Funzione PeerGroupJoin (p2p.h)
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 |
|---|---|
|
Uno dei parametri non è valido. |
|
Non è disponibile memoria sufficiente per completare l'operazione. |
|
Il cloud non può essere individuato in modo univoco, ad esempio più di un cloud corrisponde al nome specificato. |
|
L'identità peer specificata in pwzIdentity non è valida. |
|
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. |
|
L'invito non è attendibile. Ciò può essere dovuto a modifiche di invito, errori o scadenza. |
|
Impossibile trovare il cloud. |
|
L'invito non è supportato dalla versione corrente dell'infrastruttura peer. |
|
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 |