UDF > EventLog >

_EventLog__Read

Lit une entr�e � partir d'un journal d'�v�nement

#include <EventLog.au3>
_EventLog__Read ( $hEventLog [, $bRead = True [, $bForward = True [, $iOffset = 0]]] )

Param�tres

$hEventLog Le handle du journal d'�v�nement
$bRead [optionnel] Si True, proc�de s�quentiellement � partir du dernier appel � cette fonction en utilisant ce handle.
Si False, la lecture passera � l'enregistrement sp�cifi� par le param�tre $ioffset.
$bForward [optionnel] Si True, le journal est lu dans l'ordre chronologique. Si False, le journal est lu dans l'ordre chronologique inverse.
$iOffset [optionnel] Le num�ro de l'enregistrement d'�v�nement auquel la lecture doit commencer.
Ce param�tre est ignor� si $bRead est True.

Valeur de retour

Succ�s: Retourne un tableau dans le format suivant:
    [ 0] - True
    [ 1] - Num�ro de l'enregistrement
    [ 2] - Date � laquelle cette entr�e a �t� soumise
    [ 3] - Heure � laquelle cette entr�e a �t� soumise
    [ 4] - Date � laquelle cette entr�e a �t� re�ue pour �tre �crite dans le journal
    [ 5] - Heure � laquelle cette entr�e a �t� re�ue pour �tre �crire dans le journal
    [ 6] - Identifiant de l'�v�nement
    [ 7] - Type de l'�v�nement. Peut prendre les valeurs suivantes:
        1 - �v�nement d'erreur
        2 - �v�nement d'avertissement
        4 - �v�nement d'information
        8 - �v�nement d'audit de r�ussite
        16 - �v�nement d'audit d'�chec
    [ 8] - �v�nement de type string
    [ 9] - �v�nement cat�gorie
    [10] - �v�nement source
    [11] - Nom de l'ordinateur
    [12] - Nom d'utilisateur
    [13] - Description de l'�v�nement
    [14] - Tableau de donn�es de l'�v�nement
�chec: Retourne $Array[0] = False

Remarque

Lorsque cette fonction retourne un succ�s, la position de lecture dans le journal d'�v�nement est ajust�e sur le nombre d'enregistrements lus.
Bien que plusieurs enregistrements peuvent �tre lus, cette fonction retourne un enregistrement � la fois pour l'amour de la sant� mentale.

En relation

_EventLog__Close, _EventLog__Open

Exemple

#include <EventLog.au3>
#include <FontConstants.au3>
#include <GUIConstantsEx.au3>

Global $g_idMemo

Example()

Func Example()
    Local $hEventLog, $aEvent

    ; Cr�e une GUI
    GUICreate("EventLog", 400, 300)
    $g_idMemo = GUICtrlCreateEdit("", 2, 2, 396, 300, 0)
    GUICtrlSetFont($g_idMemo, 9, $FW_NORMAL, $GUI_FONTNORMAL, "Courier New")
    GUISetState(@SW_SHOW)

    ; Lit le plus r�cent enregistrement
    $hEventLog = _EventLog__Open("", "Application")
    $aEvent = _EventLog__Read($hEventLog, True, False) ; Lit le dernier enregistrement
    ; $hEventLog = _EventLog__Open("", "System")
    ; $aEvent = _EventLog__Read($hEventLog)
    ; $aEvent = _EventLog__Read($hEventLog, True, False)
    MemoWrite("Result ............: " & $aEvent[0])
    MemoWrite("Record number .....: " & $aEvent[1])
    MemoWrite("Submitted .........: " & $aEvent[2] & " " & $aEvent[3])
    MemoWrite("Generated .........: " & $aEvent[4] & " " & $aEvent[5])
    MemoWrite("Event ID ..........: " & $aEvent[6])
    MemoWrite("Type ..............: " & $aEvent[8])
    MemoWrite("Category ..........: " & $aEvent[9])
    MemoWrite("Source ............: " & $aEvent[10])
    MemoWrite("Computer ..........: " & $aEvent[11])
    MemoWrite("Username ..........: " & $aEvent[12])
    MemoWrite("Description .......: " & $aEvent[13])
    _EventLog__Close($hEventLog)

    ; Boucle jusqu'� ce que l'utilisateur quitte.
    Do
    Until GUIGetMsg() = $GUI_EVENT_CLOSE
EndFunc   ;==>Example

; Ecrit une ligne dans le contr�le m�mo
Func MemoWrite($sMessage)
    GUICtrlSetData($g_idMemo, $sMessage & @CRLF, 1)
EndFunc   ;==>MemoWrite