IHostSyncManager::CreateRWLockWriterEvent (Método)

Artículo
08/10/2011

Crea un objeto de evento de restablecimiento automático para la implementación de un bloqueo de escritura.

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

Parámetros

cookie
[in] Cookie para asociarla al evento de restablecimiento automático.
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	CreateRWLockWriterEvent 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

CLR llama al método CreateRWLockWriterEvent para obtener una referencia a una instancia de IHostAutoEvent y utilizarla en su implementación de un bloqueo de escritura. El host puede utilizar la cookie especificada para determinar las tareas que están esperando al bloqueo llamando a los métodos de iteración de la interfaz ICLRSyncManager.