Compartilhar via


CoCopyProxy

Windows Mobile SupportedWindows Embedded CE Supported

9/8/2008

Esta função torna um copiar particular do proxy especificado.

Syntax

HRESULT CoCopyProxy(
  IUnknown* pProxy,
  IUnknown** ppCopy
);

Parameters

  • pProxy
    [no] Aponta para o IUnknown interface no proxy a serem copiados. Pode não ser NULL.
  • ppCopy
    [out] Endereço do IUnknownvariável * pointer que recebe o ponteiro interface para a copiar do proxy. Talvez não seja NULL.

Return Value

  • S_OK
    O sucesso.
  • E_INVALIDARG
    Um ou mais argumentos estão inválido.

Remarks

CoCopyProxy Torna uma copiar particular do proxy especificado. Normalmente, essa função é chamado quando um cliente precisa de informações sobre autenticação de seu proxy através um chamar a alteração CoSetProxyBlanket Ou IClientSecurity::SetBlanket Sem alterar este informações para outros clientes.

CoSetProxyBlanket Afeta todos os usuários de uma instância de um proxy, criando assim um copiar particular do proxy através um chamar para CoCopyProxy e, em seguida, chamado CoSetProxyBlanket (ou IClientSecurity::SetBlanket) usando a copiar elimina o problema.

Essa função auxiliar encapsula a seguinte seqüência de comum chama (manipulação de erro excluídos).

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

Interfaces locais não podem ser copiadas. IUnknown e IClientSecurity São exemplos de local existente interfaces.

Cópias do mesmo proxy têm um relacionamento especial with respect to Falha de QueryInterface. Dado um proxy, Um, da interface ia de um remoto objeto, suponha que um copiar de Um é criado, chamado b.

Neste maiúsculas e minúsculas, chamado Falha de QueryInterface a partir de b proxy de IID_IA não irá recuperar a IA interface em b, mas o Um, o original proxy com as configurações de segurança usar como padrão para a interface IA.

Para determinar se a plataforma oferece suporte a essa função, consulte Determinando suporte COM APIs.

Requirements

Header objbase.h
Library ole32.lib
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

COM Functions