libcURL.EasyHandle.Perform

#libcURL.EasyHandle.Perform

##Method Signature

 Function Perform(URL As String = "", Timeout As Integer = 0) As Boolean

##Parameters

Name	Type	Comment
URL	String	Optional. If specified, the RFC 3986 URI to operate on.
Timeout	Integer	Optional. If specified, the connection timeout in seconds.

##Return value Returns True if the operation succeeded. Check EasyHandle.LastError for the error number if this method returns False.

##Notes Calls curl_easy_perform. Pass an optional URL to automatically set the URL options, and/or an optional timeout period.

This method will block your application until it returns regardless of the thread context. REALbasic/Xojo threads are not pre-emptive and, for the purposes of libcURL, aren't considered threads at all. For non-blocking transfers use a MultiHandle stack.

If you specify a timeout period, libcURL will abort the attempt if no connection is established before time expires. If a connection is aborted due to the timeout elapsing EasyHandle.LastError will be libcURL.Errors.TIMEOUT (28). A timeout of zero means no timeout (wait forever) and is the default.

##See also

• EasyHandle.SetOption