Mutex.TryOpenExisting Metoda

Definice

Obor názvů:

System.Threading

Sestavení:

netstandard.dll, System.Threading.dll

Otevře zadaný pojmenovaný mutex, pokud již existuje, a vrátí hodnotu, která označuje, zda operace proběhla úspěšně.

Přetížení

Name	Description
TryOpenExisting(String, Mutex)	Otevře zadaný pojmenovaný mutex, pokud již existuje, a vrátí hodnotu, která označuje, zda operace proběhla úspěšně.
TryOpenExisting(String, NamedWaitHandleOptions, Mutex)	Otevře zadaný pojmenovaný mutex, pokud již existuje, a vrátí hodnotu, která označuje, zda operace proběhla úspěšně. Pokud jsou možnosti nastaveny pouze na aktuálního uživatele, ověří se u volajícího uživatele řízení přístupu objektu.

TryOpenExisting(String, Mutex)

Zdroj:

Mutex.cs

Otevře zadaný pojmenovaný mutex, pokud již existuje, a vrátí hodnotu, která označuje, zda operace proběhla úspěšně.

public:
 static bool TryOpenExisting(System::String ^ name, [Runtime::InteropServices::Out] System::Threading::Mutex ^ % result);

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

static member TryOpenExisting : string * Mutex -> bool

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

Parametry

name

String

Název synchronizačního objektu, který se má sdílet s jinými procesy. Název je citlivý na velikost písmen. Znak zpětného lomítka (\) je vyhrazen a lze ho použít pouze k určení oboru názvů. Další informace o oborech názvů najdete v části Poznámky. V závislosti na operačním systému můžou existovat další omezení názvu. Například v operačních systémech se systémem Unix musí být název po vyloučení oboru názvů platným názvem souboru.

result

Mutex

Když tato metoda vrátí, obsahuje Mutex objekt, který představuje pojmenovaný mutex, pokud volání bylo úspěšné nebo null pokud volání selhalo. Tento parametr se považuje za neinicializovaný.

Návraty

Boolean

truepokud byl pojmenovaný mutex úspěšně otevřen; v opačném případě . false V některých případech false může být vrácena neplatná jména.

Výjimky

ArgumentException

name je prázdný řetězec.

nebo

pouze .NET Framework: name je delší než MAX_PATH (260 znaků).

ArgumentNullException

name je null.

IOException

name je neplatný. Může to být z různých důvodů, včetně některých omezení, která může operační systém umístit, například neznámé předpony nebo neplatné znaky. Všimněte si, že název a běžné předpony "Global\" a "Local\" rozlišují malá a velká písmena. U některých neplatných názvů může metoda místo toho vrátit false .

nebo

Došlo k nějaké jiné chybě. Vlastnost HResult může poskytnout další informace.

PathTooLongException

name je příliš dlouhý. Omezení délky můžou záviset na operačním systému nebo konfiguraci.

UnauthorizedAccessException

Pojmenovaný mutex existuje, ale uživatel nemá přístup zabezpečení potřebný k jeho použití.

Poznámky

Může name mít předponu Global\ nebo Local\ zadat obor názvů. Global Po zadání oboru názvů může být synchronizační objekt sdílen se všemi procesy v systému. Local Pokud je zadán obor názvů, což je také výchozí, pokud není zadán žádný obor názvů, synchronizační objekt může být sdílen s procesy ve stejné relaci. Na Windows je relace relace přihlášení a služby se obvykle spouští v jiné neinteraktivní relaci. V operačních systémech Unix má každé prostředí vlastní relaci. Objekty místní synchronizace relace můžou být vhodné pro synchronizaci mezi procesy s vztahem nadřazenosti nebo podřízenosti, kde se všechny spouští ve stejné relaci. Další informace o názvech synchronizačních objektů v Windows najdete v tématu Názvové objektyobjektu.

Pokud v oboru názvů existuje objekt synchronizace požadovaného typu, otevře se existující objekt synchronizace. Pokud synchronizační objekt v oboru názvů neexistuje nebo existuje objekt synchronizace jiného typu v oboru názvů, false je vrácen.

Chcete-li vytvořit systémový mutex, pokud ještě neexistuje, použijte jeden z Mutex konstruktorů, které mají name parametr.

