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

Upon success, the rtsp_set_msg_hdr function returns RTSP_SUCCESS; upon
failure, rtsp_set_msg_hdr 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
◦ Value contained in the hdr_type argument is not a valid enumerated RTSP
header type.
◦ The header field specified by the hdr_type argument cannot be set in the
RTSP message pointed to by the msg argument.
— RTSP_ENOMEM
Dynamic memory allocation failure.
For more information, type man 3 rtsp_set_msg_hdr at the HP-UX command
prompt.
• rtsp_get_msg_hdr
You can use rtsp_get_msg_hdr to retrieve the header field from an RTSP
message.
The declaration of rtsp_get_msg_hdr is as follows:
#include <rtsp.h>
rtsp_error_t rtsp_set_msg_hdr(
rtsp_msg_t *msg,
rtsp_hdr_type_t hdr_type,
void *value,
int *size
);
You can use the same function to retrieve headers from both request and response
messages.
You must pass the following arguments to rtsp_get_msg_hdr:
— msg
Pointer to a location containing the rtsp_msg_t structure.
— hdr_type
Enumerated RTSP header field type.
46 Using MSP APIs