EvtGetExtendedStatus, fonction (winevt.h)

Obtient un message texte qui contient les informations d’erreur étendues pour l’erreur actuelle.

Syntaxe

DWORD EvtGetExtendedStatus(
  [in]  DWORD  BufferSize,
  [in]  LPWSTR Buffer,
  [out] PDWORD BufferUsed
);

Paramètres

[in] BufferSize

Taille de la mémoire tampon , en caractères.

[in] Buffer

Mémoire tampon de chaîne allouée à l’appelant qui recevra les informations d’erreur étendues. Vous pouvez définir ce paramètre sur NULL pour déterminer la taille de mémoire tampon requise.

[out] BufferUsed

Taille, en caractères, 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

La valeur de retour est ERROR_SUCCESS si l’appel a réussi ; sinon, un code d’erreur Win32.

Remarques

Vous devez appeler cette fonction sur le thread qui a généré l’erreur et avant d’appeler une autre fonction du journal des événements Windows.

Les fonctions EvtQuery et EvtSubscribe peuvent fournir des informations d’erreur étendues en cas de problème avec le XPath spécifié. Par exemple, les informations d’erreur peuvent identifier le caractère dans le XPath où une erreur d’analyse s’est produite. Pour recevoir les informations d’erreur étendues pour un XPath mal formé, vous ne pouvez pas spécifier l’indicateur EvtQueryTolerateQueryErrors lors de l’appel d’EvtQuery ou EvtSubscribe.

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