System.Win.ComObj.IServerExceptionHandler.OnException

De RAD Studio API Documentation
Aller à : navigation, rechercher

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 ;

Propriétés

Type Visibilité  Source Unité  Parent
procedure
function
public
System.Win.ComObj.pas
System.Win.ComObj.hpp
System.Win.ComObj IServerExceptionHandler


Description

Gère les exceptions SafeCall se produisant dans un TComObject.

TComObject.SafeCallException appelle cette procédure dans la propriété ServerExceptionHandler de son instance de TComObject quand une exception se produit. Si OnException gère cette exception, SafeCallException se termine avec la valeur résultante que vous spécifiez. Sinon, SafeCallException appelle HandleSafeCallException.

Cette procédure reçoit les paramètres suivants :

Paramètre Description
ServerClass Nom de la classe TComObject.
ExceptionClass Nom de la classe de l'exception transmise à la fonction TComObject.SafeCallException.
ErrorMessage Message d'erreur de l'exception transmise à la fonction TComObject.SafeCallException.
ExceptAddr Adresse de l'objet exception, telle qu'elle est transmise à la fonction TComObject.SafeCallException.
ErrorIID Représentation chaîne de l'identificateur global unique (GUID) de l'erreur qui s'est produite.
ProgID Identificateur global unique (GUID) de l'instance de TComObject.
Handled Affectez une valeur différente de zéro à ce paramètre dans votre implémentation OnException pour indiquer que vous avez géré l'exception. Sinon, TComObject.SafeCallException appelle HandleSafeCallException pour gérer cette exception.
Result Utilisez ce paramètre pour définir la valeur de retour de la fonction TComObject.SafeCallException.
Remarque : Si vous ne gérez pas une exception (en affectant une valeur différente de zéro à Handled), la valeur de retour de la fonction TComObject.SafeCallException est la valeur de retour d'un appel à HandleSafeCallException pour cette exception, alors que la valeur que vous affectez à Handled est ignorée.

Voir aussi