SCHANNEL_ALERT_TOKEN 構造体 (schannel.h)

[アーティクル]
08/25/2023

InitializeSecurityContext (Schannel) 関数または AcceptSecurityContext (Schannel) 関数の呼び出しのターゲットに送信される Secure Sockets Layer Protocol (SSL) またはトランスポート層セキュリティプロトコル (TLS) アラートを生成します。

構文

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 プロトコル仕様によって定義されたアラートメッセージの 1 つ。定義されたメッセージの説明については、 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 (デスクトップアプリのみ)
Header	schannel.h

次の方法で共有