SWbemPropertySet.Remove method

The Remove method of the SWbemPropertySet object deletes a property from the SWbemPropertySet collection.

For an explanation of this syntax, see Document Conventions for the Scripting API.

Syntax

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

Parameters

strName [in]

Required. Name of the item to remove.

iFlags [in, optional]

Reserved. This value must be 0 (zero) if specified.

Return value

This method does not return a value.

Error codes

After completion of the Remove method, the Err object may contain one of the error codes in the following list.

wbemErrFailed - 2147749889 (0x80041001)

Unspecified failure.

wbemErrInvalidOperation - 2147749910 (0x80041016)

User attempted to delete a property that cannot be deleted.

wbemErrInvalidParameter - 2147749896 (0x80041008)

Invalid parameter was specified.

wbemErrNotFound - 2147749890 (0x80041002)

Specified property does not exist.

wbemErrOutOfMemory - 2147749894 (0x80041006)

Not enough memory for this method to execute.

wbemErrPropagatedProperty - 142927303552 (0x2147219380)

User attempted to delete a property that was not owned. The property was inherited from a parent class.

wbemErrResetToDefault - 2147758082 (0x80043002)

User deleted an override default value for the current class. The default value for this property in the parent class has been reactivated.

Remarks

Properties cannot be removed from class instances or derived classes with inherited properties. Such deletion attempts raise an error and the property is not removed; the property is reset to its default value.

You cannot iterate a collection while removing items because when you remove an element from a collection, the collection pointer is moved to the next element. For more information, see Accessing a Collection.

Examples

For a code example that uses this method, see the SWbemPropertySet topic.

Requirements

Minimum supported client
Windows Vista
Minimum supported server
Windows Server 2008
Header
Wbemdisp.h
Type library
Wbemdisp.tlb
DLL
Wbemdisp.dll
CLSID
CLSID_SWbemPropertySet
IID
IID_ISWbemPropertySet

See also

SWbemPropertySet

SWbemPropertySet.Add