funzione callback JET_CALLBACK

  • Articolo

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.

Vedere anche

JET_API_PTR
JET_DBID
JET_SESID
JET_TABLEID
JET_CBTYP