Метод IWbemClassObject::GetMethod (wbemcli.h)

  • Статья

Метод IWbemClassObject::GetMethod возвращает сведения о запрошенном методе. Этот вызов поддерживается, только если текущий объект является определением класса CIM. Сведения о методе недоступны в указателях IWbemClassObject , которые указывают на экземпляры CIM.

Синтаксис

HRESULT GetMethod(
  [in]  LPCWSTR          wszName,
  [in]  long             lFlags,
  [out] IWbemClassObject **ppInSignature,
  [out] IWbemClassObject **ppOutSignature
);

Параметры

[in] wszName

Имя метода. Он не может иметь значение NULL и должен указывать на допустимый LPCWSTR.

[in] lFlags

Зарезервировано. Этот параметр должен иметь значение 0.

[out] ppInSignature

Указатель, получающий указатель IWbemClassObject , описывающий в параметрах метода . Этот параметр игнорируется, если задано значение NULL. Имейте в виду, что управление Windows может задать для указателя IWbemClassObjectзначение NULL , если этот метод не имеет параметров. Дополнительные сведения см. в подразделе "Примечания".

[out] ppOutSignature

Указатель, получающий указатель IWbemClassObject , описывающий параметры out-parameters для метода . Этот параметр будет игнорироваться, если задано значение NULL.

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

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

Комментарии

Для метода параметры in и out описываются как свойства в IWbemClassObject, экземпляре системного класса __Parameters.

Например, рассмотрим следующий метод:

Class MyClass{
    [key] string KeyVal;
    sint32 PropVal;
    sint32 ExampleMethod([in] sint32 Parm1, [in] uint32 Parm2, 
      [out] string Parm3);
};

В этом примере класс имеет один метод. Когда пользователь вызывает IWbemClassObject::GetMethod, параметр ppInSignature получает объект IWbemClassObject , который содержит два свойства: Parm1 и Parm2. Параметр ppOutSignature содержит два свойства: Parm3 и ReturnValue.

После заполнения значений свойств объекта ppInSignature вызывающий объект может использовать объект для выполнения метода путем вызова IWbemServices::ExecMethod или IWbemServices::ExecMethodAsync.

Примечание Вызывающий объект должен вызывать IWbemClassObject::Release для указателей ppInSignature и ppOutSignature , если эти объекты больше не требуются.
 

Требования

   
Минимальная версия клиента Windows Vista
Минимальная версия сервера Windows Server 2008
Целевая платформа Windows
Header wbemcli.h (включая Wbemidl.h)
Библиотека WbemUuid.lib
DLL CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll

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

IWbemClassObject

IWbemClassObject::P utMethod