Função PdhBindInputDataSourceA (pdh.h)

Artigo
03/05/2024

Associa um ou mais arquivos de log binários para ler dados de log.

Sintaxe

PDH_FUNCTION PdhBindInputDataSourceA(
  [out] PDH_HLOG *phDataSource,
  [in]  LPCSTR   LogFileNameList
);

Parâmetros

[out] phDataSource

Manipule para as fontes de dados associadas.

[in] LogFileNameList

Cadeia de caracteres terminada em nulo que contém um ou mais arquivos de log binários a serem associados. Encerre cada nome de arquivo de log com um caractere de terminador nulo e a lista com um caractere de terminador nulo adicional. Os nomes de arquivo de log podem conter caminhos absolutos ou relativos. Você não pode especificar mais de 32 arquivos de log.

Se FOR NULL, a origem será uma fonte de dados em tempo real.

Retornar valor

Retorna ERROR_SUCCESS se a função for bem-sucedida.

Se a função falhar, o valor retornado será um código de erro do sistema ou um código de erro PDH.

Comentários

Essa função é usada com as funções PDH que exigem um identificador para uma fonte de dados. Para obter uma lista dessas funções, consulte Também.

Não é possível especificar mais de um arquivo CSV (delimitado por vírgulas) ou TSV (delimitado por tabulação). A lista pode conter apenas um tipo de arquivo– você não pode combinar vários tipos de arquivo.

Para fechar os arquivos de log associados, chame a função PdhCloseLog usando o identificador de log.

Observação

O cabeçalho pdh.h define PdhBindInputDataSource como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de 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