EventWaitHandle.TryOpenExisting Methode

Definition

Öffnet ein bestimmtes benanntes Synchronisierungsereignis, wenn es bereits vorhanden ist, und gibt einen Wert zurück, der angibt, ob der Vorgang erfolgreich war.Opens a specified named synchronization event, if it already exists, and returns a value that indicates whether the operation succeeded.

Überlädt

TryOpenExisting(String, EventWaitHandle)

Öffnet das angegebene benannte Synchronisierungsereignis, wenn es bereits vorhanden ist, und gibt einen Wert zurück, der angibt, ob der Vorgang erfolgreich war.Opens the specified named synchronization event, if it already exists, and returns a value that indicates whether the operation succeeded.

TryOpenExisting(String, EventWaitHandleRights, EventWaitHandle)

Öffnet das angegebene benannte Synchronisierungsereignis, wenn es bereits mit dem gewünschten Sicherheitszugriff vorhanden ist, und gibt einen Wert zurück, der angibt, ob der Vorgang erfolgreich war.Opens the specified named synchronization event, if it already exists, with the desired security access, and returns a value that indicates whether the operation succeeded.

TryOpenExisting(String, EventWaitHandle)

Öffnet das angegebene benannte Synchronisierungsereignis, wenn es bereits vorhanden ist, und gibt einen Wert zurück, der angibt, ob der Vorgang erfolgreich war.Opens the specified named synchronization event, if it already exists, and returns a value that indicates whether the operation succeeded.

public:
 static bool TryOpenExisting(System::String ^ name, [Runtime::InteropServices::Out] System::Threading::EventWaitHandle ^ % result);
[System.Security.SecurityCritical]
public static bool TryOpenExisting (string name, out System.Threading.EventWaitHandle result);
static member TryOpenExisting : string * EventWaitHandle -> bool
Public Shared Function TryOpenExisting (name As String, ByRef result As EventWaitHandle) As Boolean

Parameter

name
String

Der Name des zu öffnenden Systemsynchronisierungsereignisses.The name of the system synchronization event to open.

result
EventWaitHandle

Enthält nach Rückgabe dieser Methode ein EventWaitHandle-Objekt, das das benannte Synchronisierungsereignis darstellt, wenn der Aufruf erfolgreich ausgeführt wurde, oder null, wenn beim Aufruf ein Fehler aufgetreten ist.When this method returns, contains a EventWaitHandle object that represents the named synchronization event if the call succeeded, or null if the call failed. Dieser Parameter wird nicht initialisiert behandelt.This parameter is treated as uninitialized.

Gibt zurück

true, wenn das benannte Synchronisierungsereignis erfolgreich geöffnet wurde; andernfalls false.true if the named synchronization event was opened successfully; otherwise, false.

Attribute

Ausnahmen

name ist eine leere Zeichenfolge.name is an empty string.

- oder --or- name ist länger als 260 Zeichen.name is longer than 260 characters.

name ist null.name is null.

Win32-Fehler.A Win32 error occurred.

Das benannte Ereignis ist vorhanden, aber der Benutzer verfügt nicht über den erforderlichen Sicherheitszugriff.The named event exists, but the user does not have the desired security access.

Hinweise

Wenn das benannte Synchronisierungs Ereignis nicht vorhanden ist, wird es von dieser Methode nicht erstellt.If the named synchronization event does not exist, this method does not create it. Um das System Ereignis zu erstellen, wenn es nicht bereits vorhanden ist, verwenden Sie einen der EventWaitHandle Konstruktoren mit einem name-Parameter.To create the system event when it does not already exist, use one of the EventWaitHandle constructors that has a name parameter.

Wenn Sie unsicher sind, ob ein benanntes Synchronisierungs Ereignis vorhanden ist, verwenden Sie diese Methoden Überladung anstelle der OpenExisting(String)-Methoden Überladung, die eine Ausnahme auslöst, wenn das Synchronisierungs Ereignis nicht vorhanden ist.If you are uncertain whether a named synchronization event exists, use this method overload instead of the OpenExisting(String) method overload, which throws an exception if the synchronization event does not exist.

Diese Methoden Überladung entspricht dem Aufrufen der TryOpenExisting(String, EventWaitHandleRights, EventWaitHandle)-Methoden Überladung und der Angabe von EventWaitHandleRights.Synchronize und EventWaitHandleRights.Modify rechten, kombiniert mithilfe des bitweisen OR-Vorgangs.This method overload is equivalent to calling the TryOpenExisting(String, EventWaitHandleRights, EventWaitHandle) method overload and specifying EventWaitHandleRights.Synchronize and EventWaitHandleRights.Modify rights, combined by using the bitwise OR operation. Das Angeben des EventWaitHandleRights.Synchronize Flags ermöglicht einem Thread, auf das benannte System Ereignis zu warten, und die Angabe des EventWaitHandleRights.Modify Flags ermöglicht einem Thread, die Set-und Reset Methoden aufzurufen.Specifying the EventWaitHandleRights.Synchronize flag allows a thread to wait on the named system event, and specifying the EventWaitHandleRights.Modify flag allows a thread to call the Set and Reset methods.

