Compartilhar via


Função PdhBindInputDataSourceA (pdh.h)

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 pornulo que contém um ou mais arquivos de log binários a serem associados. Encerre cada nome de arquivo de log com um caractere nulo-terminator e a lista com um caractere nulo-terminator. Os nomes de arquivo de log podem conter caminhos absolutos ou relativos. Não é possível especificar mais de 32 arquivos de log.

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

Valor de retorno

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 .

Observações

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.

Nota

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

PdhBrowseCountersH

PdhEnumMachinesH

PdhEnumObjectItemsH

PdhEnumObjectsH

PdhExpandWildCardPathH

PdhGetDataSourceTimeRangeH

PdhGetDefaultPerfCounterH

PdhGetDefaultPerfObjectH

PdhOpenQueryH