PdhBindInputDataSourceA 函数（pdh.h）

项目
11/20/2024

将一个或多个二进制日志文件绑定在一起，以便读取日志数据。

语法

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

参数

[out] phDataSource

绑定到绑定数据源的句柄。

[in] LogFileNameList

Null-terminated 字符串，其中包含一个或多个要绑定的二进制日志文件。使用 null-terminateor 字符终止每个日志文件名，并使用另外一个 null-terminateor 字符终止列表。日志文件名称可以包含绝对路径或相对路径。不能指定超过 32 个日志文件。

如果 NULL，则源是实时数据源。

返回值

如果函数成功，则返回ERROR_SUCCESS。

如果函数失败，则返回值为系统错误代码或 PDH 错误代码。

言论

此函数与需要数据源句柄的 PDH 函数一起使用。有关这些函数的列表，请参阅“另请参阅”。

不能指定多个逗号分隔（CSV）或制表符分隔的（TSV）文件。该列表只能包含一种类型的文件，不能合并多个文件类型。

若要关闭绑定的日志文件，请使用日志句柄调用 PdhCloseLog 函数。

注意

pdh.h 标头将 PdhBindInputDataSource 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。

要求

要求	价值
最低支持的客户端	Windows XP [仅限桌面应用]
支持的最低服务器	Windows Server 2003 [仅限桌面应用]
目标平台	窗户
标头	pdh.h
库	Pdh.lib
DLL	Pdh.dll