ReadEventLogW, fonction (winbase.h)

Article
11/20/2024

Lit le nombre spécifié d’entrées dans le journal des événements spécifié. La fonction peut être utilisée pour lire les entrées de journal dans l’ordre chronologique ou inverse.

Syntaxe

BOOL ReadEventLogW(
  [in]  HANDLE hEventLog,
  [in]  DWORD  dwReadFlags,
  [in]  DWORD  dwRecordOffset,
  [out] LPVOID lpBuffer,
  [in]  DWORD  nNumberOfBytesToRead,
  [out] DWORD  *pnBytesRead,
  [out] DWORD  *pnMinNumberOfBytesNeeded
);

Paramètres

[in] hEventLog

Handle du journal des événements à lire. La fonction OpenEventLog retourne ce handle.

[in] dwReadFlags

Utilisez les valeurs d’indicateur suivantes pour indiquer comment lire le fichier journal. Ce paramètre doit inclure l’une des valeurs suivantes (les indicateurs s’excluent mutuellement).

Valeur	Signification
EVENTLOG_SEEK_READ 0x0002	Commencez à lire à partir de l’enregistrement spécifié dans le paramètre dwRecordOffset . Cette option peut ne pas fonctionner avec des fichiers journaux volumineux si la fonction ne peut pas déterminer la taille du fichier journal. Pour plus d’informations, consultez l’article de la Base de connaissances 177199.
EVENTLOG_SEQUENTIAL_READ 0x0001	Lisez les enregistrements de manière séquentielle. S’il s’agit de la première opération de lecture, les indicateurs de EVENTLOG_FORWARDS_READ EVENTLOG_BACKWARDS_READ déterminent l’enregistrement en premier.

Vous devez spécifier l’un des indicateurs suivants pour indiquer la direction des opérations de lecture successives (les indicateurs s’excluent mutuellement).

Valeur	Signification
EVENTLOG_FORWARDS_READ 0x0004	Le journal est lu dans l’ordre chronologique (le plus ancien au plus récent). Valeur par défaut.
EVENTLOG_BACKWARDS_READ 0x0008	Le journal est lu dans l’ordre chronologique inverse (le plus récent au plus ancien).

[in] dwRecordOffset

Numéro d’enregistrement de l’entrée de journal à laquelle l’opération de lecture doit démarrer. Ce paramètre est ignoré, sauf si dwReadFlags inclut l’indicateur de EVENTLOG_SEEK_READ.

[out] lpBuffer

Mémoire tampon allouée à l’application qui recevra une ou plusieurs structures EVENTLOGRECORD. Ce paramètre ne peut pas être NULL, même si le paramètre nNumberOfBytesToRead est égal à zéro.

La taille maximale de cette mémoire tampon est 0x7ffff octets.

[in] nNumberOfBytesToRead

Taille de la mémoire tampon lpBuffer, en octets. Cette fonction lit autant d’entrées de journal que dans la mémoire tampon ; la fonction ne retourne pas d’entrées partielles.

[out] pnBytesRead

Pointeur vers une variable qui reçoit le nombre d’octets lus par la fonction.

[out] pnMinNumberOfBytesNeeded

Pointeur vers une variable qui reçoit la taille requise de la mémoire tampon lpBuffer. Cette valeur n’est valide que cette fonction retourne zéro et GetLastError retourne ERROR_INSUFFICIENT_BUFFER.

Valeur de retour

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Remarques

Lorsque cette fonction est retournée avec succès, la position de lecture dans le journal des événements est ajustée par le nombre d’enregistrements lus.

Remarque Le nom de fichier configuré pour cette source peut également être le nom de fichier configuré pour d’autres sources (plusieurs sources peuvent exister en tant que sous-clés sous un seul journal). Par conséquent, cette fonction peut retourner des événements enregistrés par plusieurs sources.

Exemples

Pour obtenir un exemple, consultez interrogation des informations sur les événements.

Note

L’en-tête winbase.h définit ReadEventLog comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	winbase.h (inclure Windows.h)
bibliothèque	Advapi32.lib
DLL	Advapi32.dll
ensemble d’API	ext-ms-win-advapi32-eventlog-ansi-l1-1-0 (introduit dans Windows 10, version 10.0.10240)