System.Win.ComObj.IServerExceptionHandler.OnException

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure OnException(
const ServerClass, ExceptionClass, ErrorMessage: WideString;
ExceptAddr: NativeInt; const ErrorIID, ProgID: WideString;
var Handled: Integer; var Result: HResult); dispid 2;

C++

virtual void __fastcall OnException(const System::WideString ServerClass, const System::WideString ExceptionClass, const System::WideString ErrorMessage, NativeInt ExceptAddr, const System::WideString ErrorIID, const System::WideString ProgID, int &Handled, HRESULT &Result) = 0 ;

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
procedure
function
public
System.Win.ComObj.pas
System.Win.ComObj.hpp
System.Win.ComObj IServerExceptionHandler


Beschreibung

Behandelt die SafeCall-Exceptions, die in einem TComObject-Objekt auftreten.

TComObject.SafeCallException ruft diese Prozedur für die Eigenschaft ServerExceptionHandler ihrer TComObject-Instanz auf, wenn eine Exception auftritt. Wenn OnException diese Exception behandelt, wird SafeCallException mit dem von Ihnen angegebenen Ergebniswert beendet, ansonsten ruft SafeCallException HandleSafeCallException auf.

Diese Prozedur übernimmt folgende Parameter:

Parameter Beschreibung
ServerClass Der Name der TComObject-Klasse.
ExceptionClass Der Name der Exception-Klasse, die an die Funktion TComObject.SafeCallException übergeben wird.
ErrorMessage Fehlermeldung der Exception, die an die Funktion TComObject.SafeCallException übergeben wird.
ExceptAddr Die Adresse des Exception-Objekts, wie diese an die Funktion TComObject.SafeCallException übergeben wird.
ErrorIID String-Repräsentation des global eindeutigen Bezeichners (GUID) des aufgetretenen Fehlers.
ProgID Global eindeutiger Bezeichner (GUID) der TComObject-Instanz.
Handled Setzen Sie diesen Parameter in Ihrer OnException-Implementierung auf einen Wert ungleich null um die Exception-Behandlung anzugeben. Ansonsten ruft TComObject.SafeCallException HandleSafeCallException zur Behandlung dieser Exception auf.
Handled Mit diesem Parameter können Sie den Rückgabewert der Funktion TComObject.SafeCallException definieren.
Hinweis: Wenn Sie eine Exception nicht behandeln (durch Setzen von Handled auf einen Wert ungleich null), ist der Rückgabewert der Funktion TComObject.SafeCallException der Rückgabewert eines Aufrufs von HandleSafeCallException für diese Exception, und der von Ihnen gesetzte Wert für Handled wird ignoriert.

Siehe auch