TipcMsgGetNameCurrent

Name

TipcMsgGetNameCurrent — get the name of the current field

Synopsis

T_BOOL TipcMsgGetNameCurrent(msg, name_return) 
T_IPC_MSG msg; 
T_STR *name_return; 

Arguments

msg — message to get field name from

name_return — name of the field

Return Values

TRUE if the get was successful, FALSE otherwise.

Diagnostics

None

Description

TipcMsgGetNameCurrent gets the name of the current field (the field that would be returned by a TipcMsgNext* function). If the current field does not have a name, this function fails.

Examples

This example gets the name of the current field:

T_BOOL status; 
T_STR name; 
 
status = TipcMsgGetNameCurrent(msg, &name); 
if (status == FALSE) { 
  return;  /* error */ 
}