擷取已篩選記錄的頁面(批次)。 傳回記錄的篩選會在內部使用 searchCriteria、pageRecordCount、offset 和 baseRowId DIAGNOSTIC_DATA_SEARCH_CRITERIA input 參數來執行。
語法
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。
需求
| Requirement | 價值觀 |
|---|---|
| 最低支援的用戶端 | Windows 10 版本 2004 (10.0;內部版本 19041) |
| 支援的最低伺服器 | Windows Server 2004 版 (10.0;內部版本 19041) |
| Header | diagnosticdataquery.h |
| Library | DiagnosticDataQuery.Lib |