HP-UX Multimedia Streaming Protocols (MSP) Programmer's Guide

— value
Pointer to a location containing the value for the header field.
— size
Size (in bytes) of the location pointed to by the value argument.
Upon success, rtsp_append_msg_hdr returns RTSP_SUCCESS; upon failure, it
returns one of the following error values:
• RTSP_EINVAL
— The msg argument is NULL.
— The value contained in the location pointed to by the value argument is invalid.
— The value contained in the size argument is invalid.
• RTSP_EINVHDR
— The value contained in the hdr_type argument is not a valid enumerated RTSP
header type.
— The value contained in the hdr_type argument is not an appendable header
field.
— The header field specified by the hdr_type argument cannot be set in the RTSP
message.
• RTSP_ENOMEM
Dynamic memory allocation failure.
Message Body APIs
You can use the following APIs to set or retrieve the body of an RTSP message:
• rtsp_set_msg_body
To set the body of an RTSP message, use rtsp_set_msg_body. The declaration
of rtsp_set_msg_body is as follows:
#include <rtsp.h>
rtsp_error_t rtsp_set_msg_body(
rtsp_msg_t *msg,
uint8_t *body,
uint16_t content_len
);
You must pass the following arguments to rtsp_set_msg_body:
RTSP Library 49