SWbemQualifierSet.Add method

The Add method of the SWbemQualifierSet object adds an SWbemQualifier object to the SWbemQualifierSet collection. If a qualifier with the same name already exists in the collection, it is replaced.

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

Syntax

objQualifier = .Add( _
  ByVal strName, _
  ByVal varVal, _
  [ ByVal bPropagatesToSubclasses ], _
  [ ByVal bPropagatesToInstances ], _
  [ ByVal bOverridable ], _
  [ ByVal iFlags ] _
)

Parameters

strName [in]

Required. Name of the new qualifier.

varVal [in]

Required. Variant value of the new qualifier.

bPropagatesToSubclasses [in, optional]

Boolean value that indicates if this new qualifier is propagated to subclasses. The default value is TRUE.

bPropagatesToInstances [in, optional]

Boolean value that indicates if this new qualifier is propagated to instances. The default value is TRUE.

bOverridable [in, optional]

Boolean value that indicates if this qualifier can be overridden when propagated. The default value is TRUE.

iFlags [in, optional]

Reserved. The default value is 0.

Return value

If successful, this method returns an SWbemQualifier object that represents the new qualifier. Otherwise, a null object is returned.

Error codes

After completion of the Add 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.

wbemErrCannotBeKey - 2147749919 (0x8004101F)

There was an illegal attempt to specify a Key qualifier on a property that cannot be a key. The keys are specified in the class definition for an object and cannot be altered on a per-instance basis.

wbemErrInvalidQualifierType - 2147749929 (0x80041029)

The varVal parameter is not of a legal qualifier type.

wbemErrOverrideNotAllowed - 2147749914 (0x8004101A)

It is not possible to perform the SWbemQualifierSet.Add operation on this qualifier because the owning object does not permit overrides.

Requirements

See also

SWbemQualifierSet

SWbemQualifierSet.Remove