DIWbemServices.CreateClassEnumAsync

[This is preliminary documentation and subject to change.]

The DIWbemServices.CreateClassEnumAsync method performs the same function as DIWbemServices.CreateClassEnum, except that the objects return to the specified DIWbemObjectSink implementation instead of to an enumerator.

In cases where the call succeeds, CIMOM asynchronously calls pResponseHandler – >Notify from another thread with class definitions until the query has been satisfied.

DIWbemServices.CreateClassEnumAsync(
  [in] Superclass As String, 
  [in] lFlags As Long , 
  [in] pCtx As Object, 
  [in] pResponseHandler As Object
) As Long
 

Parameters

Superclass
If not vbNullStringor blank, this parameter specifies a superclass name. Only classes that are subclasses of this class return in the enumerator. If vbNullStringor blank, and if lFlags is WBEM_FLAG_SHALLOW, only top-level classes, which have no parent class or superclass, return. If vbNullStringor blank, and if lFlags is WBEM_FLAG_DEEP, all classes within the namespace return.
lFlags
WBEM_FLAG_DEEP forces recursive enumeration into all subclasses derived from the specified superclass. The superclass itself does not return in the enumeration.

WBEM_FLAG_SHALLOW forces the enumeration to include only immediate subclasses of the specified superclass.

Note  If Superclass is vbNullStringor blank, and WBEM_FLAG_DEEP is specified, all classes return.

pCtx
Typically NOTHING. Otherwise, this is an DWbemContext object required by the dynamic class provider that is producing the class instances. You must specify the values in the context object in the documentation for the provider in question.
PResponseHandler
Object that is the caller's implementation of DIWbemObjectSink. This handler receives the objects as they become available using the DIWbemObjectSink.Indicate method. When there are no more objects, CIMOM calls the DIWbemObjectSink.SetStatus method. For a detailed explanation of this parameter, see Asynchronous Methods.

Return Values

WBEM_E_FAILED Unspecified error.
WBEM_E_INVALID_PARAMETER An invalid parameter was specified, or the namespace could not be parsed.
WBEM_E_OUT_OF_MEMORY There was not enough memory to complete the operation.
WBEM_NO_ERROR Success.

For more information on return values see Visual Basic error handeling and return values

See Also

Asynchronous Methods, DIWbemServices.CreateClassEnum, DIWbemObjectSink