JetPrereadIndexRanges-Funktion

Gilt für: Windows | Windows Server

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

Die JetPrereadIndexRanges-Funktion wurde im Windows 8 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 ausgefertigt werden.

rgIndexRanges

Die Schlüsselbereiche, die vorgelesen werden.

cIndexRanges

Die Anzahl der Vorableseschlüsselbereiche, die durch die Anzahl der Elemente in rgIndexRanges bestimmt werden.

pcRangesPreread

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

rgcolumnidPreread

Liste der Spalten-IDs für Spalten mit langen Wert, die vorab gelesen werden sollen. Standardmäßig ist nur der Datensatz auf der Seite vorgelesen. Wenn Spalten mit seitenseitigem Long-Wert vorgelesen werden müssen, müssen ihre Spalten-IDs über diesen Parameter übergeben werden.

ccolumnidPreread

Die Anzahl der Spalten-IDs für Spalten mit langen Wert, 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

Vorlesen.

Rückwärts

Vorlesen rückwärts.

FirstPageOnly

Es wird nur die erste Seite einer langen Spalte vorgelesen.

NormalizedKey

Ein normalisierter Schlüssel/Lesezeichen wird anstelle des Spaltenwerts bereitgestellt.

Rückgabewert

Diese Funktion gibt den JET_ERR datentyp mit einem der in der folgenden Tabelle aufgeführten Rückgabecodes zurück. Weitere Informationen zu den möglichen ESE-Fehlern (Extensible Storage Engine) finden Sie unter Extensible Storage Engine Errors and Error Handling Parameters.

Rückgabecode

Beschreibung

JET_errSuccess

Der Vorgang wurde erfolgreich abgeschlossen.

Hinweise

Wenn sich die Datensätze mit den angegebenen Schlüsselbereichen nicht im Puffercache befinden, sollten Sie asynchrone Leseläufe starten, um die Datensätze in den Datenbankpuffercache zu übertragen.

Anforderungen

Anforderung Wert

Client

Erfordert Windows 8.

Server

Erfordert Windows Server 2012.

Header

Wird in Esent.h deklariert.

Bibliothek

Verwenden Sie ESENT.lib.

DLL

Erfordert ESENT.dll.

Weitere Informationen

JET_ERR