estrutura PDH_BROWSE_DLG_CONFIG_HA (pdh.h)

A estrutura PDH_BROWSE_DLG_CONFIG_H é usada pela função PdhBrowseCountersH para configurar a caixa de diálogo Procurar Contadores de Desempenho.

Sintaxe

typedef struct _BrowseDlgConfig_HA {
  DWORD               bIncludeInstanceIndex : 1;
  DWORD               bSingleCounterPerAdd : 1;
  DWORD               bSingleCounterPerDialog : 1;
  DWORD               bLocalCountersOnly : 1;
  DWORD               bWildCardInstances : 1;
  DWORD               bHideDetailBox : 1;
  DWORD               bInitializePath : 1;
  DWORD               bDisableMachineSelection : 1;
  DWORD               bIncludeCostlyObjects : 1;
  DWORD               bShowObjectBrowser : 1;
  DWORD               bReserved : 22;
  HWND                hWndOwner;
  PDH_HLOG            hDataSource;
  LPSTR               szReturnPathBuffer;
  DWORD               cchReturnPathLength;
  CounterPathCallBack pCallBack;
  DWORD_PTR           dwCallBackArg;
  PDH_STATUS          CallBackStatus;
  DWORD               dwDefaultDetailLevel;
  LPSTR               szDialogBoxCaption;
} PDH_BROWSE_DLG_CONFIG_HA, *PPDH_BROWSE_DLG_CONFIG_HA;

Membros

bIncludeInstanceIndex

Se esse sinalizador for TRUE, a caixa de diálogo incluirá um número de índice para nomes de instância duplicados. Por exemplo, se houver duas instâncias cmd, a lista de instâncias conterá cmd e cmd#1. Se esse sinalizador for FALSE, os nomes de instância duplicados não conterão um número de índice.

bSingleCounterPerAdd

Se esse sinalizador for TRUE, a caixa de diálogo retornará apenas um contador. Se esse sinalizador for FALSE, a caixa de diálogo poderá retornar várias seleções e seleções curinga serão permitidas. Os contadores selecionados são retornados como uma cadeia de caracteres MULTI_SZ.

bSingleCounterPerDialog

Se esse sinalizador for TRUE, a caixa de diálogo usará um botão OK e Cancelar. A caixa de diálogo retorna quando o usuário clica em um dos botões. Se esse sinalizador for FALSE, a caixa de diálogo usará um botão Adicionar e Fechar. A caixa de diálogo é fechada quando o usuário clica no botão Fechar. O botão Adicionar pode ser clicado várias vezes. O botão Adicionar substitui os itens selecionados anteriormente com os itens selecionados no momento.

bLocalCountersOnly

Se esse sinalizador for VERDADEIRO, a caixa de diálogo permitirá que o usuário selecione contadores somente no computador local (o caminho não conterá um nome de computador). Se esse sinalizador for FALSE, o usuário poderá especificar um computador do qual selecionar contadores. O nome do computador prefixará o caminho do contador, a menos que o usuário selecione Usar contadores de computador locais.

bWildCardInstances

Se esse sinalizador for verdadeiro e o usuário selecionar Todas as instâncias, o caminho do contador incluirá o caractere curinga para o campo de instância.

Se esse sinalizador for FALSE e o usuário selecionar Todas as instâncias, todas as instâncias encontradas no momento para esse objeto serão retornadas em uma cadeia de caracteres MULTI_SZ.

bHideDetailBox

Se esse sinalizador for TRUE, isso removerá nível de detalhe da caixa de diálogo para que o usuário não possa alterar o nível de detalhes dos contadores exibidos na caixa de diálogo. O nível de detalhes será corrigido para o valor do membro dwDefaultDetailLevel .

Se esse sinalizador for FALSE, isso exibirá nível de detalhes na caixa de diálogo, permitindo que o usuário altere o nível de detalhes dos contadores exibidos.

Observe que os contadores exibidos serão aqueles cujo nível de detalhe é menor ou igual à seleção de nível de detalhes atual. Selecionar um nível de detalhes do Assistente exibirá todos os contadores e objetos.

bInitializePath

Se esse sinalizador for VERDADEIRO, a caixa de diálogo realça o contador e o objeto especificados em szReturnPathBuffer quando a caixa de diálogo é exibida pela primeira vez, em vez de usar o contador e o objeto padrão especificados pelo computador.

