EventWaitHandleAcl.TryOpenExisting 方法

定義

命名空間:

System.Threading

組件:

System.Threading.AccessControl.dll

嘗試開啟指定的具名事件等候控制碼，如果已經存在，請套用所需的存取權限，並傳回值，指出作業是否成功。

public:
 static bool TryOpenExisting(System::String ^ name, System::Security::AccessControl::EventWaitHandleRights rights, [Runtime::InteropServices::Out] System::Threading::EventWaitHandle ^ % result);

public static bool TryOpenExisting (string name, System.Security.AccessControl.EventWaitHandleRights rights, out System.Threading.EventWaitHandle? result);

static member TryOpenExisting : string * System.Security.AccessControl.EventWaitHandleRights * EventWaitHandle -> bool

Public Shared Function TryOpenExisting (name As String, rights As EventWaitHandleRights, ByRef result As EventWaitHandle) As Boolean

參數

name

String

要開啟的事件等候控制碼名稱。 如果前置詞為 「Global」，則會參考整個電腦的事件等候控制碼。 如果前置詞為 「Local」，或沒有前置詞，則會參考整個會話的事件等候控制碼。 前置詞與名稱都會區分大小寫。

rights

EventWaitHandleRights

要套用至傳回事件等候控制碼所需的存取權限。

result

EventWaitHandle

當這個方法傳 true 回 時，會包含物件，表示呼叫成功時所命名事件等候控制碼，否則 null 為 。 這個參數會被視為未初始化。

傳回

Boolean

true 如果已成功開啟具名事件等候控制碼，則為 ;否則為 false 。

例外狀況

ArgumentNullException

name 是 null

ArgumentException

name 為空字串。

IOException

發生 Win32 錯誤。

UnauthorizedAccessException

具名事件等候控制碼存在，但使用者沒有使用它所需的安全性存取權。