複製鏈接
請複製以下鏈接發送給好友

CreateWaitableTimer

鎖定
CreateWaitableTimer是一個計算機系統函數
中文名
創建計時器對象
外文名
CreateWaitableTimer

CreateWaitableTimer函數原型

HANDLE WINAPI CreateWaitableTimer(LPSECURITY_ATTRIBUTES lpTimerAttributes,BOOL bManualReset,LPCTSTR lpTimerName);

CreateWaitableTimer語法格式聲明

Declare Function CreateWaitableTimer Lib "kernel32" Alias "CreateWaitableTimerA" (lpSemaphore -Attributes As SECURITY_ATTRIBUTES, ByVal bManualReset As Long, ByVal lpName As String) As Long.

CreateWaitableTimer功能説明

創建一個可等待的計時器對象。

CreateWaitableTimer出口返回值

Long,如執行成功,返回可等待計時器對象的句柄;零表示出錯。會設置GetLastError。即使返回一個有效的句柄,但倘若它指出同名的一個計時器對象已經存在,則GetLastError返回ERROR_ALREADY_EXISTS。

CreateWaitableTimer入口參數説明

CreateWaitableTimer説明

lpSemaphoreAttributes
SECURITY_ATTRIBUTES,指定一個結構,用於設置對象的安全特性。如將參數聲明為ByVal As Long,並傳遞零值,就可使用對象的默認安全設置。
bManualReset
Long,如果為TRUE,表示創建一個人工重置計時器;如果為FALSE,則創建一個自動重置計時器。
lpName
String,指定可等待計時器對象的名稱。用vbNullString可創建一個未命名的計時器對象。如果已經存在擁有這個名字的一個可等待計時器,就直接打開現成的可等待計時器。這個名字可能不與一個現有的互斥體、事件、信號機或文件映射的名稱相符。

CreateWaitableTimer區別

使用人工重置,則計時結束後所有的等待線程均變為可調度線程;使用自動重置,則只有一個線程變為可調度線程。

CreateWaitableTimer注意事項

當不再使用該對象時,應當使用CloseHandle關閉計時器對象的句柄。