JET_CBTYP

Gilt für: Windows | Windows Server

JET_CBTYP

Die JET_CBTYP Gruppe von Konstanten beschreibt alle möglichen Punkte in einem Vorgang, die die Datenbank-Engine eine Anwendung benachrichtigt, indem sie die JET_CALLBACK Rückruffunktion aufruft. Die Datenbank-Engine übergibt eine dieser Konstanten im cbtyp-Parameter der Rückruffunktion. Die Bedeutung der anderen Parameter, die von der Datenbank-Engine in diesem Aufruf übergeben werden, hängt von der jeweiligen übergebenen JET_CBTYP ab.

Windows XP: Die JET_CBTYP Gruppe von Konstanten wird in Windows XP eingeführt.

Konstante/Wert

BESCHREIBUNG

JET_cbtypNull
0x00000000

Dieser Rückruf ist reserviert und gilt immer als ungültig.

JET_cbtypFinalize
0x00000001

Dieser Rückruf ist für die zukünftige Verwendung reserviert.

JET_cbtypBeforeInsert
0x00000002

Dieser Rückruf erfolgt unmittelbar bevor ein neuer Datensatz durch einen Aufruf von JetUpdatein eine Tabelle eingefügt wird.

Der Funktionszeiger für diesen Rückrufgrund wird entweder über JET_TABLECREATE an JetCreateTableColumnIndex übergeben oder zur Laufzeit mithilfe von JetRegisterCallbackkonfiguriert. Weitere Informationen finden Sie unter JET_TABLECREATE oder JetRegisterCallback.

Die Rückrufparameter haben die folgenden Werte:

  • sesid:Die Sitzung mit dem einzufügenden Datensatz.

  • dbid:Die Datenbank-ID der Tabelle, die den einzufügenden Datensatz enthält.

  • tableid:Der Cursor, der das Einfügen des neuen Datensatzes vorbereitet hat. Es ist wichtig zu beachten, dass der Wert von Versionsspalten oder Spalten mit automatischem Inkrement derzeit möglicherweise nicht korrekt ist.

  • pvArg1: NULL

  • pvArg2: NULL

  • pvContext:Der Kontextzeiger, der an JetRegisterCallback oder NULLübergeben wird.

  • ulUnused: NULL Wenn vom Rückruf ein Fehler zurückgegeben wird, schlägt der Vorgang, der den Rückruf verursacht, mit diesem Fehler fehl.

JET_cbtypAfterInsert
0x00000004

Dieser Rückruf erfolgt unmittelbar nach dem Einfügen eines neuen Datensatzes in eine Tabelle durch einen Aufruf von JetUpdate, aber bevor JetUpdate zum Aufrufer zurückkehrt.

Der Funktionszeiger für diesen Rückrufgrund wird entweder über JET_TABLECREATE an JetCreateTableColumnIndex übergeben oder zur Laufzeit mithilfe von JetRegisterCallbackkonfiguriert. Weitere Informationen finden Sie unter JET_TABLECREATE oder JetRegisterCallback.

Die Rückrufparameter haben die folgenden Werte:

  • sesid:Die Sitzung mit dem Datensatz, der gerade eingefügt wurde.

  • dbid:Die Datenbank-ID der Tabelle, die den soeben eingefügten Datensatz enthält.

  • tableid:Ein Cursor für die Tabelle, in die der soeben eingefügte Datensatz eingefügt wurde. Beachten Sie, dass der Cursor immer noch auf demselben Indexeintrag positioniert ist, wie er sich im Voreinfügerückruf befand. Beachten Sie außerdem, dass dieser Indexeintrag möglicherweise nicht mit dem eingefügten Datensatz verknüpft ist.

  • pvArg1: NULL

  • pvArg2: NULL

  • pvContext:Der Kontextzeiger, der an JetRegisterCallback oder NULLübergeben wird.

  • ulUnused: NULL Wenn vom Rückruf ein Fehler zurückgegeben wird, wird er ignoriert.

JET_cbtypBeforeReplace
0x00000008

Dieser Rückruf erfolgt unmittelbar bevor ein vorhandener Datensatz in einer Tabelle durch einen Aufruf von JetUpdategeändert wird.

Der Funktionszeiger für diesen Rückrufgrund wird entweder über JET_TABLECREATE an JetCreateTableColumnIndex übergeben oder zur Laufzeit mithilfe von JetRegisterCallbackkonfiguriert. Weitere Informationen finden Sie unter JET_TABLECREATE oder JetRegisterCallback.

Die Rückrufparameter haben die folgenden Werte:

  • sesid:Die Sitzung, deren Datensatz geändert werden soll.

  • dbid:Die Datenbank-ID der Tabelle, die den zu ändernden Datensatz enthält.

  • tableid:Ein Cursor, der auf einem Indexeintrag positioniert ist, der dem zu ändernden Datensatz zugeordnet ist. Es ist wichtig zu beachten, dass der Wert von Versionsspalten oder Spalten mit automatischem Inkrement derzeit möglicherweise nicht korrekt ist.

  • pvArg1: NULL

  • pvArg2: NULL

  • pvContext:Der Kontextzeiger, der an JetRegisterCallback oder NULLübergeben wird.

  • ulUnused: NULL Wenn vom Rückruf ein Fehler zurückgegeben wird, schlägt der Vorgang, der den Rückruf verursacht, mit diesem Fehler fehl.

