TipcSrvReadCbLookup

Name

TipcSrvReadCbLookup — look up a read callback in the connection to RTserver

Synopsis

T_CB TipcSrvReadCbLookup(mt, func, arg) 
T_IPC_MT mt; 
T_IPC_CONN_READ_CB_FUNC func; 
T_CB_ARG arg; 

Arguments

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

func — callback function

arg — user-defined argument

Return Values

Callback if successful, NULL otherwise.

Diagnostics

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

Description

TipcSrvReadCbLookup looks up a read callback with the desired message type, function, and argument in the connection to RTserver by calling TipcConnReadCbLookup. These callbacks are called when a message is read from the connection to RTserver. See TipcConnReadCbCreate on connection read callbacks.

TipcSrvReadCbLookup may attempt to automatically create a connection to RTserver. If RTclient has a warm connection to RTserver, TipcSrvReadCbLookup looks up a read callback in the warm connection. See TipcSrvCreate on automatic creation of connections and warm connections to RTserver.

Caution

None

See Also

TipcConnReadCbCreate, TipcSrvReadCbCreate, TipcSrvReadCbLookup; see the TIBCO SmartSockets Utilities for information on TutCbDestroy.

Examples

This code looks up and destroys a global read callback in the connection to RTserver:

T_CB cb; 
 
cb = TipcSrvReadCbLookup(NULL, my_global_read_cb, NULL); 
if (cb == NULL) { 
  return;  /* error */ 
}  
if (!TutCbDestroy(cb)) { 
  return;  /* error */ 
}