IClientSecurity

オブジェクトの各インターフェイスプロキシごとに、セキュリティ設定をクライアントが制御できるようにします。

すべてのオブジェクトは 1 つのプロキシマネージャーを持ち、すべてのプロキシマネージャーは IClientSecurity インターフェイスを自動的に公開します。したがって、クライアントはオブジェクト上の任意のインターフェイスポインターを使用して、そのオブジェクトのプロキシマネージャーに対し IClientSecurity を照会できます。QueryInterface 呼び出しが成功すると、その IClientSecurity ポインターを使用して IClientSecurity のメソッドを呼び出し、クライアントが対象とするインターフェイスプロキシへのポインターを渡すことができます。IClientSecurity に対する QueryInterface の呼び出しが失敗した場合、そのオブジェクトはインプロセスで実装されているか、セキュリティをサポートしないカスタムマーシャラーによってリモート化されているかのいずれかです。(カスタムマーシャラーは、IClientSecurity インターフェイスをクライアントに提供することでセキュリティをサポートできます。)

IClientSecurity のメソッドにパラメーターとして渡すインターフェイスプロキシは、IClientSecurity インターフェイスと同じオブジェクトのものでなければなりません。つまり、各オブジェクトはそれぞれ固有の IClientSecurity インターフェイスを持ち、あるオブジェクトの IClientSecurity を呼び出す際に別のオブジェクトのプロキシを渡しても機能しません。また、プロキシを使用しないインターフェイスを IClientSecurity のメソッドに渡すことはできません。これは、プロキシマネージャーによってローカルに実装されるインターフェイスを IClientSecurity のメソッドに渡すことができないことを意味します。ただし、この規則の例外である IUnknown は除きます。

指定したプロキシに対して呼び出しを行うためにクライアントが使用する認証情報を取得します。

このメソッドは次の値を返すことがあります。

QueryBlanket は、指定したインターフェイスプロキシから行われる呼び出しに COM が使用する認証情報を取得するために、クライアントから呼び出されます。プロキシ上のインターフェイスへのポインターを使って、クライアントはまず IClientSecurity へのポインターを得るために QueryInterface を呼び出します。次に、このポインターを使って QueryBlanket を呼び出し、その後ポインターを解放します。この一連の呼び出しは、ヘルパー関数 CoQueryProxyBlanket にカプセル化されています。

pProxy にはインターフェイスポインターを渡します。ただし、プロキシを使用しないインターフェイスへのポインターを渡すことはできません。したがって、インターフェイス定義に local キーワードが指定されたインターフェイスへのポインターを渡すことはできません。そのようなインターフェイスに対してはプロキシが作成されないためです。IUnknown はこの規則の例外です。

指定したプロキシに対して呼び出しを行う際に使用する認証情報 (セキュリティブランケット) を設定します。

このメソッドは次の値を返すことがあります。

SetBlanket は、指定したインターフェイスプロキシに対して呼び出しを行う際に使用される認証情報を設定します。ここで指定された値は、自動セキュリティによって選択された値を上書きします。このメソッドを呼び出すと、指定したプロキシを使用する他のすべての利用者に対してもセキュリティ値が変更されます。変更を特定のプロキシインスタンスにのみ適用したい場合は、IClientSecurity::CopyProxy を呼び出してプロキシのプライベートなコピーを作成し、そのコピーに対して SetBlanket を呼び出します。

このメソッドが呼び出されるたびに、DCOM はプロキシに識別情報を設定し、このプロキシを使用して以降に行われる呼び出しではこの識別情報が使用されます。SetBlanket が呼び出された時点で進行中の呼び出しは、呼び出し開始時にプロキシに設定されていた認証情報を使用します。pAuthInfo が NULL の場合、プロキシの識別情報は既定で現在のプロセストークンになります (ただし、CoInitializeSecurity の呼び出しで認証識別情報が指定されていた場合を除く)。pAuthInfo が NULL のときにクローキングフラグがプロキシにどのように影響するかについては、「Cloaking」を参照してください。

既定では、COM はクライアントコンピューターとサーバーコンピューターの両方で利用可能な最初の認証サービスおよび承認サービスと、その認証サービスに対してサーバーが登録したプリンシパル名を選択します。現在のところ、COM は最初の認証サービスが失敗しても別の認証サービスを試行しません。

