Semaphore.TryOpenExisting Méthode

Définition

Espace de noms:

System.Threading

Assembly:

System.Threading.dll

Assembly:

System.dll

Assembly:

netstandard.dll

Ouvre un sémaphore nommé spécifié, s'il existe déjà, et retourne une valeur indiquant si l'opération a réussi.

Surcharges

TryOpenExisting(String, Semaphore)	Ouvre le sémaphore nommé spécifié, s'il existe déjà, et retourne une valeur indiquant si l'opération a réussi.
TryOpenExisting(String, SemaphoreRights, Semaphore)	Ouvre le sémaphore nommé spécifié, s'il existe déjà, avec l'accès de sécurité souhaité, puis retourne une valeur indiquant si l'opération a réussi.

TryOpenExisting(String, Semaphore)

Ouvre le sémaphore nommé spécifié, s'il existe déjà, et retourne une valeur indiquant si l'opération a réussi.

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);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static bool TryOpenExisting (string name, out System.Threading.Semaphore? result);

public static bool TryOpenExisting (string name, out System.Threading.Semaphore? result);

static member TryOpenExisting : string * Semaphore -> bool

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member TryOpenExisting : string * Semaphore -> bool

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

Paramètres

name

String

Nom de l’objet de synchronisation à partager avec d’autres processus. Le nom respecte la casse.

result

Semaphore

Quand cette méthode est retournée, contient un objet Semaphore qui représente le sémaphore nommé si l'appel a réussi, ou null si l'appel a échoué. Ce paramètre est traité comme étant non initialisé.

Retours

Boolean

true si le sémaphore nommé a été ouvert ; sinon, false. Il peut arriver que false soit retourné en raison d’un nom non valide.

Attributs

SupportedOSPlatformAttribute

Exceptions

ArgumentException

name est une chaîne vide.

• ou -

.NET Framework uniquement : name est plus long que MAX_PATH (260 caractères).

ArgumentNullException

name est null.

IOException

name n'est pas valide. Il peut y avoir diverses raisons à cela, notamment des restrictions placées par le système d’exploitation (par exemple, un préfixe inconnu ou des caractères non valides). Remarque : le nom et les préfixes communs « Global » et « Local » respectent la casse. Il peut arriver que la méthode retourne plutôt false en raison d’un nom non valide.

• ou -

Il y avait une autre erreur. La propriété HResult est susceptible de fournir plus d’informations.

PathTooLongException

name est trop long. Les restrictions de longueur peuvent dépendre du système d’exploitation ou de la configuration.

UnauthorizedAccessException

Le sémaphore nommé existe, mais l’utilisateur ne dispose pas de l’accès de sécurité nécessaire pour l’utiliser.

Remarques

Le name préfixe peut être associé Global\ ou Local\ spécifier un espace de noms. Lorsque l’espace Global de noms est spécifié, l’objet de synchronisation peut être partagé avec tous les processus sur le système. Lorsque l’espace Local de noms est spécifié, qui est également la valeur par défaut lorsqu’aucun espace de noms n’est spécifié, l’objet de synchronisation peut être partagé avec des processus dans la même session. Sur Windows, une session est une session de connexion et les services s’exécutent généralement dans une autre session non interactive. Sur les systèmes d’exploitation de type Unix, chaque interpréteur de commandes a sa propre session. Les objets de synchronisation local de session peuvent être appropriés pour synchroniser entre les processus avec une relation parent/enfant où ils s’exécutent tous dans la même session. Pour plus d’informations sur les noms d’objets de synchronisation sur Windows, consultez Noms d’objets.

Si un objet de synchronisation du type demandé existe dans l’espace de noms, l’objet de synchronisation existant est ouvert. Si un objet de synchronisation n’existe pas dans l’espace de noms, ou si un objet de synchronisation d’un autre type existe dans l’espace de noms, false est retourné.

Pour créer le sémaphore système lorsqu’il n’existe pas encore, utilisez l’un des Semaphore constructeurs qui ont un name paramètre.

Si vous ne savez pas si un sémaphore nommé existe, utilisez cette surcharge de méthode au lieu de la OpenExisting(String) surcharge de méthode, ce qui lève une exception si le sémaphore n’existe pas.

