Quelles sont les chaînes de spécification de format étendu WPP

  • Article

WPP inclut des chaînes de spécification de format prédéfinies que vous pouvez utiliser dans les messages de suivi en plus des chaînes de format standard définies pour printf.

Vous pouvez utiliser le % ! FLAGS !, % ! FUNC! et % ! NIVEAU! chaînes dans un préfixe de message de suivi et dans toute fonction de suivi ou macro, telle que DoTraceMessage.

Vous pouvez utiliser les autres chaînes étendues dans n’importe quelle fonction de suivi.

Options de configuration par défaut pour tracewpp

WPP utilise « defaultwpp.ini » pour les paramètres de configuration par défaut. Ce fichier INI par défaut est inclus dans le kit de développement logiciel (SDK) Windows dans le répertoire WppConfig Rev1. Reportez-vous à ce fichier INI pour obtenir les dernières informations sur le comportement par défaut de WPP, ainsi que pour plus d’informations sur la personnalisation.

Suivi logiciel

Chaîne de format Description
%! FICHIER! Affiche le nom du fichier source à partir duquel le message de trace a été généré. Cette variable peut également être utilisée dans le préfixe de message de trace.
%! DRAPEAUX! Affiche la valeur des indicateurs de trace qui activent le message de trace. Cette variable peut également être utilisée dans le préfixe de message de trace.
%! FUNC! Affiche la fonction qui a généré le message de trace. Cette variable peut également être utilisée dans le préfixe de message de trace.
%! NIVEAU! Affiche le nom du niveau de trace qui active le message de trace. Cette variable peut également être utilisée dans le préfixe de message de trace.
%! LIGNE! Affiche le numéro de ligne de la ligne dans le code qui a généré le préfixe de trace. Cette variable peut également être utilisée dans le préfixe de message de trace.

Utilisation générale

Chaîne de format Description
% !bool ! Affiche TRUE ou FALSE
% !irql ! Affiche le nom de l’IRQL actuel.
% !sid ! Représente un pointeur vers l’identificateur de sécurité (pSID). Affiche le SID.
GUID
%! GUID! Représente un pointeur vers un GUID (pGUID). Affiche le GUID vers lequel est pointé.
%! CLSID! ID de classe. Représente un pointeur vers un GUID d’ID de classe. Affiche la chaîne associée au GUID. WPP localise la chaîne dans le Registre lorsqu’il met en forme les messages de trace.
%! LIBID ! Bibliothèque de types. Représente le GUID d’une bibliothèque de types COM. Affiche la chaîne associée au GUID. WPP localise la chaîne dans le Registre lorsqu’il met en forme les messages de trace.
%! IID! ID d’interface. Représente un pointeur vers un GUID d’ID d’interface. Affiche la chaîne associée au GUID. WPP localise la chaîne dans le Registre lorsqu’il met en forme les messages de trace.
Time
% !delta ! Affiche la différence entre deux valeurs de temps, en millisecondes. Il s’agit d’une valeur LONGLONG qui s’affiche au format day~h :m :s .
%! WAITTIME ! Affiche le temps passé à attendre que quelque chose soit terminé, en millisecondes. Il s’agit d’une valeur LONGLONG qui s’affiche au format day~h :m :s . Conçu pour être utilisé avec % !due !.
% !due ! Affiche l’heure pendant laquelle une opération est attendue, en millisecondes. Il s’agit d’une valeur LONGLONG qui s’affiche au format day~h :m :s . Conçu pour être utilisé avec % ! WAITTIME !.
%! TIMESTAMP!
% !datetime !
%! TEMPS!		 Affiche la valeur de l’heure système à un moment donné. Il s’agit de valeurs LONGLONG (SINT64) affichées au format SYSTEMTIME.
Vous pouvez utiliser ces variables pour représenter différentes valeurs de temps dans votre programme et pour les distinguer.

Codes de retour

Chaîne de format Description
%! STATUT! Représente une valeur de status et affiche la chaîne associée au code status.
%! WINERROR ! Représente un code d’erreur Windows et affiche la chaîne associée à l’erreur.
%! HRESULT! Représente une erreur ou un avertissement et affiche le code au format HRESULT.

Réseau

Chaîne de format Description
%! IPADDR ! Représente un pointeur vers une adresse IP. Affiche l’adresse IP.
%! PORT! Affiche un numéro de port.