DWbemClassObject.BeginEnumeration

[This is preliminary documentation and subject to change.]

The DWbemClassObject.BeginEnumeration method resets the enumeration sequence of all the properties in the object. You must call this method before the first call to DWbemClassObject.Next to enumerate all of the properties on an object. 

DWbemClassObject.BeginEnumeration(
  [in] lEnumFlags As Long 
) As Long

Parameters

lEnumFlags
A combination of flags described in Remarks.

Return Values

WBEM_E_INVALID_PARAMETER The specified combination of flags was invalid, an invalid parameter was specified, or the namespace could not be parsed.
WBEM_E_OUT_OF_MEMORY There is not enough memory to begin a new enumeration.
WBEM_NO_ERROR Success.

Remarks

You can control the properties included in the enumeration by specifying a combination of the following flags. You can combine one flag from each group with any flag from any other group. However, flags from the same group are mutually exclusive.

GROUP 1

WBEM_FLAG_KEYS_ONLY
Only include properties that constitute the key.
WBEM_FLAG_REFS_ONLY
Only include properties that are object references.

GROUP 2

WBEM_FLAG_LOCAL_ONLY
Only include properties defined or modified in the class itself. Exclude all properties inherited from superclasses. Exclude system properties from the enumeration.
WBEM_FLAG_PROPAGATED_ONLY
Only include properties inherited from superclasses. Exclude properties defined or modified in the class itself. Exclude system properties from the enumeration.
WBEM_FLAG_SYSTEM_ONLY
Limit the enumeration to system properties only.
WBEM_FLAG_NONSYSTEM_ONLY
Exclude system properties from the enumeration. This includes local and propagated properties.

See Also

DWbemClassObject.Next, System Properties, DWbemClassObject.EndEnumeration