TipcMtLookupByNum

Name

TipcMtLookupByNum — look up a message type by number

Synopsis

T_IPC_MT TipcMtLookupByNum(num) 
T_INT4 num; 

Arguments

num — number of message type

Return Values

Message type if successful, NULL otherwise.

Diagnostics

If TipcMtLookupByNum fails, it returns NULL and sets the global SmartSockets error number to:

Description

TipcMtLookupByNum looks up a message type with the desired number. The standard SmartSockets message types use C #define defines for numbers that are similar to the names. (For example, the message type with name "numeric_data" has a defined number T_MT_NUMERIC_DATA.)

Caution

None

See Also

TipcMtCreate, TipcMtDestroy, TipcMtLookup; see TIBCO SmartSockets Utilities for information on TutHashLookup.

Examples

This example looks up the ALERT message type by number:

T_IPC_MT mt; 
 
mt = TipcMtLookupByNum(T_MT_ALERT); 
if (mt == NULL) { 
  return;  /* error */ 
}