JetRenameTableA

関数

ESEデータベース内のテーブル名を変更する（ANSI版）。

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

シグネチャ

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

INT JetRenameTableA(
    JET_SESID sesid,
    DWORD dbid,
    CHAR* szName,
    CHAR* szNameNew
);

パラメーター

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

戻り値の型: INT

公式ドキュメント

JetRenameTable 関数は、既存のテーブルの名前を変更するために使用できます。

戻り値

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

リターンコード	説明
JET_errSuccess	操作は正常に完了しました。
JET_errClientRequestToStopJetService	JetStopService の呼び出しの結果として、セッションに関連付けられたインスタンス上のすべての動作が停止しているため、操作を完了できません。
JET_errInstanceUnavailable	セッションに関連付けられたインスタンスで、データの整合性を保護するためにすべてのデータへのアクセスを取り消す必要がある致命的なエラーが発生したため、操作を完了できません。このエラーは Windows XP 以降のリリースでのみ返されます。
JET_errInvalidDatabase	指定されたデータベースが無効でした。このエラーは、一時データベースに対してテーブルの名前変更操作が試行された場合に、Windows 2000 でのみ返されます。それ以降のリリースでは、この場合に JET_errInvalidDatabaseId が返されます。
JET_errInvalidDatabaseId	指定されたデータベース ID が無効でした。
JET_errInvalidName	指定されたオブジェクト名のいずれかが無効でした。すべてのオブジェクト名は、同じ一連の規則に従う必要があります。規則は次のとおりです。オブジェクト名は ASCII 文字で構成されている必要があります。オブジェクト名は 1 文字以上の長さである必要があります。オブジェクト名の長さは JET_cbNameMost (64) 文字を超えることはできません。オブジェクト名の先頭を空白にすることはできません。オブジェクト名に ASCII 制御文字 (0x00 から 0x1F) を含めることはできません。オブジェクト名に感嘆符 (!)、ピリオド (.)、左角かっこ ([)、右角かっこ (]) の文字を含めることはできません。検証後は、文字列のうち最初の空白 (存在する場合) までの部分のみがオブジェクト名として使用されます。これは実質的に、オブジェクト名に空白も含められないことを意味します。
JET_errInvalidParameter	指定されたパラメーターのいずれかに予期しない値が含まれていたか、別のパラメーターの値と組み合わせたときに意味をなさない値が含まれていました。これは JetRenameTable では次の場合に発生する可能性があります。 szName が NULL である。 szNameNew が NULL である。
JET_errNotInitialized	セッションに関連付けられたインスタンスがまだ初期化されていないため、操作を完了できません。
JET_errObjectNotFound	指定されたテーブルは、このデータベースに存在しません。
JET_errRestoreInProgress	セッションに関連付けられたインスタンスで復元操作が進行中であるため、操作を完了できません。
JET_errSessionSharingViolation	同じセッションを同時に複数のスレッドで使用することはできません。このエラーは Windows XP 以降のリリースでのみ返されます。
JET_errTermInProgress	セッションに関連付けられたインスタンスがシャットダウン中であるため、操作を完了できません。
JET_errTransReadOnly	読み取り専用トランザクションのスコープ内では、更新を行うことはできません。読み取り専用トランザクションとは、JET_bitTransactionReadOnly を指定して JetBeginTransaction2 を呼び出すことによって開始されたトランザクションです。このエラーは Windows XP 以降のリリースでのみ返されます。

成功した場合、指定されたデータベース内の指定されたテーブルの名前は、新しい名前に永続的に変更されます。

失敗した場合、データベースの状態は変更されません。

要件

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

各言語での呼び出し定義

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

INT JetRenameTableA(
    JET_SESID sesid,
    DWORD dbid,
    CHAR* szName,
    CHAR* szNameNew
);

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

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

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

import ctypes
from ctypes import wintypes

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

require 'fiddle'
require 'fiddle/import'

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

#[link(name = "esent")]
extern "system" {
    fn JetRenameTableA(
        sesid: usize,  // JET_SESID
        dbid: u32,  // DWORD
        szName: *mut i8,  // CHAR*
        szNameNew: *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 JetRenameTableA(UIntPtr sesid, uint dbid, IntPtr szName, IntPtr szNameNew);
"@
$api = Add-Type -MemberDefinition $sig -Name 'ESENT_JetRenameTableA' -Namespace Win32 -PassThru
# $api::JetRenameTableA(sesid, dbid, szName, szNameNew)

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

出力引数:

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