MutexAcl.TryOpenExisting(String, MutexRights, Mutex) Metoda

Definicja

Przestrzeń nazw:

System.Threading

Zestaw:

System.Threading.AccessControl.dll

Pakiet:

System.Threading.AccessControl v11.0.0-preview.4.26230.115

Źródło:

MutexAcl.cs

Próbuje otworzyć określony nazwany mutex, jeśli już istnieje, stosuje żądane prawa dostępu i zwraca wartość wskazującą, czy operacja zakończyła się pomyślnie.

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

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

static member TryOpenExisting : string * System.Security.AccessControl.MutexRights * Mutex -> bool

Public Shared Function TryOpenExisting (name As String, rights As MutexRights, ByRef result As Mutex) As Boolean

Parametry

name

String

Nazwa mutexu, który ma zostać otwarty. Jeśli jest on poprzedzony ciągiem "Global", odnosi się do mutexu obejmującego całą maszynę. Jeśli prefiks jest poprzedzony ciągiem "Local" lub nie ma prefiksu, odnosi się do mutexu w całej sesji. Zarówno prefiks, jak i nazwa są uwzględniane wielkość liter.

rights

MutexRights

Żądane prawa dostępu do zastosowania do zwróconego mutexu.

result

Mutex

Gdy ta metoda zwraca truewartość , zawiera obiekt reprezentujący nazwany mutex, jeśli wywołanie zakończyło się pomyślnie lub null w inny sposób. Ten parametr jest traktowany jako niezainicjowany.

Zwraca

Boolean

true jeśli nazwany mutex został pomyślnie otwarty; w przeciwnym razie, false.

Wyjątki

ArgumentNullException

name jest null

ArgumentException

name jest pustym ciągiem.

IOException

Wystąpił błąd Win32.

UnauthorizedAccessException

Nazwany mutex istnieje, ale użytkownik nie ma dostępu zabezpieczeń wymaganego do jego użycia.