Поделиться через

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

Указатель на строку Юникода, содержащую имя поставщика. Если значение этого параметра равно 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