Funzione JetGetTruncateLogInfoInstance

Articolo
06/13/2023

Si applica a: Windows | Windows Server

Funzione JetGetTruncateLogInfoInstance

La funzione JetGetTruncateLogInfoInstance viene usata durante un backup avviato da JetBeginExternalBackup per eseguire query su un'istanza per i nomi dei file di log delle transazioni che possono essere eliminati in modo sicuro dopo il completamento del backup.

Windows XP:JetGetTruncateLogInfoInstance viene introdotto in Windows XP.

    JET_ERR JET_API JetGetTruncateLogInfoInstance(
      __in          JET_INSTANCE instance,
      __out_opt     tchar* szz,
      __in          unsigned long cbMax,
      __out_opt     unsigned long* pcbActual
    );

Parametri

Istanza

Istanza da usare per questa chiamata.

Szz

Buffer di output che riceve l'elenco di stringhe con terminazione null che descrivono il set di file di log delle transazioni che possono essere eliminati in modo sicuro dopo il completamento del 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 nella sequenza e seguita da un terminatore Null finale.

cbMax

Dimensione massima in byte del buffer di output.

pcbActual

Puntatore al buffer di output che riceve la quantità effettiva di dati stringa.

Valore restituito

Questa funzione restituisce il tipo di dati JET_ERR con uno dei codici restituiti seguenti. Per altre informazioni sugli errori ESE possibili, vedere Errori del motore di archiviazione estendibili e parametri di gestione degli errori.

Codice restituito	Descrizione
JET_errSuccess	Operazione riuscita.
JET_errInvalidParameter	Uno dei parametri forniti contiene un valore imprevisto o la combinazione di diversi valori di parametro ha generato un risultato imprevisto. Windows XP e versioni successive: Ciò può verificarsi per JetGetTruncateLogInfoInstance quando l'handle di istanza specificato non è valido.
JET_errNotInitialized	Impossibile completare l'operazione perché l'istanza associata alla sessione non è ancora stata inizializzata.
JET_errClientRequestToStopJetService	L'operazione non può essere completata perché tutte le attività nell'istanza associata alla sessione hanno interrotto come risultato di una chiamata a JetStopService.
JET_errInstanceUnavailable	Impossibile completare l'operazione perché l'istanza associata alla sessione ha rilevato un errore irreversibile che richiede che l'accesso a tutti i dati venga revocato per proteggere l'integrità dei dati. Windows XP: Questo valore restituito è stato introdotto in Windows XP.
JET_errBackupAbortByServer	L'operazione non è riuscita perché il backup esterno corrente è stato interrotto da una chiamata a JetStopBackup. Windows XP: Questo valore restituito è stato introdotto in Windows XP.
JET_errInvalidBackupSequence	L'operazione di backup non è riuscita perché è stata chiamata fuori sequenza.
JET_errNoBackup	L'operazione non è riuscita perché non è in corso alcun backup esterno.
JET_errRestoreInProgress	L'operazione non può essere completata perché un'operazione di ripristino è in corso nell'istanza associata alla sessione.
JET_errTermInProgress	Impossibile completare l'operazione perché l'istanza associata alla sessione viene arrestata.
JetGetTruncateLogInfoInstance	Esistono handle di file in sospeso creati usando JetOpenFile per l'istanza.

Se questa funzione ha esito positivo, le informazioni richieste sul set di file di log delle transazioni che possono essere eliminate in modo sicuro dopo che il backup è stato completato correttamente verrà inserito nei buffer di output in cui vengono forniti. Il computer con stato di backup sarà avanzato 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.

Se questa funzione ha esito negativo, lo stato dei buffer di output non è definito. L'errore comporterà l'annullamento dell'intero processo di backup per l'istanza.

Commenti

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 essere parte del set di file di backup. L'applicazione deve sempre fornire un buffer per ricevere le dimensioni effettive di questo elenco e usare tali informazioni 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 JetGetTruncateLogInfoInstanceW (Unicode) e JetGetTruncateLogInfoInstanceA (ANSI).

Vedere anche

JET_ERR
JET_INSTANCE
JetBeginExternalBackup
JetCloseDatabase
JetCloseTable
JetEndSession
JetOpenFile
JetResetSessionContext
JetRollback
JetStopBackup
JetStopService
JetTerm
JetTerm2

Condividi tramite

Funzione JetGetTruncateLogInfoInstance