AIDA_boSetEventID

The AIDA_boSetEventID function sets a new id in the given event.

bool AIDA_boSetEventID(
  AIDA_tstEvent *pstEvent,
  handle hStack,
  dword dwEventID
);

Parameters

pstEvent

Pointer to an event created with AIDA_pstCreateEvent or AIDA_pstCreateEventEx.

hStack

Specifies the AIDA stack where the given event shall be processed. This is a handle to an AIDA stack created by one of the AIDA stack manipulation functions. Note the the event must be sent through the stack to which the handle belongs which was used when setting the id.

dwEventID

New event id to be set. When the event id manager is active the new id must be retrieved using the event id manager functions.

Return Values

AIDA_boSetEventID returns True when the event is accepted for processing.

If the event, the stack handle or the event id is rejected the function returns False. The application can retrieve the error code using AIDA_iGetError.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Linux: Requires a kernel supporting ELF binaries.
  Header: Declared in bsk_aida.h, also requires portab.h.
  Import Library (Windows): Use BSK_AIDA.lib.

See Also

AIDA Overview, AIDA Functions, AIDA_pstCreateEvent, AIDA_pstCreateEventEx, AIDA_boDeleteEvent, AIDA_pstCloneEvent, AIDA_boSendEvent, AIDA_pstReceiveEvent, AIDA_boWaitEvent, AIDA_boSetEventTypes, AIDA_boGetEventTypes