Метод IWbemCallResult::GetResultObject (wbemcli.h)

  • Статья

Метод IWbemCallResult::GetResultObject пытается получить объект из предыдущего полусинхронного вызова IWbemServices::GetObject или IWbemServices::ExecMethod. Если объект еще недоступен, вызов возвращает WBEM_S_TIMEDOUT. Кроме того, перед вызовом этого метода для получения результирующего объекта можно вызвать метод IWbemCallResult::GetCallStatus , пока он не вернет WBEM_S_NO_ERROR, указывая, что исходная полусинхронная операция завершена.

Синтаксис

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

Параметры

[in] lTimeout

Указывает максимальное время (в миллисекундах), которое этот вызов блокирует перед возвратом. Если вы используете константную WBEM_INFINITE (0xFFFFFFFF), вызов блокируется, пока объект не будет доступен. При использовании 0 вызов немедленно возвращает объект или код состояния.

[out] ppResultObject

Этот параметр не может иметь значение NULL. Он получает копию объекта, когда он становится доступным. Необходимо вызывать IWbemClassObject::Release для возвращаемого объекта, когда объект больше не требуется. При ошибке новый объект не возвращается.

Возвращаемое значение

Этот метод возвращает HRESULT , указывающий состояние вызова метода. В следующем списке перечислены значения, содержащиеся в HRESULT.

Если исходная полусинхронная операция завершилась сбоем (например, когда объект не найден или метод не удалось вызвать), этот метод возвращает код ошибки, который исходная функция возвращала бы в своей синхронной версии.

При ошибке можно вызвать функцию COM GetErrorInfo , чтобы получить дополнительные сведения об ошибке.

Коды ошибок, относящихся к COM, также могут быть возвращены, если сетевые проблемы приводят к потере удаленного подключения к управлению Windows.

Требования

   
Минимальная версия клиента Windows Vista
Минимальная версия сервера Windows Server 2008
Целевая платформа Windows
Header wbemcli.h (включая Wbemidl.h)

См. также раздел

IWbemCallResult

IWbemServices::ExecMethod

IWbemServices::GetObject