Método IWbemServices::GetObject (wbemcli.h)

Artigo
08/27/2023

O método IWbemServices::GetObject recupera uma classe ou instância. Esse método recupera apenas objetos do namespace associado ao objeto IWbemServices atual.

Sintaxe

HRESULT GetObject(
  [in]  const BSTR       strObjectPath,
  [in]  long             lFlags,
  [in]  IWbemContext     *pCtx,
  [out] IWbemClassObject **ppObject,
  [out] IWbemCallResult  **ppCallResult
);

Parâmetros

[in] strObjectPath

Caminho do objeto a ser recuperado. Se for NULL, um objeto vazio será retornado que pode se tornar uma nova classe. Para obter mais informações, consulte Criar uma classe.

[in] lFlags

Os sinalizadores a seguir afetam o comportamento desse método.

WBEM_FLAG_USE_AMENDED_QUALIFIERS

Se esse sinalizador estiver definido, o WMI recuperará os qualificadores alterados armazenados no namespace localizado da localidade da conexão atual. Se não estiver definido, somente os qualificadores armazenados no namespace imediato serão recuperados.

WBEM_FLAG_RETURN_WBEM_COMPLETE

Esse sinalizador torna essa chamada síncrona.

WBEM_FLAG_RETURN_IMMEDIATELY

Esse sinalizador faz disso uma chamada semissíncrona. Você deve fornecer um ponteiro válido para o parâmetro ppCallResult . Para obter mais informações, confira Como chamar um método.

WBEM_FLAG_DIRECT_READ

Esse sinalizador faz com que o acesso direto ao provedor para a classe especificada sem qualquer relação com sua classe pai ou subclasses.

[in] pCtx

Normalmente NULL. Caso contrário, esse é um ponteiro para um objeto IWbemContext que pode ser usado pelo provedor que está produzindo a classe ou instância solicitada. Os valores no objeto de contexto devem ser especificados na documentação do provedor em questão. Para obter mais informações sobre esse parâmetro, consulte Fazendo chamadas para WMI.

[out] ppObject

Se não for NULL, ele receberá o objeto , se ele for encontrado. O objeto retornado tem uma contagem de referência positiva. O chamador deve usar Release quando o objeto não for mais necessário. Em todos os casos de erro, esse parâmetro é definido para apontar como NULL.

[out] ppCallResult

Se NULL, esse parâmetro não será usado. Se o parâmetro lFlagscontiver WBEM_FLAG_RETURN_IMMEDIATELY, essa chamada retornará imediatamente com WBEM_S_NO_ERROR. O parâmetro ppCallResult recebe um ponteiro para um novo objeto IWbemCallResult , que pode ser sondado para obter o resultado usando o método GetCallStatus . O chamador pode chamar IWbemCallResult::GetResultObject para recuperar o objeto quando ele ficar disponível.

Retornar valor

Esse método retorna um HRESULT que indica o status da chamada de método. A lista a seguir lista o valor contido em um HRESULT.

Em caso de falha, você pode obter todas as informações disponíveis da função COM GetErrorInfo.

Códigos de erro específicos de COM também podem ser retornados se problemas de rede fizerem com que você perca a conexão remota com o Gerenciamento do Windows.

Requisitos


Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	wbemcli.h (inclua Wbemidl.h)
Biblioteca	Wbemuuid.lib
DLL	Fastprox.dll; Esscli.dll; FrameDyn.dll; FrameDynOS.dll; Ntevt.dll; Stdprov.dll; Viewprov.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wbemsvc.dll; Wmipicmp.dll; Wmidcprv.dll; Wmipjobj.dll; Wmiprvsd.dll