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


Функция PerfIncrementULongCounterValue (perflib.h)

Увеличивает значение счетчика, значение которого представляет собой 4-байтовое целое число без знака. Поставщики используют эту функцию.

Синтаксис

ULONG PerfIncrementULongCounterValue(
  [in] HANDLE                    Provider,
  [in] PPERF_COUNTERSET_INSTANCE Instance,
  [in] ULONG                     CounterId,
  [in] ULONG                     Value
);

Параметры

[in] Provider

Дескриптор поставщика. Используйте переменную дескриптора, созданную средством CTRPP . Имя переменной см. в атрибуте symbol элемента provider .

Windows Vista: Функция PerfStartProvider возвращает дескриптор.

[in] Instance

Структура PERF_COUNTERSET_INSTANCE , содержащая экземпляр набора счетчиков. Функция PerfCreateInstance возвращает этот указатель.

[in] CounterId

Идентификатор, однозначно определяющий счетчик для обновления в блоке экземпляра. Идентификатор определяется в атрибуте id элемента counter и должен соответствовать члену CounterId одной из PERF_COUNTER_INFO структур в блоке экземпляра. Используйте константу идентификатора счетчика, созданную средством CTRPP . Имя константы см. в атрибуте symbol элемента counter .

Windows Vista: Константы идентификатора счетчика недоступны.

[in] Value

Значение, на которое увеличивается счетчик.

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

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

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

Комментарии

Это удобная функция для увеличения необработанных данных счетчика. Чтобы самостоятельно увеличить необработанные данные счетчика, используйте элемент Offsetструктуры PERF_COUNTER_INFO для доступа к необработанным данным счетчика для конкретного счетчика. Блок структуры PERF_COUNTERSET_INSTANCE содержит одну или несколько информационных структур счетчиков.

Используйте функцию PerfSetULongCounterValue для первоначального задания значения счетчика.

Обратите внимание, что значение счетчика переполняется, когда значение счетчика увеличивается до максимального размера 4-байтового целого числа без знака.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header perflib.h
Библиотека Advapi32.lib
DLL Advapi32.dll

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

PerfDecrementULongCounterValue

PerfIncrementULongLongCounterValue

PerfSetULongCounterValue