JetIdle-Funktion

Gilt für: Windows | Windows Server

JetIdle-Funktion

Die JetIdle-Funktion ist nicht mehr funktionsfähig und sollte nur zu Testzwecken verwendet werden. JetIdle kann verwendet werden, um Bereinigungsaufgaben im Leerlauf auszuführen oder den Status des Versionsspeichers in ESE zu überprüfen.

    JET_ERR JET_API JetIdle(
      __in          JET_SESID sesid,
      __in          JET_GRBIT grbit
    );

Parameter

sesid

Die Sitzung, die für diesen Aufruf verwendet wird.

grbit

Eine Gruppe von Bits, die die für diesen Aufruf zu verwendenden Optionen enthalten, die null oder mehr der folgenden Bits enthalten:

Wert

Bedeutung

JET_bitIdleCompact

Löst die Bereinigung des Versionsspeichers aus.

JET_bitIdleFlushBuffers

Für die zukünftige Verwendung reserviert. Wenn dieses Flag angegeben ist, gibt die API JET_errInvalidgrbit zurück.

JET_bitIdleStatus

Gibt JET_wrnIdleFull zurück, wenn der Versionsspeicher mehr als die Hälfte voll ist.

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_errInvalidParameter

Ein grbit-Parameter, der für die API bereitgestellt wurde, war ungültig.

Wenn diese Funktion erfolgreich ausgeführt wird, wird der entsprechende Vorgang oder ein Fehlercode ausgelöst, der angibt, wie voll der Versionsspeicher abhängig vom angegebenen Grbit ist.

Wenn diese Funktion fehlschlägt, wurde der angeforderte Vorgang nicht erfolgreich abgeschlossen.

Hinweise

Der Versionsspeicher verwaltet den Momentaufnahmeisolationsmechanismus von ESE. Wenn der Versionsspeicher mehr als die Hälfte voll ist, schließt das Programm möglicherweise Transaktionen mit langer Laufzeit. Wenn eine Transaktion mit langer Laufzeit den Versionsspeicher erschöpft, lässt ESE keine Schreibvorgänge in die Datenbank zu.

Anforderungen

| | |

Client

|

Erfordert Windows Vista, Windows XP oder Windows 2000 Professional.

| |

Server

|

Erfordert Windows Server 2008, Windows Server 2003 oder Windows 2000 Server.

| |

Header

|

Deklariert in Esent.h.

| |

Bibliothek

|

Verwenden Sie ESENT.lib.

| |

DLL

|

Erfordert ESENT.dll.

|

Weitere Informationen

JET_ERR
JET_GRBIT
JET_SESID
JetCommitTransaction