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.
CreateWaitableTimerWindows API函数功能说明
创建一个可等待的计时器对象。
CreateWaitableTimerWindows API函数出口返回值
Long，如执行成功，返回可等待计时器对象的句柄；零表示出错。会设置GetLastError。即使返回一个有效的句柄，但倘若它指出同名的一个计时器对象已经存在，则GetLastError返回ERROR_ALREADY_EXISTS。
CreateWaitableTimerWindows API函数入口参数说明
CreateWaitableTimer说明
lpSemaphoreAttributes | SECURITY_ATTRIBUTES，指定一个结构，用于设置对象的安全特性。如将参数声明为ByVal As Long，并传递零值，就可使用对象的默认安全设置。 |
bManualReset | Long，如果为TRUE，表示创建一个人工重置计时器；如果为FALSE，则创建一个自动重置计时器。 |
lpName | String，指定可等待计时器对象的名称。用vbNullString可创建一个未命名的计时器对象。如果已经存在拥有这个名字的一个可等待计时器，就直接打开现成的可等待计时器。这个名字可能不与一个现有的互斥体、事件、信号机或文件映射的名称相符。 |
CreateWaitableTimer人工重置与自动重置的区别
使用人工重置，则计时结束后所有的等待线程均变为可调度线程；使用自动重置，则只有一个线程变为可调度线程。
CreateWaitableTimer注意事项
当不再使用该对象时，应当使用CloseHandle关闭计时器对象的句柄。
