Compartilhar via


Função PdhBrowseCountersA (pdh.h)

Exibe uma caixa de diálogo Procurar Contadores que o usuário pode usar para selecionar um ou mais contadores que deseja adicionar à consulta.

Para usar identificadores em fontes de dados, use a função PdhBrowseCountersH.

Sintaxe

PDH_FUNCTION PdhBrowseCountersA(
  [in] PPDH_BROWSE_DLG_CONFIG_A pBrowseDlgData
);

Parâmetros

[in] pBrowseDlgData

Uma estrutura PDH_BROWSE_DLG_CONFIG que especifica o comportamento da caixa de diálogo.

Valor de retorno

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 ou um código de erro PDH .

Observações

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

Para obter informações sobre como usar essa função, consulte Contadores de Navegação.

Exemplos

Para obter um exemplo, consulte contadores de desempenho de navegação.

Nota

O cabeçalho pdh.h define PdhBrowseCounters como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho pdh.h
biblioteca Pdh.lib
de DLL Pdh.dll

Consulte também

CounterPathCallBack

PDH_BROWSE_DLG_CONFIG

PdhBrowseCountersH