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。 否则,它将返回以下值之一。

返回代码 说明
E_INVALIDARG
其中一个参数无效。
E_OUTOFMEMORY
内存不足,无法执行指定的操作。
PEER_E_NO_KEY_ACCESS
对对等标识或对等组密钥的访问被拒绝。 通常,这是由于包含用户或计算机密钥的文件夹的访问控制列表 (ACL) 不正确导致的。 手动重置 ACL 时可能会发生这种情况。
PEER_E_NOT_FOUND
找不到与指定名称匹配的标识。

注解

可以通过调用 CryptGetUserKey 来检索密钥。

当不再需要句柄时,应用程序负责使用 CryptReleaseContext 释放句柄。

要求

要求
最低受支持的客户端 带 SP2 的 Windows XP [仅限桌面应用],带 SP1 的 Windows XP 和适用于 Windows XP 的高级网络包
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 p2p.h
Library P2P.lib
DLL P2P.dll

另请参阅

CryptGetUserKey

CryptReleaseContext