Win32 API 日本語リファレンス
ホームUI.Shell › SYNCMGRITEM

SYNCMGRITEM

構造体
サイズx64: 304 バイト / x86: 296 バイト

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

フィールド

フィールドサイズx64x86説明
cbSizeDWORD4+0+0この構造体のサイズをバイト単位で指定する。
dwFlagsDWORD4+4+4有効なメンバーや項目特性を示すフラグ群。
ItemIDGUID16+8+8同期アイテムを一意に識別する GUID。
dwItemStateDWORD4+24+24アイテムの状態(チェック済み等)を示す値。
hIconHICON8/4+32+28アイテムを表すアイコンのハンドル。
wszItemNameWCHAR256+40+32アイテムの表示名を格納する WCHAR 配列。
ftLastUpdateFILETIME8+296+288アイテムが最後に更新された日時(FILETIME)。

各言語での定義

#include <windows.h>

// FILETIME  (x64 8 / x86 8 バイト)
typedef struct FILETIME {
    DWORD dwLowDateTime;
    DWORD dwHighDateTime;
} FILETIME;

// SYNCMGRITEM  (x64 304 / x86 296 バイト)
typedef struct SYNCMGRITEM {
    DWORD cbSize;
    DWORD dwFlags;
    GUID ItemID;
    DWORD dwItemState;
    HICON hIcon;
    WCHAR wszItemName[128];
    FILETIME ftLastUpdate;
} SYNCMGRITEM;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct FILETIME
{
    public uint dwLowDateTime;
    public uint dwHighDateTime;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SYNCMGRITEM
{
    public uint cbSize;
    public uint dwFlags;
    public Guid ItemID;
    public uint dwItemState;
    public IntPtr hIcon;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 128)] public string wszItemName;
    public FILETIME ftLastUpdate;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure FILETIME
    Public dwLowDateTime As UInteger
    Public dwHighDateTime As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SYNCMGRITEM
    Public cbSize As UInteger
    Public dwFlags As UInteger
    Public ItemID As Guid
    Public dwItemState As UInteger
    Public hIcon As IntPtr
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=128)> Public wszItemName As String
    Public ftLastUpdate As FILETIME
End Structure
import ctypes
from ctypes import wintypes

class FILETIME(ctypes.Structure):
    _fields_ = [
        ("dwLowDateTime", wintypes.DWORD),
        ("dwHighDateTime", wintypes.DWORD),
    ]

class SYNCMGRITEM(ctypes.Structure):
    _fields_ = [
        ("cbSize", wintypes.DWORD),
        ("dwFlags", wintypes.DWORD),
        ("ItemID", GUID),
        ("dwItemState", wintypes.DWORD),
        ("hIcon", ctypes.c_void_p),
        ("wszItemName", ctypes.c_wchar * 128),
        ("ftLastUpdate", FILETIME),
    ]
#[repr(C)]
pub struct FILETIME {
    pub dwLowDateTime: u32,
    pub dwHighDateTime: u32,
}

#[repr(C)]
pub struct SYNCMGRITEM {
    pub cbSize: u32,
    pub dwFlags: u32,
    pub ItemID: GUID,
    pub dwItemState: u32,
    pub hIcon: *mut core::ffi::c_void,
    pub wszItemName: [u16; 128],
    pub ftLastUpdate: FILETIME,
}
import "golang.org/x/sys/windows"

type FILETIME struct {
	dwLowDateTime uint32
	dwHighDateTime uint32
}

type SYNCMGRITEM struct {
	cbSize uint32
	dwFlags uint32
	ItemID windows.GUID
	dwItemState uint32
	hIcon uintptr
	wszItemName [128]uint16
	ftLastUpdate FILETIME
}
type
  FILETIME = record
    dwLowDateTime: DWORD;
    dwHighDateTime: DWORD;
  end;

  SYNCMGRITEM = record
    cbSize: DWORD;
    dwFlags: DWORD;
    ItemID: TGUID;
    dwItemState: DWORD;
    hIcon: Pointer;
    wszItemName: array[0..127] of WideChar;
    ftLastUpdate: FILETIME;
  end;
const FILETIME = extern struct {
    dwLowDateTime: u32,
    dwHighDateTime: u32,
};

const SYNCMGRITEM = extern struct {
    cbSize: u32,
    dwFlags: u32,
    ItemID: GUID,
    dwItemState: u32,
    hIcon: ?*anyopaque,
    wszItemName: [128]u16,
    ftLastUpdate: FILETIME,
};
type
  FILETIME {.bycopy.} = object
    dwLowDateTime: uint32
    dwHighDateTime: uint32

  SYNCMGRITEM {.bycopy.} = object
    cbSize: uint32
    dwFlags: uint32
    ItemID: GUID
    dwItemState: uint32
    hIcon: pointer
    wszItemName: array[128, uint16]
    ftLastUpdate: FILETIME
struct FILETIME
{
    uint dwLowDateTime;
    uint dwHighDateTime;
}

struct SYNCMGRITEM
{
    uint cbSize;
    uint dwFlags;
    GUID ItemID;
    uint dwItemState;
    void* hIcon;
    wchar[128] wszItemName;
    FILETIME ftLastUpdate;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; SYNCMGRITEM サイズ: 296 バイト(x86)
dim st, 74    ; 4byte整数×74(構造体サイズ 296 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwFlags : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; ItemID : GUID (+8, 16byte)  varptr(st)+8 を基点に操作(16byte:入れ子/配列)
; dwItemState : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; hIcon : HICON (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; wszItemName : WCHAR (+32, 256byte)  varptr(st)+32 を基点に操作(256byte:入れ子/配列)
; ftLastUpdate : FILETIME (+288, 8byte)  varptr(st)+288 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; SYNCMGRITEM サイズ: 304 バイト(x64)
dim st, 76    ; 4byte整数×76(構造体サイズ 304 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwFlags : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; ItemID : GUID (+8, 16byte)  varptr(st)+8 を基点に操作(16byte:入れ子/配列)
; dwItemState : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; hIcon : HICON (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; wszItemName : WCHAR (+40, 256byte)  varptr(st)+40 を基点に操作(256byte:入れ子/配列)
; ftLastUpdate : FILETIME (+296, 8byte)  varptr(st)+296 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global GUID, pack=1
    #field int Data1
    #field short Data2
    #field short Data3
    #field byte Data4 8
#endstruct

#defstruct global FILETIME
    #field int dwLowDateTime
    #field int dwHighDateTime
#endstruct

#defstruct global SYNCMGRITEM
    #field int cbSize
    #field int dwFlags
    #field GUID ItemID
    #field int dwItemState
    #field intptr hIcon
    #field wchar wszItemName 128
    #field FILETIME ftLastUpdate
#endstruct

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