Share via

Fonction TraceSetInformation (evntrace.h)

  • Article

La fonction TraceSetInformation configure les paramètres de session de suivi d’événements.

Syntaxe

ULONG WMIAPI TraceSetInformation(
  [in] TRACEHANDLE      SessionHandle,
  [in] TRACE_INFO_CLASS InformationClass,
  [in] PVOID            TraceInformation,
  [in] ULONG            InformationLength
);

Paramètres

[in] SessionHandle

Gérer la session de suivi d’événements à configurer. 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 à activer ou désactiver. 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 activer, consultez l’énumération TRACE_QUERY_INFO_CLASS .

[in] TraceInformation

Pointeur vers des données spécifiques à la classe d’informations. La classe d’informations détermine le contenu de ce paramètre.

[in] InformationLength

Taille, en octets, des donné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.

Notes

Appelez cette fonction après avoir appelé StartTrace.

Si le paramètre InformationClass est défini sur TraceStackTracingInfo, l’appel de cette fonction permet le suivi de la pile des événements de noyau spécifiés. Les appels suivants à cette fonction remplacent la liste précédente des événements de noyau pour lesquels le suivi de pile est activé. Pour désactiver le suivi de la pile, appelez cette fonction avec InformationClass définie sur TraceStackTracingInfo et InformationLength définie sur 0.

La section de données étendues de l’événement inclut la pile des appels. La classe MOF StackWalk_Event définit la disposition des données étendues.

En règle générale, sur les ordinateurs 64 bits, vous ne pouvez pas capturer la pile du noyau dans certains contextes lorsque les erreurs de page ne sont pas autorisées. Pour activer la marche à pied de la pile du noyau sur x64, définissez la valeur de Registre Gestion de la DisablePagingExecutive mémoire sur 1. La DisablePagingExecutive valeur du Registre se trouve sous la clé de Registre suivante : HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Memory Management. Cela ne doit être effectué qu’à des fins de diagnostic temporaire, car cela augmente l’utilisation de la mémoire du système.

Spécifications

   
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [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, Windows Server 2012, Windows 7 et Windows Server 2008 R2
DLL Sechost.dll sur Windows 8.1 et Windows Server 2012 R2 ; Advapi32.dll sur Windows 8, Windows Server 2012, Windows 7 et Windows Server 2008 R2

Voir aussi

TRACE_QUERY_INFO_CLASS

TraceQueryInformation