System.Threading.EventWaitHandle.OpenExisting Method

Opens the specified named synchronization event, if it already exists, with the desired security access.

Syntax

public static EventWaitHandle OpenExisting (string name, System.Security.AccessControl.EventWaitHandleRights rights)

Parameters

name
The name of the system synchronization event to open.
rights
A bitwise combination of the enumeration values that represent the desired security access.

Returns

An object that represents the named system event.

Remarks

The rights parameter must include the System.Security.AccessControl.EventWaitHandleRights.Synchronize flag to allow threads to wait on the event, and the System.Security.AccessControl.EventWaitHandleRights.Modify flag to allow threads to call the EventWaitHandle.Set and EventWaitHandle.Reset methods.

The erload:System.Threading.EventWaitHandle.OpenExisting method tries to open an existing named system event. If the system event does not exist, this method throws an exception instead of creating the system event. To create the system event when it does not already exist, use one of the EventWaitHandle.#ctor(bool, EventResetMode, string, Boolean@, System.Security.AccessControl.EventWaitHandleSecurity) constructors that has a name parameter.

Multiple calls to this method that use the same value for name do not necessarily return the same System.Threading.EventWaitHandle object, even though the objects that are returned represent the same named system event.

Requirements

Namespace: System.Threading
Assembly: mscorlib (in mscorlib.dll)
Assembly Versions: 2.0.0.0, 4.0.0.0
Since: .NET 2.0