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 ihr das Präfix "Global" vorangestellt ist, bezieht es sich auf einen maschinenweiten Semaphor. Wenn ihr das Präfix "Local" vorangestellt ist oder kein Präfix vorhanden ist, bezieht es sich auf einen sitzungsweiten Semaphor. Bei Präfix und Namen wird die Groß-/Kleinschreibung beachtet.

rights

SemaphoreRights

Die gewünschten Zugriffsrechte, die für das zurückgegebene Semaphor gelten sollen.

result

Semaphore

Wenn diese Methode zurückgibt true, enthält ein -Objekt, das den benannten Semaphor darstellt, wenn der Aufruf erfolgreich war oder null andernfalls. 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 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.