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

Статья
11/20/2024

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

Синтаксис

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

Параметры

[out] phDataSource

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

[in] LogFileNameList

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

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

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

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

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

Замечания

Эта функция используется с функциями PDH, которые требуют дескриптора к источнику данных. Список этих функций см. в разделе "Также".

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

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

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	pdh.h
библиотеки	Pdh.lib
DLL	Pdh.dll