Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.
Übersetzung
Original

JetGetThreadStats-Funktion

Letzte Änderung: Freitag, 27. Februar 2015

Gilt für: Windows | Windows Server

Die JetGetThreadStats -Funktion ruft Performance-Informationen über die Datenbank-Engine für den aktuellen Thread. Mehrere Aufrufe dienen zum Sammeln von Statistiken, die die Aktivität des Datenbankmoduls auf diesem Thread zwischen den Aufrufen widerspiegeln.

Windows Vista:  JetGetThreadStats wird in Windows Vista eingeführt.

JET_ERR JET_API JetGetThreadStats(
  __out         void* pvResult,
  __in          unsigned long cbMax
);

Parameter

pvResult

Der Ausgabepuffer, der Thread-Statistik-Daten empfängt. Der Puffer enthält eine JET_THREADSTATS -Struktur nach einem erfolgreichen Aufruf.

cbMax

Die maximale Größe des Ausgabepuffers in Bytes.

Return Value

Diese Funktion gibt den Datentyp der JET_ERR mit einem der folgenden Rückgabecodes. Weitere Informationen zu den möglichen ESE-Fehlern finden Sie unter Extensible Storage Engine-Fehler und Fehler behandeln Parameter.

Rückgabecode

Beschreibung

JET_errSuccess

Der Vorgang wurde erfolgreich abgeschlossen.

JET_errBufferTooSmall

Der Vorgang ist fehlgeschlagen, da der bereitgestellte Ausgabepuffer zu klein für die angeforderten Daten enthalten war. Die JetGetThreadStats -Funktion gibt diesen Fehler zurück, wenn der Ausgabepuffer zu klein für die kleinste Version der JET_THREADSTATS -Struktur, die von der Datenbank-Engine unterstützt wird.

Bei Erfolg enthält der Ausgabepuffer eine JET_THREADSTATS -Struktur, die Datenbank-Engine-Statistik für den aktuellen Thread enthält.

Bei einem Fehler ist der Zustand des Ausgabepuffers undefiniert.

Anmerkungen

Die Angaben von zwei aufeinander folgenden Aufrufen dieser API sollen verwendet werden, um die Ausgaben für andere Engine Datenbankvorgänge für den aktuellen Thread zu berechnen. Dies geschieht in der Regel mit einer vor und nach dem Lesen der Statistiken und die Anzahl die nach dem vom Subtrahieren der bevor Count, um die net Anzahl von Operationen ausgeführt.

Eine Anwendung könnte z. B. JetGetThreadStats einmal aufrufen, um einen Ausgangswert der Statistiken für den aktuellen Thread abzurufen. Sie konnte mit der cRow -Parameter auf JET_MoveNext festgelegt, um mit dem nächsten Indexeintrag für einen Index verschieben dann die Funktion JetMove aufrufen. Sie können dann JetGetThreadStats erneut aus, um einen anderen Lesevorgang von Statistiken für den Thread aufrufen. Es konnte dann den Leistungsindikator cPageReferenced aus der zweiten Lesung vom ersten subtrahieren. Das Ergebnis wäre die Anzahl der Datenbankseiten, die vom Datenbankmodul zum Ausführen des Vorgangs JetMove verwiesen wird.

Die Statistik für jeden Thread werden während der Lebensdauer des betreffenden Threads angefügt. Die Statistik wird zurückgesetzt, wenn das Datenbankmodul DLL vom Hostprozess wird.

Die JET_THREADSTATS -Struktur wird wahrscheinlich in der Zukunft erweitert um weitere Statistiken enthalten. Neue Statistiken werden am Ende der Struktur hinzugefügt werden und mit einer erhöhten Ausgabepuffergröße abgerufen werden können. Das Vorhandensein von zusätzlichen statistischen kann durch einen höheren Wert für die CbStruct abgeleitet werden.

Voraussetzungen

-Client,

Ist Windows Vista erforderlich.

Server

Erfordert WindowsServer 2008.

Kopfzeile

In Esent.h deklariert.

Library

Verwenden Sie ESENT.lib.

DLL

"ESENT.dll" erfordert.

Siehe auch

Anzeigen:
© 2015 Microsoft