Filter:Pascal Plain C C++ (DLL/Lib) C++ (VCL) C++ (.NET) C# VB.NET Java
This event is fired when storage needs to be created.
- Sender - reference to the class that called the delegate/event handler.
- Operation - the code of operation being performed.
- Progress - current progress.
- Total - maximum progress. Can be 0 if it can't be determined.
- CanStop - specifies is the operation can be interrupted by the user. The value can be different during one operation
- Stop - set this parameter to true to stop current operation
- [Plain C] UserData - application-defined parameter which is specified when the operation is invoked and passed back to callback function.
[Java] Return values
Returns True if the operation must be stopped immediately and false otherwise.
The event is fired when some lengthy operation is performed. Note, that certain operations can be repeated many times, so the same operation code can be reported several times in Operation parameter.
The callback/event handler must be set before the storage is opened.
You need to implement ISolFSProgressEvents interface in your code and pass the object, that implements the events, to one of SolFSStorage constructors that accept storageEvents parameter.
ERROR REPORTING: In Java you can't return more than one parameter, so the natural way is to throw an exception. You can throw any exception, and this exception will be passed back to the code, which called one of SolFS functions. So if you use callback mechanism and throw exception from within event handlers, be sure to wrap each call to SolFS methods with try/catch.