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


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

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

Синтаксис

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 или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

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

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

PdhGetLogFileSize

PdhOpenLog

PdhOpenQuery

PdhUpdateLogFileCatalog