IHostSyncManager::CreateRWLockReaderEvent, méthode

Article
05/10/2023

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

Syntaxe

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` retourné.
HOST_E_CLRNOTAVAILABLE	Le Common Language Runtime (CLR) n’a pas été chargé dans un processus ou est dans un état dans lequel il ne peut ni exécuter le code managé ni traiter l’appel avec succès.
HOST_E_TIMEOUT	L’appel a expiré.
HOST_E_NOT_OWNER	L’appelant n’est pas propriétaire du verrou.
HOST_E_ABANDONED	Un événement a été annulé alors qu’un thread ou une fibre bloqué l’attendait.
E_FAIL	Une défaillance catastrophique inconnue s’est produite. Quand une méthode retourne E_FAIL, le CLR n’est plus utilisable au sein du processus. Les appels suivants aux méthodes d’hébergement renvoient HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY	La mémoire insuffisante pour créer l’objet d’événement demandé.

Notes

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

Spécifications

Plateformes : Consultez Configuration requise.

En-tête : MSCorEE.h

Bibliothèque : incluse en tant que ressource dans MsCorEE.dll

Versions de .NET Framework : Disponible depuis la version 2.0

Partager via