JetOpenDatabaseA

関数

アタッチ済みのデータベースを開く(ANSI版)。

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

シグネチャ

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

INT JetOpenDatabaseA(
    JET_SESID sesid,
    CHAR* szFilename,
    CHAR* szConnect,   // optional
    DWORD* pdbid,
    DWORD grbit
);

パラメーター

名前	型	方向	説明
sesid	JET_SESID	in	データベースを開くセッションのJET_SESIDハンドル。
szFilename	CHAR*	in	開くデータベースファイルのパスを指す終端付きANSI文字列ポインタ。
szConnect	CHAR*	inoptional	予約済みの接続文字列ポインタ。通常はNULLを指定する。
pdbid	DWORD*	out	開いたデータベースのIDを受け取る出力ポインタ(JET_DBID)。
grbit	DWORD	in	オープン動作を制御するビットフラグ。JET_bitDbReadOnly等で読み取り専用などを指定する。

戻り値の型: INT

公式ドキュメント

JetOpenDatabase 関数は、JetAttachDatabase 関数または JetAttachDatabase2 関数によって以前にアタッチされたデータベースを、データベースセッションで使用するために開きます。この関数は、同じデータベースに対して複数回呼び出すことができます。

戻り値

この関数は、JET_ERR データ型として次のいずれかのリターンコードを返します。発生し得る ESE のエラーの詳細については、「Extensible Storage Engine Errors」および「Error Handling Parameters」を参照してください。

リターンコード	説明
JET_errSuccess	操作は正常に完了しました。
JET_errDatabaseInUse	排他アクセスが要求されましたが、許可できませんでした。
JET_errDatabaseInvalidPath	szFilename に無効なパスが指定されました。szFilename は NULL 以外で、有効なファイルを参照している必要があります。
JET_errDatabaseLocked	別のセッションが既にデータベースを排他的に (JET_bitDbExclusive を使用して) 開いています。
JET_errDatabaseNotFound	データベースが以前にアタッチされていません (JetAttachDatabase を参照してください)。
JET_errInvalidDatabase	有効なデータベースファイルではないファイルを開こうとしました。
JET_errOneDatabasePerSession	JET_paramOneDatabasePerSession が設定されている状態で、複数のデータベースを開こうとしました。詳細については、「System Parameters」を参照してください。
JET_wrnFileOpenReadOnly	ファイルは読み取り専用としてアタッチされましたが、JetOpenDatabase は JET_bitDbReadOnly を渡しませんでした。データベースは読み取り専用アクセスで開かれます。

要件

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

各言語での呼び出し定義

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

INT JetOpenDatabaseA(
    JET_SESID sesid,
    CHAR* szFilename,
    CHAR* szConnect,   // optional
    DWORD* pdbid,
    DWORD grbit
);

[DllImport("ESENT.dll", CharSet = CharSet.Ansi, ExactSpelling = true)]
static extern int JetOpenDatabaseA(
    UIntPtr sesid,   // JET_SESID
    IntPtr szFilename,   // CHAR*
    IntPtr szConnect,   // CHAR* optional
    out uint pdbid,   // DWORD* out
    uint grbit   // DWORD
);

<DllImport("ESENT.dll", CharSet:=CharSet.Ansi, ExactSpelling:=True)>
Public Shared Function JetOpenDatabaseA(
    sesid As UIntPtr,   ' JET_SESID
    szFilename As IntPtr,   ' CHAR*
    szConnect As IntPtr,   ' CHAR* optional
    <Out> ByRef pdbid As UInteger,   ' DWORD* out
    grbit As UInteger   ' DWORD
) As Integer
End Function

' sesid : JET_SESID
' szFilename : CHAR*
' szConnect : CHAR* optional
' pdbid : DWORD* out
' grbit : DWORD
Declare PtrSafe Function JetOpenDatabaseA Lib "esent" ( _
    ByVal sesid As LongPtr, _
    ByVal szFilename As LongPtr, _
    ByVal szConnect As LongPtr, _
    ByRef pdbid As Long, _
    ByVal grbit As Long) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

JetOpenDatabaseA = ctypes.windll.esent.JetOpenDatabaseA
JetOpenDatabaseA.restype = ctypes.c_int
JetOpenDatabaseA.argtypes = [
    ctypes.c_size_t,  # sesid : JET_SESID
    ctypes.POINTER(ctypes.c_byte),  # szFilename : CHAR*
    ctypes.POINTER(ctypes.c_byte),  # szConnect : CHAR* optional
    ctypes.POINTER(wintypes.DWORD),  # pdbid : DWORD* out
    wintypes.DWORD,  # grbit : DWORD
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('ESENT.dll')
JetOpenDatabaseA = Fiddle::Function.new(
  lib['JetOpenDatabaseA'],
  [
    Fiddle::TYPE_UINTPTR_T,  # sesid : JET_SESID
    Fiddle::TYPE_VOIDP,  # szFilename : CHAR*
    Fiddle::TYPE_VOIDP,  # szConnect : CHAR* optional
    Fiddle::TYPE_VOIDP,  # pdbid : DWORD* out
    -Fiddle::TYPE_INT,  # grbit : DWORD
  ],
  Fiddle::TYPE_INT)

#[link(name = "esent")]
extern "system" {
    fn JetOpenDatabaseA(
        sesid: usize,  // JET_SESID
        szFilename: *mut i8,  // CHAR*
        szConnect: *mut i8,  // CHAR* optional
        pdbid: *mut u32,  // DWORD* out
        grbit: u32  // DWORD
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("ESENT.dll", CharSet = CharSet.Ansi)]
public static extern int JetOpenDatabaseA(UIntPtr sesid, IntPtr szFilename, IntPtr szConnect, out uint pdbid, uint grbit);
"@
$api = Add-Type -MemberDefinition $sig -Name 'ESENT_JetOpenDatabaseA' -Namespace Win32 -PassThru
# $api::JetOpenDatabaseA(sesid, szFilename, szConnect, pdbid, grbit)

#uselib "ESENT.dll"
#func global JetOpenDatabaseA "JetOpenDatabaseA" sptr, sptr, sptr, sptr, sptr
; JetOpenDatabaseA sesid, varptr(szFilename), varptr(szConnect), varptr(pdbid), grbit   ; 戻り値は stat
; sesid : JET_SESID -> "sptr"
; szFilename : CHAR* -> "sptr"
; szConnect : CHAR* optional -> "sptr"
; pdbid : DWORD* out -> "sptr"
; grbit : DWORD -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

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