Метод SWbemPropertySet.Remove

Метод Remove объекта SWbemPropertySet удаляет свойство из коллекции SWbemPropertySet .

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

Синтаксис

SWbemPropertySet.Remove( _
  ByVal strName, _
  [ ByVal iFlags ] _
)

Параметры

strName [in]

Обязательный. Имя удаляемого элемента.

iFlags [in, необязательный]

Зарезервировано. Если указано, это значение должно быть равно 0 (ноль).

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

Этот метод не возвращает значение.

Коды ошибок

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

wbemErrFailed — 2147749889 (0x80041001)

Неуказанным сбоем.

wbemErrInvalidOperation — 2147749910 (0x80041016)

Пользователь пытался удалить свойство, которое невозможно удалить.

wbemErrInvalidParameter — 2147749896 (0x80041008)

Указан недопустимый параметр.

wbemErrNotFound — 2147749890 (0x80041002)

Указанное свойство не существует.

wbemErrOutOfMemory — 2147749894 (0x80041006)

Недостаточно памяти для выполнения этого метода.

wbemErrPropagatedProperty — 142927303552 (0x2147219380)

Пользователь попытался удалить свойство, которое не принадлежит. Свойство было унаследовано от класса-родителя.

wbemErrResetToDefault — 2147758082 (0x80043002)

Пользователь удалил переопределенное значение по умолчанию для текущего класса. Значение по умолчанию для этого свойства в родительском классе было повторно активировано.

Комментарии

Свойства нельзя удалить из экземпляров классов или производных классов с наследуемыми свойствами. Такие попытки удаления вызывают ошибку, и свойство не удаляется; Свойство сбрасывается до значения по умолчанию.

Невозможно выполнить итерацию коллекции при удалении элементов, так как при удалении элемента из коллекции указатель коллекции перемещается в следующий элемент. Дополнительные сведения см. в разделе Доступ к коллекции.

Примеры

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

Требования

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

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

SWbemPropertySet

SWbemPropertySet.Add