Функция SslCreateHandshakeHash

Функция SslCreateHandshakeHash получает хэш-дескриптор, который используется для хэширования сообщений подтверждения.

Синтаксис

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

Параметры

hSslProvider [in]

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

phHandshakeHash [out]

Хэш-дескриптор, который можно передать другим функциям поставщика SSL.

dwProtocol [in]

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

Примечание

Эта функция не используется с протоколом SSL 2.0.

dwCipherSuite [in]

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

dwFlags [in]

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

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

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

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

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

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

Комментарии

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

1. Для получения хэш-дескриптора вызывается функция SslCreateHandshakeHash .
2. Функция SslHashHandshake вызывается любое количество раз с хэш-дескриптором для добавления данных в хэш.
3. Функция SslComputeFinishedHash вызывается с хэш-дескриптором для получения хэшированных данных.

Требования

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