Compartilhar via


_com_ptr_t::GetActiveObject

Específicos do Microsoft

Anexa a uma instância existente de um objeto que recebe um CLSID ou ProgID.

HRESULT GetActiveObject(
   const CLSID& rclsid 
) throw( );
HRESULT GetActiveObject(
   LPCWSTR clsidString 
) throw( );
HRESULT GetActiveObject(
   LPCSTR clsidStringA 
) throw( );

Parâmetros

  • rclsid
    O CLSID de um objeto.

  • clsidString
    Uma seqüência de caracteres Unicode que mantém um um CLSID (começando com "{") ou um ProgID.

  • clsidStringA
    Uma seqüência de caracteres multibyte, usando a página de código ANSI, que contém tanto um CLSID (começando com "{") ou um ProgID.

Comentários

Essas funções membro chamam GetActiveObject para recuperar um ponteiro para um objeto em execução que foi registrado com OLE e, em seguida, o tipo de interface consultas para esse ponteiro inteligente.O ponteiro resultante é encapsulado nisso _com_ptr_t objeto.Versão é chamado decrementar a contagem de referência para o ponteiro encapsulado anteriormente.Esta rotina retorna o HRESULT para indicar sucesso ou falha.

  • GetActiveObject (rclsid) anexa a uma instância existente de um objeto que recebe um CLSID.

  • GetActiveObject (clsidString) anexa a uma instância existente de um objeto, dada uma seqüência de caracteres Unicode que mantém um um CLSID (começando com "{") ou um ProgID.

  • GetActiveObject (clsidStringA) anexa a uma instância existente de um objeto, dada uma seqüência de caracteres multibyte que mantém um um CLSID (começando com "{") ou um ProgID.Chamadas MultiByteToWideChar, que faz supor que a seqüência está na página de código ANSI em vez de uma página de código OEM.

Específicos do Microsoft final

Consulte também

Referência

com_ptr_t classe