EventWaitHandleAcl.TryOpenExisting 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 uchwyt oczekiwania zdarzeń, 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::EventWaitHandleRights rights, [Runtime::InteropServices::Out] System::Threading::EventWaitHandle ^ % result);
public static bool TryOpenExisting(string name, System.Security.AccessControl.EventWaitHandleRights rights, out System.Threading.EventWaitHandle? result);
public static bool TryOpenExisting(string name, System.Security.AccessControl.EventWaitHandleRights rights, out System.Threading.EventWaitHandle result);
static member TryOpenExisting : string * System.Security.AccessControl.EventWaitHandleRights * EventWaitHandle -> bool
Public Shared Function TryOpenExisting (name As String, rights As EventWaitHandleRights, ByRef result As EventWaitHandle) As Boolean
Parametry
- name
- String
Nazwa dojścia oczekiwania zdarzenia do otwarcia. Jeśli jest ona poprzedzona ciągiem "Global", odnosi się do dojścia oczekiwania zdarzeń dla całej maszyny. Jeśli jest on poprzedzony prefiksem "Local" lub nie ma prefiksu, odwołuje się do dojścia oczekiwania zdarzeń dla całej sesji. Zarówno prefiks, jak i nazwa są uwzględniane wielkość liter.
- rights
- EventWaitHandleRights
Żądane prawa dostępu do zastosowania do zwracanego dojścia oczekiwania zdarzeń.
- result
- EventWaitHandle
Gdy ta metoda zwraca truewartość , zawiera obiekt reprezentujący nazwany uchwyt oczekiwania zdarzenia, 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 uchwyt oczekiwania zdarzenia został pomyślnie otwarty; w przeciwnym razie, false.
Wyjątki
name jest null
name jest pustym ciągiem.
Wystąpił błąd Win32.
Istnieje nazwany uchwyt oczekiwania zdarzeń, ale użytkownik nie ma dostępu zabezpieczeń wymaganego do jego użycia.