CURLSMBS.GetInfoActiveSocket as integer

If the socket is no longer valid, -1 is returned. When you finish working with the socket, the Destructor closes the socket and cleanup other resources associated with the handle. This is typically used in combination with OptionConnectOnly.

This option was added as a replacement for GetInfoLastSocket since that one isn't working on all platforms.

CURLSMBS.GetInfoAppConnectTime as Double

CURLSMBS.GetInfoCAInfo as string

CURLSMBS.GetInfoCAPath as string

CURLSMBS.GetInfoCertInfo as CURLSListMBS()

Var c as new CURLSMBS

// do some transfer
c.OptionURL = "https://www.mbsplugins.de/"
c.OptionCertInfo = true
Var e as Integer = c.perform

// query certificate info
Var lists() as CURLSListMBS = c.GetInfoCertInfo

for each l as CURLSListMBS in lists
  MsgBox Join(l, EndOfLine)
next

MsgBox c.DebugMessages

Please set OptionCertInfo first.

CURLSMBS.GetInfoConditionUnmet as Integer

CURLSMBS.GetInfoConnectTime as Double

The Lasterror property is set. 0 for success.

CURLSMBS.GetInfoContentLengthDownload as Double

The Lasterror property is set. 0 for success.
This is the value read from the Content-Length: field.

Some examples using this method:

• /CURL/CURLS simple download compressed

CURLSMBS.GetInfoContentLengthUpload as Double

The Lasterror property is set. 0 for success.

CURLSMBS.GetInfoContentType as string

The Lasterror property is set. 0 for success.
This is the value read from the Content-Type: field. If you get "", it means that the server didn't send a valid Content-Type header or that the protocol used doesn't support this.

Some examples using this method:

• /CURL/CURLS post form values/CURLS post form values
• /CURL/CURLS post form values/CURLS post form values old
• /CURL/CURLS post form/CURLS post form
• /CURL/WebServices/CURL post Twilio Verification

CURLSMBS.GetInfoCookieList as CURLSListMBS

The Lasterror property is set. 0 for success.
If there are no cookies (cookies for the handle have not been enabled or simply none have been received) the result is nil.

CURLSMBS.GetInfoEarlyDataSent as integer

TLS early data is only attempted when kSSLOptionEarlyData is set for the transfer. In addition, it is only used by libcurl when a TLS session exists that announces support.

The amount is negative when the sent data was rejected by the server. TLS allows a server that announces support for early data to reject any attempt to use it at its own discretion. When for example 127 bytes had been sent, but were rejected, it reports -127 as the amount "sent".

CURLSMBS.GetInfoEffectiveMethod as string

In cases when you've asked libcurl to follow redirects, the method may very well not be the same method the first request would use.

CURLSMBS.GetInfoEffectiveURL as string

The Lasterror property is set. 0 for success.

CURLSMBS.GetInfoFileTime as Integer

// init CURL with options
Var d as new CURLSMBS
d.OptionFileTime = true
d.OptionURL = "http://www.monkeybreadsoftware.de/images/mbs.jpg"

// run query
Var e as Integer = d.Perform

// calculate date object
Var da as new date(1970,1,1,0,0,0)
da.TotalSeconds = da.TotalSeconds + d.GetInfoFileTime

// show date
ResultText.text=str(d.GetInfoFileTime)+" "+da.ShortDate+" "+da.ShortTime

