This topic has not yet been rated - Rate this topic

IWbemQualifierSet::BeginEnumeration method

The IWbemQualifierSet::BeginEnumeration method resets before there is an enumeration of all the qualifiers in the object. To enumerate all of the qualifiers on an object, this method must be called before the first call to IWbemQualifierSet::Next. The order in which qualifiers are enumerated is guaranteed to be invariant for a given instance of IWbemQualifierSet.

Syntax

C++


HRESULT BeginEnumeration(
  [in]  LONG lFlags
);

Parameters

lFlags [in]

Specifies the qualifiers to include in the enumeration. It must be one of the following constants.

Constant	Meaning
0 (Zero)	Return the names of all qualifiers.
WBEM_FLAG_LOCAL_ONLY	Return only the names of qualifiers specific to the current property or object. If the current qualifiers set refers to a property, return only the qualifiers specific to the property (including overrides), and not those qualifiers propagated from the class definition. 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 specific to the class being derived.
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 the class definition, and not those from the 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 parent classes.

Return value

This method returns an HRESULT indicating the status of the method call. The following table lists the value contained within an HRESULT.

Return code	Description
WBEM_E_INVALID_PARAMETER	The lFlags parameter was not valid.
WBEM_E_OUT_OF_MEMORY	There was not enough memory to complete the operation.
WBEM_E_UNEXPECTED	A second call was made to IWbemQualifierSet::BeginEnumeration without an intervening call to IWbemQualifierSet::EndEnumeration.
WBEM_S_NO_ERROR	The call succeeded.

Examples

For script code examples, see WMI Tasks for Scripts and Applications and the TechNet ScriptCenter Script Repository.

For C++ code examples, see WMI C++ Application Examples.

Requirements

Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Header	Wbemcli.h (include Wbemidl.h)
Library	Wbemuuid.lib
DLL	Fastprox.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll

Community Additions

ADD