Поделиться через

Функция PutMethod

Создает метод.

Замечание

Этот API предназначен только для внутреннего использования. Он не предназначен для использования из кода разработчика.

Синтаксис

HRESULT PutMethod (
   [in] int                vFunc,
   [in] IWbemClassObject*  ptr,
   [in] LPCWSTR            wszName,
   [in] LONG               lFlags,
   [in] IWbemClassObject*  pInSignature,
   [in] IWbemClassObject*  pOutSignature
);

Параметры

vFunc [in] Этот параметр не используется.

ptr [in] Указатель на экземпляр IWbemClassObject .

wszName [in] Имя создаваемого метода.

lFlags [in] Скрытный. Этот параметр должен иметь значение 0.

pSignatureIn [in] Указатель на копию __Parameters системного класса , содержащего in параметры метода. Этот параметр игнорируется, если задано значение null.

pSignatureOut [in] Указатель на копию __Parameters системного класса , содержащего out параметры метода. Этот параметр игнорируется, если задано значение null.

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

Следующие значения, возвращаемые этой функцией, определяются в файле заголовка WbemCli.h или можно определить их как константы в коде:

Постоянный Ценность Description
WBEM_E_INVALID_PARAMETER 0x80041008 Один или несколько параметров недопустимы.
WBEM_E_INVALID_DUPLICATE_PARAMETER 0x80041043 Параметр [in, out] метода, указанный в объектах pInSignature и pOutSignature , имеют разные квалификаторы.
WBEM_E_MISSING_PARAMETER_ID 0x80041036 Параметр метода отсутствует спецификация ID квалификатора.
WBEM_E_NONCONSECUTIVE_PARAMETER_IDS 0x80041038 Ряд идентификаторов, назначенный параметрам метода, не является последовательными или не начинается с 0.
WBEM_E_PARAMETER_ID_ON_RETVAL 0x80041039 Возвращаемое значение для метода имеет ID квалификатор.
WBEM_E_PROPAGATED_METHOD 0x80041034 Предпринята попытка повторно использовать существующее имя метода из родительского класса, и подписи не совпадали.
WBEM_S_NO_ERROR 0 Вызов функции был успешно выполнен.

Замечания

Эта функция упаковывает вызов метода IWbemClassObject::P utMethod .

Этот вызов метода поддерживается только в том случае, если ptr это определение класса CIM. Манипуляция с методом недоступна из указателей IWbemClassObject , указывающих на экземпляры CIM.

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

Для метода in и out параметры описываются как свойства в объектах IWbemClassObject .

Параметр [in/out] можно определить, добавив одно и то же свойство к обоим объектам, на которые указываются pInSignature и pOutSignature параметры. В этом случае свойства имеют одно и то же ID значение квалификатора.

Каждое свойство в объекте класса __Parameters , отличное от того, которое ReturnValue должно иметь ID квалификатор, числовое значение от нуля, определяющее порядок отображения параметров. Нет двух параметров может иметь одно и то же ID значение, и значение не ID может быть пропущено. При возникновении PutMethod любого условия функция возвращается WBEM_E_NONCONSECUTIVE_PARAMETER_IDS.

Example

Пример см. в методе IWbemClassObject::P utMethod .

Требования

Платформы: см. раздел Требования к системе.

Заголовок: WMINet_Utils.idl

Версии .NET Framework: Доступно с версии 4.7.2

См. также

  • Last updated on