SslGetKeyProperty 函数

SslGetKeyProperty 函数检索安全套接字层协议的命名属性的值， (SSL) 提供程序密钥对象。

语法

SECURITY_STATUS WINAPI SslGetKeyProperty(
  _In_  NCRYPT_KEY_HANDLE hKey,
  _In_  LPCWSTR           pszProperty,
  _Out_ PBYTE             ppbOutput,
  _Out_ DWORD             *pcbOutput,
  _In_  DWORD             dwFlags
);

参数

hKey [in]

SSL 提供程序的句柄。

pszProperty [in]

指向以 null 结尾的 Unicode 字符串的指针，其中包含要检索的属性的名称。 这可以是预定义的密钥之一存储属性标识符或自定义属性标识符。

ppbOutput [out]

指向接收属性值的缓冲区的指针。 函数的调用方必须通过调用 SslFreeBuffer 函数释放此缓冲区。

输入 [ out]

pbOutput 缓冲区的大小（以字节为单位）。

dwFlags [in]

此参数留待将来使用。

返回值

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

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

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

返回代码/值	说明
NTE_INVALID_HANDLE 0x80090026L	提供的句柄之一无效。
NTE_INVALID_PARAMETER 0x80090027L	提供的参数之一无效。

要求

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