JetEnableMultiInstance 函式

發行項
06/13/2023

適用于： Windows |Windows Server

JetEnableMultiInstance 函式

JetEnableMultiInstance函式會設定資料庫引擎，以便與相同進程中的多個實例搭配使用。全域系統參數的選擇性陣列可供第一個呼叫端使用，允許變更為多重實例模式。

Windows XP：JetEnableMultiInstance 是在 Windows XP 中引進。

    JET_ERR JET_API JetEnableMultiInstance(
      __in_opt      JET_SETSYSPARAM* psetsysparam,
      __in_opt      unsigned long csetsysparam,
      __out_opt     unsigned long* pcsetsucceed
    );

參數

psetsysparam

全域系統參數的陣列，只有在引擎因為這個呼叫而進入多重實例模式時才設定。如果 csetsysparam 為零， 則會忽略 psetsysparam 。

csetsysparam

全域參數陣列的元素計數，只有在引擎因為這個呼叫而進入多重實例模式時才設定。如果 csetsysparam 為零， 則會忽略 psetsysparam 。

pcsetsucceed

此呼叫結果成功設定之全域系統參數計數的指標。

傳回值

此函式會傳回具有下列其中一個傳回碼的 JET_ERR 資料類型。如需可能 ESE 錯誤的詳細資訊，請參閱可延伸儲存引擎錯誤和錯誤處理參數。

傳回碼	描述
JET_errSuccess	作業已成功完成。
JET_errIndexTuplesInvalidLimits	不允許指定的元組索引參數。只有在將JET_paramIndexTuplesLengthMin、JET_paramIndexTuplesLengthMax或JET_paramIndexTuplesToIndexMax設定為不合法的值時，JetEnableMultiInstance才會傳回此錯誤。 Windowsxp：這個傳回值是在 Windows XP 中引進。
JET_errInvalidPath	指定的檔案系統路徑無效。只有在設定代表檔案系統路徑的系統參數時，JetEnableMultiInstance 才會傳回此錯誤。例如， JET_paramSystemPath 可能會傳回此錯誤。
JET_errRunningInOneInstanceMode	作業失敗，因為資料庫引擎在單一實例模式中作業時不合法， (Windows 2000 相容性模式) 。
JET_errSystemParamsAlreadySet	JetEnableMultiInstance 失敗，因為引擎已經在多重實例模式中。注意即使未指定任何系統參數，也會發生這種情況。

如果此函式成功，資料庫引擎將會設定為在多重實例模式中執行。引擎也已成功設定全域系統參數的選擇性清單。

如果此函式失敗，資料庫引擎將會維持在目前模式中。如果 pcsetsucceed 不是零，系統參數數目將會維持設定狀態。

備註

只有當應用程式必須以不可部分完成的方式設定資料庫引擎，以在相同進程中的多使用者案例中使用時，才應該使用此函式。如果有另一個同步處理方法可用，最好分別呼叫 JetCreateInstance 和 JetSetSystemParameter 。

規格需求

需求	值
用戶端	需要 Windows Vista 或 Windows XP。
Server	需要 Windows Server 2008 或 Windows Server 2003。
標頭	在 Esent.h 中宣告。
程式庫	使用 ESENT.lib。
Dll	需要ESENT.dll。
Unicode	實作為 JetEnableMultiInstanceW (Unicode) 和 JetEnableMultiInstanceA (ANSI) 。

另請參閱

JET_ERR
JET_SETSYSPARAM
JetCreateInstance
JetInit
JetSetSystemParameter

共用方式為

JetEnableMultiInstance 函式