OpenEvent

函数功能

打开一个已经存在的命名事件对象

函数原型

HANDLE  OpenEvent(

DWORD dwDesiredAccess,

BOOL bInheritHandle,

LPCTSTR lpName

);

参数说明

dwDesiredAccess 【in】指定对事件对象的请求访问权限，如果安全描述符指定的对象不允许要求通过对调用该函数的过程，函数将返回失败。

该参数必须设置为以下值：

EVENT_ALL_ACCESS 指定事件对象所有可能的权限

bInheritHandle 【in】指定是否返回的句柄是否继承 。该参数必须设置为false

lpName 【in】指向一个以null结束的字符串，即将要打开的事件对象的名字。名称是区分大小写的。

返回值

函数执行成功则返回事件对象的句柄；失败则返回NULL，获取错误信息可以使用GetLastError.

参数表

参数表

参数

类型及说明

dwDesiredAccess

Long，下述常数之一：

EVENT_ALL_ACCESS

要求对事件对象进行完全访问

EVENT_MODIFY_STATE

允许SetEvent 和 ResetEvent函数

SYNCHRONIZE

允许事件对象的使用同步

bInheritHandle

Long，如希望子进程能够继承句柄，则为TRUE

lpName

String，指定要打开的对象的名字

注解

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