JetGetObjectInfoW

関数

ESEデータベース内のオブジェクトの情報を取得する。

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

シグネチャ

// ESENT.dll  (Unicode / -W)
#include <windows.h>

INT JetGetObjectInfoW(
    JET_SESID sesid,
    DWORD dbid,
    DWORD objtyp,
    WORD* szContainerName,   // optional
    WORD* szObjectName,   // optional
    void* pvResult,
    DWORD cbMax,
    DWORD InfoLevel
);

パラメーター

名前	型	方向	説明
sesid	JET_SESID	in	操作に使用するセッションID。
dbid	DWORD	in	対象オブジェクトを含むデータベースのID。
objtyp	DWORD	in	取得対象のオブジェクト種別(JET_objtypTable等)。
szContainerName	WORD*	inoptional	オブジェクトコンテナ名を指すワイド文字列(WORD*)。NULL可。
szObjectName	WORD*	inoptional	情報を取得する対象オブジェクト名を指すワイド文字列(WORD*)。NULL可。
pvResult	void*	out	取得した情報を受け取る出力バッファへのポインタ。
cbMax	DWORD	in	pvResultバッファのバイトサイズ。
InfoLevel	DWORD	in	取得する情報レベル(JET_ObjInfo系定数)。

戻り値の型: INT

公式ドキュメント

JetGetObjectInfo 関数は、データベースオブジェクトに関する情報を取得します。現在はテーブルのみがサポートされています。JetGetObjectInfo よりも多くの情報を取得するには、JetGetTableInfo を使用できます。

戻り値

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

戻りコード	説明
JET_errSuccess	操作は正常に完了しました。
JET_errBufferTooSmall	cbMax に指定されたバッファーのサイズが小さすぎて、目的の情報を格納できませんでした。
JET_errInvalidName	szObjectName または szContainerName に無効な名前が指定されました。
JET_errInvalidParameter	不正なパラメーターが指定されました。InfoLevel に不正なレベルが渡された可能性があります。

解説

JetGetObjectInfo が一時テーブル (たとえば JET_ObjInfoList や JET_ObjInfoNoStats) の作成に成功した場合、その一時テーブルを JetCloseTable で閉じる責任は呼び出し元にあります。

JetGetObjectInfo は現在、テーブルに関する情報の取得のみをサポートしています。

要件

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

各言語での呼び出し定義

// ESENT.dll  (Unicode / -W)
#include <windows.h>

INT JetGetObjectInfoW(
    JET_SESID sesid,
    DWORD dbid,
    DWORD objtyp,
    WORD* szContainerName,   // optional
    WORD* szObjectName,   // optional
    void* pvResult,
    DWORD cbMax,
    DWORD InfoLevel
);

[DllImport("ESENT.dll", CharSet = CharSet.Unicode, ExactSpelling = true)]
static extern int JetGetObjectInfoW(
    UIntPtr sesid,   // JET_SESID
    uint dbid,   // DWORD
    uint objtyp,   // DWORD
    IntPtr szContainerName,   // WORD* optional
    IntPtr szObjectName,   // WORD* optional
    IntPtr pvResult,   // void* out
    uint cbMax,   // DWORD
    uint InfoLevel   // DWORD
);

<DllImport("ESENT.dll", CharSet:=CharSet.Unicode, ExactSpelling:=True)>
Public Shared Function JetGetObjectInfoW(
    sesid As UIntPtr,   ' JET_SESID
    dbid As UInteger,   ' DWORD
    objtyp As UInteger,   ' DWORD
    szContainerName As IntPtr,   ' WORD* optional
    szObjectName As IntPtr,   ' WORD* optional
    pvResult As IntPtr,   ' void* out
    cbMax As UInteger,   ' DWORD
    InfoLevel As UInteger   ' DWORD
) As Integer
End Function

' sesid : JET_SESID
' dbid : DWORD
' objtyp : DWORD
' szContainerName : WORD* optional
' szObjectName : WORD* optional
' pvResult : void* out
' cbMax : DWORD
' InfoLevel : DWORD
Declare PtrSafe Function JetGetObjectInfoW Lib "esent" ( _
    ByVal sesid As LongPtr, _
    ByVal dbid As Long, _
    ByVal objtyp As Long, _
    ByVal szContainerName As LongPtr, _
    ByVal szObjectName As LongPtr, _
    ByVal pvResult As LongPtr, _
    ByVal cbMax As Long, _
    ByVal InfoLevel As Long) As Long
' Unicode(W): 文字列は ByVal As LongPtr とし StrPtr(unicodeStr) を渡す
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

