Funzione JetGetLogInfoInstance
Si applica a: Windows | Windows Server
Funzione JetGetLogInfoInstance
La funzione JetGetLogInfoInstance viene usata durante un backup avviato da JetBeginExternalBackup per eseguire una query su un'istanza per i nomi dei file di patch del database e dei file di log delle transazioni che devono far parte del set di file di backup. Questi file possono essere successivamente aperti usando JetOpenFile e letti usando JetReadFile.
Windows XP: JetGetLogInfoInstance è stato introdotto in Windows XP.
JET_ERR JET_API JetGetLogInfoInstance(
__in JET_INSTANCE instance,
__out_opt tchar* szz,
__in unsigned long cbMax,
__out_opt unsigned long* pcbActual
);
Parametri
Istanza
Istanza da utilizzare per questa chiamata.
Per Windows 2000, la variante API che accetta questo parametro non è disponibile perché è supportata una sola istanza. L'uso di questa istanza globale è implicito in questo caso.
Per Windows XP e versioni successive, la variante DELL'API che non accetta questo parametro può essere chiamata solo quando il motore è in modalità legacy (modalità di compatibilità di Windows 2000) in cui è supportata una sola istanza. In caso contrario, l'operazione avrà esito negativo con JET_errRunningInMultiInstanceMode.
Szz
Buffer di output che riceverà l'elenco di stringhe con terminazione Null che descrivono il set di file di patch del database e i file di log delle transazioni che devono far parte del set di file di backup.
L'elenco di stringhe restituite in questo buffer è nello stesso formato di una stringa multipla usata dal Registro di sistema. Ogni stringa con terminazione Null viene restituita in sequenza seguita da un terminatore Null finale.
cbMax
Dimensione massima in byte del buffer di output.
pcbActual
Riceve la quantità effettiva di dati stringa ricevuti nel buffer di output.
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.
Codice restituito |
Descrizione |
---|---|
JET_errSuccess |
Operazione riuscita. |
JET_errBackupAbortByServer |
L'operazione non è riuscita perché il backup esterno corrente è stato interrotto da una chiamata a JetStopBackup. Questo errore verrà restituito solo da Windows XP e versioni successive. |
JET_errClientRequestToStopJetService |
Non è possibile completare l'operazione perché tutte le attività sull'istanza associata alla sessione sono cessate a seguito di una chiamata a JetStopService. |
JET_errInstanceUnavailable |
Non è possibile completare l'operazione perché l'istanza associata alla sessione ha rilevato un errore irreversibile che richiede la revoca dell'accesso a tutti i dati per proteggere l'integrità dei dati. Questo errore verrà restituito solo da Windows XP e versioni successive. |
JET_errInvalidBackupSequence |
L'operazione di backup non è riuscita perché è stata chiamata fuori sequenza. JetGetLogInfo restituirà questo errore se sono presenti handle di file in sospeso creati usando JetOpenFile per l'istanza. |
JET_errInvalidParameter |
Uno dei parametri forniti conteneva un valore imprevisto o conteneva un valore che non ha senso se combinato con il valore di un altro parametro. Questo problema può verificarsi per JetGetLogInfo quando l'handle di istanza specificato non è valido (Windows XP e versioni successive). |
JET_errNoBackup |
L'operazione non è riuscita perché non è in corso alcun backup esterno. |
JET_errNotInitialized |
Non è possibile completare l'operazione perché l'istanza associata alla sessione non è ancora stata inizializzata. |
JET_errRestoreInProgress |
Non è possibile completare l'operazione perché è in corso un'operazione di ripristino nell'istanza associata alla sessione. |
JET_errRunningInMultiInstanceMode |
L'operazione non è riuscita perché è stato effettuato un tentativo di utilizzo del motore in modalità legacy (modalità di compatibilità di Windows 2000), in cui è supportata solo un'istanza quando esistono effettivamente più istanze. |
JET_errTermInProgress |
Non è possibile completare l'operazione perché l'istanza associata alla sessione viene arrestata. |
In caso di esito positivo, le informazioni richieste sul set di file di patch del database e sui file di log delle transazioni che devono far parte del set di file di backup verranno inserite nei buffer di output, dove specificato. La macchina a stati di backup sarà avanzata in modo che il backup dei file di database non sia più consentito. Solo i file di patch del database e i file di log delle transazioni possono essere aperti per il backup oltre questo punto.
In caso di errore, lo stato dei buffer di output non è definito. L'errore comporterà l'annullamento dell'intero processo di backup per l'istanza.
Commenti
È importante notare che questa API non restituisce un errore o un avviso se il buffer di output è troppo piccolo per accettare l'elenco completo di file che devono far parte del set di file di backup. L'applicazione deve sempre fornire un buffer per ricevere le dimensioni effettive di questo elenco e usarle per determinare se l'elenco è stato troncato.
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. |
Unicode |
Implementato come JetGetLogInfoInstanceW (Unicode) e JetGetLogInfoInstanceA (ANSI). |
Vedere anche
JET_ERR
JET_INSTANCE
JET_LOGINFO
JetBeginExternalBackup
JetOpenFile
JetReadFile
JetStopBackup
JetStopService