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 。
備註
如果回呼將游標傳遞至應用程式,請務必知道此資料指標刻意受限於較小的功能集,以避免遞迴和其他例外狀況。 允許下列作業:
當您設計回呼時,請考慮到即使有這些限制,回呼仍可能會失敗。
規格需求
需求 | 值 |
---|---|
用戶端 |
需要 Windows Vista、Windows XP 或 Windows 2000 Professional。 |
Server |
需要 Windows Server 2008、Windows Server 2003 或 Windows 2000 Server。 |
標頭 |
在 Esent.h 中宣告。 |