JetGrowDatabase (funzione)

Si applica a: Windows | Windows Server

JetGrowDatabase (funzione)

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, in pagine.

pcpgReal

Puntatore a un numero che riceve le dimensioni del database, in 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 seguenti codici restituiti. Per ulteriori informazioni sugli errori ESE possibili, vedere la pagina relativa agli errori e ai parametri di gestione deglierrori del motore di archiviazione estensibile .

Codice restituito

Descrizione

JET_errSuccess

Operazione riuscita.

JET_errDiskFull

Lo spazio disponibile nel volume non è sufficiente per eseguire l'operazione di espansione.

JET_errDiskIO

Un errore relativo al file è stato restituito da JetSetDatabaseSize. Per ulteriori informazioni sugli altri errori correlati ai file che potrebbero essere restituiti, vedere JetSetDatabaseSize.

Commenti

Se JetGrowDatabase viene chiamato prima dell'inserimento di grandi quantità di dati, il file di database verrà aumentato in un'unica operazione. In questo modo si ridurrà la probabilità che il file di database diventi frammentato a livello di file system e si 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 è supportata solo la crescita del file. Per compattare un file, utilizzare 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. Sono disponibili altre due pagine riservate che potrebbero non essere conteggiate in pcpgReal.

Requisiti

Client

Richiede Windows Vista, Windows XP o Windows 2000 Professional.

Server

Richiede Windows Server 2008, Windows Server 2003 o Windows 2000 Server.

Intestazione

Dichiarata 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