SemaphoreAcl.TryOpenExisting(String, SemaphoreRights, Semaphore) 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 sémaphore 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::SemaphoreRights rights, [Runtime::InteropServices::Out] System::Threading::Semaphore ^ % result);
public static bool TryOpenExisting (string name, System.Security.AccessControl.SemaphoreRights rights, out System.Threading.Semaphore? result);
static member TryOpenExisting : string * System.Security.AccessControl.SemaphoreRights * Semaphore -> bool
Public Shared Function TryOpenExisting (name As String, rights As SemaphoreRights, ByRef result As Semaphore) As Boolean
Paramètres
- name
- String
Nom du sémaphore à ouvrir. S’il est préfixé par « Global », il fait référence à un sémaphore à l’échelle de la machine. S’il est préfixé par « Local » ou s’il n’a pas de préfixe, il fait référence à un sémaphore à l’échelle de la session. Le préfixe et le nom respectent la casse.
- rights
- SemaphoreRights
Droits d’accès souhaités à appliquer au sémaphore retourné.
- result
- Semaphore
Lorsque cette méthode retourne true
, contient un objet qui représente le sémaphore nommé si l’appel a réussi, ou null
autrement. Ce paramètre est traité comme étant non initialisé.
Retours
true
si le sémaphore nommé a été ouvert ; sinon, false
.
Exceptions
name
est null
name
est une chaîne vide.
Une erreur Win32 s’est produite.
Le sémaphore nommé existe, mais l’utilisateur ne dispose pas de l’accès de sécurité nécessaire pour l’utiliser.