Export (0) Print
Expand All

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 table.

Error (Name/Dec/Hex)Meaning
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 2003

Type library

Wbemdisp.tlb

DLL

Wbemdisp.dll

See also

SWbemPropertySet.Add

 

 

Show:
© 2014 Microsoft