Функция SslGetCipherSuitePRFHashAlgorithm

  • Статья

Функция SslGetCipherSuitePRFHashAlgorithm возвращает api шифрования: код алгоритма следующего поколения (CNG) алгоритма хэширования, который используется для псевдослучайной функциипротокола TLS (PRF) для входного протокола, набора шифров и типа ключа.

Синтаксис

SECURITY_STATUS WINAPI SslGetCipherSuitePRFHashAlgorithm(
  _In_  NCRYPT_PROV_HANDLE hSslProvider,
  _In_  DWORD              dwProtocol,
  _In_  DWORD              dwCipherSuite,
  _In_  DWORD              dwKeyType,
  _Out_ WCHAR              szPRFHash[NCRYPT_SSL_MAX_NAME_SIZE],
  _In_  DWORD              dwFlags
);

Параметры

hSslProvider [in]

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

dwProtocol [in]

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

dwCipherSuite [in]

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

dwKeyType [in]

Одно из значений идентификатора типа ключа поставщика SSL CNG . Для типов ключей, которые не являются криптографией с эллиптических кривых (ECC), задайте для этого параметра нулевое значение.

szPRFHash [out]

Один из идентификаторов алгоритма CNG для хэша, который будет использоваться для TLS PRF.

dwFlags [in]

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

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

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

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

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

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

Комментарии

Эта функция SslGetCipherSuitePRFHashAlgorithm вызывается для бесед TLS 1.2 или более поздней версии для запроса алгоритма хэширования, который будет использоваться в TLS PRF.

Требования

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