DSBITEMA
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| cbStruct | DWORD | 4 | +0 | +0 | 構造体のサイズをバイト単位で格納します。 |
| pszADsPath | LPWSTR | 8/4 | +8 | +4 | 項目の ADsPath を格納する、null で終わる Unicode 文字列へのポインターです。 |
| pszClass | LPWSTR | 8/4 | +16 | +8 | 項目のオブジェクト クラス名を格納する、null で終わる Unicode 文字列へのポインターです。 |
| dwMask | DWORD | 4 | +24 | +12 | 構造体のどのメンバーが有効なデータを格納しているかを示すフラグのセットを格納します。0、または次の値の 1 つ以上の組み合わせを指定できます。 DSBF_DISPLAYNAMEszDisplayName メンバーが有効なデータを格納しています。 DSBF_ICONLOCATIONszIconLocation メンバーと iIconResID メンバーが有効なデータを格納しています。 DSBF_STATEdwState メンバーと dwStateMask メンバーが有効なデータを格納しています。 |
| dwState | DWORD | 4 | +28 | +16 | 項目の状態を示すフラグのセットを格納します。0、または次の値の 1 つ以上の組み合わせを指定できます。 DSBS_CHECKEDこのフラグが設定されている場合、項目は選択されています。設定されていない場合、項目は選択されていません。このフラグは現在サポートされていません。 DSBS_HIDDENこのフラグが設定されている場合、項目は非表示です。設定されていない場合、項目は表示されます。 DSBS_ROOTこのフラグが設定されている場合、項目はルート項目です。設定されていない場合、項目はルート項目ではありません。 |
| dwStateMask | DWORD | 4 | +32 | +20 | dwState メンバーのどのフラグが有効なデータを格納しているかを示すフラグのセットを格納します。0、または次の値の 1 つ以上の組み合わせを指定できます。たとえば、dwStateMask に DSBS_HIDDEN フラグが設定されていて、dwState に DSBS_HIDDEN フラグが設定されていない場合、その項目は表示されます。dwStateMask に DSBS_HIDDEN フラグが設定されていない場合、dwState の DSBS_HIDDEN フラグは無視しなければなりません。 DSBS_CHECKEDdwState メンバーの DSBS_CHECKED フラグが有効なデータを格納しています。 DSBS_HIDDENdwState メンバーの DSBS_HIDDEN フラグが有効なデータを格納しています。 DSBS_ROOTdwState メンバーの DSBS_ROOT フラグが有効なデータを格納しています。 |
| szDisplayName | CHAR | 64 | +36 | +24 | 項目の表示名を格納する、null で終わる文字列へのポインターです。項目の表示名は、新しい表示名をこのメンバーにコピーし、dwMask メンバーに DSBF_DISPLAYNAME フラグを設定して、BFFCallBack から 0 以外の値を返すことで変更できます。 |
| szIconLocation | CHAR | 260 | +100 | +88 | 項目に表示するアイコンを含む .exe、.dll、または .ico ファイルの名前を格納する、null で終わる文字列へのポインターです。ExtractIcon 関数に渡すことができるファイル形式であれば、いずれも指定できます。このアイコンのインデックスは iIconResID で指定します。項目に表示するアイコンを変更するには、アイコンのソース ファイル名をこのメンバーにコピーし、iIconResID にアイコンの 0 から始まるインデックスを設定し、dwMask メンバーに DSBF_ICONLOCATION フラグを設定して、BFFCallBack から 0 以外の値を返します。 |
| iIconResID | INT | 4 | +360 | +348 | 項目に表示するアイコンの 0 から始まるインデックスを格納します。 メモ これはアイコンのリソース識別子ではありません。
|
公式ドキュメント
DSBITEM 構造体は、Active Directory コンテナー ブラウザー ダイアログ ボックス内の項目に関するデータを格納します。この構造体は、DSBM_QUERYINSERT 通知とともに BFFCallBack コールバック関数に渡されます。コンテナー ブラウザー ダイアログ ボックスは、DsBrowseForContainer 関数によって作成されます。
解説(Remarks)
dsclient.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして DSBITEM を定義します。エンコード中立のエイリアスと、エンコード中立でないコードを混在させて使用すると不整合が生じ、コンパイル エラーや実行時エラーの原因になることがあります。詳細については、「関数プロトタイプの規則」を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// DSBITEMA (x64 368 / x86 352 バイト)
typedef struct DSBITEMA {
DWORD cbStruct;
LPWSTR pszADsPath;
LPWSTR pszClass;
DWORD dwMask;
DWORD dwState;
DWORD dwStateMask;
CHAR szDisplayName[64];
CHAR szIconLocation[260];
INT iIconResID;
} DSBITEMA;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DSBITEMA
{
public uint cbStruct;
public IntPtr pszADsPath;
public IntPtr pszClass;
public uint dwMask;
public uint dwState;
public uint dwStateMask;
[MarshalAs(UnmanagedType.ByValArray, SizeConst = 64)] public sbyte[] szDisplayName;
[MarshalAs(UnmanagedType.ByValArray, SizeConst = 260)] public sbyte[] szIconLocation;
public int iIconResID;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DSBITEMA
Public cbStruct As UInteger
Public pszADsPath As IntPtr
Public pszClass As IntPtr
Public dwMask As UInteger
Public dwState As UInteger
Public dwStateMask As UInteger
<MarshalAs(UnmanagedType.ByValArray, SizeConst:=64)> Public szDisplayName() As SByte
<MarshalAs(UnmanagedType.ByValArray, SizeConst:=260)> Public szIconLocation() As SByte
Public iIconResID As Integer
End Structureimport ctypes
from ctypes import wintypes
class DSBITEMA(ctypes.Structure):
_fields_ = [
("cbStruct", wintypes.DWORD),
("pszADsPath", ctypes.c_void_p),
("pszClass", ctypes.c_void_p),
("dwMask", wintypes.DWORD),
("dwState", wintypes.DWORD),
("dwStateMask", wintypes.DWORD),
("szDisplayName", ctypes.c_byte * 64),
("szIconLocation", ctypes.c_byte * 260),
("iIconResID", ctypes.c_int),
]#[repr(C)]
pub struct DSBITEMA {
pub cbStruct: u32,
pub pszADsPath: *mut core::ffi::c_void,
pub pszClass: *mut core::ffi::c_void,
pub dwMask: u32,
pub dwState: u32,
pub dwStateMask: u32,
pub szDisplayName: [i8; 64],
pub szIconLocation: [i8; 260],
pub iIconResID: i32,
}import "golang.org/x/sys/windows"
type DSBITEMA struct {
cbStruct uint32
pszADsPath uintptr
pszClass uintptr
dwMask uint32
dwState uint32
dwStateMask uint32
szDisplayName [64]int8
szIconLocation [260]int8
iIconResID int32
}type
DSBITEMA = record
cbStruct: DWORD;
pszADsPath: Pointer;
pszClass: Pointer;
dwMask: DWORD;
dwState: DWORD;
dwStateMask: DWORD;
szDisplayName: array[0..63] of Shortint;
szIconLocation: array[0..259] of Shortint;
iIconResID: Integer;
end;const DSBITEMA = extern struct {
cbStruct: u32,
pszADsPath: ?*anyopaque,
pszClass: ?*anyopaque,
dwMask: u32,
dwState: u32,
dwStateMask: u32,
szDisplayName: [64]i8,
szIconLocation: [260]i8,
iIconResID: i32,
};type
DSBITEMA {.bycopy.} = object
cbStruct: uint32
pszADsPath: pointer
pszClass: pointer
dwMask: uint32
dwState: uint32
dwStateMask: uint32
szDisplayName: array[64, int8]
szIconLocation: array[260, int8]
iIconResID: int32struct DSBITEMA
{
uint cbStruct;
void* pszADsPath;
void* pszClass;
uint dwMask;
uint dwState;
uint dwStateMask;
byte[64] szDisplayName;
byte[260] szIconLocation;
int iIconResID;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DSBITEMA サイズ: 352 バイト(x86)
dim st, 88 ; 4byte整数×88(構造体サイズ 352 / 4 切り上げ)
; cbStruct : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; pszADsPath : LPWSTR (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; pszClass : LPWSTR (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; dwMask : DWORD (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; dwState : DWORD (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; dwStateMask : DWORD (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; szDisplayName : CHAR (+24, 64byte) varptr(st)+24 を基点に操作(64byte:入れ子/配列)
; szIconLocation : CHAR (+88, 260byte) varptr(st)+88 を基点に操作(260byte:入れ子/配列)
; iIconResID : INT (+348, 4byte) st.87 = 値 / 値 = st.87 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DSBITEMA サイズ: 368 バイト(x64)
dim st, 92 ; 4byte整数×92(構造体サイズ 368 / 4 切り上げ)
; cbStruct : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; pszADsPath : LPWSTR (+8, 8byte) qpoke st,8,値 / qpeek(st,8) ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; pszClass : LPWSTR (+16, 8byte) qpoke st,16,値 / qpeek(st,16) ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; dwMask : DWORD (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; dwState : DWORD (+28, 4byte) st.7 = 値 / 値 = st.7 (lpoke/lpeek も可)
; dwStateMask : DWORD (+32, 4byte) st.8 = 値 / 値 = st.8 (lpoke/lpeek も可)
; szDisplayName : CHAR (+36, 64byte) varptr(st)+36 を基点に操作(64byte:入れ子/配列)
; szIconLocation : CHAR (+100, 260byte) varptr(st)+100 を基点に操作(260byte:入れ子/配列)
; iIconResID : INT (+360, 4byte) st.90 = 値 / 値 = st.90 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global DSBITEMA
#field int cbStruct
#field intptr pszADsPath
#field intptr pszClass
#field int dwMask
#field int dwState
#field int dwStateMask
#field byte szDisplayName 64
#field byte szIconLocation 260
#field int iIconResID
#endstruct
stdim st, DSBITEMA ; NSTRUCT 変数を確保
st->cbStruct = 100
mes "cbStruct=" + st->cbStruct