ACTCTXW
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| cbSize | DWORD | 4 | +0 | +0 | この構造体のサイズ (バイト単位)。この構造体のバージョンを判別するために使用されます。 | ||||||||||||||||
| dwFlags | DWORD | 4 | +4 | +4 | この構造体に含まれる値をどのように使用するかを示すフラグです。dwFlags の未定義のビットはすべて 0 に設定してください。未定義のビットが 0 に設定されていない場合、アクティブ化コンテキストを作成する CreateActCtx の呼び出しは失敗し、無効なパラメーターを示すエラーコードを返します。
| ||||||||||||||||
| lpSource | LPWSTR | 8/4 | +8 | +8 | アクティブ化コンテキストの作成に使用するマニフェストファイルまたは PE イメージのパスを指定する、NULL 終端文字列です。このパスが EXE ファイルまたは DLL ファイルを指す場合は、lpResourceName メンバーが必要です。 | ||||||||||||||||
| wProcessorArchitecture | WORD | 2 | +16 | +12 | 使用されるプロセッサの種類を識別します。システムのプロセッサアーキテクチャを指定します。 この値には次のいずれかを指定できます。 | ||||||||||||||||
| wLangId | WORD | 2 | +18 | +14 | 使用する言語マニフェストを指定します。既定値は、現在のユーザーの現在の UI 言語です。 要求された言語が見つからない場合は、次の順序で近い言語が検索されます。
| ||||||||||||||||
| lpAssemblyDirectory | LPWSTR | 8/4 | +24 | +16 | アクティブ化コンテキスト内のアセンブリがシステム全体のストアに存在しない場合に、プライベートアセンブリの探索 (プローブ) を行う基準ディレクトリです。 | ||||||||||||||||
| lpResourceName | LPWSTR | 8/4 | +32 | +20 | hModule または lpSource で指定された PE から読み込むリソース名を格納する、NULL 終端文字列へのポインターです。リソース名が整数の場合は、MAKEINTRESOURCE を使用してこのメンバーを設定します。lpSource が EXE または DLL を指す場合、このメンバーは必須です。 | ||||||||||||||||
| lpApplicationName | LPWSTR | 8/4 | +40 | +24 | 現在のアプリケーションの名前です。このメンバーの値が NULL に設定されている場合は、現在のプロセスを起動した実行可能ファイルの名前が使用されます。 | ||||||||||||||||
| hModule | HMODULE | 8/4 | +48 | +28 | 既に DLL を読み込んでおり、lpSource のパスを使用する代わりにその DLL を使用してアクティブ化コンテキストを作成する場合は、lpSource ではなくこのメンバーを使用します。このモジュール内でリソースを検索する際の規則については、lpResourceName を参照してください。 |
公式ドキュメント
ACTCTX 構造体は、 CreateActCtx 関数がアクティブ化コンテキストを作成するために使用します。
解説(Remarks)
lpSource メンバーの値で指定されたファイルが PE イメージファイルである場合、 CreateActCtx は、同じディレクトリにある .manifest ファイル内と、その PE イメージファイル内の最初の RT_MANIFEST リソース内からマニフェストを検索します。イメージ内の特定の名前付きリソースを検索するには、lpResourceName にリソース名を設定し、dwFlags メンバーに ACTCTX_FLAG_RESOURCE_NAME_VALID を追加します。リソース名の指定方法の詳細については、 FindResource を参照してください。
ほとんどの場合、呼び出し元は dwFlags メンバーの ACTCTX_FLAG_PROCESSOR_ARCHITECTURE_VALID フラグおよび ACTCTX_FLAG_LANGID_VALID フラグを設定すべきではありません。また、ほとんどの場合、lpResourceName メンバーの値は NULL に設定してください。
アクティブ化コンテキストを作成する実行可能ファイルがアプリケーションのホストである場合、lpApplicationName と lpAssemblyDirectory の値は NULL に設定されません。この場合、ホストはアプリケーションに別の名前を設定して、構成ファイルの検索やエラーの報告などを行うことができます。
winbase.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして ACTCTX を定義しています。エンコーディング中立のエイリアスと、エンコーディング中立でないコードを混在させると、不整合が生じてコンパイルエラーや実行時エラーの原因となることがあります。詳細については、関数プロトタイプの規則 を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// ACTCTXW (x64 56 / x86 32 バイト)
typedef struct ACTCTXW {
DWORD cbSize;
DWORD dwFlags;
LPWSTR lpSource;
WORD wProcessorArchitecture;
WORD wLangId;
LPWSTR lpAssemblyDirectory;
LPWSTR lpResourceName;
LPWSTR lpApplicationName;
HMODULE hModule;
} ACTCTXW;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct ACTCTXW
{
public uint cbSize;
public uint dwFlags;
public IntPtr lpSource;
public ushort wProcessorArchitecture;
public ushort wLangId;
public IntPtr lpAssemblyDirectory;
public IntPtr lpResourceName;
public IntPtr lpApplicationName;
public IntPtr hModule;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure ACTCTXW
Public cbSize As UInteger
Public dwFlags As UInteger
Public lpSource As IntPtr
Public wProcessorArchitecture As UShort
Public wLangId As UShort
Public lpAssemblyDirectory As IntPtr
Public lpResourceName As IntPtr
Public lpApplicationName As IntPtr
Public hModule As IntPtr
End Structureimport ctypes
from ctypes import wintypes
class ACTCTXW(ctypes.Structure):
_fields_ = [
("cbSize", wintypes.DWORD),
("dwFlags", wintypes.DWORD),
("lpSource", ctypes.c_void_p),
("wProcessorArchitecture", ctypes.c_ushort),
("wLangId", ctypes.c_ushort),
("lpAssemblyDirectory", ctypes.c_void_p),
("lpResourceName", ctypes.c_void_p),
("lpApplicationName", ctypes.c_void_p),
("hModule", ctypes.c_void_p),
]#[repr(C)]
pub struct ACTCTXW {
pub cbSize: u32,
pub dwFlags: u32,
pub lpSource: *mut core::ffi::c_void,
pub wProcessorArchitecture: u16,
pub wLangId: u16,
pub lpAssemblyDirectory: *mut core::ffi::c_void,
pub lpResourceName: *mut core::ffi::c_void,
pub lpApplicationName: *mut core::ffi::c_void,
pub hModule: *mut core::ffi::c_void,
}import "golang.org/x/sys/windows"
type ACTCTXW struct {
cbSize uint32
dwFlags uint32
lpSource uintptr
wProcessorArchitecture uint16
wLangId uint16
lpAssemblyDirectory uintptr
lpResourceName uintptr
lpApplicationName uintptr
hModule uintptr
}type
ACTCTXW = record
cbSize: DWORD;
dwFlags: DWORD;
lpSource: Pointer;
wProcessorArchitecture: Word;
wLangId: Word;
lpAssemblyDirectory: Pointer;
lpResourceName: Pointer;
lpApplicationName: Pointer;
hModule: Pointer;
end;const ACTCTXW = extern struct {
cbSize: u32,
dwFlags: u32,
lpSource: ?*anyopaque,
wProcessorArchitecture: u16,
wLangId: u16,
lpAssemblyDirectory: ?*anyopaque,
lpResourceName: ?*anyopaque,
lpApplicationName: ?*anyopaque,
hModule: ?*anyopaque,
};type
ACTCTXW {.bycopy.} = object
cbSize: uint32
dwFlags: uint32
lpSource: pointer
wProcessorArchitecture: uint16
wLangId: uint16
lpAssemblyDirectory: pointer
lpResourceName: pointer
lpApplicationName: pointer
hModule: pointerstruct ACTCTXW
{
uint cbSize;
uint dwFlags;
void* lpSource;
ushort wProcessorArchitecture;
ushort wLangId;
void* lpAssemblyDirectory;
void* lpResourceName;
void* lpApplicationName;
void* hModule;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; ACTCTXW サイズ: 32 バイト(x86)
dim st, 8 ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; dwFlags : DWORD (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; lpSource : LPWSTR (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; wProcessorArchitecture : WORD (+12, 2byte) wpoke st,12,値 / 値 = wpeek(st,12)
; wLangId : WORD (+14, 2byte) wpoke st,14,値 / 値 = wpeek(st,14)
; lpAssemblyDirectory : LPWSTR (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; lpResourceName : LPWSTR (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; lpApplicationName : LPWSTR (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; hModule : HMODULE (+28, 4byte) st.7 = 値 / 値 = st.7 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; ACTCTXW サイズ: 56 バイト(x64)
dim st, 14 ; 4byte整数×14(構造体サイズ 56 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; dwFlags : DWORD (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; lpSource : LPWSTR (+8, 8byte) qpoke st,8,値 / qpeek(st,8) ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; wProcessorArchitecture : WORD (+16, 2byte) wpoke st,16,値 / 値 = wpeek(st,16)
; wLangId : WORD (+18, 2byte) wpoke st,18,値 / 値 = wpeek(st,18)
; lpAssemblyDirectory : LPWSTR (+24, 8byte) qpoke st,24,値 / qpeek(st,24) ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; lpResourceName : LPWSTR (+32, 8byte) qpoke st,32,値 / qpeek(st,32) ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; lpApplicationName : LPWSTR (+40, 8byte) qpoke st,40,値 / qpeek(st,40) ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; hModule : HMODULE (+48, 8byte) qpoke st,48,値 / qpeek(st,48) ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global ACTCTXW
#field int cbSize
#field int dwFlags
#field intptr lpSource
#field short wProcessorArchitecture
#field short wLangId
#field intptr lpAssemblyDirectory
#field intptr lpResourceName
#field intptr lpApplicationName
#field intptr hModule
#endstruct
stdim st, ACTCTXW ; NSTRUCT 変数を確保
st->cbSize = 100
mes "cbSize=" + st->cbSize