Функция SslGetProviderProperty

Статья
06/13/2023

Функция 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]

Этот параметр зарезервирован для использования в будущем.

Возвращаемое значение

Если функция завершается успешно, она возвращает ноль.

Если функция завершается сбоем, она возвращает ненулевое значение ошибки.

Возможные коды возврата включают, помимо прочего, следующие.

Возвращаемый код/значение	Описание
NTE_NO_MEMORY 0x8009000EL	Недостаточно памяти для выделения необходимых буферов.
NTE_INVALID_HANDLE 0x80090026L	Недопустимый дескриптор hSslProvider .
NTE_INVALID_PARAMETER 0x80090027L	Один из предоставленных параметров недопустим.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Заголовок	Sslprovider.h
DLL	Ncrypt.dll