Поделиться через

Функция PdhUpdateLogFileCatalog (pdh.h)

  • Статья

Синхронизирует сведения в каталоге файлов журнала с данными о производительности в файле журнала.

Примечание Эта функция устарела.
 

Синтаксис

PDH_FUNCTION PdhUpdateLogFileCatalog(
  [in] PDH_HLOG hLog
);

Параметры

[in] hLog

Дескриптор файла журнала, содержащего каталог файлов для обновления. Функция PdhOpenLog .

Возвращаемое значение

Если функция выполняется успешно, она возвращает ERROR_SUCCESS.

Если функция завершается ошибкой, возвращаемым значением является системный код ошибки или код ошибки PDH. Ниже приведены возможные значения.

Код возврата Описание
PDH_NOT_IMPLEMENTED
 Указан дескриптор файла журнала CSV или TSV. Эти типы файлов журналов не имеют каталогов.
PDH_UNKNOWN_LOG_FORMAT
 Указан дескриптор файла журнала в неизвестном формате.
PDH_INVALID_HANDLE
 Недопустимый дескриптор.

Комментарии

Каталог файлов журнала служит индексом для записей данных о производительности в файле журнала, обеспечивая более быстрый поиск отдельных записей в файле.

Каталоги должны обновляться после завершения процесса сбора данных и закрытия файла журнала. Каталог можно обновить во время сбора данных, но это может нарушить процесс ведения журнала данных о производительности, так как обновление каталогов может занять много времени.

Файлы журналов Perfmon, CSV и TSV не имеют каталогов. Указание дескриптора для этих типов файлов журнала приведет к возврату значения PDH_NOT_IMPLEMENTED.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header pdh.h
Библиотека Pdh.lib
DLL Pdh.dll

См. также раздел

PdhGetLogFileSize

PdhUpdateLog