Funzione JetGrowDatabase

Si applica a: Windows | server Windows

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 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 ha esito negativo, 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 sugli errori ESE possibili, vedere Estendibili Archiviazione errori del motore e parametri di gestione degli errori.

Codice restituito

Descrizione

JET_errSuccess

Operazione riuscita.

JET_errDiskFull

Nel volume non è disponibile spazio sufficiente per eseguire l'operazione di crescita.

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 cresciuto. La crescita del file di database una volta può essere più veloce rispetto alla crescita più volte.

Attualmente è supportato solo il file in crescita. 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 server 2000.

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