Semaphore.TryOpenExisting Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Apre un semaforo denominato specificato, se già esistente, e restituisce un valore che indica se l'operazione ha avuto esito positivo.
Overload
| Nome | Descrizione |
|---|---|
| TryOpenExisting(String, Semaphore) |
Apre il semaforo denominato specificato, se già esistente, e restituisce un valore che indica se l'operazione ha avuto esito positivo. |
| TryOpenExisting(String, SemaphoreRights, Semaphore) |
Apre il semaforo denominato specificato, se già esistente, con l'accesso di sicurezza desiderato e restituisce un valore che indica se l'operazione è riuscita. |
TryOpenExisting(String, Semaphore)
Apre il semaforo denominato specificato, se già esistente, e restituisce un valore che indica se l'operazione ha avuto esito positivo.
public:
static bool TryOpenExisting(System::String ^ name, [Runtime::InteropServices::Out] System::Threading::Semaphore ^ % result);public static bool TryOpenExisting(string name, out System.Threading.Semaphore result);static member TryOpenExisting : string * Semaphore -> boolPublic Shared Function TryOpenExisting (name As String, ByRef result As Semaphore) As BooleanParametri
- name
- String
Nome dell'oggetto di sincronizzazione da condividere con altri processi. Il nome è sensibile alle maiuscole. Il carattere barra rovesciata (\) è riservato e può essere usato solo per specificare uno spazio dei nomi. Per altre informazioni sugli spazi dei nomi, vedere la sezione osservazioni. Potrebbero esserci ulteriori restrizioni sul nome a seconda del sistema operativo. Ad esempio, nei sistemi operativi basati su Unix, il nome dopo l'esclusione dello spazio dei nomi deve essere un nome di file valido.
- result
- Semaphore
Quando termina, questo metodo contiene un Semaphore oggetto che rappresenta il semaforo denominato se la chiamata ha avuto esito positivo o null se la chiamata non è riuscita. Questo parametro viene considerato non inizializzato.
Valori restituiti
true se il semaforo denominato è stato aperto correttamente; in caso contrario, false. In alcuni casi, false può essere restituito per nomi non validi.
Eccezioni
name è una stringa vuota.
oppure
solo .NET Framework: name è più lungo di MAX_PATH (260 caratteri).
name è null.
name non è valido. Questo può essere per vari motivi, incluse alcune restrizioni che potrebbero essere inserite dal sistema operativo, ad esempio un prefisso sconosciuto o caratteri non validi. Si noti che il nome e i prefissi comuni "Global\" e "Local\" fanno distinzione tra maiuscole e minuscole. Per alcuni nomi non validi, il metodo può invece restituire false .
oppure
Si è verificato un altro errore. La HResult proprietà potrebbe fornire altre informazioni.
name supera la lunghezza consentita. Le restrizioni relative alla lunghezza possono dipendere dal sistema operativo o dalla configurazione.
Il semaforo denominato esiste, ma l'utente non ha l'accesso di sicurezza necessario per usarlo.
Commenti
Può name essere preceduto Global\ da o Local\ per specificare uno spazio dei nomi. Quando si specifica lo Global spazio dei nomi, l'oggetto di sincronizzazione può essere condiviso con qualsiasi processo nel sistema. Quando si specifica lo Local spazio dei nomi , che è anche l'impostazione predefinita quando non viene specificato alcuno spazio dei nomi, l'oggetto di sincronizzazione può essere condiviso con i processi nella stessa sessione. In Windows una sessione è una sessione di accesso e i servizi vengono in genere eseguiti in una sessione non interattiva diversa. Nei sistemi operativi simili a Unix, ogni shell ha una propria sessione. Gli oggetti di sincronizzazione locale della sessione possono essere appropriati per la sincronizzazione tra processi con una relazione padre/figlio in cui vengono eseguiti tutti nella stessa sessione. Per altre informazioni sui nomi degli oggetti di sincronizzazione in Windows, vedere Nomina oggetto.
Se esiste un oggetto di sincronizzazione del tipo richiesto nello spazio dei nomi , viene aperto l'oggetto di sincronizzazione esistente. Se non esiste un oggetto di sincronizzazione nello spazio dei nomi o un oggetto di sincronizzazione di un tipo diverso nello spazio dei nomi, false viene restituito .
Per creare il semaforo di sistema quando non esiste già, usare uno dei Semaphore costruttori con un name parametro .
Se non si è certi se esiste un semaforo denominato, utilizzare questo overload del metodo anziché l'overload del OpenExisting(String) metodo, che genera un'eccezione se il semaforo non esiste.
Questo overload del metodo equivale a chiamare l'overload del TryOpenExisting metodo e specificare SemaphoreRights.Synchronize i diritti e SemaphoreRights.Modify , combinati usando l'operazione OR bit per bit. Se si specifica il SemaphoreRights.Synchronize flag, un thread può immettere il semaforo e specificare il SemaphoreRights.Modify flag consente a un thread di chiamare il Release metodo .
Si applica a
TryOpenExisting(String, SemaphoreRights, Semaphore)
Apre il semaforo denominato specificato, se già esistente, con l'accesso di sicurezza desiderato e restituisce un valore che indica se l'operazione è riuscita.
public:
static bool TryOpenExisting(System::String ^ name, System::Security::AccessControl::SemaphoreRights rights, [Runtime::InteropServices::Out] System::Threading::Semaphore ^ % result);public static bool TryOpenExisting(string name, System.Security.AccessControl.SemaphoreRights rights, out System.Threading.Semaphore result);static member TryOpenExisting : string * System.Security.AccessControl.SemaphoreRights * Semaphore -> boolPublic Shared Function TryOpenExisting (name As String, rights As SemaphoreRights, ByRef result As Semaphore) As BooleanParametri
- name
- String
Nome dell'oggetto di sincronizzazione da condividere con altri processi. Il nome è sensibile alle maiuscole. Il carattere barra rovesciata (\) è riservato e può essere usato solo per specificare uno spazio dei nomi. Per altre informazioni sugli spazi dei nomi, vedere la sezione osservazioni. Potrebbero esserci ulteriori restrizioni sul nome a seconda del sistema operativo. Ad esempio, nei sistemi operativi basati su Unix, il nome dopo l'esclusione dello spazio dei nomi deve essere un nome di file valido.
- rights
- SemaphoreRights
Combinazione bit per bit dei valori di enumerazione che rappresentano l'accesso alla sicurezza desiderato.
- result
- Semaphore
Quando termina, questo metodo contiene un Semaphore oggetto che rappresenta il semaforo denominato se la chiamata ha avuto esito positivo o null se la chiamata non è riuscita. Questo parametro viene considerato non inizializzato.
Valori restituiti
true se il semaforo denominato è stato aperto correttamente; in caso contrario, false. In alcuni casi, false può essere restituito per nomi non validi.
Eccezioni
name è una stringa vuota.
oppure
solo .NET Framework: name è più lungo di MAX_PATH (260 caratteri).
name è null.
name non è valido. Questo può essere per vari motivi, incluse alcune restrizioni che potrebbero essere inserite dal sistema operativo, ad esempio un prefisso sconosciuto o caratteri non validi. Si noti che il nome e i prefissi comuni "Global\" e "Local\" fanno distinzione tra maiuscole e minuscole. Per alcuni nomi non validi, il metodo può invece restituire false .
oppure
Si è verificato un altro errore. La HResult proprietà potrebbe fornire altre informazioni.
name supera la lunghezza consentita. Le restrizioni relative alla lunghezza possono dipendere dal sistema operativo o dalla configurazione.
Il semaforo denominato esiste, ma l'utente non ha l'accesso di sicurezza necessario per usarlo.
Commenti
Può name essere preceduto Global\ da o Local\ per specificare uno spazio dei nomi. Quando si specifica lo Global spazio dei nomi, l'oggetto di sincronizzazione può essere condiviso con qualsiasi processo nel sistema. Quando si specifica lo Local spazio dei nomi , che è anche l'impostazione predefinita quando non viene specificato alcuno spazio dei nomi, l'oggetto di sincronizzazione può essere condiviso con i processi nella stessa sessione. In Windows una sessione è una sessione di accesso e i servizi vengono in genere eseguiti in una sessione non interattiva diversa. Nei sistemi operativi simili a Unix, ogni shell ha una propria sessione. Gli oggetti di sincronizzazione locale della sessione possono essere appropriati per la sincronizzazione tra processi con una relazione padre/figlio in cui vengono eseguiti tutti nella stessa sessione. Per altre informazioni sui nomi degli oggetti di sincronizzazione in Windows, vedere Nomina oggetto.
Se esiste un oggetto di sincronizzazione del tipo richiesto nello spazio dei nomi , viene aperto l'oggetto di sincronizzazione esistente. Se non esiste un oggetto di sincronizzazione nello spazio dei nomi o un oggetto di sincronizzazione di un tipo diverso nello spazio dei nomi, false viene restituito .
Per creare il semaforo di sistema quando non esiste già, usare uno dei Semaphore costruttori con un name parametro .
Se non si è certi se esiste un semaforo denominato, utilizzare questo overload del metodo anziché l'overload del OpenExisting(String, SemaphoreRights) metodo, che genera un'eccezione se il semaforo non esiste.
Il rights parametro deve includere il SemaphoreRights.Synchronize flag per consentire ai thread di immettere il semaforo e il SemaphoreRights.Modify flag per consentire ai thread di chiamare il Release metodo .
Più chiamate a questo metodo che utilizzano lo stesso valore per name non restituiscono necessariamente lo stesso Semaphore oggetto, anche se gli oggetti restituiti rappresentano lo stesso semaforo di sistema denominato.