Freigeben über


JET_CBTYP

Letzte Änderung: Freitag, 27. Februar 2015

Gilt für: Windows | Windows Server

JET_CBTYP

Die JET_CBTYP -Gruppe von Konstanten werden alle möglichen Punkt in einem Vorgang, dass die Datenbank-Engine eine Anwendung informiert wird durch Aufrufen der Rückruffunktion JET_CALLBACK beschrieben. Die Datenbank-Engine übergibt eine der folgenden Konstanten im Cbtyp -Parameter der Callback-Funktion. Die Bedeutung der anderen Parameter wird von der Datenbank-Engine in diesem Aufruf übergeben, abhängig von bestimmten JET_CBTYP übergeben.

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

Konstante-Wert

Beschreibung

JET_cbtypNull
0x00000000

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

JET_cbtypFinalize
0x00000001

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

JET_cbtypBeforeInsert
0x00000002

Dieser Rückruf, tritt auf, unmittelbar bevor ein neuer Datensatz in einer Tabelle durch einen Aufruf von JetUpdateeingefügt wird.

Der Funktionszeiger aus diesem Grund Rückruf entweder über JET_TABLECREATE an JetCreateTableColumnIndex übergeben oder zur Laufzeit mittels JetRegisterCallbackkonfiguriert ist. Weitere Informationen finden Sie unter JET_TABLECREATE oder JetRegisterCallback.

Die Callback-Parameter werden die folgenden Werte haben:

  • Sesid: die Sitzung mit dem Datensatz, eingefügt werden soll.

  • DBID: die Datenbank-ID der Tabelle mit dem Datensatz, eingefügt werden soll.

  • TableID: der Cursor, der den neuen Datensatz eingefügt werden soll vorbereitet hat. Es ist wichtig, beachten Sie, dass der Wert der Version oder automatische Inkrementierung Spalten möglicherweise nicht richtig zu diesem Zeitpunkt.

  • pvArg1: NULL

  • pvArg2: NULL

  • PvContext: der Kontext-Zeiger auf JetRegisterCallback oder NULLübergeben.

  • UlUnused:, NULL, Wenn ein Fehler von der Rückruf zurückgegeben wird, wird der Vorgang, die den Rückruf getätigt mit diesem Fehler fehl.

JET_cbtypAfterInsert
0x00000004

Dieser Rückruf, tritt auf, unmittelbar nachdem ein neuer Datensatz in einer Tabelle durch einen Aufruf von JetUpdate eingefügt wurde, jedoch bevor JetUpdate an die aufrufende zurückgibt.

Der Funktionszeiger aus diesem Grund Rückruf entweder über JET_TABLECREATE an JetCreateTableColumnIndex übergeben oder zur Laufzeit mittels JetRegisterCallbackkonfiguriert ist. Weitere Informationen finden Sie unter JET_TABLECREATE oder JetRegisterCallback.

Die Callback-Parameter werden die folgenden Werte haben:

  • Sesid: die Sitzung, die den Datensatz enthält, die gerade eingefügt wurde.

  • DBID: die Datenbank-ID der Tabelle, die den Datensatz enthält, die gerade eingefügt wurde.

  • TableID: ein Cursor auf die Tabelle, in die der Datensatz, der gerade hinzugefügt wurde. Beachten Sie, dass der Cursor weiterhin auf die gleiche Indexeintrag positioniert wird, wie in der Callback vor dem Einfügen. Beachten Sie, dass diese Indexeintrag kann nicht in eine Möglichkeit, dass der Datensatz eingefügt wird im Zusammenhang weiter.

  • pvArg1: NULL

  • pvArg2: NULL

  • PvContext: der Kontext-Zeiger auf JetRegisterCallback oder NULLübergeben.

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

JET_cbtypBeforeReplace
0x00000008

Dieser Rückruf tritt kurz vor dem ein vorhandener Datensatz in einer Tabelle, die durch einen Aufruf von JetUpdategeändert wird.

Der Funktionszeiger aus diesem Grund Rückruf entweder über JET_TABLECREATE an JetCreateTableColumnIndex übergeben oder zur Laufzeit mittels JetRegisterCallbackkonfiguriert ist. Weitere Informationen finden Sie unter JET_TABLECREATE oder JetRegisterCallback.

