JetCreateIndexA

関数

キー定義を指定してテーブルにインデックスを作成する(ANSI版)。

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

シグネチャ

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

INT JetCreateIndexA(
    JET_SESID sesid,
    JET_TABLEID tableid,
    CHAR* szIndexName,
    DWORD grbit,
    CHAR* szKey,
    DWORD cbKey,
    DWORD lDensity
);

パラメーター

名前	型	方向	説明
sesid	JET_SESID	in	操作に使用するセッションID。
tableid	JET_TABLEID	in	インデックスを作成する対象テーブルのカーソルID。
szIndexName	CHAR*	in	作成するインデックス名を指すANSI文字列。
grbit	DWORD	in	インデックス属性を制御するJET_bitIndexUnique等のフラグ。
szKey	CHAR*	in	キー列の指定を二重NUL終端で並べたANSI文字列(各列は方向記号+列名)。
cbKey	DWORD	in	szKeyの全体バイト長(終端NULを含む)。
lDensity	DWORD	in	インデックスの初期ページ充填率(20〜100のパーセント)。

戻り値の型: INT

公式ドキュメント

JetCreateIndex 関数を使用すると、Extensible Storage Engine (ESE) データベース内のデータに対するインデックスを作成でき、特定のデータを迅速に見つけることができます。

戻り値

この関数は JET_ERR データ型を返し、その値は次の表に示す戻り値コードのいずれかです。発生し得る ESE のエラーの詳細については、「Extensible Storage Engine のエラー」および「エラー処理パラメーター」を参照してください。

戻り値コード	意味
JET_errSuccess	操作は正常に完了しました。

JetCreateIndex 関数が返すことのできるその他のエラーの一覧については、JetCreateIndex2 を参照してください。

解説

JetCreateIndex 関数の呼び出しは、JetCreateIndex のパラメーターと同じ設定を格納した JET_INDEXCREATE 構造体と、値が 1 の cIndexCreate パラメーターを指定して JetCreateIndex2 関数を呼び出すことと同一です。JET_INDEXCREATE 構造体のうち、JetCreateIndex に対応するパラメーターが存在しないフィールドについては、値 0 が指定されたものとみなされます。

JetCreateIndex は JetCreateIndex2 に置き換えられている点に注意してください。

要件

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

各言語での呼び出し定義

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

INT JetCreateIndexA(
    JET_SESID sesid,
    JET_TABLEID tableid,
    CHAR* szIndexName,
    DWORD grbit,
    CHAR* szKey,
    DWORD cbKey,
    DWORD lDensity
);

[DllImport("ESENT.dll", CharSet = CharSet.Ansi, ExactSpelling = true)]
static extern int JetCreateIndexA(
    UIntPtr sesid,   // JET_SESID
    UIntPtr tableid,   // JET_TABLEID
    IntPtr szIndexName,   // CHAR*
    uint grbit,   // DWORD
    IntPtr szKey,   // CHAR*
    uint cbKey,   // DWORD
    uint lDensity   // DWORD
);

<DllImport("ESENT.dll", CharSet:=CharSet.Ansi, ExactSpelling:=True)>
Public Shared Function JetCreateIndexA(
    sesid As UIntPtr,   ' JET_SESID
    tableid As UIntPtr,   ' JET_TABLEID
    szIndexName As IntPtr,   ' CHAR*
    grbit As UInteger,   ' DWORD
    szKey As IntPtr,   ' CHAR*
    cbKey As UInteger,   ' DWORD
    lDensity As UInteger   ' DWORD
) As Integer
End Function

' sesid : JET_SESID
' tableid : JET_TABLEID
' szIndexName : CHAR*
' grbit : DWORD
' szKey : CHAR*
' cbKey : DWORD
' lDensity : DWORD
Declare PtrSafe Function JetCreateIndexA Lib "esent" ( _
    ByVal sesid As LongPtr, _
    ByVal tableid As LongPtr, _
    ByVal szIndexName As LongPtr, _
    ByVal grbit As Long, _
    ByVal szKey As LongPtr, _
    ByVal cbKey As Long, _
    ByVal lDensity As Long) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

JetCreateIndexA = ctypes.windll.esent.JetCreateIndexA
JetCreateIndexA.restype = ctypes.c_int
JetCreateIndexA.argtypes = [
    ctypes.c_size_t,  # sesid : JET_SESID
    ctypes.c_size_t,  # tableid : JET_TABLEID
    ctypes.POINTER(ctypes.c_byte),  # szIndexName : CHAR*
    wintypes.DWORD,  # grbit : DWORD
    ctypes.POINTER(ctypes.c_byte),  # szKey : CHAR*
    wintypes.DWORD,  # cbKey : DWORD
    wintypes.DWORD,  # lDensity : DWORD
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('ESENT.dll')
JetCreateIndexA = Fiddle::Function.new(
  lib['JetCreateIndexA'],
  [
    Fiddle::TYPE_UINTPTR_T,  # sesid : JET_SESID
    Fiddle::TYPE_UINTPTR_T,  # tableid : JET_TABLEID
    Fiddle::TYPE_VOIDP,  # szIndexName : CHAR*
    -Fiddle::TYPE_INT,  # grbit : DWORD
    Fiddle::TYPE_VOIDP,  # szKey : CHAR*
    -Fiddle::TYPE_INT,  # cbKey : DWORD
    -Fiddle::TYPE_INT,  # lDensity : DWORD
  ],
  Fiddle::TYPE_INT)

#[link(name = "esent")]
extern "system" {
    fn JetCreateIndexA(
        sesid: usize,  // JET_SESID
        tableid: usize,  // JET_TABLEID
        szIndexName: *mut i8,  // CHAR*
        grbit: u32,  // DWORD
        szKey: *mut i8,  // CHAR*
        cbKey: u32,  // DWORD
        lDensity: u32  // DWORD
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("ESENT.dll", CharSet = CharSet.Ansi)]
public static extern int JetCreateIndexA(UIntPtr sesid, UIntPtr tableid, IntPtr szIndexName, uint grbit, IntPtr szKey, uint cbKey, uint lDensity);
"@
$api = Add-Type -MemberDefinition $sig -Name 'ESENT_JetCreateIndexA' -Namespace Win32 -PassThru
# $api::JetCreateIndexA(sesid, tableid, szIndexName, grbit, szKey, cbKey, lDensity)

#uselib "ESENT.dll"
#func global JetCreateIndexA "JetCreateIndexA" sptr, sptr, sptr, sptr, sptr, sptr, sptr
; JetCreateIndexA sesid, tableid, varptr(szIndexName), grbit, varptr(szKey), cbKey, lDensity   ; 戻り値は stat
; sesid : JET_SESID -> "sptr"
; tableid : JET_TABLEID -> "sptr"
; szIndexName : CHAR* -> "sptr"
; grbit : DWORD -> "sptr"
; szKey : CHAR* -> "sptr"
; cbKey : DWORD -> "sptr"
; lDensity : DWORD -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

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