SetBlanket で dwImpLevel に既定の定数が指定された場合、このパラメーターは CoInitializeSecurity に指定された値を既定とします。CoInitializeSecurity が呼び出されていない場合は、既定で RPC_C_IMP_LEVEL_IDENTIFY になります。

プロキシ上の dwAuthnLevel の初期値は、クライアントの CoInitializeSecurity 呼び出しで設定された値と、サーバーの CoInitializeSecurity 呼び出しで設定された値のうち、高い方になります。CoInitializeSecurity を呼び出さなかったプロセスの場合、既定の認証レベルは RPC_C_AUTHN_CONNECT です。

CoInitializeSecurity を呼び出さないプロセスの既定の認証レベルおよび偽装レベルは、DCOMCNFG で設定できます。

dwCapabilities に EOAC_DEFAULT を指定した場合、CoInitializeSecurity の有効な機能が使用されます。CoInitializeSecurity が呼び出されていない場合、機能フラグには EOAC_NONE が使用されます。

同じプロキシに対して 2 つのスレッドで同時に SetBlanket が呼び出された場合、適用される変更は 1 組のみです。同じプロキシに対して 2 つのスレッドで SetBlanket と CRpcOptions::Set が同時に呼び出された場合、両方の変更が適用されることもあれば、片方のみが適用されることもあります。

IClientSecurity インターフェイスのようなローカルインターフェイスには、セキュリティ情報を設定できません。ただし、そのインターフェイスはローカルでのみサポートされるため、セキュリティは不要です。IUnknown と IMultiQI は特別なケースです。ロケーション実装は、これらのインターフェイスをサポートするためにリモート呼び出しを行います。SetBlanket は IUnknown に対して使用できます。IMultiQI は IUnknown のセキュリティ設定を使用します。

SetBlanket の 1 つのパラメーターを他のパラメーターに対処せずに変更するには、他のパラメーターに既定の定数を指定できます。アプリケーションは、他のすべてのパラメーターを既定の定数に設定することで、認証サービスを含む他のパラメーターを無視して、あるパラメーター (認証レベルなど) を変更できます。

既定値は明白でないことが多いため、使用しないパラメーターはすべて既定の定数に設定することが重要である点に注意してください。特に、認証サービスを既定に設定する場合は、認証情報とプリンシパル名も既定に設定すべきです。その理由は 2 つあります。第 1 に、認証情報の型は DCOM が選択する認証サービスに依存します。第 2 に、DCOM は特定の認証サービスに対して複雑な認証情報を渡す必要があるため、認証サービスを既定に設定し、認証情報を NULL に設定すると、機能しないセキュリティ設定になる可能性があるためです。

指定したインターフェイスのプロキシのプライベートなコピーを作成します。

このメソッドは次の値を返すことがあります。

CopyProxy は、指定したインターフェイスのプロキシのプライベートなコピーを作成するために、クライアントから呼び出されます。プロキシのコピーは、認証情報に既定値を持ちます。その認証情報は、元のプロキシの他のクライアントに影響を与えることなく、IClientSecurity::SetBlanket の呼び出しによって変更できます。コピーは参照カウントを 1 つ持ち、CopyProxy の呼び出し元は、そのプロキシのコピーが確実に解放されるようにしなければなりません。

IUnknown や IClientSecurity のようなローカルインターフェイスはコピーできません。CopyProxy を使用してプロキシマネージャーを複製することはできません。

同じプロキシのコピーどうしは、QueryInterface に関して特別な関係を持ちます。リモートオブジェクトの IA インターフェイスのプロキシを a とし、a のコピーを作成して b と呼ぶとします。この場合、b プロキシから IID_IA に対して QueryInterface を呼び出すと、b 上の IA インターフェイスではなく、元のプロキシである a 上の IA インターフェイスが取得されます。

誰でもプロキシを照会し、SetBlanket を使用してそのセキュリティを変更できる点に注意してください。ただし、プロキシのコピーを作成した場合、それを他者に渡さない限り、誰もそのコピーを取得できません。そのコピーを持つ者だけが、そのコピーにセキュリティを設定できます。

ヘルパー関数 CoCopyProxy は、IClientSecurity へのポインターに対する QueryInterface 呼び出し、その IClientSecurity ポインターを使用した CopyProxy の呼び出し、および IClientSecurity ポインターの解放をカプセル化します。