Метод Provider::P utInstance(IWbemClassObject*,long,MethodContext*) (provider.h)

  • Статья

[Класс Provider является частью платформы поставщика WMI, которая в настоящее время рассматривается в окончательном состоянии, и никакие дальнейшие разработки, улучшения или обновления не будут доступны для проблем, не связанных с безопасностью, влияющих на эти библиотеки. API mi mi следует использовать для всех новых разработок.]

Метод PutInstance обновляет экземпляр .

Синтаксис

HRESULT PutInstance(
  IWbemClassObject *pInst,
  long             lFlags,
  MethodContext    *pContext
);

Параметры

pInst

TBD

lFlags

Битовая маска флагов со сведениями об операции обновления. Это значение, указанное клиентом в методе IWbemServices::P utInstance .

Следующий флаг обрабатывается (и отфильтровывается) WMI:

  • WBEM_FLAG_RETURN_IMMEDIATELY
Допустимые значения lFlags :
  • WBEM_FLAG_CREATE_ONLY
  • WBEM_FLAG_CREATE_OR_UPDATE
  • WBEM_FLAG_UPDATE_ONLY

pContext

TBD

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

Реализация этого метода поставщиком платформы по умолчанию возвращает WBEM_E_PROVIDER_NOT_CAPABLE в вызывающий метод. Метод IWbemServices::P utInstance перечисляет наиболее распространенные возвращаемые значения, хотя вы можете вернуть любой код возврата COM.

Комментарии

WMI вызывает PutInstance , когда клиент вызывает IWbemServices::P utInstance для вашего класса. Если поставщик платформы обновляет экземпляры, необходимо реализовать PutInstance . В следующем списке описана распространенная реализация PutInstance:

  1. Проверьте ключевые свойства, переданные клиентом, с помощью методов Get для CInstance, таких как CInstance::GetCHString.

    Реализация должна определить, поддерживает ли поставщик изменения, запрошенные клиентом.

  2. При необходимости создайте или обновите соответствующий управляемый объект.
  3. Возвращает соответствующее возвращаемое значение.

    Если поставщик не поддерживает изменения, запрошенные клиентом, следует вернуть соответствующий код ошибки. Полный список допустимых кодов ошибок см. в разделе IWbemServices::P utInstance.

Требования

Требование Значение
Минимальная версия клиента Windows Vista
Минимальная версия сервера Windows Server 2008
Целевая платформа Windows
Header provider.h (включая FwCommon.h)
Библиотека FrameDyn.lib
DLL FrameDynOS.dll; FrameDyn.dll