GetFirstEvent
Bekommt den ersten Event der Source.
Diese Funktion resetet den internen Iterator und ruft GetNextEvent auf.
Um die Aufzählung fortzusetzen rufen sie GetNextEvent auf.
Wenn die Source von einer asynchronen Operation gesperrt ist, wird nicht E_FAIL zurückgegeben sondern gewartet bis die sperrung aufgehoben ist.
HRESULT GetFirstEvent([out,retval]
IEvtCfgEvent** ppEvent);
Parameter
ppEvent
[out, retval] Pointer zu einem IEvtCfgEvent interface Pointer in dem das erste Child gespeichert wird.
Rückgabe Werte
S_OK
Funktion erfolgreich ausgeführt.
S_FALSE
Die Source hat keine Events. *ppEvent ist NULL.
E_POINTER
ppEvent ist kein gültiger Pointer
E_ACCESSDENIED
Das Objekt ist wegen einer asynchronen Operation gesperrt.