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

Удаляет указанные спецификации счетчика производительности из указанного запроса.

Синтаксис

ULONG PerfDeleteCounters(
  [in]      HANDLE                   hQuery,
  [in, out] PPERF_COUNTER_IDENTIFIER pCounters,
            DWORD                    cbCounters
);

Параметры

[in] hQuery

Дескриптор запроса, из которого требуется удалить спецификации счетчика производительности.

[in, out] pCounters

Указатель на спецификации счетчика производительности, которые требуется удалить.

cbCounters

Размер буфера, указанного параметром pCounters , в байтах.

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

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

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

Комментарии

Параметр pCounters должен указывать на последовательность PERF_COUNTER_IDENTIFIER блоков. Каждый PERF_COUNTER_IDENTIFIER блок состоит из PERF_COUNTER_IDENTIFIER структуры, за которой при необходимости следует строка имени экземпляра UTF-16LE, завершающаяся null, и заполнение, которое делает размер блока кратным 8 байтам.

Настройте каждый блок PERF_COUNTER_IDENTIFIER так же, как описано в разделе Примечания для PerfAddCounters.

PerfDeleteCounters пытается удалить одну спецификацию счетчика из запроса для каждого блока PERF_COUNTER_IDENTIFIER и обновляет элемент Status структуры PERF_COUNTER_IDENTIFIER в каждом блоке с учетом результата попытки.

Требования

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

PERF_COUNTER_IDENTIFIER

PerfAddCounters