INtime SDK Help
RtCreateEvent (iwin32x)
INtime SDK v7 > About INtime > Alternate APIs > iwin32 API > iwin32x API > RtCreateEvent (iwin32x)

Creates or opens an event.

HANDLE RtCreateEvent(

LPSECURITY_ATTRIBUTES lpEventAttributes,
BOOLEAN ManualReset,
BOOLEAN bInitialState
LPCTSTR lpName
);

Parameters

lpEventAttributes
Ignored; set to NULL.
ManualReset
Boolean event type:
TRUE
Use RtResetEvent to manually reset the event to the non-signaled state.
FALSE
The system automatically resets the event after a single waiting thread is released.
bInitialState
Specifies the initial event state:
TRUE
Signaled.
FALSE
Non-signaled.
lpName
Pointer to a null-terminated string that specifies the event object's name. The name is limited to MAX_PATH characters and can contain any character except the backslash path-separator character (\). Name comparison is case sensitive. Values include:
NULL
The event object is created without a name.
Matches an existing named event object
Ignores the ManualReset and bInitialState parameters because they were already set by the creation process.
Matches the name of an existing mutex, semaphore, or shared memory object
The function fails and the Windows' GetLastError function returns ERROR_INVALID_HANDLE. This occurs because these objects share the same name space.

Return Values

Handle of the event object
Success.
NULL
Failure.

Requirements

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

Notes

See Also

RtResetEvent, iwin32x API, iwin32 Overview