Condividi tramite

Funzione PeerGroupCreatePasswordInvitation (p2p.h)

  • Articolo

La funzione PeerGroupCreatePasswordInvitation restituisce una stringa XML che può essere utilizzata dal peer specificato per unire un gruppo con una password corrispondente.

Sintassi

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupCreatePasswordInvitation(
  [in]  HGROUP hGroup,
  [out] PWSTR  *ppwzInvitation
);

Parametri

[in] hGroup

Gestire il gruppo peer per il quale viene emesso l'invito. Questo handle viene restituito dalla funzione PeerGroupCreate, PeerGroupOpen o PeerGroupJoin . Questo parametro è obbligatorio.

[out] ppwzInvitation

Puntatore a una stringa Unicode che contiene l'invito dall'autorità emittente. Questo invito può essere passato a PeerGroupPasswordJoin dal destinatario per partecipare al gruppo di peer specificato. Per restituire i dettagli dell'invito come struttura PEER_INVITATION_INFO , passare questa stringa a PeerGroupParseInvitation. Per rilasciare questi dati, passare questo puntatore a PeerFreeData.

Questa funzione richiede che i campi seguenti siano impostati nella struttura PEER_GROUP_PROPERTIES passata a PeerGroupCreate.

  • pwzGroupPassword. Questo campo deve contenere la password usata per convalidare i peer che si uniscono al gruppo di peer.
  • groupPasswordRole. Questo campo deve contenere il GUID del ruolo (amministratore o peer) per il quale è necessaria la password.
  • dwAuthenticationSchemes. Per questo campo deve essere impostato il flag PEER_GROUP_PASSWORD_AUTHENTICATION (0x00000001).

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 eseguire l'operazione specificata.
PEER_E_GROUP_NOT_READY
 Il gruppo di peer non è in uno stato in cui è possibile aggiungere record. Ad esempio, viene chiamato PeerGroupJoin , ma la sincronizzazione con il database di gruppo non è stata completata.
PEER_E_CHAIN_TOO_LONG
 La catena GMC è più lunga di 24 amministratori o membri. Per altre informazioni sulle catene GMC, vedere la documentazione relativa al funzionamento della sicurezza del gruppo .
PEER_E_IDENTITY_DELETED
 I dati passati come pwzIdentityInfo sono per un'identità eliminata e non sono più validi.
PEER_E_NOT_AUTHORIZED
 Il peer che ha chiamato questo metodo non è un amministratore.
PEER_E_NO_KEY_ACCESS
 L'accesso alle chiavi di gruppo di identità o 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 viene 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

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