Метод SWbemPropertySet.Add

Статья
06/13/2023

Метод Add объекта SWbemPropertySet добавляет объект SWbemProperty в коллекцию SWbemPropertySet . Если свойство с таким же именем уже существует в коллекции, его содержимое заменяется новым определением.

Примечание

Значение добавленного свойства после этой операции равно NULL (не назначено). Чтобы задать или изменить значение свойства WMI, необходимо задать свойство Value возвращаемого объекта SWbemProperty .

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

Синтаксис

objProperty = .Add( _
  ByVal strName, _
  ByVal iCIMType, _
  [ ByVal bIsArray ], _
  [ ByVal iFlags ] _
)

Параметры

strName [in]: Обязательный. Имя нового свойства.
iCIMType [in]: Обязательный. Целое число, представляющее квалификатор CIMType нового свойства. Список с квалификаторами CIMType и их значениями см. в разделе WbemCimTypeEnum.
bIsArray [in, необязательный]: Указывает, является ли свойство типом массива. Значение по умолчанию для этого параметра — FALSE.
iFlags [in, необязательный]: Зарезервировано и должно быть равно нулю, если указано.

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

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

Коды ошибок

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

wbemErrFailed — 2147749889 (0x80041001): Неопределенный сбой.
wbemErrInvalidParameter — 2147749896 (0x80041008): Указан недопустимый параметр.
wbemErrOutOfMemory — 2147749894 (0x80041006): Недостаточно памяти для выполнения этого метода.
wbemErrInvalidPropertyType — 2147749930: Квалификатор CIMType не распознается.

Примеры

Пример кода, в котором используется этот метод, см. в разделе SWbemPropertySet .

Требования

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

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

SWbemPropertySet
SWbemPropertySet.Remove
SWbemProperty.Value

Share via