PeerGroupConnectByAddress-Funktion (p2p.h)
Die PeerGroupConnectByAddress-Funktion versucht, eine Verbindung mit der Peergruppe herzustellen, an der andere Peers mit bekannten IPv6-Adressen teilnehmen. Nachdem diese Funktion erfolgreich aufgerufen wurde, kann ein Peer mit anderen Mitgliedern der Peergruppe kommunizieren.
Syntax
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupConnectByAddress(
[in] HGROUP hGroup,
[in] ULONG cAddresses,
[in] PPEER_ADDRESS pAddresses
);
Parameter
[in] hGroup
Handle mit der Peergruppe, mit der ein Peer eine Verbindung herstellen möchte. Dieses Handle wird von der Funktion PeerGroupCreate, PeerGroupOpen, PeerGroupJoin oder PeerGroupPasswordJoin zurückgegeben. Dieser Parameter ist erforderlich.
[in] cAddresses
Die Gesamtzahl der PEER_ADDRESS Strukturen, auf die von pAddresses verwiesen wird.
[in] pAddresses
Zeiger auf eine Liste von PEER_ADDRESS Strukturen, die die Endpunkte von Peers angeben, die an der Gruppe teilnehmen.
Rückgabewert
Gibt S_OK zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt die Funktion den folgenden Wert zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Das Handle für die Peergruppe ist ungültig. |
Kryptografiespezifische Fehler können vom Microsoft RSA-Basisanbieter zurückgegeben werden. Diesen Fehlern wird CRYPT_* vorangestellt und in Winerror.h definiert.
Hinweise
Wenn in der Anwendung kein Timeoutwert für PeerGroupConnectByAddress angegeben wird, führt ein Fehler dazu, dass die Anwendung hängen bleibt. Ein Timeoutwert von 30 Sekunden wird empfohlen.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP mit SP2 [nur Desktop-Apps],Windows XP mit SP1 mit dem Advanced Networking Pack forWindows XP |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | p2p.h |
| Bibliothek | P2P.lib |
| DLL | P2P.dll |