CURLSMultiMBS.AddCURL(curl as CURLSMBS, handler as CURLSTransferFinishedMBS = nil) as boolean

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	CURL	MBS CURL Plugin	15.0	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Add a standard CURL handle to the multi stack.

Lasterror is set.

We added handler parameter for v23.2 to make it easier to run things asynchronously.

Some examples using this method:

• /CURL/CURL iOS Test
• /CURL/MQTT
• /CURL/Multi Transfer
• /CURL/Multi Transfer automatic
• /CURL/Receive Email/CURLS email client
• /CURL/Send Email/MassEmailer
• /CURL/Send Email/Send Email in Background async
• /CURL/SFTP/CURLS sftp batch download
• /CURL/SFTP/CURLS sftp batch upload
• /MacExtras/Sparkle/UpdaterKit/Updater Example

CURLSMultiMBS.CURLs as CURLSMBS()

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	CURL	MBS CURL Plugin	15.0	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Queries list of current CURL instances.

CURLSMultiMBS.NetworkChanged(ClearConns as Boolean, ClearDNS as Boolean)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	CURL	MBS CURL Plugin	25.5	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Signal network changed.

Informs CURL about a network change, so it can discard connections or DNS cache entries.

This method can be caled at any time and repeatedly. Each call only affects the currently cached connections and DNS information. Any connection created or DNS information added afterwards is cached the usual way again.

The call affects only the connection and DNS cache of the multi handle itself and not the ones owned by SHARE handles.

ClearConns: No longer reuse any existing connection in the multi handle's connection cache. This closes all connections that are not in use. Ongoing transfers continue on the connections they operate on.

ClearDNS: Clear the multi handle's DNS cache.

CURLSMultiMBS.Perform

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	CURL	MBS CURL Plugin	15.0	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Checks for things to see.

When the app thinks there's data available for CURL it calls this function to read/write whatever there is right now. This returns as soon as the reads and writes are done. This function does not require that there actually is data available for reading or that data can be written, it can be called just in case.

Lasterror is set. This only provides errors etc regarding the whole multi stack. There might still have occurred problems on invidual transfers even when this returns OK.

Sets RunningTransfers property.

CURLSMultiMBS.RemoveAll

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	CURL	MBS CURL Plugin	23.4	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Removes all curl handles.

Same as looping over CURLs() array and calling RemoveCURL for each.
This effectively cancels all requests.

CURLSMultiMBS.RemoveCURL(CURL as CURLSMBS) as boolean

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	CURL	MBS CURL Plugin	15.0	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Removes a CURL handle from the multi stack again.

Lasterror is set.
Plugin calls this automatically when TransferFinished event was called.