IHostSyncManager::CreateSemaphore, méthode
Crée un objet IHostSemaphore que le CLR va utiliser comme sémaphore pour les événements d’attente.
Syntaxe
HRESULT CreateSemaphore (
[in] DWORD dwInitial,
[in] DWORD dwMax,
[out] IHostSemaphore **ppSemaphore
);
Paramètres
dwInitial
[in] Nombre initial pour ppSemaphore
.
dwMax
[in] Nombre maximal pour ppSemaphore
.
ppSemaphore
[out] Pointeur vers l’adresse d’une instance IHostSemaphore
ou Null si le sémaphore n’a pas pu être créé.
Valeur de retour
HRESULT | Description |
---|---|
S_OK | CreateSemaphore retourné. |
HOST_E_CLRNOTAVAILABLE | Le CLR n’a pas été chargé dans un processus ou son état ne lui permet pas d’exécuter du code managé ni de traiter l’appel correctement. |
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
CreateSemaphore
équivaut à la fonction Win32 qui porte le même nom. Les paramètres dwInitial
et dwMax
utilisent la même sémantique pour le nombre de sémaphores que les paramètres Win32 lInitialCount
et lMaximumCount
, respectivement. dwInitial
doit être compris entre zéro et dwMax
, inclusivement. dwMax
doit être supérieur à zéro.
Configuration requise
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
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour