Compartilhar via


Função PdhBrowseCountersHA (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.

Essa função é idêntica à função PdhBrowseCounters, exceto que dá suporte ao uso de identificadores para fontes de dados.

Sintaxe

PDH_FUNCTION PdhBrowseCountersHA(
  [in] PPDH_BROWSE_DLG_CONFIG_HA pBrowseDlgData
);

Parâmetros

[in] pBrowseDlgData

Uma estrutura PDH_BROWSE_DLG_CONFIG_H 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.

Nota

O cabeçalho pdh.h define PdhBrowseCountersH 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

PDH_BROWSE_DLG_CONFIG_H

PdhBindInputDataSource

PdhEnumMachinesH

PdhEnumObjectItemsH

PdhEnumObjectsH

PdhExpandWildCardPathH

PdhGetDataSourceTimeRangeH

PdhGetDefaultPerfCounterH

PdhGetDefaultPerfObjectH

PdhOpenQueryH