Funzione JetIdle

Si applica a: Windows | Windows Server

Funzione JetIdle

La funzione JetIdle è inattiva e deve essere usata solo a scopo di test. JetIdle può essere usato per eseguire attività di pulizia inattive o controllare lo stato dell'archivio versioni in ESE.

    JET_ERR JET_API JetIdle(
      __in          JET_SESID sesid,
      __in          JET_GRBIT grbit
    );

Parametri

sesid

Sessione che verrà utilizzata per questa chiamata.

grbit

Gruppo di bit che contengono le opzioni da usare per questa chiamata, che includono zero o più dei bit seguenti:

Valore

Significato

JET_bitIdleCompact

Attiva la pulizia dell'archivio versioni.

JET_bitIdleFlushBuffers

Riservato per utilizzi futuri. Se questo flag viene specificato, l'API restituirà JET_errInvalidgrbit.

JET_bitIdleStatus

Restituisce JET_wrnIdleFull se l'archivio versioni è più della metà pieno.

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_errInvalidParameter

Parametro grbit fornito all'API non valido.

Se questa funzione ha esito positivo, verrà attivata l'operazione appropriata o un codice di errore che indica come l'archivio delle versioni completo dipende dal grbit fornito.

Se questa funzione ha esito negativo, l'operazione richiesta non verrà completata correttamente.

Commenti

L'archivio delle versioni gestisce il meccanismo di isolamento dello snapshot di ESE. Se l'archivio versioni è più della metà completa, il programma potrebbe chiudere le transazioni a esecuzione prolungata. Se una transazione con esecuzione prolungata esaurisce l'archivio delle versioni, ESE interromperà le operazioni di scrittura nel database.

Requisiti

Requisito Valore

Client

Richiede Windows Vista, Windows XP o Windows 2000 Professional.

Server

Richiede Windows Server 2008, Windows Server 2003 o Windows 2000 Server.

Intestazione

Dichiarato in Esent.h.

Libreria

Usare ESENT.lib.

DLL

Richiede ESENT.dll.

Vedere anche

JET_ERR
JET_GRBIT
JET_SESID
JetCommitTransaction