Skip to content

libcURL.EasyHandle.Progess

Andrew Lambert edited this page Feb 2, 2016 · 20 revisions

#libcURL.EasyHandle.Progress

##Event Signature

 Event Function Progress(dlTotal As UInt64, dlnow As UInt64, ultotal As UInt64, ulnow As UInt64) As Boolean

##Parameters

Name Type Comment
dlTotal UInt64 The total number of bytes libcURL expects to download in this transfer.
dlNow UInt64 The number of bytes downloaded so far.
ulTotal UInt64 The total number of bytes libcURL expects to upload in this transfer.
ulNow UInt64 The number of bytes uploaded so far.

##Return value Return True to abort the transfer.

##Remarks This event handles either the CURLOPT_XFERINFOFUNCTION (libcURL 7.32.0 and newer) or the CURLOPT_PROGRESSFUNCTION callbacks. The selection will be made at runtime.

This event will be raised at a varying but frequent interval. If you don't need it then you should consider disabling progress callbacks. This can provide a modest performance boost:

 Dim e As New libcURL.EasyHandle
 If Not e.SetOption(libcURL.Opts.NOPROGRESS, True) Then Raise New libcURL.cURLException(e)

##See also

Clone this wiki locally