Funzione PeerGraphOpenDirectConnection (p2p.h)

Articolo
03/01/2024

La funzione PeerGraphOpenDirectConnection consente a un'applicazione di stabilire una connessione diretta con un nodo in un grafo peer. La connessione può essere effettuata solo se il nodo a cui si connette l'applicazione ha sottoscritto l'evento PEER_GRAPH_EVENT_DIRECT_CONNECTION . L'applicazione può quindi inviare dati direttamente a un altro nodo. Una chiamata a questa funzione è asincrona.

Sintassi

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

Parametri

[in] hGraph

Gestire in un grafo peer.

[in] pwzPeerId

Puntatore all'ID univoco di un utente o di un nodo a cui connettersi. Questo parametro viene usato per identificare un utente specifico perché è possibile associare più identità all'indirizzo specificato.

[in] pAddress

Puntatore a una struttura PEER_ADDRESS che contiene l'indirizzo del nodo a cui connettersi.

[out] pullConnectionId

Riceve l'ID connessione per la connessione richiesta.

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
PEER_E_INVALID_GRAPH	L'handle per il grafico non è valido.
PEER_E_NOT_INITIALIZED	Il grafico deve essere inizializzato con una chiamata a PeerGraphStartup, prima di usare questa funzione.

Commenti

Una chiamata a PeerGraphOpenDirectConnection è una chiamata asincrona. Viene attivato un evento PEER_GRAPH_EVENT_DIRECT_CONNECTION per informare l'applicazione dell'esito positivo o negativo della connessione diretta. Lo stato effettivo dell'esito positivo o negativo della funzione viene assegnato nella struttura PEER_GRAPH_EVENT_DATA .

Requisiti

Requisito	Valore
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

PeerGraphCloseDirectConnection

PeerGraphEnumConnections

Condividi tramite