CoCopyProxy 関数 (combaseapi.h)

指定したプロキシのプライベート コピーを作成します。

構文

HRESULT CoCopyProxy(
  [in]  IUnknown *pProxy,
  [out] IUnknown **ppCopy
);

パラメーター

[in] pProxy

コピーするプロキシ上の IUnknown インターフェイスへのポインター。 このパラメーターを NULL にすることはできません。

[out] ppCopy

プロキシのコピーへのインターフェイス ポインターを受け取るポインター変数のアドレス。 このパラメーターを NULL にすることはできません。

戻り値

この関数は、次の値を返すことができます。

解説

CoCopyProxy は 、指定したプロキシのプライベート コピーを作成します。 通常、この関数は、クライアントが他のクライアントのこの情報を変更せずに CoSetProxyBlanket または IClientSecurity::SetBlanket を呼び出してプロキシの認証情報を変更する必要がある場合に呼び出されます。 CoSetProxyBlanket はプロキシのインスタンスのすべてのユーザーに影響を与えるので、 CoCopyProxy の呼び出しを通じてプロキシのプライベート コピーを作成し、コピーを使用して CoSetProxyBlanket (または IClientSecurity::SetBlanket) を呼び出すと、問題が解消されます。

このヘルパー関数は、次の一連の一般的な呼び出しをカプセル化します (エラー処理は除外されます)。

    pProxy->QueryInterface(IID_IClientSecurity, (void**)&pcs);
    pcs->CopyProxy(punkProxy, ppunkCopy);
    pcs->Release();

ローカル インターフェイスはコピーできません。 IUnknown と IClientSecurity は、既存のローカル インターフェイスの例です。

同じプロキシのコピーには、 QueryInterface に関して特別な関係があります。 リモート オブジェクトの IA インターフェイスのプロキシ a を指定すると、b と呼ばれる のコピーが作成されるとします。 この場合、IID_IAの b プロキシから QueryInterface を 呼び出すと、b の IA インターフェイスは取得されませんが、IA インターフェイスの "既定の" セキュリティ設定を持つ元のプロキシ上の IA インターフェイスは取得されません。

要件

関連項目

CoSetProxyBlanket

IClientSecurity::SetBlanket

COM のセキュリティ