CoCopyProxy 함수(combaseapi.h)

지정된 프록시의 프라이빗 복사본을 만듭니다.

구문

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

매개 변수

[in] pProxy

복사할 프록시의 IUnknown 인터페이스에 대한 포인터입니다. 이 매개 변수는 NULL일 수 없습니다.

[out] ppCopy

프록시 복사본에 대한 인터페이스 포인터를 수신하는 포인터 변수의 주소입니다. 이 매개 변수는 NULL일 수 없습니다.

반환 값

이 함수는 다음 값을 반환할 수 있습니다.

설명

CoCopyProxy 는 지정된 프록시의 프라이빗 복사본을 만듭니다. 일반적으로 이 함수는 클라이언트가 다른 클라이언트에 대해 이 정보를 변경하지 않고 CoSetProxyBlanket 또는 IClientSecurity::SetBlanket 에 대한 호출을 통해 프록시의 인증 정보를 변경해야 할 때 호출됩니다. CoSetProxyBlanket은 프록시 instance 모든 사용자에게 영향을 주므로 CoCopyProxy 호출을 통해 프록시의 프라이빗 복사본을 만든 다음 복사본을 사용하여 CoSetProxyBlanket(또는 IClientSecurity::SetBlanket)을 호출하면 문제가 제거됩니다.

이 도우미 함수는 다음과 같은 일반적인 호출 시퀀스를 캡슐화합니다(오류 처리 제외).

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

로컬 인터페이스는 복사할 수 없습니다. IUnknown 및 IClientSecurity 는 기존 로컬 인터페이스의 예입니다.

동일한 프록시의 복사본에는 QueryInterface와 관련된 특별한 관계가 있습니다. 원격 개체의 IA 인터페이스에 대한 프록시가 지정된 경우 의 복사본이 생성되어 b라고 합니다. 이 경우 IID_IA 대해 b 프록시에서 QueryInterface 를 호출하면 b에서 IA 인터페이스를 검색하지 않고 IA 인터페이스에 대한 "기본" 보안 설정이 있는 원래 프록시의 IA 인터페이스를 검색하지 않습니다.

요구 사항

추가 정보

CoSetProxyBlanket

IClientSecurity::SetBlanket

COM의 보안