DdqGetDiagnosticRecordPage 函数 (diagnosticdataquery.h)

提取 (批量) 筛选记录的页面。 使用 searchCriteria、pageRecordCount、offset 和 baseRowId DIAGNOSTIC_DATA_SEARCH_CRITERIA输入参数对返回的记录执行筛选。

语法

HRESULT DdqGetDiagnosticRecordPage(
  HDIAGNOSTIC_DATA_QUERY_SESSION          hSession,
  DIAGNOSTIC_DATA_SEARCH_CRITERIA * const searchCriteria,
  UINT32                                  offset,
  UINT32                                  pageRecordCount,
  INT64                                   baseRowId,
  HDIAGNOSTIC_RECORD                      *hRecord
);

参数

hSession

类型：诊断数据查询会话的 HANDLE 句柄。

searchCriteria

类型： DIAGNOSTIC_DATA_SEARCH_CRITERIA* 指向包含此操作搜索条件的资源的指针。 此资源包含生成者、类别和标记等条件。

offset

类型： UINT32 通过返回 rowId 从 baseRowId 的偏移量开始的记录来筛选结果。

pageRecordCount

类型： UINT32 所需记录页中的记录数

baseRowId

类型： INT64 仅返回 rowId 值小于或等于 baseRowId 的记录来筛选出新记录 (如果查询代码希望将结果限制为在 DdqGetDiagnosticRecordStats 调用时可用的事件，这非常有用。maxRowId 参数可用作 baseRowId) 。 如果为 baseRowId 传递了 –1，则不应用筛选。

hRecord

类型： HANDLE* 此输出参数是指向包含匹配记录列表的资源句柄的指针。

返回值

类型： HRESULT 在成功完成时返回S_OK。

要求

要求	值
最低受支持的客户端	Windows 10版本 2004 (10.0;内部版本 19041)
最低受支持的服务器	Windows Server 版本 2004 (10.0;内部版本 19041)
标头	diagnosticdataquery.h