Função PerfDeleteInstance (perflib.h)
Exclui uma instância do conjunto de contadores criado pela função PerfCreateInstance . Os provedores usam essa função.
Sintaxe
ULONG PerfDeleteInstance(
[in] HANDLE Provider,
[in] PPERF_COUNTERSET_INSTANCE InstanceBlock
);
Parâmetros
[in] Provider
O identificador do provedor. Use a variável de identificador gerada pela ferramenta CTRPP para você. Para obter o nome da variável, consulte o atributo de símbolo do elemento provider .
Windows Vista: A função PerfStartProvider retorna o identificador.
[in] InstanceBlock
Uma estrutura PERF_COUNTERSET_INSTANCE que contém a instância do contador definida para excluir.
Retornar valor
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
Se o processo do provedor for encerrado anormalmente, todas as instâncias alocadas serão liberadas.
O provedor determina quando exclui uma instância. Se os dados do contador forem mais estáticos, o provedor poderá excluir uma instância no momento da limpeza. Por exemplo, o número de processadores em um computador seria considerado estático, portanto, um provedor que fornece dados de contador para processadores poderia excluir uma instância para cada processador no computador no momento da limpeza. Para contadores mais dinâmicos, como contadores de disco ou de processo, os provedores excluiriam as instâncias em resposta a um dispositivo USB sendo removido ou um processo sendo encerrado.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | perflib.h |
| Biblioteca | Advapi32.lib |
| DLL | Advapi32.dll |