次の方法で共有


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

リターン コード 説明
SEC_E_UNSUPPORTED_FUNCTION
この値は、この関数がサポートされていないことを示すために、Schannel カーネル モードによって返されます。

注釈

ApplyControlToken 関数は、このトークンに基づいてコンテキストを変更できます。 この関数がクライアント コンテキストに追加できるトークンの中には 、SCHANNEL_ALERT_TOKENSCHANNEL_SESSION_TOKENがあります。

この関数を使用して、既存の Schannel 接続の基になる セキュリティ コンテキスト をシャットダウンできます。 これを行う方法については、「 Schannel 接続のシャットダウン」を参照してください。

要件

要件
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー sspi.h (Security.h を含む)
Library Secur32.lib
[DLL] Secur32.dll

こちらもご覧ください

DecryptMessage (Schannel)

ImpersonateSecurityContext

SCHANNEL_ALERT_TOKEN

SCHANNEL_SESSION_TOKEN

SSPI 関数

SecBuffer

SecBufferDesc