Funzione PerfDeleteCounters (perflib.h)

Rimuove le specifiche del contatore delle prestazioni specificate dalla query specificata.

Sintassi

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

Parametri

[in] hQuery

Handle per la query da cui si desidera rimuovere le specifiche del contatore delle prestazioni.

[in, out] pCounters

Puntatore alle specifiche del contatore delle prestazioni da rimuovere.

cbCounters

Dimensione del buffer specificata dal parametro pCounters , espressa in byte.

Valore restituito

Se la funzione ha esito positivo, restituisce ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema.

Commenti

Il parametro pCounters deve puntare a una sequenza di blocchi PERF_COUNTER_IDENTIFIER . Ogni blocco PERF_COUNTER_IDENTIFIER è costituito da una struttura PERF_COUNTER_IDENTIFIER , seguita facoltativamente da una stringa del nome dell'istanza UTF-16LE con terminazione Null, seguita dalla spaziatura interna che rende le dimensioni del blocco un multiplo di 8 byte.

Configurare ogni blocco di PERF_COUNTER_IDENTIFIER nello stesso modo descritto in Osservazioni per PerfAddCounters.

PerfDeleteCounters tenta di rimuovere una specifica del contatore dalla query per ogni blocco PERF_COUNTER_IDENTIFIER e aggiorna il membro Status della struttura PERF_COUNTER_IDENTIFIER in ogni blocco con il risultato del tentativo.

Requisiti

Vedi anche

PERF_COUNTER_IDENTIFIER

PerfAddCounters