Funzione JetInit2

Si applica a: Windows | Windows Server

Funzione JetInit2

La funzione JetInit2 inserisce il motore di database in uno stato in cui può supportare l'uso dell'applicazione di file di database. Il motore deve essere già configurato correttamente per l'inizializzazione tramite JetSetSystemParameter. Il ripristino di arresto anomalo del database viene eseguito automaticamente come parte del processo di inizializzazione.

Windows XP:JetInit2 è stato introdotto in Windows XP.

questa funzione è obsoleta. Usare invece JetInit3 .

JET_ERR JET_API JetInit2(
  __in_out_opt  JET_INSTANCE* pinstance,
  __in          JET_GRBIT grbit
);

Parametri

pinstance

Istanza da utilizzare per questa chiamata.

Per Windows 2000, questo parametro viene ignorato e deve essere sempre NULL.

Per Windows XP e versioni successive, l'uso di questo parametro dipende dalla modalità operativa del motore. Se il motore funziona in modalità legacy (modalità di compatibilità di Windows 2000) in cui è supportata una sola istanza, questo parametro può essere NULL oppure può essere impostato su un buffer di output valido contenente NULL o JET_instanceNil che restituisce l'handle di istanza globale creato come effetto collaterale dell'inizializzazione. Questo handle di istanza può quindi essere passato a qualsiasi altra API che accetta un'istanza di . Se il motore opera in modalità a istanze multipli, questo parametro deve essere impostato su un buffer di input valido che contiene l'handle di istanza restituito da JetCreateInstance inizializzato.

grbit

Un gruppo di bit che specifica zero o più delle opzioni seguenti.

Valore	Significato
JET_bitReplayReplicatedLogFiles	Riservato per utilizzi futuri.
JET_bitCreateSFSVolumeIfNotExist	Riservato per utilizzi futuri.
JET_bitReplayIgnoreMissingDB	Questa opzione consente all'utente di eseguire il ripristino in un set di file di log, senza che tutti i database siano presenti, collegati in un punto del set di log.
JET_bitRecoveryWithoutUndo	Eseguire il ripristino, ma arrestarsi nella fase Annulla. In questo modo, i log delle transazioni aggiuntivi possono essere copiati e applicati.
JET_bitTruncateLogsAfterRecovery	Al termine del ripristino software, troncare i file di log.
JET_bitReplayMissingMapEntryDB	Voce della mappa di database mancante per impostazione predefinita nella stessa posizione.
JET_bitReplayIgnoreLostLogs	Ignorare i log persi dalla fine del flusso di log. Windows 7:JET_bitReplayIgnoreLostLogs è stato introdotto in Windows 7.

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.

Commenti

Un'istanza di deve essere inizializzata con una chiamata a JetInit2 prima che possa essere usata da qualsiasi elemento diverso da JetSetSystemParameter.

Un'istanza viene eliminata definitivamente da una chiamata alla funzione JetTerm , anche se tale istanza non è mai stata inizializzata usando JetInit. Un'istanza è l'unità di recuperabilità per il motore di database. Controlla il ciclo di vita di tutti i file usati per proteggere l'integrità dei dati in un set di file di database. Questi file includono il file del checkpoint e i file di log delle transazioni.

Se il ripristino è in esecuzione in un set di log, per cui non tutti i database sono presenti (che restituirà l'errore JET_errAttachedDatabaseMismatch in circostanze normali) e il client desidera continuare nonostante i database mancanti, il JET_ bitReplayIgnoreMissingDB viene usato per continuare il ripristino per i database disponibili.

Per altre informazioni, vedere la sezione Osservazioni in JetInit .

Requisiti

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

Vedere anche

File del motore di archiviazione estendibile
JET_ERR
JET_GRBIT
JET_INSTANCE
JetCreateInstance
JetInit
JetInit3
JetSetSystemParameter
Parametri delle risorse