curl / libcurl / API / curl_easy_getinfo / CURLINFO_PROTOCOL

CURLINFO_PROTOCOL explained

Name

CURLINFO_PROTOCOL - URL scheme used in transfer

Synopsis

 #include <curl/curl.h>   CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_PROTOCOL, long *p);

Description

This option is deprecated. We strongly recommend using CURLINFO_SCHEME instead, because this option cannot return all possible schemes. The scheme might also sometimes be referred to as the protocol.

Pass a pointer to a long to receive the scheme used in the last transfer. The returned value is set to one of these values:

 CURLPROTO_DICT, CURLPROTO_FILE, CURLPROTO_FTP, CURLPROTO_FTPS, CURLPROTO_GOPHER, CURLPROTO_HTTP, CURLPROTO_HTTPS, CURLPROTO_IMAP, CURLPROTO_IMAPS, CURLPROTO_LDAP, CURLPROTO_LDAPS, CURLPROTO_POP3, CURLPROTO_POP3S, CURLPROTO_RTMP, CURLPROTO_RTMPE, CURLPROTO_RTMPS, CURLPROTO_RTMPT, CURLPROTO_RTMPTE, CURLPROTO_RTMPTS, CURLPROTO_RTSP, CURLPROTO_SCP, CURLPROTO_SFTP, CURLPROTO_SMB, CURLPROTO_SMBS, CURLPROTO_SMTP, CURLPROTO_SMTPS, CURLPROTO_TELNET, CURLPROTO_TFTP, CURLPROTO_MQTT

Protocols

This functionality affects all supported protocols

Example

 int main(void) {   CURL *curl = curl_easy_init();   if(curl) {   CURLcode result;   curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");   result = curl_easy_perform(curl);   if(result == CURLE_OK) {   long scheme;   curl_easy_getinfo(curl, CURLINFO_PROTOCOL, &scheme);   }   curl_easy_cleanup(curl);   } }

Deprecated

Deprecated since 7.85.0.

Availability

Added in curl 7.52.0

Return value

curl_easy_getinfo returns a CURLcode indicating success or error.

CURLE_OK (0) means everything was OK, non-zero means an error occurred, see libcurl-errors.