Метод IWbemContext::SetValue (wbemcli.h)

  • Статья

Метод IWbemContext::SetValue создает или перезаписывает именованное значение контекста.

Синтаксис

HRESULT SetValue(
  [in] LPCWSTR wszName,
  [in] long    lFlags,
  [in] VARIANT *pValue
);

Параметры

[in] wszName

Не может иметь значение NULL. Это указатель, доступный только для чтения, который указывает имя значения контекста. Это значение должно заканчиваться null.

[in] lFlags

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

[in] pValue

Должен указывать на допустимый вариант VARIANT, который обрабатывается как доступный только для чтения. Значение в VARIANT становится именованным значением контекста. Можно сохранить весь объект IWbemClassObject , а также простое значение, заключив его в variant , использующий тип VT_UNKNOWN . Вызывающий объект должен выполнить QueryInterface в объекте IWbemClassObject , запросив IID_IUnknown и используя возвращенный указатель в VARIANT.

Если pValue содержит внедренный объект IWbemClassObject , вызывающий объект должен вызвать IWbemClassObject::QueryInterface для IID_IUnknown и поместить полученный указатель в VARIANT с помощью типа VT_UNKNOWN. Исходный внедренный объект копируется во время операции записи и поэтому не может быть изменен операцией.

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

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

Требования

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

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

IWbemContext

IWbemContext::GetValue