PeerGroupConnectByAddress function (p2p.h)

The PeerGroupConnectByAddress function attempts to connect to the peer group that other peers with known IPv6 addresses are participating in. After this function is called successfully, a peer can communicate with other members of the peer group.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupConnectByAddress(
  [in] HGROUP        hGroup,
  [in] ULONG         cAddresses,
  [in] PPEER_ADDRESS pAddresses
);

Parameters

[in] hGroup

Handle to the peer group to which a peer intends to connect. This handle is returned by the PeerGroupCreate, PeerGroupOpen,PeerGroupJoin, or PeerGroupPasswordJoin function. This parameter is required.

[in] cAddresses

The total number of PEER_ADDRESS structures pointed to by pAddresses.

[in] pAddresses

Pointer to a list of PEER_ADDRESS structures that specify the endpoints of peers participating in the group.

Return value

Returns S_OK if the operation succeeds. Otherwise, the function returns the following value.

Cryptography-specific errors may be returned from the Microsoft RSA Base Provider. These errors are prefixed with CRYPT_* and defined in Winerror.h.

Remarks

If a time-out value for PeerGroupConnectByAddress is not provided in the application, encountering a failure will cause the application to hang. A time-out value of 30 seconds is recommended.

Requirements

See also

PEER_ADDRESS

PeerGroupConnect

PeerGroupJoin

PeerGroupPasswordJoin