JetGrowDatabase-Funktion

Artikel
09/23/2022
2 Minuten Lesedauer

Gilt für: Windows | Windows Server

JetGrowDatabase-Funktion

Die JetGrowDatabase-Funktion erweitert die Größe einer derzeit geöffneten Datenbank.

    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

Zeigen Sie auf eine Zahl, die die Größe der Datenbank in Seiten nach dem API-Aufruf empfängt. Wenn der API-Aufruf fehlschlägt, werden die Inhalte 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 Modulfehler und Fehlerbehandlungsparameter.

Rückgabecode	Beschreibung
JET_errSuccess	Der Vorgang wurde erfolgreich abgeschlossen.
JET_errDiskFull	Es gibt nicht genügend freien Speicherplatz auf dem Volume, um den Wachstumsvorgang auszuführen.
JET_errDiskIO	Ein dateibezogener Fehler wurde von JetSetDatabaseSize zurückgegeben. Weitere Informationen zu anderen dateibezogenen Fehlern, die zurückgegeben werden können, finden Sie unter JetSetDatabaseSize.

Bemerkungen

Wenn JetGrowDatabase vor dem Einfügen großer Datenmengen aufgerufen wird, wird die Datenbankdatei in einem Vorgang vergrößert. Dadurch wird die Wahrscheinlichkeit verringert, dass die Datenbankdatei auf Der Dateisystemebene fragmentiert wird und auch die Anzahl der Zeiten verringert, in denen die Datenbankdatei vergrößert werden muss. Das Wachstum der Datenbankdatei kann einmal schneller sein, als sie mehrmals zu wachsen.

Nur das Wachstum der Datei wird derzeit unterstützt. Um eine Datei zu verkleinern, verwenden Sie das Defragmentierungsfeature des esentutl.exe Hilfsprogramms.

Informationen zum Festlegen der Größe einer datenbank, die nicht geöffnet wird, finden Sie unter JetSetDatabaseSize.

Die Dateigröße entspricht möglicherweise nicht der Anzahl von Seiten, die in pcpgReal zurückgegeben werden. Es gibt zwei zusätzliche reservierte Seiten, die möglicherweise nicht in pcpgReal zählen.

Requirements (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

JetGrowDatabase-Funktion