EventWaitHandle.TryOpenExisting Method (String, EventWaitHandleRights, EventWaitHandle)
Opens the specified named synchronization event, if it already exists, with the desired security access, and returns a value that indicates whether the operation succeeded.
Assembly: mscorlib (in mscorlib.dll)
static member TryOpenExisting : name:string * rights:EventWaitHandleRights * result:EventWaitHandle byref -> bool
- Type: System.String
The name of the system synchronization event to open.
- Type: System.Security.AccessControl.EventWaitHandleRights
A bitwise combination of the enumeration values that represent the desired security access.
Return ValueType: System.Boolean
true if the named synchronization event was opened successfully; otherwise, false.
name is an empty string.
name is longer than 260 characters.
name is a null reference (Nothing in Visual Basic).
A Win32 error occurred.
The named event exists, but the user does not have the desired security access.
If the named synchronization event does not exist, this method does not create it. To create the system event when it does not already exist, use one of the EventWaitHandle constructors that has a name parameter.
If you are uncertain whether a named synchronization event exists, use this method overload instead of the OpenExisting(String, EventWaitHandleRights) method overload, which throws an exception if the synchronization event does not exist.
The rights parameter must include the EventWaitHandleRights.Synchronize flag to allow threads to wait on the event, and the EventWaitHandleRights.Modify flag to allow threads to call the Set and Reset methods.
Multiple calls to this method that use the same value for name do not necessarily return the same EventWaitHandle object, even though the objects that are returned represent the same named system event.
requires full trust for the immediate caller. This member cannot be used by partially trusted or transparent code.
Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.