GetNextEvent

Get the next child of this source according to the internal iterator.
Before starting enumeration of events call GetFirstEvent
After adding or removing events you must restart enumeration by calling GetFirstEvent.
If the source is locked by an asyncroneous operation, this method will not return E_FAIL, but wait until the lock is released.

 

HRESULT GetNextEvent([out, retval]
IEvtCfgSEvent** ppEvent);

Parameters

ppEvent

[out, retval] pointer to a pointer to store the returned event.

Return Values

S_OK

ppEvent contains a valid pointer to an IEvtCfgSource object.

S_FALSE

The configuration does not contain more events. *ppEvent is set to NULL.

E_POINTER

ppEvent was no valid pointer

E_ACCESSDENIED

The object is locked due to an asynchronous operation