CreateEvent

CreateEvent

VB声明

Declare Function CreateEvent Lib "kernel32" Alias "CreateEventA" (lpEventAttributes As SECURITY_ATTRIBUTES, ByVal bManualReset As Long, ByVal bInitialState As Long, ByVal lpName As String) As Long

说明

创建一个事件对象

返回值

Long，如执行成功，返回事件对象句柄；零表示出错。会设置GetLastError。即使返回一个有效的句柄，但同时指出指定的名字已经存在，GetLastError也会设为ERROR_ALREADY_EXISTS

参数表

参数

类型及说明

lpEventAttributes

SECURITY_ATTRIBUTES，指定一个结构，用于设置对象的安全特性。如变成ByVal As Long，并传递零值，则表明使用对象默认的安全设置

bManualReset

Long，如果为TRUE，表示创建一个人工重设事件；如果为FALSE，表示创建一个自动重设事件

bInitialState

Long，如事件应内部进入触发状态，则为TRUE

lpName

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

注解

一旦不再需要，注意一定要用CloseHandle关闭事件句柄。如对象的所有句柄都已关闭，对象也会自动删除

Top