Функция 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
);
Параметры
-
hSslProvider [in]
-
Дескриптор поставщика протокола SSL , для которого извлекается свойство .
-
pszProperty [in]
-
Указатель на строку Юникода, завершающуюся null, которая содержит имя извлекаемого свойства.
-
ppbOutput [out]
-
Адрес буфера, получающего значение свойства.
Вызывающий объект функции должен освободить этот буфер, вызвав функцию SslFreeBuffer .
-
pcbOutput [out]
-
Размер буфера pbOutput в байтах.
-
ppEnumState [in, out]
-
Адрес указателя VOID , получающего сведения о состоянии перечисления, которые используются в последующих вызовах этой функции. Эти сведения имеют значение только для поставщика SSL и непрозрачны для вызывающей стороны. Поставщик SSL использует эти сведения, чтобы определить, какой элемент является следующим в перечислении. Если переменная, на которую указывает этот параметр, содержит значение NULL, перечисление запускается с самого начала.
Вызывающий объект функции должен освободить эту память, вызвав функцию SslFreeBuffer .
-
dwFlags [in]
-
Этот параметр зарезервирован для использования в будущем.
Возвращаемое значение
Если функция завершается успешно, она возвращает ноль.
Если функция завершается сбоем, она возвращает ненулевое значение ошибки.
Возможные коды возврата включают, помимо прочего, следующие.
| Возвращаемый код/значение | Описание |
|---|---|
|
Недостаточно памяти для выделения необходимых буферов. |
|
Недопустимый дескриптор hSslProvider . |
|
Один из предоставленных параметров недопустим. |
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows Vista [только классические приложения] |
| Минимальная версия сервера |
Windows Server 2008 [только классические приложения] |
| Заголовок |
|
| DLL |
|