JetPrereadIndexRanges-Funktion

Artikel
06/13/2023

Gilt für: Windows | Windows Server

Die JetPrereadIndexRanges-Funktion liest Indizes vor, um die Leistung zu verbessern.

Die JetPrereadIndexRanges-Funktion wurde im Windows 8 Betriebssystem eingeführt.

JET_ERR JetPrereadIndexRanges(
  __in          const JET_SESID sesid,
  __in          const JET_TABLEID tableid,
  __in_ecount(cIndexRanges)  const JET_INDEX_RANGE* const rgIndexRanges,
  __in          const unsigned long cIndexRanges,
  __out_opt     unsigned long* const pcRangesPreread,
  __in_ecount(ccolumnidPreread)  const JET_COLUMNID* const rgcolumnidPreread,
  __in          const unsigned long ccolumnidPreread,
  __in          const JET_GRBIT grbit
);

Parameter

sesid

Der Datenbanksitzungskontext, der für den API-Aufruf verwendet werden soll.

tableid

Die Tabelle, für die die Prereads ausgeführt werden sollen.

rgIndexRanges

Der Schlüsselbereich, der vorab gelesen werden soll.

cIndexRanges

Die Anzahl der zu lesenden Schlüsselbereiche, die durch die Anzahl der Elemente in rgIndexRanges bestimmt wird.

pcRangesPreread

Die Anzahl der Schlüsselbereiche, die tatsächlich vorab gelesen wurden.

rgcolumnidPreread

Liste der Spalten-IDs für Spalten mit langen Werten, die vorab gelesen werden sollen. Standardmäßig ist nur der On-Page-Datensatz vorab gelesen. Wenn Offpage-Spalten mit langen Werten vorab gelesen werden müssen, müssen ihre Spalten-IDs über diesen Parameter übergeben werden.

ccolumnidPreread

Die Anzahl der Spalten-IDs für Spalten mit langen Werten, die vorab gelesen werden sollen, bestimmt durch die Anzahl der Elemente in rgcolumnidPreread.

grbit

Eine Gruppe von Bits, die null oder mehr der in der folgenden Tabelle aufgeführten Werte für die Vorleserichtung angibt.

Wert	Bedeutung
Weiter	Vorab gelesen.
Rückwärts	Vorab gelesen.
FirstPageOnly	Lesen Sie nur die erste Seite einer langen Spalte vor.
NormalizedKey	Normalisierter Schlüssel/Lesezeichen anstelle des Spaltenwerts.

Rückgabewert

Diese Funktion gibt den Datentyp JET_ERR mit einem der in der folgenden Tabelle aufgeführten Rückgabecodes zurück. Weitere Informationen zu möglichen Ese-Fehlern (Extensible Storage Engine) finden Sie unter Fehler der erweiterbaren Speicher-Engine und Fehlerbehandlungsparameter.

Rückgabecode	Beschreibung
JET_errSuccess	Der Vorgang wurde erfolgreich abgeschlossen.

Bemerkungen

Wenn sich die Datensätze mit den angegebenen Schlüsselbereichen nicht im Puffercache befinden, sollten Sie mit asynchronen Lesevorgängen beginnen, um die Datensätze in den Datenbankpuffercache zu bringen.

Anforderungen

Anforderung	Wert
Client	Erfordert Windows 8.
Server	Erfordert Windows Server 2012.
Kopfzeile	Deklariert in Esent.h.
Bibliothek	Verwenden Sie ESENT.lib.
DLL	Erfordert ESENT.dll.

Siehe auch

JET_ERR

Freigeben über