EvtGetEventInfo, fonction (winevt.h)

Article
08/27/2023

Obtient des informations qui identifient la requête XML structurée qui a sélectionné l’événement et le canal ou le fichier journal qui contenait l’événement.

Syntaxe

BOOL EvtGetEventInfo(
  [in]  EVT_HANDLE            Event,
  [in]  EVT_EVENT_PROPERTY_ID PropertyId,
  [in]  DWORD                 PropertyValueBufferSize,
  [in]  PEVT_VARIANT          PropertyValueBuffer,
  [out] PDWORD                PropertyValueBufferUsed
);

Paramètres

[in] Event

Handle d’un événement pour lequel vous souhaitez récupérer des informations.

[in] PropertyId

Indicateur qui identifie les informations à récupérer. Par exemple, l’identificateur de requête ou le chemin d’accès. Pour connaître les valeurs possibles, consultez l’énumération EVT_EVENT_PROPERTY_ID .

[in] PropertyValueBufferSize

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

[in] PropertyValueBuffer

Mémoire tampon allouée à l’appelant qui recevra les informations. 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. Utilisez la fonction GetLastError pour obtenir le code d’erreur.

Remarques

Si la requête que vous avez passée à EvtQuery ou EvtSubscribe était un XPath au lieu d’une requête XML structurée, l’identificateur de requête sera zéro et le chemin d’accès sera le chemin que vous avez transmis à la fonction.

Configuration requise


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

Partager via