Fonction PdhUpdateLogFileCatalog (pdh.h)
Synchronise les informations du catalogue de fichiers journaux avec les données de performances dans le fichier journal.
Syntaxe
PDH_FUNCTION PdhUpdateLogFileCatalog(
[in] PDH_HLOG hLog
);
Paramètres
[in] hLog
Gérez le fichier journal contenant le catalogue de fichiers à mettre à jour. Fonction PdhOpenLog .
Valeur retournée
Si la fonction réussit, elle retourne ERROR_SUCCESS.
Si la fonction échoue, la valeur renvoyée est un code d’erreur système ou un code d’erreur PDH. Voici les valeurs possibles.
| Code de retour | Description |
|---|---|
|
Un handle dans un fichier journal CSV ou TSV a été spécifié. Ces types de fichiers journaux n’ont pas de catalogues. |
|
Un handle dans un fichier journal au format inconnu a été spécifié. |
|
Le handle n’est pas valide. |
Remarques
Le catalogue de fichiers journaux sert d’index aux enregistrements de données de performances dans le fichier journal, ce qui permet des recherches plus rapides pour les enregistrements individuels dans le fichier.
Les catalogues doivent être mis à jour lorsque le processus de collecte de données est terminé et que le fichier journal a été fermé. Le catalogue peut être mis à jour pendant la collecte de données, mais cela peut perturber le processus de journalisation des données de performances, car la mise à jour des catalogues peut prendre beaucoup de temps.
Les fichiers journaux Perfmon, CSV et TSV n’ont pas de catalogues. La spécification d’un handle pour ces types de fichiers journaux entraîne une valeur de retour de PDH_NOT_IMPLEMENTED.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | pdh.h |
| Bibliothèque | Pdh.lib |
| DLL | Pdh.dll |