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 Datentyp JET_ERR 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_errDiskFull	Auf dem Volume ist nicht genügend freier Speicherplatz vorhanden, um den Vergrößerungsvorgang auszuführen.
JET_errDiskIO	Ein dateibezogener Fehler wurde von JetSetDatabaseSize zurü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 verringert auch die Anzahl der Anwachsens der Datenbankdatei. Das einmalige Vergrößern der Datenbankdatei kann schneller sein, als sie mehrmals zu vergrößern.

Derzeit wird nur das Vergrößern der Datei unterstützt. Um eine Datei zu verkleinern, verwenden Sie die Defragmentierungsfunktion des esentutl.exe Hilfsprogramm.

Informationen zum Festlegen der Größe einer Nicht geöffneten Datenbank finden Sie unter JetSetDatabaseSize.

Die Dateigröße stimmt möglicherweise nicht mit der Anzahl von 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.
Kopfzeile	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