JET_CALLBACK Rückruffunktion
Gilt für: Windows | Windows Server
JET_CALLBACK Rückruffunktion
Die JET_CALLBACK-Funktion ist eine mehrzweckige Rückruffunktion, die von der Datenbank-Engine verwendet wird, um die Anwendung eines Ereignisses mit Onlinedefragmentierung und Cursorzustandsbenachrichtigungen zu informieren.
Unter JET_CBTYP finden Sie spezifische Einstellungen, die für die Parameter dieser Funktion verwendet werden sollen, da sich diese Einstellungen je nach der option JET_CBTYP unterscheiden, die für die Verwendung im cbtyp-Parameter ausgewählt ist.
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
);
Parameter
sesid
Die Sitzung, für die der Rückruf durchgeführt wird.
dbid
Die Datenbank, für die der Rückruf durchgeführt wird.
tableid
Der Cursor, für den der Rückruf durchgeführt wird.
cbtyp
Der Punkt im Vorgang, an dem der Rückruf durchgeführt wird. Eine Liste der Werte und die Bedeutung der jeweils folgenden Parameter finden Sie unter JET_CBTYP .
pvArg1
Ein Parameter, der für die Kommunikation mit der Anwendung mithilfe des Rückrufs verwendet wird. Informationen zur Verwendung dieses Parameters für jeden von der Datenbank-Engine unterstützten Rückruf finden Sie unter JET_CBTYP .
pvArg2
Ein Parameter, der für die Kommunikation mit der Anwendung mithilfe des Rückrufs verwendet wird. Informationen zur Verwendung dieses Parameters für jeden von der Datenbank-Engine unterstützten Rückruf finden Sie unter JET_CBTYP .
pvContext
Ein Parameter, der für die Kommunikation mit der Anwendung mithilfe des Rückrufs verwendet wird. Informationen zur Verwendung dieses Parameters für jeden von der Datenbank-Engine unterstützten Rückruf finden Sie unter JET_CBTYP .
ulUnused
Ein Parameter, der für die Kommunikation mit der Anwendung mithilfe des Rückrufs verwendet wird. Informationen zur Verwendung dieses Parameters für jeden von der Datenbank-Engine unterstützten Rückruf finden Sie unter JET_CBTYP .
Rückgabewert
Die Funktion gibt einen der Fehlercodes der Erweiterbaren Speicher-Engine zurück. Informationen zum Zurückgeben dieser Codes als HRESULTs finden Sie unter Fehler der erweiterbaren Speicher-Engine. Bei Erfolg kann der Vorgang, der den Rückruf ausgegeben hat, normal fortgesetzt werden. In einigen Fällen gibt der Rückruf möglicherweise eine Warnung zurück, die diesen Vorgang beeinflusst. Informationen zur Verwendung dieser Warnungen durch den Vorgang finden Sie unter JET_CBTYP .
Bei einem Fehler wird der Vorgang, der den Rückruf ausgegeben hat, möglicherweise normal fortgesetzt oder schlägt fehl. Informationen zur Verwendung des Fehlercodes durch den Vorgang finden Sie unter JET_CBTYP .
Bemerkungen
Wenn der Rückruf einen Cursor an die Anwendung übergibt, ist es wichtig zu wissen, dass dieser Cursor absichtlich auf einen kleineren Satz von Funktionen beschränkt ist, um Rekursion und andere Hässlichkeiten zu vermeiden. Die folgenden Vorgänge sind zulässig:
Berücksichtigen Sie beim Entwerfen des Rückrufs, dass der Rückruf trotz dieser Einschränkungen weiterhin fehlschlägt.
Anforderungen
| Anforderung | Wert |
|---|---|
Client |
Erfordert Windows Vista, Windows XP oder Windows 2000 Professional. |
Server |
Erfordert Windows Server 2008, Windows Server 2003 oder Windows 2000 Server. |
Kopfzeile |
Deklariert in Esent.h. |