Condividi tramite


Funzione PeerGraphConnect (p2p.h)

La funzione PeerGraphConnect tenta di stabilire una connessione a un nodo specificato in un grafico peer. Questa funzione avvia un'operazione asincrona. L'applicazione chiamante deve attendere un evento PEER_GRAPH_EVENT_NEIGHBOR_CONNECTION per determinare se il tentativo di connessione ha esito positivo.

Sintassi

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

Parametri

[in] hGraph

Gestire in un grafo peer.

[in] pwzPeerId

ID univoco di un peer a cui connettersi in pAddress. Specificare NULL per connettersi a qualsiasi peer in ascolto in corrispondenza di un indirizzo specificato nello stesso grafo peer.

[in] pAddress

Puntatore a una struttura PEER_ADDRESS che identifica un nodo a cui connettersi.

[out] pullConnectionId

Riceve il puntatore a un ULONGLONG contenente l'ID connessione. Questo ID può essere usato con le funzioni di comunicazione diretta.

Valore restituito

Se la chiamata di funzione ha esito positivo, il valore restituito viene S_OK. In caso contrario, restituisce uno dei valori seguenti.

Codice restituito Descrizione
E_INVALIDARG
Uno dei parametri non è valido.
E_OUTOFMEMORY
Memoria insufficiente per eseguire un'operazione specificata.
PEER_E_ALREADY_EXISTS
Esiste già una connessione adiacente a un nodo specificato.
PEER_E_INVALID_GRAPH
L'handle di un grafo peer non è valido.
PEER_E_NOT_INITIALIZED
È necessario inizializzare un grafico con una chiamata a PeerGraphStartup prima di usare questa funzione.

Requisiti

   
Client minimo supportato Windows XP con SP2 [solo app desktop],Windows XP con SP1 con Advanced Networking Pack forWindows XP
Server minimo supportato Nessuno supportato
Piattaforma di destinazione Windows
Intestazione p2p.h
Libreria P2PGraph.lib
DLL P2PGraph.dll

Vedi anche

PEER_ADDRESS

PeerGraphGetEventData

PeerGraphListen

PeerGraphOpenDirectConnection

PeerGraphSendData