TipcMsgDeleteCurrent

TipcMsgDeleteCurrent — delete the current field from a message

T_BOOL TipcMsgDeleteCurrent(msg) 
T_IPC_MSG msg;

msg — message to delete field from

TRUE if the update was successful, FALSE otherwise.

If TipcMsgDeleteCurrent fails, it returns FALSE and sets the global SmartSockets error numbers to one of the following:

T_ERR_NULL_PTR — msg was null

T_ERR_READ_ONLY — the message was marked read-only. This happens if the message is a field in another message.

T_ERR_MSG_INVALID — msg was not a valid message

TipcMsgDeleteCurrent deletes the current field from the message, whether the field is named or unnamed. If no such field exists, it returns FALSE.

This code example deletes the current field from the message:

if (!TipcMsgDeleteCurrent(msg)) { 
 return;  /* error */ 
}