Funzione PeerGroupJoin (p2p.h)

Articolo
08/25/2023

La funzione PeerGroupJoin prepara un peer con un invito a partecipare a un gruppo di peer esistente prima di chiamare PeerGroupConnect o PeerGroupConnectByAddress.

Sintassi

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

Parametri

[in] pwzIdentity

Puntatore a una stringa Unicode contenente l'identità che apre il gruppo di peer specificato. Se questo parametro è NULL, l'implementazione usa l'identità ottenuta da PeerIdentityGetDefault.

[in] pwzInvitation

Puntatore a una stringa Unicode contenente l'invito XML concesso da un altro peer. Viene creato un invito quando il peer invito chiama PeerGroupCreateInvitation o PeerGroupIssueCredentials. È possibile ottenere dettagli specifici relativi a questo invito come struttura PEER_INVITATION_INFO chiamando PeerGroupParseInvitation. Questo parametro è obbligatorio.

[in] pwzCloud

Puntatore a una stringa Unicode contenente il nome del cloud PNRP in cui si trova un gruppo. Il valore predefinito è NULL, che indica che il cloud specificato nell'invito deve essere usato.

[out] phGroup

Puntatore all'handle del gruppo peer. Per avviare la comunicazione con un gruppo, chiamare PeerGroupConnect. 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_CLOUD_NAME_AMBIGUOUS	Il cloud non può essere individuato in modo univoco, ad esempio più di un cloud corrisponde al nome specificato.
PEER_E_INVALID_PEER_NAME	L'identità peer specificata in pwzIdentity non è valida.
PEER_E_INVALID_TIME_PERIOD	Il periodo di validità specificato nell'invito non è valido. Il periodo specificato è scaduto o l'invito non è ancora valido( ad esempio, la data\ora di validità specificata non è ancora stata raggiunta). Un possibile motivo per la restituzione di questo errore è che l'orologio di sistema è impostato in modo errato nel computer che partecipa al gruppo o nel computer che ha rilasciato l'invito.
PEER_E_INVITATION_NOT_TRUSTED	L'invito non è attendibile. Ciò può essere dovuto a modifiche di invito, errori o scadenza.
PEER_E_NO_CLOUD	Impossibile trovare il cloud.
PEER_E_UNSUPPORTED_VERSION	L'invito non è supportato dalla versione corrente dell'infrastruttura peer.
PEER_E_NO_KEY_ACCESS	L'accesso alle chiavi peer identity o peer group viene negato. In genere, questo è 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.

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