CreateEventEx

函数功能创建或打开一个事件内核对象,并返回该内核对象的句柄.

语法HANDLE WINAPI CreateEventEx(

__in_opt LPSECURITY_ATTRIBUTES lpEventAttributes,

__in_opt LPCTSTR lpName,

__in DWORD dwFlags,

__in DWORD dwDesiredAccess

);

参数lpEventAttributes[in, optional] :

一个指向SECURITY_ATTRIBUTES结构的指针,如果该参数设为NULL,那么事件内核对象的句柄不能被子进程继承.

lpName[in, optional] :

指向事件内核对象的名称字符串的指针,如果该参数设为NULL,那么这个对象被创建为一个匿名事件内核对象.

dwFlags[in] :

这个参数可被设为以下一个或多个值.

值

意义

CREATE_EVENT_INITIAL_SET 0x00000002

对象初始状态为已触发,否则为未触发.

CREATE_EVENT_MANUAL_RESET0x00000001

这个事件对象必须用ResetEvents函数手动重置,如果不设置这个标志,系统会在内核对象被释放后自动重置.

dwDesiredAccess[in] :

访问权限描述标记,详情见Synchronization Object Security and Access Rights[1]

返回值如果函数调用成功,返值是所创建或打开的事件内核对象的句柄.如果调用失败则返回NULL.

函数信息最低客户端系统要求

Windows Vista

最低服务端系统要求

Windows Server 2008

头文件

Winbase.h (include Windows.h)

库文件

Kernel32.lib

动态链接库

Kernel32.dll