TipcSrvConnErrorCbLookup

Name

TipcSrvConnErrorCbLookup — look up an error callback in the connection

Synopsis

T_CB TipcSrvConnErrorCbLookup(srv, func, arg) 
T_IPC_SRV srv; 
T_IPC_CONN_ERROR_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 TipcSrvConnErrorCbLookup fails, it returns NULL and sets the global SmartSockets error number to one of:

Description

TipcSrvConnErrorCbLookup looks up an error callback with the desired function and argument in the connection to RTserver by calling TipcConnErrorCbLookup. These callbacks are called when there is an unrecoverable error on the connection to RTserver. See TipcConnErrorCbCreate for more information on error callbacks.

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

Caution

None

See Also

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

Examples

This example looks up an error callback in the connection to RTserver:

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