ホーム › System.ApplicationInstallationAndServicing › ACTCTX_SECTION_KEYED_DATA

ACTCTX_SECTION_KEYED_DATA

構造体

サイズx64: 112 バイト / x86: 64 バイト

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

フィールド

フィールド	型	サイズ	x64	x86	説明
cbSize	DWORD	4	+0	+0	アクティブ化コンテキストのキー付きデータ構造体のサイズ (バイト単位) です。
ulDataFormatVersion	DWORD	4	+4	+4	キーが見つかったセクション内のデータの形式を示す番号です。クライアントは、未知のデータ形式の値を解釈しようとするのではなく、データ形式のバージョンが想定どおりであることを確認してください。この番号は、セクションのデータ形式に下位互換性のない大きな変更を加える必要がある場合にのみ変更されます。現在の形式のバージョンは 1 です。
lpData	void*	8/4	+8	+8	セクション識別子とキーに関連付けて見つかったリダイレクトデータへのポインターです。
ulLength	DWORD	4	+16	+12	lpData が参照する構造体のバイト数です。データ構造は時間の経過とともに拡張されるため、ulLength を超える範囲のインスタンスデータのメンバーにはアクセスしないでください。
lpSectionGlobalData	void*	8/4	+24	+16	キーが見つかったアクティブ化コンテキストセクション全体に共通する、セクション固有のデータ構造体へのポインターが返されます。その解釈は、要求されたセクション識別子によって異なります。
ulSectionGlobalDataLength	DWORD	4	+32	+20	lpSectionGlobalData が参照するセクショングローバルデータブロックのバイト数です。データ構造は時間の経過とともに拡張されるため、古い形式のアクティブ化コンテキストデータブロックを受け取る可能性があることに注意してください。ulSectionGlobalDataLength を超える範囲のセクショングローバルデータのメンバーにはアクセスしないでください。
lpSectionBase	void*	8/4	+40	+24	キーが見つかったセクションの先頭へのポインターです。一部のインスタンスデータにはセクションの基底アドレスからの相対オフセットが含まれており、その場合にこのポインター値を使用します。
ulSectionTotalLength	DWORD	4	+48	+28	lpSectionBase から始まるセクション全体のバイト数です。セクションの基底からの相対値として指定されたオフセットと長さの組が、セクション内に完全に収まっていることを確認するために使用できます。
hActCtx	HANDLE	8/4	+56	+32	キーが見つかったアクティブ化コンテキストへのハンドルです。最初にスレッドのアクティブなアクティブ化コンテキストが検索され、続いてプロセス既定のアクティブ化コンテキスト、次にシステム互換既定のアクティブ化コンテキストが検索されます。このメンバーは、要求されたセクションとキーを含んでいたアクティブ化コンテキストを示します。これは FIND_ACTCTX_SECTION_KEY_RETURN_HACTCTX フラグが渡された場合にのみ返されます。これが返された場合、呼び出し元は、アクティブ化コンテキストへの他のすべての参照が解放された後に、返されたアクティブ化コンテキストハンドルに対して ReleaseActCtx() を呼び出してシステムリソースを解放する必要があります。
ulAssemblyRosterIndex	DWORD	4	+64	+36	見つかったリダイレクト情報を提供した、アクティブ化コンテキスト内のアセンブリの基数です。この値を QueryActCtxW に渡すと、情報を提供したアセンブリに関する詳細を取得できます。
ulFlags	DWORD	4	+68	+40	返却データに関するフラグ。
AssemblyMetadata	ACTCTX_SECTION_KEYED_DATA_ASSEMBLY_METADATA	40/20	+72	+44	アセンブリのメタデータ情報を保持するサブ構造体。

公式ドキュメント

ACTCTX_SECTION_KEYED_DATA 構造体は、 FindActCtxSectionString 関数および FindActCtxSectionGuid 関数が、GUID または 32 ビット整数でタグ付けされたアクティブ化コンテキストセクションと共に、アクティブ化コンテキスト情報を返すために使用します。

解説(Remarks)

呼び出し元は、 ACTCTX_SECTION_KEYED_DATA 構造体を次のように初期化してください。

"ACTCTX_SECTION_KEYED_DATA askd = { sizeof(askd) };"

