TipcSrvConnDefaultCbLookup

Name

TipcSrvConnDefaultCbLookup — look up a default callback in the connection

Synopsis

T_CB TipcSrvConnDefaultCbLookup(srv, func, arg) 
T_IPC_SRV srv; 
T_IPC_CONN_DEFAULT_CB_FUNC func; 
T_CB_ARG arg; 

Arguments

srv — connection handle to RTserver

func — callback function

arg — user-defined argument

Return Values

New callback if successful, NULL otherwise.

Diagnostics

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

Description

TipcSrvConnDefaultCbLookup looks up a default callback with the desired connection, function, and argument in the connection to RTserver by calling TipcConnDefaultCbLookup. These callbacks are called by TipcSrvConnMsgProcess when there are no process callbacks for the type of message being processed. See TipcConnDefaultCbCreate for more information on default callbacks.

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

Caution

None

See Also

TipcSrvConnDefaultCbCreate; see the TIBCO SmartSockets Utilities for information on TutCbDestroy.

Examples

This looks up and destroys a default callback in the connection to RTserver:

T_CB cb; 
 
cb = TipcSrvConnDefaultCbLookup(srv, my_srv_default_cb, NULL); 
if (cb == NULL) { 
  return;  /* error */ 
}  
if (!TutCbDestroy(cb)) { 
  return;  /* error */ 
}