IHostSyncManager::CreateRWLockReaderEvent, méthode

Article
08/10/2011

Crée un objet événement de réinitialisation manuelle pour l'implémentation d'un verrou de lecteur.

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

Paramètres

bInitialState
[in] true, si ppEvent doit être signalé ; sinon false.
cookie
[in] Cookie à associer au verrou de lecteur.
ppEvent
[out] Pointeur vers l'adresse d'une instance IHostManualEvent, ou null si l'objet événement n'a pas pu être créé.

Valeur de retour

HRESULT	Description
S_OK	CreateRWLockReaderEvent a été retourné avec succès.
HOST_E_CLRNOTAVAILABLE	Le Common Language Runtime (CLR) n'a pas été chargé dans un processus ou le CLR présente un état dans lequel il ne peut pas exécuter de code managé ou traiter l'appel avec succès.
HOST_E_TIMEOUT	L'appel a expiré.
HOST_E_NOT_OWNER	L'appelant ne possède pas le verrou.
HOST_E_ABANDONED	Un événement a été annulé alors qu'un thread bloqué ou une fibre l'attendait.
E_FAIL	Une défaillance grave et inconnue s'est produite. Lorsqu'une méthode retourne E_FAIL, le CLR n'est plus utilisable dans le processus. Les appels suivants aux méthodes d'hébergement retournent HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY	Mémoire disponible insuffisante pour la création de l'objet événement demandé.

Notes

Le CLR appelle CreateRWLockReaderEvent pour obtenir une référence à une instance IHostManualEvent à utiliser dans son implémentation d'un verrou de lecteur. L'hôte peut utiliser le cookie pour déterminer quelles tâches attendent le verrou de lecteur en interrogeant l'interface ICLRSyncManager.