_com_ptr_t::GetActiveObject

 

Publicado: abril de 2016

Para obter a documentação mais recente do Visual Studio 2017 RC, consulte a documentação do Visual Studio 2017 RC.

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.

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

Classe _com_ptr_t

Mostrar: