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

Message Object Functions 61
Get and Set Functions
RvSipMsgGetStrBadSyntaxStartLine()
RvSipMsgGetStrBadSyntaxStartLine()
DESCRIPTION
Copies the bad-syntax start line from the message into a given buffer. When a
message is received and the start line contains a syntax error, the start line is
kept as a separate bad-syntax string. This function retrieves this string. If the
bufferLen size adequate, this function copies the parameter into the strBuffer.
Otherwise, it returns RV_ERROR_INSUFFICIENT_BUFFER and the
actualLen parameter contains the required buffer length. Use this function in
RvSipTransportBadSyntaxStartLineMsgEv() event implementation to check
and fix the defected start-line.
Note If the start line is valid the function will return
RV_ERROR_NOT_FOUND and the actualLen parameter will be set to 0.
SYNTAX
RvStatus RvSipMsgGetStrBadSyntaxStartLine(
IN RvSipMsgHandle hSipMsg,
IN RvChar* strBuffer,
IN RvUint bufferLen,
OUT RvUint* actualLen);
PARAMETERS
hSipMsg
The handle of the message.
strBuffer
The buffer with which to fill the bad-syntax start line.
bufferLen
The length of the buffer.