DdqGetDiagnosticRecordStats-Funktion (diagnosticdataquery.h)

Ruft die gefilterten Ereignistranskript-Diagnosedatensatzstatistiken ab. Die Filterung nach zurückgegebenen Statistiken erfolgt mithilfe des Eingabeparameters DIAGNOSTIC_DATA_SEARCH_CRITERIA Filters. Der Datensatzstatus beschreibt, wie viele Datensätze verfügbar sind, die den Suchkriterien entsprechen, und gibt Parameter zurück, die für weitere Abfragen von Daten verwendet werden. Eine der Verwendungsmöglichkeiten dieser API besteht darin, zu überprüfen, ob seit der letzten Datenabfrage nach Änderungen vorgenommen wurde. Eine Änderung der Ausgabeparameter weist auf eine Änderung des Zustands des Ereignistranskriptdatensatzes hin.

Syntax

HRESULT DdqGetDiagnosticRecordStats(
  HDIAGNOSTIC_DATA_QUERY_SESSION        hSession,
  DIAGNOSTIC_DATA_SEARCH_CRITERIA const *searchCriteria,
  UINT32                                *recordCount,
  INT64                                 *minRowId,
  INT64                                 *maxRowId
);

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

recordCount

Typ: UINT32* Dieser Ausgabeparameter ist der Zeiger auf die Anzahl der Datensätze, die für die Suchkriterien übereinstimmen.

minRowId

Typ: INT64* Dieser Ausgabeparameter ist der Zeiger auf die Minimale Zeilen-ID des Datensatzes, der für die Suchkriterien entspricht.

maxRowId

Typ: INT64* Dieser Ausgabeparameter ist der Zeiger auf die maximale Zeilen-ID des Datensatzes, der nach den Suchkriterien übereinstimmt.

Rückgabewert

Typ: HRESULT gibt S_OK zurück, wenn der Abschluss erfolgreich abgeschlossen wurde.

Anforderungen