JetIdle-Funktion

Gilt für: Windows | Windows Server

JetIdle-Funktion

Die JetIdle-Funktion ist nicht mehr vorhanden und sollte nur zu Testzwecken verwendet werden. JetIdle kann verwendet werden, um Leerlaufbereinigungsaufgaben auszuführen oder den Versionsspeicher status 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 Optionen enthalten, die für diesen Aufruf verwendet werden sollen, die null oder mehr der folgenden Bits enthalten:

Wert	Bedeutung
JET_bitIdleCompact	Löst eine 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 möglichen ESE-Fehlern finden Sie unter Erweiterbare Speichermodulfehler und Fehlerbehandlungsparameter.

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 ist, wird der entsprechende Vorgang oder ein Fehlercode ausgelöst, der angibt, wie voll der Versionsspeicher ist, abhängig vom bereitgestellten Grbit .

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

Bemerkungen

Der Versionsspeicher verwaltet den Momentaufnahme Isolationsmechanismus von ESE. Wenn der Versionsspeicher mehr als die Hälfte voll ist, kann das Programm Transaktionen mit langer Ausführungszeit schließen. Wenn eine Transaktion mit langer Ausführungszeit den Versionsspeicher erschöpft, lässt ESE Schreibvorgänge in die Datenbank nicht mehr zu.

Anforderungen

Anforderung	Wert
Client	Erfordert Windows Vista, Windows XP oder Windows 2000 Professional.
Server	Erfordert Windows Server 2008, Windows Server 2003 oder Windows 2000 Server.
Kopfzeile	Deklariert in Esent.h.
Bibliothek	Verwenden Sie ESENT.lib.
DLL	Erfordert ESENT.dll.

Weitere Informationen

JET_ERR
JET_GRBIT
JET_SESID
JetCommitTransaction