TipcMtGetNum

Name

TipcMtGetNum — get the number of a message type

Synopsis

T_BOOL TipcMtGetNum(mt, num_return) 
T_IPC_MT mt; 
T_INT4 *num_return; 

Arguments

mt — message type to get number from

num_return — storage for message type number

Return Values

TRUE if the number was successfully retrieved from the message type, FALSE otherwise.

Diagnostics

If TipcMtGetNum fails, it returns FALSE and sets the global SmartSockets error number to:

Description

TipcMtGetNum gets the number of a message type. Message type numbers less than 1 are reserved for SmartSockets standard message types.

Caution

If TipcMtGetNum returns FALSE, it does not store a value in num_return.

See Also

TipcMtCreate, TipcMtGetGrammar, TipcMtGetName

Examples

This example prints the number of the NUMERIC_DATA message type:

T_IPC_MT mt; 
T_INT4 num; 
 
mt = TipcMtLookup("numeric_data"); 
if (mt == NULL) { 
  return;  /* error */ 
} 
 
if (!TipcMtGetNum(mt, &num)) { 
  return;  /* error */ 
}  
 
TutOut("NUMERIC_DATA msg type has num %d\n", num);