ISecurityCallContext
COMIDispatch (デュアル)comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。公式ドキュメント
現在の呼び出しのセキュリティ呼び出しコンテキストに関する情報と、セキュリティメソッドへのアクセスを提供します。
メソッド 6
vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。
セキュリティコンテキストコレクション内のプロパティ数を取得します。
| plCount | INT* | out | 名前付きセキュリティ呼び出しコンテキストプロパティの数。 |
戻り値
このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、E_FAIL、S_OK を返すことがあります。
セキュリティ呼び出しコンテキストコレクション内の指定されたプロパティを取得します。
| name | LPWSTR | in | 取得するプロパティ項目の名前。利用可能な項目については「解説」を参照してください。 |
| pItem | VARIANT* | out | 取得されたプロパティへの参照。 |
戻り値
このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、E_FAIL、S_OK を返すことがあります。
解説(Remarks)
セキュリティ呼び出しコンテキストコレクションは、セキュリティ呼び出しコンテキストを表します。これは、現在の呼び出しで終わる呼び出しの連鎖における呼び出し元に関する情報を提供します。セキュリティ呼び出しコンテキストコレクション内の各項目について、次の表に、説明、取得に使用するインデックス名、および項目の戻りデータ型を示します。
| 項目 | 説明 | インデックス名 | 戻り値の型 |
|---|---|---|---|
| 直接の呼び出し元 | オブジェクトの直接の呼び出し元。 | "DirectCaller" | SecurityIdentity オブジェクト |
| 元の呼び出し元 | オブジェクトへの呼び出しの連鎖を開始した呼び出し元。 | "OriginalCaller" | SecurityIdentity オブジェクト |
| 最小認証レベル | 呼び出しの連鎖で使用された最も低い認証レベル。 | "MinAuthenticationLevel" | Long |
| 呼び出し元の数 | オブジェクトへの呼び出しの連鎖における呼び出し元の数。 | "NumCallers" | Long |
| 呼び出し元 | 現在の呼び出しで終わる呼び出しの連鎖における呼び出し元。 | "Callers" | SecurityCallers オブジェクト |
セキュリティ呼び出しコンテキストコレクションの列挙子を取得します。
| ppEnum | IUnknown** | out | 返される IEnumVARIANT インターフェースへの参照。 |
戻り値
このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、E_FAIL、S_OK を返すことがあります。
直接の呼び出し元が指定されたロールに属しているかどうかを判断します。
| bstrRole | LPWSTR | in | ロールの名前。 |
| pfInRole | VARIANT_BOOL* | out | 呼び出し元が指定されたロールに属している場合は TRUE、そうでない場合は FALSE。指定されたロールがアプリケーションに定義されていない場合は FALSE が返されます。ロールベースセキュリティが有効でない場合、このパラメーターは TRUE に設定されます。 |
戻り値
このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、E_FAIL を返すことがあるほか、次の値を返すことがあります。
| 戻りコード | 説明 |
|---|---|
| bstrRole パラメーターで指定されたロールは認識されているロールであり、pfIsInRole パラメーターで返されるブール値の結果は、呼び出し元がそのロールに属しているかどうかを示します。 | |
| bstrRole パラメーターで指定されたロールは存在しません。 |
解説(Remarks)
呼び出し元が指定されたロールのメンバーでない限り実行すべきでないコードのセクションへのアクセスを制限するには、このメソッドを使用します。Windows のグループおよびユーザーは、コンポーネントサービス管理ツールを使用してアプリケーションのロールに割り当てられます。ロールの詳細については、ロールベースセキュリティを参照してください。
IsCallerInRole は、現在実行中のメソッドの直接の呼び出し元にのみ適用されます。IsCallerInRole は、現在のメソッドの呼び出し元となった呼び出しシーケンス内のその他の呼び出し元には適用されません。ただし、get_Item プロパティメソッドを使用してセキュリティ呼び出しコンテキストオブジェクトの Callers プロパティを取得することで、シーケンス内の他の呼び出し元に関する情報を取得できます。
ロールベースセキュリティが有効でない場合、IsCallerInRole は TRUE になるため、IsCallerInRole が有用な情報を返すことを確実にするには、IsCallerInRole を呼び出す前に IsSecurityEnabled を呼び出すことをお勧めします。
オブジェクトに対してセキュリティが有効かどうかを判断します。
| pfIsEnabled | VARIANT_BOOL* | out | アプリケーションがロールベースセキュリティを使用し、現在オブジェクトに対してロールチェックが有効になっている場合は TRUE、そうでない場合は FALSE。 |
戻り値
このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、E_FAIL、S_OK を返すことがあります。
解説(Remarks)
COM+ アプリケーションは、ロールベースセキュリティまたはプロセスアクセス許可という 2 種類のセキュリティのいずれかを使用できます。アプリケーションがロールベースセキュリティを使用しているものの、アプリケーションレベルまたはコンポーネントレベルで現在無効になっている場合、pfIsEnabled は FALSE になります。同様に、COM+ アプリケーションがロールベースセキュリティの代わりにプロセスアクセス許可を使用している場合も、pfIsEnabled は FALSE になります。
IsCallerInRole を使用してロールのメンバーシップを確認する前に、このメソッドを使用してロールベースセキュリティが有効かどうかを調べることができます。これを行う理由は、ロールベースセキュリティが有効でない場合、IsCallerInRole が TRUE になるためです。
指定されたユーザーが指定されたロールに属しているかどうかを判断します。
| pUser | VARIANT* | in | ロールのメンバーシップを確認するユーザーのユーザー ID を保持する値へのポインター。セキュリティ識別子 (SID) を IsUserInRole に渡す場合、このパラメーターは次の要件を満たす必要があります: V_VT(pUser) == (VT_ARRAY|VT_UI1) && V_ARRAY(pUser)->cDims == 1。 |
| bstrRole | LPWSTR | in | ロールの名前。 |
| pfInRole | VARIANT_BOOL* | out | ユーザーが指定されたロールに属している場合は TRUE、そうでない場合は FALSE。指定されたロールがアプリケーションに定義されていない場合は FALSE が返されます。ロールベースセキュリティが有効でない場合、このパラメーターは TRUE に設定されます。 |
戻り値
このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、E_FAIL を返すことがあるほか、次の値を返すことがあります。
| 戻りコード | 説明 |
|---|---|
| bstrRole パラメーターで指定されたロールは認識されているロールであり、pfIsInRole パラメーターで返されるブール値の結果は、ユーザーがそのロールに属しているかどうかを示します。 | |
| bstrRole パラメーターで指定されたロールは存在しません。 |
解説(Remarks)
呼び出し元が指定されたロールのメンバーでない限り実行すべきでないコードのセクションへのアクセスを制限するには、このメソッドを使用します。Windows のグループおよびユーザーは、コンポーネントサービス管理ツールを使用してアプリケーションのロールに割り当てられます。ロールの詳細については、ロールベースセキュリティを参照してください。
ロールベースセキュリティが有効でない場合、IsUserInRole は TRUE になるため、IsUserInRole が有用な情報を返すことを確実にするには、IsUserInRole を呼び出す前に IsSecurityEnabled を呼び出すことをお勧めします。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_ISecurityCallContext "{CAFC823E-B441-11D1-B82B-0000F8757E2A}" #usecom global ISecurityCallContext IID_ISecurityCallContext "{ECABB0A7-7F19-11D2-978E-0000F8757E2A}" #comfunc global ISecurityCallContext_get_Count 7 var #comfunc global ISecurityCallContext_get_Item 8 wstr,var #comfunc global ISecurityCallContext_get__NewEnum 9 sptr #comfunc global ISecurityCallContext_IsCallerInRole 10 wstr,var #comfunc global ISecurityCallContext_IsSecurityEnabled 11 var #comfunc global ISecurityCallContext_IsUserInRole 12 var,wstr,var ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。 ; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_ISecurityCallContext "{CAFC823E-B441-11D1-B82B-0000F8757E2A}" #usecom global ISecurityCallContext IID_ISecurityCallContext "{ECABB0A7-7F19-11D2-978E-0000F8757E2A}" #comfunc global ISecurityCallContext_get_Count 7 sptr #comfunc global ISecurityCallContext_get_Item 8 wstr,sptr #comfunc global ISecurityCallContext_get__NewEnum 9 sptr #comfunc global ISecurityCallContext_IsCallerInRole 10 wstr,sptr #comfunc global ISecurityCallContext_IsSecurityEnabled 11 sptr #comfunc global ISecurityCallContext_IsUserInRole 12 sptr,wstr,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。 ; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。