TipcMsgGetReplyTo

Name

TipcMsgGetReplyTo — get the reply to destination property of a message

Synopsis

T_BOOL TipcMsgGetReplyTo(msg, reply_to_dest_return) 
T_IPC_MSG msg; 
T_STR *reply_to_dest_return; 

Arguments

msg — message to get reply to destination from

reply_to_dest_return — storage for message reply to destination

Return Values

TRUE if the reply to destination was successfully retrieved from the message, FALSE otherwise.

Diagnostics

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

Description

TipcMsgGetReplyTo gets the reply to destination property of a message. The reply to destination property is a string representing a subject where a reply to the message should be sent.

Caution

If TipcMsgGetReplyTo returns FALSE, it does not store a value in reply_to_dest_return.

Do not modify the value stored in reply_to_dest_return. It points directly into an internal data structure.

See Also

TipcMsgSetReplyTo

Examples

This example prints the reply to destination of a message:

T_STR reply_to_dest; 
if (!TipcMsgGetReplyTo(msg, &reply_to_dest)) { 
  return;  /* error */ 
} 
TutOut("msg had reply to %s\n", reply_to_dest ? reply_to_dest : 
"<NULL>");