[#CConnman-OpenNetworkConnection]
= xref:CConnman.adoc[CConnman]::OpenNetworkConnection
:relfileprefix: ../
:mrdocs:

Open a new P2P connection and initialize it with the PeerManager at `m_msgproc`.

== Synopsis

Declared in `<net.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
[[requires_capability(0x7f2e2b748458, 0x7f2e2b748518), requires_capability(0x7f2e28941168, 0x7f2e28941228), requires_capability(0x7f2e234d0348, 0x7f2e234d0408), requires_capability(0x7f2e2737cae8, 0x7f2e2737cba8), requires_capability(0x7f2e235ee178, 0x7f2e235ee238), requires_capability(0x7f2e2a34a268, 0x7f2e2a34a328), requires_capability(0x7f2e219f7038, 0x7f2e219f70f8), requires_capability(0x7f2e21c81ef8, 0x7f2e21c81fb8), requires_capability(0x7f2e1aa34a58, 0x7f2e1aa34b18), requires_capability(0x7f2e376b6b38, 0x7f2e376b6bf8), requires_capability(0x7f2e433cc6c8, 0x7f2e433cc788)]]
bool
OpenNetworkConnection(
    xref:CAddress.adoc[CAddress] const& addrConnect,
    bool fCountFailure,
    xref:CountingSemaphoreGrant.adoc[CountingSemaphoreGrant<>]&& grant_outbound,
    char const* pszDest,
    xref:ConnectionType.adoc[ConnectionType] conn_type,
    bool use_v2transport,
    std::optional<Proxy> const& proxy_override);
----

== Return Value

whether the connection was opened successfully.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *addrConnect* [in]
| Address to connect to, if `pszDest` is `nullptr`.
| *fCountFailure* [in]
| Increment the number of connection attempts to this address in Addrman.
| *grant_outbound* [in]
| Take ownership of this grant, to be released later when the connection is closed.
| *pszDest* [in]
| Address to resolve and connect to.
| *conn_type* [in]
| Type of the connection to open, must not be `ConnectionType::INBOUND`.
| *use_v2transport* [in]
| Use P2P encryption, (aka V2 transport, BIP324).
| *proxy_override* [in]
| Optional proxy to use and override normal proxy selection.
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#