UDF > WinAPIEx > Processes & Synchronization > Synchronization >


_WinAPI_OpenSemaphore

Ouvre un objet Semaphore nommé existant

#include <WinAPIProc.au3>
_WinAPI_OpenSemaphore ( $sSemaphore [, $iAccess = 0x001F0003 [, $bInherit = False]] )

Paramètres

$sSemaphore Le nom du sémaphore à ouvrir. La comparaison des noms est sensible à la casse.
$iAccess [optionnel] L'accès à l'objet sémaphore. La fonction échoue si le descripteur de sécurité de l'objet spécifié ne permet pas l'accès demandé au processus appelant.
Ce paramètre peut prendre l'une des valeurs suivantes:
$SEMAPHORE_ALL_ACCESS (par défaut)
$SEMAPHORE_MODIFY_STATE
$bInherit [optionnel] Spécifie si le handle peut être hérité par les processus, les valeurs valables sont:
True - Les processus créés par ce processus hériteront du handle.
False - Les processus n'hériteront pas de ce handle (par défaut).

Valeur de retour

Succès: Retourne le handle de l'objet Semaphore.
Échec: Retourne 0, appelez _WinAPI_GetLastError() pour obtenir des informations supplémentaires sur l'erreur.

Remarque

La fonction ne réussit que si un processus a déjà créé le sémaphore en utilisant la fonction _WinAPI_CreateMutex().
Le processus appelant peut utiliser la handle retourné dans toute fonction qui nécessite un handle d'objet sémaphore.

En relation

_WinAPI_CreateSemaphore

Voir aussi

Consultez OpenSemaphore dans la librairie MSDN.