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