Vcl.SvcMgr.TService.LogMessage

• Übergeordnet: TService

Delphi

procedure LogMessage(Message: String; EventType: DWord = 1;
Category: Integer = 0; ID: Integer = 0);

C++

void __fastcall LogMessage(System::UnicodeString Message, unsigned EventType = (unsigned)(0x1), int Category = 0x0, int ID = 0x0);

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
procedure function	public	Vcl.SvcMgr.pas Vcl.SvcMgr.hpp	Vcl.SvcMgr	TService

Beschreibung

Sendet eine Fehlermeldung an das Ereignisprotokoll.

Wenn ein Fehler oder eine Exception auftritt, sendet LogMessage die entsprechende Fehlermeldung an das Ereignisprotokoll. Der Parameter EventType hat standardmäßig den Wert EVENTLOG_ERROR_TYPE (normalerweise handelt es sich um eine Fehlfunktion oder einen Datenverlust), und die Parameter Category und ID sind per Vorgabe Null. Beispielsweise kann ein Dienst, der sich beim Systemstart nicht laden lässt, ein Fehlerereignis protokollieren und Category und ID auf Null setzen.

Der Parameter EventType gibt den Typ des protokollierten Ereignisses an. Er kann folgende Werte annehmen:

Wert	Bedeutung
EVENTLOG_WARNING_TYPE	Warnungsereignis
EVENTLOG_INFORMATION_TYPE	Informationsereignis
EVENTLOG_AUDIT_SUCCESS	Audit-Ereignis für Erfolg
EVENTLOG_AUDIT_FAILURE	Audit-Ereignis mit Fehlfunktion
EVENTLOG_ERROR_TYPE	Error-Ereignis

Der Parameter Category enthält die Ereigniskategorie. Es handelt sich dabei um eine quellenspezifische Information mit einem beliebigen Wert.

Der Parameter ID enthält die Ereignis-ID. Diese bezeichnet die Meldung, die in der zur Ereignisquelle gehörigen Meldungsdatei enthalten ist.