Mehrere Aufrufe dieser Methode, die denselben Wert für name verwenden, geben nicht notwendigerweise dasselbe EventWaitHandle Objekt zurück, auch wenn die zurückgegebenen Objekte dasselbe benannte System Ereignis darstellen.Multiple calls to this method that use the same value for name do not necessarily return the same EventWaitHandle object, even though the objects that are returned represent the same named system event.

Sicherheit

SecurityCriticalAttribute
Erfordert volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer.requires full trust for the immediate caller. Dieser Member kann nicht von teilweise vertrauenswürdigem oder transparentem Code verwendet werden.This member cannot be used by partially trusted or transparent code.

TryOpenExisting(String, EventWaitHandleRights, EventWaitHandle)

Öffnet das angegebene benannte Synchronisierungsereignis, wenn es bereits mit dem gewünschten Sicherheitszugriff vorhanden ist, und gibt einen Wert zurück, der angibt, ob der Vorgang erfolgreich war.Opens the specified named synchronization event, if it already exists, with the desired security access, and returns a value that indicates whether the operation succeeded.

public:
 static bool TryOpenExisting(System::String ^ name, System::Security::AccessControl::EventWaitHandleRights rights, [Runtime::InteropServices::Out] System::Threading::EventWaitHandle ^ % result);
[System.Security.SecurityCritical]
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

Parameter

name
String

Der Name des zu öffnenden Systemsynchronisierungsereignisses.The name of the system synchronization event to open.

rights
EventWaitHandleRights

Eine bitweise Kombination von Enumerationswerten, die die gewünschten Sicherheitszugriffsrechte darstellen.A bitwise combination of the enumeration values that represent the desired security access.

result
EventWaitHandle

Enthält nach Rückgabe dieser Methode ein EventWaitHandle-Objekt, das das benannte Synchronisierungsereignis darstellt, wenn der Aufruf erfolgreich ausgeführt wurde, oder null, wenn beim Aufruf ein Fehler aufgetreten ist.When this method returns, contains a EventWaitHandle object that represents the named synchronization event if the call succeeded, or null if the call failed. Dieser Parameter wird nicht initialisiert behandelt.This parameter is treated as uninitialized.

Gibt zurück

true, wenn das benannte Synchronisierungsereignis erfolgreich geöffnet wurde; andernfalls false.true if the named synchronization event was opened successfully; otherwise, false.

Attribute

Ausnahmen

name ist eine leere Zeichenfolge.name is an empty string.

- oder --or- name ist länger als 260 Zeichen.name is longer than 260 characters.

name ist null.name is null.

Win32-Fehler.A Win32 error occurred.

Das benannte Ereignis ist vorhanden, aber der Benutzer verfügt nicht über den erforderlichen Sicherheitszugriff.The named event exists, but the user does not have the desired security access.

Hinweise

Wenn das benannte Synchronisierungs Ereignis nicht vorhanden ist, wird es von dieser Methode nicht erstellt.If the named synchronization event does not exist, this method does not create it. Um das System Ereignis zu erstellen, wenn es nicht bereits vorhanden ist, verwenden Sie einen der EventWaitHandle Konstruktoren mit einem name-Parameter.To create the system event when it does not already exist, use one of the EventWaitHandle constructors that has a name parameter.

Wenn Sie unsicher sind, ob ein benanntes Synchronisierungs Ereignis vorhanden ist, verwenden Sie diese Methoden Überladung anstelle der OpenExisting(String, EventWaitHandleRights)-Methoden Überladung, die eine Ausnahme auslöst, wenn das Synchronisierungs Ereignis nicht vorhanden ist.If you are uncertain whether a named synchronization event exists, use this method overload instead of the OpenExisting(String, EventWaitHandleRights) method overload, which throws an exception if the synchronization event does not exist.

Der rights-Parameter muss das EventWaitHandleRights.Synchronize-Flag enthalten, damit Threads auf das Ereignis warten können, und das EventWaitHandleRights.Modify-Flag, damit Threads die Set-und Reset Methoden aufrufen können.The rights parameter must include the EventWaitHandleRights.Synchronize flag to allow threads to wait on the event, and the EventWaitHandleRights.Modify flag to allow threads to call the Set and Reset methods.

Mehrere Aufrufe dieser Methode, die denselben Wert für name verwenden, geben nicht notwendigerweise dasselbe EventWaitHandle Objekt zurück, auch wenn die zurückgegebenen Objekte dasselbe benannte System Ereignis darstellen.Multiple calls to this method that use the same value for name do not necessarily return the same EventWaitHandle object, even though the objects that are returned represent the same named system event.

Sicherheit

SecurityCriticalAttribute
Erfordert volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer.requires full trust for the immediate caller. Dieser Member kann nicht von teilweise vertrauenswürdigem oder transparentem Code verwendet werden.This member cannot be used by partially trusted or transparent code.

Gilt für: