CreateWaitableTimer

概述

函式原型

HANDLE WINAPI CreateWaitableTimer(

LPSECURITY_ATTRIBUTES lpTimerAttributes,

BOOL bManualReset,

LPCTSTR lpTimerName);

語法格式聲明

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

Windows API函式功能說明

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

Windows API函式出口返回值

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

Windows API函式入口參數說明

說明

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

人工重置與自動重置的區別

使用人工重置，則計時結束後所有的等待執行緒均變為可調度執行緒；使用自動重置，則只有一個執行緒變為可調度執行緒。

注意事項

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