TdhLoadManifestFromBinary, fonction (tdh.h)
Prend un chemin d’accès terminé par null à un fichier binaire qui contient les ressources de métadonnées nécessaires pour décoder un fournisseur d’événements spécifique.
Syntaxe
TDHSTATUS TdhLoadManifestFromBinary(
[in] PWSTR BinaryPath
);
Paramètres
[in] BinaryPath
Type : PWSTR
Chemin d’accès au binaire du fournisseur ETW qui contient les ressources de métadonnées.
Valeur retournée
Type : ULONG
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_INVALID_PARAMETER | Un ou plusieurs paramètres ne sont pas valides. |
| ERROR_FILE_NOT_FOUND | Le fichier pointé par BinaryPath est introuvable. |
| ERROR_NOT_ENOUGH_MEMORY | Échec des allocations de mémoire. |
| ERROR_RESOURCE_NOT_FOUND | Le fichier ne contient pas de ressources de métadonnées d’événement. |
Remarques
Les GUID et la chaîne BinaryPath sont mis en cache.
Lorsque des métadonnées sont demandées pour un événement ou un fournisseur donné, mais que le fournisseur n’est pas installé dans le système, le cache des fichiers binaires fait l’objet d’une recherche.
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 | tdh.h |
| Bibliothèque | Tdh.lib |
| DLL | Tdh.dll |