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.