Função PdhSelectDataSourceA (pdh.h)

  • Artigo

Exibe uma janela de diálogo que solicita que o usuário especifique a origem 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 poderá 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 usar um dos valores a seguir.

Valor Significado
PDH_FLAGS_FILE_BROWSER_ONLY
 Exibir somente o navegador de arquivos. Defina esse sinalizador quando quiser 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 uma cadeia de caracteres terminada em nulo 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 szDataSource , em TCHARs.

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. 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 .
PDH_MEMORY_ALLOCATION_FAILURE
 Um buffer de comprimento zero foi passado no parâmetro szDataSource .

Comentários

Observação

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

Confira também

PdhIsRealTimeQuery