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