Home

Previous

Up

Next

MultiCam Boards Documentation > MultiCam Documentation > MultiCam User Guide > MultiCam Basics > Exceptions > API Errors > Message and Exception Behavior

Message and Exception Behavior

This behavior is assumed when the MultiCam configuration parameter ErrorHandling is set to MSGEXCEPTION.

When a MultiCam API function encounters an error, it displays an error dialog giving more information about the problem. The user closes the dialog by selection on of three buttons:

Selecting OK simply throws a WIN32 structured exception. The exception code is the MultiCam error code.

Exception handling is usually performed by special compiler dependent keywords.

Selecting ABORT immediately terminates the application. All MultiCam associated resources are cleaned up excepted the application resources.

Selecting IGNORE forces the function to return MC_OK without throwing an exception, allowing the program to ignore the error.

The user will refer to the Windows SDK documentation and to the relevant compiler documentation for more information about WIN32 structured exceptions and how to handle them.

The message and exception behavior is available on Windows operating systems only.