IHostSecurityManager::SetSecurityContext メソッド

  • [アーティクル]

現在実行中のスレッドのセキュリティ コンテキストを設定します。

構文

HRESULT SetSecurityContext (  
    [in]  EContextType eContextType,  
    [out] IHostSecurityContext** ppSecurityContext  
);

パラメーター

eContextType
[in] EContextType 値の 1 つ。共通言語ランタイム (CLR) によりホストに配置されているコンテキストの種類を示します。

ppSecurityContext
[out] 新しい IHostSecurityContext オブジェクトのアドレスへのポインター。

戻り値

HRESULT 説明
S_OK SetSecurityContext が正常に返されました。
HOST_E_CLRNOTAVAILABLE CLR がプロセスに読み込まれていないか、CLR がマネージド コードを実行できないまたは呼び出しを正常に処理できない状態です。
HOST_E_TIMEOUT 呼び出しがタイムアウトになりました。
HOST_E_NOT_OWNER 呼び出し元がロックを所有していません。
HOST_E_ABANDONED ブロックされたスレッドまたはファイバーが待機しているときに、イベントが取り消されました。
E_FAIL 原因不明の致命的なエラーが発生しました。 メソッドにより E_FAIL が返されると、そのプロセス内で CLR が使用できなくなります。 後続のホスティング メソッドの呼び出しでは HOST_E_CLRNOTAVAILABLE が返されます。

解説

CLR によりいくつかのシナリオで SetSecurityContext が呼び出されます。 CLR では、クラス コンストラクターとモジュール コンストラクター、およびファイナライザーを実行する前に SetSecurityContext が呼び出され、ホストが実行エラーから保護されるようにします。 次に、SetSecurityContext への別の呼び出しを使用して、コンストラクターまたはファイナライザーの実行後に、セキュリティ コンテキストが元の状態にリセットされます。 同様のパターンは、I/O の完了時に発生します。 ホストにより IHostIoCompletionManager が実装された場合、ホストにより ICLRIoCompletionManager::OnComplete が呼び出された後に CLR により SetSecurityContext が呼び出されます。

ワーカー スレッドの非同期ポイントでは、ホストまたは CLR によってスレッド プールが実装されているかどうかに応じて、CLR によって ThreadPool.QueueUserWorkItem または IHostThreadPoolManager::QueueUserWorkItem 内の SetSecurityContext が呼び出されます。

必要条件

:「システム要件」を参照してください。

ヘッダー: MSCorEE.h

ライブラリ: MSCorEE.dll にリソースとして含まれます

.NET Framework のバージョン: 2.0 以降で使用可能

関連項目