Método IWbemCallResult::GetResultObject (wbemcli.h)

  • Artigo

O método IWbemCallResult::GetResultObject tenta recuperar um objeto de uma chamada semissíncrona anterior para IWbemServices::GetObject ou IWbemServices::ExecMethod. Se o objeto ainda não estiver disponível, a chamada retornará WBEM_S_TIMEDOUT. Além disso, antes de invocar esse método para obter o objeto resultante, você pode chamar IWbemCallResult::GetCallStatus até que ele retorne WBEM_S_NO_ERROR, indicando que a operação semissíncrona original foi concluída.

Sintaxe

HRESULT GetResultObject(
  [in]  long             lTimeout,
  [out] IWbemClassObject **ppResultObject
);

Parâmetros

[in] lTimeout

Especifica o tempo máximo em milissegundos que essa chamada bloqueia antes de retornar. Se você usar a WBEM_INFINITE constante (0xFFFFFFFF), a chamada será bloqueada até que o objeto esteja disponível. Se você usar 0, a chamada retornará imediatamente o objeto ou um código status.

[out] ppResultObject

Esse parâmetro não pode ser NULL. Ele recebe a cópia do objeto quando ele fica disponível. Você deve chamar IWbemClassObject::Release no objeto retornado quando o objeto não for mais necessário. Um novo objeto não é retornado com erro.

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.

Se a operação semissíncrona original falhou (como quando o objeto não foi encontrado ou o método não pôde ser invocado), esse método retorna o código de erro que a função original teria retornado em sua versão síncrona.

Em caso de erro, você pode chamar a função COM GetErrorInfo para obter mais informações de erro.

Códigos de erro específicos do COM também poderão 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 (include Wbemidl.h)

Confira também

IWbemCallResult

IWbemServices::ExecMethod

IWbemServices::GetObject