Funzione PeerGroupIssueCredentials (p2p.h)

Articolo
03/01/2024

La funzione PeerGroupIssueCredentials genera credenziali, tra cui un GMC, un'identità specifica e, facoltativamente, restituisce una stringa XML di invito che il peer invitato può usare per partecipare a un gruppo peer.

Sintassi

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupIssueCredentials(
  [in]  HGROUP               hGroup,
  [in]  PCWSTR               pwzSubjectIdentity,
  [in]  PEER_CREDENTIAL_INFO *pCredentialInfo,
  [in]  DWORD                dwFlags,
  [out] PWSTR                *ppwzInvitation
);

Parametri

[in] hGroup

Gestire un gruppo peer per il quale un peer emetterà le credenziali ai potenziali peer invitati. Questo handle viene restituito dalla funzione PeerGroupCreate, PeerGroupOpen o PeerGroupJoin . Questo parametro è obbligatorio.

[in] pwzSubjectIdentity

Specifica l'identità di un peer a cui verranno rilasciate le credenziali. Questo parametro è obbligatorio.

[in] pCredentialInfo

PEER_CREDENTIAL_INFO struttura che contiene informazioni sulle credenziali di un peer la cui identità è specificata in pwzSubjectIdentity. Se questo parametro è NULL, vengono invece usate le informazioni archiviate nel database peer. Questo parametro è facoltativo e,

Se viene specificato questo parametro, i campi seguenti in PEER_CREDENTIAL_INFO vengono ignorati:

pwzIssuerPeerName
pwzIssuerFriendlyName

[in] dwFlags

Specifica un set di flag usati per descrivere le azioni eseguite quando vengono rilasciate le credenziali. Se questo parametro è impostato su 0 (zero), le credenziali vengono restituite in ppwzInvitation. Questo parametro è facoltativo e,

Valore	Significato
PEER_GROUP_STORE_CREDENTIALS	Pubblicare la GMC appena creata dell'oggetto nel database del gruppo. Il GMC viene raccolto automaticamente dall'oggetto. Se questo flag non è impostato, le credenziali devono essere ottenute da un'applicazione diversa, ad esempio posta elettronica.

[out] ppwzInvitation

Puntatore a una stringa XML di invito restituita dalla chiamata alla funzione. Questo invito viene passato fuori banda al peer invitato che lo usa in una chiamata a PeerGroupJoin. Questo parametro è facoltativo e,

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_IDENTITY_DELETED	L'identità che crea le credenziali è stata eliminata.
PEER_E_IDENTITY_NOT_FOUND	Impossibile trovare l'identità nel database del gruppo e pCredentialInfo è NULL.
PEER_E_NO_KEY_ACCESS	L'accesso alle chiavi di identità o gruppo 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.

Commenti

Questa funzione può essere chiamata solo correttamente da un amministratore.

Le credenziali per un membro (PEER_CREDENTIAL_INFO) vengono ottenute chiamando PeerGroupEnumMembers. Le credenziali si trovano nel campo pCredentialInfo della struttura PEER_MEMBER per un membro specifico.

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

Condividi tramite