IG_err_error

This function retrieves information about the record from error stack with the given index.

Declaration:

	Copy Code
AT_BOOL ACCUAPI IG_err_error_get( UINT nLevel, UINT nIndex, LPCHAR lpszFileName, UINT nFNameSize, LPINT lpnLineNumber, LPAT_ERRCODE lpnCode, LPAT_INT lplValue1, LPAT_INT lplValue2, LPCHAR lpExtraText, UINT nETextSize );

Copy Code

AT_BOOL ACCUAPI IG_err_error_get(
   UINT nLevel,
   UINT nIndex,
   LPCHAR lpszFileName,
   UINT nFNameSize,
   LPINT lpnLineNumber,
   LPAT_ERRCODE lpnCode,
   LPAT_INT lplValue1,
   LPAT_INT lplValue2,
   LPCHAR lpExtraText,
   UINT nETextSize
);

Arguments:

Name	Type	Description
nLevel	UINT	Level of errors to index. 0 means critical errors (function failure); greater levels denote warnings.
nIndex	UINT	Zero-based record index of the given level.
lpszFileName	LPCHAR	Pointer indicating where to return the source's file name where the error occurred.
nFNameSize	UINT	Size of the memory buffer lpszFileName.
lpnLineNumber	LPINT	Pointer indicating where to return the line number where the error occurred.
lpnCode	LPAT_ERRCODE	Pointer indicating where to return the error code.
lplValue1	LPAT_INT	Pointer indicating where to return the first associated long value.
lplValue2	LPAT_INT	Pointer indicating where to return the second associated long value.
lpExtraText	LPCHAR	Pointer indicating where to return the additional text description.
nETextSize	UINT	Size of the memory buffer lpExtraText.

Return Value:

Returns TRUE if the error information has been successfully retrieved; returns FALSE otherwise. Errors that occurred during this function call are not appended onto the error stack.

Supported Raster Image Formats:

This function does not process image pixels.

Sample:

None

Example:

	Copy Code
AT_ERRCOUNT errCount; errCount = IG_err_count_get();

Remarks:

The difference between this function and IG_err_record_get is that this index exists for records with the specified level, nLevel; not for all records on the stack.