Partilhar via

_com_ptr_t::GetActiveObject

  • Artigo

Específico da Microsoft

Anexa a uma instância existente de um objeto dado o 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 cadeia de caracteres Unicode que contém CLSID (começando com “{") ou ProgID.

  • clsidStringA
    Uma cadeia de caracteres multibyte, usando a página de códigos ANSI, que contém CLSID (começando com “{") ou ProgID.

Comentários

Essas funções de membro chamam GetActiveObject para recuperar um ponteiro para um objeto em execução que foi registrado com OLE e depois consulta o tipo de interface desse ponteiro inteligente. O ponteiro resultante é encapsulado nesse objeto _com_ptr_t. Release é chamado para diminuir a contagem de referências para o ponteiro anteriormente encapsulado. Essa rotina retorna HRESULT para indicar êxito ou falha.

  • GetActiveObject( rclsid )   Anexa a uma instância existente de um objeto dado o CLSID.

  • GetActiveObject( clsidString )   Anexa a uma instância existente de um objeto dada uma cadeia de caracteres Unicode que contém um CLSID (começando com "{") ou um ProgID.

  • GetActiveObject( clsidStringA )   Anexa a uma instância existente de um objeto dada uma cadeia de caracteres multibyte que contém um CLSID (começando com "{") ou um ProgID. Chama MultiByteToWideChar, que presume que a cadeia de caracteres esteja na página de códigos ANSI em vez de uma página de códigos OEM.

FIM de Específico da Microsoft

Consulte também

Referência

Classe _com_ptr_t