TipcSrvConnGetXtSource

Name

TipcSrvConnGetXtSource — get source suitable for XtAppAddInput from the connection

Synopsis

T_BOOL TipcSrvConnGetXtSource(srv, source_return) 
T_IPC_SRV srv; 
T_INT4 *source_return; 

Arguments

srv — connection handle to RTserver

source_return — storage for source

Return Values

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

Diagnostics

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

Description

TipcSrvConnGetXtSource 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.

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

Caution

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

See Also

TipcConnGetXtSource, TipcSrvConnGetSocket

Examples

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

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