peerIdentityGetCryptKey 函式 (p2p.h)

PeerIdentityGetCryptKey 函式會擷取密碼編譯服務提供者的句柄， (CSP) 。

語法

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

[in] pwzIdentity

指定要擷取金鑰組的對等識別。

[out] phCryptProv

接收密碼編譯服務提供者句柄的指標， (CSP) 包含AT_KEYEXCHANGE RSA 金鑰組。

如果函數調用成功，傳回值會 S_OK。否則，它會傳回下列其中一個值。

傳回碼	Description
E_INVALIDARG	其中一個參數無效。
E_OUTOFMEMORY	記憶體不足，無法執行指定的作業。
PEER_E_NO_KEY_ACCESS	拒絕對等身分識別或對等群組密鑰的存取。一般而言，這是因為包含使用者或計算機密鑰的資料夾 (ACL) 不正確的存取控制清單所造成。當 ACL 已手動重設時，就會發生這種情況。
PEER_E_NOT_FOUND	找不到符合指定名稱的身分識別。

呼叫 CryptGetUserKey 即可擷取密鑰。

當不再需要句柄時，應用程式會負責使用 CryptReleaseContext 釋放句柄。

需求	值
最低支援的用戶端	Windows XP 搭配 SP2 [僅限傳統型應用程式]，Windows XP 含 SP1 與適用於 Windows XP 的進階網络套件
最低支援的伺服器	都不支援
目標平台	Windows
標頭	p2p.h
程式庫	P2P.lib
Dll	P2P.dll

CryptReleaseContext