Win32 API 日本語リファレンス
ホームSystem.Search › DBCOLUMNINFO

DBCOLUMNINFO

構造体
サイズx64: 72 バイト / x86: 48 バイトパッキング2

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールドサイズx64x86説明
pwszNameLPWSTR8/4+0+0列名を表すワイド文字列へのポインタ。無名列ではNULL可。
pTypeInfoITypeInfo*8/4+8+4列の型情報(ITypeInfo)へのポインタ。NULL可。
iOrdinalUINT_PTR8/4+16+8列の序数(1始まり、ブックマーク列は0)。
dwFlagsDWORD4+24+12列の特性を示すフラグ(DBCOLUMNFLAGS_*)。可NULL/書込可等を表す。
ulColumnSizeUINT_PTR8/4+28+16列の最大サイズ。文字列は文字数、その他はバイト数。
wTypeWORD2+36+20列のデータ型を示すDBTYPE値(WORD)。
bPrecisionBYTE1+38+22数値型の精度(全体桁数)。
bScaleBYTE1+39+23数値型のスケール(小数部桁数)。
columnidDBID32/24+40+24列を一意に識別するDBID。

各言語での定義

#include <windows.h>

// DBID  (x64 32 / x86 24 バイト)
typedef struct DBID {
    _uGuid_e__Union uGuid;
    DWORD eKind;
    _uName_e__Union uName;
} DBID;

// DBCOLUMNINFO  (x64 72 / x86 48 バイト)
#pragma pack(push, 2)
typedef struct DBCOLUMNINFO {
    LPWSTR pwszName;
    ITypeInfo* pTypeInfo;
    UINT_PTR iOrdinal;
    DWORD dwFlags;
    UINT_PTR ulColumnSize;
    WORD wType;
    BYTE bPrecision;
    BYTE bScale;
    DBID columnid;
} DBCOLUMNINFO;
#pragma pack(pop)
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DBID
{
    public _uGuid_e__Union uGuid;
    public uint eKind;
    public _uName_e__Union uName;
}

[StructLayout(LayoutKind.Sequential, Pack = 2, CharSet = CharSet.Unicode)]
public struct DBCOLUMNINFO
{
    public IntPtr pwszName;
    public IntPtr pTypeInfo;
    public UIntPtr iOrdinal;
    public uint dwFlags;
    public UIntPtr ulColumnSize;
    public ushort wType;
    public byte bPrecision;
    public byte bScale;
    public DBID columnid;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DBID
    Public uGuid As _uGuid_e__Union
    Public eKind As UInteger
    Public uName As _uName_e__Union
End Structure

<StructLayout(LayoutKind.Sequential, Pack:=2, CharSet:=CharSet.Unicode)>
Public Structure DBCOLUMNINFO
    Public pwszName As IntPtr
    Public pTypeInfo As IntPtr
    Public iOrdinal As UIntPtr
    Public dwFlags As UInteger
    Public ulColumnSize As UIntPtr
    Public wType As UShort
    Public bPrecision As Byte
    Public bScale As Byte
    Public columnid As DBID
End Structure
import ctypes
from ctypes import wintypes

class DBID(ctypes.Structure):
    _fields_ = [
        ("uGuid", _uGuid_e__Union),
        ("eKind", wintypes.DWORD),
        ("uName", _uName_e__Union),
    ]

class DBCOLUMNINFO(ctypes.Structure):
    _pack_ = 2
    _fields_ = [
        ("pwszName", ctypes.c_void_p),
        ("pTypeInfo", ctypes.c_void_p),
        ("iOrdinal", ctypes.c_size_t),
        ("dwFlags", wintypes.DWORD),
        ("ulColumnSize", ctypes.c_size_t),
        ("wType", ctypes.c_ushort),
        ("bPrecision", ctypes.c_ubyte),
        ("bScale", ctypes.c_ubyte),
        ("columnid", DBID),
    ]
#[repr(C)]
pub struct DBID {
    pub uGuid: _uGuid_e__Union,
    pub eKind: u32,
    pub uName: _uName_e__Union,
}

#[repr(C, packed(2))]
pub struct DBCOLUMNINFO {
    pub pwszName: *mut core::ffi::c_void,
    pub pTypeInfo: *mut core::ffi::c_void,
    pub iOrdinal: usize,
    pub dwFlags: u32,
    pub ulColumnSize: usize,
    pub wType: u16,
    pub bPrecision: u8,
    pub bScale: u8,
    pub columnid: DBID,
}
import "golang.org/x/sys/windows"

type DBID struct {
	uGuid _uGuid_e__Union
	eKind uint32
	uName _uName_e__Union
}

type DBCOLUMNINFO struct {
	pwszName uintptr
	pTypeInfo uintptr
	iOrdinal uintptr
	dwFlags uint32
	ulColumnSize uintptr
	wType uint16
	bPrecision byte
	bScale byte
	columnid DBID
}
type
  DBID = record
    uGuid: _uGuid_e__Union;
    eKind: DWORD;
    uName: _uName_e__Union;
  end;

