JET_CALLBACK Rückruffunktion

  • Artikel

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.

Weitere Informationen

JET_API_PTR
JET_DBID
JET_SESID
JET_TABLEID
JET_CBTYP