Share via

SslGetProviderProperty 函数

  • 项目

SslGetProviderProperty 函数检索指定提供程序属性的值。

语法

SECURITY_STATUS WINAPI SslGetProviderProperty(
  _In_    NCRYPT_PROV_HANDLE hSslProvider,
  _In_    LPCWSTR            pszProperty,
  _Out_   PBYTE              ppbOutput,
  _Out_   DWORD              *pcbOutput,
  _Inout_ PVOID              *ppEnumState,
  _In_    DWORD              dwFlags
);

parameters

hSslProvider [in]

要为其检索属性的安全 套接字层协议 (SSL) 提供程序的句柄。

pszProperty [in]

指向包含要检索的属性名称的 null 终止 Unicode 字符串的指针。

ppbOutput [out]

接收属性值的缓冲区的地址。

函数的调用方必须通过调用 SslFreeBuffer 函数释放此缓冲区。

azureOutput [out]

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

ppEnumState [in， out]

VOID 指针的地址，该指针接收在对此函数的后续调用中使用的枚举状态信息。 此信息仅对 SSL 提供程序有意义，对调用方不透明。 SSL 提供程序使用此信息来确定枚举中的下一项。 如果此参数指向的变量包含 NULL，则从开头开始枚举。

函数的调用方必须通过调用 SslFreeBuffer 函数释放此内存。

dwFlags [in]

此参数留待将来使用。

返回值

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

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

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

返回代码/值 描述
NTE_NO_MEMORY
0x8009000EL
 没有足够的内存可用于分配必要的缓冲区。
NTE_INVALID_HANDLE
0x80090026L
 hSslProvider 句柄无效。
NTE_INVALID_PARAMETER
0x80090027L
 提供的参数之一无效。

要求

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