IWbemContext::BeginEnumeration method

The IWbemContext::BeginEnumeration method resets the enumeration of all the context values in the object. This method must be called before the first call to IWbemContext::Next to enumerate all of the context values in the object. The order in which context values are enumerated is guaranteed to be invariant for a given instance of IWbemContext.

Syntax


HRESULT BeginEnumeration(
  [in] LONG lFlags
);

Parameters

lFlags [in]

Reserved. This parameter must be 0.

Return value

This method returns an HRESULTHRESULT indicating the status of the method call. The following list lists the value contained withinan HRESULTHRESULT.

WBEM_E_INVALID_PARAMETER

The lFlags parameter was not valid.

WBEM_S_NO_ERROR

The call succeeded.

WBEM_E_OUT_OF_MEMORY

There was not enough memory to begin an enumeration.

WBEM_E_UNEXPECTED

A second call was made to IWbemContext::BeginEnumeration without an intervening call to IWbemContext::EndEnumeration.

WBEM_E_FAILED

There has been a general failure.

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Header

WbemCli.h (include Wbemidl.h)

Library

Wbemuuid.lib

DLL

Esscli.dll;
Fastprox.dll;
FrameDyn.dll;
FrameDynOS.dll;
Wbemcomn.dll;
Wbemcore.dll;
Wbemess.dll;
Wmipjobj.dll

See also

IWbemContext
IWbemContext::EndEnumeration
IWbemContext::Next

 

 

Show: