ホーム › Storage.Jet › JetEnableMultiInstanceA

JetEnableMultiInstanceA

関数

ESEのマルチインスタンス動作を有効化しパラメーターを設定する（ANSI版）。

DLLESENT.dll文字セットANSI (-A)呼出規約winapi

シグネチャ

// ESENT.dll  (ANSI / -A)
#include <windows.h>

INT JetEnableMultiInstanceA(
    JET_SETSYSPARAM_A* psetsysparam,   // optional
    DWORD csetsysparam,
    DWORD* pcsetsucceed   // optional
);

パラメーター

名前	型	方向	説明
psetsysparam	JET_SETSYSPARAM_A*	inoptional	マルチインスタンス有効化時に設定するシステムパラメータ配列(JET_SETSYSPARAM_A)へのポインタ。
csetsysparam	DWORD	in	psetsysparam配列の要素数。
pcsetsucceed	DWORD*	outoptional	正常に設定できたパラメータ数を受け取るDWORDポインタ。

戻り値の型: INT

公式ドキュメント

JetEnableMultiInstance 関数は、同一プロセス内で複数のインスタンスを使用できるようにデータベースエンジンを構成します。マルチインスタンスモードへ変更する最初の呼び出し元は、省略可能なグローバルシステムパラメーターの配列を指定できます。

戻り値

この関数は JET_ERR データ型を返し、その値は次の戻りコードのいずれかです。発生する可能性がある ESE のエラーの詳細については、Extensible Storage Engine Errors および Error Handling Parameters を参照してください。

戻りコード	説明
JET_errSuccess	操作は正常に完了しました。
JET_errIndexTuplesInvalidLimits	指定されたタプルインデックスのパラメーターは許可されていません。このエラーは、JET_paramIndexTuplesLengthMin、JET_paramIndexTuplesLengthMax、または JET_paramIndexTuplesToIndexMax を不正な値に設定した場合にのみ JetEnableMultiInstance から返されます。 Windows XP: この戻り値は Windows XP で導入されました。
JET_errInvalidPath	指定されたファイルシステムのパスが無効です。このエラーは、ファイルシステムのパスを表すシステムパラメーターを設定した場合にのみ JetEnableMultiInstance から返されます。たとえば、JET_paramSystemPath はこのエラーを返すことがあります。
JET_errRunningInOneInstanceMode	データベースエンジンがシングルインスタンスモード (Windows 2000 互換モード) で動作している場合、この操作は許可されないため失敗しました。
JET_errSystemParamsAlreadySet	エンジンが既にマルチインスタンスモードであるため、JetEnableMultiInstance は失敗しました。メモシステムパラメーターを 1 つも指定していない場合でも、これは発生します。

この関数が成功すると、データベースエンジンはマルチインスタンスモードで動作するように構成されます。また、省略可能なグローバルシステムパラメーターの一覧による構成も正常に行われます。

この関数が失敗した場合、データベースエンジンは現在のモードのままです。pcsetsucceed が 0 以外の場合、その数のシステムパラメーターは設定されたままになります。

解説

この関数は、同一プロセス内のマルチユーザーのシナリオで使用するためにデータベースエンジンをセットアップする際に、アプリケーションが特定のシステムパラメーターの組をアトミックに構成する必要がある場合にのみ使用してください。他の同期手段が利用できる場合は、JetCreateInstance と JetSetSystemParameter を個別に呼び出すことをお勧めします。

要件

要件	値
クライアント	Windows Vista または Windows XP が必要です。
サーバー	Windows Server 2008 または Windows Server 2003 が必要です。
ヘッダー	Esent.h で宣言されています。
ライブラリ	ESENT.lib を使用します。
DLL	ESENT.dll が必要です。
Unicode	JetEnableMultiInstanceW (Unicode) および JetEnableMultiInstanceA (ANSI) として実装されています。

各言語での呼び出し定義

// ESENT.dll  (ANSI / -A)
#include <windows.h>

INT JetEnableMultiInstanceA(
    JET_SETSYSPARAM_A* psetsysparam,   // optional
    DWORD csetsysparam,
    DWORD* pcsetsucceed   // optional
);

