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