Метод SWbemPropertySet.Add

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

Описание этого синтаксиса см. в разделе Соглашения о документах для 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 .

Требования

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

SWbemPropertySet

SWbemPropertySet.Remove

SWbemProperty.Value