SslOpenPrivateKey 函数

  • 项目

SslOpenPrivateKey 函数打开私钥的句柄。

语法

SECURITY_STATUS WINAPI SslOpenPrivateKey(
  _In_  NCRYPT_PROV_HANDLE hSslProvider,
  _Out_ NCRYPT_KEY_HANDLE  *phPrivateKey,
  _In_  PCCERT_CONTEXT     pCertContext,
  _In_  DWORD              dwFlags
);

参数

hSslProvider [in]

安全套接字层协议的句柄 (SSL) 协议提供程序实例。

phPrivateKey [out]

要在其中将句柄写入私钥的缓冲区的地址。

使用完密钥后，应通过调用 SslFreeObject 函数释放 phPrivateKey。

pCertContext [in]

要从中获取私钥的证书的地址。

dwFlags [in]

此参数留待将来使用。

返回值

如果函数成功，则返回零。

如果函数失败，则返回非零错误值。

可能的返回代码包括但不限于以下内容。

返回代码/值 说明
NTE_NO_MEMORY
0x8009000EL
 没有足够的内存可用于分配必要的缓冲区。
NTE_INVALID_HANDLE
0x80090026L
 hSslProvider 句柄无效。
NTE_INVALID_PARAMETER
0x80090027L
 phPrivateKey 或 pCertContext 参数为 NULL。

备注

获取的私钥是证书中公钥/私钥对的一部分。 此函数仅从 pCertContext 参数指定的证书中提取私钥。

要求

要求 值
最低受支持的客户端
 Windows Vista [仅限桌面应用]
最低受支持的服务器
 Windows Server 2008 [仅限桌面应用]
标头
Sslprovider.h
DLL
Ncrypt.dll