IGetSecurityCallContext
COMIDispatch (デュアル)comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。公式ドキュメント
現在の呼び出しに関連付けられた SecurityCallContext クラスから作成されたオブジェクトへの参照を取得します。(IGetSecurityCallContext)
メソッド 1
vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。
現在の呼び出しに関連付けられた SecurityCallContext クラスから作成されたオブジェクトへの参照を取得します。(IGetSecurityCallContext.GetSecurityCallContext)
| ppObject | ISecurityCallContext** | out | オブジェクトのコンテキスト上の ISecurityCallContext への参照。 |
戻り値
このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、および E_FAIL に加えて、次の値を返すことがあります。
| 戻り値 | 説明 |
|---|---|
| メソッドは正常に完了しました。 | |
| コンポーネントがアプリケーションにインポートされていない、またはオブジェクトが COM+ の CreateInstance メソッドのいずれかで作成されていないため、現在のオブジェクトにはコンテキストが関連付けられていません。このエラーは、GetObjectContext メソッドがコンストラクターまたは IUnknown メソッドから呼び出された場合にも返されます。 |
解説(Remarks)
オブジェクトのセキュリティ呼び出しコンテキストを使用すると、最小認証レベル、直接の呼び出し元、元の呼び出し元、呼び出し元のチェーン、呼び出し元の数など、セキュリティ呼び出しコンテキストコレクション内の項目を取得できます。また、IsSecurityEnabled メソッドおよび IsCallerInRole メソッドを呼び出して、特定のコードセクションが確実に実行されるようにすることもできます。ただし、これらのメソッドを呼び出せるのは、ロールベースのセキュリティが有効であり、かつ直接の呼び出し元が指定されたロールのメンバーである場合に限られます。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IGetSecurityCallContext "{CAFC823F-B441-11D1-B82B-0000F8757E2A}"
#usecom global IGetSecurityCallContext IID_IGetSecurityCallContext "{}"
#comfunc global IGetSecurityCallContext_GetSecurityCallContext 7 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。