SCHANNEL_ALERT_TOKEN 结构 (schannel.h)

项目
08/25/2023

生成安全套接字层协议 (SSL) 或传输层安全协议， (TLS) 警报发送到调用 InitializeSecurityContext (Schannel) 函数或 AcceptSecurityContext (Schannel) 函数的目标。

语法

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

成员

dwTokenType

指定此结构的类型。将此成员的值设置为 SCHANNEL_ALERT。

dwAlertType

指定警报类型。这必须是以下值之一。

值	含义
TLS1_ALERT_WARNING 1	消息是警告。
TLS1_ALERT_FATAL 2	该消息是一个致命错误。连接会立即关闭。

dwAlertNumber

TLS 协议规范定义的警报消息之一。有关定义的消息的说明，请参阅 RFC 5246、 RFC 4346 或 RFC 2246。此成员必须是以下值之一。

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)

注解

在调用 ApplyControlToken 函数时，将此结构用作 pInput 参数的值，将警报消息添加到客户端上下文。

要求

要求	值
最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
标头	schannel.h

通过