CreateWaitableTimerExW 函式 （synchapi.h）
建立或開啟可等候的定時器物件，並傳回物件的句柄。
語法
HANDLE CreateWaitableTimerExW(
[in, optional] LPSECURITY_ATTRIBUTES lpTimerAttributes,
[in, optional] LPCWSTR lpTimerName,
[in] DWORD dwFlags,
[in] DWORD dwDesiredAccess
);
參數
[in, optional] lpTimerAttributes
SECURITY_ATTRIBUTES 結構的指標。 如果此參數 NULL，則子進程無法繼承定時器句柄。
如果 lpTimerAttributesNULL，定時器物件會取得預設的安全性描述元，而且無法繼承句柄。 定時器的預設安全性描述元中的 ACL 來自建立者的主要或模擬令牌。
[in, optional] lpTimerName
定時器物件的名稱。 名稱限制為 MAX_PATH 個字元。 名稱比較區分大小寫。
如果 lpTimerNameNULL，則會建立沒有名稱的定時器物件。
如果 lpTimerName 符合現有事件、旗號、mutex、job 或檔案對應物件的名稱，則函式會失敗，GetLastError 傳回 ERROR_INVALID_HANDLE。 這是因為這些對象共用相同的命名空間。
名稱可以有 「Global」 或 「Local」 前置詞，以明確在全域或會話命名空間中建立物件。 名稱的其餘部分可以包含反斜杠字元 （\） 以外的任何字元。 如需詳細資訊，請參閱 Kernel Object Namespaces。 使用終端機服務會話實作快速使用者切換。 核心物件名稱必須遵循終端機服務概述的指導方針，應用程式才能支援多個使用者。
物件可以在私人命名空間中建立。 如需詳細資訊，請參閱 物件命名空間。
[in] dwFlags
此參數可以是 0 或下列值。
[in] dwDesiredAccess
定時器物件的存取遮罩。 如需訪問許可權清單，請參閱 Synchronization Object Security and Access Rights。
傳回值
如果函式成功，傳回值就是定時器物件的句柄。 如果具名定時器物件存在於函數呼叫之前，函式會傳回現有物件的句柄，GetLastError 會傳回 ERROR_ALREADY_EXISTS。
如果函式失敗，則傳回值 NULL。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。
言論
呼叫進程的任何線程都可以在呼叫其中一個 等候函式中指定定時器物件句柄。
多個進程可以有相同定時器物件的句柄，讓對象能夠進行進程間同步處理。
CreateProcess 函式所建立的進程，如果 createWaitableTimerEx 啟用繼承的lpTimerAttributes 參數，則可以繼承定時器物件的句柄。 - 進程可以在呼叫 DuplicateHandle 函式時指定定時器物件句柄。 產生的句柄可由另一個進程使用。
- 進程可以在呼叫 openWaitableTimer 或 CreateWaitableTimerEx 函式時指定定時器對象的名稱。
使用 CloseHandle 函式來關閉句柄。 系統會在進程終止時自動關閉句柄。 定時器對象在最後一個句柄關閉時會終結。
若要將定時器與視窗產生關聯，請使用 SetTimer 函式。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [傳統型應用程式 |UWP 應用程式] |
| 支援的最低伺服器 | Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
| 目標平臺 | 窗戶 |
| 標頭 | synchapi.h （包括 Windows.h） |
| 連結庫 | Kernel32.lib |
| DLL | Kernel32.dll |