JET_cbtypAfterReplace
0x00000010

Dieser Rückruf erfolgt unmittelbar, nachdem ein vorhandener Datensatz in einer Tabelle durch einen Aufruf von JetUpdate geändert wurde, aber bevor JetUpdate zu seinem Aufrufer zurückkehrt.

Der Funktionszeiger für diesen Rückrufgrund wird entweder über JET_TABLECREATE an JetCreateTableColumnIndex übergeben oder zur Laufzeit mithilfe von JetRegisterCallbackkonfiguriert. Weitere Informationen finden Sie unter JET_TABLECREATE oder JetRegisterCallback.

Die Rückrufparameter haben die folgenden Werte:

  • sesid:Die Sitzung mit dem Datensatz, der gerade geändert wurde.

  • dbid:Die Datenbank-ID der Tabelle, die den soeben geänderten Datensatz enthält.

  • tableid:Ein Cursor, der auf einem Indexeintrag positioniert ist, der dem gerade geänderten Datensatz zugeordnet ist.

  • pvArg1: NULL

  • pvArg2: NULL

  • pvContext:Der Kontextzeiger, der an JetRegisterCallback oder NULLübergeben wird.

  • ulUnused: NULL Wenn vom Rückruf ein Fehler zurückgegeben wird, wird er ignoriert.

JET_cbtypBeforeDelete
0x00000020

Dieser Rückruf erfolgt unmittelbar bevor ein vorhandener Datensatz in einer Tabelle durch einen Aufruf von JetDeletegelöscht wird.

Der Funktionszeiger für diesen Rückrufgrund wird entweder über JET_TABLECREATE an JetCreateTableColumnIndex übergeben oder zur Laufzeit mithilfe von JetRegisterCallbackkonfiguriert. Weitere Informationen finden Sie unter JET_TABLECREATE oder JetRegisterCallback.

Die Rückrufparameter haben die folgenden Werte:

  • sesid:Die Sitzung, in der der Datensatz gelöscht werden soll.

  • dbid:Die Datenbank-ID der Tabelle, die den zu löschenden Datensatz enthält.

  • tableid:Ein Cursor, der auf einem Indexeintrag positioniert ist, der dem zu löschenden Datensatz zugeordnet ist.

  • pvArg1: NULL

  • pvArg2: NULL

  • pvContext:Der Kontextzeiger, der an JetRegisterCallback oder NULLübergeben wird.

  • ulUnused: NULL Wenn vom Rückruf ein Fehler zurückgegeben wird, schlägt der Vorgang, der den Rückruf verursacht, mit diesem Fehler fehl.

JET_cbtypAfterDelete
0x00000040

Dieser Rückruf erfolgt unmittelbar nach dem Löschen eines vorhandenen Datensatzes in einer Tabelle durch einen Aufruf von JetDelete, aber bevor JetDelete zu seinem Aufrufer zurückkehrt.

Der Funktionszeiger für diesen Rückrufgrund wird entweder über JET_TABLECREATE an JetCreateTableColumnIndex übergeben oder zur Laufzeit mithilfe von JetRegisterCallbackkonfiguriert. Weitere Informationen finden Sie unter JET_TABLECREATE oder JetRegisterCallback.

Die Rückrufparameter haben die folgenden Werte:

  • sesid:Die Sitzung mit dem Datensatz, der gerade gelöscht wurde.

  • dbid:Die Datenbank-ID der Tabelle, die den soeben gelöschten Datensatz enthält.

  • tableid:Ein Cursor, der auf einem Indexeintrag positioniert ist, der dem gerade gelöschten Datensatz zugeordnet ist.

  • pvArg1: NULL

  • pvArg2: NULL

  • pvContext:Der Kontextzeiger, der an JetRegisterCallback oder NULLübergeben wird.

  • ulUnused: NULL

Wenn vom Rückruf ein Fehler zurückgegeben wird, wird er ignoriert.

JET_cbtypUserDefinedDefaultValue
0x00000080

Dieser Rückruf tritt auf, wenn die Engine den benutzerdefinierten Standardwert einer Spalte aus der Anwendung abrufen muss. Dieser Rückruf ist im Wesentlichen eine eingeschränkte Implementierung von JetRetrieveColumn, die von der Anwendung ausgewertet wird. Für einen benutzerdefinierten Standardwert kann maximal ein Spaltenwert zurückgegeben werden.

Der Funktionszeiger für diesen Rückrufgrund wird entweder mit einer JET_USERDEFINEDDEFAULT-Struktur an JetAddColumn übergeben oder an JetCreateTableColumnIndex mit einer JET_USERDEFINEDDEFAULT-Struktur in einer JET_COLUMNCREATE-Struktur in einer JET_TABLECREATE-Struktur übergeben.

