Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo EventWaitHandle.TryOpenExisting (String, EventWaitHandle)

.NET Framework (current version)
 

Apre l'evento di sincronizzazione denominato specificato, se esistente, e restituisce un valore che indica se l'operazione è riuscita.

Spazio dei nomi:   System.Threading
Assembly:  mscorlib (in mscorlib.dll)

[SecurityCriticalAttribute]
public static bool TryOpenExisting(
	string name,
	out EventWaitHandle result
)

Parametri

name
Type: System.String

Nome dell'evento di sincronizzazione del sistema da aprire.

result
Type: System.Threading.EventWaitHandle

Quando restituisce il controllo, questo metodo contiene un oggetto EventWaitHandle che rappresenta l'evento di sincronizzazione denominato se la chiamata è riuscita o null se la chiamata non è riuscita. Questo parametro viene trattato come non inizializzato.

Valore restituito

Type: System.Boolean

true se l'evento di sincronizzazione denominato è stato aperto correttamente; in caso contrario, false.

Exception Condition
ArgumentException

Il parametro name è una stringa vuota.

-oppure-

La lunghezza di name supera i 260 caratteri.

ArgumentNullException

name è null.

IOException

Errore Win32.

UnauthorizedAccessException

L'evento denominato esiste, ma l'utente non dispone dell'accesso di sicurezza desiderato.

If the named synchronization event does not exist, this method does not create it. To create the system event when it does not already exist, use one of the M:System.Threading.EventWaitHandle.#ctor(System.Boolean,System.Threading.EventResetMode,System.String,System.Boolean@,System.Security.AccessControl.EventWaitHandleSecurity) constructors that has a name parameter.

If you are uncertain whether a named synchronization event exists, use this method overload instead of the M:System.Threading.EventWaitHandle.OpenExisting(System.String) method overload, which throws an exception if the synchronization event does not exist.

This method overload is equivalent to calling the M:System.Threading.EventWaitHandle.TryOpenExisting(System.String,System.Security.AccessControl.EventWaitHandleRights,System.Threading.EventWaitHandle@) method overload and specifying F:System.Security.AccessControl.EventWaitHandleRights.Synchronize and F:System.Security.AccessControl.EventWaitHandleRights.Modify rights, combined by using the bitwise OR operation. Specifying the F:System.Security.AccessControl.EventWaitHandleRights.Synchronize flag allows a thread to wait on the named system event, and specifying the F:System.Security.AccessControl.EventWaitHandleRights.Modify flag allows a thread to call the M:System.Threading.EventWaitHandle.Set and M:System.Threading.EventWaitHandle.Reset methods.

Multiple calls to this method that use the same value for name do not necessarily return the same T:System.Threading.EventWaitHandle object, even though the objects that are returned represent the same named system event.

SecurityCriticalAttribute

requires full trust for the immediate caller. This member cannot be used by partially trusted or transparent code.

Universal Windows Platform
Disponibile da 8
.NET Framework
Disponibile da 4.5
Libreria di classi portabile
Supportato in: piattaforme .NET portabili
Windows Phone Silverlight
Disponibile da 8.0
Windows Phone
Disponibile da 8.1
Torna all'inizio
Mostra: