ホーム › System.ComponentServices › ISecurityProperty

ISecurityProperty

COM

IID51372aea-cae7-11cf-be81-00aa00a2fa25継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

現在のオブジェクトの元の呼び出し元または直接の呼び出し元のセキュリティ識別子を判別します。ただし、オブジェクトの呼び出し元に関する情報を取得するための推奨される方法は、ISecurityCallContext インターフェースを使用することです。

メソッド 5

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT GetDirectCreatorSID(PSID* pSID)

MTS 2.0 では、このメソッドは現在のオブジェクトを直接作成した外部プロセスのセキュリティ識別子を取得します。COM+ ではこのメソッドを使用しないでください。

pSID

PSID*

inout

現在のオブジェクトを直接作成したプロセスのセキュリティ ID への参照。

戻り値

このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、E_FAIL に加えて、次の値を返すことができます。

戻り値	説明
S_OK	現在のオブジェクトを直接作成したプロセスのセキュリティ ID が、パラメーター pSid に返されます。
CONTEXT_E_NOCONTEXT	コンポーネントがアプリケーションにインポートされていないか、またはオブジェクトが COM+ の CreateInstance メソッドのいずれかで作成されていないため、現在のオブジェクトには関連付けられたコンテキストがありません。

vtbl 4 HRESULT GetOriginalCreatorSID(PSID* pSID)

MTS 2.0 では、このメソッドは、現在のオブジェクトが実行されているアクティビティを開始したベースプロセスのセキュリティ識別子を取得します。COM+ ではこのメソッドを使用しないでください。

pSID

PSID*

inout

現在のオブジェクトが実行されているアクティビティを開始したベースプロセスのセキュリティ ID への参照。

戻り値

このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、E_FAIL に加えて、次の値を返すことができます。

戻り値	説明
S_OK	元の作成元のセキュリティ ID が、パラメーター pSid に返されます。
CONTEXT_E_NOCONTEXT	コンポーネントがアプリケーションにインポートされていないか、またはオブジェクトが COM+ の CreateInstance メソッドのいずれかで作成されていないため、現在のオブジェクトには関連付けられたコンテキストがありません。

vtbl 5 HRESULT GetDirectCallerSID(PSID* pSID)

現在実行中のメソッドを呼び出した外部プロセスのセキュリティ識別子を取得します。

pSID

PSID*

inout

現在のメソッドが呼び出された元のプロセスのセキュリティ ID への参照。

戻り値

このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、E_FAIL に加えて、次の値を返すことができます。

戻り値	説明
S_OK	現在のメソッドを呼び出したプロセスのセキュリティ ID が、パラメーター pSid に返されます。
CONTEXT_E_NOCONTEXT	コンポーネントがアプリケーションにインポートされていないか、またはオブジェクトが COM+ の CreateInstance メソッドのいずれかで作成されていないため、現在のオブジェクトには関連付けられたコンテキストがありません。

解説(Remarks)

GetDirectCallerSID メソッドを使用して、オブジェクトの現在実行中のメソッドを呼び出したプロセスのセキュリティ ID を判別します。セキュリティはプロセス境界を越えて適用されます。つまり、GetDirectCallerSID が返すセキュリティ ID は、現在のオブジェクトが実行されているプロセスを呼び出したプロセスに関連付けられたセキュリティ ID であり、必ずしもオブジェクト自体を直接呼び出した呼び出し元とは限りません。あるオブジェクトが同じプロセス内の別のオブジェクトを呼び出した場合、2 番目のオブジェクトが GetDirectCallerSID を呼び出すと、自身のプロセス境界の外側にある最も直近の呼び出し元のセキュリティ ID が取得され、直接呼び出したオブジェクトのセキュリティ ID は取得されません。

次のシナリオは、GetDirectCallerSID メソッドの機能を示しています。

ユーザー A として Server A で実行されているベースプロセスが、ユーザー B として実行されている Server B 上の Object X を呼び出します。次に、Object X が Server C 上で実行されている Object Y を呼び出します。Object Y が GetDirectCallerSID を呼び出すと、ユーザー B のセキュリティ ID が返されます。
ユーザー A として Server A で実行されているベースプロセスが、ユーザー B として実行されている Server B 上の Object X を呼び出します。次に、Object X が、同じく Server B 上で Object X と同じプロセス内で実行されている Object Y を呼び出します。Object Y が GetDirectCallerSID を呼び出すと、ユーザー B のセキュリティ ID ではなく、ユーザー A のセキュリティ ID が返されます。

セキュリティ ID の使用を終えたら、そのセキュリティ ID に対して ISecurityProperty::ReleaseSID を呼び出す必要があります。

vtbl 6 HRESULT GetOriginalCallerSID(PSID* pSID)

