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.

Weitere Informationen

JET_API_PTR
JET_DBID
JET_SESID
JET_TABLEID
JET_CBTYP