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

— value
Pointer to a location where the value for the header field is returned.
— size
Pointer to a location containing the size (in bytes) of the location pointed to by
the value argument.
Upon success, rtsp_get_msg_hdr returns one of the following values:
— RTSP_SUCCESS
Successful completion. The location pointed to by the value argument stores
header information.
— RTSP_HDR_NOT_IN_MSG
The RTSP message does not contain the header indicated by the hdr_type
argument.
Upon failure, rtsp_get_msg_hdr returns one of the following values:
— RTSP_EINVAL
◦ The msg argument is NULL.
◦ The value argument is NULL.
◦ The size argument is required and is NULL.
◦ The value contained in the location pointed to by the value argument is not
NULL and the value in the location pointed to by the size argument is invalid.
— RTSP_EINVHDR
◦ The 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 retrieved
from the RTSP message.
— RTSP_ENOMEM
Dynamic memory allocation failure.
• rtsp_copy_msg_hdr
You can use rtsp_copy_msg_hdr to copy a header from one RTSP message to
another.
The declaration of rtsp_copy_msg_hdr is as follows:
#include <rtsp.h>
rtsp_error_t rtsp_copy_msg_hdr(
rtsp_msg_t *dst_msg,
rtsp_msg_t *src_msg,
rtsp_hdr_type_t hdr_type
);
RTSP Library 47