funzione di callback JET_PFNSTATUS

Si applica a: Windows | Windows Server

funzione di callback JET_PFNSTATUS

La funzione di callback JET_PFNSTATUS riceve informazioni sullo stato di avanzamento delle operazioni a esecuzione prolungata, ad esempio la deframmentazione, il backup o le operazioni di ripristino. Durante queste operazioni, il motore di database chiama questa funzione di callback per fornire un aggiornamento sullo stato di avanzamento dell'operazione.

    JET_ERR JET_API JET_PFNSTATUS(
                           JET_SESID  sesid,
                           JET_SNP snp,
                           JET_SNT snt,
                           void* pv
    );

Parametri

sesid

Sessione di tipo JET_SESID con cui è stata chiamata la funzione a esecuzione prolungata.

Snp

Tipo di operazione come specificato in JET_SNP. I tipi di operazioni includono ripristino, compatta, ripristino, backup, aggiornamento, pulizia e aggiornamento del formato del record.

Snt

Stato di un'operazione. I tipi di stato includono l'inizio, il completamento o l'errore. Lo stato verrà specificato con il terzo parametro di tipo JET_SNT.

Pv

Puntatore facoltativo a una struttura di tipo JET_SNPROG.

Valore restituito

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

In caso di esito positivo, l'operazione che ha rilasciato il callback può procedere normalmente. In alcuni casi, il callback potrebbe restituire un avviso che influisce su tale operazione.

In caso di errore, l'operazione che ha generato il callback potrebbe procedere normalmente o potrebbe non riuscire.

Commenti

Questa funzione di callback verrà usata in una notifica di stato in cui la struttura indicherà lo stato corrente dello stato di avanzamento. Si noti che la funzione di callback potrebbe essere chiamata più volte per lo stato di avanzamento dell'operazione.

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.

Vedere anche

Codici di errore del motore di archiviazione estendibili
Errori del motore di archiviazione estendibili
JET_SESID
JET_SNP
JET_SNPROG
JET_SNT