SCHANNEL_ALERT_TOKEN structure (schannel.h)

Article
03/01/2024

Génère une alerte SSL (Secure Sockets Layer Protocol) ou TLS (Transport Layer Security Protocol) à envoyer à la cible d’un appel à la fonction InitializeSecurityContext (Schannel) ou AcceptSecurityContext (Schannel).

Syntaxe

typedef struct _SCHANNEL_ALERT_TOKEN {
  DWORD dwTokenType;
  DWORD dwAlertType;
  DWORD dwAlertNumber;
} SCHANNEL_ALERT_TOKEN;

Membres

dwTokenType

Spécifie le type de cette structure. Définissez la valeur de ce membre sur SCHANNEL_ALERT.

dwAlertType

Spécifie le type d’alerte. Il doit s’agir de l’une des valeurs suivantes.

Valeur	Signification
TLS1_ALERT_WARNING 1	Le message est un avertissement.
TLS1_ALERT_FATAL 2	Le message est une erreur irrécupérable. La connexion est fermée immédiatement.

dwAlertNumber

Un des messages d’alerte définis par la spécification du protocole TLS. Pour obtenir une description des messages définis, consultez RFC 5246, RFC 4346 ou RFC 2246. Ce membre doit être l’une des valeurs suivantes.

TLS1_ALERT_CLOSE_NOTIFY (0)

TLS1_ALERT_UNEXPECTED_MESSAGE (10)

TLS1_ALERT_BAD_RECORD_MAC (20)

TLS1_ALERT_DECRYPTION_FAILED (21)

TLS1_ALERT_RECORD_OVERFLOW (22)

TLS1_ALERT_DECOMPRESSION_FAIL (30)

TLS1_ALERT_HANDSHAKE_FAILURE (40)

TLS1_ALERT_BAD_CERTIFICATE (42)

TLS1_ALERT_UNSUPPORTED_CERT (43)

TLS1_ALERT_CERTIFICATE_REVOKED (44)

TLS1_ALERT_CERTIFICATE_EXPIRED (45)

TLS1_ALERT_CERTIFICATE_UNKNOWN (46)

TLS1_ALERT_ILLEGAL_PARAMETER (47)

TLS1_ALERT_UNKNOWN_CA (48)

TLS1_ALERT_ACCESS_DENIED (49)

TLS1_ALERT_DECODE_ERROR (50)

TLS1_ALERT_DECRYPT_ERROR (51)

TLS1_ALERT_EXPORT_RESTRICTION (60)

TLS1_ALERT_PROTOCOL_VERSION (70)

TLS1_ALERT_INSUFFIENT_SECURITY (71)

TLS1_ALERT_INTERNAL_ERROR (80)

TLS1_ALERT_USER_CANCELED (90)

TLS1_ALERT_NO_RENEGOTIATION (100)

TLS1_ALERT_UNSUPPORTED_EXT (110)

Remarques

Ajoutez un message d’alerte à un contexte client en utilisant cette structure comme valeur du paramètre pInput dans un appel à la fonction ApplyControlToken .

Configuration requise

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

Partager via