Die Callback-Parameter werden die folgenden Werte haben:

  • Sesid: die Sitzung mit der Datensatz geändert werden muss.

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

  • TableID: einen Cursor auf einen Indexeintrag zugeordnet zu ändernden Datensatz positioniert. Es ist wichtig, beachten Sie, dass der Wert der Version oder automatische Inkrementierung Spalten möglicherweise nicht richtig zu diesem Zeitpunkt.

  • pvArg1: NULL

  • pvArg2: NULL

  • PvContext: der Kontext-Zeiger auf JetRegisterCallback oder NULLübergeben.

  • UlUnused:, NULL, Wenn ein Fehler von der Rückruf zurückgegeben wird, wird der Vorgang, die den Rückruf getätigt mit diesem Fehler fehl.

JET_cbtypAfterReplace
0x00000010

Dieser Rückruf, tritt auf, unmittelbar nachdem ein vorhandener Datensatz in einer Tabelle durch einen Aufruf für JetUpdate , jedoch vor dem JetUpdate Rückgabe an die aufrufende geändert wurde.

Der Funktionszeiger aus diesem Grund Rückruf entweder über JET_TABLECREATE an JetCreateTableColumnIndex übergeben oder zur Laufzeit mittels JetRegisterCallbackkonfiguriert ist. Weitere Informationen finden Sie unter JET_TABLECREATE oder JetRegisterCallback.

Die Callback-Parameter werden die folgenden Werte haben:

  • Sesid: die Sitzung, die den Datensatz enthält, die gerade geändert wurde.

  • DBID: die Datenbank-ID der Tabelle, die den Datensatz enthält, die gerade geändert wurde.

  • TableID: einen Cursor auf einen Indexeintrag dem Datensatz, der soeben geänderten zugeordnet positioniert.

  • pvArg1: NULL

  • pvArg2: NULL

  • PvContext: der Kontext-Zeiger auf JetRegisterCallback oder NULLübergeben.

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

JET_cbtypBeforeDelete
0x00000020

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

Der Funktionszeiger aus diesem Grund Rückruf entweder über JET_TABLECREATE an JetCreateTableColumnIndex übergeben oder zur Laufzeit mittels JetRegisterCallbackkonfiguriert ist. Weitere Informationen finden Sie unter JET_TABLECREATE oder JetRegisterCallback.

Die Callback-Parameter werden die folgenden Werte haben:

  • Sesid: die Sitzung, die den zu löschenden Datensatz hat.

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

  • TableID: einen Cursor auf einen Indexeintrag zugeordnet zu löschenden Datensatz positioniert.

  • pvArg1: NULL

  • pvArg2: NULL

  • PvContext: der Kontext-Zeiger auf JetRegisterCallback oder NULLübergeben.

  • UlUnused:, NULL, Wenn ein Fehler von der Rückruf zurückgegeben wird, wird der Vorgang, die den Rückruf getätigt mit diesem Fehler fehl.

JET_cbtypAfterDelete
0x00000040

Dieser Rückruf, tritt auf, unmittelbar nachdem ein vorhandener Datensatz in einer Tabelle durch einen Aufruf von JetDelete gelöscht wurde, jedoch bevor JetDelete an die aufrufende zurückgibt.

Der Funktionszeiger aus diesem Grund Rückruf entweder über JET_TABLECREATE an JetCreateTableColumnIndex übergeben oder zur Laufzeit mittels JetRegisterCallbackkonfiguriert ist. Weitere Informationen finden Sie unter JET_TABLECREATE oder JetRegisterCallback.

Die Callback-Parameter werden die folgenden Werte haben:

  • Sesid: die Sitzung mit dem Datensatz, der soeben gelöschten.

  • DBID: die Datenbank-ID der Tabelle, die den Datensatz enthält, die gerade gelöscht wurde.

  • TableID: einen Cursor auf einen Indexeintrag dem Datensatz, der soeben gelöschten zugeordnete positioniert.

  • pvArg1: NULL

  • pvArg2: NULL

  • PvContext: der Kontext-Zeiger auf JetRegisterCallback oder NULLübergeben.

  • UlUnused: NULL

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

JET_cbtypUserDefinedDefaultValue
0x00000080

Dieser Rückruf tritt auf, wenn das Modul muss zum Abrufen des Benutzers Standardwert einer Spalte aus der Anwendung definiert. Dieser Rückruf ist im Wesentlichen eine begrenzte Implementierung der JetRetrieveColumn , die von der Anwendung ausgewertet wird. Ein Maximum von einem Spaltenwert kann für einen benutzerdefinierten Standardwert zurückgegeben werden.

