PeerGraphOpenDirectConnection-Funktion (p2p.h)

Artikel
03/01/2024

Mit der Funktion PeerGraphOpenDirectConnection kann eine Anwendung eine direkte Verbindung mit einem Knoten in einem Peerdiagramm herstellen. Die Verbindung kann nur hergestellt werden, wenn der Knoten, mit dem die Anwendung eine Verbindung herstellt, das PEER_GRAPH_EVENT_DIRECT_CONNECTION-Ereignis abonniert hat. Die Anwendung kann Daten dann direkt an einen anderen Knoten senden. Ein Aufruf dieser Funktion ist asynchron.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphOpenDirectConnection(
  [in]  HGRAPH        hGraph,
  [in]  PCWSTR        pwzPeerId,
  [in]  PPEER_ADDRESS pAddress,
  [out] ULONGLONG     *pullConnectionId
);

Parameter

[in] hGraph

Handle mit einem Peerdiagramm.

[in] pwzPeerId

Zeiger auf die eindeutige ID eines Benutzers oder Knotens, mit dem eine Verbindung hergestellt werden soll. Dieser Parameter wird verwendet, um einen bestimmten Benutzer zu identifizieren, da mehrere Identitäten an die angegebene Adresse angefügt werden können.

[in] pAddress

Zeiger auf eine PEER_ADDRESS Struktur, die die Adresse des Knotens enthält, mit dem eine Verbindung hergestellt werden soll.

[out] pullConnectionId

Empfängt die Verbindungs-ID für die angeforderte Verbindung.

Rückgabewert

Wenn der Funktionsaufruf erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls wird einer der folgenden Werte zurückgegeben.

Rückgabecode	Beschreibung
PEER_E_INVALID_GRAPH	Das Handle für das Diagramm ist ungültig.
PEER_E_NOT_INITIALIZED	Das Diagramm muss mit einem Aufruf von PeerGraphStartup initialisiert werden, bevor diese Funktion verwendet wird.

Hinweise

Ein Aufruf von PeerGraphOpenDirectConnection ist ein asynchroner Aufruf. Ein PEER_GRAPH_EVENT_DIRECT_CONNECTION-Ereignis wird ausgelöst, um die Anwendung über den Erfolg oder Fehler der Direktverbindung zu informieren. Der tatsächliche status des Erfolgs oder Fehlers der Funktion wird in der PEER_GRAPH_EVENT_DATA-Struktur angegeben.

Anforderungen

Anforderung	Wert
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	P2PGraph.lib
DLL	P2PGraph.dll

Weitere Informationen

PEER_ADDRESS

PeerGraphCloseDirectConnection

PeerGraphEnumConnections

Freigeben über