Функция PdhBindInputDataSourceA (pdh.h)

Статья
08/25/2023

Связывает один или несколько двоичных файлов журнала для чтения данных журнала.

Синтаксис

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

Параметры

[out] phDataSource

Дескриптор связанных источников данных.

[in] LogFileNameList

Строка, завершающаяся значением NULL, содержащая один или несколько двоичных файлов журнала для привязки. Завершите каждое имя файла журнала символом конца null, а список — одним дополнительным символом конца null. Имена файлов журнала могут содержать абсолютные или относительные пути. Нельзя указать более 32 файлов журнала.

При значении NULL источник является источником данных в режиме реального времени.

Возвращаемое значение

Возвращает ERROR_SUCCESS, если функция выполнена успешно.

Если функция завершается ошибкой, возвращаемым значением является системный код ошибки или код ошибки PDH.

Нельзя указать несколько файлов с разделителями-запятыми (CSV) или табуляции (TSV). Список может содержать только один тип файлов. Вы не можете объединить несколько типов файлов.

Чтобы закрыть связанные файлы журнала, вызовите функцию PdhCloseLog с помощью дескриптора журнала.

Примечание

Заголовок pdh.h определяет PdhBindInputDataSource как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	pdh.h
Библиотека	Pdh.lib
DLL	Pdh.dll