PeerIdentityGetCryptKey-Funktion (p2p.h)

Die PeerIdentityGetCryptKey-Funktion ruft ein Handle an einen Kryptografiedienstanbieter (CSP) ab.

Syntax

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

[in] pwzIdentity

Gibt die Peeridentität an, für die das Schlüsselpaar abgerufen werden soll.

[out] phCryptProv

Empfängt einen Zeiger auf das Handle des Kryptografiedienstanbieters (CSP), das ein AT_KEYEXCHANGE RSA-Schlüsselpaar enthält.

Wenn der Funktionsaufruf erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls wird einer der folgenden Werte zurückgegeben.

Rückgabecode	Beschreibung
E_INVALIDARG	Einer der Parameter ist ungültig.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um den angegebenen Vorgang auszuführen.
PEER_E_NO_KEY_ACCESS	Der Zugriff auf die Peeridentität oder Peergruppenschlüssel wird verweigert. Dies wird in der Regel durch eine falsche Zugriffssteuerungsliste (Access Control List, ACL) für den Ordner verursacht, der die Benutzer- oder Computerschlüssel enthält. Dies kann passieren, wenn die ACL manuell zurückgesetzt wurde.
PEER_E_NOT_FOUND	Eine Identität, die mit dem angegebenen Namen übereinstimmt, wurde nicht gefunden.

Der Schlüssel kann durch Aufrufen von CryptGetUserKey abgerufen werden.

Wenn das Handle nicht mehr benötigt wird, ist die Anwendung für die Freigabe des Handles mithilfe von CryptReleaseContext verantwortlich.

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP2 [nur Desktop-Apps],Windows XP mit SP1 mit dem Advanced Networking Pack für Windows XP
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	p2p.h
Bibliothek	P2P.lib
DLL	P2P.dll

CryptReleaseContext