Contadores de navegação

Para exibir uma caixa de diálogo que lista os objetos de desempenho e os contadores definidos no computador, chame a função PdhBrowseCounters . A caixa de diálogo permite que o usuário navegue e selecione contadores de desempenho. Use a estrutura PDH_BROWSE_DLG_CONFIG para especificar a configuração da caixa de diálogo. Por exemplo, você pode configurar a caixa de diálogo para retornar uma seleção ou várias seleções.

Na entrada, o membro szReturnPathBuffer contém o objeto de desempenho padrão e o contador selecionados na caixa de diálogo. Na saída, o buffer contém o objeto de desempenho e o contador que o usuário selecionou. Você também pode usar o membro pCallBack para especificar uma função de retorno de chamada para processar os nomes de contador retornados pela caixa de diálogo.

Observe que essa caixa de diálogo pode retornar PDH_DIALOG_CANCELLED se bSingleCounterPerDialog for FALSE e o usuário clicar no botão Fechar, portanto, seu tratamento de erro teria que considerar isso.

Para obter um exemplo que usa a função PdhBrowseCounters , consulte Navegando contadores de desempenho.

Para recuperar uma lista de objetos de desempenho no computador, você também pode chamar a função PdhEnumObjects . Para recuperar uma lista de contadores e instâncias de um objeto de desempenho, chame a função PdhEnumObjectItems . Você também pode usar essas funções para identificar os objetos de desempenho e os contadores contidos em um arquivo de log. Chamadas repetidas para PdhEnumObjectItems retornarão a mesma lista de contadores e instâncias até que você chame PdhEnumObjects para atualizar a lista de objetos de desempenho primeiro. Para obter um exemplo que enumera objetos e contadores, consulte Enumerando objetos de processo.

Selecionando a fonte de dados

Você pode usar PdhSelectDataSource em conjunto com PdhBrowseCounters para solicitar que o usuário selecione se a fonte de dados está em tempo real ou em um arquivo de log e, se for um arquivo de log, seu nome. Se você não quiser que a caixa de diálogo de fonte de dados seja exibida, chame PdhSelectDataSource para exibir apenas o catálogo do navegador de arquivos. Para fazer isso, especifique PDH_FLAGS_FILE_BROWSER_ONLY como o segundo parâmetro da chamada para PdhSelectDataSource.