Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Функция 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. Ниже приведены возможные значения.
| Код возврата | Описание |
|---|---|
|
Один или несколько аргументов являются недопустимыми или неправильными. |
|
Не удалось выделить буфер памяти. |
|
Недопустимый дескриптор запроса. |
|
Указанный счетчик не найден. |
|
Не удалось найти указанный объект. |
|
Не удалось создать запись компьютера. |
|
Передана пустая строка пути к имени счетчика. |
|
Не удалось определить функцию вычисления для этого счетчика. |
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows XP [только классические приложения] |
| Минимальная версия сервера |
Windows Server 2003 [только классические приложения] |
| Библиотека |
|
| DLL |
|