Metodo IHostCrst::TryEnter

Articolo
08/11/2011

Tenta di accedere alla sezione critica rappresentata dall'istanza corrente di IHostCrst.

HRESULT TryEnter (
    [in]  DWORD  option,
    [out] BOOL   *pbSucceeded
);

Parametri

option
[in] Uno dei valori di WAIT_OPTION, che indica l'azione che deve essere eseguita dall'host in caso di blocco dell'operazione.
pbSucceeded
[out] true se è possibile accedere alla sezione critica; in caso contrario, false.

Valore restituito

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

Note

TryEnter viene compleato immediatamente e indica se il thread chiamante è riuscito ad accedere alla sezione critica. Questo metodo si comporta in modo identico alla funzione Wind32 TryEnterCriticalSection.