Метод SWbemQualifierSet.Add

Статья
06/13/2023

Метод Add объекта SWbemQualifierSet добавляет объект SWbemQualifier в коллекцию SWbemQualifierSet . Если квалификатор с тем же именем уже существует в коллекции, он заменяется.

Описание этого синтаксиса см. в разделе Соглашения о документах для API скриптов.

Синтаксис

objQualifier = .Add( _
  ByVal strName, _
  ByVal varVal, _
  [ ByVal bPropagatesToSubclasses ], _
  [ ByVal bPropagatesToInstances ], _
  [ ByVal bOverridable ], _
  [ ByVal iFlags ] _
)

Параметры

strName [in]: Обязательный. Имя нового квалификатора.
varVal [in]: Обязательный. Значение Variant нового квалификатора.
bPropagatesToSubclasses [in, необязательный]: Логическое значение, указывающее, распространяется ли этот новый квалификатор на подклассы. Значение по умолчанию — TRUE.
bPropagatesToInstances [in, необязательный]: Логическое значение, указывающее, распространяется ли этот новый квалификатор на экземпляры. Значение по умолчанию — TRUE.
bOverridable [in, optional]: Логическое значение, указывающее, можно ли переопределить этот квалификатор при распространении. Значение по умолчанию — TRUE.
iFlags [in, необязательный]: Зарезервировано. Значение по умолчанию — 0.

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

В случае успешного выполнения этот метод возвращает объект SWbemQualifier , представляющий новый квалификатор. В противном случае возвращается объект NULL .

Коды ошибок

После завершения метода Add объект Err может содержать один из кодов ошибок из следующего списка.

wbemErrInvalidParameter — 2147749896 (0x80041008): Недопустимый параметр iFlags .
wbemErrFailed — 2147749889 (0x80041001): Незаданная ошибка.
wbemErrCannotBeKey — 2147749919 (0x8004101F): Была предпринята недопустимая попытка указать квалификатор ключа для свойства, которое не может быть ключом. Ключи указываются в определении класса объекта и не могут быть изменены для каждого отдельного экземпляра.
wbemErrInvalidQualifierType — 2147749929 (0x80041029): Параметр varVal не имеет юридического типа квалификатора.
wbemErrOverrideNotAllowed — 2147749914 (0x8004101A): Невозможно выполнить операцию SWbemQualifierSet.Add для этого квалификатора, так как объект-владение не допускает переопределения.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Заголовок	Wbemdisp.h
Библиотека типов	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemQualifierSet
IID	IID_ISWbemQualifierSet

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

SWbemQualifierSet
SWbemQualifierSet.Remove

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