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 über ein Ereignis zu informieren, das Onlinedefragmentierung und Cursorzustandsbenachrichtigungen umfasst.
Unter JET_CBTYP finden Sie spezifische Einstellungen, die für die Parameter dieser Funktion verwendet werden sollen, da sich diese Einstellungen abhängig von der JET_CBTYP Option 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 erfolgt.
Dbid
Die Datenbank, für die der Rückruf erfolgt.
tableid
Der Cursor, für den der Rückruf ausgeführt wird.
cbtyp
Der Punkt im Vorgang, an dem der Rückruf erfolgt. Unter JET_CBTYP finden Sie jeweils eine Liste der Werte und die Bedeutung der folgenden Parameter.
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 rückruf, der von der Datenbank-Engine unterstützt wird, 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 rückruf, der von der Datenbank-Engine unterstützt wird, 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 rückruf, der von der Datenbank-Engine unterstützt wird, 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 rückruf, der von der Datenbank-Engine unterstützt wird, finden Sie unter JET_CBTYP.
Rückgabewert
Die Funktion gibt einen der Extensible Storage Engine-Fehlercodeszurück. Informationen zum Zurückgeben dieser Codes als HRESULTs finden Sie unter Extensible Storage Engine Errors. 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 kann der Vorgang, der den Rückruf ausgegeben hat, normal fortgesetzt werden oder fehlschlagen. 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 auch bei diesen Einschränkungen weiterhin fehlschlägt.
Requirements (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. |
Header |
Deklariert in Esent.h. |