pdhGetDataSourceTimeRangeH 函数 (pdh.h)
确定时间范围、条目数以及包含指定输入源中性能数据的缓冲区的大小(如果适用)。
此函数与 PdhGetDataSourceTimeRange 函数相同,只不过它支持对数据源使用句柄。
语法
PDH_FUNCTION PdhGetDataSourceTimeRangeH(
[in] PDH_HLOG hDataSource,
[out] LPDWORD pdwNumEntries,
[out] PPDH_TIME_INFO pInfo,
[in] LPDWORD pdwBufferSize
);
参数
[in] hDataSource
PdhBindInputDataSource 函数返回的数据源的句柄。
[out] pdwNumEntries
pInfo 缓冲区中的结构数。 此函数仅收集一个时间范围的信息,因此,如果发生错误,该值通常为 1 或零。
[out] pInfo
接收时间范围的 PDH_TIME_INFO 结构。 该信息跨越所有绑定的日志文件。
[in] pdwBufferSize
PDH_TIME_INFO 结构的大小(以字节为单位)。
返回值
如果函数成功,则返回ERROR_SUCCESS。
如果函数失败,则返回值为 系统错误代码 或 PDH 错误代码。 以下是可能的值。
返回代码 | 说明 |
---|---|
|
参数无效或格式不正确。 |
|
计数器句柄无效。 |
|
当前数据源是实时数据源。 |
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | pdh.h |
Library | Pdh.lib |
DLL | Pdh.dll |