Error reporting and handling

If your application needs to report some error when processing the callback, it should throw ECBFSError exception (CBFSError in .NET) exception. The application must pass the error code with the exception by passing the error code as a parameter to ECBFSError constructor.

Use the error codes, defined by Win32 API, when throwing the exception. These error codes are listed in WinError.h header file in Windows Platform SDK. Callback File System API will catch ECBFSError exception and extract the error code. The error code will be reported to the operating system.

If some exception occurs when the callback is executed, the application must catch this exception and throw an instance of ECBFSError instead. If you don't catch some exception in your code, the API will catch it for you. But in this case it will report "Internal error" error to the OS, and this doesn't look well for the OS and for the user.