Cette surcharge de méthode équivaut à appeler la TryOpenExisting surcharge de méthode et à spécifier et à spécifier SemaphoreRights.Synchronize des SemaphoreRights.Modify droits, combinés à l’aide de l’opération OR au niveau du bit. La spécification de l’indicateur SemaphoreRights.Synchronize permet à un thread d’entrer le sémaphore et de spécifier l’indicateur SemaphoreRights.Modify permet à un thread d’appeler la Release méthode.

TryOpenExisting(String, SemaphoreRights, Semaphore)

Ouvre le sémaphore nommé spécifié, s'il existe déjà, avec l'accès de sécurité souhaité, puis retourne une valeur indiquant si l'opération a réussi.

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

Paramètres

name

String

Nom de l’objet de synchronisation à partager avec d’autres processus. Le nom respecte la casse.

rights

SemaphoreRights

Combinaison d'opérations de bits des valeurs d'énumération qui représentent l'accès de sécurité voulu.

result

Semaphore

Quand cette méthode est retournée, contient un objet Semaphore qui représente le sémaphore nommé si l'appel a réussi, ou null si l'appel a échoué. Ce paramètre est traité comme étant non initialisé.

Retours

Boolean

true si le sémaphore nommé a été ouvert ; sinon, false. Il peut arriver que false soit retourné en raison d’un nom non valide.

Exceptions

ArgumentException

name est une chaîne vide.

• ou -

.NET Framework uniquement : name est plus long que MAX_PATH (260 caractères).

ArgumentNullException

name est null.

IOException

name n'est pas valide. Il peut y avoir diverses raisons à cela, notamment des restrictions placées par le système d’exploitation (par exemple, un préfixe inconnu ou des caractères non valides). Remarque : le nom et les préfixes communs « Global » et « Local » respectent la casse. Il peut arriver que la méthode retourne plutôt false en raison d’un nom non valide.

• ou -

Il y avait une autre erreur. La propriété HResult est susceptible de fournir plus d’informations.

PathTooLongException

name est trop long. Les restrictions de longueur peuvent dépendre du système d’exploitation ou de la configuration.

UnauthorizedAccessException

Le sémaphore nommé existe, mais l’utilisateur ne dispose pas de l’accès de sécurité nécessaire pour l’utiliser.

Remarques

Le name préfixe peut être associé Global\ ou Local\ spécifier un espace de noms. Lorsque l’espace Global de noms est spécifié, l’objet de synchronisation peut être partagé avec tous les processus sur le système. Lorsque l’espace Local de noms est spécifié, qui est également la valeur par défaut lorsqu’aucun espace de noms n’est spécifié, l’objet de synchronisation peut être partagé avec des processus dans la même session. Sur Windows, une session est une session de connexion et les services s’exécutent généralement dans une autre session non interactive. Sur les systèmes d’exploitation de type Unix, chaque interpréteur de commandes a sa propre session. Les objets de synchronisation local de session peuvent être appropriés pour synchroniser entre les processus avec une relation parent/enfant où ils s’exécutent tous dans la même session. Pour plus d’informations sur les noms d’objets de synchronisation sur Windows, consultez Noms d’objets.

Si un objet de synchronisation du type demandé existe dans l’espace de noms, l’objet de synchronisation existant est ouvert. Si un objet de synchronisation n’existe pas dans l’espace de noms, ou si un objet de synchronisation d’un autre type existe dans l’espace de noms, false est retourné.

Pour créer le sémaphore système lorsqu’il n’existe pas encore, utilisez l’un des Semaphore constructeurs qui ont un name paramètre.

Si vous ne savez pas si un sémaphore nommé existe, utilisez cette surcharge de méthode au lieu de la OpenExisting(String, SemaphoreRights) surcharge de méthode, ce qui lève une exception si le sémaphore n’existe pas.

Le rights paramètre doit inclure l’indicateur SemaphoreRights.Synchronize pour autoriser les threads à entrer dans le sémaphore, et l’indicateur SemaphoreRights.Modify pour autoriser les threads à appeler la Release méthode.

Plusieurs appels à cette méthode qui utilisent la même valeur pour name ne retournent pas nécessairement le même Semaphore objet, même si les objets retournés représentent le même sémaphore système nommé.