Funzione JetResizeDatabase

Articolo
06/13/2023

Si applica a: Windows | Windows Server

La funzione JetResizeDatabase estende o riduce le dimensioni di un database attualmente aperto.

La funzione JetResizeDatabase è stata introdotta nel sistema operativo Windows 8.

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
);

Parametri

sesid

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

dbid

Database che verrà esteso.

Cpg

Dimensioni richieste del database, nelle pagine.

pcpgActual

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

grbit

Gruppo di bit che specifica zero o più valori elencati nella tabella seguente.

Valore	Significato
JET_bitResizeDatabaseOnlyGrow	Aumentare solo il database. Se la chiamata di ridimensionamento ridurrà il database, non eseguire alcuna operazione.

Valore restituito

Questa funzione restituisce il tipo di dati JET_ERR con uno dei codici restituiti elencati nella tabella seguente. Per altre informazioni sui possibili errori di Extensible Storage Engine (ESE), vedere Extensible Storage Engine Errors and Error Handling Parameters .For more information about the possible Extensible Storage Engine errors( ESE), see Extensible Storage Engine Errors and Error Handling Parameters.

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 dalla funzione JetSetDatabaseSize . Per altre informazioni sugli altri errori correlati ai file che potrebbero essere restituiti, vedere JetSetDatabaseSize.

Commenti

Se la funzione JetResizeDatabase viene chiamata 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.

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

Le dimensioni del file potrebbero non corrispondere al numero di pagine restituite nel parametro pcpgReal . È possibile che non vengano conteggiate due pagine riservate aggiuntive nel parametro pcpgReal .

Requisiti

Requisito	Valore
Client	Richiede Windows 8.
Server	Richiede Windows Server 2012.
Intestazione	Dichiarato in Esent.h.
Libreria	Usare ESENT.lib.
DLL	Richiede ESENT.dll.

Vedi anche

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JET_OBJECTINFO
JET_OBJECTLIST
JetSetDatabaseSize

Condividi tramite