cryptGetUserKey 函数 (wincrypt.h)

重要此 API 已弃用。新的和现有的软件应开始使用加密下一代 API。 Microsoft 可能会在将来的版本中删除此 API。

CryptGetUserKey 函数检索用户的两个公钥/私钥对之一的句柄。此函数仅由公钥/私钥对的所有者使用，并且仅当加密服务提供程序的句柄 (CSP) 及其关联的密钥容器可用时。如果 CSP 句柄不可用，并且用户的证书为，请使用 CryptAcquireCertificatePrivateKey。

语法

BOOL CryptGetUserKey(
  [in]  HCRYPTPROV hProv,
  [in]  DWORD      dwKeySpec,
  [out] HCRYPTKEY  *phUserKey
);

[in] hProv

通过调用 CryptAcquireContext 创建的加密服务提供程序 (CSP) 的 HCRYPTPROV 句柄。

[in] dwKeySpec

标识要从密钥容器使用的私钥。它可以AT_KEYEXCHANGE或AT_SIGNATURE。

此外，某些提供程序允许通过此函数访问其他用户特定的密钥。有关详细信息，请参阅有关特定提供程序的文档。

[out] phUserKey

指向检索到的密钥的 HCRYPTKEY 句柄的指针。使用完密钥后，通过调用 CryptDestroyKey 函数删除句柄。

如果函数成功，则返回值为非零 (TRUE) 。

如果函数失败，则返回值为零 (FALSE) 。有关扩展的错误信息，请调用 GetLastError。

以“NTE”开头的错误代码由使用的特定 CSP 生成。下面是一些可能的错误代码。