擷取篩選的事件文字記錄診斷數據記錄統計數據。傳回統計數據的篩選是使用輸入參數來執行,DIAGNOSTIC_DATA_SEARCH_CRITERIA篩選。 記錄狀態描述有多少記錄符合搜尋準則,並傳回用於進一步查詢數據的參數。 此 API 的其中一個用法是檢查上次查詢數據之後是否有變更。 輸出參數中的變更表示事件文字記錄狀態的狀態變更。
語法
HRESULT DdqGetDiagnosticRecordStats(
HDIAGNOSTIC_DATA_QUERY_SESSION hSession,
DIAGNOSTIC_DATA_SEARCH_CRITERIA const *searchCriteria,
UINT32 *recordCount,
INT64 *minRowId,
INT64 *maxRowId
);
參數
hSession
類型:診斷資料查詢會話的 HANDLE 控制碼。
searchCriteria
類型: DIAGNOSTIC_DATA_SEARCH_CRITERIA* 包含此作業搜尋準則之資源的指標。 此資源包含生產者、類別和標籤等條件。
recordCount
類型: UINT32* 此輸出參數是符合搜尋準則之記錄數目的指標。
minRowId
類型: INT64* 此輸出參數是指向符合搜尋準則之記錄最小列 ID 的指標。
maxRowId
類型: INT64* 此輸出參數是符合搜尋準則之記錄之列 ID 上限的指標。
返回值
類型: HRESULT 成功完成時傳回S_OK。
需求
| Requirement | 價值觀 |
|---|---|
| 最低支援的用戶端 | Windows 10 版本 2004 (10.0;內部版本 19041) |
| 支援的最低伺服器 | Windows Server 2004 版 (10.0;內部版本 19041) |
| Header | diagnosticdataquery.h |
| Library | DiagnosticDataQuery.Lib |