SslEnumProtocolProviders 函数

SslEnumProtocolProviders 函数返回已安装的安全套接字层协议 (SSL) 协议提供程序的数组。

语法

SECURITY_STATUS WINAPI SslEnumProtocolProviders(
  _Out_ DWORD              *pdwProviderCount,
  _Out_ NCryptProviderName **ppProviderList,
  _In_  DWORD              dwFlags
);

参数

pdwProviderCount [out]

指向 DWORD 值的指针,用于接收返回的协议提供程序数。

ppProviderList [out]

指向接收 NCryptProviderName 结构数组的缓冲区的指针。

dwFlags [in]

此参数留待将来使用。

返回值

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

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

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

返回代码/值 说明
NTE_BAD_FLAGS
0x80090009L
dwFlags 参数不为零。
NTE_NO_MEMORY
0x8009000EL
没有足够的内存可用于分配必要的缓冲区。
NTE_INVALID_PARAMETER
0x80090027L
pdwProviderCountppProviderList 参数为 NULL

备注

使用完 NCryptProviderName 结构数组后,调用 SslFreeBuffer 函数以释放数组。

要求

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