Método IWbemServices::GetObject (wbemcli.h)
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 |