Der Funktionszeiger aus diesem Grund Rückruf ist entweder über eine JET_USERDEFINEDDEFAULT Struktur JetAddColumn übergeben oder JetCreateTableColumnIndex über eine JET_USERDEFINEDDEFAULT -Struktur in einer JET_COLUMNCREATE Struktur in einer Struktur JET_TABLECREATE übergeben.

Die Callback-Parameter werden die folgenden Werte haben:

  • Sesid: definierten Standardwert entsprechend die Sitzung, die den Benutzer computing

  • DBID: definierten Standardwert entsprechend die Datenbank-ID der Tabelle, die den Benutzer enthält

  • TableID: ein Cursor auf den Eintrag für die vom Benutzer Standardwert definierten positioniert wird abgerufen

  • pvArg1: definierten Standardwert entsprechend der Ausgabepuffer für den Benutzer

  • pvArg2: bei der Eingabe ist dies die Größe des Ausgabepuffers. Dies ist bei der Ausgabe der tatsächlichen Größe der der Standardwert der benutzerdefinierten. in beiden Fällen wird die Größe einer 32-Bit-Ganzzahl ohne Vorzeichen.

  • PvContext: ein Zeiger auf einen Puffer mit der Benutzerdaten in den JET_USERDEFINEDDEFAULT angegebenen Struktur, wenn die Spalte erstellt wurde, oder NULL, wenn kein Kontext bereitgestellt wurde.

  • UlUnused: der Spalte ID der Spalte, für die vom Benutzer Standardwert definierten, abgerufen wird.

Wenn ein Fehler, durch den Rückruf zurückgegeben wird schlägt der Vorgang, den Rückruf getätigt mit diesem Fehler fehl.

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

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

JET_cbtypOnlineDefragCompleted
0x00000100

Dieser Rückruf tritt auf, wenn die online-Defragmentierung einer Datenbank wie von JetDefragment initiiert aufgrund der Vorgang abgeschlossen wird oder das Zeitlimit überschritten wird beendet wurde.

Der Funktionszeiger aus diesem Grund Rückruf wird an JetDefragmentübergeben. Weitere Informationen finden Sie unter JetDefragment.

Die Callback-Parameter werden die folgenden Werte haben:

  • Sesid: die Sitzung zum Ausführen von online-Defragmentierung für die Datenbank oder JET_sesidNil für eine streaming-Datei verwendet.

  • DBID: die Datenbank-ID der Datenbank Defragmentierung oder JET_dbidNil für eine streaming-Datei.

  • TableID: JET_tableidNil

  • pvArg1: NULL

  • pvArg2: NULL

  • PvContext: NULL

  • UlUnused: NULL

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

JET_cbtypFreeCursorLS
0x00000200

Dieser Rückruf tritt auf, wenn die Anwendung Kontextnummer für den lokalen Speicher mit einen Cursor, der von der Datenbank-Engine veröffentlichten bereinigen muss. Weitere Informationen finden Sie unter JetSetLS.

Der Funktionszeiger aus diesem Grund Rückruf ist über JetSetSystemParameter mit JET_paramRuntimeCallbackkonfiguriert.

Die Callback-Parameter werden die folgenden Werte haben:

  • Sesid: JET_sesidNil

  • DBID: JET_dbidNil

  • TableID: JET_tableidNil

  • pvArg1: Kontextnummer mit JetSetLS festgelegt

  • pvArg2: NULL

  • PvContext: NULL

  • UlUnused: NULL

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

JET_cbtypFreeTableLS
0x00000400

Dieser Rückruf erfolgt als Ergebnis der die Notwendigkeit für die Anwendung zu bereinigen, die einer Tabelle, die von der Datenbank-Engine veröffentlichten Kontextnummer für den lokalen Speicher zugeordnet. Weitere Informationen finden Sie unter JetSetLS.

Der Funktionszeiger aus diesem Grund Rückruf ist über JetSetSystemParameter mit JET_paramRuntimeCallbackkonfiguriert.

Die Callback-Parameter werden die folgenden Werte haben:

  • Sesid: JET_sesidNil

  • DBID: JET_dbidNil

  • TableID: JET_tableidNil

  • pvArg1: Kontextnummer mit JetSetLSfestgelegt.

  • pvArg2: NULL

  • PvContext: NULL

  • UlUnused: NULL

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

Voraussetzungen

-Client,

Erfordert Windows Vista oder Windows XP.

Server

Erfordert WindowsServer 2008 oder WindowsServer 2003.

Kopfzeile

In Esent.h deklariert.

Siehe auch

JET_CALLBACK