Funzione PeerGroupConnect (p2p.h)

La funzione PeerGroupConnect avvia una ricerca PNRP per un gruppo peer e tenta di connettersi. Dopo aver chiamato correttamente questa funzione, un peer può comunicare con altri membri del gruppo peer.

Sintassi

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupConnect(
  [in] HGROUP hGroup
);

Parametri

[in] hGroup

Gestire il gruppo peer a cui un peer intende connettersi. Questo handle viene restituito dalla funzione PeerGroupCreate, PeerGroupOpen, PeerGroupJoin o PeerGroupPasswordJoin . Questo parametro è obbligatorio.

Valore restituito

Restituisce S_OK se l'operazione ha esito positivo. In caso contrario, la funzione restituisce il valore seguente.

Codice restituito	Descrizione
PEER_E_INVALID_GROUP	L'handle per il gruppo di peer non è valido.

 

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

Un'applicazione esegue la registrazione per gli eventi peer prima di chiamare questa funzione. Se la chiamata di funzione ha esito negativo, viene generato un evento PEER_GROUP_EVENT_CONNECTION_FAILED. In caso contrario, viene generato un evento PEER_GROUP_EVENT_STATUS_CHANGED.

L'evento PEER_GROUP_EVENT_CONNECTION_FAILED viene generato anche quando un autore di gruppi non riesce a chiamare PeerGroupConnect immediatamente dopo la creazione. Se questa operazione non viene eseguita, gli utenti che hanno ricevuto un invito chiameranno PeerGroupConnect correttamente, ma non saranno in grado di ascoltare e riceveranno l'evento di connessione non riuscito.

In caso di asimmetria dell'orologio tra i computer partecipanti, l'esito positivo di PeerGroupConnect può dipendere dalla gravità dell'asimmetria. Quando si risolve un errore di join, questa possibilità deve essere presa in considerazione verificando che gli orologi del computer siano sincronizzati.

Per essere presenti nel gruppo peer e ricevere eventi ma rimangono non connessi, usare la funzione PeerGroupOpen .

Se non viene fornito un valore di timeout per PeerGroupConnect nell'applicazione, se si verifica un errore, l'applicazione si blocca. È consigliabile un valore di timeout di 30 secondi.

Prima di chiamare PeerGroupConnect, un gruppo esiste in uno stato "Disconnesso". Durante questo periodo non è possibile rilevare o ricevere connessioni al gruppo. Per restituire un gruppo a questo stato, è necessario chiamare la funzione PeerGroupClose .

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

Vedi anche

PeerGroupClose

PeerGroupJoin

PeerGroupOpen

PeerGroupPasswordJoin