Метод IWbemQualifierSet::P ut (wbemcli.h)

Статья
03/03/2024

Метод IWbemQualifierSet::P ut записывает именованный квалификатор и значение. Новый квалификатор перезаписывает предыдущее значение с тем же именем. Если квалификатор не существует, он создается.

Иногда невозможно записать значение квалификатора, например, если квалификатор распространяется из другого объекта. Как правило, распространяемые квалификаторы доступны только для чтения, но их можно переопределить. Дополнительные сведения см. в разделе Варианты квалификатора.

При использовании квалификатора key не нужно указывать какие-либо варианты или правила распространения.

Пользователь не может создавать квалификаторы с именами, которые начинаются или заканчиваются символом подчеркивания (_). Он зарезервирован для системных классов и свойств.

Синтаксис

HRESULT Put(
  [in] LPCWSTR wszName,
  [in] VARIANT *pVal,
  [in] long    lFlavor
);

Параметры

[in] wszName

Имя записываемого квалификатора. Указатель обрабатывается как доступный только для чтения.

[in] pVal

Не может иметь значение NULL. Он должен указывать на допустимый вариант VARIANT , содержащий значение квалификатора для записи. Указатель обрабатывается как доступный только для чтения. Вызывающий объект отвечает за вызов VariantClear для этого указателя после того, как значение не требуется.

Поддерживаются только варианты и массивы типа VT_I4, VT_R8, VT_BSTRVT_BOOL .

[in] lFlavor

Требуемые варианты квалификатора для этого квалификатора. В следующем списке перечислены соответствующие константы для lFlavor. Значение по умолчанию равно нулю (0).

WBEM_FLAVOR_OVERRIDABLE (0 (0x0))

Значение квалификатора можно переопределить в производном классе или экземпляре . Это значение по умолчанию. Использование этой константы аналогично использованию флага EnableOverride .

WBEM_FLAVOR_FLAG_PROPAGATE_TO_INSTANCE (1 (0x1))

Квалификатор распространяется в экземпляры. Использование этой константы аналогично использованию флага ToInstance .

WBEM_FLAVOR_FLAG_PROPAGATE_TO_DERIVED_CLASS (2 (0x2))

Квалификатор распространяется на производные классы. Использование этой константы аналогично использованию флага ToSubClass .

WBEM_FLAVOR_NOT_OVERRIDABLE (16 (0x10))

Значение квалификатора нельзя переопределить в производном классе или экземпляре. Использование этой константы аналогично использованию флага DisableOverride .

WBEM_FLAVOR_AMENDED (128 (0x80))

Квалификатор локализован. Использование этой константы аналогично использованию флага Изменено .

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

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

Требования

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

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

Варианты квалификатора