Fonction PdhUpdateLogFileCatalog (pdh.h)

  • Article

Synchronise les informations du catalogue de fichiers journaux avec les données de performances dans le fichier journal.

Note Cette fonction est obsolète.
 

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
PDH_NOT_IMPLEMENTED
 Un handle dans un fichier journal CSV ou TSV a été spécifié. Ces types de fichiers journaux n’ont pas de catalogues.
PDH_UNKNOWN_LOG_FORMAT
 Un handle dans un fichier journal au format inconnu a été spécifié.
PDH_INVALID_HANDLE
 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

Voir aussi

PdhGetLogFileSize

PdhUpdateLog