[DllImport("ESENT.dll", CharSet = CharSet.Ansi, ExactSpelling = true)]
static extern int JetEnableMultiInstanceA(
    IntPtr psetsysparam,   // JET_SETSYSPARAM_A* optional
    uint csetsysparam,   // DWORD
    IntPtr pcsetsucceed   // DWORD* optional, out
);

<DllImport("ESENT.dll", CharSet:=CharSet.Ansi, ExactSpelling:=True)>
Public Shared Function JetEnableMultiInstanceA(
    psetsysparam As IntPtr,   ' JET_SETSYSPARAM_A* optional
    csetsysparam As UInteger,   ' DWORD
    pcsetsucceed As IntPtr   ' DWORD* optional, out
) As Integer
End Function

' psetsysparam : JET_SETSYSPARAM_A* optional
' csetsysparam : DWORD
' pcsetsucceed : DWORD* optional, out
Declare PtrSafe Function JetEnableMultiInstanceA Lib "esent" ( _
    ByVal psetsysparam As LongPtr, _
    ByVal csetsysparam As Long, _
    ByVal pcsetsucceed As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

JetEnableMultiInstanceA = ctypes.windll.esent.JetEnableMultiInstanceA
JetEnableMultiInstanceA.restype = ctypes.c_int
JetEnableMultiInstanceA.argtypes = [
    ctypes.c_void_p,  # psetsysparam : JET_SETSYSPARAM_A* optional
    wintypes.DWORD,  # csetsysparam : DWORD
    ctypes.POINTER(wintypes.DWORD),  # pcsetsucceed : DWORD* optional, out
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('ESENT.dll')
JetEnableMultiInstanceA = Fiddle::Function.new(
  lib['JetEnableMultiInstanceA'],
  [
    Fiddle::TYPE_VOIDP,  # psetsysparam : JET_SETSYSPARAM_A* optional
    -Fiddle::TYPE_INT,  # csetsysparam : DWORD
    Fiddle::TYPE_VOIDP,  # pcsetsucceed : DWORD* optional, out
  ],
  Fiddle::TYPE_INT)

#[link(name = "esent")]
extern "system" {
    fn JetEnableMultiInstanceA(
        psetsysparam: *mut JET_SETSYSPARAM_A,  // JET_SETSYSPARAM_A* optional
        csetsysparam: u32,  // DWORD
        pcsetsucceed: *mut u32  // DWORD* optional, out
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("ESENT.dll", CharSet = CharSet.Ansi)]
public static extern int JetEnableMultiInstanceA(IntPtr psetsysparam, uint csetsysparam, IntPtr pcsetsucceed);
"@
$api = Add-Type -MemberDefinition $sig -Name 'ESENT_JetEnableMultiInstanceA' -Namespace Win32 -PassThru
# $api::JetEnableMultiInstanceA(psetsysparam, csetsysparam, pcsetsucceed)

#uselib "ESENT.dll"
#func global JetEnableMultiInstanceA "JetEnableMultiInstanceA" sptr, sptr, sptr
; JetEnableMultiInstanceA varptr(psetsysparam), csetsysparam, varptr(pcsetsucceed)   ; 戻り値は stat
; psetsysparam : JET_SETSYSPARAM_A* optional -> "sptr"
; csetsysparam : DWORD -> "sptr"
; pcsetsucceed : DWORD* optional, out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "ESENT.dll"
#cfunc global JetEnableMultiInstanceA "JetEnableMultiInstanceA" var, int, var
; res = JetEnableMultiInstanceA(psetsysparam, csetsysparam, pcsetsucceed)
; psetsysparam : JET_SETSYSPARAM_A* optional -> "var"
; csetsysparam : DWORD -> "int"
; pcsetsucceed : DWORD* optional, out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "ESENT.dll"
#cfunc global JetEnableMultiInstanceA "JetEnableMultiInstanceA" sptr, int, sptr
; res = JetEnableMultiInstanceA(varptr(psetsysparam), csetsysparam, varptr(pcsetsucceed))
; psetsysparam : JET_SETSYSPARAM_A* optional -> "sptr"
; csetsysparam : DWORD -> "int"
; pcsetsucceed : DWORD* optional, out -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。