TipcConnReadCbLookup

Name

TipcConnReadCbLookup — look up a read callback in a connection

Synopsis

T_CB TipcConnReadCbLookup(conn, mt, func, arg) 
T_IPC_CONN conn; 
T_IPC_MT mt; 
T_IPC_CONN_READ_CB_FUNC func; 
T_CB_ARG arg; 

Arguments

conn — connection to look up callback for

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 TipcConnReadCbLookup fails, it returns NULL and sets the global SmartSockets error number to one of:

Description

TipcConnReadCbLookup looks up a connection read callback with the desired message type, function, and argument in a connection. These callbacks are called when a new message is received from the connection’s socket, which occurs in TipcConnRead. See TipcConnReadCbCreate for more information on connection read callbacks.

Caution

None

See Also

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

Examples

This example looks up a NUMERIC_DATA connection read callback and a global connection read callback:

mt = TipcMtLookupByNum(T_MT_NUMERIC_DATA); 
if (mt == NULL) { 
  return;  /* error */ 
}  
 
cb = TipcConnReadCbLookup(conn, mt, my_conn_read_cb, NULL); 
if (cb == NULL) { 
  return;  /* error */ 
}  
/* global connection read callback */ 
cb = TipcConnReadCbLookup(conn, NULL, my_global_read_cb, NULL); 
if (cb == NULL) { 
  return;  /* error */ 
}