SWbemQualifierSet.Remove method

Article
01/07/2021

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

Requirement	Value
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