TLS_PARAMETERS structure (schannel.h)

  • Article

Indique des restrictions de paramètres TLS.

Syntaxe

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

Membres

cAlpnIds

Nombre d’ID ALPN dans rgstrAlpnIds.

Définissez la valeur 0 si les restrictions de paramètre suivantes s’appliquent quel que soit le protocole d’application négocié. Le fait de spécifier plus de SCH_CRED_MAX_SUPPORTED_ALPN_IDS est une erreur.

rgstrAlpnIds

Tableau d’ID ALPN auxquels s’appliquent les paramètres suivants.

Définissez sur NULL si les restrictions de paramètre s’appliquent quel que soit le protocole d’application négocié.

grbitDisabledProtocols

Chaîne de bits qui représente les protocoles désactivés.

Définissez sur 0 pour utiliser les valeurs système par défaut. Les indicateurs de protocole Schannel sont documentés ici.

cDisabledCrypto

Nombre d’entrées dans le tableau pDisabledCrypto. Le fait de spécifier plus de SCH_CRED_MAX_SUPPORTED_CRYPTO_SETTINGS est une erreur.

pDisabledCrypto

Tableau de pointeurs vers les structures CRYPTO_SETTINGS qui expriment des paramètres de chiffrement désactivés.

dwFlags

(facultatif) Indicateurs à passer.

Lorsque TLS_PARAMS_OPTIONAL est défini, TLS_PARAMETERS ne sont respectés que s’ils n’entraînent pas l’arrêt de l’établissement d’une liaison par le serveur.

Dans le cas contraire, schannel risque d’échouer à l’établissement d’une liaison TLS afin de respecter les restrictions TLS_PARAMETERS.

Notes

TLS_PARAMS_OPTIONAL est valide uniquement pour les applications serveur. Doit être égal à zéro dans le cas contraire.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10 1809 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 1809 [applications de bureau uniquement]
En-tête schannel.h

Voir aussi

SCH_CREDENTIALS

CRYPTO_SETTINGS