Compartilhar via


estrutura TLS_PARAMETERS (schannel.h)

Indica restrições de parâmetro TLS.

Sintaxe

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

Membros

cAlpnIds

O número de IDs ALPN em rgstrAlpnIds.

Defina como 0 se as restrições de parâmetro a seguir se aplicarem independentemente do protocolo de aplicativo negociado. É um erro especificar mais de SCH_CRED_MAX_SUPPORTED_ALPN_IDS.

rgstrAlpnIds

Uma matriz de IDs ALPN às quais os parâmetros a seguir se aplicam.

Defina como NULL se as restrições de parâmetro se aplicarem independentemente do protocolo de aplicativo negociado.

grbitDisabledProtocols

A cadeia de caracteres de bits que representa os protocolos desabilitados.

Defina como 0 para usar os padrões do sistema. Os sinalizadores de protocolo Schannel estão documentados aqui.

cDisabledCrypto

A contagem de entradas na matriz pDisabledCrypto. É um erro especificar mais de SCH_CRED_MAX_SUPPORTED_CRYPTO_SETTINGS.

pDisabledCrypto

Uma matriz de ponteiros para as estruturas de CRYPTO_SETTINGS que expressam configurações criptográficas desabilitadas.

dwFlags

(opcional) Os sinalizadores a serem passados.

Quando TLS_PARAMS_OPTIONAL estiver definido, TLS_PARAMETERS só será honrado se não fizer com que o servidor encerre o handshake.

Caso contrário, o schannel poderá falhar nos handshakes do TLS para cumprir as restrições de TLS_PARAMETERS.

Observação

TLS_PARAMS_OPTIONAL é válido apenas para aplicativos de servidor. Deve ser zero caso contrário.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10 1809 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 1809 [somente aplicativos da área de trabalho]
Cabeçalho schannel.h

Confira também

SCH_CREDENTIALS

CRYPTO_SETTINGS