Semaphore.TryOpenExisting Método

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 -> bool

Public Shared Function TryOpenExisting (name As String, ByRef result As Semaphore) As Boolean

Parâmetros

Devoluções

true se o semáforo nomeado fosse aberto com sucesso; caso contrário, false. Em alguns casos, false pode ser devolvido por nomes inválidos.

Exceções

Observações

Podem name ser precedidos por Global\ ou Local\ para especificar um namespace. Quando o Global namespace é especificado, o objeto de sincronização pode ser partilhado com quaisquer processos no sistema. Quando o Local namespace é especificado, que é também o padrão quando não há namespace especificado, o objeto de sincronização pode ser partilhado com processos na mesma sessão. No Windows, uma sessão é uma sessão de login, e os serviços normalmente correm numa sessão diferente e não interativa. Em sistemas operativos do tipo Unix, cada shell tem a sua própria sessão. Os objetos de sincronização local da sessão podem ser apropriados para sincronizar entre processos com uma relação pai/filho, onde todos correm na mesma sessão. Para mais informações sobre nomes de objetos de sincronização no Windows, veja Object Names.

Se existir um objeto de sincronização do tipo solicitado no namespace, o objeto de sincronização existente é aberto. Se um objeto de sincronização não existir no namespace, ou se existir um objeto de sincronização de outro tipo no namespace, false é devolvido.

Para criar o semáforo do sistema quando este ainda não existe, use um dos Semaphore construtores que tenha um name parâmetro.

Se não tiver a certeza se existe um semáforo nomeado, use esta sobrecarga de métodos em vez da OpenExisting(String) sobrecarga de método, que cria uma exceção se o semáforo não existir.

Esta sobrecarga de métodos é equivalente a chamar o TryOpenExisting método overload e especificar SemaphoreRights.Synchronize e os direitos SemaphoreRights.Modify , combinados usando a operação OR bit a bit. Especificar o SemaphoreRights.Synchronize flag permite que um thread entre no semáforo, e especificar o SemaphoreRights.Modify flag permite que um thread chame o Release método.

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 -> bool

Public Shared Function TryOpenExisting (name As String, rights As SemaphoreRights, ByRef result As Semaphore) As Boolean

Parâmetros

Devoluções

true se o semáforo nomeado fosse aberto com sucesso; caso contrário, false. Em alguns casos, false pode ser devolvido por nomes inválidos.

Exceções

Observações

Podem name ser precedidos por Global\ ou Local\ para especificar um namespace. Quando o Global namespace é especificado, o objeto de sincronização pode ser partilhado com quaisquer processos no sistema. Quando o Local namespace é especificado, que é também o padrão quando não há namespace especificado, o objeto de sincronização pode ser partilhado com processos na mesma sessão. No Windows, uma sessão é uma sessão de login, e os serviços normalmente correm numa sessão diferente e não interativa. Em sistemas operativos do tipo Unix, cada shell tem a sua própria sessão. Os objetos de sincronização local da sessão podem ser apropriados para sincronizar entre processos com uma relação pai/filho, onde todos correm na mesma sessão. Para mais informações sobre nomes de objetos de sincronização no Windows, veja Object Names.

Se existir um objeto de sincronização do tipo solicitado no namespace, o objeto de sincronização existente é aberto. Se um objeto de sincronização não existir no namespace, ou se existir um objeto de sincronização de outro tipo no namespace, false é devolvido.

Para criar o semáforo do sistema quando este ainda não existe, use um dos Semaphore construtores que tenha um name parâmetro.

Se não tiver a certeza se existe um semáforo nomeado, use esta sobrecarga de métodos em vez da OpenExisting(String, SemaphoreRights) sobrecarga de método, que cria uma exceção se o semáforo não existir.

O rights parâmetro deve incluir a SemaphoreRights.Synchronize flag para permitir que as threads entrem no semáforo, e a SemaphoreRights.Modify flag para permitir que as threads chamem o Release método.

Múltiplas chamadas a este método que usam o mesmo valor para name não retornam necessariamente o mesmo Semaphore objeto, embora os objetos que são devolvidos representem o mesmo semáforo do sistema com o mesmo nome.