Jetresettablesequential-Funktion

Gilt für: Windows | Windows Server

Jetresettablesequential-Funktion

Die jetresettablesequential -Funktion benachrichtigt die Datenbank-Engine, dass die Anwendung den gesamten aktuellen Index, der einen bestimmten Cursor enthält, nicht mehr scannt. Dieser Rückruf kehrt eine von jetsettablesequentialgesendete 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

-sid

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

TableID

Der Cursor, der für diesen-Befehl 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 den möglichen ESE-Fehlern finden Sie unter Extensible Storage Engine Errors und Error Handling Parameters.

Rückgabecode

Beschreibung

JET_errSuccess

Der Vorgang wurde erfolgreich abgeschlossen.

JET_errClientRequestToStopJetService

Der Vorgang kann nicht ausgeführt werden, da alle Aktivitäten auf der Instanz, die der Sitzung zugeordnet ist, aufgrund eines Aufrufens von jetstopservicebeendet wurden.

JET_errInstanceUnavailable

Der Vorgang kann nicht ausgeführt werden, da bei der der Sitzung zugeordneten Instanz ein schwerwiegender Fehler aufgetreten ist, der erfordert, dass der Zugriff auf alle Daten widerrufen wird, um die Integrität der Daten zu schützen. Dieser Fehler wird nur von Windows XP und höheren Versionen zurückgegeben.

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 für die-Instanz, die der Sitzung zugeordnet ist, ein Wiederherstellungs Vorgang ausgeführt wird.

JET_errTermInProgress

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

Bei Erfolg ist der aktuelle Index des Cursors nicht mehr für einen sequenziellen Scan des gesamten Indexes optimiert. Es erfolgt keine Änderung des Daten Bank Status.

Bei einem Fehler tritt keine Änderung an der Konfiguration des Cursors auf. Es erfolgt keine Änderung des Daten Bank Status.

Bemerkungen

Es ist sicher, diesen Vorgang für einen Cursor durchführen zu lassen, der zuvor nicht durch einen-Befehl von jetsettablesequenziellkonfiguriert wurde.

Anforderungen

Client

Erfordert Windows Vista oder Windows XP.

Server

Erfordert Windows Server 2008 oder Windows Server 2003.

Header

In "ESENT. h" deklariert.

Bibliothek

Verwenden Sie ESENT. lib.

DLL

Erfordert ESENT.dll.

Weitere Informationen

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
Jetsettablesequential
Jetstopservice