IGetSecurityCallContext::GetSecurityCallContext メソッド (comsvcs.h)
現在の呼び出しに関連付けられている SecurityCallContext クラスから作成されたオブジェクトへの参照を取得します。
このメソッドを使用する代わりに、C++ 開発者は CoGetCallContext 関数を使用し、 riid パラメーターにIID_ISecurityCallContextを指定する必要があります。
構文
HRESULT GetSecurityCallContext(
[out] ISecurityCallContext **ppObject
);
パラメーター
[out] ppObject
オブジェクトのコンテキストでの ISecurityCallContext への参照。
戻り値
このメソッドは、E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、E_FAILの標準戻り値と、次の値を返すことができます。
| リターン コード | 説明 |
|---|---|
|
メソッドは正常に完了しました。 |
|
コンポーネントがアプリケーションにインポートされていないか、COM+ CreateInstance メソッドのいずれかでオブジェクトが作成されていないため、現在のオブジェクトにはコンテキストが関連付けられません。 このエラーは、GetObjectContext メソッドがコンストラクターまたは IUnknown メソッドから呼び出された場合にも返されます。 |
解説
オブジェクトのセキュリティ呼び出しコンテキストを使用すると、セキュリティ呼び出しコンテキスト コレクション内の項目 (最小認証レベル、直接呼び出し元、元の呼び出し元、呼び出し元のチェーン、呼び出し元の数など) を取得できます。 IsSecurityEnabled メソッドと IsCallerInRole メソッドを呼び出して、コードの特定のセクションが確実に実行されるようにすることもできます。 ただし、これらのメソッドを呼び出すことができるのは、ロールベースのセキュリティが有効になっている場合と、直接呼び出し元が指定されたロールのメンバーである場合のみです。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | comsvcs.h |