TipcSrvConnProcessCbLookup

Name

TipcSrvConnProcessCbLookup — look up a process callback in the connection

Synopsis

T_CB TipcSrvConnProcessCbLookup(srv, mt, func, arg) 
T_IPC_SRV srv; 
T_IPC_MT mt; 
T_IPC_CONN_PROCESS_CB_FUNC func; 
T_CB_ARG arg; 

Arguments

srv — connection handle to RTserver

mt — message type to look up callback for (null means global callback)

func — callback function

arg — user-defined argument

Return Values

New callback if successful, NULL otherwise.

Diagnostics

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

Description

TipcSrvConnProcessCbLookup looks up the process callback with the desired message type, function, and argument in the connection to RTserver by calling TipcConnProcessCbLookup. These callbacks are called by TipcSrvConnMsgProcess to perform the normal processing of a message. See TipcConnProcessCbCreate for more information on connection process callbacks.

TipcSrvConnProcessCbLookup may attempt to automatically create a connection to RTserver. If RTclient has a warm connection to RTserver, TipcSrvConnProcessCbLookup looks up a process callback in the warm connection. See TipcSrvConnOpen for more information on automatic creation of connections and warm connections to RTserver.

See Also

TipcConnProcessCbLookup, TipcSrvConnProcessCbCreate; see the TIBCO SmartSockets Utilities for information on TutCbDestroy.

Examples

This example looks up a global process callback in the connection to RTserver:

T_CB cb; 
 
cb = TipcSrvConnProcessCbLookup(srv, NULL, 
my_global_srv_process_cb, 
                                NULL); 
if (cb == NULL) { 
  return;  /* error */ 
}