Funzione JetGrowDatabase

Si applica a: Windows | Windows Server

Funzione JetGrowDatabase

La funzione JetGrowDatabase estende le dimensioni di un database attualmente aperto.

    JET_ERR JET_API JetGrowDatabase(
      __in          JET_SESID sesid,
      __in          JET_DBID dbid,
      __in          unsigned long cpg,
      __in          unsigned long* pcpgReal
    );

Parametri

sesid

Contesto della sessione di database da usare per la chiamata API.

dbid

Database che verrà esteso.

Cpg

Dimensioni desiderate del database, nelle pagine.

pcpgReal

Puntatore a un numero che riceve le dimensioni del database, nelle pagine, dopo la chiamata API. Se la chiamata API non riesce, il contenuto di pcpgReal non è definito.

Valore restituito

Questa funzione restituisce il tipo di dati JET_ERR con uno dei codici restituiti seguenti. Per altre informazioni sui possibili errori ESE, vedere Errori del motore di archiviazione estendibile e parametri di gestione degli errori.

Codice restituito	Descrizione
JET_errSuccess	Operazione riuscita.
JET_errDiskFull	Spazio disponibile insufficiente nel volume per eseguire l'operazione di aumento.
JET_errDiskIO	Un errore correlato al file è stato restituito da JetSetDatabaseSize. Per altre informazioni sugli altri errori correlati ai file che potrebbero essere restituiti, vedere JetSetDatabaseSize.

Commenti

Se JetGrowDatabase viene chiamato prima di inserire grandi quantità di dati, il file di database verrà cresciuto in un'unica operazione. Ciò ridurrà la probabilità che il file di database diventi frammentato a livello di file system e ridurrà anche il numero di volte in cui il file di database deve essere aumentato. La crescita del file di database può essere più veloce rispetto alla crescita più volte.

Attualmente è supportato solo l'aumento del file. Per compattare un file, usare la funzionalità di deframmentazione del programma di utilità esentutl.exe .

Per impostare le dimensioni di un database non aperto, vedere JetSetDatabaseSize.

Le dimensioni del file potrebbero non corrispondere al numero di pagine restituite in pcpgReal. Esistono due pagine riservate aggiuntive che potrebbero non essere conteggiate in pcpgReal.

Requisiti

Requisito	Valore
Client	Richiede Windows Vista, Windows XP o Windows 2000 Professional.
Server	Richiede Windows Server 2008, Windows Server 2003 o Windows 2000 Server.
Intestazione	Dichiarato in Esent.h.
Libreria	Usare ESENT.lib.
DLL	Richiede ESENT.dll.

Vedere anche

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JET_OBJECTINFO
JET_OBJECTLIST
JetSetDatabaseSize