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

ACTCTXA

構造体
サイズ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
lpSourceLPSTR8/4+8+8アクティブ化コンテキストの作成に使用するマニフェストファイルまたは PE イメージのパスを指定する、null で終わる文字列です。このパスが EXE または DLL ファイルを指す場合は、lpResourceName メンバーが必要です。
wProcessorArchitectureWORD2+16+12

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

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

wLangIdWORD2+18+14

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

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

  • 現在のユーザーの特定の言語。たとえば、米国英語 (1033)。
  • 現在のユーザーの主要言語。たとえば、英語 (9)。
  • 現在のシステムの特定の言語。
  • 現在のシステムの主要言語。
  • 特定の地域に依存しない言語。言語ニュートラル (0)。
lpAssemblyDirectoryLPSTR8/4+24+16アクティブ化コンテキスト内のアセンブリがシステム全体のストアに存在しない場合に、プライベートアセンブリの探索 (プロービング) を実行する基準ディレクトリです。
lpResourceNameLPSTR8/4+32+20hModule または lpSource で指定した PE から読み込むリソース名を格納した、null で終わる文字列へのポインターです。リソース名が整数の場合は、MAKEINTRESOURCE を使用してこのメンバーを設定します。lpSource が EXE または DLL を指す場合、このメンバーは必須です。
lpApplicationNameLPSTR8/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>

// ACTCTXA  (x64 56 / x86 32 バイト)
typedef struct ACTCTXA {
    DWORD cbSize;
    DWORD dwFlags;
    LPSTR lpSource;
    WORD wProcessorArchitecture;
    WORD wLangId;
    LPSTR lpAssemblyDirectory;
    LPSTR lpResourceName;
    LPSTR lpApplicationName;
    HMODULE hModule;
} ACTCTXA;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct ACTCTXA
{
    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 ACTCTXA
    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 ACTCTXA(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 ACTCTXA {
    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 ACTCTXA struct {
	cbSize uint32
	dwFlags uint32
	lpSource uintptr
	wProcessorArchitecture uint16
	wLangId uint16
	lpAssemblyDirectory uintptr
	lpResourceName uintptr
	lpApplicationName uintptr
	hModule uintptr
}
type
  ACTCTXA = record
    cbSize: DWORD;
    dwFlags: DWORD;
    lpSource: Pointer;
    wProcessorArchitecture: Word;
    wLangId: Word;
    lpAssemblyDirectory: Pointer;
    lpResourceName: Pointer;
    lpApplicationName: Pointer;
    hModule: Pointer;
  end;
const ACTCTXA = extern struct {
    cbSize: u32,
    dwFlags: u32,
    lpSource: ?*anyopaque,
    wProcessorArchitecture: u16,
    wLangId: u16,
    lpAssemblyDirectory: ?*anyopaque,
    lpResourceName: ?*anyopaque,
    lpApplicationName: ?*anyopaque,
    hModule: ?*anyopaque,
};
type
  ACTCTXA {.bycopy.} = object
    cbSize: uint32
    dwFlags: uint32
    lpSource: pointer
    wProcessorArchitecture: uint16
    wLangId: uint16
    lpAssemblyDirectory: pointer
    lpResourceName: pointer
    lpApplicationName: pointer
    hModule: pointer
struct ACTCTXA
{
    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 レイアウト)
; ACTCTXA サイズ: 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 : LPSTR (+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 : LPSTR (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; lpResourceName : LPSTR (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; lpApplicationName : LPSTR (+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 レイアウト)
; ACTCTXA サイズ: 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 : LPSTR (+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 : LPSTR (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; lpResourceName : LPSTR (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; lpApplicationName : LPSTR (+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 ACTCTXA
    #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, ACTCTXA        ; NSTRUCT 変数を確保
st->cbSize = 100
mes "cbSize=" + st->cbSize