Funzione JetUnregisterCallback

Articolo
06/13/2023

Si applica a: Windows | Windows Server

Funzione JetUnregisterCallback

La funzione JetUnregisterCallback consente all'applicazione di configurare il motore di database per arrestare l'emissione di notifiche all'applicazione come richiesto in precedenza tramite JetRegisterCallback.

Windows XP:JetUnregisterCallback viene introdotto in Windows XP.

    JET_ERR JET_API JetUnregisterCallback(
      __in          JET_SESID sesid,
      __in          JET_TABLEID tableid,
      __in          JET_CBTYP cbtyp,
      __in          JET_HANDLE hCallbackId
    );

Parametri

sesid

Sessione da usare per questa chiamata.

tableid

Cursore da usare per questa chiamata.

cbtyp

Maschera di bit composta dai motivi di callback che l'applicazione non vuole più ricevere notifiche.

Per creare questa maschera di bit, semplicemente o insieme motivi di callback validi dall'enumerazione JET_CBTYP .

hCallbackId

Handle del callback registrato restituito da JetRegisterCallback.

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_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 viene introdotto in Windows XP.
JET_errNotInitialized	L'operazione non può essere completata perché l'istanza associata alla sessione non è ancora stata inizializzata.
JET_errRestoreInProgress	L'operazione non può essere completata perché un'operazione di ripristino è in corso nell'istanza associata alla sessione.
JET_errSessionSharingViolation	La stessa sessione non può essere usata contemporaneamente per più thread. Windows XP: Questo valore restituito viene introdotto in Windows XP.
JET_errTermInProgress	Impossibile completare l'operazione perché l'istanza associata alla sessione viene arrestata.

Se questa funzione ha esito positivo, il callback specificato verrà annullato per i motivi di callback specificati con la tabella associata al cursore specificato. Non verrà eseguita alcuna modifica allo stato del database.

Se questa funzione non riesce, il callback specificato non verrà registrato. Non verrà eseguita alcuna modifica allo stato del database.

Commenti

La maschera di bit specificata deve corrispondere esattamente alla maschera di bit specificata durante la registrazione del callback. Il motore di database non supporta attualmente la rimozione di un subset di queste notifiche e non restituisce un errore quando viene tentato.

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.

Vedere anche

JET_CBTYP
JET_ERR
JET_HANDLE
JET_SESID
JET_TABLEID
JetRegisterCallback
JetStopService

Condividi tramite

Funzione JetUnregisterCallback