IHostSyncManager::CreateMonitorEvent (Método)

Artículo
08/10/2011

Crea un objeto de evento de restablecimiento automático supervisado.

HRESULT CreateMonitorEvent (
    [in]  SIZE_T cookie,
    [out] IHostAutoEvent **ppEvent
);

Parámetros

cookie
[in] Cookie para asociarla al objeto de evento.
ppEvent
[out] Puntero a la dirección de una instancia de IHostAutoEvent o NULL si no se ha podido crear el objeto de evento.

Valor devuelto

HRESULT	Descripción
S_OK	CreateMonitorEvent finalizó correctamente.
HOST_E_CLRNOTAVAILABLE	Common Language Runtime (CLR) no se ha cargado en un proceso o está en un estado en el que no puede ejecutar el 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 llamador no posee el bloqueo.
HOST_E_ABANDONED	Se canceló un evento mientras una fibra o un subproceso bloqueado estaba esperándole.
E_FAIL	Se ha producido un error catastrófico desconocido. Si un método devuelve E_FAIL, CLR no se puede seguir utilizando en el proceso. Las llamadas subsiguientes a métodos de hospedaje devuelven HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY	No había suficiente memoria disponible para crear el objeto de evento solicitado.

Comentarios

CreateMonitorEvent devuelve una instancia de IHostAutoEvent que CLR utiliza en su implementación del tipo System.Threading.Monitor administrado. Este método refleja la función CreateEvent de Win32, con un valor false para el parámetro bManualReset.

El host puede utilizar la cookie para determinar qué tarea está esperando el monitor mediante una llamada al método ICLRSyncManager::GetMonitorOwner.