MutexAcl.TryOpenExisting(String, MutexRights, Mutex) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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 poprzedzona ciągiem "Global", odnosi się do mutexu całego komputera. Jeśli prefiks jest poprzedzony ciągiem "Local" lub nie ma prefiksu, odwołuje się do mutexu obejmującego całą sesję. 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 trueobiekt , 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
true jeśli nazwany mutex został pomyślnie otwarty; w przeciwnym razie , false.
Wyjątki
name to null
name jest pustym ciągiem.
Wystąpił błąd Win32.
Nazwany mutex istnieje, ale użytkownik nie ma wymaganego dostępu do zabezpieczeń, aby go używać.