Fonction TraceQueryInformation (evntrace.h)

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

Syntaxe

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

Paramètres

TraceId

[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

Voir aussi

TRACE_QUERY_INFO_CLASS

TraceSetInformation