функция QualifierSet_Put

Записывает именованный квалификатор и значение. Новый квалификатор перезаписывает предыдущее значение того же имени. Если квалификатор не существует, он создается.

Замечание

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

Синтаксис

HRESULT QualifierSet_Put (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LPCWSTR              wszName,
   [in] VARIANT*             pVal,
   [in] LONG                 lFlavor
);

Параметры

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

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

wszName
[in] Имя квалификатора для записи.

pVal
[in] Указатель на допустимый VARIANT , содержащий квалификатор для записи. Этот параметр не может быть null.

lFlavor
[in] Одна из следующих констант, определяющих требуемые вкусы квалификатора для этого квалификатора. Значение по умолчанию — WBEM_FLAVOR_OVERRIDABLE (0).

Постоянный	Ценность	Description
WBEM_FLAVOR_OVERRIDABLE	0	Квалификатор может быть переопределен в производном классе или экземпляре. Это значение по умолчанию.
WBEM_FLAVOR_FLAG_PROPAGATE_TO_INSTANCE	1	Квалификатор распространяется на экземпляры.
WBEM_FLAVOR_FLAG_PROPAGATE_TO_DERIVED_CLASS	2	Квалификатор распространяется на производные классы.
WBEM_FLAVOR_NOT_OVERRIDABLE	0x10	Квалификатор нельзя переопределить в производном классе или экземпляре.
WBEM_FLAVOR_AMENDED	0x80	Квалификатор локализован.

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

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

Постоянный	Ценность	Description
WBEM_E_CANNOT_BE_KEY	0x8004101f	Была неправильная попытка указать Key квалификатор для свойства, которое не может быть ключом. Ключи указываются в определении класса для объекта и не могут быть изменены на основе каждого экземпляра.
WBEM_E_INVALID_PARAMETER	0x80041008	Недопустимый параметр.
WBEM_E_INVALID_QUALIFIER_TYPE	0x80041029	Параметр pVal не является типом юридического квалификатора.
WBEM_E_OVERRIDE_NOT_ALLOWED	0x8004101a	Невозможно вызвать QualifierSet_Put метод квалификатора, так как принадлежащий объект не разрешает переопределения.
WBEM_S_NO_ERROR	0	Вызов функции был успешно выполнен.

Замечания

Эта функция выполняет оболочку вызова метода IWbemQualifierSet::P ut .

Требования

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

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

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

См. также

• Счетчики WMI и производительности (справочник по неуправляемых API)