Compartilhar via


Função PerfDeleteCounters (perflib.h)

Remove as especificações do contador de desempenho da consulta especificada.

Sintaxe

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

Parâmetros

[in] hQuery

Um identificador para a consulta da qual você deseja remover as especificações do contador de desempenho.

[in, out] pCounters

Um ponteiro para as especificações do contador de desempenho que você deseja remover.

cbCounters

O tamanho do buffer especificado pelo parâmetro pCounters , em bytes.

Valor retornado

Se a função for bem-sucedida, ela retornará ERROR_SUCCESS.

Se a função falhar, o valor retornado será um código de erro do sistema.

Comentários

O parâmetro pCounters deve apontar para uma sequência de blocos de PERF_COUNTER_IDENTIFIER . Cada bloco PERF_COUNTER_IDENTIFIER consiste em uma estrutura PERF_COUNTER_IDENTIFIER , opcionalmente seguida por uma cadeia de caracteres de nome de instância UTF-16LE terminada em nulo, seguida por preenchimento que torna o tamanho do bloco um múltiplo de 8 bytes.

Configure cada bloco PERF_COUNTER_IDENTIFIER da mesma forma que descrito nos Comentários de PerfAddCounters.

PerfDeleteCounters tenta remover uma especificação de contador da consulta para cada bloco PERF_COUNTER_IDENTIFIER e atualiza o membro Status da estrutura PERF_COUNTER_IDENTIFIER em cada bloco com o resultado da tentativa.

Requisitos

   
Cliente mínimo com suporte Windows 10, versão 1607 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2016 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho perflib.h
Biblioteca AdvAPI32.lib
DLL AdvAPI32.dll

Confira também

PERF_COUNTER_IDENTIFIER

PerfAddCounters