UDF > WinAPIEx > Processes & Synchronization > Synchronization >


_WinAPI_OpenMutex

Ouvre un objet Mutex nommé existant

#include <WinAPIProc.au3>
_WinAPI_OpenMutex ( $sMutex [, $iAccess = $MUTEX_ALL_ACCESS [, $bInherit = False]] )

Paramètres

$sMutex Le nom du mutex à ouvrir. La comparaison des noms est sensible à la casse.
$iAccess [optionnel] L'accès à l'objet Mutex. 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:
$MUTEX_ALL_ACCESS
$MUTEX_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 Mutex.
É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 mutex en utilisant la fonction _WinAPI_CreateMutex()
. Le processus appelant peut utiliser la handle retourné dans toute fonction qui nécessite un handle d'objet mutex.

En relation

_WinAPI_CreateMutex

Voir aussi

Consultez OpenMutex dans la librairie MSDN.