Функция PerfDeleteInstance (perflib.h)
Удаляет экземпляр набора счетчиков, созданный функцией 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 |