Функция 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]
-
phHandshakeHash [out]
-
Указатель на переменную NCRYPT_HASH_HANDLE для получения хэш-дескриптора.
-
dwProtocol [in]
-
Одно из значений идентификатора протокола поставщика SSL CNG .
-
dwCipherSuite [in]
-
Одно из значений идентификатора комплекта шифров поставщика SSL CNG .
-
pszHashAlgId [in]
-
Одно из значений идентификаторов алгоритма CNG .
-
dwFlags [in]
-
Этот параметр зарезервирован для использования в будущем и должен иметь нулевое значение.
Возвращаемое значение
Если функция завершается успешно, она возвращает ноль.
Если функция завершается сбоем, она возвращает ненулевое значение ошибки.
Возможные коды возврата включают, помимо прочего, следующие.
| Возвращаемый код/значение | Описание |
|---|---|
|
Параметр hSslProvider содержит недопустимый указатель. |
|
Параметр phHandshakeHash имеет значение NULL. |
|
Выбранная функция не поддерживается в указанной версии интерфейса. |
|
Недостаточно памяти для выделения буферов. |
|
Параметру dwFlags необходимо задать нулевое значение. |
Комментарии
Функция SslCreateClientAuthHash вызывается для бесед по протоколу TLS 1.2 или более поздней версии для создания хэш-объектов, которые используются для хэш-подтверждения сообщений. Он вызывается один раз для каждого возможного алгоритма хэширования , который можно использовать в сигнатуре проверки подлинности клиента.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows 7 [только классические приложения] |
| Минимальная версия сервера |
Windows Server 2008 R2 [только классические приложения] |
| Заголовок |
|
| DLL |
|