IHostSyncManager::CreateRWLockReaderEvent (Método)

Artículo
08/10/2011

Crea un objeto de evento de restablecimiento manual para la implementación de un bloqueo de lectura.

HRESULT CreateRWLockReaderEvent (
    [in]  BOOL bInitialState,
    [in]  SIZE_T cookie,
    [out] IHostManualEvent **ppEvent
);

Parámetros

bInitialState
[in] true si ppEvent debe estar señalado; de lo contrario, false.
cookie
[in] Cookie que se va a asociar al bloqueo de lectura.
ppEvent
[out] Puntero a la dirección de una instancia de IHostManualEvent o NULL si no se ha podido crear el objeto de evento.

Valor devuelto

HRESULT	Descripción
S_OK	CreateRWLockReaderEvent 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 a CreateRWLockReaderEvent para obtener una referencia a una instancia de IHostManualEvent y utilizarla en su implementación de un bloqueo de lectura. El host puede utilizar la cookie para determinar las tareas que están esperando al bloqueo de lectura consultando la interfaz ICLRSyncManager.