ImageGear for C and C++ on Windows v19.5 - Updated
LPFNIG_ERRMNGR_CLEAR
API Reference Guide > Core Component API Reference > Core Component Callback Functions Reference > LPFNIG_ERRMNGR_CLEAR

This callback is called each time an error stack is cleared by any thread.

Declaration:

 
Copy Code
typedef VOID (LPACCUAPI LPFNIG_ERRMNGR_CLEAR)(
        LPVOID lpPrivate,
        DWORD dwThreadID,
        UINT nRecords
);

Arguments:

Name Type Description
lpPrivate LPVOID Private data passed.
dwThreadID DWORD Thread identifier where the stack cleared.
nRecords UINT Number of records cleared from the stack starting from index 0.

Return Value:

None

Supported Raster Image Formats:

This function does not process image pixels.

Sample:

MFC Threads

Example:

 
Copy Code
VOID ACCUAPI ErrGlClearCB(
LPVOID    lpPrivate,    /* Private data passed in. */
DWORD     dwThreadID,   /* Thread identifier where stack cleared.  */
UINT      nRecords    /* Number of records cleared from the stack starting from 0 index. */
)
{
char      szOutput[1024];
sprintf( szOutput, "Global CallBack - error stack cleared\nThread:%i, Records cleared:%i",
dwThreadID, nRecords );
        //AfxMessageBox( szOutput );
        ::MessageBox(NULL, szOutput, "THREADS", MB_OK);
}

Remarks:

Since each thread has its own independent error stack clearing, a stack by one thread does not cause other stacks to clear.