JetDeleteTableA

関数

ESEデータベースから指定したテーブルを削除する（ANSI版）。

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

シグネチャ

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

INT JetDeleteTableA(
    JET_SESID sesid,
    DWORD dbid,
    CHAR* szTableName
);

パラメーター

名前	型	方向	説明
sesid	JET_SESID	in	操作に使用するセッションID。
dbid	DWORD	in	対象テーブルを含むデータベースのID。
szTableName	CHAR*	in	削除するテーブル名を指すANSI文字列。

戻り値の型: INT

公式ドキュメント

JetDeleteTable 関数は、ESE データベース内のテーブルを削除します。

戻り値

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

リターンコード	説明
JET_errSuccess	操作は正常に完了しました。
JET_errTableInUse	別のセッションが JetOpenTable または JetDupCursor によってテーブル ID (JET_TABLEID) を開いている間に、テーブルを削除しようとしました。
JET_errCannotDeletetemporary table	一時テーブルを削除しようとしました。一時テーブルは、JetCloseTable で閉じられると自動的に削除されます。
JET_errCannotDeleteTemplateTable	テンプレートテーブル、つまり DDL の継承元となるテーブルを削除しようとしました。

要件

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

各言語での呼び出し定義

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

INT JetDeleteTableA(
    JET_SESID sesid,
    DWORD dbid,
    CHAR* szTableName
);

[DllImport("ESENT.dll", CharSet = CharSet.Ansi, ExactSpelling = true)]
static extern int JetDeleteTableA(
    UIntPtr sesid,   // JET_SESID
    uint dbid,   // DWORD
    IntPtr szTableName   // CHAR*
);

<DllImport("ESENT.dll", CharSet:=CharSet.Ansi, ExactSpelling:=True)>
Public Shared Function JetDeleteTableA(
    sesid As UIntPtr,   ' JET_SESID
    dbid As UInteger,   ' DWORD
    szTableName As IntPtr   ' CHAR*
) As Integer
End Function

' sesid : JET_SESID
' dbid : DWORD
' szTableName : CHAR*
Declare PtrSafe Function JetDeleteTableA Lib "esent" ( _
    ByVal sesid As LongPtr, _
    ByVal dbid As Long, _
    ByVal szTableName As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

JetDeleteTableA = ctypes.windll.esent.JetDeleteTableA
JetDeleteTableA.restype = ctypes.c_int
JetDeleteTableA.argtypes = [
    ctypes.c_size_t,  # sesid : JET_SESID
    wintypes.DWORD,  # dbid : DWORD
    ctypes.POINTER(ctypes.c_byte),  # szTableName : CHAR*
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('ESENT.dll')
JetDeleteTableA = Fiddle::Function.new(
  lib['JetDeleteTableA'],
  [
    Fiddle::TYPE_UINTPTR_T,  # sesid : JET_SESID
    -Fiddle::TYPE_INT,  # dbid : DWORD
    Fiddle::TYPE_VOIDP,  # szTableName : CHAR*
  ],
  Fiddle::TYPE_INT)

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

$sig = @"
[DllImport("ESENT.dll", CharSet = CharSet.Ansi)]
public static extern int JetDeleteTableA(UIntPtr sesid, uint dbid, IntPtr szTableName);
"@
$api = Add-Type -MemberDefinition $sig -Name 'ESENT_JetDeleteTableA' -Namespace Win32 -PassThru
# $api::JetDeleteTableA(sesid, dbid, szTableName)

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

出力引数:

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