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

Vedere anche

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