IG_err_record

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

Declaration:

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

Copy Code

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

Arguments:

nIndex	Zero based index of the record.
lpszFileName	Pointer indicating where to return the source's file name where the error occurred.
nFNameSize	The buffer memory size of lpszFileName.
lpnLineNumber	Pointer indicating where to return the line number where the error occurred.
lpnCode	Pointer indicating where to return the error code.
lpnLevel	Pointer indicating where to return the error level.
lplValue1	Pointer indicating where to return the first associated long value.
lplValue2	Pointer indicating where to return the second associated long value.
lpExtraText	Pointer indicating where to return additional text description.
nETextSize	Size of the memory buffer lpExtraText.

Return Value:

Returns TRUE if the record 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 iErrCount, i; CHAR FileName[_MAX_PATH]; INT nLineNumber; AT_ERRCODE nCode; UINT nLevel; // get all records from error stack. iErrCount = IG_err_count_get( ); for( i = 0; i<iErrCount; i++ ) { IG_err_record_get( i, FileName, sizeof(FileName), &nLineNumber, &nCode, &nLevel, NULL, NULL, NULL, 0 ); //... }