IWbemQualifierSet::GetNames

[This is preliminary documentation and subject to change.]

The IWbemQualifierSet::GetNames method retrieves the names of all of the qualifiers available. Alternately, depending on the filter value of IFlags, this method retrieves the names of certain qualifiers.

You can access these qualifiers by name, using IWbemQualifierSet::Get for each name. It is not an error for any given object to have zero qualifiers, so the number of strings in pbstrNames on return can be zero, even though WBEM_NO_ERROR is returned.

HRESULT IWbemQualifierSet::GetNames(
  [in] LONG lFlags,
  [out] SAFEARRAY (BSTR) *pbstrNames 
);
 

Parameters

lFlags

One of the following constants:

0 (Zero)	Return the names of all qualifiers.
WBEM_FLAG_LOCAL_ONLY	Return only the names of the local object. If the current qualifiers set refers to a property, return only the qualifiers set on this property, and not those qualifiers propagated from another qualifier set. If the current qualifiers set refers to an instance, return only instance-specific qualifier names. If the current qualifiers set refers to a class, return only qualifiers local to the derived-most class.
WBEM_FLAG_PROPAGATED_ONLY	Return only the names of qualifiers propagated from another object. For example, if the current qualifier set refers to a property, return only the qualifiers propagated to this property from another qualifier set, and not those set on this property itself. If the current qualifier set refers to an instance, only return those qualifiers propagated from the class definition. If the current qualifier set refers to a class, only return those qualifier names inherited from the superclasses.

pbstrNames

A new SAFEARRAYis created that contains the requested names.

In all cases where no error is returned, a new array is created and pbstrNames is set to point to it. This occurs even though the resulting array has zero elements. On error, a new SAFEARRAY is not returned.

Return Values

See Also

IWbemQualifierSet::Get

IWbemQualifierSet::BeginEnumeration