SemaphoreAcl.TryOpenExisting(String, SemaphoreRights, Semaphore) Methode

Definition

Namespace:

System.Threading

Assembly:

System.Threading.AccessControl.dll

Versucht, einen angegebenen benannten Semaphor zu öffnen, wenn er bereits vorhanden ist, wendet die gewünschten Zugriffsrechte an, und gibt einen Wert zurück, der angibt, ob der Vorgang erfolgreich war.

public:
 static bool TryOpenExisting(System::String ^ name, System::Security::AccessControl::SemaphoreRights rights, [Runtime::InteropServices::Out] System::Threading::Semaphore ^ % result);

public static bool TryOpenExisting (string name, System.Security.AccessControl.SemaphoreRights rights, out System.Threading.Semaphore? result);

static member TryOpenExisting : string * System.Security.AccessControl.SemaphoreRights * Semaphore -> bool

Public Shared Function TryOpenExisting (name As String, rights As SemaphoreRights, ByRef result As Semaphore) As Boolean

Parameter

name

String

Der Name des zu öffnenden Semaphors. Wenn sie von "Global" präfixiert wird, bezieht es sich auf einen computerweiten Semaphor. Wenn es von "Local" präfixiert wird oder kein Präfix aufweist, bezieht es sich auf ein sitzungsweites Semaphor. Bei Präfix und Namen wird die Groß-/Kleinschreibung beachtet.

rights

SemaphoreRights

Die gewünschten Zugriffsrechte, die auf das zurückgegebene Semaphor angewendet werden sollen.

result

Semaphore

Wenn diese Methode zurückgegeben truewird, enthält ein Objekt, das den benannten Semaphor darstellt, wenn der Aufruf erfolgreich war oder null anderweitig. Dieser Parameter wird nicht initialisiert behandelt.

Gibt zurück

Boolean

true, wenn das benannte Semaphor erfolgreich geöffnet wurde; andernfalls false.

Ausnahmen

ArgumentNullException

name ist gleich null.

ArgumentException

name ist eine leere Zeichenfolge.

IOException

Win32-Fehler.

UnauthorizedAccessException

Der benannte Semaphor ist vorhanden, aber der Benutzer verfügt nicht über den Sicherheitszugriff, der für die Verwendung erforderlich ist.