TipcDispatcherCreate

Name

TipcDispatcherCreate — create a dispatcher

Synopsis

T_IPC_DISPATCHER TipcDispatcherCreate() 

Arguments

None

Return Values

A new dispatcher if successful, NULL otherwise.

Diagnostics

None

Description

TipcDispatcherCreate creates a new dispatcher to which events can be registered and from which messages can be received on RTclient/RTserver connections.

Caution

A dispatcher must continuously manage incoming messages and events by calling TipcDispatcherDispatch or TipcDispatcherMainLoop. A dispatcher created with TipcDispatcherCreate which does not do this can create a situation that leads to unpredictable behavior in your application.

You must use TipcDispatcherCreate if your SmartSockets application is a single thread, in which case you must ensure the calls to TipcDispatcherDispatch or TipcDispatcherMainLoop take place.

See Also

TipcDispatcherCreateDetached, TipcDispatcherDestroy

Examples

This example creates a dispatcher:

T_IPC_DISPATCHER dispatcher; 
 
dispatcher = TipcDisaptcherCreate();