Partager via


TdhLoadManifest, fonction (tdh.h)

Charge le manifeste utilisé pour décoder un fichier journal.

Syntaxe

TDHSTATUS TdhLoadManifest(
  [in] PWSTR Manifest
);

Paramètres

[in] Manifest

Chemin d’accès complet au manifeste.

Valeur retournée

Retourne ERROR_SUCCESS en cas de réussite. Sinon, cette fonction retourne l’un des codes de retour suivants en plus d’autres.

Code de retour Description
ERROR_FILE_NOT_FOUND
Le fichier manifeste est introuvable au niveau du chemin d’accès spécifié.
ERROR_INVALID_PARAMETER
Le paramètre Manifest ne peut pas être NULL et le chemin d’accès ne peut pas dépasser MAX_PATH.
ERROR_XML_PARSE_ERROR
Le manifeste n’a pas réussi la validation. Pour déterminer les erreurs de validation, exécutez le manifeste via le compilateur de messages (mc.exe).

Remarques

Pour consommer des événements, TDH nécessite le manifeste du fournisseur. En règle générale, vous décodez le fichier journal sur un ordinateur qui contient le fournisseur. Étant donné que le fournisseur inclut le manifeste en tant que ressource, TDH utilise le fournisseur pour obtenir le manifeste. Pour décoder le fichier journal sur un ordinateur qui ne contient pas le fournisseur, vous devez d’abord utiliser l’exécutable TraceRpt.exe pour exporter le manifeste (voir le commutateur –export) à partir du fournisseur sur un ordinateur qui contient le fournisseur. Une fois que vous avez le fichier manifeste, vous pouvez décoder le fichier journal sur un ordinateur qui ne contient pas le fournisseur.

Vous devez appeler cette fonction avant de décoder le premier événement. Par exemple, vous pouvez appeler cette fonction avant d’appeler la fonction OpenTrace . Après avoir traité tous les événements, appelez la fonction TdhUnloadManifest .

Configuration requise

Condition requise Valeur
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 tdh.h
Bibliothèque Tdh.lib
DLL Tdh.dll

Voir aussi

TdhUnloadManifest