IHostSyncManager::CreateMonitorEvent (Método)
Este método puede usarse para crear un objeto de evento de restablecimiento automático supervisado.
Sintaxis
HRESULT CreateMonitorEvent (
[in] SIZE_T cookie,
[out] IHostAutoEvent **ppEvent
);
Parámetros
cookie
[in] El valor de este parámetro se corresponde con la cookie que se va a asociar con el objeto de evento en cuestión.
ppEvent
[out] El valor de este parámetro se corresponde con un puntero a la dirección de una instancia de la interfaz IHostAutoEvent o, alternativamente, es null si no se puede crear el objeto de evento.
Valor devuelto
| HRESULT | Descripción |
|---|---|
| S_OK | CreateMonitorEvent se devolvió correctamente. |
| HOST_E_CLRNOTAVAILABLE | El Common Language Runtime (CLR) no se ha cargado en un proceso o se encuentra en un estado en el que no puede ejecutar código administrado o procesar la llamada correctamente. |
| HOST_E_TIMEOUT | Se agotó el tiempo de espera de la llamada. |
| HOST_E_NOT_OWNER | El autor de la llamada no es el propietario del bloqueo. |
| HOST_E_ABANDONED | Se canceló un evento mientras que una fibra o subproceso que estaba bloqueado lo estaba esperando. |
| E_FAIL | Ocurrió un error grave desconocido. Si un método devuelve el valor E_FAIL, el CLR ya no se podrá usar en el proceso. Las llamadas que se hagan a los métodos de hospedaje posteriormente devolverán el valor HOST_E_CLRNOTAVAILABLE. |
| E_OUTOFMEMORY | Si se devuelve este valor, significa que no hubo suficiente memoria disponible para crear el objeto de evento que se solicitó. |
Comentarios
El uso del método CreateMonitorEvent le devolverá una instancia de la interfaz IHostAutoEvent que puede usarse con la implementación del tipo administrado System.Threading.Monitor del motor CLR. Este método es equivalente a la función CreateEvent de Win32 cuando se establece un valor de false en el parámetro bManualReset de esta.
A partir de la cookie, el host puede determinar qué tarea está esperando al monitor mediante una llamada al método ICLRSyncManager::GetMonitorOwner.
Requisitos
Plataformas: Vea Requisitos de sistema.
Encabezado: MSCorEE.h
Biblioteca: incluida como recurso en MSCorEE.dll
Versiones de .NET Framework: disponible a partir de la versión 2.0
