Error Codes

Error

Value

Description

IMG_OK

1

No error has occurred.

IMG_INV_FIL

2

The file is not a valid image file. Make sure the file has a proper extension.

IMG_FILE_ERR

3

An error occurred when reading from the image file or an error occurred while writing to a temporary file. The most likely cause is a full disk or a corrupted file.

IMG_NOFILE

4

The file whose name was passed to ImgOpen() could not be opened. Most likely the file doesn't exist or may be opened exclusively by another process.

IMG_NOMEM

6

The ImageMan function was not able to allocate memory from the global heap. This can result from low memory conditions or from Windows having run out of selectors in Standard or Enhanced modes. In Windows 3.0 the limit for selectors is 4096 in Standard mode and 8192 in Enhanced mode.

IMG_INV_HAND

8

This is the result of passing an Invalid handle to an ImageMan function. Make sure that any handle passed to an ImageMan function was returned from ImgOpen().

IMG_NSUPPORT

9

This indicates that an image file contains an option not supported by ImageMan . Although currently ImageMan fully supports each image specification, many formats are continuing to evolve. Please contact Data Techniques about availability of updated image filters.

IMG_PROC_ERR

10

This indicates that an error occurred while processing the image. Most likely the image is corrupted.

IMG_PRINT_ERR

11

Indicates that an error occurred while preparing the image for printing.

IMG_BAD_PRN

12

Indicates that the selected printer is not capable of printing the requested image type. This should only occur when attempting to print a raster based image on a plotter or similar vector device.

IMG_BAD_SRC

13

This error is returned when an application attempts to use a source rectangle that is beyond the image's boundaries.

IMG_BAD_TYPE

14

Returned when using ImgGetDIB on a vector image (ImgGetDIB supports raster images only.)

IMG_NO_DILS

15

This error code is set when ImageMan is initialized to indicate that no DILs were found; if no DILs are found, ImageMan cannot process any images. This code can be checked for upon application initialization or it will be returned from the first ImgOpenSolo or ImgOpenEmbedded function call made by the application.

IMG_INV_PAGE

16

Returned by ImgSetPage function when the user attempts to seek to a non-existent page.

IMG_NO_PROC

17

This is an internal error that should not occur. It indicates that a DIL file could not be initialized.

IMG_PASTECLIP

19

An error occurred when pasting an image onto the clipboard.

IMG_BLITERR

20

An error occurred in ImgDrawImage when attempting to StretchBlit a DDB to the specified device context.

IMG_DIBERR

21

An error occurred in ImgDrawImage when attempting to StretchBlit a DIB to the specified device context.

IMG_METAFILEERR

22

An error occurred in ImgDrawImage when attempting to play a metafile to the specified device context.

IMG_CANCELLED

23

The operation was canceled by the Status procedure.

IMG_BADBITMAP

24

A valid DIB was not passed to ImgFromDIBSection.

IMG_IVNFILTER

25

An invalid pre-defined filter was passed to ImgFilter.

IMG_DLGCANCEL

26

The user selected the Cancel button in the Open or Save dialog.

IMG_BUFFTOOSMALL

27

The buffer passed to the function was too small to hold the selected filename.

IMG_DLGERR

28

The dialog procedure generated an internal error. The DLL's resources may be corrupted.

IMG_BAD_PARAM
29 Bad Parameter passed to function

IMG_BAD_PASSWD
30 Invalid Password or Password Required

IMGFX_INVALIDPARAM

100

An invalid parameter (probably one that is out of range) was sent to ImgDrawImageFX.

IMGFX_INVALIDIMAGE

102

An image was given to the special effects that it can do special effects on.

IMGFX_OUTOFMEMORY

103

The special effects can not allocate the required memory.

IMGFX_OUTOFRESOURCES

104

There is not enough free resources for the special effects.

IMGPI _ UNAVAIL

40

The plug-in host is not available to the ImageMan's main DLL. Most likely the Plug-in host DLL is missing or isn't on the path.

IMGPI_ALREADYLOADED

41

The plug-in host module has already been loaded. This is more of an informative message and generally speaking your code can go on about its way if this is returned. This return value only comes from the ImgPlugInHostLoad function.

IMGPI_NOTLOADED

42

The plug-in host is not loaded. You have attempted to load a plug-in, invoke a plug-in, invoke a plug-in's about dialog box without having successfully loaded a plug-in with ImgPlugInLoad.

IMGPI_CANTUNLOAD

43

The plug-in host is locked in memory and can not currently be unloaded.

IMGPI_ERRORLOADINGPLUGIN

44

This is returned if the host can not load the specified plug-in or the plug-in is corrupt and contains invalid internal data. Some plug-ins also depend on other DLLs that may not be present on your system. You can use the VC++ dumpbin utility (or other such utility that can expose the imports) with the -imports option specified to determine its dependency on any other DLLs.

IMGPI_NOPLUGINSELECTED

45

This is returned if you call ImgPlugInAbout or ImgPlugInInvoke but you have not loaded a plug-in.

IMGPI_PLUGINERROR

46

An internal error in the plug-in itself has occurred

IMGPI_ERRORENUMERATING

47

The plug-in encountered an error while attempting to enumerate the plug-ins. You have probably specified an invalid directory when you called ImgPlugInHostLoad.

IMGPI_NOMEM

48

There is not enough memory available for either the plug-in host or the plug-in itself.

