CURLNMBS.GetInfoConnectTime as Double

The Lasterror property is set. 0 for success.

CURLNMBS.GetInfoContentLengthDownload as Double

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

CURLNMBS.GetInfoContentLengthUpload as Double

The Lasterror property is set. 0 for success.

CURLNMBS.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.

CURLNMBS.GetInfoCookieList as CURLNListMBS

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.

CURLNMBS.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.

CURLNMBS.GetInfoEffectiveURL as string

The Lasterror property is set. 0 for success.

CURLNMBS.GetInfoFileTime as Integer

// init CURL with options
Var d as new CURLNMBS
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)

CURLNMBS.GetInfoFTPEntryPath as string

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

CURLNMBS.GetInfoHeaderSize as Integer

The Lasterror property is set. 0 for success.

CURLNMBS.GetInfoHTTPAuthAvail as Integer

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

CURLNMBS.GetInfoHTTPConnectCode as Integer

The Lasterror property is set. 0 for success.
none

CURLNMBS.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.

CURLNMBS.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.

CURLNMBS.GetInfoLocalIP as string

Var c as new CURLNMBS

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

// now check local IP
MsgBox c.GetInfoLocalIP

CURLNMBS.GetInfoLocalPort as Integer

Var c as new CURLNMBS

// 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)

CURLNMBS.GetInfoNameLookupTime as Double

The Lasterror property is set. 0 for success.

CURLNMBS.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.

CURLNMBS.GetInfoOSErrno as Integer

The Lasterror property is set. 0 for success.

CURLNMBS.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.

CURLNMBS.GetInfoPrimaryIP as string

Var c as new CURLNMBS

// 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)

CURLNMBS.GetInfoPrimaryPort as Integer

Var c as new CURLNMBS

// 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)

CURLNMBS.GetInfoProtocol as integer   Deprecated

See kProtocol* constants.

CURLNMBS.GetInfoProxyAuthAvail as Integer

The Lasterror property is set. 0 for success.

CURLNMBS.GetInfoProxyError as integer

CURLNMBS.GetInfoProxySSLVerifyResult as integer

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

CURLNMBS.GetInfoRedirectCount as Integer

The Lasterror property is set. 0 for success.

CURLNMBS.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)

CURLNMBS.GetInfoRedirectURL as string

CURLNMBS.GetInfoReferer as string

CURLNMBS.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.

CURLNMBS.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.

CURLNMBS.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.

CURLNMBS.GetInfoRTSPClientCSEQ as Integer

CURLNMBS.GetInfoRTSPCSEQRecv as Integer

CURLNMBS.GetInfoRTSPServerCSEQ as Integer

CURLNMBS.GetInfoRTSPSessionID as string

CURLNMBS.GetInfoScheme as string

CURLNMBS.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.

CURLNMBS.GetInfoSizeUpload as Double

The Lasterror property is set. 0 for success.

CURLNMBS.GetInfoSpeedDownload as Double

The Lasterror property is set. 0 for success.

CURLNMBS.GetInfoSpeedUpload as Double

The Lasterror property is set. 0 for success.

CURLNMBS.GetInfoSSLEngines as CURLNListMBS

The Lasterror property is set. 0 for success.
Note that engines are normally implemented in separate dynamic libraries. Hence not all the returned engines may be available at run-time.

CURLNMBS.GetInfoSSLVerifyResult as Integer

The Lasterror property is set. 0 for success.

CURLNMBS.GetInfoStartTransferTime as Double

The Lasterror property is set. 0 for success.
This includes the pretransfer time and also the time the server needs to calculate the result.

CURLNMBS.GetInfoTotalTime as Double

The Lasterror property is set. 0 for success.

CURLNMBS.OpenMTInputFile(file as folderitem, Offset as Integer = 0) as boolean

Var c As New CURLNMBS
Var file As FolderItem = SpecialFolder.Desktop.Child("test.rtf")

If c.OpenMTInputFile(file) Then
  // okay
Else
  MessageBox "Failed to open file to upload."
  Return
End If

// do a SFTP upload
c.OptionURL = "sftp://monkeybreadsoftware.de/folder/test.rtf"
c.OptionUpload = True
c.OptionUsername = "test"
c.OptionPassword = "test"
c.CollectOutputData = false

Var e As Integer = c.Perform

Var ErrorMessage As String = c.LasterrorMessage
Var ErrorLog As String = c.DebugMessages
Var ResultData As String = c.OutputData

Break

The read event is not called with PerformMT.
Offset is helpful for HTTP PUT requests with range, so you can start with an offset.
With 15.2 version of plugin, this also works with Perform.

Must be called before Perform or PerformMT, so we can stream data from the file.
The file is closed automatically when Perform methods finish their work.

The function returns false in case of an error, e.g. if file is already open by another application, the foleritem/path is invalid, the offset is negative or we can't determinate the file size.
It may be wise to have a fallback in your code to use a binarystream in that case (if that one can read the file) and then read all the data in a string and put into the InputData property.

See also:

• OpenMTInputFile(Path as String, Offset as Integer = 0) as boolean

CURLNMBS.OpenMTInputFile(Path as String, Offset as Integer = 0) as boolean

The read event is not called with PerformMT.
Offset is helpful for HTTP PUT requests with range, so you can start with an offset.

Must be called before Perform or PerformMT, so we can stream data from the file.
The file is closed automatically when Perform methods finish their work.

The function returns false in case of an error, e.g. if file is already open by another application, the foleritem/path is invalid, the offset is negative or we can't determinate the file size.
It may be wise to have a fallback in your code to use a binarystream in that case (if that one can read the file) and then read all the data in a string and put into the InputData property.

See also:

• OpenMTInputFile(file as folderitem, Offset as Integer = 0) as boolean