IHostSyncManager::CreateSemaphore, méthode

Article
05/10/2023

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

Partager via