Pokud si nejste jisti, zda pojmenovaný mutex existuje, použijte tuto metodu přetížení namísto OpenExisting(String) přetížení metody, která vyvolá výjimku, pokud mutex neexistuje.

Více volání této metody, které používají stejnou hodnotu pro name nemusí nutně vrátit stejný Mutex objekt, i když vrácené objekty představují stejný pojmenovaný systémový mutex.

Toto přetížení metody je ekvivalentní volání TryOpenExisting(String, MutexRights, Mutex) přetížení metody a určení MutexRights.Synchronize a MutexRights.Modify práva v kombinaci pomocí bitové OPERACE OR. Určení příznaku MutexRights.Synchronize umožňuje vláknu čekat na mutex a zadáním MutexRights.Modify příznaku umožňuje vlákno volat metodu ReleaseMutex .

Tato metoda nevyžaduje vlastnictví mutexu.

TryOpenExisting(String, NamedWaitHandleOptions, Mutex)

Zdroj:

Mutex.cs

Otevře zadaný pojmenovaný mutex, pokud již existuje, a vrátí hodnotu, která označuje, zda operace proběhla úspěšně. Pokud jsou možnosti nastaveny pouze na aktuálního uživatele, ověří se u volajícího uživatele řízení přístupu objektu.

public:
 static bool TryOpenExisting(System::String ^ name, System::Threading::NamedWaitHandleOptions options, [Runtime::InteropServices::Out] System::Threading::Mutex ^ % result);

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

static member TryOpenExisting : string * System.Threading.NamedWaitHandleOptions * Mutex -> bool

Public Shared Function TryOpenExisting (name As String, options As NamedWaitHandleOptions, ByRef result As Mutex) As Boolean

Parametry

name

String

Název synchronizačního objektu, který se má sdílet s jinými procesy. Název je citlivý na velikost písmen.

options

NamedWaitHandleOptions

Možnosti oboru pojmenovaného systémového mutexu. Ve výchozím nastavení je přístup omezený pouze na aktuálního uživatele a aktuální relaci. Zadané možnosti můžou mít vliv na obor názvů pro název a přístup k podkladovému systémovému objektu mutex.

result

Mutex

Když tato metoda vrátí, obsahuje Mutex objekt, který představuje pojmenovaný mutex, pokud volání bylo úspěšné nebo null pokud volání selhalo. Tento parametr se považuje za neinicializovaný.

Návraty

Boolean

truepokud byl pojmenovaný mutex úspěšně otevřen; v opačném případě . false V některých případech false může být vrácena neplatná jména.

Výjimky

ArgumentException

name je prázdný řetězec.

ArgumentNullException

name je null.

IOException

name je neplatný. Může to být z různých důvodů, včetně některých omezení, která může operační systém umístit, například neznámé předpony nebo neplatné znaky. Všimněte si, že název a běžné předpony "Global\" a "Local\" rozlišují malá a velká písmena. U některých neplatných názvů může metoda místo toho vrátit false .

nebo

Došlo k nějaké jiné chybě. Vlastnost HResult může poskytnout další informace.

PathTooLongException

name je příliš dlouhý. Omezení délky můžou záviset na operačním systému nebo konfiguraci.

UnauthorizedAccessException

Pojmenovaný mutex existuje, ale uživatel nemá přístup zabezpečení potřebný k jeho použití.

Poznámky

Pokud v oboru názvů existuje objekt synchronizace požadovaného typu, otevře se existující objekt synchronizace. Pokud options však určuje přístup omezený na aktuálního uživatele a synchronizační objekt není kompatibilní s ním, false vrátí se. Pokud synchronizační objekt v oboru názvů neexistuje nebo existuje objekt synchronizace jiného typu v oboru názvů, false vrátí se také.

Chcete-li vytvořit systémový mutex, pokud ještě neexistuje, použijte jeden z Mutex konstruktorů, které mají name parametr.

Pokud si nejste jisti, zda pojmenovaný mutex existuje, použijte tuto metodu přetížení namísto OpenExisting(String) přetížení metody, která vyvolá výjimku, pokud mutex neexistuje.

Více volání této metody, které používají stejnou hodnotu pro name nemusí nutně vrátit stejný Mutex objekt, i když vrácené objekty představují stejný pojmenovaný systémový mutex.

Tato metoda nevyžaduje vlastnictví mutexu.