PeerGraphConnect-Funktion (p2p.h)
Die PeerGraphConnect-Funktion versucht, eine Verbindung mit einem angegebenen Knoten in einem Peergraph herzustellen. Diese Funktion startet einen asynchronen Vorgang. Die aufrufende Anwendung muss auf ein PEER_GRAPH_EVENT_NEIGHBOR_CONNECTION-Ereignis warten, um zu bestimmen, ob der Verbindungsversuch erfolgreich ist.
Syntax
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphConnect(
[in] HGRAPH hGraph,
[in] PCWSTR pwzPeerId,
[in] PPEER_ADDRESS pAddress,
[out] ULONGLONG *pullConnectionId
);
Parameter
[in] hGraph
Handle für ein Peerdiagramm.
[in] pwzPeerId
Die eindeutige ID eines Peers, mit dem unter pAddress eine Verbindung hergestellt werden soll. Geben Sie NULL an, um eine Verbindung mit einem Peer herzustellen, der an einer angegebenen Adresse im selben Peerdiagramm lauscht.
[in] pAddress
Zeiger auf eine PEER_ADDRESS Struktur, die einen Knoten identifiziert, mit dem eine Verbindung hergestellt werden soll.
[out] pullConnectionId
Empfängt den Zeiger auf eine ULONGLONGLONG , die die Verbindungs-ID enthält. Diese ID kann mit den Funktionen für die direkte Kommunikation verwendet werden.
Rückgabewert
Wenn der Funktionsaufruf erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls wird einer der folgenden Werte zurückgegeben.
| Rückgabecode | Beschreibung |
|---|---|
|
Einer der Parameter ist ungültig. |
|
Es ist nicht genügend Arbeitsspeicher vorhanden, um einen angegebenen Vorgang auszuführen. |
|
Eine Nachbarverbindung mit einem angegebenen Knoten ist bereits vorhanden. |
|
Das Handle für ein Peerdiagramm ist ungültig. |
|
Ein Graph muss mit einem Aufruf von PeerGraphStartup initialisiert werden, bevor diese Funktion verwendet wird. |
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP mit SP2 [nur Desktop-Apps],Windows XP mit SP1 mit dem Erweiterten Netzwerkpaket fürWindows XP |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | p2p.h |
| Bibliothek | P2PGraph.lib |
| DLL | P2PGraph.dll |