Поделиться через

Функция PdhVbGetCounterPathElements

  • Статья

Функция PdhVbGetCounterPathElements анализирует полную строку пути счетчика производительности на отдельные элементы. Каждая из строковых переменных должна иметь одинаковый размер (BufferSize), а также быть измеренными и инициализированными, прежде чем они будут использоваться в этой функции.

Важно!

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

Функция PdhVbGetCounterPathElements( _ ByVal PathString As String, _ ByVal MachineName As String, _ ByVal ObjectName As String, _ ByVal InstanceName As String, _ ByVal ParentInstance As String, _ ByVal CounterName As String, _ ByVal BufferSize As Long _ ) As Long

Параметры

PathString

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

MachineName

Строка для получения имени компьютера.

ObjectName

Строка для получения имени объекта.

InstanceName

Строка для получения имени экземпляра, если используется.

ParentInstance

Строка для получения родительского экземпляра, если используется.

CounterName

Строка для получения имени счетчика.

BufferSize

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

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

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

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

Код возврата Описание
PDH_INVALID_ARGUMENT
 Один или несколько строковых буферов не имеет правильного размера.
PDH_MORE_DATA
 Один или несколько элементов пути счетчика слишком велики для длины возвращаемого буфера.
PDH_MEMORY_ALLOCATION_FAILURE
 Не удалось выделить временный буфер памяти.

Требования

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

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

PdhVbCreateCounterPathList

PdhVbGetCounterPathFromList

PdhVbGetOneCounterPath