Функция PdhVbAddCounter

Функция PdhVbAddCounter создает запись счетчика в указанном объекте запроса и возвращает дескриптор для этого счетчика после успешного завершения.

Важно!

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

Функция PdhVbAddCounter( _ ByVal QueryHandle As Long, _ ByVal CounterPath as string, _ ByVal CounterHandle as long _ ) As Long

Параметры

QueryHandle

Идентификатор запроса, которому требуется назначить этот счетчик. Это значение возвращается функцией PdhVbOpenQuery .

CounterPath

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

CounterHandle

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

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

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

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

Код возврата	Описание
PDH_INVALID_ARGUMENT	Один или несколько аргументов являются недопустимыми или неправильными.
PDH_MEMORY_ALLOCATION_FAILURE	Не удалось выделить буфер памяти.
PDH_INVALID_HANDLE	Недопустимый дескриптор запроса.
PDH_CSTATUS_NO_COUNTER	Указанный счетчик не найден.
PDH_CSTATUS_NO_OBJECT	Не удалось найти указанный объект.
PDH_CSTATUS_NO_MACHINE	Не удалось создать запись компьютера.
PDH_CSTATUS_BAD_COUNTERNAME	Передана пустая строка пути к имени счетчика.
PDH_FUNCTION_NOT_FOUND	Не удалось определить функцию вычисления для этого счетчика.

Требования

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

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

PdhVbOpenQuery