Język

EventWaitHandleAcl.TryOpenExisting Metoda

Definicja

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.

Dotyczy