Share via

SslOpenProvider 函数

  • 项目

SslOpenProvider 函数打开指定安全套接字层协议的句柄 (SSL) 协议提供程序。

语法

SECURITY_STATUS WINAPI SslOpenProvider(
  _Out_ NCRYPT_PROV_HANDLE *phSslProvider,
  _In_  LPCWSTR            pszProviderName,
  _In_  DWORD              dwFlags
);

参数

phSslProvider [out]

要在其中写入提供程序句柄 的NCRYPT_PROV_HANDLE 的地址。

使用完句柄后，应通过调用 SslFreeObject 函数来释放它。

pszProviderName [in]

指向包含提供程序名称的 Unicode 字符串的指针。 如果此参数的值为 NULL，则返回 MS_SCHANNEL_PROVIDER 的句柄。

dwFlags [in]

此参数保留供将来使用，并且必须设置为零。

返回值

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

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

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

返回代码/值 说明
NTE_INVALID_HANDLE
0x80090026L
 提供的句柄之一无效。
NTE_INVALID_PARAMETER
0x80090027L
 phSslProvider 或 ppProviderList 参数为 NULL。
STATUS_NO_MEMORY
0xC0000017L
 没有足够的内存可用于分配必要的缓冲区。

要求

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