MutexAcl.TryOpenExisting(String, MutexRights, Mutex) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
嘗試開啟指定的具名 mutex,如果已存在,則會套用所需的存取權限,並傳回值,指出作業是否成功。
public:
static bool TryOpenExisting(System::String ^ name, System::Security::AccessControl::MutexRights rights, [Runtime::InteropServices::Out] System::Threading::Mutex ^ % result);
public static bool TryOpenExisting (string name, System.Security.AccessControl.MutexRights rights, out System.Threading.Mutex? result);
static member TryOpenExisting : string * System.Security.AccessControl.MutexRights * Mutex -> bool
Public Shared Function TryOpenExisting (name As String, rights As MutexRights, ByRef result As Mutex) As Boolean
參數
- name
- String
要開啟的 Mutex 名稱。 如果它前面加上 「Global」,則會參考全機器的 Mutex。 如果前置詞是 「Local」,或沒有前置詞,則會參考整個會話的 Mutex。 前置詞與名稱都會區分大小寫。
- rights
- MutexRights
要套用至傳回 Mutex 所需的存取權限。
- result
- Mutex
當這個方法傳 true
回 時,如果呼叫成功,則包含代表具名 mutex 的物件, null
否則為 。 這個參數會被視為未初始化。
傳回
如果已成功開啟具名 Mutex,則為true
,否則為 false
。
例外狀況
name
是 null
name
為空字串。
發生 Win32 錯誤。
具名的 Mutex 已存在,但使用者沒有使用它所需的安全性存取權。