Функция SslCreateClientAuthHash

  • Статья

Функция SslCreateClientAuthHash извлекает дескриптор хэша подтверждения, используемого для проверки подлинности клиента.

Синтаксис

SECURITY_STATUS WINAPI SslCreateClientAuthHash(
  _In_  NCRYPT_PROV_HANDLE hSslProvider,
  _Out_ NCRYPT_HASH_HANDLE *phHandshakeHash,
  _In_  DWORD              dwProtocol,
  _In_  DWORD              dwCipherSuite,
  _In_  LPCWSTR            pszHashAlgId,
  _In_  DWORD              dwFlags
);

Параметры

hSslProvider [in]

Дескриптор экземпляра поставщика протокола SSL.

phHandshakeHash [out]

Указатель на переменную NCRYPT_HASH_HANDLE для получения хэш-дескриптора.

dwProtocol [in]

Одно из значений идентификатора протокола поставщика SSL CNG .

dwCipherSuite [in]

Одно из значений идентификатора комплекта шифров поставщика SSL CNG .

pszHashAlgId [in]

Одно из значений идентификаторов алгоритма CNG .

dwFlags [in]

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

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

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

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

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

Возвращаемый код/значение Описание
NTE_INVALID_HANDLE
0x80090026L
 Параметр hSslProvider содержит недопустимый указатель.
NTE_INVALID_PARAMETER
0x80090027L
 Параметр phHandshakeHash имеет значение NULL.
NTE_NOT_SUPPORTED
0x80090029L
 Выбранная функция не поддерживается в указанной версии интерфейса.
NTE_NO_MEMORY
0x8009000EL
 Недостаточно памяти для выделения буферов.
NTE_BAD_FLAGS
0x80090009L
 Параметру dwFlags необходимо задать нулевое значение.

Комментарии

Функция SslCreateClientAuthHash вызывается для бесед по протоколу TLS 1.2 или более поздней версии для создания хэш-объектов, которые используются для хэш-подтверждения сообщений. Он вызывается один раз для каждого возможного алгоритма хэширования , который можно использовать в сигнатуре проверки подлинности клиента.

Требования

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