Fonction TraceQueryInformation (evntrace.h)

  • Article

La fonction TraceQueryInformation fournit des informations sur une session de suivi d’événements.

Syntaxe

ULONG WMIAPI TraceQueryInformation(
  [in]            TRACEHANDLE      SessionHandle,
  [in]            TRACE_INFO_CLASS InformationClass,
  [out]           PVOID            TraceInformation,
  [in]            ULONG            InformationLength,
  [out, optional] PULONG           ReturnLength
);

Paramètres

[in] SessionHandle

Gérer la session de suivi des événements pour laquelle vous collectez des informations. La fonction StartTrace retourne ce handle lorsqu’une nouvelle trace est démarrée. Pour obtenir le handle d’une trace existante, utilisez ControlTrace pour interroger les propriétés de trace en fonction du nom de la trace, puis obtenir le handle à partir du champ Wnode.HistoricalContext des données retournées EVENT_TRACE_PROPERTIES .

[in] InformationClass

Classe d’informations à interroger. Les informations que la classe capture sont incluses dans la section de données étendues de l’événement. Pour obtenir la liste des classes d’informations que vous pouvez interroger, consultez l’énumération TRACE_QUERY_INFO_CLASS .

[out] TraceInformation

Pointeur vers une mémoire tampon pour recevoir les données spécifiques de la classe d’informations retournées. La classe d’informations détermine le contenu de ce paramètre. Par exemple, pour la classe d’informations TraceStackTracingInfo , ce paramètre est un tableau de structures CLASSIC_EVENT_ID . Les structures spécifient les GUID d’événement pour lesquels le suivi de pile est activé. Le tableau est limité à 256 éléments.

[in] InformationLength

Taille, en octets, des données retournées dans la mémoire tampon TraceInformation . Si la fonction échoue, cette valeur indique la taille requise de la mémoire tampon TraceInformation nécessaire.

[out, optional] ReturnLength

Pointeur valeur qui reçoit la taille, en octets, des données spécifiques retournées dans la mémoire tampon TraceInformation .

Valeur retournée

Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.

Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants.

  • ERROR_BAD_LENGTH

    Le programme a émis une commande de longueur incorrecte. Cette erreur est retournée si le paramètre InformationLength est inférieur à une taille minimale.

  • ERROR_INVALID_PARAMETER

    Le paramètre est incorrect.

  • ERROR_NOT_SUPPORTED

    La demande n'est pas prise en charge.

  • Autres

    Utilisez FormatMessage pour obtenir la chaîne de message pour l’erreur retournée.

Remarques

La fonction TraceQueryInformation interroge les paramètres de session de suivi des événements à partir d’une session de trace. Appelez cette fonction après avoir appelé StartTrace.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau uniquement]
Plateforme cible Windows
En-tête evntrace.h
Bibliothèque Sechost.lib sur Windows 8.1 et Windows Server 2012 R2 ; Advapi32.lib sur Windows 8 et Windows Server 2012
DLL Sechost.dll sur Windows 8.1 et Windows Server 2012 R2 ; Advapi32.dll sur Windows 8 et Windows Server 2012

Voir aussi

TRACE_QUERY_INFO_CLASS

TraceSetInformation