Metodo IHostSyncManager::CreateRWLockReaderEvent

Articolo
08/11/2011

Crea un oggetto evento di reimpostazione manuale per l'implementazione di un blocco reader.

HRESULT CreateRWLockReaderEvent (
    [in]  BOOL bInitialState,
    [in]  SIZE_T cookie,
    [out] IHostManualEvent **ppEvent
);

Parametri

bInitialState
[in] true se ppEvent deve essere segnalato; in caso contrario, false.
cookie
[in] Cookie da associare al blocco reader.
ppEvent
[out] Puntatore all'indirizzo di un'istanza di IHostManualEvent oppure null se non è stato possibile creare l'oggetto evento.

Valore restituito

HRESULT	Oggetto di descrizione
S_OK	CreateRWLockReaderEvent 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

CLR chiama CreateRWLockReaderEvent per ottenere un riferimento a un'istanza di IHostManualEvent da utilizzare nella relativa implementazione di un blocco reader. L'host può utilizzare il cookie per individuare le attività in attesa sul blocco reader eseguendo una query sull'interfaccia ICLRSyncManager.