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

Функция 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).

Константа Значение Описание
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 , или их можно определить как константы в коде:

Константа Значение Описание
WBEM_E_CANNOT_BE_KEY 0x8004101f Была предпринята недопустимая попытка указать квалификатор ключа для свойства, которое не может быть ключом. Ключи указываются в определении класса объекта и не могут быть изменены для каждого отдельного экземпляра.
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.

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