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

Статья
08/27/2023

Метод IWbemServices::ExecMethod выполняет метод, экспортируемый объектом CIM. Вызов метода пересылается соответствующему поставщику, где он выполняется. Сведения и состояние возвращаются вызывающей, которая блокируется до завершения вызова.

Методы не реализуются непосредственно службой управления Windows, но экспортируются поставщиками методов. Для любого заданного класса CIM доступные методы и их параметры должны быть указаны в документации для соответствующего поставщика.

Дополнительные сведения о выполнении методов см. в разделе Вызов метода.

Синтаксис

HRESULT ExecMethod(
  [in]  const BSTR       strObjectPath,
  [in]  const BSTR       strMethodName,
  [in]  long             lFlags,
  [in]  IWbemContext     *pCtx,
  [in]  IWbemClassObject *pInParams,
  [out] IWbemClassObject **ppOutParams,
  [out] IWbemCallResult  **ppCallResult
);

Параметры

[in] strObjectPath

Допустимая строка BSTR, содержащая путь к объекту объекта, для которого выполняется метод.

[in] strMethodName

Имя метода для объекта .

[in] lFlags

Для этого параметра можно задать значение 0, чтобы сделать этот вызов синхронным. Чтобы сделать этот вызов полусинхронным, задайте для lFlagsзначение WBEM_FLAG_RETURN_IMMEDIATELY, укажите допустимый указатель для параметра ppCallResult , и этот вызов возвращается немедленно. Дополнительные сведения см. в разделе Вызов метода.

[in] pCtx

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

[in] pInParams

Может иметь значение NULL , если для выполнения метода не требуются встроенные параметры. В противном случае это указывает на IWbemClassObject , содержащий свойства, действующие в качестве входящих параметров для выполнения метода. Содержимое объекта зависит от метода и является частью спецификации для соответствующего поставщика. Дополнительные сведения о создании входных параметров см. в разделе Создание объектов параметров в C++.

[out] ppOutParams

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

[out] ppCallResult

Значение NULL не используется. Если указан параметр ppCallResult , ему необходимо задать значение NULL для записи. В этом случае вызов возвращается немедленно с WBEM_S_NO_ERROR. Параметр ppCallResult получает указатель на новый объект IWbemCallResult , который необходимо опрашивать, чтобы получить результат выполнения метода с помощью метода GetCallStatus . Параметры out для вызова доступны путем вызова 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

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

Вызов метода

IWbemCallResult::GetResultObject

IWbemServices

IWbemServices::ExecMethodAsync