IHostSyncManager::CreateMonitorEvent, méthode

Article
05/10/2023

Crée un objet d’événement de réinitialisation automatique supervisé.

Syntaxe

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

Paramètres

cookie
[in] Cookie à associer à l’objet d’événement.

ppEvent
[out] Pointeur vers l’adresse d’une instance IHostAutoEvent ou Null si l’objet d’événement n’a pas pu être créé.

Valeur de retour

HRESULT	Description
S_OK	`CreateMonitorEvent` 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

CreateMonitorEvent retourne un IHostAutoEvent que le CLR utilise dans son implémentation du type System.Threading.Monitor managé. Cette méthode reflète la fonction CreateEvent Win32 avec une valeur false spécifiée pour le paramètre bManualReset.

L’hôte peut utiliser le cookie pour déterminer quelle tâche attend le moniteur en appelant la méthode ICLRSyncManager::GetMonitorOwner.

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