libcURL.cURLException

libcURL.cURLException

Class Declaration

 Protected Class cURLException
 Inherits RuntimeException

Remarks

This exception type will be raised if a required libcURL function call returns an error code. The ErrorNumber and Message properties will contain the error code and a message for that code, respectively. In addition to libcURL's error numbers, several additional error numbers might be encountered which originate from the wrapper. These are:

Name	Number	Comment
INIT_FAILED	-3	Unknown failure while constructing a libcURL handle. This error means that libcURL was unable to create the requested handle, and indicates a deep, dark problem.
FEATURE_UNAVAILABLE	-4	The requested feature is known not to be available in the installed version of libcURL. This has an identical meaning to curl error code CURLE_NOT_BUILT_IN(4). Using a separate code makes it possible to determine who is saying the feature is unavailable: the wrapper or libcURL itself. This error code is also used if the wrapper knows that a feature is only available in a newer version of libcURL, rather than more generic errors like CURLE_UNKNOWN_OPTION (48) that libcURL would emit.
NOT_INITIALIZED	-5	libcURL has not yet been initialized. This is the default value of the cURLHandle.LastError property, which is inherited by all subclasses. It gets overwritten by the Constructor, so encountering this error means something weird is going on (probably in Operator_Convert.)
CALL_LOOP_DETECTED	-6	MultiHandle.PerformOnce was called from the context of an EasyHandle or MultiHandle event handler. Don't do that.
NO_COOKIEJAR	-7	Reserved.
INVALID_LOCAL_FILE	-8	The specified local file is invalid, non-existent, or otherwise inappropriate for the requested action.
INVALID_STATE	-9	The CookieEngine cannot be turned off once turned on. Create a new EasyHandle to stop using cookies.
MIME_ADD_FAILED	-10	Unknown error while trying to create a new MIME message part.
MIME_OWNER_MISSING	-11	The EasyHandle that owns this MIMEMessage has already been destroyed.
MIME_MANUAL_ONLY	-12	The specified Dictionary contains keys and/or values that cannot be converted automatically.
HEADER_INDEX_OUT_OF_BOUNDS	-13	There is no header with the requested index.
REQUEST_INDEX_OUT_OF_BOUNDS	-14	There was no such request number.
NO_SUCH_HEADER	-16	No such response header exists.
NO_HEADERS	-17	No response headers have been received at all.
INCONCEIVABLE	-15	The unlikely event that an unlikely event would occur, even being as unlikely as it was, as previously mentioned, has, in fact, occurred. Please report all occurrences of this occurrence.

If an EasyHandle with UseErrorBuffer set to True is passed to the Constructor then the contents of the error buffer are copied to the Message property.

Methods

• Constructor

See also

• libcURL.FormatError
• libcURL.FormatMultiError
• libcURL.FormatShareError