現在のメソッドが呼び出された呼び出しシーケンスを開始したベースプロセスのセキュリティ識別子を取得します。

pSID

PSID*

inout

現在のメソッドが呼び出された呼び出しシーケンスを開始したベースプロセスのセキュリティ ID への参照。

戻り値

このメソッドは、標準の戻り値 E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、E_FAIL に加えて、次の値を返すことができます。

戻り値	説明
S_OK	現在のオブジェクトへの呼び出しを発生させたベースプロセスのセキュリティ ID が、パラメーター pSid に返されます。
CONTEXT_E_NOCONTEXT	コンポーネントがアプリケーションにインポートされていないか、またはオブジェクトが COM+ の CreateInstance メソッドのいずれかで作成されていないため、現在のオブジェクトには関連付けられたコンテキストがありません。

解説(Remarks)

GetOriginalCallerSID メソッドを使用して、現在のメソッドが呼び出された呼び出しシーケンスを開始した元のプロセスのセキュリティ ID を判別します。これはプロセスの発信元(または作成者)ではありません。オブジェクトへのポインターは一連のサーバーやユーザーを経由して渡されることがありますが、GetOriginalCallerSID は、たとえそのユーザーがオブジェクトの元の作成者でなかったとしても、常にプロセスの最初のサーバーとユーザーを返します。次のシナリオは、GetOriginalCallerSID メソッドの機能を示しています。

:::image type="content" source="./images/ff4d2c22-6e80-48e0-a6ca-4622b703e9e9.png" border="false" alt-text="2 つのベースプロセスを実行する 4 台のサーバー間で受け渡されるオブジェクト参照に対する GetOriginalCallerSID メソッドの結果を示す図。":::

ユーザー A として Server A で実行されている Base Process 1 が、ユーザー B として実行されている Server B 上に Object X を作成します。
Base Process 1 は、Object X への参照を、ユーザー D として Server D で実行されている Base Process 2 に渡します。
Base Process 2 は、その参照を使用して Object X を呼び出します。
Object X は、Server C 上で実行されている Object Y を呼び出します。その後、Object Y が GetOriginalCallerSID を呼び出すと、オブジェクトを元々作成したユーザー A ではなく、ユーザー D のセキュリティ ID が返されます。

メモ通常、オブジェクトの元の呼び出し元は、その元の作成者と同じプロセスです。元の呼び出し元と元の作成者が異なる唯一の状況は、元の作成者が別のプロセスに参照を渡し、その別のプロセスが呼び出しシーケンスを開始する場合(前述の例のような場合)です。

チェーン内のいずれかのオブジェクトが IObjectContext::CreateInstance または ITransactionContext::CreateInstance 以外の手段で作成された場合、元の呼び出し元へのパスは切断されます。たとえば、Base Process 1 が CoCreateInstance を使用して Object X を作成した場合、Object Y が GetOriginalCallerSID を呼び出すと、取得されるセキュリティ ID はユーザー D ではなくユーザー B のセキュリティ ID になります。これは、呼び出しシーケンスがオブジェクトのコンテキストを通じてさかのぼって追跡され、COM+ は IObjectContext::CreateInstance または ITransactionContext::CreateInstance のいずれかで作成されたオブジェクトに対してのみコンテキストを作成できるためです。

セキュリティ ID の使用を終えたら、そのセキュリティ ID に対して ReleaseSID を呼び出す必要があります。

vtbl 7 HRESULT ReleaseSID(PSID pSID)

他の ISecurityProperty メソッドのいずれかによって返されたセキュリティ識別子を解放します。

pSID

PSID

セキュリティ ID への参照。

戻り値

このメソッドは、次の値を返すことができます。

戻り値	説明
S_OK	メソッドが正常に完了しました。
E_INVALIDARG	pSid パラメーターに渡された引数が、セキュリティ ID への参照ではありません。

解説(Remarks)

GetDirectCallerSID、GetDirectCreatorSID、GetOriginalCallerSID、GetOriginalCreatorSID の各メソッドによって返されたセキュリティ ID ポインターを解放するには、常に ReleaseSID メソッドを呼び出す必要があります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

#define global IID_ISecurityProperty "{51372AEA-CAE7-11CF-BE81-00AA00A2FA25}"
#usecom global ISecurityProperty IID_ISecurityProperty "{}"
#comfunc global ISecurityProperty_GetDirectCreatorSID    3 sptr
#comfunc global ISecurityProperty_GetOriginalCreatorSID  4 sptr
#comfunc global ISecurityProperty_GetDirectCallerSID     5 sptr
#comfunc global ISecurityProperty_GetOriginalCallerSID   6 sptr
#comfunc global ISecurityProperty_ReleaseSID             7 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。