API Errors
MultiCam errors are managed either with a MultiCam error code or a Windows exception, and with or without an error dialog box.
The ErrorHandling parameter sets the error management behavior and has 4 possible values:
NONE, the function returns a MultiCam error code.
- All API functions have the type MCSTATUS and return an integer value.
- If no error occurs, the function returns the value MC_OK or 0.
- If an error occurs, the function returns a negative value as defined in MCSTATUS.
MSG, the function displays a dialog box then returns a MultiCam error code. (Windows OS only)
- All API functions have the type MCSTATUS and return an integer value.
- If no error occurs, the function returns the value MC_OK or 0.
- If an error occurs, a dialog box is displayed with 3 buttons:
- OK, the function returns a negative value as defined in MCSTATUS and passes this error value to the application.
- ABORT terminates the application. All MultiCam resources are cleaned up but the application resources.
- IGNORE forces the function to return MC_OK to the application, allowing the program to ignore the error.
EXCEPTION, the function issues a Windows exception. (Windows OS only)
- If an error occurs, the function generates a WIN32 structured exception with an error code as defined in MCSTATUS.
- The exception handling is compiler dependent. Refer to the Windows SDK and your compiler documentation for more information.
MSGEXCEPTION, the function displays a dialog box then issues a Windows exception. (Windows OS only)
- If an error occurs, a dialog box is displayed with 3 buttons:
- OK, the function generates a WIN32 structured exception with an error code as defined in MCSTATUS.
- ABORT terminates the application. All MultiCam resources are cleaned up but the application resources.
- IGNORE forces the function to return MC_OK to the application without generating an exception, allowing the program to ignore the error.
- The exception handling is compiler dependent. Refer to the Windows SDK and your compiler documentation for more information.