適用于: Windows |Windows Server
JetUnregisterCallback 函式
JetUnregisterCallback函式可讓應用程式設定資料庫引擎停止發出通知給應用程式,如先前透過JetRegisterCallback要求一樣。
Windows XP:JetUnregisterCallback 是在 Windows XP 中引進。
JET_ERR JET_API JetUnregisterCallback(
__in JET_SESID sesid,
__in JET_TABLEID tableid,
__in JET_CBTYP cbtyp,
__in JET_HANDLE hCallbackId
);
參數
sesid
要用於這個呼叫的會話。
tableid
要用於這個呼叫的資料指標。
cbtyp
由應用程式不再想要接收通知的回呼原因所組成的位元遮罩。
若要建立這個位元遮罩,只要或結合來自 JET_CBTYP 列舉的有效回呼原因即可。
hCallbackId
JetRegisterCallback所傳回之已註冊回呼的控制碼。
傳回值
此函式會傳回具有下列其中一個傳回碼 的JET_ERR 資料類型。 如需可能 ESE 錯誤的詳細資訊,請參閱 可延伸的儲存引擎錯誤 和 錯誤處理參數。
傳回碼 |
Description |
|---|---|
JET_errSuccess |
作業已成功完成。 |
JET_errClientRequestToStopJetService |
作業無法完成,因為與會話相關聯的實例上的所有活動都因為對 JetStopService的呼叫而停止。 |
JET_errInstanceUnavailable |
作業無法完成,因為與會話相關聯的實例發生嚴重錯誤,需要撤銷所有資料的存取權,以保護該資料的完整性。 Windowsxp: 此傳回值會在 Windows XP 中引進。 |
JET_errNotInitialized |
作業無法完成,因為與會話相關聯的實例尚未初始化。 |
JET_errRestoreInProgress |
作業無法完成,因為與會話相關聯的實例上正在進行還原作業。 |
JET_errSessionSharingViolation |
同一個會話不能同時用於多個執行緒。 Windowsxp: 此傳回值會在 Windows XP 中引進。 |
JET_errTermInProgress |
作業無法完成,因為與會話相關聯的實例正在關閉。 |
如果此函式成功,則會取消註冊指定的回呼,因為指定的回呼原因與指定資料指標相關聯的資料表。 不會變更資料庫狀態。
如果此函式失敗,將不會取消註冊指定的回呼。 不會變更資料庫狀態。
備註
指定的位元遮罩應該完全符合註冊回呼時指定的位元遮罩。 資料庫引擎目前不支援移除這些通知的子集,而且在嘗試此動作時不會傳回錯誤。
規格需求
| 需求 | 值 |
|---|---|
用戶端 |
需要 Windows Vista 或 Windows XP。 |
Server |
需要 Windows Server 2008 或 Windows Server 2003。 |
標頭 |
在 Esent.h 中宣告。 |
程式庫 |
使用 ESENT.lib。 |
Dll |
需要ESENT.dll。 |
另請參閱
JET_CBTYP
JET_ERR
JET_HANDLE
JET_SESID
JET_TABLEID
JetRegisterCallback
JetStopService