Metodo IHostSyncManager::CreateMonitorEvent

Articolo
08/11/2011

Crea un oggetto evento di reimpostazione automatica monitorata.

HRESULT CreateMonitorEvent (
    [in]  SIZE_T cookie,
    [out] IHostAutoEvent **ppEvent
);

Parametri

cookie
[in] Cookie da associare all'oggetto evento.
ppEvent
[out] Puntatore all'indirizzo di un'istanza di IHostAutoEvent oppure null se non è stato possibile creare l'oggetto evento.

Valore restituito

HRESULT	Oggetto di descrizione
S_OK	CreateMonitorEvent ha restituito correttamente un valore.
HOST_E_CLRNOTAVAILABLE	Common Language Runtime non è stato caricato in un processo oppure si trova in uno stato in cui non è possibile eseguire codice gestito né elaborare correttamente la chiamata.
HOST_E_TIMEOUT	Timeout della chiamata.
HOST_E_NOT_OWNER	Il chiamante non è il proprietario del blocco.
HOST_E_ABANDONED	Un evento è stato annullato mentre un thread o un fiber bloccato era in attesa di tale evento.
E_FAIL	Si è verificato un errore irreversibile sconosciuto. Se un metodo restituisce E_FAIL, CLR non sarà più utilizzabile all'interno del processo. Le successive chiamate ai metodi di hosting restituiranno HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY	Memoria insufficiente per la creazione dell'oggetto evento richiesto.

Note

CreateMonitorEvent restituisce un oggetto IHostAutoEvent che verrà utilizzato da CLR per l'implementazione del tipo gestito System.Threading.Monitor. Questo metodo si comporta in modo identico alla funzione Win32 CreateEvent con un valore false specificato per il parametro bManualReset

L'host può utilizzare il cookie per determinare l'attività in attesa sul monitor chiamando il metodo ICLRSyncManager::GetMonitorOwner.