函数功能(函数原型 参数说明 返回值)

VB声明(参数表)

Remark

函数功能

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

函数原型

HANDLEOpenEvent(

DWORD dwDesiredAccess,

BOOL bInheritHandle,

LPCTSTR lpName

);

参数说明

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

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

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

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

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

返回值

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

VB声明

Declare Function OpenEvent Lib "kernel32" Alias "OpenEventA" (ByVal dwDesiredAccess As Long, ByVal bInheritHandle As Long, ByVal lpName As String) As Long

参数表

参数表

参数　类型及说明

dwDesiredAccess　Long，下述常数之一：

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

EVENT_MODIFY_STATE　允许SetEvent 和 ResetEvent函数

SYNCHRONIZE　允许事件对象的使用同步

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

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

注解

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

Remark

The OpenEvent function enables multiple processes to open handles of the same event object. The function succeeds only if some process has already created the event using the CreateEvent function. The calling process can use the returned handle in any function that requires a handle to an event object, subject to the limitations of the access specified in the dwDesiredAccess parameter.

Use the DuplicateHandle function to duplicate the handle. Use the CloseHandle function to close the handle. The system closes the handle automatically when the process terminates. The event object is destroyed when its last handle has been closed.