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]
-
此参数留待将来使用。
返回值
如果函数成功，则返回零。
如果函数失败，则返回非零错误值。
可能的返回代码包括但不限于以下代码。
| 返回代码/值 | 描述 |
|---|---|
|
没有足够的内存可用于分配必要的缓冲区。 |
|
hSslProvider 句柄无效。 |
|
提供的参数之一无效。 |
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows Vista [仅限桌面应用] |
| 最低受支持的服务器 |
Windows Server 2008 [仅限桌面应用] |
| 标头 |
|
| DLL |
|