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, EventWaitHandleRights, EventWaitHandle)

.NET Framework (current version)
 

Apre l'evento di sincronizzazione denominato specificato, se esistente, con l'accesso di sicurezza desiderato 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,
	EventWaitHandleRights rights,
	out EventWaitHandle result
)

Parametri

name
Type: System.String

Nome dell'evento di sincronizzazione del sistema da aprire.

rights
Type: System.Security.AccessControl.EventWaitHandleRights

Combinazione bit per bit dei valori di enumerazione che rappresentano l'accesso di sicurezza desiderato.

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,System.Security.AccessControl.EventWaitHandleRights) method overload, which throws an exception if the synchronization event does not exist.

The rights parameter must include the F:System.Security.AccessControl.EventWaitHandleRights.Synchronize flag to allow threads to wait on the event, and the F:System.Security.AccessControl.EventWaitHandleRights.Modify flag to allow threads 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.

.NET Framework
Disponibile da 4.5
Torna all'inizio
Mostra: