estrutura PDH_BROWSE_DLG_CONFIG_A (pdh.h)

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

Sintaxe

typedef struct _BrowseDlgConfig_A {
  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;
  LPSTR               szDataSource;
  LPSTR               szReturnPathBuffer;
  DWORD               cchReturnPathLength;
  CounterPathCallBack pCallBack;
  DWORD_PTR           dwCallBackArg;
  PDH_STATUS          CallBackStatus;
  DWORD               dwDefaultDetailLevel;
  LPSTR               szDialogBoxCaption;
} PDH_BROWSE_DLG_CONFIG_A, *PPDH_BROWSE_DLG_CONFIG_A;

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 de 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 de 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 qualquer 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 TRUE, 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 no 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 TRUE e o usuário selecionar Todas as instâncias, o caminho do contador incluirá o caractere curinga do 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á o 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á fixo para o valor do membro dwDefaultDetailLevel .

Se esse sinalizador for FALSE, isso exibirá o 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 detalhe atual. Selecionar um nível de detalhes do Assistente exibirá todos os contadores e objetos.

bInitializePath

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

Se esse sinalizador for FALSE, isso selecionará o contador inicial e o objeto 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 em Selecionar contadores do computador.

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

bIncludeCostlyObjects

Se esse sinalizador for TRUE, 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 TRUE, 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 da instância e contador 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á um caractere curinga somente 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.

szDataSource

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do arquivo de log do qual a lista de contadores é recuperada. Se FOR NULL, a lista de contadores será recuperada do computador local (ou do computador remoto, se especificado).

szReturnPathBuffer

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

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

cchReturnPathLength

Tamanho do buffer 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 da 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 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 tiver ocorrido, a função de retorno de chamada deverá retornar o erro PDH apropriado status valor.

dwDefaultDetailLevel

Nível de detalhes padrão a ser mostrado na lista Nível de detalhes se bHideDetailBox for FALSE. Se bHideDetailBox for TRUE, a caixa de diálogo usará esse valor para filtrar os objetos e contadores de desempenho exibidos. É possível especificar um dos seguintes valores:

szDialogBoxCaption

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o legenda opcional a ser exibido na barra de legenda da caixa de diálogo. Se esse membro for NULL, o legenda será Procurar Contadores de Desempenho.

Comentários

Sempre que o botão Adicionar é 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

Confira também

CounterPathCallBack

PdhAddCounter

PdhBrowseCounters