ApplyControlToken 関数 (sspi.h)

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

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 つです。

リターンコード	説明
SEC_E_UNSUPPORTED_FUNCTION	この値は、この関数がサポートされていないことを示すために、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