SWbemQualifierSet.Remove method

The Remove method of the SWbemQualifierSet object deletes a named qualifier from the collection.

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

Syntax


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

Parameters

strName [in]

Required. Name of the qualifier to remove.

iFlags [in, optional]

Reserved. The default value is 0.

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.

wbemErrInvalidParameter - 2147749896 (0x80041008)

The iFlags parameter was not valid.

wbemErrFailed - 2147749889 (0x80041001)

Unspecified error.

wbemErrNotFound - 2147749890 (0x80041002)

Specified qualifier does not exist.

wbemErrInvalidOperation - 2147749910 (0x80041016)

Removing this qualifier is illegal.

Remarks

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.

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Header

Wbemdisp.h

Type library

Wbemdisp.tlb

DLL

Wbemdisp.dll

CLSID

CLSID_SWbemQualifierSet

IID

IID_ISWbemQualifierSet

See also

SWbemQualifierSet
SWbemQualifierSet.Add

 

 

Show: