DdqGetDiagnosticRecordPage-Funktion (diagnosticdataquery.h)

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

Syntax

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

Die Parameter

hSession

Typ: Handle Handle to the Diagnostic Data Query session.

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 Produzenten, Kategorien und Tags.

offset

Typ: UINT32 Filtert Ergebnisse, indem Datensätze mit rowId zurückgegeben werden, die mit dem 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 mit zeilen-ID-Wert kleiner oder gleich baseRowId zurückgegeben werden (dies ist nützlich, wenn das Abfragen von Code Ergebnisse auf Ereignisse beschränken möchte, die zum Zeitpunkt des DdqGetDiagnosticRecordStats-Aufrufs verfügbar waren. Der parameter maxRowId kann als baseRowId verwendet werden. Es wird keine Filterung angewendet, wenn "-1" für baseRowId übergeben wird.

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 S_OK nach erfolgreichem Abschluss zurück.

Anforderungen