GetFirstEvent

Get the first name of the source.
This method resets the internal iterator and calls GetNextEvent
To continue enumation call GetNextEvent.
If the source is locked by an asyncroneous operation, this method will not return E_FAIL, but wait until the lock is released.

HRESULT GetFirstEvent([out,retval]
IEvtCfgEvent** ppEvent);

Parameters

ppEvent

[out, retval] pointer to a IEvtCfgEvent interface pointer to store the first child of this source.

Return Values

S_OK

name contains the first name of this source.

S_FALSE

The source does not have any childs. *ppEvent is set to NULL.

E_POINTER

ppEvent was no valid pointer

E_ACCESSDENIED

The object is locked due to an asynchronous operation