Win32 API 日本語リファレンス
ホームSystem.ApplicationInstallationAndServicing › ACTCTXW

ACTCTXW

構造体
サイズx64: 56 バイト / x86: 32 バイト

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

フィールド

フィールドサイズx64x86説明
cbSizeDWORD4+0+0この構造体のサイズ (バイト単位)。この構造体のバージョンを判別するために使用されます。
dwFlagsDWORD4+4+4

この構造体に含まれる値をどのように使用するかを示すフラグです。dwFlags の未定義のビットはすべて 0 に設定してください。未定義のビットが 0 に設定されていない場合、アクティブ化コンテキストを作成する CreateActCtx の呼び出しは失敗し、無効なパラメーターを示すエラーコードを返します。

ビットフラグ 意味
ACTCTX_FLAG_PROCESSOR_ARCHITECTURE_VALID
1
0x001
ACTCTX_FLAG_LANGID_VALID
2
0x002
ACTCTX_FLAG_ASSEMBLY_DIRECTORY_VALID
4
0x004
ACTCTX_FLAG_RESOURCE_NAME_VALID
8
0x008
ACTCTX_FLAG_SET_PROCESS_DEFAULT
16
0x010
ACTCTX_FLAG_APPLICATION_NAME_VALID
32
0x020
ACTCTX_FLAG_HMODULE_VALID
128
0x080
lpSourceLPWSTR8/4+8+8アクティブ化コンテキストの作成に使用するマニフェストファイルまたは PE イメージのパスを指定する、NULL 終端文字列です。このパスが EXE ファイルまたは DLL ファイルを指す場合は、lpResourceName メンバーが必要です。
wProcessorArchitectureWORD2+16+12

使用されるプロセッサの種類を識別します。システムのプロセッサアーキテクチャを指定します。

この値には次のいずれかを指定できます。

wLangIdWORD2+18+14

使用する言語マニフェストを指定します。既定値は、現在のユーザーの現在の UI 言語です。

要求された言語が見つからない場合は、次の順序で近い言語が検索されます。

  • 現在のユーザーの固有の言語。たとえば、米国英語 (1033) です。
  • 現在のユーザーの主要言語。たとえば、英語 (9) です。
  • 現在のシステムの固有の言語。
  • 現在のシステムの主要言語。
  • 地域に依存しない言語。言語ニュートラル (0) です。
lpAssemblyDirectoryLPWSTR8/4+24+16アクティブ化コンテキスト内のアセンブリがシステム全体のストアに存在しない場合に、プライベートアセンブリの探索 (プローブ) を行う基準ディレクトリです。
lpResourceNameLPWSTR8/4+32+20hModule または lpSource で指定された PE から読み込むリソース名を格納する、NULL 終端文字列へのポインターです。リソース名が整数の場合は、MAKEINTRESOURCE を使用してこのメンバーを設定します。lpSource が EXE または DLL を指す場合、このメンバーは必須です。
lpApplicationNameLPWSTR8/4+40+24現在のアプリケーションの名前です。このメンバーの値が NULL に設定されている場合は、現在のプロセスを起動した実行可能ファイルの名前が使用されます。
hModuleHMODULE8/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 に設定してください。

アクティブ化コンテキストを作成する実行可能ファイルがアプリケーションのホストである場合、lpApplicationNamelpAssemblyDirectory の値は NULL に設定されません。この場合、ホストはアプリケーションに別の名前を設定して、構成ファイルの検索やエラーの報告などを行うことができます。

メモ

winbase.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして ACTCTX を定義しています。エンコーディング中立のエイリアスと、エンコーディング中立でないコードを混在させると、不整合が生じてコンパイルエラーや実行時エラーの原因となることがあります。詳細については、関数プロトタイプの規則 を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
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 Structure
import 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: pointer
struct 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