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

Статья
08/25/2023

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

Синтаксис

ULONG PerfSetULongCounterValue(
  [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

Новое значение 4-байтового счетчика.

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

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

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

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

Для увеличения или уменьшения значения счетчика можно использовать функции PerfIncrementULongCounterValue и PerfDecrementULongCounterValue соответственно.

Требования

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

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

PerfDecrementULongCounterValue

PerfIncrementULongCounterValue

PerfSetCounterRefValue

PerfSetULongLongCounterValue