Método IHostCrst::TryEnter

Artigo
05/10/2023

Tenta introduzir a secção crítica representada pela instância atual do IHostCrst .

Sintaxe

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

Parâmetros

option
[in] Um dos valores de WAIT_OPTION , que indica a ação que o anfitrião deve tomar se a operação bloquear.

pbSucceeded
[fora] true se for possível introduzir a secção crítica; caso contrário, false.

Devolver Valor

HRESULT	Description
S_OK	`TryEnter` devolvido com êxito.
HOST_E_CLRNOTAVAILABLE	O runtime de linguagem comum (CLR) não foi carregado para um processo ou o CLR está num estado em que não pode executar código gerido ou processar a chamada com êxito.
HOST_E_TIMEOUT	A chamada excedeu o limite de tempo.
HOST_E_NOT_OWNER	O autor da chamada não é o proprietário do bloqueio.
HOST_E_ABANDONED	Um evento foi cancelado enquanto um thread ou fibra bloqueado estava à espera do mesmo.
E_FAIL	Ocorreu uma falha catastrófica desconhecida. Quando um método devolve E_FAIL, o CLR já não é utilizável no processo. As chamadas subsequentes para métodos de alojamento devolvem HOST_E_CLRNOTAVAILABLE.

Observações

TryEnter devolve imediatamente e indica se o thread de chamada entrou na secção crítica. Este método espelha a função Wind32 TryEnterCriticalSection .

Requisitos

Plataformas: Veja Requisitos do Sistema.

Cabeçalho: MSCorEE.h

Biblioteca: Incluído como um recurso no MSCorEE.dll

.NET Framework Versões: Disponível desde 2.0

Partilhar via