SemaphoreAcl.OpenExisting(String, SemaphoreRights) Method

Definition

Namespace:

System.Threading

Assembly:

System.Threading.AccessControl.dll

Opens a specified named semaphore, if it already exists, and applies the desired access rights.

public:
 static System::Threading::Semaphore ^ OpenExisting(System::String ^ name, System::Security::AccessControl::SemaphoreRights rights);

public static System.Threading.Semaphore OpenExisting (string name, System.Security.AccessControl.SemaphoreRights rights);

static member OpenExisting : string * System.Security.AccessControl.SemaphoreRights -> System.Threading.Semaphore

Public Shared Function OpenExisting (name As String, rights As SemaphoreRights) As Semaphore

Parameters

name

String

The name of the semaphore to be opened. If it's prefixed by "Global", it refers to a machine-wide semaphore. If it's prefixed by "Local", or doesn't have a prefix, it refers to a session-wide semaphore. Both prefix and name are case-sensitive.

rights

SemaphoreRights

The desired access rights to apply to the returned semaphore.

Returns

Semaphore

An existing named semaphore.

Exceptions

ArgumentNullException

name is null.

ArgumentException

name is an empty string.

WaitHandleCannotBeOpenedException

The named semaphore does not exist or is invalid.

IOException

The path was not found.

-or-

A Win32 error occurred.

UnauthorizedAccessException

The named semaphore exists, but the user does not have the security access required to use it.