Метод SWbemPropertySet.Remove

Статья
06/13/2023

Метод 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

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