RtkOpenEvent

RtkOpenEvent returns a handle to the named RTSS event.

Syntax

HANDLE RtOpenEvent(
    RTSSINST RtssInst,
    PULONG pErrorCode,
    DWORD DesiredAccess,
    BOOL bInheritHandle,
    PUNICODE_STRING lpName
);

Parameters

RtssInst

An RTSSINST value returned from a call to RtkRtssAttach.

pErrorCode

A pointer to a location where additional error information may be returned. This location need not be defined; the user may pass a NULL value. If defined, this location is set to NULL if no error occurred.

DesiredAccess

Ignored. The desired access to the event object.

bInheritHandle

Ignored. If this value is TRUE, processes created by this process will inherit the handle. Otherwise, the processes do not inherit this handle.

lpName

A pointer to a PUNICODE_STRING specifying the name of the event object. The name is limited to RTX_MAX_PATH characters and can contain any character except the backslash path-separator character (\). Name comparison is case-sensitive.

Return Values

A handle of the event object if the function succeeds, NULL if the function fails

Remarks

RtkOpenEvent enables multiple processes to open handles of the same event object. The function succeeds only if some process has already created the event with RtkCreateEvent. The calling process can use the returned handle in any function that requires a handle of a event object, such as a wait function.

Use RtkCloseHandle 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.

Requirements

Header	Rtkapi.h
Library	rtx_rtk.lib