[#i2p-sam-Session-Connect]
= xref:i2p.adoc[i2p]::xref:i2p/sam.adoc[sam]::xref:i2p/sam/Session.adoc[Session]::Connect
:relfileprefix: ../../../
:mrdocs:

Connect to an I2P peer.

== Synopsis

Declared in `<i2p.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
[[requires_capability(0x7f2e2a7c1468), requires_capability(0x7f2e2a92e5e8), requires_capability(0x7f2e22549098), requires_capability(0x7f2e263f54a8), requires_capability(0x7f2e22817db8), requires_capability(0x7f2e2abec998), requires_capability(0x7f2e4307eff8), requires_capability(0x7f2e41b52cd8), requires_capability(0x7f2e18720298), requires_capability(0x7f2e1cf3e808), requires_capability(0x7f2e15144aa8), requires_capability(0x7f2e120b0378)]]
bool
Connect(
    xref:CService.adoc[CService] const& to,
    xref:i2p/Connection.adoc[Connection]& conn,
    bool& proxy_error);
----

== Return Value

true on success

== Parameters

[cols="1,4"]
|===
| Name| Description
| *to* [in]
| Peer to connect to.
| *conn* [out]
| Established connection. Only set if `true` is returned.
| *proxy_error* [out]
| If an error occurs due to proxy or general network failure, then this is set to `true`. If an error occurs due to unreachable peer (likely peer is down), then it is set to `false`. Only set if `false` is returned.
|===


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