Método IHostSyncManager::CreateMonitorEvent
Cria um objeto de evento de reposição automática monitorizado.
Sintaxe
HRESULT CreateMonitorEvent (
[in] SIZE_T cookie,
[out] IHostAutoEvent **ppEvent
);
Parâmetros
cookie
[in] Um cookie para associar ao objeto de evento.
ppEvent
[fora] Um ponteiro para o endereço de uma instância IHostAutoEvent ou nulo se não for possível criar o objeto de evento.
Devolver Valor
HRESULT | Description |
---|---|
S_OK | CreateMonitorEvent 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. |
E_OUTOFMEMORY | Não havia memória suficiente disponível para criar o objeto de evento pedido. |
Observações
CreateMonitorEvent
devolve um IHostAutoEvent
que o CLR utiliza na implementação do tipo gerido System.Threading.Monitor . Este método espelha a função Win32 CreateEvent
, com um valor de false
especificado para o bManualReset
parâmetro.
O anfitrião pode utilizar o cookie para determinar que tarefa está a aguardar no monitor ao chamar o método ICLRSyncManager::GetMonitorOwner .
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