TipcEventGetDispatcher

Name

TipcEventGetDispatcher — get the identifier of an event’s dispatcher

Synopsis

T_BOOL TipcEventGetDispatcher(event, dispatcher_return) 
T_IPC_EVENT event; 
T_IPC_DISPATCHER *dispatcher_return; 

Arguments

event — an event (connection, message, socket, timer, or user event)

dispatcher_return — returned dispatcher identifier

Return Values

TRUE if the dispatcher was successfully retrieved for the event, FALSE otherwise.

Diagnostics

If TipcEventGetDispatcher fails, it returns FALSE and sets the global SmartSockets error number to:

Description

TipcEventGetDispatcher returns the identifier of an event’s dispatcher.

Caution

None

See Also

TipcEventCreate

Examples

This example returns the identifier of an event’s dispatcher:

T_IPC_DISPATCHER dispatcher; 
 
if (!TipcEventGetDispatcher(event, &dispatcher)) { 
  return;  /* error */ 
}