これにより、正しく設定されるサイズフィールドを除くすべてのメンバーが 0 または null に初期化されます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// ACTCTX_SECTION_KEYED_DATA_ASSEMBLY_METADATA  (x64 40 / x86 20 バイト)
typedef struct ACTCTX_SECTION_KEYED_DATA_ASSEMBLY_METADATA {
    void* lpInformation;
    void* lpSectionBase;
    DWORD ulSectionLength;
    void* lpSectionGlobalDataBase;
    DWORD ulSectionGlobalDataLength;
} ACTCTX_SECTION_KEYED_DATA_ASSEMBLY_METADATA;

// ACTCTX_SECTION_KEYED_DATA  (x64 112 / x86 64 バイト)
typedef struct ACTCTX_SECTION_KEYED_DATA {
    DWORD cbSize;
    DWORD ulDataFormatVersion;
    void* lpData;
    DWORD ulLength;
    void* lpSectionGlobalData;
    DWORD ulSectionGlobalDataLength;
    void* lpSectionBase;
    DWORD ulSectionTotalLength;
    HANDLE hActCtx;
    DWORD ulAssemblyRosterIndex;
    DWORD ulFlags;
    ACTCTX_SECTION_KEYED_DATA_ASSEMBLY_METADATA AssemblyMetadata;
} ACTCTX_SECTION_KEYED_DATA;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct ACTCTX_SECTION_KEYED_DATA_ASSEMBLY_METADATA
{
    public IntPtr lpInformation;
    public IntPtr lpSectionBase;
    public uint ulSectionLength;
    public IntPtr lpSectionGlobalDataBase;
    public uint ulSectionGlobalDataLength;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct ACTCTX_SECTION_KEYED_DATA
{
    public uint cbSize;
    public uint ulDataFormatVersion;
    public IntPtr lpData;
    public uint ulLength;
    public IntPtr lpSectionGlobalData;
    public uint ulSectionGlobalDataLength;
    public IntPtr lpSectionBase;
    public uint ulSectionTotalLength;
    public IntPtr hActCtx;
    public uint ulAssemblyRosterIndex;
    public uint ulFlags;
    public ACTCTX_SECTION_KEYED_DATA_ASSEMBLY_METADATA AssemblyMetadata;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure ACTCTX_SECTION_KEYED_DATA_ASSEMBLY_METADATA
    Public lpInformation As IntPtr
    Public lpSectionBase As IntPtr
    Public ulSectionLength As UInteger
    Public lpSectionGlobalDataBase As IntPtr
    Public ulSectionGlobalDataLength As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure ACTCTX_SECTION_KEYED_DATA
    Public cbSize As UInteger
    Public ulDataFormatVersion As UInteger
    Public lpData As IntPtr
    Public ulLength As UInteger
    Public lpSectionGlobalData As IntPtr
    Public ulSectionGlobalDataLength As UInteger
    Public lpSectionBase As IntPtr
    Public ulSectionTotalLength As UInteger
    Public hActCtx As IntPtr
    Public ulAssemblyRosterIndex As UInteger
    Public ulFlags As UInteger
    Public AssemblyMetadata As ACTCTX_SECTION_KEYED_DATA_ASSEMBLY_METADATA
End Structure

import ctypes
from ctypes import wintypes

class ACTCTX_SECTION_KEYED_DATA_ASSEMBLY_METADATA(ctypes.Structure):
    _fields_ = [
        ("lpInformation", ctypes.c_void_p),
        ("lpSectionBase", ctypes.c_void_p),
        ("ulSectionLength", wintypes.DWORD),
        ("lpSectionGlobalDataBase", ctypes.c_void_p),
        ("ulSectionGlobalDataLength", wintypes.DWORD),
    ]

class ACTCTX_SECTION_KEYED_DATA(ctypes.Structure):
    _fields_ = [
        ("cbSize", wintypes.DWORD),
        ("ulDataFormatVersion", wintypes.DWORD),
        ("lpData", ctypes.c_void_p),
        ("ulLength", wintypes.DWORD),
        ("lpSectionGlobalData", ctypes.c_void_p),
        ("ulSectionGlobalDataLength", wintypes.DWORD),
        ("lpSectionBase", ctypes.c_void_p),
        ("ulSectionTotalLength", wintypes.DWORD),
        ("hActCtx", ctypes.c_void_p),
        ("ulAssemblyRosterIndex", wintypes.DWORD),
        ("ulFlags", wintypes.DWORD),
        ("AssemblyMetadata", ACTCTX_SECTION_KEYED_DATA_ASSEMBLY_METADATA),
    ]

#[repr(C)]
pub struct ACTCTX_SECTION_KEYED_DATA_ASSEMBLY_METADATA {
    pub lpInformation: *mut core::ffi::c_void,
    pub lpSectionBase: *mut core::ffi::c_void,
    pub ulSectionLength: u32,
    pub lpSectionGlobalDataBase: *mut core::ffi::c_void,
    pub ulSectionGlobalDataLength: u32,
}

#[repr(C)]
pub struct ACTCTX_SECTION_KEYED_DATA {
    pub cbSize: u32,
    pub ulDataFormatVersion: u32,
    pub lpData: *mut core::ffi::c_void,
    pub ulLength: u32,
    pub lpSectionGlobalData: *mut core::ffi::c_void,
    pub ulSectionGlobalDataLength: u32,
    pub lpSectionBase: *mut core::ffi::c_void,
    pub ulSectionTotalLength: u32,
    pub hActCtx: *mut core::ffi::c_void,
    pub ulAssemblyRosterIndex: u32,
    pub ulFlags: u32,
    pub AssemblyMetadata: ACTCTX_SECTION_KEYED_DATA_ASSEMBLY_METADATA,
}

import "golang.org/x/sys/windows"

type ACTCTX_SECTION_KEYED_DATA_ASSEMBLY_METADATA struct {
	lpInformation uintptr
	lpSectionBase uintptr
	ulSectionLength uint32
	lpSectionGlobalDataBase uintptr
	ulSectionGlobalDataLength uint32
}

type ACTCTX_SECTION_KEYED_DATA struct {
	cbSize uint32
	ulDataFormatVersion uint32
	lpData uintptr
	ulLength uint32
	lpSectionGlobalData uintptr
	ulSectionGlobalDataLength uint32
	lpSectionBase uintptr
	ulSectionTotalLength uint32
	hActCtx uintptr
	ulAssemblyRosterIndex uint32
	ulFlags uint32
	AssemblyMetadata ACTCTX_SECTION_KEYED_DATA_ASSEMBLY_METADATA
}

type
  ACTCTX_SECTION_KEYED_DATA_ASSEMBLY_METADATA = record
    lpInformation: Pointer;
    lpSectionBase: Pointer;
    ulSectionLength: DWORD;
    lpSectionGlobalDataBase: Pointer;
    ulSectionGlobalDataLength: DWORD;
  end;

  ACTCTX_SECTION_KEYED_DATA = record
    cbSize: DWORD;
    ulDataFormatVersion: DWORD;
    lpData: Pointer;
    ulLength: DWORD;
    lpSectionGlobalData: Pointer;
    ulSectionGlobalDataLength: DWORD;
    lpSectionBase: Pointer;
    ulSectionTotalLength: DWORD;
    hActCtx: Pointer;
    ulAssemblyRosterIndex: DWORD;
    ulFlags: DWORD;
    AssemblyMetadata: ACTCTX_SECTION_KEYED_DATA_ASSEMBLY_METADATA;
  end;

const ACTCTX_SECTION_KEYED_DATA_ASSEMBLY_METADATA = extern struct {
    lpInformation: ?*anyopaque,
    lpSectionBase: ?*anyopaque,
    ulSectionLength: u32,
    lpSectionGlobalDataBase: ?*anyopaque,
    ulSectionGlobalDataLength: u32,
};

const ACTCTX_SECTION_KEYED_DATA = extern struct {
    cbSize: u32,
    ulDataFormatVersion: u32,
    lpData: ?*anyopaque,
    ulLength: u32,
    lpSectionGlobalData: ?*anyopaque,
    ulSectionGlobalDataLength: u32,
    lpSectionBase: ?*anyopaque,
    ulSectionTotalLength: u32,
    hActCtx: ?*anyopaque,
    ulAssemblyRosterIndex: u32,
    ulFlags: u32,
    AssemblyMetadata: ACTCTX_SECTION_KEYED_DATA_ASSEMBLY_METADATA,
};

type
  ACTCTX_SECTION_KEYED_DATA_ASSEMBLY_METADATA {.bycopy.} = object
    lpInformation: pointer
    lpSectionBase: pointer
    ulSectionLength: uint32
    lpSectionGlobalDataBase: pointer
    ulSectionGlobalDataLength: uint32

  ACTCTX_SECTION_KEYED_DATA {.bycopy.} = object
    cbSize: uint32
    ulDataFormatVersion: uint32
    lpData: pointer
    ulLength: uint32
    lpSectionGlobalData: pointer
    ulSectionGlobalDataLength: uint32
    lpSectionBase: pointer
    ulSectionTotalLength: uint32
    hActCtx: pointer
    ulAssemblyRosterIndex: uint32
    ulFlags: uint32
    AssemblyMetadata: ACTCTX_SECTION_KEYED_DATA_ASSEMBLY_METADATA

struct ACTCTX_SECTION_KEYED_DATA_ASSEMBLY_METADATA
{
    void* lpInformation;
    void* lpSectionBase;
    uint ulSectionLength;
    void* lpSectionGlobalDataBase;
    uint ulSectionGlobalDataLength;
}

struct ACTCTX_SECTION_KEYED_DATA
{
    uint cbSize;
    uint ulDataFormatVersion;
    void* lpData;
    uint ulLength;
    void* lpSectionGlobalData;
    uint ulSectionGlobalDataLength;
    void* lpSectionBase;
    uint ulSectionTotalLength;
    void* hActCtx;
    uint ulAssemblyRosterIndex;
    uint ulFlags;
    ACTCTX_SECTION_KEYED_DATA_ASSEMBLY_METADATA AssemblyMetadata;
}

HSP用定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; ACTCTX_SECTION_KEYED_DATA サイズ: 64 バイト(x86)
dim st, 16    ; 4byte整数×16(構造体サイズ 64 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; ulDataFormatVersion : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; lpData : void* (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; ulLength : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; lpSectionGlobalData : void* (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; ulSectionGlobalDataLength : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; lpSectionBase : void* (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; ulSectionTotalLength : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; hActCtx : HANDLE (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; ulAssemblyRosterIndex : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; ulFlags : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; AssemblyMetadata : ACTCTX_SECTION_KEYED_DATA_ASSEMBLY_METADATA (+44, 20byte)  varptr(st)+44 を基点に操作(20byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; ACTCTX_SECTION_KEYED_DATA サイズ: 112 バイト(x64)
dim st, 28    ; 4byte整数×28(構造体サイズ 112 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; ulDataFormatVersion : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; lpData : void* (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; ulLength : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; lpSectionGlobalData : void* (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; ulSectionGlobalDataLength : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; lpSectionBase : void* (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; ulSectionTotalLength : DWORD (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; hActCtx : HANDLE (+56, 8byte)  qpoke st,56,値 / qpeek(st,56)  ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; ulAssemblyRosterIndex : DWORD (+64, 4byte)  st.16 = 値  /  値 = st.16   (lpoke/lpeek も可)
; ulFlags : DWORD (+68, 4byte)  st.17 = 値  /  値 = st.17   (lpoke/lpeek も可)
; AssemblyMetadata : ACTCTX_SECTION_KEYED_DATA_ASSEMBLY_METADATA (+72, 40byte)  varptr(st)+72 を基点に操作(40byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global ACTCTX_SECTION_KEYED_DATA_ASSEMBLY_METADATA
    #field intptr lpInformation
    #field intptr lpSectionBase
    #field int ulSectionLength
    #field intptr lpSectionGlobalDataBase
    #field int ulSectionGlobalDataLength
#endstruct

#defstruct global ACTCTX_SECTION_KEYED_DATA
    #field int cbSize
    #field int ulDataFormatVersion
    #field intptr lpData
    #field int ulLength
    #field intptr lpSectionGlobalData
    #field int ulSectionGlobalDataLength
    #field intptr lpSectionBase
    #field int ulSectionTotalLength
    #field intptr hActCtx
    #field int ulAssemblyRosterIndex
    #field int ulFlags
    #field ACTCTX_SECTION_KEYED_DATA_ASSEMBLY_METADATA AssemblyMetadata
#endstruct

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