Raising Exceptions During Invoke
A version of this page is also available for
4/8/2010
When you implement IDispatch::Invoke, errors can be communicated either through the normal return value or by raising an exception. An exception is a special situation that is normally handled by jumping to the nearest routine enclosing the exception handler.
To raise an exception, Invoke returns DISP_E_EXCEPTION and fills the structure passed through pExcepInfo with information about the cause of the exception or error. You can use the information to understand the cause of the exception and proceed as necessary.
The exception information structure includes an error code number that identifies the kind of exception (a string that describes the error in a human-readable way). It also includes a Help file and a Help context number that can be passed to Windows Help for details about the error.
At a minimum, the error code number must be filled with a valid number.
If you consider IDispatch another way to call C++ methods in an interface, EXCEPINFO models the raising of an exception or longjmp call by such a method.