TipcSrvGetXtSource

Name

TipcSrvGetXtSource — get source suitable for XtAppAddInput from the connection to RTserver

Synopsis

T_BOOL TipcSrvGetXtSource(source_return) 
T_INT4 *source_return; 

Arguments

source_return — storage for source

Return Values

TRUE if source was successfully retrieved from the connection to RTserver, FALSE otherwise.

Diagnostics

If TipcSrvGetXtSource fails, it returns FALSE and sets the global SmartSockets error number to one of:

Description

TipcSrvGetXtSource gets an XtAppAddInput-compatible source from the connection to RTserver by calling TipcConnGetXtSource. This source allows SmartSockets IPC to be mixed with Motif or any other Xt-based widget set. See TipcConnGetXtSource for more information on Xt-compatible sources.

TipcSrvGetXtSource may attempt to automatically create a connection to RTserver. If RTclient has a warm connection to RTserver, TipcSrvGetXtSource does not use the warm connection, because the warm connection does not have a valid source. See TipcSrvCreate on automatic creation of connections and warm connections to RTserver.

Caution

If TipcSrvGetXtSource returns FALSE, it does not store a value in source_return.

See Also

TipcConnGetXtSource, TipcSrvGetSocket, TipcSrvSetSocket

Examples

This example creates a connection to RTserver, then gets and prints the Xt-compatible source of the connection:

T_INT4 source; 
 
if (!TipcSrvCreate(T_IPC_SRV_CONN_FULL)) { 
  return;  /* error */ 
}  
if (!TipcSrvGetXtSource(&source)) { 
  return;  /* error */ 
}  
TutOut("Source of connection to RTserver is <%d>.\n", source);