Langue

EventWaitHandleAcl.TryOpenExisting Méthode

Définition

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);
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éfixé par « 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 non initialisé.

Retours

true si le handle d’attente d’événement nommé a été ouvert avec succès ; sinon, false.

Exceptions

name est 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.

S’applique à