JetSetTableSequential-Funktion

  • Artikel

Gilt für: Windows | Windows Server

JetSetTableSequential-Funktion

Die JetSetTableSequential-Funktion benachrichtigt das Datenbankmodul, dass die Anwendung den gesamten aktuellen Index überprüft, der einen bestimmten Cursor enthält. Folglich werden die Methoden, mit denen auf die Indexdaten zugegriffen wird, so schnell wie möglich abgestimmt.

Windows XP:JetSetTableSequential wird in Windows XP eingeführt.

    JET_ERR JET_API JetSetTableSequential(
      __in          JET_SESID sesid,
      __in          JET_TABLEID tableid,
      __in          JET_GRBIT grbit
    );

Parameter

sesid

Die Sitzung, die für diesen Aufruf verwendet werden soll.

tableid

Der Cursor, der für diesen Aufruf verwendet werden soll.

grbit

Eine Gruppe von Bits, die null oder mehr der folgenden Optionen angeben.

Wert

Bedeutung

JET_bitPrereadForward

Diese Option wird verwendet, um in der Vorwärtsrichtung indiziert zu werden.

Windows 7:JET_bitPrereadForward wird in Windows 7 eingeführt.

JET_bitPrereadBackward

Diese Option wird zum Indizieren in der Rückwärtsrichtung verwendet.

Windows 7:JET_bitPrereadBackward wird in Windows 7 eingeführt.

Rückgabewert

Diese Funktion gibt den datentyp JET_ERR mit einem der folgenden Rückgabecodes zurück. Weitere Informationen zu den möglichen ESE-Fehlern finden Sie unter Erweiterbarkeit Storage Modulfehler und Fehlerbehandlungsparameter.

Rückgabecode

Beschreibung

JET_errClientRequestToStopJetService

Der Vorgang kann nicht abgeschlossen werden, da alle Aktivitäten für die Instanz, die der Sitzung zugeordnet ist, aufgrund eines Aufrufs von JetStopService aufgehoben wurde.

JET_errInstanceUnavailable

Der Vorgang kann nicht abgeschlossen werden, da die Instanz, die der Sitzung zugeordnet ist, einen schwerwiegenden Fehler aufgetreten ist, der erfordert, dass der Zugriff auf alle Daten widerrufen wird, um die Integrität dieser Daten zu schützen.

Windows XP: Dieser Rückgabewert wird in Windows XP eingeführt.

JET_errNotInitialized

Der Vorgang kann nicht abgeschlossen werden, da die Instanz, die der Sitzung zugeordnet ist, noch nicht initialisiert wurde.

JET_errRestoreInProgress

Der Vorgang kann nicht abgeschlossen werden, da ein Wiederherstellungsvorgang in der Instanz ausgeführt wird, die der Sitzung zugeordnet ist.

JET_errTermInProgress

Der Vorgang kann nicht abgeschlossen werden, da die Instanz, die der Sitzung zugeordnet ist, heruntergefahren wird.

Wenn diese Funktion erfolgreich verläuft, ist der aktuelle Index des Cursors für eine sequenzielle Überprüfung des gesamten Indexes optimiert. Es tritt keine Änderung des Datenbankstatus auf.

Wenn diese Funktion fehlschlägt, tritt keine Änderung der Konfiguration des Cursors auf. Es tritt keine Änderung des Datenbankstatus auf.

Hinweise

Wenn die Anwendung eine bekannte Teilmenge eines Indexes effizient scannen muss, wird auch eine ähnliche Optimierung ausgeführt, wenn ein Indexbereich mithilfe von JetSetIndexRange eingerichtet wird. Diese Optimierung ist nur auf Windows XP und späteren Versionen verfügbar.

Wenn die Anwendung eine unbekannte Teilmenge eines Indexes effizient scannen muss, sollte keine Aktion ausgeführt werden. Das Modul kann das Scanverhalten automatisch erkennen und Daten vorab abrufen. Dieses Verhalten ist jedoch nicht so aggressiv.

Diese Optimierung macht das Scannen des primären Indexes effizient und macht das Scannen nur der Indexeingabedaten in einem sekundären Index effizient. Beim Abrufen von Datensatzdaten wird kein sekundärer Index gescannt. Dies liegt daran, dass das Modul keinen Lesevorgang für die Datensatzdaten ausführt.

Requirements (Anforderungen)

Anforderung Wert

Client

Erfordert Windows Vista oder Windows XP.

Server

Erfordert Windows Server 2008 oder Windows Server 2003.

Kopfzeile

Deklariert in Esent.h.

Bibliothek

Verwenden Sie ESENT.lib.

DLL

Erfordert ESENT.dll.

Weitere Informationen

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetSetIndexRange
JetStopService