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.

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

Comentários

Observe que a caixa de diálogo pode retornar PDH_DIALOG_CANCELLED se bSingleCounterPerDialog for 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.

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho pdh.h
Biblioteca Pdh.lib
DLL Pdh.dll

Confira também

CounterPathCallBack

PDH_BROWSE_DLG_CONFIG

PdhBrowseCountersH