ApplyControlToken 関数 (sspi.h)
ApplyControlToken 関数は、コントロール トークンをセキュリティ コンテキストに適用する方法を提供します。 セキュリティ コンテキストが InitializeSecurityContext (Schannel) 関数の呼び出しによって確立されている場合、またはメッセージごとのセキュリティ サービス (検証やシール解除など) を使用して、トークンを受信できます。
この関数は、Schannel セキュリティ サポート プロバイダー (SSP) でのみサポートされます。
この関数はカーネル モードではサポートされていません。
この関数を使用すると、コンテキストに追加または置換のトークンを適用できます。
構文
KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY ApplyControlToken(
[in] PCtxtHandle phContext,
[in] PSecBufferDesc pInput
);
パラメーター
[in] phContext
トークンが適用されるコンテキストへのハンドル。
Schannel SSP がリモート パーティにシャットダウンを通知する方法については、「 DecryptMessage (Schannel)」の「備考」セクションを参照してください。 この関数の使用方法の詳細については、「 Schannel 接続のシャットダウン」を参照してください。
[in] pInput
コンテキストに適用する入力トークンを含む SecBuffer 構造体へのポインターを含む SecBufferDesc 構造体へのポインター。
戻り値
関数が成功した場合、関数はSEC_E_OKを返します。
関数が失敗すると、0 以外のエラー コードが返されます。 次のエラー コードは、返される可能性のあるエラー コードの 1 つです。
| リターン コード | 説明 |
|---|---|
|
この値は、この関数がサポートされていないことを示すために、Schannel カーネル モードによって返されます。 |
注釈
ApplyControlToken 関数は、このトークンに基づいてコンテキストを変更できます。 この関数がクライアント コンテキストに追加できるトークンの中には 、SCHANNEL_ALERT_TOKEN と SCHANNEL_SESSION_TOKENがあります。
この関数を使用して、既存の Schannel 接続の基になる セキュリティ コンテキスト をシャットダウンできます。 これを行う方法については、「 Schannel 接続のシャットダウン」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | sspi.h (Security.h を含む) |
| Library | Secur32.lib |
| [DLL] | Secur32.dll |