INtime SDK Help
RtOpenEvent (iwin32x)
INtime SDK v6 > About INtime > Alternate APIs > iwin32 API > iwin32x API > RtOpenEvent (iwin32x)

Searches for an existing event with the given name and returns its handle.

HANDLE RtOpenEvent(
    DWORD dwDesiredAccess,
    BOOLEAN bInheritHandle,
    LPCTSTR lpName
);

Parameters

dwDesiredAccess
Ignored.
bInheritHandle
Ignored.
lpName
Pointer to a null-terminated string that names the event to open. Name comparisons are case-sensitive.

Remarks

RtOpenEvent can also be used within the real-time portion of your application to obtain the handle of an iwin32 event.

RtOpenEvent enables multiple processes to open handles of the same event object. The function succeeds only if some process has already created the event using RtCreateEvent. The calling process can use the returned handle in any function that requires a handle to an event object.

To close the handle, use RtCloseHandle. When the process terminates, the system automatically closes the handle. When the last handle closes, the event object is destroyed.

Return Values

A handle to the event object
Success.
NULL
Failure. For extended error information, see the Windows' GetLastError function.

Requirements

Versions Defined in Include Link to
INtime 3.0 intime/nt/include/iwin32x.h iwin32x.h iwin32x.lib

Notes

See Also

RtCloseHandle, RtCreateEvent, iwin32x API, iwin32 Overview