CreateWaitableTimer

CreateWaitableTimer

VB声明

Declare Function CreateWaitableTimer Lib "kernel32" Alias "CreateWaitableTimerA" (lpSemaphoreAttributes As SECURITY_ATTRIBUTES, ByVal bManualReset As Long, ByVal lpName As String) As Long

说明

创建一个可等待的计时器对象

返回值

Long,如执行成功,返回可等待计时器对象的句柄;零表示出错。会设置GetLastError。即使返回一个有效的句柄,但倘若它指出同名的一个计时器对象已经存在,那么GetLastError也会返回ERROR_ALREADY_EXISTS

参数表

参数

类型及说明

lpSemaphoreAttributes

SECURITY_ATTRIBUTES,指定一个结构,用于设置对象的安全特性。如将参数声明为ByVal As Long,并传递零值,就可使用对象的默认安全设置

bManualReset

Long,如果为TRUE,表示创建一个人工重设计时器;如果为FALSE,则创建一个自动重设计时器

lpName

String,指定可等待计时器对象的名称。用vbNullString可创建一个未命名的计时器对象。如果已经存在拥有这个名字的一个可等待计时器,就直接打开现成的可等待计时器。这个名字可能不与一个现有的互斥体、事件、信号机或文件映射的名称相符

注解

一旦不再需要,一定记住用CloseHandle关闭计时器对象的句柄。它的所有句柄都关闭以后,对象自己也会删除

Top