Функция SslLookupCipherLengths

  • Статья

Функция SslLookupCipherLengths возвращает структуру NCRYPT_SSL_CIPHER_LENGTHS , содержащую длину заголовка и трейлера входного протокола, набора шифров и типа ключа.

Синтаксис

SECURITY_STATUS WINAPI SslLookupCipherLengths(
  _In_  NCRYPT_PROV_HANDLE        hSslProvider,
  _In_  DWORD                     dwProtocol,
  _In_  DWORD                     dwCipherSuite,
  _In_  DWORD                     dwKeyType,
  _Out_ NCRYPT_SSL_CIPHER_LENGTHS *pCipherLengths,
  _In_  DWORD                     cbCipherLengths,
  _In_  DWORD                     dwFlags
);

Параметры

hSslProvider [in]

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

dwProtocol [in]

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

dwCipherSuite [in]

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

dwKeyType [in]

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

pCipherLengths [out]

Указатель на буфер для получения структуры NCRYPT_SSL_CIPHER_LENGTHS .

cbCipherLengths [in]

Длина (в байтах) буфера, на который указывает параметр pCipherLengths .

dwFlags [in]

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

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

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

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

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

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

Комментарии

Функция SslLookupCipherLengths вызывается для протоколов TLS 1.1 или более поздних версий для запроса длины заголовка и трейлера для запрошенного протокола, набора шифров и типа ключа.

Требования

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