JetInit2 函式
適用于: Windows |Windows Server
JetInit2 函式
JetInit2函式會將資料庫引擎置於可支援應用程式使用資料庫檔案的狀態。 引擎必須已經正確設定,才能使用 JetSetSystemParameter進行初始化。 資料庫當機復原會在初始化過程中自動執行。
Windows XP:JetInit2 是在 Windows XP 中引進。
此函式已過時。 請改用 JetInit3 。
JET_ERR JET_API JetInit2(
__in_out_opt JET_INSTANCE* pinstance,
__in JET_GRBIT grbit
);
參數
pinstance
要用於這個呼叫的 實例。
若為 Windows 2000,則會忽略此參數,且一律為 Null。
針對 Windows XP 和更新版本,此參數的使用取決於引擎的作業模式。 如果引擎在舊版模式中運作 (Windows 2000 相容性模式) 只支援一個實例,則此參數可能是 Null,或者它可能會設定為包含 Null 的有效輸出緩衝區,或 JET_instanceNil傳回建立為初始化副作用的全域實例控制碼。 然後,這個實例控制碼可以傳遞至任何其他採用 實例的 API。 如果引擎是以多重實例模式運作,這個參數必須設定為有效的輸入緩衝區,其中包含正在初始化之 JetCreateInstance 所傳回的實例控制碼。
grbit
指定下列零個或多個選項的位群組。
值 |
意義 |
---|---|
JET_bitReplayReplicatedLogFiles |
保留供未來使用。 |
JET_bitCreateSFSVolumeIfNotExist |
保留供未來使用。 |
JET_bitReplayIgnoreMissingDB |
此選項可讓使用者在一組記錄檔上執行復原,而不需要所有資料庫都已附加在記錄集的一個點。 |
JET_bitRecoveryWithoutUndo |
執行復原,但在復原階段停止。 這可讓其他交易記錄複製到 並套用。 |
JET_bitTruncateLogsAfterRecovery |
在成功的軟復原時,截斷記錄檔。 |
JET_bitReplayMissingMapEntryDB |
遺漏資料庫對應專案預設為相同的位置。 |
JET_bitReplayIgnoreLostLogs |
忽略記錄資料流程結尾遺失的記錄。 Windows 7:JET_bitReplayIgnoreLostLogs 是在 Windows 7 中引進。 |
傳回值
此函式會傳回具有下列其中一個傳回碼 的JET_ERR 資料類型。 如需可能 ESE 錯誤的詳細資訊,請參閱 可延伸的儲存引擎錯誤 和 錯誤處理參數。
備註
實例必須先使用 JetInit2 的呼叫初始化,才能由 JetSetSystemParameter以外的任何專案使用。
即使從未使用JetInit初始化該實例,仍會透過JetTerm函式的呼叫來終結實例。 實例是資料庫引擎的復原能力單位。 它會控制用來保護一組資料庫檔案中資料完整性的所有檔案生命週期。 這些檔案包括檢查點檔案和交易記錄檔。
如果復原是在一組記錄上執行,但並非所有資料庫都存在 (,這會在一般情況下傳回錯誤JET_errAttachedDatabaseMismatch) ,而用戶端希望即使遺漏資料庫仍繼續復原,JET_ bitReplayIgnoreMissingDB 會用來繼續復原可用的資料庫。
如需詳細資訊,請參閱 JetInit 中的一節。
規格需求
需求 | 值 |
---|---|
用戶端 |
需要 Windows Vista 或 Windows XP。 |
Server |
需要 Windows Server 2008 或 Windows Server 2003。 |
標頭 |
在 Esent.h 中宣告。 |
程式庫 |
使用 ESENT.lib。 |
Dll |
需要ESENT.dll。 |
另請參閱
可延伸儲存引擎檔案
JET_ERR
JET_GRBIT
JET_INSTANCE
JetCreateInstance
JetInit
JetInit3
JetSetSystemParameter
資源參數