System.Win.ComObj.TComObject.ServerExceptionHandler

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

property ServerExceptionHandler: IServerExceptionHandler

C++

__property _di_IServerExceptionHandler ServerExceptionHandler = {read=FServerExceptionHandler, write=FServerExceptionHandler};

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
property public
System.Win.ComObj.pas
System.Win.ComObj.hpp
System.Win.ComObj TComObject

Beschreibung

Stellt einen Zugriff auf den Botschaftsprozess der SafeCall-Exception bereit.

Die Eigenschaft ServerExceptionHandler stellt einen Zugriff auf den Botschaftsprozess der SafeCall-Exception bereit. Damit können Sie diese Botschaften in einer Datei protokollieren oder an einen externen Monitor leiten. Der Monitor kann ein anderes Objekt in demselben COM-Server-Modul sein oder er kann sich auf einem gänzlich anderer Rechner befinden.

Ereignisbehandlungsroutinen für Server-Exceptions können für die Ausführung der folgenden Aufgaben implementiert werden:

  • COM-Server-Exceptions in der NT-Systemereignis-Logdatei protokollieren
  • Exceptions in eine Textdatei speichern
  • E-Mails an einen Administrator senden
  • Technische Mitarbeiter über einen Pager informieren

Die Eigenschaft ServerExceptionHandler eignet sich zur Verwaltung von Remote-Servern, insbesondere dann, wenn ein Server physikalisch nicht erreichbar ist. Wenn beispielsweise in einem COM-Objekt eine Exception ausgelöst wird und die Server-Anwendung eine VCL-formularbasierte Anwendung (nicht einfach eine DLL) ist, kann die VCL-Standard-Ereignisbehandlungsroutine ein Meldungsfenster auf dem Server anzeigen. Bevor dieses Meldungsfenster nicht geschlossen wird, können keine Client-Anforderungen auf dieser COM-Objektinstanz bedient werden. Indem die Exception in einem Ereignisprotokoll festgehalten wird, kann diese Information von allen Remote-Anwender eingesehen werden, sofern diese Zugriffsrechte für den Server besitzen.

Tip:  Die Eigenschaft ServerExceptionHandler eignet sich weiterhin besonders für COM-Objekte (entweder eigenständige oder solche, die in einer MTS-Umgebung ausgeführt werden), die in aktiven Server-Seiten verwendet werden. Mithilfe der Eigenschaft ServerExceptionHandler lassen sich Exception-Informationen im HTML- oder einem beliebigen anderen Format schreiben.

Siehe auch