Header and Value Deleting Functions

void sip_delete_start_line(sip_msg_t sip_msg);

The sip_delete_start_line() function deletes the start line from the SIP message that is indicated by the value of the sip_msg parameter. The start line can be either the request line or the response line.

int sip_delete_header(sip_header_t sip_header);

The sip_delete_header() function deletes the header that is indicated by the value of the sip_header parameter from its associated SIP message. The function marks that header as deleted. The stack destroys that header when the SIP message is destroyed.

int sip_delete_header_by_name(sip_msg_t sip_msg, char *header_name);

The sip_delete_header_by_name() function deletes the header that is specified by the value of the header_name parameter from the SIP message that is indicated by the value of the sip_msg parameter. The value of the header_name parameter can be either the long name or the compact name for the SIP header. This function marks the header as deleted. The stack destroys this header when it destroys the SIP message.

int sip_delete_value(sip_header_t header, sip_header_value_t value);

The sip_delete_value() function deletes the value that is specified by the sip_value parameter from the header that is specified by the sip_header parameter. The stack marks the value as deleted and destroys the value when it destroys the header.