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

Статья
11/20/2024

Собирает данные счетчика для текущего запроса и записывает данные в файл журнала.

Синтаксис

PDH_FUNCTION PdhUpdateLogA(
  [in] PDH_HLOG hLog,
  [in] LPCSTR   szUserString
);

Параметры

[in] hLog

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

[in] szUserString

Строка, завершающая значение NULL, содержащая определяемый пользователем комментарий для добавления в запись данных. Строка не может быть пустой.

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

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

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

Возвращаемый код	Описание
PDH_INVALID_HANDLE	Недопустимый дескриптор файла журнала.
PDH_INVALID_ARGUMENT	Пустая строка была передана в параметре szUserString.

Замечания

При обновлении файла журнала из другого файла журнала комментарии из другого файла журнала не переносятся.

Примеры

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

Заметка

Заголовок pdh.h определяет PdhUpdateLog как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	pdh.h
библиотеки	Pdh.lib
DLL	Pdh.dll

См. также

PdhGetLogFileSize

PdhOpenLog

PdhOpenQuery

PdhUpdateLogFileCatalog

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