JetResetTableSequential-Funktion

  • Artikel

Gilt für: Windows | Windows Server

JetResetTableSequential-Funktion

Die JetResetTableSequential-Funktion benachrichtigt die Datenbank-Engine, dass die Anwendung nicht mehr den gesamten aktuellen Index überprüft, der einen bestimmten Cursor enthält. Dieser Aufruf kehrt eine von JetSetTableSequential gesendete Benachrichtigung um.

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

    JET_ERR JET_API JetResetTableSequential(
      __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

Für die zukünftige Verwendung reserviert.

Rückgabewert

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

Rückgabecode

Beschreibung

JET_errSuccess

Der Vorgang wurde erfolgreich abgeschlossen.

JET_errClientRequestToStopJetService

Es ist nicht möglich, den Vorgang abzuschließen, da alle Aktivitäten auf dem instance, die der Sitzung zugeordnet sind, aufgrund eines Aufrufs von JetStopService beendet wurden.

JET_errInstanceUnavailable

Es ist nicht möglich, den Vorgang abzuschließen, da beim instance, der der Sitzung zugeordnet ist, ein schwerwiegender Fehler aufgetreten ist, der erfordert, dass der Zugriff auf alle Daten widerrufen wird, um die Integrität dieser Daten zu schützen. Dieser Fehler wird nur von Windows XP und höheren Versionen zurückgegeben.

JET_errNotInitialized

Es ist nicht möglich, den Vorgang abzuschließen, da die der Sitzung zugeordnete instance noch nicht initialisiert wurde.

JET_errRestoreInProgress

Es ist nicht möglich, den Vorgang abzuschließen, da auf dem der Sitzung zugeordneten instance ein Wiederherstellungsvorgang ausgeführt wird.

JET_errTermInProgress

Es ist nicht möglich, den Vorgang abzuschließen, da die der Sitzung zugeordnete instance heruntergefahren wird.

Bei Erfolg ist der aktuelle Index des Cursors nicht mehr für eine sequenzielle Überprüfung des gesamten Indexes optimiert. Es wird keine Änderung des Datenbankstatus vorgenommen.

Bei einem Fehler tritt keine Änderung an der Konfiguration des Cursors auf. Es wird keine Änderung des Datenbankstatus vorgenommen.

Bemerkungen

Es ist sicher, diesen Aufruf für einen Cursor zu tätigen, der zuvor nicht durch einen Aufruf von JetSetTableSequential konfiguriert wurde.

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
JetSetTableSequential
JetStopService