Funktionreferenz

_EventLog__Report

Beschreibung anzeigen in

Schreibt einen angegebenen Eintrag an das Ende des Logfiles

#include <EventLog.au3>
_EventLog__Report ( $hEventLog, $iType, $iCategory, $iEventID, $sUserName, $sDesc, $aData )

Parameter

$hEventLog Der Handle eines Event-Logs. Bis Windows XP SP2 gibt es keinen Handle zum Security Log
$iType Event-Typen. Dies sind mögliche Rückgabewerte:
    0 - Erfolg
    1 - Fehler
    2 - Warnung
    4 - Information
    8 - Erfolgskontrolle
    16 - Fehlerkontrolle
$iCategory Die Event-Kategorieen. Dies sind quellenspezifische Informationen der Kategorie, die jeden Wert haben können.
$iEventID Die Event-Kennung. Die Event-Kennung spezifiziert den Eintrag im Event-File mit dem dazugehörigen Event-Code
$sUserName Benutzername für den Event. Dieser kann leer bleiben, um anzudeuten, dass kein Name vergeben wurde.
$sDesc Event-Beschreibung
$aData Das Array ist wie folgt formatiert:
    [0] - Anzahl der Bytes im Array
    [1] - Byte 1
    [2] - Byte 2
    [n] - Byte n

Rückgabewert

Erfolg: True
Fehler: False

Bemerkungen

Diese Funktion wird dazu genutzt, um ein Ereignis (Event) zu loggen. Ein Eintrag wird an das Ende des konfigurierten Logs anhand des
$hEventLog-Parameter geschrieben. Die Funktion merkt sich die Zeit, die Eintragslänge und den Offset, bevor die Einträge
in das Logfile geschrieben werden.

Verwandte Funktionen

_EventLog__Close, _EventLog__Open

Beispiel

#include <EventLog.au3>

Example()

Func Example()
    Local $hEventLog, $aData[4] = [3, 1, 2, 3]

    $hEventLog = _EventLog__Open("", "Application")
    _EventLog__Report($hEventLog, 4, 0, 2, "Administrator", "Von AutoIt3 generiertes Ereignis", $aData)
    _EventLog__Close($hEventLog)
EndFunc   ;==>Example