EvtGetLogInfo, fonction (winevt.h)

Obtient des informations sur un canal ou un fichier journal.

Syntaxe

BOOL EvtGetLogInfo(
  [in]  EVT_HANDLE          Log,
  [in]  EVT_LOG_PROPERTY_ID PropertyId,
  [in]  DWORD               PropertyValueBufferSize,
  [in]  PEVT_VARIANT        PropertyValueBuffer,
  [out] PDWORD              PropertyValueBufferUsed
);

Paramètres

[in] Log

Handle du canal ou du fichier journal que la fonction EvtOpenLog retourne.

[in] PropertyId

Identificateur de la propriété à récupérer. Pour obtenir la liste des identificateurs de propriété, consultez l’énumération EVT_LOG_PROPERTY_ID .

[in] PropertyValueBufferSize

Taille de la mémoire tampon PropertyValueBuffer , en octets.

[in] PropertyValueBuffer

Mémoire tampon allouée à l’appelant qui recevra la valeur de la propriété. La mémoire tampon contient un objet EVT_VARIANT . Vous pouvez définir ce paramètre sur NULL pour déterminer la taille de mémoire tampon requise.

[out] PropertyValueBufferUsed

Taille, en octets, de la mémoire tampon allouée à l’appelant utilisée par la fonction ou de la taille de mémoire tampon requise si la fonction échoue avec ERROR_INSUFFICIENT_BUFFER.

Valeur retournée

Code/valeur de retour	Description
TRUE	La fonction a réussi.
FALSE	Échec de la fonction. Pour obtenir le code d’erreur, appelez la fonction GetLastError .

Remarques

Vous pouvez obtenir des informations complètes pour les canaux opérationnels et Administration ou les fichiers .evtx. Toutefois, pour les canaux Debug et Analytique ou les fichiers .etl, vous ne pouvez pas obtenir d’informations pour les propriétés EvtLogFull, EvtLogOldestRecordNumber et EvtLogNumberOfLogRecords.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winevt.h
Bibliothèque	Wevtapi.lib
DLL	Wevtapi.dll

Voir aussi

EvtOpenLog