Vcl.SvcMgr.TService.LogMessage
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.