1--- 2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. 3SPDX-License-Identifier: curl 4Title: CURLINFO_CONN_ID 5Section: 3 6Source: libcurl 7See-also: 8 - CURLINFO_XFER_ID (3) 9 - curl_easy_getinfo (3) 10 - curl_easy_setopt (3) 11Protocol: 12 - All 13--- 14 15# NAME 16 17CURLINFO_CONN_ID - get the ID of the last connection used by the handle 18 19# SYNOPSIS 20 21~~~c 22#include <curl/curl.h> 23 24CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_CONN_ID, 25 curl_off_t *conn_id); 26~~~ 27 28# DESCRIPTION 29 30Pass a pointer to a *curl_off_t* to receive the connection identifier last 31used by the handle. Stores -1 if there was no connection used. 32 33The connection id is unique among all connections using the same 34connection cache. This is implicitly the case for all connections in the 35same multi handle. 36 37# EXAMPLE 38 39~~~c 40int main(void) 41{ 42 CURL *curl = curl_easy_init(); 43 if(curl) { 44 CURLcode res; 45 46 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com"); 47 48 /* Perform the request */ 49 res = curl_easy_perform(curl); 50 51 if(!res) { 52 curl_off_t conn_id; 53 res = curl_easy_getinfo(curl, CURLINFO_CONN_ID, &conn_id); 54 if(!res) { 55 printf("Connection used: %" CURL_FORMAT_CURL_OFF_T "\n", conn_id); 56 } 57 } 58 } 59} 60~~~ 61 62# AVAILABILITY 63 64Added in 8.2.0 65 66# RETURN VALUE 67 68Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. 69