Método IHostSyncManager::CreateMonitorEvent
Cria um objeto de evento de redefinição automática monitorado.
Sintaxe
HRESULT CreateMonitorEvent (
[in] SIZE_T cookie,
[out] IHostAutoEvent **ppEvent
);
Parâmetros
cookie
[in] Um cookie a ser associado ao objeto de evento.
ppEvent
[out] Um ponteiro para o endereço de uma instância IHostAutoEvent ou nulo se o objeto de evento não pôde ser criado.
Valor Retornado
| HRESULT | Descrição |
|---|---|
| S_OK | CreateMonitorEvent retornado com êxito. |
| HOST_E_CLRNOTAVAILABLE | O CLR (Common Language Runtime) não foi carregado em um processo ou está em um estado no qual não pode executar o código gerenciado ou processar a chamada com sucesso. |
| HOST_E_TIMEOUT | Uma chamada atingiu o tempo limite. |
| HOST_E_NOT_OWNER | O chamador não possui o bloqueio. |
| HOST_E_ABANDONED | Um evento foi cancelado enquanto uma fibra ou um thread bloqueado estava esperando por ele. |
| E_FAIL | Uma falha catastrófica desconhecida ocorreu. Quando um método retorna E_FAIL, o CLR não pode mais ser usado no processo. Chamadas subsequentes para métodos de hospedagem retornam HOST_E_CLRNOTAVAILABLE. |
| E_OUTOFMEMORY | Não havia memória suficiente disponível para criar o objeto de evento solicitado. |
Comentários
CreateMonitorEvent retorna um IHostAutoEvent que o CLR usa em sua implementação do tipo System.Threading.Monitor gerenciado. Esse método espelha a função CreateEvent Win32, com um valor false especificado para o parâmetro bManualReset.
O host pode usar o cookie para determinar qual tarefa está aguardando no monitor chamando o método ICLRSyncManager::GetMonitorOwner .
Requisitos
Plataformas: confira Requisitos do sistema.
Cabeçalho: MSCorEE.h
Biblioteca: incluída como um recurso no MSCorEE.dll
Versões do .NET Framework: disponíveis desde 2.0
