HP-UX C SIP Stack Message Layer Reference Guide (February 2008)

Message Object Functions 37
Get and Set Functions
RvSipMsgGetBadSyntaxHeaders()
RvSipMsgGetBadSyntaxHeaders()
DESCRIPTION
Gets a header with a syntax error from the message. The message holds most
headers in a sequential list. To, From, CallId, Cseq, ContentLength and Content-
Type headers are held separately. This function scans all headers in the message
(the ones that are in the header list and the ones that are not) and retrieves only
headers with syntax errors.
This function treats all headers as if they were located in one virtual list. The
virtual list includes the headers that are in the header list and the headers that are
not. This function returns the handle to the requested header as a void pointer.
You should check the pHeaderType parameter and cast the return value to the
appropriate header handle.
SYNTAX
void* RvSipMsgGetBadSyntaxHeaders(
IN RvSipMsgHandle hSipMsg,
IN RvSipHeadersLocation location,
INOUT RvSipHeaderListElemHandle* hListElem,
OUT RvSipHeaderType* pHeaderType);
PARAMETERS
hSipMsg
The handle of the message.
location
The location on the list: next, previous, first or last.
hListElem
The handle to the current position in the list. Supply this value if you chose
“next” or “previous” in the location parameter. This is also an output parameter
and will be set with a link to the requested header in the list.