Partager via


MutexAcl.TryOpenExisting(String, MutexRights, Mutex) Méthode

Définition

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

Boolean

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.

S’applique à