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
| 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] |
| Cabeçalho | pdh.h |