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
phPrivateKeypCertContext 参数为 NULL

注解

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

要求

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