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. |