MutexAcl.TryOpenExisting(String, MutexRights, Mutex) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Tente d’ouvrir un mutex nommé spécifié, s’il existe déjà, applique les droits d’accès souhaités et retourne une valeur qui indique si l’opération a réussi.
public:
static bool TryOpenExisting(System::String ^ name, System::Security::AccessControl::MutexRights rights, [Runtime::InteropServices::Out] System::Threading::Mutex ^ % result);
public static bool TryOpenExisting (string name, System.Security.AccessControl.MutexRights rights, out System.Threading.Mutex? result);
static member TryOpenExisting : string * System.Security.AccessControl.MutexRights * Mutex -> bool
Public Shared Function TryOpenExisting (name As String, rights As MutexRights, ByRef result As Mutex) As Boolean
Paramètres
- name
- String
Nom du mutex à ouvrir. S’il est précédé de « Global », il fait référence à un mutex à l’échelle de l’ordinateur. S’il est préfixé par « Local » ou n’a pas de préfixe, il fait référence à un mutex à l’échelle de la session. Le préfixe et le nom respectent la casse.
- rights
- MutexRights
Droits d’accès souhaités à appliquer au mutex retourné.
- result
- Mutex
Lorsque cette méthode retourne true
, contient un objet qui représente le mutex nommé si l’appel a réussi, ou null
sinon. Ce paramètre est traité comme étant non initialisé.
Retours
true
si le mutex nommé a été ouvert ; sinon, false
.
Exceptions
name
a la valeur null
.
name
est une chaîne vide.
Une erreur Win32 s’est produite.
Le mutex nommé existe, mais l’utilisateur ne dispose pas de l’accès de sécurité nécessaire pour l’utiliser.