IHostSyncManager::CreateManualEvent-Methode

2011-08-10

Erstellt ein Ereignisobjekt für manuelles Zurücksetzen.

HRESULT CreateManualEvent (
    [in]  BOOL bInitialState,
    [out] IHostManualEvent **ppEvent
);

Parameter

bInitialState
[in] true, wenn das Objekt signalisiert wird; andernfalls false.
ppEvent
[out] Ein Zeiger auf die Adresse einer IHostManualEvent-Instanz oder NULL, wenn das Ereignis nicht erstellt werden konnte.

Rückgabewert

HRESULT	Beschreibungen
S_OK	CreateManualEvent erfolgreich zurückgegeben.
HOST_E_CLRNOTAVAILABLE	Die Common Language Runtime (CLR) wurde nicht in einen Prozess geladen oder befindet sich in einem Zustand, in dem sie weder verwalteten Code ausführen noch den Aufruf erfolgreich verarbeiten kann.
HOST_E_TIMEOUT	Der Aufruf hat das Zeitlimit überschritten.
HOST_E_NOT_OWNER	Der Aufrufer ist nicht Besitzer der Sperre.
HOST_E_ABANDONED	Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber auf das Ereignis gewartet hat.
E_FAIL	Ein unbekannter, schwerwiegender Fehler ist aufgetreten. Wenn eine Methode E_FAIL zurückgibt, kann die CLR innerhalb des Prozesses nicht mehr verwendet werden. Nachfolgende Aufrufe von Hostmethoden geben HOST_E_CLRNOTAVAILABLE zurück.
E_OUTOFMEMORY	Es war nicht genügend Arbeitsspeicher verfügbar, um das angeforderte Ereignisobjekt zu erstellen.

Hinweise

CreateManualEvent erstellt ein IHostManualEvent, ein Ereignisobjekt für manuelles Zurücksetzen, das einen Aufruf der IHostManualEvent::Reset-Methode erfordert, damit es auf einen nicht signalisierten Zustand festgelegt werden kann. CreateManualEvent spiegelt die Win32-CreateEvent-Funktion, wobei der Wert true für den Parameter bManualReset angegeben wird.