DdqGetDiagnosticRecordPage-Funktion (diagnosticdataquery.h)

Ruft eine Seite (Batch) gefilterter Datensätze ab. Die Filterung nach zurückgegebenen Datensätzen erfolgt intern mithilfe der Eingabeparameter DIAGNOSTIC_DATA_SEARCH_CRITERIA searchCriteria, pageRecordCount, offset und baseRowId.

Syntax

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

Parameter

hSession

Typ: HANDLE-Handle für die Diagnosedatenabfragesitzung.

searchCriteria

Typ: DIAGNOSTIC_DATA_SEARCH_CRITERIA* Zeiger auf die Ressource, die die Suchkriterien für diesen Vorgang enthält. Diese Ressource enthält Kriterien wie Producer, Kategorien und Tags.

offset

Typ: UINT32 Filtert Ergebnisse, indem Datensätze mit rowId zurückgegeben werden, die am Offset von baseRowId beginnen.

pageRecordCount

Typ: UINT32 Die Anzahl der Datensätze auf einer gewünschten Datensatzseite

baseRowId

Typ: INT64 Filtert neue Datensätze aus, indem nur Datensätze zurückgegeben werden, deren rowId-Wert kleiner oder gleich baseRowId ist (dies ist nützlich, wenn der Abfragecode die Ergebnisse nur auf Ereignisse beschränken möchte, die zum Zeitpunkt des DdqGetDiagnosticRecordStats-Aufrufs verfügbar waren. Der maxRowId-Parameter kann als baseRowId verwendet werden. Wenn "-1" für baseRowId übergeben wird, wird keine Filterung angewendet.

hRecord

Typ: HANDLE* Dieser Ausgabeparameter ist ein Zeiger auf das Handle für die Ressource, die die Liste der übereinstimmenden Datensätze enthält.

Rückgabewert

Typ: HRESULT Gibt bei erfolgreichem Abschluss S_OK zurück.

Anforderungen