структура TLS_PARAMETERS (schannel.h)

Статья
08/25/2023

Указывает ограничения параметров TLS.

Синтаксис

typedef struct _TLS_PARAMETERS {
  DWORD            cAlpnIds;
  PUNICODE_STRING  rgstrAlpnIds;
  DWORD            grbitDisabledProtocols;
  DWORD            cDisabledCrypto;
  PCRYPTO_SETTINGS pDisabledCrypto;
  DWORD            dwFlags;
} TLS_PARAMETERS, *PTLS_PARAMETERS;

Члены

cAlpnIds

Число идентификаторов ALPN в rgstrAlpnIds.

Установите значение 0, если следующие ограничения параметров применяются независимо от согласованного протокола приложения. Указание более SCH_CRED_MAX_SUPPORTED_ALPN_IDS является ошибкой.

rgstrAlpnIds

Массив идентификаторов ALPN, к которым применяются следующие параметры.

Установите значение NULL, если ограничения параметров применяются независимо от согласованного протокола приложения.

grbitDisabledProtocols

Битовая строка, представляющая отключенные протоколы.

Задайте значение 0, чтобы использовать системные значения по умолчанию. Флаги протокола Schannel описаны здесь.

cDisabledCrypto

Количество записей в массиве pDisabledCrypto. Указание более SCH_CRED_MAX_SUPPORTED_CRYPTO_SETTINGS является ошибкой.

pDisabledCrypto

Массив указателей на CRYPTO_SETTINGS структуры, которые выражают отключенные параметры шифрования.

dwFlags

(необязательно) Флаги для передачи.

Если задано TLS_PARAMS_OPTIONAL, TLS_PARAMETERS будут учитываться только в том случае, если они не приводят к завершению подтверждения сервером.

В противном случае schannel может завершиться ошибкой подтверждения TLS, чтобы соблюдать ограничения TLS_PARAMETERS.

Примечание

TLS_PARAMS_OPTIONAL допустимо только для серверных приложений. В противном случае должно быть равно нулю.

Требования

Требование	Значение
Минимальная версия клиента	Windows 10 1809 [только классические приложения]
Минимальная версия сервера	Windows Server 1809 [только классические приложения]
Верхняя часть	schannel.h

См. также раздел

SCH_CREDENTIALS

CRYPTO_SETTINGS

Поделиться через