Функция PdhVbUpdateLog

Функция PdhVbUpdateLog обновляет текущий запрос и записывает новые данные в файл журнала. Эта функция вызывает PdhUpdateLog.

Важно!

Функция, описанная в этом разделе, может быть изменена или недоступна в будущем. Вместо этого корпорация Майкрософт рекомендует использовать функции, описанные в разделе Функции счетчиков производительности.

Функция PdhVbUpdateLog( _ ByVal hLog As PDH_HLOG, _ ByVal szUserString As LPCTSTR _ )

Параметры

hLog [in]

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

szUserString [in]

Указатель на строку, указывающую данные, добавляемые в файл журнала. Обычно используется для комментариев в файле журнала.

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

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

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

Код возврата	Описание
PDH_INSUFFICIENT_BUFFER	Запрошенные данные больше, чем предоставленный буфер. Не удается вернуть запрошенные данные.
PDH_INVALID_ARGUMENT	Один или несколько строковых буферов не являются правильным размером.
PDH_INVALID_HANDLE	Дескриптор не является допустимым объектом PDH.
PDH_LOG_FILE_OPEN_ERROR	Не удается открыть указанный файл журнала.
PDH_FILE_NOT_FOUND	Не удается найти указанный файл.

Комментарии

Должен быть открытый запрос, и нужные счетчики должны быть добавлены в него перед вызовом этой функции.

Требования

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

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

PdhUpdateLog

PdhVbGetLogFileSize

PdhVbOpenLog