Semaphore.TryOpenExisting 方法

  • 參考

定義

命名空間:
System.Threading
組件:
System.Threading.dll
組件:
System.dll
組件:
netstandard.dll

開啟指定的具名號誌 (如果已經存在)，並傳回值，指出作業是否成功。

多載

TryOpenExisting(String, Semaphore)

開啟指定的具名號誌 (如果已經存在)，並傳回值，指出作業是否成功。
TryOpenExisting(String, SemaphoreRights, Semaphore)

使用所需的安全性存取權，開啟指定的具名號誌 (如果已經存在)，並傳回值，指出作業是否成功。

TryOpenExisting(String, Semaphore)

開啟指定的具名號誌 (如果已經存在)，並傳回值，指出作業是否成功。

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

參數

name
String

要與其他處理序共用之同步物件的名稱。 名稱區分大小寫。

result
Semaphore

這個方法傳回時，如果呼叫成功，則包含 Semaphore 物件，此物件代表具名信號，如果呼叫失敗，則為null。 這個參數會被視為未初始化。

傳回

Boolean

如果已成功開啟具名號誌，則為 true；否則為 false。 在某些情況下，可能會因為名稱無效而傳回 false。

屬性
SupportedOSPlatformAttribute

例外狀況

ArgumentException

name 為空字串。

-或-

僅限 .NET Framework：name 的長度超過 MAX_PATH (260 個字元)。

ArgumentNullException

name 上所宣告的預設值是 null。

IOException

name 無效。 這可能基於數種原因，其中包括可能由作業系統設定的一些限制，例如未知前置詞或無效字元。 請注意，名稱與通用前置詞 "Global" 與 "Local" 會區分大小寫。 針對某些無效的名稱，方法可能會改為傳回 false。

-或-

發生一些其他錯誤。 HResult 屬性可提供詳細資訊。

PathTooLongException

name 太長。 長度限制可能會取決於作業系統或設定。

UnauthorizedAccessException

具名的信號已存在，但使用者沒有使用它所需的安全性存取權。

備註

name前面可能會加上 Global\ 或 Local\ ，以指定命名空間。 Global指定命名空間時，同步處理物件可能會與系統上的任何進程共用。 Local指定命名空間時，這也是未指定命名空間時的預設值，同步處理物件可能會與相同會話中的進程共用。 在Windows上，會話是登入會話，而且服務通常會在不同的非互動式會話中執行。 在類似 Unix 的作業系統上，每個殼層都有自己的會話。 會話本機同步處理物件可能適用于在進程與父/子關聯性之間同步處理，其中它們全都在相同會話中執行。 如需同步處理Windows物件名稱的詳細資訊，請參閱物件名稱。

如果命名空間中存在要求的同步處理物件，則會開啟現有的同步處理物件。 如果命名空間中不存在同步處理物件，或命名空間中存在不同類型的同步處理物件， false 則會傳回 。

若要在系統旗號不存在時建立，請使用其中一個 name 具有 參數的 Semaphore 建構函式。

如果您不確定具名旗號是否存在，請使用這個方法多載，而不是 OpenExisting(String) 方法多載，這會在旗號不存在時擲回例外狀況。

這個方法多載相當於呼叫 TryOpenExisting 方法多載，並使用 SemaphoreRights.Synchronize 位 OR 運算來指定 和 SemaphoreRights.Modify 許可權。 指定 SemaphoreRights.Synchronize 旗標可讓執行緒進入旗號，並指定 SemaphoreRights.Modify 旗標可讓執行緒呼叫 Release 方法。

適用於

TryOpenExisting(String, SemaphoreRights, Semaphore)

使用所需的安全性存取權，開啟指定的具名號誌 (如果已經存在)，並傳回值，指出作業是否成功。

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

參數

name
String

要與其他處理序共用之同步物件的名稱。 名稱區分大小寫。

rights
SemaphoreRights

列舉值的位元組合，表示所需的安全性存取。

result
Semaphore

這個方法傳回時，如果呼叫成功，則包含 Semaphore 物件，此物件代表具名信號，如果呼叫失敗，則為 null 。 這個參數會被視為未初始化。

傳回

Boolean

如果已成功開啟具名號誌，則為 true；否則為 false。 在某些情況下，可能會因為名稱無效而傳回 false。

例外狀況

ArgumentException

name 為空字串。

-或-

僅限 .NET Framework：name 的長度超過 MAX_PATH (260 個字元)。

ArgumentNullException

name 上所宣告的預設值是 null。

IOException

name 無效。 這可能基於數種原因，其中包括可能由作業系統設定的一些限制，例如未知前置詞或無效字元。 請注意，名稱與通用前置詞 "Global" 與 "Local" 會區分大小寫。 針對某些無效的名稱，方法可能會改為傳回 false。

-或-

發生一些其他錯誤。 HResult 屬性可提供詳細資訊。

PathTooLongException

name 太長。 長度限制可能會取決於作業系統或設定。

UnauthorizedAccessException

具名的信號已存在，但使用者沒有使用它所需的安全性存取權。

備註

name前面可能會加上 Global\ 或 Local\ ，以指定命名空間。 Global指定命名空間時，同步處理物件可能會與系統上的任何進程共用。 Local指定命名空間時，這也是未指定命名空間時的預設值，同步處理物件可能會與相同會話中的進程共用。 在Windows上，會話是登入會話，而且服務通常會在不同的非互動式會話中執行。 在類似 Unix 的作業系統上，每個殼層都有自己的會話。 會話本機同步處理物件可能適用于在進程與父/子關聯性之間同步處理，其中它們全都在相同會話中執行。 如需同步處理Windows物件名稱的詳細資訊，請參閱物件名稱。

如果命名空間中存在要求的同步處理物件，則會開啟現有的同步處理物件。 如果命名空間中不存在同步處理物件，或命名空間中存在不同類型的同步處理物件， false 則會傳回 。

若要在系統旗號不存在時建立，請使用其中一個 name 具有 參數的 Semaphore 建構函式。

如果您不確定具名旗號是否存在，請使用這個方法多載，而不是 OpenExisting(String, SemaphoreRights) 方法多載，這會在旗號不存在時擲回例外狀況。

參數 rights 必須包含 SemaphoreRights.Synchronize 旗標，以允許執行緒輸入旗號，以及 SemaphoreRights.Modify 允許執行緒呼叫 方法的 Release 旗標。

對這個方法使用相同值的 name 多個呼叫不一定傳回相同的 Semaphore 物件，即使傳回的物件代表相同的具名系統旗號也一樣。

適用於