JET_CALLBACK回调函数

适用于： Windows |Windows Server

JET_CALLBACK回调函数

JET_CALLBACK函数是数据库引擎用于通知应用程序涉及联机碎片整理和游标状态通知的事件的多用途回调函数。

有关要用于此函数参数的特定设置，请参阅JET_CBTYP，因为这些设置将有所不同，具体取决于选择用于 cbtyp 参数的JET_CBTYP选项。

    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
    );

参数

sesid

要为其进行回调的会话。

dbid

要为其执行回调的数据库。

tableid

要对其执行回调的游标。

cbtyp

执行回调的操作中的点。 有关值列表以及每个情况下以下参数的含义，请参阅 JET_CBTYP 。

pvArg1

用于使用回调与应用程序通信的参数。 有关对数据库引擎支持的每个回调使用此参数的信息，请参阅 JET_CBTYP 。

pvArg2

用于使用回调与应用程序通信的参数。 有关对数据库引擎支持的每个回调使用此参数的信息，请参阅 JET_CBTYP 。

pvContext

用于使用回调与应用程序通信的参数。 有关对数据库引擎支持的每个回调使用此参数的信息，请参阅 JET_CBTYP 。

ulUnused

用于使用回调与应用程序通信的参数。 有关对数据库引擎支持的每个回调使用此参数的信息，请参阅 JET_CBTYP 。

返回值

函数返回 可扩展存储引擎错误代码之一。 有关如何将这些代码作为 HRESULT 返回的信息，请参阅 可扩展存储引擎错误。 成功后，发出回调的操作可以正常进行。 在某些情况下，回调可能会返回影响该操作的警告。 有关操作使用这些警告的信息，请参阅 JET_CBTYP 。

失败时，发出回调的操作可能会正常进行，也可能失败。 有关操作使用错误代码的信息，请参阅 JET_CBTYP 。

备注

如果回调将游标传递给应用程序，则必须知道此游标被有意限制为一组较小的功能，以避免递归和其他丑陋。 允许执行以下操作：

• JetDupCursor

• JetEnumerateColumns

• JetGetBookmark

• JetGetCurrentIndex

• JetGetCursorInfo

• JetGetLS

• JetGetRecordPosition

• JetGetSecondaryIndexBookmark

• JetGetTableColumnInfo

• JetGetTableIndexInfo

• JetGetTableInfo

• JetRegisterCallback

• JetRetrieveColumn

• JetRetrieveColumns

• JetRetrieveKey

• JetSetColumn

• JetSetColumns

• JetSetLS

• JetUnregisterCallback

设计回调时，请注意，即使存在这些限制，回调仍可能失败。

要求

要求	值
客户端	需要 Windows Vista、Windows XP 或 Windows 2000 Professional。
服务器	需要 Windows Server 2008、Windows Server 2003 或 Windows 2000 Server。
标头	在 Esent.h 中声明。

另请参阅

JET_API_PTR
JET_DBID
JET_SESID
JET_TABLEID
JET_CBTYP