JetPrereadIndexRanges-Funktion

  • Artikel

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