函数功能

语法

参数

返回值

函数信息

函数功能

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

语法

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

返回值

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

函数信息

最低客户端系统要求　Windows Vista

最低服务端系统要求　Windows Server 2008

头文件　Winbase.h (include Windows.h)

库文件　Kernel32.lib

动态链接库　Kernel32.dll