IG_errmngr_callback

This function sets error stack callback data and functions that are called to signal error stack changes for all threads.

Declaration:

	Copy Code
AT_ERRCODE ACCUAPI IG_errmngr_callback_set( LPVOID lpPrivate, LPFNIG_ERRMNGR_ADD lpfnAddCB, LPFNIG_ERRMNGR_CLEAR lpfnClearCB );

Arguments:

Name	Type	Description
lpPrivate	LPVOID	Any Private data that will be passed to lpfnAddCB and lpfnClearCB callbacks. NULL is acceptable.
lpfnAddCB	LPFNIG_ERRMNGR_ADD	Callback function that will be called after the record is added to the error stack. See LPFNIG_ERRMNGR_ADD for a declaration.
lpfnClearCB	LPFNIG_ERRMNGR_CLEAR	Callback function that will be called after the error stack is cleared. See LPFNIG_ERRMNGR_CLEAR for a declaration.

Return Value:

Returns the code of the ImageGear error that occurred during this function call. A value of zero means no errors have occurred. 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:

MFC Threads

Example:

	Copy Code
VOID ACCUAPI ErrMgrRecordAdd( LPVOID lpPrivate, DWORD dwThreadID, UINT nRecord, INT iLineNumber, AT_ERRCODE iCode, UINT nLevel, AT_INT lValue1, AT_INT lValue2, LPCHAR lpFileName, LPCHAR lpExtratext ) { HWND hWnd = (HWND)lpPrivate; // update error window with new records // ... } VOID ACCUAPI ErrMgrClear( LPVOID lpPrivate, DWORD dwThreadID, UINT nRecords) { HWND hWnd = (HWND)lpPrivate; // remove records from error window // ... } void Example_IG_errmngr_callback_set() { HWND hWnd = 0; // This assuming to be a real window AT_ERRCODE iErrCode; iErrCode = IG_errmngr_callback_set( (LPVOID)hWnd, ErrMgrRecordAdd, ErrMgrClear); }

Copy Code

VOID ACCUAPI ErrMgrRecordAdd(
   LPVOID        lpPrivate,
   DWORD            dwThreadID,
   UINT            nRecord,
    INT            iLineNumber,
    AT_ERRCODE    iCode,
    UINT            nLevel,
    AT_INT        lValue1,
    AT_INT        lValue2,
    LPCHAR        lpFileName,
    LPCHAR        lpExtratext
)
{
    HWND hWnd = (HWND)lpPrivate;
    // update error window with new records 
    // ...
}

VOID ACCUAPI ErrMgrClear(
   LPVOID        lpPrivate,
   DWORD            dwThreadID,
   UINT            nRecords)
{
    HWND hWnd = (HWND)lpPrivate;
    // remove records from error window
    // ...
}

void Example_IG_errmngr_callback_set()
{
    HWND hWnd = 0; // This assuming to be a real window
    AT_ERRCODE iErrCode;
    
    iErrCode = IG_errmngr_callback_set( (LPVOID)hWnd, ErrMgrRecordAdd, ErrMgrClear);
}

Remarks:

Global private data and callback functions can be obtained using IG_errmngr_callback_get function.

Each thread has its own independent error stack. There are two types of callbacks - local to thread and global. This API allows you to get the global (thread independent) callbacks. Use IG_err_callback_set to set the thread specific data and callbacks.