The Lasterror property is set. 0 for success.
If you get -1, it can be because of many reasons (unknown, the server hides it or the server doesn't support the command that tells document time etc) and the time of the document is unknown. Note that you must tell the server to collect this information before the transfer is made, by using the OptionFileTime option or you will unconditionally get a -1 back. (Added in 7.5)

CURLSMBS.GetInfoFTPEntryPath as string

That is the initial path libCURL ended up in when logging on to the remote FTP server.
Empty string if unknown.

CURLSMBS.GetInfoHeaderSize as Integer

The Lasterror property is set. 0 for success.

CURLSMBS.GetInfoHTTPAuthAvail as Integer

The Lasterror property is set. 0 for success.
The meaning of the bits is explained in the HTTPAuth option.

CURLSMBS.GetInfoHTTPConnectCode as Integer

The Lasterror property is set. 0 for success.

CURLSMBS.GetInfoHTTPVersion as integer

The returned value will be kHTTP_VERSION_1_0, kHTTP_VERSION_1_1, or kHTTP_VERSION_2_0, or 0 if the version can't be determined.

CURLSMBS.GetInfoLastSocket as Integer   Deprecated

If the socket is no longer valid, -1 is returned. When you finish working with the socket, the destructor will free the handle as usual and let libCURL close the socket and cleanup other resources associated with the handle. This is typically used in combination with OptionConnectOnly. (Added in 7.15.2)

NOTE: this API is not really working on win64, since the SOCKET type on win64 is 64 bit large while its 'long' is only 32 bits.

CURLSMBS.GetInfoLocalIP as string

Var c as new CURLSMBS

// do some transfer
c.OptionURL = "http://www.mbsplugins.de/"
Var e as Integer = c.perform

// now check local IP
MsgBox c.GetInfoLocalIP

CURLSMBS.GetInfoLocalPort as Integer

Var c as new CURLSMBS

// do some transfer
c.OptionURL = "http://www.mbsplugins.de/"
Var e as Integer = c.perform

// now check local IP and port
MsgBox c.GetInfoLocalIP+":"+str(c.GetInfoLocalPort)

CURLSMBS.GetInfoNameLookupTime as Double

The Lasterror property is set. 0 for success.

CURLSMBS.GetInfoNumConnects as Integer

The Lasterror property is set. 0 for success.
(only the successful connects are counted)
Combined with RedirectCount you are able to know how many times libCURL successfully reused existing connection(s) or not. See the Connection Options to see how libCURL tries to make persistent connections to save time.

CURLSMBS.GetInfoOSErrno as Integer

The Lasterror property is set. 0 for success.

CURLSMBS.GetInfoPreTransferTime as Double

The Lasterror property is set. 0 for success.
This includes all pre-transfer commands and negotiations that are specific to the particular protocol(s) involved.

CURLSMBS.GetInfoPrimaryIP as string

Var c as new CURLSMBS

// do some transfer
c.OptionURL = "http://www.mbsplugins.de/"
Var e as Integer = c.perform

// now check primary IP and port
MsgBox c.GetInfoPrimaryIP+":"+str(c.GetInfoPrimaryport)

CURLSMBS.GetInfoPrimaryPort as Integer

Var c as new CURLSMBS

// do some transfer
c.OptionURL = "http://www.mbsplugins.de/"
Var e as Integer = c.perform

// now check primary IP and port
MsgBox c.GetInfoPrimaryIP+":"+str(c.GetInfoPrimaryport)

CURLSMBS.GetInfoProtocol as integer   Deprecated

See kProtocol* constants.

CURLSMBS.GetInfoProxyAuthAvail as Integer

The Lasterror property is set. 0 for success.

CURLSMBS.GetInfoProxyError as integer

CURLSMBS.GetInfoProxySSLVerifyResult as integer

receive the result of the certificate verification that was requested (using the OptionProxySSLVerifyPeer option. This is only used for HTTPS proxies.

CURLSMBS.GetInfoRedirectCount as Integer

The Lasterror property is set. 0 for success.

CURLSMBS.GetInfoRedirectTime as Double

The Lasterror property is set. 0 for success.
RedirectTime contains the complete execution time for multiple redirections. (Added in 7.9.7)

CURLSMBS.GetInfoRedirectURL as string

CURLSMBS.GetInfoReferer as string

CURLSMBS.GetInfoRequestSize as Integer

The Lasterror property is set. 0 for success.
This is so far only for HTTP requests. Note that this may be more than one request if FOLLOWLOCATION is true.

CURLSMBS.GetInfoResponseCode as Integer

The Lasterror property is set. 0 for success.
This will be zero if no server response code has been received. Note that a proxy's CONNECT response should be read with GetInfoHTTPConnectCode and not this.

With HTTP transfer, a successful transfer reports 200 here. If the page is not found, you get 404. Or any other HTTP Response code.

Some examples using this method:

• /CURL/CURLS Amazon S3 download
• /CURL/CURLS Amazon S3 pre-signed URL
• /CURL/CURLS Amazon S3 upload
• /CURL/WebServices/TIN Check
• /MacExtras/Sparkle/UpdaterKit/Updater Example

CURLSMBS.GetInfoRetryAfter as integer

Receive the number of seconds the HTTP server suggesets the client should wait until the next request is issued.
The information from the "Retry-After:" header.

While the HTTP header might contain a fixed date string, the RetryAfter will always return number of seconds to wait - or zero if there was no header or the header couldn't be parsed.

CURLSMBS.GetInfoRTSPClientCSEQ as Integer

CURLSMBS.GetInfoRTSPCSEQRecv as Integer

CURLSMBS.GetInfoRTSPServerCSEQ as Integer

CURLSMBS.GetInfoRTSPSessionID as string

CURLSMBS.GetInfoScheme as string

CURLSMBS.GetInfoSizeDownload as Double

The Lasterror property is set. 0 for success.
The amount is only for the latest transfer and will be reset again for each new transfer.

Some examples using this method:

• /CURL/CURLS preemptive threaded download
• /CURL/CURLS simple download compressed

CURLSMBS.GetInfoSizeUpload as Double

The Lasterror property is set. 0 for success.

CURLSMBS.GetInfoSpeedDownload as Double

The Lasterror property is set. 0 for success.

CURLSMBS.GetInfoSpeedUpload as Double

The Lasterror property is set. 0 for success.