Функция PdhUpdateLogA (pdh.h)
Собирает данные счетчика для текущего запроса и записывает данные в файл журнала.
Синтаксис
PDH_FUNCTION PdhUpdateLogA(
[in] PDH_HLOG hLog,
[in] LPCSTR szUserString
);
Параметры
[in] hLog
Дескриптор одного обновляемого файла журнала. Функция PdhOpenLog возвращает этот дескриптор.
[in] szUserString
Строка, завершающаяся значением NULL, содержащая определяемый пользователем комментарий для добавления в запись данных. Строка не может быть пустой.
Возвращаемое значение
Если функция выполняется успешно, она возвращает ERROR_SUCCESS.
Если функция завершается ошибкой, возвращаемым значением является системный код ошибки или код ошибки PDH. Ниже приведены возможные значения.
| Код возврата | Описание |
|---|---|
|
Недопустимый дескриптор файла журнала. |
|
Пустая строка передана в параметре szUserString . |
Комментарии
При обновлении файла журнала из другого файла журнала комментарии из другого файла журнала не переносятся.
Примеры
Пример см. в разделе Запись данных о производительности в файл журнала.
Примечание
Заголовок pdh.h определяет PdhUpdateLog как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | pdh.h |
| Библиотека | Pdh.lib |
| DLL | Pdh.dll |