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.
|