Função PdhSelectDataSourceA (pdh.h)

Artigo
11/20/2024

Exibe uma janela de diálogo que solicita ao usuário que especifique a fonte dos dados de desempenho.

Sintaxe

PDH_FUNCTION PdhSelectDataSourceA(
  [in]      HWND    hWndOwner,
  [in]      DWORD   dwFlags,
  [out]     LPSTR   szDataSource,
  [in, out] LPDWORD pcchBufferLength
);

Parâmetros

[in] hWndOwner

Proprietário da janela de diálogo. Isso pode ser NULL se não houver proprietário (a área de trabalho se tornará o proprietário).

[in] dwFlags

Caixas de diálogo que serão exibidas para solicitar a fonte de dados. Esse parâmetro pode ser um dos valores a seguir.

Valor	Significado
PDH_FLAGS_FILE_BROWSER_ONLY	Exibir somente o navegador de arquivos. Defina esse sinalizador quando desejar solicitar apenas o nome e o local de um arquivo de log.
0	Exibir a caixa de diálogo de seleção da fonte de dados. A caixa de diálogo permite que o usuário selecione dados de desempenho de um arquivo de log ou de uma fonte em tempo real. Se o usuário especificou que os dados devem ser coletados de um arquivo de log, um navegador de arquivos será exibido para o usuário especificar o nome e o local do arquivo de log.

[out] szDataSource

Buffer alocado pelo chamador que recebe um cadeia de caracteres nulaterminada que contém o nome de um arquivo de log selecionado pelo usuário. O nome do arquivo de log será truncado para o tamanho do buffer se o buffer for muito pequeno.

Se o usuário tiver selecionado uma fonte em tempo real, o buffer estará vazio.

[in, out] pcchBufferLength

Tamanho máximo do buffer de szDataSource, em TCHARs.

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 . Veja a seguir os valores possíveis.

Código de retorno	Descrição
PDH_INVALID_ARGUMENT	O comprimento do buffer passado no pcchBufferLength não é igual ao comprimento real do buffer szDataSource do .
PDH_MEMORY_ALLOCATION_FAILURE	Um buffer de comprimento zero foi passado no parâmetro szDataSource .

Observações

Nota

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

PdhIsRealTimeQuery

Compartilhar via