JetGetObjectInfoW = ctypes.windll.esent.JetGetObjectInfoW
JetGetObjectInfoW.restype = ctypes.c_int
JetGetObjectInfoW.argtypes = [
    ctypes.c_size_t,  # sesid : JET_SESID
    wintypes.DWORD,  # dbid : DWORD
    wintypes.DWORD,  # objtyp : DWORD
    ctypes.POINTER(ctypes.c_ushort),  # szContainerName : WORD* optional
    ctypes.POINTER(ctypes.c_ushort),  # szObjectName : WORD* optional
    ctypes.POINTER(None),  # pvResult : void* out
    wintypes.DWORD,  # cbMax : DWORD
    wintypes.DWORD,  # InfoLevel : DWORD
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('ESENT.dll')
JetGetObjectInfoW = Fiddle::Function.new(
  lib['JetGetObjectInfoW'],
  [
    Fiddle::TYPE_UINTPTR_T,  # sesid : JET_SESID
    -Fiddle::TYPE_INT,  # dbid : DWORD
    -Fiddle::TYPE_INT,  # objtyp : DWORD
    Fiddle::TYPE_VOIDP,  # szContainerName : WORD* optional
    Fiddle::TYPE_VOIDP,  # szObjectName : WORD* optional
    Fiddle::TYPE_VOIDP,  # pvResult : void* out
    -Fiddle::TYPE_INT,  # cbMax : DWORD
    -Fiddle::TYPE_INT,  # InfoLevel : DWORD
  ],
  Fiddle::TYPE_INT)
# Wide strings: pass str.encode("UTF-16LE") + "\x00\x00"

#[link(name = "esent")]
extern "system" {
    fn JetGetObjectInfoW(
        sesid: usize,  // JET_SESID
        dbid: u32,  // DWORD
        objtyp: u32,  // DWORD
        szContainerName: *mut u16,  // WORD* optional
        szObjectName: *mut u16,  // WORD* optional
        pvResult: *mut (),  // void* out
        cbMax: u32,  // DWORD
        InfoLevel: u32  // DWORD
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("ESENT.dll", CharSet = CharSet.Unicode)]
public static extern int JetGetObjectInfoW(UIntPtr sesid, uint dbid, uint objtyp, IntPtr szContainerName, IntPtr szObjectName, IntPtr pvResult, uint cbMax, uint InfoLevel);
"@
$api = Add-Type -MemberDefinition $sig -Name 'ESENT_JetGetObjectInfoW' -Namespace Win32 -PassThru
# $api::JetGetObjectInfoW(sesid, dbid, objtyp, szContainerName, szObjectName, pvResult, cbMax, InfoLevel)

#uselib "ESENT.dll"
#func global JetGetObjectInfoW "JetGetObjectInfoW" wptr, wptr, wptr, wptr, wptr, wptr, wptr, wptr
; JetGetObjectInfoW sesid, dbid, objtyp, varptr(szContainerName), varptr(szObjectName), pvResult, cbMax, InfoLevel   ; 戻り値は stat
; sesid : JET_SESID -> "wptr"
; dbid : DWORD -> "wptr"
; objtyp : DWORD -> "wptr"
; szContainerName : WORD* optional -> "wptr"
; szObjectName : WORD* optional -> "wptr"
; pvResult : void* out -> "wptr"
; cbMax : DWORD -> "wptr"
; InfoLevel : DWORD -> "wptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "ESENT.dll"
#cfunc global JetGetObjectInfoW "JetGetObjectInfoW" sptr, int, int, var, var, sptr, int, int
; res = JetGetObjectInfoW(sesid, dbid, objtyp, szContainerName, szObjectName, pvResult, cbMax, InfoLevel)
; sesid : JET_SESID -> "sptr"
; dbid : DWORD -> "int"
; objtyp : DWORD -> "int"
; szContainerName : WORD* optional -> "var"
; szObjectName : WORD* optional -> "var"
; pvResult : void* out -> "sptr"
; cbMax : DWORD -> "int"
; InfoLevel : DWORD -> "int"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "ESENT.dll"
#cfunc global JetGetObjectInfoW "JetGetObjectInfoW" sptr, int, int, sptr, sptr, sptr, int, int
; res = JetGetObjectInfoW(sesid, dbid, objtyp, varptr(szContainerName), varptr(szObjectName), pvResult, cbMax, InfoLevel)
; sesid : JET_SESID -> "sptr"
; dbid : DWORD -> "int"
; objtyp : DWORD -> "int"
; szContainerName : WORD* optional -> "sptr"
; szObjectName : WORD* optional -> "sptr"
; pvResult : void* out -> "sptr"
; cbMax : DWORD -> "int"
; InfoLevel : DWORD -> "int"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。