CURLINFO_RTSP_SESSION_ID(3)

1CURLINFO_RTSP_SESSION_ID(3)curl_easy_getinfo optionsCURLINFO_RTSP_SESSION_ID(3)
2
3
4

NAME

6       CURLINFO_RTSP_SESSION_ID - get RTSP session ID
7

SYNOPSIS

9       #include <curl/curl.h>
10
11       CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_RTSP_SESSION_ID, char
12       **id);
13

DESCRIPTION

15       Pass a pointer to a char pointer to receive a pointer to a string hold‐
16       ing the most recent RTSP Session ID.
17
18       Applications  wishing  to  resume an RTSP session on another connection
19       should retrieve this info before closing the active connection.
20
21       The id pointer will be NULL or pointing to private memory you MUST  NOT
22       free  -  it gets freed when you call curl_easy_cleanup(3) on the corre‐
23       sponding CURL handle.
24

PROTOCOLS

26       RTSP
27

EXAMPLE

29       CURL *curl = curl_easy_init();
30       if(curl) {
31         CURLcode res;
32         curl_easy_setopt(curl, CURLOPT_URL, "rtsp://rtsp.example.com");
33         res = curl_easy_perform(curl);
34         if(res == CURLE_OK) {
35           char *id;
36           curl_easy_getinfo(curl, CURLINFO_RTSP_SESSION_ID, &id);
37         }
38         curl_easy_cleanup(curl);
39       }
40

AVAILABILITY

42       Added in 7.20.0
43

RETURN VALUE

45       Returns CURLE_OK if the option is supported,  and  CURLE_UNKNOWN_OPTION
46       if not.
47