Platforms to show: All Mac Windows Linux Cross-Platform
Back to CURLNMBS class.
CURLNMBS.SetOptionConnectTo(list() as string)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | CURL | MBS CURL Plugin | 18.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
CURLNMBS.SetOptionEmptyPassword
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | CURL | MBS CURL Plugin | 15.3 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
Normally you have no password unless you set it.
But if you set a password with empty string, the plugin sets CURL to use no password.
This method is to use an empty password.
CURLNMBS.SetOptionHTTP200Aliases(list() as string)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | CURL | MBS CURL Plugin | 9.8 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
Some servers respond with a custom header response line. For example, IceCast servers respond with "ICY 200 OK". By including this string in your list of aliases, the response will be treated as a valid HTTP header line such as "HTTP/1.0 200 OK".
The alias itself is not parsed for any version strings. So if your alias is "MYHTTP/9.9", LibCURL will not treat the server as responding with HTTP version 9.9. Instead LibCURL will use the value set by option HTTPVersion.
The Lasterror property is set. 0 for success.
CURLNMBS.SetOptionHTTPHeader(list() as string)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | CURL | MBS CURL Plugin | 9.8 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
If you add a header that is otherwise generated and used by libCURL internally, your added one will be used instead. If you add a header with no contents as in 'Accept:' (no data on the right side of the colon), the internally used header will get disabled. Thus, using this option you can add new headers, replace internal headers and remove internal headers. To add a header with no contents, make the contents be two quotes: "". The headers included in the linked list must not be CRLF-terminated, because CURL adds CRLF after each header item. Failure to comply with this will result in strange bugs because the server will most likely ignore part of the headers you specified.
The first line in a request (containing the method, usually a GET or POST) is not a header and cannot be replaced using this option. Only the lines following the request-line are headers. Adding this method line in this list of headers will only cause your request to send an invalid header.
Pass an empty array to this to reset back to no custom headers.
The Lasterror property is set. 0 for success.
CURLNMBS.SetOptionMailRecipients(list() as string)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | CURL | MBS CURL Plugin | 11.0 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
CURLNMBS.SetOptionPostQuote(list() as string)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | CURL | MBS CURL Plugin | 9.8 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
Disable this operation again by using an empty array for this option.
The Lasterror property is set. 0 for success.
If you want to do a ftp operation instead of download/upload/directory listing, please use SetOptionQuote.
CURLNMBS.SetOptionPreQuote(list() as string)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | CURL | MBS CURL Plugin | 9.8 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
Disable this operation again by using an empty array for this option. Before version 7.15.6, if you also set Nobody to true, this option didn't work.
The Lasterror property is set. 0 for success.
CURLNMBS.SetOptionProxyHeader(list() as string)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | CURL | MBS CURL Plugin | 18.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
CURLNMBS.SetOptionQuote(list() as string)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | CURL | MBS CURL Plugin | 9.8 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
This will be done before any other FTP commands are issued (even before the CWD command).
Disable this operation again by using an empty array for this option.
The Lasterror property is set. 0 for success.
CURLNMBS.SetOptionResolve(list() as string)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | CURL | MBS CURL Plugin | 18.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
CURLNMBS.SetOptionTelnetOptions(list() as string)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | CURL | MBS CURL Plugin | 9.8 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
The variables should be in the format <option=value>. libCURL supports the options 'TTYPE', 'XDISPLOC' and 'NEW_ENV'. See the TELNET standard for details.
The Lasterror property is set. 0 for success.
CURLNMBS.SetPathCAInfo(path as folderitem)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | CURL | MBS CURL Plugin | 10.0 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
This makes sense only when used in combination with the OptionSSLVerifyPeer option. If OptionSSLVerifyPeer is false, OptionCAINFO need not even indicate an accessible file.
Note that option is by default set to the system path where libCURL's cacert bundle is assumed to be stored, as established at build time.
The Lasterror property is set. 0 for success.
You can set this value and later you can read it, but you cannot read the default value.
CURLNMBS.SetPathCAPath(path as folderitem)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | CURL | MBS CURL Plugin | 10.0 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
The certificate directory must be prepared using the openssl c_rehash utility. This makes sense only when used in combination with the CURLOPT_SSL_VERIFYPEER option. If OptionSSLVerifyPeer is zero, OptionCAPath need not even indicate an accessible path. The OptionCAPath function apparently does not work in Windows due to some limitation in openssl. This option is OpenSSL-specific and does nothing if libCURL is built to use GnuTLS.
The Lasterror property is set. 0 for success.
You can set this value and later you can read it, but you cannot read the default value.
CURLNMBS.SetPathCRLFile(path as folderitem)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | CURL | MBS CURL Plugin | 10.0 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
When CURL is built to use NSS or GnuTLS, there is no way to influence the use of CRL passed to help in the verification process. When libCURL is built with OpenSSL support, X509_V_FLAG_CRL_CHECK and X509_V_FLAG_CRL_CHECK_ALL are both set, requiring CRL check against all the elements of the certificate chain if a CRL file is passed.
This option makes sense only when used in combination with the OptionSSLVerifyPeer option.
A specific error code (CURLE_SSL_CRL_BADFILE) is defined with the option. It is returned when the SSL exchange fails because the CRL file cannot be loaded. Note that a failure in certificate verification due to a revocation information found in the CRL does not trigger this specific error. (Added in 7.19.0)
CURLNMBS.SetPathIssuerCert(path as folderitem)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | CURL | MBS CURL Plugin | 10.0 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
If the option is set, an additional check against the peer certificate is performed to verify the issuer is indeed the one associated with the certificate provided by the option. This additional check is useful in multi-level PKI where one needs to enforce that the peer certificate is from a specific branch of the tree.
This option makes sense only when used in combination with the OptionSSLVerifyPeer option. Otherwise, the result of the check is not considered as failure.
A specific error code (CURLE_SSL_ISSUER_ERROR) is defined with the option, which is returned if the setup of the SSL/TLS session has failed due to a mismatch with the issuer of peer certificate (OptionSSLVerifyPeer has to be set too for the check to fail). (Added in 7.19.0)
CURLNMBS.SetPathNetRCFile(path as folderitem)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | CURL | MBS CURL Plugin | 10.0 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
If this option is omitted, and OptionNETRC is set, libCURL will attempt to find the a .netrc file in the current user's home directory. (Added in 7.10.9)
The Lasterror property is set. 0 for success.
You can set this value and later you can read it, but you cannot read the default value.
CURLNMBS.SetPathProxyIssuerCert(path as folderitem)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | CURL | MBS CURL Plugin | 20.3 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
Pass a string naming a file holding a CA certificate in PEM format. If the option is set, an additional check against the peer certificate is performed to verify the issuer of the the HTTPS proxy is indeed the one associated with the certificate provided by the option. This additional check is useful in multi-level PKI where one needs to enforce that the peer certificate is from a specific branch of the tree.
This option makes sense only when used in combination with the OptionProxySSLVerifyPeer option. Otherwise, the result of the check is not considered as failure.
A specific error code (CURLE_SSL_ISSUER_ERROR) is defined with the option, which is returned if the setup of the SSL/TLS session has failed due to a mismatch with the issuer of peer certificate (OptionProxySSLVerifyPeer has to be set too for the check to fail).
CURLNMBS.SetupEmail(email as Variant) as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | CURL | MBS CURL Plugin | 14.3 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
You can set your own settings like proxy after this function call.
If you like you can reuse the email and CURL objects after you sent an email, change values and send another email.
Returns true on success or false on failure.
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | CURL | MBS CURL Plugin | 18.5 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
Perform any connection upkeep checks.
Some protocols have "connection upkeep" mechanisms. These mechanisms usually send some traffic on existing connections in order to keep them alive; this can prevent connections from being closed due to overzealous firewalls, for example.
Currently the only protocol with a connection upkeep mechanism is HTTP/2: when the connection upkeep interval is exceeded and Upkeep is called, an HTTP/2 PING frame is sent on the connection.
This function must be explicitly called in order to perform the upkeep work. The connection upkeep interval is set with OptionUpkeepIntervalMS.
CURLNMBS.WebSocketMeta as CURLNWebSocketFrameMBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | CURL | MBS CURL Plugin | 23.0 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
Only useful if called in Write event.
CURLNMBS.WebSocketReceive(BufferSize as Integer = 65536) as CURLNWebSocketFrameMBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | CURL | MBS CURL Plugin | 23.0 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
Retrieves as much as possible of a received WebSocket data fragment into the buffer, but not more than BufferSize bytes. The bytesReceived property in CURLNWebSocketFrameMBS is set to the number of bytes actually stored.
If there is more fragment data to deliver than what fits in the provided buffer, CURL returns a full buffer and the application needs to call this function again to continue draining the buffer.
The returned CURLNWebSocketFrameMBS contains the data and the metadata about the received data.
Lasterror property is set.
CURLNMBS.WebSocketSend(Data as MemoryBlock, FrameSize as Integer = 0, SendFlags as Integer = 0) as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | CURL | MBS CURL Plugin | 23.0 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
The buffer holds the data to send.
Returns the number of payload bytes actually sent.
To send a (huge) fragment using multiple calls with partial content per invoke, set the kFlagOffset bit and the FrameSize argument as the total expected size for the first part, then set the kFlagOffset with a zero FrameSize for the following parts.
If not sending a partial fragment or if this is raw mode, FrameSize should be set to zero.
If kWebSocketRaw is enabled in WebSocketOptions, the flags argument should be set to 0.
Lasterror property is set.
The items on this page are in the following plugins: MBS CURL Plugin.