MutexAcl.Create(Boolean, String, Boolean, MutexSecurity) 方法

定義

命名空間:

System.Threading

組件:

System.Threading.AccessControl.dll

取得或建立 Mutex 執行個體，允許在建立 Mutex 期間，選擇性地指定 MutexSecurity 以進行設定。

public:
 static System::Threading::Mutex ^ Create(bool initiallyOwned, System::String ^ name, [Runtime::InteropServices::Out] bool % createdNew, System::Security::AccessControl::MutexSecurity ^ mutexSecurity);

public static System.Threading.Mutex Create (bool initiallyOwned, string? name, out bool createdNew, System.Security.AccessControl.MutexSecurity? mutexSecurity);

static member Create : bool * string * bool * System.Security.AccessControl.MutexSecurity -> System.Threading.Mutex

Public Shared Function Create (initiallyOwned As Boolean, name As String, ByRef createdNew As Boolean, mutexSecurity As MutexSecurity) As Mutex

參數

initiallyOwned

Boolean

true 表示如果這個呼叫的結果建立了具名系統 Mutex，則將具名系統 Mutex 的初始擁有權授與呼叫執行緒，否則為 false。

name

String

如果同步物件要與其他處理序共用，則為名稱；否則為 null 或空字串。 名稱區分大小寫。 反斜杠字元 (\) 是保留的，只能用來指定命名空間。 如需命名空間的詳細資訊，請參閱一節。 視操作系統而定，可能會進一步限制名稱。 例如，在 Unix 型作業系統上，排除命名空間之後的名稱必須是有效的檔名。

createdNew

Boolean

當此方法傳回時，如果已建立本機 Mutex，則此引數一律會設定為 true (意即當 name 為 null 或 Empty 時)。 如果 name 具有非空白的有效值，則此引數會在建立系統 Mutex 時設定為 true；如果找到具有該名稱的現有系統 Mutex 時，則會設定為 false。 這個參數會以未初始化的狀態傳遞。

mutexSecurity

MutexSecurity

要套用的選擇性 Mutex 存取控制安全性。

傳回

Mutex

若物件已命名，則代表系統 Mutex；若物件未命名，則代表本機 Mutex。

例外狀況

ArgumentException

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

IOException

name 無效。 這可能基於數種原因，其中包括可能由作業系統設定的一些限制，例如未知前置詞或無效字元。 請注意，名稱和通用前置詞 「Global\」 和 「Local\」 會區分大小寫。

-或-

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

DirectoryNotFoundException

僅限 Windows：name 已指定未知命名空間。 請參閱物件名稱 \(英文\) 以取得詳細資訊。

PathTooLongException

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

WaitHandleCannotBeOpenedException

無法建立具有所提供 name 的同步物件。 不同類型的同步物件可能具有相同名稱。

備註

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

name如果 已提供 ，且要求的型別同步處理物件已存在於命名空間中，則會開啟現有的同步處理物件。 如果命名空間中已經存在不同類型的同步處理物件， WaitHandleCannotBeOpenedException 則會擲回 。 否則，會建立新的同步處理物件。

警告

根據預設，具名 mutex 不會限製為建立它的使用者。 其他使用者可以開啟並使用 mutex，包括輸入 mutex 而不要結束 Mutex 來干擾 mutex。 若要限制特定使用者的存取權，您可以在建立具名 mutex 時傳入 MutexSecurity 。 避免在沒有存取限制的情況下使用具名 Mutex，而系統可能有不受信任的使用者執行程序代碼。