Error Codes

The LEADTOOLS toolkit returns error and success notifications to applications in the form of HRESULT values.

A return code's LOWORD portion is the return code itself, in hexadecimal format.

The COM Win32 HRESULT documentation contains more information, including how to use the FAILED and SUCCEEDED macros to test return values.

Microsoft Visual Basic® programmers will see only the decimal equivalent of the error code's first 16-bit portion. This value appears in an error notification dialog box or in the Err object as a run-time error. If the error is not in the following list, you must convert the decimal number to its hexadecimal equivalent, and then look for the error as described previously. Note that the error's hexadecimal version will be a maximum of four digits long; to find the error, match the last four digits of the hexadecimal code in the error code list to the converted run-time error.

The LEADTOOLS filters will return E_EVAL_EXPIRED (0x80050010) if you attempt to create them after the evaluation period has expired.

Some components will convert DOS error codes to 0x8003zzzz, where "zzzz" is the error code. For example, the DOS error code ERROR_PATH_NOT_FOUND (0x03) is converted to 0x80030003. For a complete list, see the GetLastError function in the Microsoft Platform SDK documentation.

 

Value

Number

Meaning

NOERROR

0

No error. Numerically equivalent to S_OK.

S_OK

0

Success. Numerically equivalent to NOERROR.

S_FALSE

1

Success. Condition was FALSE.

E_OUTOFMEMORY

&H80000002

Insufficient memory.

E_INVALIDARG

&H80000003

Argument is invalid.

E_NOTIMPL

&H80004001

Method is not supported.

E_POINTER

&H80004003

NULL pointer argument.

E_FAIL

&H80004005

Failure.

E_UNEXPECTED

&H8000FFFF

Unexpected error.

E_SHARING_VIOLATION

&H80070020

The output file is in use.

E_EVAL_EXPIRED

&H80050010

The evaluation period for the filter has expired.

LTMM_E_INVALID_DATA

&H80050013

Invalid data

LTMM_E_INVALID_HEADER

&H80050014

Invalid packed data

LTMM_E_DISABLED

&H80050015

This feature is disabled

LTMM_E_INVALID_VERSION

&H80050016

This version is not supported

LTMM_E_STILLIMAGE_LOCKED

&H80050017

The LEADTOOLS still image toolkit needs to be unlocked