Funzione PeerGroupOpen (p2p.h)

Articolo
08/25/2023

La funzione PeerGroupOpen apre un gruppo di peer creato o unito a un peer. Dopo l'apertura di un gruppo peer, il peer può registrarsi per le notifiche degli eventi.

Sintassi

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupOpen(
  [in]  PCWSTR pwzIdentity,
  [in]  PCWSTR pwzGroupPeerName,
  [in]  PCWSTR pwzCloud,
  [out] HGROUP *phGroup
);

Parametri

[in] pwzIdentity

Puntatore a una stringa Unicode che contiene l'identità usata da un peer per aprire un gruppo. Questo parametro è obbligatorio.

[in] pwzGroupPeerName

Puntatore a una stringa Unicode contenente il nome peer del gruppo peer. Questo parametro è obbligatorio.

[in] pwzCloud

Puntatore a una stringa Unicode contenente il nome del cloud PNRP in cui si trova il gruppo di peer. Se il valore è NULL, viene usato il cloud specificato nelle proprietà del gruppo peer.

[out] phGroup

Puntatore a un handle per un gruppo peer. Se questo valore è NULL, l'operazione di apertura non riesce. 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	Memoria insufficiente per completare l'operazione.
PEER_E_CLOUD_NAME_AMBIGUOUS	Il cloud specificato in pwzCloud non può essere individuato in modo univoco, ad esempio più di un cloud corrisponde al nome specificato.
PEER_E_NO_CLOUD	Impossibile trovare il cloud specificato in pwzCloud .
PEER_E_NO_KEY_ACCESS	L'accesso all'identità peer o alle chiavi del gruppo peer viene negato. In genere, ciò è 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

Più applicazioni possono aprire lo stesso gruppo contemporaneamente. Qualsiasi applicazione può scegliere di aprire un gruppo senza chiamare successivamente PeerGroupConnect. Queste applicazioni vengono considerate offline. Tuttavia, una seconda applicazione può aprire e connettere il peer al gruppo, il che significa che un'applicazione deve essere pronta per la connessione in qualsiasi momento.

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

Vedi anche

Condividi tramite