JetResizeDatabase-Funktion

  • Artikel

Gilt für: Windows | Windows Server

Die JetResizeDatabase-Funktion erweitert oder verkleinert die Größe einer datenbank, die derzeit geöffnet ist.

Die JetResizeDatabase-Funktion wurde im Windows 8 Betriebssystem eingeführt.

JET_ERR JET_API JetResizeDatabase(
  __in          JET_SESID sesid,
  __in          JET_DBID dbid,
  __in          unsigned long cpg,
  __out         unsigned long* pcpgActual,
  __in          const JET_GRBIT grbit
);

Parameter

sesid

Der Datenbanksitzungskontext, der für den API-Aufruf verwendet werden soll.

dbid

Die Datenbank, die erweitert wird.

Cpg

Die angeforderte Größe der Datenbank in Seiten.

pcpgActual

Ein 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 des parameters pcpgActual nicht definiert.

grbit

Eine Gruppe von Bits, die null oder mehr der in der folgenden Tabelle aufgeführten Werte angibt.

Wert

Bedeutung

JET_bitResizeDatabaseOnlyGrow

Vergrößern Sie nur die Datenbank. Wenn der Aufruf zur Größenänderung die Datenbank verkleinern würde, tun Sie nichts.

Rückgabewert

Diese Funktion gibt den Datentyp JET_ERR mit einem der in der folgenden Tabelle aufgeführten Rückgabecodes zurück. Weitere Informationen zu möglichen Ese-Fehlern (Extensible Storage Engine) finden Sie unter Fehler der erweiterbaren Speicher-Engine 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

Von der JetSetDatabaseSize-Funktion wurde ein dateibezogener Fehler zurückgegeben. Weitere Informationen zu anderen dateibezogenen Fehlern, die möglicherweise zurückgegeben werden, finden Sie unter JetSetDatabaseSize.

Bemerkungen

Wenn die JetResizeDatabase-Funktion 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.

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 der Seiten überein, die im pcpgReal-Parameter zurückgegeben werden. Zwei zusätzliche reservierte Seiten werden möglicherweise nicht im parameter pcpgReal gezählt.

Anforderungen

Anforderung Wert

Client

Erfordert Windows 8.

Server

Erfordert Windows Server 2012.

Kopfzeile

Deklariert in Esent.h.

Bibliothek

Verwenden Sie ESENT.lib.

DLL

Erfordert ESENT.dll.

Siehe auch

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JET_OBJECTINFO
JET_OBJECTLIST
JetSetDatabaseSize