PeerGroupOpenDirectConnection-Funktion (p2p.h)

Artikel
08/25/2023

Die Funktion PeerGroupOpenDirectConnection stellt eine direkte Verbindung mit einem anderen Peer in einer Peergruppe her.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupOpenDirectConnection(
  [in]  HGROUP        hGroup,
  [in]  PCWSTR        pwzIdentity,
  [in]  PPEER_ADDRESS pAddress,
  [out] ULONGLONG     *pullConnectionId
);

Parameter

[in] hGroup

Handle mit der Peergruppe, die die Direktverbindung hostet. Dieses Handle wird von der Funktion PeerGroupCreate, PeerGroupOpen oder PeerGroupJoin zurückgegeben. Dieser Parameter ist erforderlich.

[in] pwzIdentity

Zeiger auf eine Unicode-Zeichenfolge, die die Identität enthält, mit der ein Peer eine Verbindung herstellt. Dieser Parameter ist erforderlich.

[in] pAddress

Zeiger auf eine PEER_ADDRESS-Struktur , die die IPv6-Adresse enthält, mit der der Peer eine Verbindung herstellt. Dieser Parameter ist erforderlich.

[out] pullConnectionId

64-Bit-Ganzzahl ohne Vorzeichen, die die direkte Verbindung identifiziert. Dieser ID-Wert kann erst dann als gültig angenommen werden, wenn das PEER_GROUP_EVENT_DIRECT_CONNECTION-Ereignis ausgelöst wird und angibt, dass die Verbindung vom anderen Peer akzeptiert wurde. Dieser Parameter ist erforderlich.

Rückgabewert

Gibt S_OK zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt die Funktion einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
E_INVALIDARG	Einer der Parameter ist ungültig.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher verfügbar, um den Vorgang abzuschließen.
PEER_E_CONNECT_SELF	Bei der Verbindung ist ein Fehler aufgetreten, da es sich um ein Loopback handelt, d. h. die Verbindung zwischen einem Peer und sich selbst.
PEER_E_NO_KEY_ACCESS	Der Zugriff auf die Peeridentität oder Peergruppenschlüssel wird verweigert. Dies wird in der Regel durch eine falsche Zugriffssteuerungsliste (Access Control List, ACL) für den Ordner verursacht, der die Benutzer- oder Computerschlüssel enthält. Dies kann passieren, wenn die ACL manuell zurückgesetzt wurde.

Kryptografiespezifische Fehler können vom Microsoft RSA-Basisanbieter zurückgegeben werden. Diesen Fehlern wird CRYPT_* vorangestellt und in Winerror.h definiert.

Hinweise

Jede direkte Verbindung, die mit dieser Funktion geöffnet wird, muss geschlossen werden, PEER_GROUP_EVENT DATA-Struktur das status Element ihrer Komponente PEER_EVENT_CONNECTION_CHANGE_DATA Struktur auf PEER_CONNECTION_FAILED festgelegt hat.

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