Se esse sinalizador for FALSE, isso selecionará o contador e o objeto iniciais usando o contador padrão e as informações de objeto retornadas pelo computador.

bDisableMachineSelection

Se esse sinalizador for TRUE, o usuário não poderá selecionar um computador Selecionar contadores do computador.

Se esse sinalizador for FALSE, o usuário poderá selecionar um computador Selecionar contadores no computador. Esse é o valor padrão. A lista contém o computador local apenas a menos que você chame o PdhConnectMachine para se conectar a outros computadores primeiro.

bIncludeCostlyObjects

Se esse sinalizador for VERDADEIRO, a lista de contadores também conterá dados caros, ou seja, dados que exigem uma quantidade relativamente grande de tempo de processador ou sobrecarga de memória para coletar.

Se esse sinalizador for FALSE, a lista não conterá contadores caros. Esse é o valor padrão.

bShowObjectBrowser

Se esse sinalizador for VERDADEIRO, a caixa de diálogo listará apenas objetos de desempenho. Quando o usuário seleciona um objeto, a caixa de diálogo retorna um caminho de contador que inclui o objeto e caracteres curinga para o nome e o contador da instância se o objeto for um objeto de várias instâncias. Por exemplo, se o objeto "Process" estiver selecionado, a caixa de diálogo retornará a cadeia de caracteres "\Process(*)*". Se o objeto for um único objeto de instância, o caminho conterá apenas um caractere curinga para contador. Por exemplo, "\System*". Em seguida, você pode passar o caminho para PdhExpandWildCardPath para recuperar uma lista de caminhos reais para o objeto.

bReserved

hWndOwner

Identificador da janela para possuir a caixa de diálogo. Se NULL, o proprietário será a área de trabalho.

hDataSource

Manipule para uma fonte de dados retornada pela função PdhBindInputDataSource .

szReturnPathBuffer

Ponteiro para um MULTI_SZ que contém os caminhos de contador selecionados.

Se bInitializePath for VERDADEIRO, você poderá usar esse membro para especificar um caminho de contador cujos componentes são usados para realçar entradas no computador, objeto, contador e listas de instâncias quando a caixa de diálogo for exibida pela primeira vez.

cchReturnPathLength

Tamanho do buffer de szReturnPathBuffer , em TCHARs. Se a função de retorno de chamada realocar um novo buffer, ela também deverá atualizar esse valor.

pCallBack

Ponteiro para a função de retorno de chamada que processa a seleção do usuário. Para obter mais informações, consulte CounterPathCallBack .

dwCallBackArg

Valor definido pelo chamador que é passado para a função de retorno de chamada.

CallBackStatus

Na entrada para a função de retorno de chamada, esse membro contém o status do buffer de caminho. Na saída, a função de retorno de chamada define o valor de status resultante do processamento.

Se o buffer for muito pequeno para carregar a seleção atual, a caixa de diálogo definirá esse valor como PDH_MORE_DATA. Se esse valor for ERROR_SUCCESS, o membro szReturnPathBuffer conterá um caminho de contador válido ou uma lista de caminhos de contador.

Se a função de retorno de chamada realocar um novo buffer, ela deverá definir esse membro como PDH_RETRY para que a caixa de diálogo tente carregar o buffer com os caminhos selecionados e chamar a função de retorno de chamada novamente.

Se algum outro erro ocorreu, a função de retorno de chamada deverá retornar o valor de status de erro PDH apropriado.

dwDefaultDetailLevel

Nível de detalhes padrão a ser mostrado na lista de de nível de Detalhes do se bHideDetailBox estiver false. Se bHideDetailBox for TRUE, a caixa de diálogo usará esse valor para filtrar os objetos e contadores de desempenho exibidos. Você pode especificar um dos seguintes valores:

szDialogBoxCaption

Ponteiro para um cadeia de caracteresterminada nula que especifica a legenda opcional a ser exibida na barra de legendas da caixa de diálogo. Se esse membro estiver NULL, a legenda será Procurar Contadores de Desempenho.

Observações

Sempre que o botão Adicionar for clicado, o buffer szReturnPathBuffer contém o contador selecionado e a função de retorno de chamada pCallBack é chamada. A função de retorno de chamada deve chamar a função PdhAddCounter para cada contador no buffer.

Requisitos

Consulte também

CounterPathCallBack

PdhAddCounter

PdhBindInputDataSource

PdhBrowseCountersH