DdqGetDiagnosticRecordPage 函式 (diagnosticdataquery.h)
擷取分頁 (篩選記錄的批次) 。 在內部使用 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
類型: 處理 診斷數據查詢會話的句柄。
searchCriteria
類型: DIAGNOSTIC_DATA_SEARCH_CRITERIA* 資源指標,其中包含此作業的搜尋準則。 此資源包含產生者、類別和標籤等準則。
offset
類型: UINT32 傳回從baseRowId位移開始的rowId記錄來篩選結果。
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 |