Funzione PeerGroupOpenDirectConnection (p2p.h)

Articolo
03/15/2023

La funzione PeerGroupOpenDirectConnection stabilisce una connessione diretta con un altro peer in un gruppo peer.

Sintassi

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

Parametri

[in] hGroup

Gestire il gruppo peer che ospita la connessione diretta. Questo handle viene restituito dalla funzione PeerGroupCreate, PeerGroupOpen o PeerGroupJoin . Questo parametro è obbligatorio.

[in] pwzIdentity

Puntatore a una stringa Unicode che contiene l'identità a cui si connette un peer. Questo parametro è obbligatorio.

[in] pAddress

Puntatore a una struttura PEER_ADDRESS che contiene l'indirizzo IPv6 a cui si connette il peer. Questo parametro è obbligatorio.

[out] pullConnectionId

Intero a 64 bit senza segno che identifica la connessione diretta. Questo valore ID non può essere assunto come valido finché non viene generato l'evento PEER_GROUP_EVENT_DIRECT_CONNECTION e indica che la connessione è stata accettata dall'altro peer. Questo parametro è obbligatorio.

Valore restituito

Restituisce S_OK se l'operazione ha esito positivo. In caso contrario, la funzione restituisce uno dei valori seguenti.

Codice restituito	Descrizione
E_INVALIDARG	Uno dei parametri non è valido.
E_OUTOFMEMORY	Non è disponibile memoria sufficiente per completare l'operazione.
PEER_E_CONNECT_SELF	La connessione non è riuscita perché era un loopback, ovvero la connessione è tra un peer e se stesso.
PEER_E_NO_KEY_ACCESS	L'accesso alle chiavi peer identity o peer group viene negato. Questo è in genere causato da un elenco di controllo di accesso non corretto (ACL) per la cartella che contiene le chiavi utente o computer. Ciò può verificarsi quando l'ACL è stato reimpostato manualmente.

Gli errori specifici della crittografia possono essere restituiti dal provider di base Microsoft RSA. Questi errori sono preceduti da CRYPT_* e definiti in Winerror.h.

Commenti

Ogni connessione diretta aperta con questa funzione deve essere chiusa con PEER_GROUP_EVENT struttura DATA ha il membro di stato della struttura del componente PEER_EVENT_CONNECTION_CHANGE_DATA impostata su PEER_CONNECTION_FAILED.

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	P2P.lib
DLL	P2P.dll