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

Статья
03/05/2024

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

Синтаксис

PDH_FUNCTION PdhUpdateLogW(
  [in] PDH_HLOG hLog,
  [in] LPCWSTR  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