Função PdhBrowseCountersHW (pdh.h)

Artigo
03/01/2024

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 ela dá suporte ao uso de identificadores para fontes de dados.

Sintaxe

PDH_FUNCTION PdhBrowseCountersHW(
  [in] PPDH_BROWSE_DLG_CONFIG_HW pBrowseDlgData
);

Parâmetros

[in] pBrowseDlgData

Uma estrutura PDH_BROWSE_DLG_CONFIG_H 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, seu tratamento de erro teria que considerar isso.

Observação

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 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