funzione callback JET_CALLBACK
Si applica a: Windows | Windows Server
funzione callback JET_CALLBACK
La funzione JET_CALLBACK è una funzione di callback multiuso usata dal motore di database per informare l'applicazione di un evento che coinvolge la deframmentazione online e le notifiche dello stato del cursore.
Vedere JET_CBTYP per impostazioni specifiche da usare per i parametri di questa funzione, in quanto queste impostazioni variano a seconda dell'opzione JET_CBTYP selezionata per l'uso nel parametro cbtyp .
JET_ERR JET_API* JET_CALLBACK(
[in] JET_SESID sesid,
[in] JET_DBID dbid,
[in] JET_TABLEID tableid,
[in] JET_CBTYP cbtyp,
[in, out] void* pvArg1,
[in, out] void* pvArg2,
[in] void* pvContext,
[in] JET_API_PTR ulUnused
);
Parametri
sesid
Sessione per la quale viene eseguito il callback.
dbid
Database per il quale viene eseguito il callback.
tableid
Cursore per il quale viene eseguito il callback.
cbtyp
Punto dell'operazione in corrispondenza del quale viene eseguito il callback. Vedere JET_CBTYP per un elenco di valori e il significato dei parametri seguenti in ogni caso.
pvArg1
Parametro utilizzato per comunicare con l'applicazione usando il callback. Per informazioni sull'uso di questo parametro per ogni callback supportato dal motore di database, vedere JET_CBTYP .
pvArg2
Parametro utilizzato per comunicare con l'applicazione usando il callback. Per informazioni sull'uso di questo parametro per ogni callback supportato dal motore di database, vedere JET_CBTYP .
pvContext
Parametro utilizzato per comunicare con l'applicazione usando il callback. Per informazioni sull'uso di questo parametro per ogni callback supportato dal motore di database, vedere JET_CBTYP .
ulUnused
Parametro utilizzato per comunicare con l'applicazione usando il callback. Per informazioni sull'uso di questo parametro per ogni callback supportato dal motore di database, vedere JET_CBTYP .
Valore restituito
La funzione restituisce uno dei codici di errore del motore di archiviazione estendibile. Per informazioni su come restituire questi codici come HRESULT, vedere Errori del motore di archiviazione estendibile. In caso di esito positivo, l'operazione che ha emesso il callback può continuare normalmente. In alcuni casi, il callback può restituire un avviso che influenza tale operazione. Per informazioni sull'uso di questi avvisi da parte dell'operazione, vedere JET_CBTYP.
In caso di errore, l'operazione che ha emesso il callback può continuare normalmente o potrebbe non riuscire. Per informazioni sull'uso del codice di errore da parte dell'operazione, vedere JET_CBTYP.
Commenti
Se il callback passa un cursore all'applicazione, è importante sapere che questo cursore è intenzionalmente limitato a un set più piccolo di funzionalità per evitare ricorsioni e altre ugità. Sono consentite le operazioni seguenti:
Quando si progetta il callback, tenere presente che, anche con queste restrizioni, è comunque possibile che il callback non riesca.
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. |