Метод IWbemServices::GetObject (wbemcli.h)

Статья
08/27/2023

Метод IWbemServices::GetObject извлекает класс или экземпляр . Этот метод извлекает объекты только из пространства имен, связанного с текущим объектом IWbemServices .

Синтаксис

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

Параметры

[in] strObjectPath

Путь к извлекаемого объекта. Если значение равно NULL, возвращается пустой объект, который может стать новым классом. Дополнительные сведения см. в разделе Создание класса.

[in] lFlags

Следующие флаги влияют на поведение этого метода.

WBEM_FLAG_USE_AMENDED_QUALIFIERS

Если этот флаг установлен, инструментарий WMI получает измененные квалификаторы, хранящиеся в локализованном пространстве имен языкового стандарта текущего подключения. Если значение не задано, извлекаются только квалификаторы, хранящиеся в непосредственном пространстве имен.

WBEM_FLAG_RETURN_WBEM_COMPLETE

Этот флаг делает этот вызов синхронным.

WBEM_FLAG_RETURN_IMMEDIATELY

Этот флаг делает этот вызов полусинхронным. Необходимо указать допустимый указатель для параметра ppCallResult . Дополнительные сведения см. в разделе Вызов метода.

WBEM_FLAG_DIRECT_READ

Этот флаг обеспечивает прямой доступ к поставщику для указанного класса без учета его родительского класса или подклассов.

[in] pCtx

Обычно имеет значение NULL. В противном случае это указатель на объект IWbemContext , который может использоваться поставщиком, создающим запрошенный класс или экземпляр. Значения в объекте контекста должны быть указаны в документации для соответствующего поставщика. Дополнительные сведения об этом параметре см. в разделе Выполнение вызовов WMI.

[out] ppObject

Если значение не равно NULL, объект получается, если он найден. Возвращаемый объект имеет положительное число ссылок. Вызывающий объект должен использовать Release , если объект больше не нужен. Во всех случаях ошибки этот параметр имеет значение NULL.

[out] ppCallResult

Если значение РАВНО NULL, этот параметр не используется. Если параметр lFlags содержит WBEM_FLAG_RETURN_IMMEDIATELY, этот вызов немедленно возвращается с WBEM_S_NO_ERROR. Параметр ppCallResult получает указатель на новый объект IWbemCallResult , который затем можно опрашивать для получения результата с помощью метода GetCallStatus . Вызывающий объект может вызвать IWbemCallResult::GetResultObject , чтобы получить объект, когда он станет доступным.

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

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

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

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

Требования


Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	wbemcli.h (включая Wbemidl.h)
Библиотека	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