PeerIdentityGetCryptKey, fonction (p2p.h)

La fonction PeerIdentityGetCryptKey récupère un handle à un fournisseur de services de chiffrement (CSP).

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentityGetCryptKey(
  [in]  PCWSTR     pwzIdentity,
  [out] HCRYPTPROV *phCryptProv
);

[in] pwzIdentity

Spécifie l’identité d’homologue pour laquelle récupérer la paire de clés.

[out] phCryptProv

Reçoit un pointeur vers le handle du fournisseur de services de chiffrement (CSP) qui contient une paire de clés RSA AT_KEYEXCHANGE.

Si l’appel de fonction réussit, la valeur de retour est S_OK. Sinon, elle retourne l’une des valeurs suivantes.

Code de retour	Description
E_INVALIDARG	L’un des paramètres n’est pas valide.
E_OUTOFMEMORY	La mémoire est insuffisante pour effectuer l’opération spécifiée.
PEER_E_NO_KEY_ACCESS	L’accès à l’identité d’homologue ou aux clés de groupe d’homologues est refusé. En règle générale, cela est dû à une liste de contrôle d’accès (ACL) incorrecte pour le dossier qui contient les clés d’utilisateur ou d’ordinateur. Cela peut se produire lorsque l’ACL a été réinitialisée manuellement.
PEER_E_NOT_FOUND	Une identité qui correspond au nom spécifié est introuvable.

La clé peut être récupérée en appelant CryptGetUserKey.

Lorsque le handle n’est plus requis, l’application est responsable de la libération du handle à l’aide de CryptReleaseContext.

Condition requise	Valeur
Client minimal pris en charge	Windows XP avec SP2 [applications de bureau uniquement],Windows XP avec SP1 avec le Pack de mise en réseau avancé pour Windows XP
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	p2p.h
Bibliothèque	P2P.lib
DLL	P2P.dll

CryptReleaseContext