ASSOCIATIONELEMENT
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| ac | ASSOCCLASS | 4 | +0 | +0 | 関連付けデータの取得元と、データが格納されている形式です。ASSOCCLASS 列挙型の次の値のいずれかを指定します。 ASSOCCLASS_APP_KEYhkClass メンバーは、アプリケーション識別子 (APPID) の完全なレジストリパスを指定します。 ASSOCCLASS_CLSID_KEYhkClass メンバーは、CLSID の完全なレジストリパスを指定します。 ASSOCCLASS_CLSID_STRhkClass メンバーは、次の場所にある CLSID の名前を指定します。 HKEY_CLASSES_ROOT\CLSID\pszClass ASSOCCLASS_PROGID_KEYhkClass メンバーは、ProgID の完全なレジストリパスを指定します。 ASSOCCLASS_SHELL_KEYhkClass メンバーは、次の場所にあるキーの名前を指定します。 HKEY_CLASSES_ROOT\SystemFileAssociations\hkClass ASSOCCLASS_PROGID_STRpszClass メンバーは、次の場所にある ProgID の名前を指定します。 HKEY_CLASSES_ROOT\pszClass ASSOCCLASS_SYSTEM_STRpszClass メンバーは、次の場所にあるキーの名前を指定します。 HKEY_CLASSES_ROOT\SystemFileAssociations\pszClass ASSOCCLASS_APP_STRアプリケーション情報を格納する APPID は、次の場所にあります。 HKEY_CLASSES_ROOT\Applications\FileName ここで FileName は、pszClass を PathFindFileName に渡して取得されるものです。 ASSOCCLASS_FOLDERHKEY_CLASSES_ROOT\Folder の下に格納されているフォルダー用の関連付け情報を使用します。このフラグが設定されている場合、hkClass と pszClass は無視されます。 ASSOCCLASS_STARHKEY_CLASSES_ROOT\* サブキーの下に格納されている関連付け情報を使用します。このフラグが設定されている場合、hkClass と pszClass は無視されます。 ASSOCCLASS_FIXED_PROGID_STRWindows 8 で導入されました。pszClass メンバーで指定されたクラスのマッピングの適用に、ユーザーの既定値を使用しません。 ASSOCCLASS_PROTOCOL_STRWindows 8 で導入されました。pszClass メンバーで指定されたクラスのマッピングの適用に、ユーザーの既定値を使用します。このクラスはプロトコルです。 |
| hkClass | HKEY | 8/4 | +4 | +4 | 関連付け情報を含むクラスを指定するレジストリキーです。 |
| pszClass | LPWSTR | 8/4 | +12 | +8 | 関連付け情報を含むクラスの名前へのポインターです。 |
公式ドキュメント
指定されたファイル関連付けに対する IQueryAssociations インターフェイスを取得するために AssocCreateForClasses が使用する情報を定義します。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// ASSOCIATIONELEMENT (x64 20 / x86 12 バイト)
#pragma pack(push, 1)
typedef struct ASSOCIATIONELEMENT {
ASSOCCLASS ac;
HKEY hkClass;
LPWSTR pszClass;
} ASSOCIATIONELEMENT;
#pragma pack(pop)using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, Pack = 1, CharSet = CharSet.Unicode)]
public struct ASSOCIATIONELEMENT
{
public int ac;
public IntPtr hkClass;
public IntPtr pszClass;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, Pack:=1, CharSet:=CharSet.Unicode)>
Public Structure ASSOCIATIONELEMENT
Public ac As Integer
Public hkClass As IntPtr
Public pszClass As IntPtr
End Structureimport ctypes
from ctypes import wintypes
class ASSOCIATIONELEMENT(ctypes.Structure):
_pack_ = 1
_fields_ = [
("ac", ctypes.c_int),
("hkClass", ctypes.c_void_p),
("pszClass", ctypes.c_void_p),
]#[repr(C, packed(1))]
pub struct ASSOCIATIONELEMENT {
pub ac: i32,
pub hkClass: *mut core::ffi::c_void,
pub pszClass: *mut core::ffi::c_void,
}import "golang.org/x/sys/windows"
type ASSOCIATIONELEMENT struct {
ac int32
hkClass uintptr
pszClass uintptr
}type
ASSOCIATIONELEMENT = packed record
ac: Integer;
hkClass: Pointer;
pszClass: Pointer;
end;const ASSOCIATIONELEMENT = extern struct {
ac: i32,
hkClass: ?*anyopaque,
pszClass: ?*anyopaque,
};type
ASSOCIATIONELEMENT {.packed.} = object
ac: int32
hkClass: pointer
pszClass: pointeralign(1)
struct ASSOCIATIONELEMENT
{
int ac;
void* hkClass;
void* pszClass;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; ASSOCIATIONELEMENT サイズ: 12 バイト(x86)
dim st, 3 ; 4byte整数×3(構造体サイズ 12 / 4 切り上げ)
; ac : ASSOCCLASS (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; hkClass : HKEY (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; pszClass : LPWSTR (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; ASSOCIATIONELEMENT サイズ: 20 バイト(x64)
dim st, 5 ; 4byte整数×5(構造体サイズ 20 / 4 切り上げ)
; ac : ASSOCCLASS (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; hkClass : HKEY (+4, 8byte) qpoke st,4,値 / qpeek(st,4) ※IronHSPのみ。3.7/3.8は lpoke st,4,下位 : lpoke st,8,上位
; pszClass : LPWSTR (+12, 8byte) qpoke st,12,値 / qpeek(st,12) ※IronHSPのみ。3.7/3.8は lpoke st,12,下位 : lpoke st,16,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global ASSOCIATIONELEMENT, pack=1
#field int ac
#field intptr hkClass
#field intptr pszClass
#endstruct
stdim st, ASSOCIATIONELEMENT ; NSTRUCT 変数を確保
st->ac = 100
mes "ac=" + st->ac