JetGrowDatabase-Funktion
Gilt für: Windows | Windows Server
JetGrowDatabase-Funktion
Die JetGrowDatabase-Funktion erweitert die Größe einer Datenbank, die derzeit geöffnet ist.
JET_ERR JET_API JetGrowDatabase(
__in JET_SESID sesid,
__in JET_DBID dbid,
__in unsigned long cpg,
__in unsigned long* pcpgReal
);
Parameter
sesid
Der Datenbanksitzungskontext, der für den API-Aufruf verwendet werden soll.
Dbid
Die Datenbank, die erweitert wird.
Cpg
Die gewünschte Größe der Datenbank in Seiten.
pcpgReal
Zeiger auf eine Zahl, die die Größe der Datenbank in Seiten nach dem API-Aufruf empfängt. Wenn der API-Aufruf fehlschlägt, ist der Inhalt von pcpgReal nicht definiert.
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_errDiskFull |
Es ist nicht genügend freier Speicherplatz auf dem Volume vorhanden, um den Zuwachsvorgang auszuführen. |
JET_errDiskIO |
Ein dateibezogener Fehler wurde von JetSetDatabaseSizezurückgegeben. Weitere Informationen zu anderen dateibezogenen Fehlern, die möglicherweise zurückgegeben werden, finden Sie unter JetSetDatabaseSize. |
Bemerkungen
Wenn JetGrowDatabase vor dem Einfügen großer Datenmengen aufgerufen wird, wird die Datenbankdatei in einem Vorgang vergrößert. Dies verringert die Wahrscheinlichkeit, dass die Datenbankdatei auf Dateisystemebene fragmentiert wird, und die Anzahl der Erweiterungen der Datenbankdatei. Das einmalige Anwachsen der Datenbankdatei kann schneller sein, als sie mehrmals zu erhöhen.
Derzeit wird nur das Anwachsen der Datei unterstützt. Um eine Datei zu verkleinern, verwenden Sie das Defragmentierungsfeature des Hilfsprogrammsesentutl.exe.
Informationen zum Festlegen der Größe einer Datenbank, die nicht geöffnet ist, finden Sie unter JetSetDatabaseSize.
Die Dateigröße stimmt möglicherweise nicht mit der Anzahl der Seiten überein, die in pcpgReal zurückgegeben werden. Es gibt zwei zusätzliche reservierte Seiten, die in pcpgReal möglicherweise nicht gezählt werden.
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. |
Header |
Deklariert in Esent.h. |
Bibliothek |
Verwenden Sie ESENT.lib. |
DLL |
Erfordert ESENT.dll. |
Weitere Informationen
JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JET_OBJECTINFO
JET_OBJECTLIST
JetSetDatabaseSize