PdhBindInputDataSourceA 函数 (pdh.h)

项目
03/04/2024

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

语法

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

参数

[out] phDataSource

绑定数据源的句柄。

[in] LogFileNameList

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

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

返回值

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

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

注解

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

不能指定多个逗号分隔 (CSV) 或制表符分隔 (TSV) 文件。该列表只能包含一种类型的文件-不能组合多个文件类型。

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

注意

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

要求

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