OpenEventA 函式 (synchapi.h)

開啟現有的具名事件物件。

語法

HANDLE OpenEventA(
  [in] DWORD  dwDesiredAccess,
  [in] BOOL   bInheritHandle,
  [in] LPCSTR lpName
);

[in] dwDesiredAccess

事件物件的存取權。如果指定對象的安全性描述元不允許呼叫進程的要求存取權，函式就會失敗。如需訪問許可權的清單，請參閱同步處理物件安全性和訪問許可權。

[in] bInheritHandle

如果此值為 TRUE，此進程所建立的進程將會繼承句柄。否則，進程不會繼承這個句柄。

[in] lpName

要開啟的事件名稱。名稱比較會區分大小寫。

此函式可以在私人命名空間中開啟物件。如需詳細資訊，請參閱物件命名空間。

終端機服務： 名稱可以有「Global」或「Local」前置詞，以在全域或會話命名空間中明確開啟物件。名稱的其餘部分可以包含任何字元，但反斜杠字元 (\) 除外。如需詳細資訊，請參閱核心物件命名空間。

注意使用終端機服務會話實作快速使用者切換。第一個登入的使用者會使用會話 0、下一個登入的使用者會使用會話 1 等等。核心物件名稱必須遵循終端機服務概述的指導方針，讓應用程式可以支援多個使用者。

如果函式成功，則傳回值是事件物件的句柄。

如果函式失敗，則傳回值為 NULL。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

OpenEvent 函式可讓多個進程開啟相同事件物件的句柄。只有在某些進程已經使用 CreateEvent 函式建立事件時，函式才會成功。呼叫進程可以在任何需要事件物件的句柄的函式中使用傳回的句柄，受限於 dwDesiredAccess 參數中指定的存取限制。

您可以使用 DuplicateHandle 函式來複製句柄。使用 CloseHandle 函式關閉句柄。系統會在進程終止時自動關閉句柄。當最後一個句柄已關閉時，就會終結事件物件。

注意

synchapi.h 標頭會將 OpenEvent 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

需求	值
最低支援的用戶端	Windows XP [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2003 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	synchapi.h (Windows Server 2003、Windows Vista、Windows 7、Windows Server 2008 Windows Server 2008 R2)
程式庫	Kernel32.lib
DLL	Kernel32.dll