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

Статья
08/25/2023

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

Синтаксис

ULONG PerfDeleteInstance(
  [in] HANDLE                    Provider,
  [in] PPERF_COUNTERSET_INSTANCE InstanceBlock
);

Параметры

[in] Provider

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

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

[in] InstanceBlock

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

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

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

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

Поставщик определяет, когда он удаляет экземпляр. Если данные счетчика являются более статическими, поставщик может удалить экземпляр во время очистки. Например, количество процессоров на компьютере будет считаться статическим, поэтому поставщик, предоставляющий данные счетчика для процессоров, может удалить экземпляр для каждого процессора на компьютере во время очистки. Для более динамических счетчиков, таких как счетчики дисков или процессов, поставщики будут удалять экземпляры в ответ на удаление USB-устройства или завершение процесса.

Требования

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

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

PerfCreateInstance

PerfQueryInstance

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