SemaphoreAcl.TryOpenExisting(String, SemaphoreRights, Semaphore) 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 semafor o nazwie, jeśli już istnieje, stosuje odpowiednie 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::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
Parametry
- name
- String
Nazwa semafora, który ma zostać otwarty. Jeśli jest poprzedzona ciągiem "Global", odnosi się do semafora całego komputera. Jeśli jest on poprzedzony prefiksem "Local" lub nie ma prefiksu, odwołuje się do semaphoru całej sesji. Zarówno prefiks, jak i nazwa są uwzględniane wielkość liter.
- rights
- SemaphoreRights
Żądane prawa dostępu do zastosowania do zwróconego semafora.
- result
- Semaphore
Gdy ta metoda zwraca true
wartość , zawiera obiekt reprezentujący nazwany semafor, 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 semafor został pomyślnie otwarty; w przeciwnym razie , false
.
Wyjątki
name
to null
name
jest pustym ciągiem.
Wystąpił błąd Win32.
Nazwany semafor istnieje, ale użytkownik nie ma dostępu zabezpieczeń wymaganego do jego użycia.