Error	Value	Description
IMG_OK	1	No error has occurred.
IMG_INV_FIL	2	The file is not a valid image file. Make sure the file has a proper extension.
IMG_FILE_ERR	3	An error occurred when reading from the image file or an error occurred while writing to a temporary file. The most likely cause is a full disk or a corrupted file.
IMG_NOFILE	4	The file whose name was passed to ImgOpen() could not be opened. Most likely the file doesn't exist or may be opened exclusively by another process.
IMG_NOMEM	6	The ImageMan function was not able to allocate memory from the global heap. This can result from low memory conditions or from Windows having run out of selectors in Standard or Enhanced modes. In Windows 3.0 the limit for selectors is 4096 in Standard mode and 8192 in Enhanced mode.
IMG_INV_HAND	8	This is the result of passing an Invalid handle to an ImageMan function. Make sure that any handle passed to an ImageMan function was returned from ImgOpen().
IMG_NSUPPORT	9	This indicates that an image file contains an option not supported by ImageMan . Although currently ImageMan fully supports each image specification, many formats are continuing to evolve. Please contact Data Techniques about availability of updated image filters.
IMG_PROC_ERR	10	This indicates that an error occurred while processing the image. Most likely the image is corrupted.
IMG_PRINT_ERR	11	Indicates that an error occurred while preparing the image for printing.
IMG_BAD_PRN	12	Indicates that the selected printer is not capable of printing the requested image type. This should only occur when attempting to print a raster based image on a plotter or similar vector device.
IMG_BAD_SRC	13	This error is returned when an application attempts to use a source rectangle that is beyond the image's boundaries.
IMG_BAD_TYPE	14	Returned when using ImgGetDIB on a vector image (ImgGetDIB supports raster images only.)
IMG_NO_DILS	15	This error code is set when ImageMan is initialized to indicate that no DILs were found; if no DILs are found, ImageMan cannot process any images. This code can be checked for upon application initialization or it will be returned from the first ImgOpenSolo or ImgOpenEmbedded function call made by the application.
IMG_INV_PAGE	16	Returned by ImgSetPage function when the user attempts to seek to a non-existent page.
IMG_NO_PROC	17	This is an internal error that should not occur. It indicates that a DIL file could not be initialized.
IMG_PASTECLIP	19	An error occurred when pasting an image onto the clipboard.
IMG_BLITERR	20	An error occurred in ImgDrawImage when attempting to StretchBlit a DDB to the specified device context.
IMG_DIBERR	21	An error occurred in ImgDrawImage when attempting to StretchBlit a DIB to the specified device context.
IMG_METAFILEERR	22	An error occurred in ImgDrawImage when attempting to play a metafile to the specified device context.
IMG_CANCELLED	23	The operation was canceled by the Status procedure.
IMG_BADBITMAP	24	A valid DIB was not passed to ImgFromDIBSection.
IMG_IVNFILTER	25	An invalid pre-defined filter was passed to ImgFilter.
IMG_DLGCANCEL	26	The user selected the Cancel button in the Open or Save dialog.
IMG_BUFFTOOSMALL	27	The buffer passed to the function was too small to hold the selected filename.
IMG_DLGERR	28	The dialog procedure generated an internal error. The DLL's resources may be corrupted.
IMG_BAD_PARAM	29	Bad Parameter passed to function
IMG_BAD_PASSWD	30	Invalid Password or Password Required
IMGFX_INVALIDPARAM	100	An invalid parameter (probably one that is out of range) was sent to ImgDrawImageFX.
IMGFX_INVALIDIMAGE	102	An image was given to the special effects that it can do special effects on.
IMGFX_OUTOFMEMORY	103	The special effects can not allocate the required memory.
IMGFX_OUTOFRESOURCES	104	There is not enough free resources for the special effects.
IMGPI _ UNAVAIL	40	The plug-in host is not available to the ImageMan's main DLL. Most likely the Plug-in host DLL is missing or isn't on the path.
IMGPI_ALREADYLOADED	41	The plug-in host module has already been loaded. This is more of an informative message and generally speaking your code can go on about its way if this is returned. This return value only comes from the ImgPlugInHostLoad function.
IMGPI_NOTLOADED	42	The plug-in host is not loaded. You have attempted to load a plug-in, invoke a plug-in, invoke a plug-in's about dialog box without having successfully loaded a plug-in with ImgPlugInLoad.
IMGPI_CANTUNLOAD	43	The plug-in host is locked in memory and can not currently be unloaded.
IMGPI_ERRORLOADINGPLUGIN	44	This is returned if the host can not load the specified plug-in or the plug-in is corrupt and contains invalid internal data. Some plug-ins also depend on other DLLs that may not be present on your system. You can use the VC++ dumpbin utility (or other such utility that can expose the imports) with the -imports option specified to determine its dependency on any other DLLs.
IMGPI_NOPLUGINSELECTED	45	This is returned if you call ImgPlugInAbout or ImgPlugInInvoke but you have not loaded a plug-in.
IMGPI_PLUGINERROR	46	An internal error in the plug-in itself has occurred
IMGPI_ERRORENUMERATING	47	The plug-in encountered an error while attempting to enumerate the plug-ins. You have probably specified an invalid directory when you called ImgPlugInHostLoad.
IMGPI_NOMEM	48	There is not enough memory available for either the plug-in host or the plug-in itself.