Die Rückrufparameter verfügen über die folgenden Werte:

  • sesid:Die Sitzung, die den benutzerdefinierten Standardwert abrechnt

  • dbid:Die Datenbank-ID der Tabelle, die den benutzerdefinierten Standardwert enthält.

  • tableid:Ein Cursor, der auf dem Datensatz positioniert ist, für den der benutzerdefinierte Standardwert abgerufen wird.

  • pvArg1:Der Ausgabepuffer für den benutzerdefinierten Standardwert

  • pvArg2:Bei der Eingabe ist dies die Größe des Ausgabepuffers. Bei der Ausgabe ist dies die tatsächliche Größe des benutzerdefinierten Standardwerts. In beiden Fällen ist die Größe eine 32-Bit-Ganzzahl ohne Vorzeichen.

  • pvContext:Ein Zeiger auf einen Puffer, der die in der JET_USERDEFINEDDEFAULT-Struktur angegebenen Benutzerdaten enthält, als die Spalte erstellt wurde, oder NULL, wenn kein Kontext angegeben wurde.

  • ulUnused:Die Spalten-ID der Spalte, für die der benutzerdefinierte Standardwert abgerufen wird.

Wenn vom Rückruf ein Fehler zurückgegeben wird, tritt bei dem Vom Rückruf ausgehenden Vorgang ein Fehler auf.

Wenn JET_wrnBufferTruncated Rückruf zurückgegeben wird, wird der Vorgang fortgesetzt, aber der gesamte Wert wird während des Rückrufs nicht abgerufen.

Wenn JET_wrnColumnNull Rückruf zurückgegeben wird, wird der Vorgang fortgesetzt, aber der benutzerdefinierte Standardwert für die Spalte ist NULL.

JET_cbtypOnlineDefragCompleted
0x00000100

Dieser Rückruf tritt auf, wenn die von JetDefragment initiierte Onlinedefragmentierung einer Datenbank beendet wurde, weil der Prozess abgeschlossen oder das Zeitlimit erreicht wurde.

Der Funktionszeiger für diesen Rückrufgrund wird an JetDefragment übergeben. Weitere Informationen finden Sie unter JetDefragment.

Die Rückrufparameter verfügen über die folgenden Werte:

  • sesid:Die Sitzung, die zum Durchführen der Onlinedefragmentierung für die Datenbank oder JET_sesidNil Streamingdatei verwendet wird.

  • dbid:Die Datenbank-ID der Datenbank, die defragmentiert oder JET_dbidNil Streamingdatei erstellt wird.

  • tableid: JET_tableidNil

  • pvArg1: NULL

  • pvArg2: NULL

  • pvContext: NULL

  • ulUnused: NULL

Wenn ein Fehler vom Rückruf zurückgegeben wird, wird er ignoriert.

JET_cbtypFreeCursorLS
0x00000200

Dieser Rückruf tritt auf, wenn die Anwendung das Kontexthandel für die lokale Storage, die einem Cursor zugeordnet ist, der von der Datenbank-Engine freigegeben wird. Weitere Informationen finden Sie unter JetSetLS.

Der Funktionszeiger für diesen Rückrufgrund wird mit jetSetSystemParameter mit JET_paramRuntimeCallback.

Die Rückrufparameter verfügen über die folgenden Werte:

  • sesid: JET_sesidNil

  • dbid: JET_dbidNil

  • tableid: JET_tableidNil

  • pvArg1:Der Kontexthandlsatz mit JetSetLS

  • pvArg2: NULL

  • pvContext: NULL

  • ulUnused: NULL

Wenn ein Fehler vom Rückruf zurückgegeben wird, wird er ignoriert.

JET_cbtypFreeTableLS
0x00000400

Dieser Rückruf tritt auf, weil die Anwendung das Kontexthand handle für die lokale Storage bereinigen muss, die einer Tabelle zugeordnet ist, die von der Datenbank-Engine freigegeben wird. Weitere Informationen finden Sie unter JetSetLS.

Der Funktionszeiger für diesen Rückrufgrund wird mit jetSetSystemParameter mit JET_paramRuntimeCallback.

Die Rückrufparameter verfügen über die folgenden Werte:

  • sesid: JET_sesidNil

  • dbid: JET_dbidNil

  • tableid: JET_tableidNil

  • pvArg1:Das Kontexthandl, das mit JetSetLS festgelegt wurde.

  • pvArg2: NULL

  • pvContext: NULL

  • ulUnused: NULL

Wenn ein Fehler vom Rückruf zurückgegeben wird, wird er ignoriert.

Anforderungen

Anforderung Wert

Client

Erfordert Windows Vista oder Windows XP.

Server

Erfordert Windows Server 2008 oder Windows Server 2003.

Header

Wird in Esent.h deklariert.

Weitere Informationen

JET_CALLBACK