Функция 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