JetResetTableSequential-Funktion
Gilt für: Windows | Windows Server
JetResetTableSequential-Funktion
Die JetResetTableSequential-Funktion benachrichtigt die Datenbank-Engine, dass die Anwendung nicht mehr den gesamten aktuellen Index mit einem angegebenen Cursor scannt. Dieser Aufruf 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
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 den möglichen ESE-Fehlern finden Sie unter Extensible Storage Engine Errors and Error Handling Parameters.
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 der Instanz, die der Sitzung zugeordnet ist, als Ergebnis eines Aufrufs von JetStopServiceaufgetreten sind. |
JET_errInstanceUnavailable |
Es ist nicht möglich, den Vorgang abzuschließen, da für die instanz, die 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 späteren Versionen zurückgegeben. |
JET_errNotInitialized |
Es ist nicht möglich, den Vorgang abzuschließen, da die der Sitzung zugeordnete Instanz noch nicht initialisiert wurde. |
JET_errRestoreInProgress |
Es ist nicht möglich, den Vorgang abzuschließen, da ein Wiederherstellungsvorgang für die Instanz ausgeführt wird, die der Sitzung zugeordnet ist. |
JET_errTermInProgress |
Es ist nicht möglich, den Vorgang abzuschließen, da die der Sitzung zugeordnete Instanz 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 am Datenbankzustand vorgenommen.
Bei einem Fehler erfolgt keine Änderung an der Konfiguration des Cursors. Es wird keine Änderung am Datenbankzustand vorgenommen.
Hinweise
Es ist sicher, diesen Aufruf für einen Cursor zu tätigen, der zuvor nicht durch einen Aufruf von JetSetTableSequentialkonfiguriert wurde.
Anforderungen
| Anforderung | Wert |
|---|---|
Client |
Erfordert Windows Vista oder Windows XP. |
Server |
Erfordert Windows Server 2008 oder Windows Server 2003. |
Header |
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