  DBCOLUMNINFO = packed record
    pwszName: Pointer;
    pTypeInfo: Pointer;
    iOrdinal: NativeUInt;
    dwFlags: DWORD;
    ulColumnSize: NativeUInt;
    wType: Word;
    bPrecision: Byte;
    bScale: Byte;
    columnid: DBID;
  end;
const DBID = extern struct {
    uGuid: _uGuid_e__Union,
    eKind: u32,
    uName: _uName_e__Union,
};

const DBCOLUMNINFO = extern struct {
    pwszName: ?*anyopaque,
    pTypeInfo: ?*anyopaque,
    iOrdinal: usize,
    dwFlags: u32,
    ulColumnSize: usize,
    wType: u16,
    bPrecision: u8,
    bScale: u8,
    columnid: DBID,
};
type
  DBID {.bycopy.} = object
    uGuid: _uGuid_e__Union
    eKind: uint32
    uName: _uName_e__Union

  DBCOLUMNINFO {.packed.} = object
    pwszName: pointer
    pTypeInfo: pointer
    iOrdinal: uint
    dwFlags: uint32
    ulColumnSize: uint
    wType: uint16
    bPrecision: uint8
    bScale: uint8
    columnid: DBID
struct DBID
{
    _uGuid_e__Union uGuid;
    uint eKind;
    _uName_e__Union uName;
}

align(2)
struct DBCOLUMNINFO
{
    void* pwszName;
    void* pTypeInfo;
    size_t iOrdinal;
    uint dwFlags;
    size_t ulColumnSize;
    ushort wType;
    ubyte bPrecision;
    ubyte bScale;
    DBID columnid;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DBCOLUMNINFO サイズ: 48 バイト(x86)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; pwszName : LPWSTR (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; pTypeInfo : ITypeInfo* (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; iOrdinal : UINT_PTR (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; dwFlags : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; ulColumnSize : UINT_PTR (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; wType : WORD (+20, 2byte)  wpoke st,20,値  /  値 = wpeek(st,20)
; bPrecision : BYTE (+22, 1byte)  poke st,22,値  /  値 = peek(st,22)
; bScale : BYTE (+23, 1byte)  poke st,23,値  /  値 = peek(st,23)
; columnid : DBID (+24, 24byte)  varptr(st)+24 を基点に操作(24byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DBCOLUMNINFO サイズ: 72 バイト(x64)
dim st, 18    ; 4byte整数×18(構造体サイズ 72 / 4 切り上げ)
; pwszName : LPWSTR (+0, 8byte)  qpoke st,0,値 / qpeek(st,0)  ※IronHSPのみ。3.7/3.8は lpoke st,0,下位 : lpoke st,4,上位
; pTypeInfo : ITypeInfo* (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; iOrdinal : UINT_PTR (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; dwFlags : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; ulColumnSize : UINT_PTR (+28, 8byte)  qpoke st,28,値 / qpeek(st,28)  ※IronHSPのみ。3.7/3.8は lpoke st,28,下位 : lpoke st,32,上位
; wType : WORD (+36, 2byte)  wpoke st,36,値  /  値 = wpeek(st,36)
; bPrecision : BYTE (+38, 1byte)  poke st,38,値  /  値 = peek(st,38)
; bScale : BYTE (+39, 1byte)  poke st,39,値  /  値 = peek(st,39)
; columnid : DBID (+40, 32byte)  varptr(st)+40 を基点に操作(32byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global DBID
    #field byte uGuid 16
    #field int eKind
    #field byte uName 8
#endstruct

#defstruct global DBCOLUMNINFO, pack=2
    #field intptr pwszName
    #field intptr pTypeInfo
    #field intptr iOrdinal
    #field int dwFlags
    #field intptr ulColumnSize
    #field short wType
    #field byte bPrecision
    #field byte bScale
    #field DBID columnid
#endstruct

stdim st, DBCOLUMNINFO        ; NSTRUCT 変数を確保
st->iOrdinal = 100
mes "iOrdinal=" + st->iOrdinal