GetFileMUIPath
関数シグネチャ
// KERNEL32.dll
#include <windows.h>
BOOL GetFileMUIPath(
DWORD dwFlags,
LPCWSTR pcwszFilePath,
LPWSTR pwszLanguage, // optional
DWORD* pcchLanguage,
LPWSTR pwszFileMUIPath, // optional
DWORD* pcchFileMUIPath,
ULONGLONG* pululEnumerator
);パラメーター
| 名前 | 型 | 方向 | 説明 | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| dwFlags | DWORD | in | 言語の形式とフィルタリングを指定するフラグです。次のフラグは、pwszLanguage で示される言語の形式を指定します。これらのフラグは相互排他的であり、既定値は MUI_LANGUAGE_NAME です。
次のフラグは、pwszLanguage が NULL に設定されている場合に、関数が言語固有リソースファイルを探す際に使用するフィルタリングを指定します。これらのフィルタリングフラグは相互排他的であり、既定値は MUI_USER_PREFERRED_UI_LANGUAGES です。 次のフラグを使用すると、ユーザーは pcwszFilePath で指定されるファイルの種類を示すことができ、関数はファイル名に ".mui" を追加する必要があるかどうかを判断できます。これらのフラグは相互排他的です。アプリケーションが両方のフラグを渡した場合、関数は失敗します。どちらのフラグも渡さなかった場合、関数はルートフォルダー内のファイルを調べてファイルの種類を確認し、ファイル名の付け方を決定します。
| ||||||||||||
| pcwszFilePath | LPCWSTR | in | ファイルパスを指定する、null 終端文字列へのポインターです。このパスは、既存の LN ファイル、または .txt、.inf、.msc などのファイルのいずれかを指します。ファイルが LN ファイルの場合、関数は関連する言語固有リソースを含むファイルを探します。それ以外のすべての種類のファイルについては、指定されたファイル名およびパスに正確に対応するファイルを探します。アプリケーションは、MUI_LANG_NEUTRAL_PE_FILE フラグまたは MUI_NON_LANG_NEUTRAL_FILE フラグを使用することで、ファイル種別チェックの動作を上書きできます。詳細については、「解説」セクションを参照してください。 Note 指定するファイルパスはネットワークパスでもかまいません。たとえば、"\\machinename\c$\windows\system32\notepad.exe" のように指定できます。
| ||||||||||||
| pwszLanguage | LPWSTR | inoutoptional | 言語文字列を含むバッファーへのポインターです。入力時、このバッファーには、dwFlags の設定に応じて、アプリケーションが言語固有リソースファイルを探す対象となる言語識別子または言語名が格納されます。関数が正常に戻ると、このパラメーターには、関数が見つけた言語固有リソースファイルの言語が格納されます。 あるいは、アプリケーションはこのパラメーターを NULL に設定し、pcchLanguage が参照する値を 0 に設定することもできます。この場合、関数は必要なバッファーサイズを pcchLanguage に取得します。 | ||||||||||||
| pcchLanguage | DWORD* | inout | pwszLanguage で示される言語文字列のバッファーサイズ(文字数)へのポインターです。アプリケーションがこのパラメーターが参照する値を 0 に設定し、pwszLanguage に NULL を渡した場合、必要なバッファーサイズが pcchLanguage に返されます。この関数は通常、連続して複数回呼び出されるため、返されるバッファーサイズは常に LOCALE_NAME_MAX_LENGTH になります。関数は後続のすべての呼び出しにおける言語名の正確なサイズを判断できず、後続の呼び出しでバッファーを拡張することもできません。したがって、安全な最大値は LOCALE_NAME_MAX_LENGTH のみです。 | ||||||||||||
| pwszFileMUIPath | LPWSTR | outoptional | 言語固有リソースファイルへのパスを含むバッファーへのポインターです。このバッファーは MAX_PATH のサイズで確保することを強く推奨します。 あるいは、pcchFileMUIPath が参照する値を 0 に設定した場合、このパラメーターには NULL が取得されます。この場合、関数はファイルパスバッファーに必要なサイズを pcchFileMUIPath に取得します。 | ||||||||||||
| pcchFileMUIPath | DWORD* | inout | pwszFileMUIPath で示されるファイルパスのバッファーサイズ(文字数)へのポインターです。関数が正常に戻ると、このパラメーターは取得されたファイルパスのサイズを示します。アプリケーションがこのパラメーターが参照する値を 0 に設定した場合、関数は pwszFileMUIPath に NULL を取得し、必要なバッファーサイズが pcchFileMUIPath に返されます。この関数は通常、連続して複数回呼び出されるため、返されるバッファーサイズは常に MAX_PATH になります。関数は後続のすべての呼び出しにおけるパスの正確なサイズを判断できず、後続の呼び出しでバッファーを拡張することもできません。したがって、安全な最大値は MAX_PATH のみです。 | ||||||||||||
| pululEnumerator | ULONGLONG* | inout | 列挙用変数へのポインターです。この関数を初めて呼び出すとき、変数の値は 0 にする必要があります。以降の呼び出しの間は、アプリケーションはこのパラメーターの値を変更してはなりません。関数がすべての可能な言語固有リソースファイルパスを取得し終えると、FALSE を返します。 |
戻り値の型: BOOL
公式ドキュメント
指定された LN ファイルに関連付けられた、すべての言語固有リソースファイルへのパスを取得します。各リソースファイルのパスを取得するには、アプリケーションがこの関数を繰り返し呼び出す必要があります。
戻り値
成功した場合は TRUE を、それ以外の場合は FALSE を返します。関数が失敗した場合、出力パラメーターは変更されません。
拡張エラー情報を取得するには、アプリケーションは GetLastError を呼び出すことができます。この関数は次のエラーコードを返すことがあります。
- ERROR_INSUFFICIENT_BUFFER。指定されたバッファーサイズが十分でなかったか、誤って NULL に設定されていました。
- ERROR_NO_MORE_FILES。処理すべきファイルがこれ以上ありませんでした。
解説(Remarks)
この関数は言語固有リソースファイルが存在することを検証しますが、それらが正しいことは検証しません。リソースファイルは、Application Deployment で説明されている格納規則に従って保存されている必要があります。
この関数の呼び出しで MUI_LANGUAGE_ID フラグを指定する場合、指定する言語文字列は、
先頭の 0x を含まない 16 進数の言語識別子を使用し、長さは 4 文字でなければなりません。
たとえば、en-US は "0409"、en は "0009" として渡します。返される言語文字列も
同じ形式になります。
MUI_LANGUAGE_ID を指定する場合、指定する言語文字列内の各 16 進数値は、実際の言語識別子を表していなければなりません。特に、次のロケールに対応する値は指定できません。
- LOCALE_USER_DEFAULT
- LOCALE_SYSTEM_DEFAULT
- LOCALE_CUSTOM_DEFAULT
- LOCALE_CUSTOM_UI_DEFAULT
- LOCALE_CUSTOM_UNSPECIFIED
通常、リソースファイルを見つけるにはリソースローダーが使用されます。ただし、アプリケーションはこの関数を使用してファイルを見つけることもできます。入力ファイルパスが LN ファイルのものである場合、関数は対応する言語固有リソースファイルを探す際に ".mui" というサフィックスを付加します。
たとえば、アプリケーションが pcwszFilePath にルートファイルパスとして文字列 "C:\mydir\Example1.dll" を渡し、dwFlags に MUI_LANGUAGE_NAME | MUI_USE_SEARCH_ALL_LANGUAGES を設定した場合、関数は次のファイルを取得します。
- C:\mydir\Example1.dll
- C:\mydir\en-US\Example1.dll.mui
- C:\mydir\ja-JP\Example1.dll.mui
pcwszFilePath で示されるファイルにリソース構成データがない場合、またはファイルが存在しない場合、関数は対応する言語固有リソースファイルを探す際にファイル名をそのままにします。
たとえば、アプリケーションが pcwszFilePath にルートファイルパスとして文字列 "C:\mydir\Example2.txt" を渡し、dwFlags に MUI_LANGUAGE_NAME | MUI_USER_PREFERRED_UI_LANGUAGES を設定したとします。ユーザーの優先 UI 言語が(順に)カタロニア語 "ca-ES" およびスペイン語(スペイン)"es-ES" であり、次のファイルが存在する場合を考えます。
- (C:\mydir には対応するファイルなし)
- C:\mydir\en-US\Example2.txt
- C:\mydir\en\Example2.txt
- C:\mydir\es-ES\Example2.txt
- C:\mydir\es\Example2.txt
- C:\mydir\ja-JP\Example2.txt
対象ファイルおよびそれに関連付けられたリソースファイルが実際には Side-by-side enabled assemblies である場合、GetFileMUIPath を使用してリソースファイルへのパスを取得することはできません。MUI サポートを伴う Side-by-side アセンブリの使用方法の詳細については、Using Assemblies with a Multilanguage User Interface を参照してください。
C# Signature
[DllImport("Kernel32.dll", CharSet = CharSet.Auto)]
static extern System.Boolean GetFileMUIPath(
System.UInt32 dwFlags,
System.String pcwszFilePath,
System.Text.StringBuilder pwszLanguage,
ref System.UInt32 pcchLanguage,
System.Text.StringBuilder pwszFileMUIPath,
ref System.UInt32 pcchFileMUIPath,
ref System.UInt64 pululEnumerator
);
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での呼び出し定義
// KERNEL32.dll
#include <windows.h>
BOOL GetFileMUIPath(
DWORD dwFlags,
LPCWSTR pcwszFilePath,
LPWSTR pwszLanguage, // optional
DWORD* pcchLanguage,
LPWSTR pwszFileMUIPath, // optional
DWORD* pcchFileMUIPath,
ULONGLONG* pululEnumerator
);[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("KERNEL32.dll", SetLastError = true, ExactSpelling = true)]
static extern bool GetFileMUIPath(
uint dwFlags, // DWORD
[MarshalAs(UnmanagedType.LPWStr)] string pcwszFilePath, // LPCWSTR
[MarshalAs(UnmanagedType.LPWStr)] System.Text.StringBuilder pwszLanguage, // LPWSTR optional, in/out
ref uint pcchLanguage, // DWORD* in/out
[MarshalAs(UnmanagedType.LPWStr)] System.Text.StringBuilder pwszFileMUIPath, // LPWSTR optional, out
ref uint pcchFileMUIPath, // DWORD* in/out
ref ulong pululEnumerator // ULONGLONG* in/out
);<DllImport("KERNEL32.dll", SetLastError:=True, ExactSpelling:=True)>
Public Shared Function GetFileMUIPath(
dwFlags As UInteger, ' DWORD
<MarshalAs(UnmanagedType.LPWStr)> pcwszFilePath As String, ' LPCWSTR
<MarshalAs(UnmanagedType.LPWStr)> pwszLanguage As System.Text.StringBuilder, ' LPWSTR optional, in/out
ByRef pcchLanguage As UInteger, ' DWORD* in/out
<MarshalAs(UnmanagedType.LPWStr)> pwszFileMUIPath As System.Text.StringBuilder, ' LPWSTR optional, out
ByRef pcchFileMUIPath As UInteger, ' DWORD* in/out
ByRef pululEnumerator As ULong ' ULONGLONG* in/out
) As <MarshalAs(UnmanagedType.Bool)> Boolean
End Function' dwFlags : DWORD
' pcwszFilePath : LPCWSTR
' pwszLanguage : LPWSTR optional, in/out
' pcchLanguage : DWORD* in/out
' pwszFileMUIPath : LPWSTR optional, out
' pcchFileMUIPath : DWORD* in/out
' pululEnumerator : ULONGLONG* in/out
Declare PtrSafe Function GetFileMUIPath Lib "kernel32" ( _
ByVal dwFlags As Long, _
ByVal pcwszFilePath As LongPtr, _
ByVal pwszLanguage As LongPtr, _
ByRef pcchLanguage As Long, _
ByVal pwszFileMUIPath As LongPtr, _
ByRef pcchFileMUIPath As Long, _
ByRef pululEnumerator As LongLong) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
GetFileMUIPath = ctypes.windll.kernel32.GetFileMUIPath
GetFileMUIPath.restype = wintypes.BOOL
GetFileMUIPath.argtypes = [
wintypes.DWORD, # dwFlags : DWORD
wintypes.LPCWSTR, # pcwszFilePath : LPCWSTR
wintypes.LPWSTR, # pwszLanguage : LPWSTR optional, in/out
ctypes.POINTER(wintypes.DWORD), # pcchLanguage : DWORD* in/out
wintypes.LPWSTR, # pwszFileMUIPath : LPWSTR optional, out
ctypes.POINTER(wintypes.DWORD), # pcchFileMUIPath : DWORD* in/out
ctypes.POINTER(ctypes.c_ulonglong), # pululEnumerator : ULONGLONG* in/out
]
# GetLastError: use ctypes.GetLastError() (or ctypes.WinDLL(use_last_error=True))require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('KERNEL32.dll')
GetFileMUIPath = Fiddle::Function.new(
lib['GetFileMUIPath'],
[
-Fiddle::TYPE_INT, # dwFlags : DWORD
Fiddle::TYPE_VOIDP, # pcwszFilePath : LPCWSTR
Fiddle::TYPE_VOIDP, # pwszLanguage : LPWSTR optional, in/out
Fiddle::TYPE_VOIDP, # pcchLanguage : DWORD* in/out
Fiddle::TYPE_VOIDP, # pwszFileMUIPath : LPWSTR optional, out
Fiddle::TYPE_VOIDP, # pcchFileMUIPath : DWORD* in/out
Fiddle::TYPE_VOIDP, # pululEnumerator : ULONGLONG* in/out
],
Fiddle::TYPE_INT)#[link(name = "kernel32")]
extern "system" {
fn GetFileMUIPath(
dwFlags: u32, // DWORD
pcwszFilePath: *const u16, // LPCWSTR
pwszLanguage: *mut u16, // LPWSTR optional, in/out
pcchLanguage: *mut u32, // DWORD* in/out
pwszFileMUIPath: *mut u16, // LPWSTR optional, out
pcchFileMUIPath: *mut u32, // DWORD* in/out
pululEnumerator: *mut u64 // ULONGLONG* in/out
) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.$sig = @"
[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("KERNEL32.dll", SetLastError = true)]
public static extern bool GetFileMUIPath(uint dwFlags, [MarshalAs(UnmanagedType.LPWStr)] string pcwszFilePath, [MarshalAs(UnmanagedType.LPWStr)] System.Text.StringBuilder pwszLanguage, ref uint pcchLanguage, [MarshalAs(UnmanagedType.LPWStr)] System.Text.StringBuilder pwszFileMUIPath, ref uint pcchFileMUIPath, ref ulong pululEnumerator);
"@
$api = Add-Type -MemberDefinition $sig -Name 'KERNEL32_GetFileMUIPath' -Namespace Win32 -PassThru
# $api::GetFileMUIPath(dwFlags, pcwszFilePath, pwszLanguage, pcchLanguage, pwszFileMUIPath, pcchFileMUIPath, pululEnumerator)#uselib "KERNEL32.dll"
#func global GetFileMUIPath "GetFileMUIPath" sptr, sptr, sptr, sptr, sptr, sptr, sptr
; GetFileMUIPath dwFlags, pcwszFilePath, varptr(pwszLanguage), varptr(pcchLanguage), varptr(pwszFileMUIPath), varptr(pcchFileMUIPath), varptr(pululEnumerator) ; 戻り値は stat
; dwFlags : DWORD -> "sptr"
; pcwszFilePath : LPCWSTR -> "sptr"
; pwszLanguage : LPWSTR optional, in/out -> "sptr"
; pcchLanguage : DWORD* in/out -> "sptr"
; pwszFileMUIPath : LPWSTR optional, out -> "sptr"
; pcchFileMUIPath : DWORD* in/out -> "sptr"
; pululEnumerator : ULONGLONG* in/out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。#uselib "KERNEL32.dll" #cfunc global GetFileMUIPath "GetFileMUIPath" int, wstr, var, var, var, var, var ; res = GetFileMUIPath(dwFlags, pcwszFilePath, pwszLanguage, pcchLanguage, pwszFileMUIPath, pcchFileMUIPath, pululEnumerator) ; dwFlags : DWORD -> "int" ; pcwszFilePath : LPCWSTR -> "wstr" ; pwszLanguage : LPWSTR optional, in/out -> "var" ; pcchLanguage : DWORD* in/out -> "var" ; pwszFileMUIPath : LPWSTR optional, out -> "var" ; pcchFileMUIPath : DWORD* in/out -> "var" ; pululEnumerator : ULONGLONG* in/out -> "var" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "KERNEL32.dll" #cfunc global GetFileMUIPath "GetFileMUIPath" int, wstr, sptr, sptr, sptr, sptr, sptr ; res = GetFileMUIPath(dwFlags, pcwszFilePath, varptr(pwszLanguage), varptr(pcchLanguage), varptr(pwszFileMUIPath), varptr(pcchFileMUIPath), varptr(pululEnumerator)) ; dwFlags : DWORD -> "int" ; pcwszFilePath : LPCWSTR -> "wstr" ; pwszLanguage : LPWSTR optional, in/out -> "sptr" ; pcchLanguage : DWORD* in/out -> "sptr" ; pwszFileMUIPath : LPWSTR optional, out -> "sptr" ; pcchFileMUIPath : DWORD* in/out -> "sptr" ; pululEnumerator : ULONGLONG* in/out -> "sptr" ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; BOOL GetFileMUIPath(DWORD dwFlags, LPCWSTR pcwszFilePath, LPWSTR pwszLanguage, DWORD* pcchLanguage, LPWSTR pwszFileMUIPath, DWORD* pcchFileMUIPath, ULONGLONG* pululEnumerator) #uselib "KERNEL32.dll" #cfunc global GetFileMUIPath "GetFileMUIPath" int, wstr, var, var, var, var, var ; res = GetFileMUIPath(dwFlags, pcwszFilePath, pwszLanguage, pcchLanguage, pwszFileMUIPath, pcchFileMUIPath, pululEnumerator) ; dwFlags : DWORD -> "int" ; pcwszFilePath : LPCWSTR -> "wstr" ; pwszLanguage : LPWSTR optional, in/out -> "var" ; pcchLanguage : DWORD* in/out -> "var" ; pwszFileMUIPath : LPWSTR optional, out -> "var" ; pcchFileMUIPath : DWORD* in/out -> "var" ; pululEnumerator : ULONGLONG* in/out -> "var" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; BOOL GetFileMUIPath(DWORD dwFlags, LPCWSTR pcwszFilePath, LPWSTR pwszLanguage, DWORD* pcchLanguage, LPWSTR pwszFileMUIPath, DWORD* pcchFileMUIPath, ULONGLONG* pululEnumerator) #uselib "KERNEL32.dll" #cfunc global GetFileMUIPath "GetFileMUIPath" int, wstr, intptr, intptr, intptr, intptr, intptr ; res = GetFileMUIPath(dwFlags, pcwszFilePath, varptr(pwszLanguage), varptr(pcchLanguage), varptr(pwszFileMUIPath), varptr(pcchFileMUIPath), varptr(pululEnumerator)) ; dwFlags : DWORD -> "int" ; pcwszFilePath : LPCWSTR -> "wstr" ; pwszLanguage : LPWSTR optional, in/out -> "intptr" ; pcchLanguage : DWORD* in/out -> "intptr" ; pwszFileMUIPath : LPWSTR optional, out -> "intptr" ; pcchFileMUIPath : DWORD* in/out -> "intptr" ; pululEnumerator : ULONGLONG* in/out -> "intptr" ; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。
import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
kernel32 = windows.NewLazySystemDLL("KERNEL32.dll")
procGetFileMUIPath = kernel32.NewProc("GetFileMUIPath")
)
// dwFlags (DWORD), pcwszFilePath (LPCWSTR), pwszLanguage (LPWSTR optional, in/out), pcchLanguage (DWORD* in/out), pwszFileMUIPath (LPWSTR optional, out), pcchFileMUIPath (DWORD* in/out), pululEnumerator (ULONGLONG* in/out)
r1, _, err := procGetFileMUIPath.Call(
uintptr(dwFlags),
uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(pcwszFilePath))),
uintptr(pwszLanguage),
uintptr(pcchLanguage),
uintptr(pwszFileMUIPath),
uintptr(pcchFileMUIPath),
uintptr(pululEnumerator),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // BOOLfunction GetFileMUIPath(
dwFlags: DWORD; // DWORD
pcwszFilePath: PWideChar; // LPCWSTR
pwszLanguage: PWideChar; // LPWSTR optional, in/out
pcchLanguage: Pointer; // DWORD* in/out
pwszFileMUIPath: PWideChar; // LPWSTR optional, out
pcchFileMUIPath: Pointer; // DWORD* in/out
pululEnumerator: Pointer // ULONGLONG* in/out
): BOOL; stdcall;
external 'KERNEL32.dll' name 'GetFileMUIPath';result := DllCall("KERNEL32\GetFileMUIPath"
, "UInt", dwFlags ; DWORD
, "WStr", pcwszFilePath ; LPCWSTR
, "Ptr", pwszLanguage ; LPWSTR optional, in/out
, "Ptr", pcchLanguage ; DWORD* in/out
, "Ptr", pwszFileMUIPath ; LPWSTR optional, out
, "Ptr", pcchFileMUIPath ; DWORD* in/out
, "Ptr", pululEnumerator ; ULONGLONG* in/out
, "Int") ; return: BOOL●GetFileMUIPath(dwFlags, pcwszFilePath, pwszLanguage, pcchLanguage, pwszFileMUIPath, pcchFileMUIPath, pululEnumerator) = DLL("KERNEL32.dll", "bool GetFileMUIPath(dword, char*, char*, void*, char*, void*, void*)")
# 呼び出し: GetFileMUIPath(dwFlags, pcwszFilePath, pwszLanguage, pcchLanguage, pwszFileMUIPath, pcchFileMUIPath, pululEnumerator)
# dwFlags : DWORD -> "dword"
# pcwszFilePath : LPCWSTR -> "char*"
# pwszLanguage : LPWSTR optional, in/out -> "char*"
# pcchLanguage : DWORD* in/out -> "void*"
# pwszFileMUIPath : LPWSTR optional, out -> "char*"
# pcchFileMUIPath : DWORD* in/out -> "void*"
# pululEnumerator : ULONGLONG* in/out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。const std = @import("std");
extern "kernel32" fn GetFileMUIPath(
dwFlags: u32, // DWORD
pcwszFilePath: [*c]const u16, // LPCWSTR
pwszLanguage: [*c]u16, // LPWSTR optional, in/out
pcchLanguage: [*c]u32, // DWORD* in/out
pwszFileMUIPath: [*c]u16, // LPWSTR optional, out
pcchFileMUIPath: [*c]u32, // DWORD* in/out
pululEnumerator: [*c]u64 // ULONGLONG* in/out
) callconv(std.os.windows.WINAPI) i32;proc GetFileMUIPath(
dwFlags: uint32, # DWORD
pcwszFilePath: WideCString, # LPCWSTR
pwszLanguage: ptr uint16, # LPWSTR optional, in/out
pcchLanguage: ptr uint32, # DWORD* in/out
pwszFileMUIPath: ptr uint16, # LPWSTR optional, out
pcchFileMUIPath: ptr uint32, # DWORD* in/out
pululEnumerator: ptr uint64 # ULONGLONG* in/out
): int32 {.importc: "GetFileMUIPath", stdcall, dynlib: "KERNEL32.dll".}pragma(lib, "kernel32");
extern(Windows)
int GetFileMUIPath(
uint dwFlags, // DWORD
const(wchar)* pcwszFilePath, // LPCWSTR
wchar* pwszLanguage, // LPWSTR optional, in/out
uint* pcchLanguage, // DWORD* in/out
wchar* pwszFileMUIPath, // LPWSTR optional, out
uint* pcchFileMUIPath, // DWORD* in/out
ulong* pululEnumerator // ULONGLONG* in/out
);ccall((:GetFileMUIPath, "KERNEL32.dll"), stdcall, Int32,
(UInt32, Cwstring, Ptr{UInt16}, Ptr{UInt32}, Ptr{UInt16}, Ptr{UInt32}, Ptr{UInt64}),
dwFlags, pcwszFilePath, pwszLanguage, pcchLanguage, pwszFileMUIPath, pcchFileMUIPath, pululEnumerator)
# dwFlags : DWORD -> UInt32
# pcwszFilePath : LPCWSTR -> Cwstring
# pwszLanguage : LPWSTR optional, in/out -> Ptr{UInt16}
# pcchLanguage : DWORD* in/out -> Ptr{UInt32}
# pwszFileMUIPath : LPWSTR optional, out -> Ptr{UInt16}
# pcchFileMUIPath : DWORD* in/out -> Ptr{UInt32}
# pululEnumerator : ULONGLONG* in/out -> Ptr{UInt64}
# stdcall は 32bit のみ意味を持つ(x64 では無視)。local ffi = require("ffi")
ffi.cdef[[
int32_t GetFileMUIPath(
uint32_t dwFlags,
const uint16_t* pcwszFilePath,
uint16_t* pwszLanguage,
uint32_t* pcchLanguage,
uint16_t* pwszFileMUIPath,
uint32_t* pcchFileMUIPath,
uint64_t* pululEnumerator);
]]
local kernel32 = ffi.load("kernel32")
-- kernel32.GetFileMUIPath(dwFlags, pcwszFilePath, pwszLanguage, pcchLanguage, pwszFileMUIPath, pcchFileMUIPath, pululEnumerator)
-- dwFlags : DWORD
-- pcwszFilePath : LPCWSTR
-- pwszLanguage : LPWSTR optional, in/out
-- pcchLanguage : DWORD* in/out
-- pwszFileMUIPath : LPWSTR optional, out
-- pcchFileMUIPath : DWORD* in/out
-- pululEnumerator : ULONGLONG* in/out
-- 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。const koffi = require('koffi');
const lib = koffi.load('KERNEL32.dll');
const GetFileMUIPath = lib.func('__stdcall', 'GetFileMUIPath', 'int32_t', ['uint32_t', 'str16', 'uint16_t *', 'uint32_t *', 'uint16_t *', 'uint32_t *', 'uint64_t *']);
// GetFileMUIPath(dwFlags, pcwszFilePath, pwszLanguage, pcchLanguage, pwszFileMUIPath, pcchFileMUIPath, pululEnumerator)
// dwFlags : DWORD -> 'uint32_t'
// pcwszFilePath : LPCWSTR -> 'str16'
// pwszLanguage : LPWSTR optional, in/out -> 'uint16_t *'
// pcchLanguage : DWORD* in/out -> 'uint32_t *'
// pwszFileMUIPath : LPWSTR optional, out -> 'uint16_t *'
// pcchFileMUIPath : DWORD* in/out -> 'uint32_t *'
// pululEnumerator : ULONGLONG* in/out -> 'uint64_t *'
// 出力ポインタは koffi.out(...) で包む。構造体は koffi.struct で定義。const lib = Deno.dlopen("KERNEL32.dll", {
GetFileMUIPath: { parameters: ["u32", "buffer", "buffer", "pointer", "buffer", "pointer", "pointer"], result: "i32" },
});
// lib.symbols.GetFileMUIPath(dwFlags, pcwszFilePath, pwszLanguage, pcchLanguage, pwszFileMUIPath, pcchFileMUIPath, pululEnumerator)
// dwFlags : DWORD -> "u32"
// pcwszFilePath : LPCWSTR -> "buffer"
// pwszLanguage : LPWSTR optional, in/out -> "buffer"
// pcchLanguage : DWORD* in/out -> "pointer"
// pwszFileMUIPath : LPWSTR optional, out -> "buffer"
// pcchFileMUIPath : DWORD* in/out -> "pointer"
// pululEnumerator : ULONGLONG* in/out -> "pointer"
// 文字列引数は "buffer"(NUL 終端のバイト列を Uint8Array で渡す)。
// 値渡し構造体は { struct: [ ...field types... ] } を使用。<?php
$ffi = FFI::cdef(<<<C
int32_t GetFileMUIPath(
uint32_t dwFlags,
const uint16_t* pcwszFilePath,
uint16_t* pwszLanguage,
uint32_t* pcchLanguage,
uint16_t* pwszFileMUIPath,
uint32_t* pcchFileMUIPath,
uint64_t* pululEnumerator);
C, "KERNEL32.dll");
// $ffi->GetFileMUIPath(dwFlags, pcwszFilePath, pwszLanguage, pcchLanguage, pwszFileMUIPath, pcchFileMUIPath, pululEnumerator);
// dwFlags : DWORD
// pcwszFilePath : LPCWSTR
// pwszLanguage : LPWSTR optional, in/out
// pcchLanguage : DWORD* in/out
// pwszFileMUIPath : LPWSTR optional, out
// pcchFileMUIPath : DWORD* in/out
// pululEnumerator : ULONGLONG* in/out
// 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。
// WINAPI(stdcall): x64 では呼出規約が統一されるため問題なし。x86 では __stdcall 対応のラッパが必要な場合あり。import com.sun.jna.*;
import com.sun.jna.ptr.*;
import com.sun.jna.win32.StdCallLibrary;
import com.sun.jna.win32.W32APIOptions;
public interface Kernel32 extends StdCallLibrary {
Kernel32 INSTANCE = Native.load("kernel32", Kernel32.class);
boolean GetFileMUIPath(
int dwFlags, // DWORD
WString pcwszFilePath, // LPCWSTR
char[] pwszLanguage, // LPWSTR optional, in/out
IntByReference pcchLanguage, // DWORD* in/out
char[] pwszFileMUIPath, // LPWSTR optional, out
IntByReference pcchFileMUIPath, // DWORD* in/out
LongByReference pululEnumerator // ULONGLONG* in/out
);
}@[Link("kernel32")]
lib LibKERNEL32
fun GetFileMUIPath = GetFileMUIPath(
dwFlags : UInt32, # DWORD
pcwszFilePath : UInt16*, # LPCWSTR
pwszLanguage : UInt16*, # LPWSTR optional, in/out
pcchLanguage : UInt32*, # DWORD* in/out
pwszFileMUIPath : UInt16*, # LPWSTR optional, out
pcchFileMUIPath : UInt32*, # DWORD* in/out
pululEnumerator : UInt64* # ULONGLONG* in/out
) : Int32
end
# 構造体/GUID/enum は lib 内に対応する型定義が必要。
# 呼出規約: x64 は規約統一のため OK。x86(32bit)は WINAPI=stdcall だが Crystal の fun に stdcall 付与構文がなく非対応。import 'dart:ffi';
import 'package:ffi/ffi.dart';
typedef GetFileMUIPathNative = Int32 Function(Uint32, Pointer<Utf16>, Pointer<Utf16>, Pointer<Uint32>, Pointer<Utf16>, Pointer<Uint32>, Pointer<Uint64>);
typedef GetFileMUIPathDart = int Function(int, Pointer<Utf16>, Pointer<Utf16>, Pointer<Uint32>, Pointer<Utf16>, Pointer<Uint32>, Pointer<Uint64>);
final GetFileMUIPath = DynamicLibrary.open('KERNEL32.dll')
.lookupFunction<GetFileMUIPathNative, GetFileMUIPathDart>('GetFileMUIPath');
// dwFlags : DWORD -> Uint32
// pcwszFilePath : LPCWSTR -> Pointer<Utf16>
// pwszLanguage : LPWSTR optional, in/out -> Pointer<Utf16>
// pcchLanguage : DWORD* in/out -> Pointer<Uint32>
// pwszFileMUIPath : LPWSTR optional, out -> Pointer<Utf16>
// pcchFileMUIPath : DWORD* in/out -> Pointer<Uint32>
// pululEnumerator : ULONGLONG* in/out -> Pointer<Uint64>
// 文字列は package:ffi の "...".toNativeUtf16()/toNativeUtf8() で変換。{$mode objfpc}{$H+}
function GetFileMUIPath(
dwFlags: DWORD; // DWORD
pcwszFilePath: PWideChar; // LPCWSTR
pwszLanguage: PWideChar; // LPWSTR optional, in/out
pcchLanguage: Pointer; // DWORD* in/out
pwszFileMUIPath: PWideChar; // LPWSTR optional, out
pcchFileMUIPath: Pointer; // DWORD* in/out
pululEnumerator: Pointer // ULONGLONG* in/out
): BOOL; stdcall;
external 'KERNEL32.dll' name 'GetFileMUIPath';import Foreign
import Foreign.C.Types
import Foreign.C.String
foreign import stdcall safe "GetFileMUIPath"
c_GetFileMUIPath :: Word32 -> CWString -> CWString -> Ptr Word32 -> CWString -> Ptr Word32 -> Ptr Word64 -> IO CInt
-- dwFlags : DWORD -> Word32
-- pcwszFilePath : LPCWSTR -> CWString
-- pwszLanguage : LPWSTR optional, in/out -> CWString
-- pcchLanguage : DWORD* in/out -> Ptr Word32
-- pwszFileMUIPath : LPWSTR optional, out -> CWString
-- pcchFileMUIPath : DWORD* in/out -> Ptr Word32
-- pululEnumerator : ULONGLONG* in/out -> Ptr Word64
-- 要 GHC(Windows)。stdcall は x64 では ccall として扱われる。ブロックする API は safe 呼び出し推奨。open Ctypes
open Foreign
let getfilemuipath =
foreign "GetFileMUIPath"
(uint32_t @-> (ptr uint16_t) @-> (ptr uint16_t) @-> (ptr uint32_t) @-> (ptr uint16_t) @-> (ptr uint32_t) @-> (ptr uint64_t) @-> returning int32_t)
(* dwFlags : DWORD -> uint32_t *)
(* pcwszFilePath : LPCWSTR -> (ptr uint16_t) *)
(* pwszLanguage : LPWSTR optional, in/out -> (ptr uint16_t) *)
(* pcchLanguage : DWORD* in/out -> (ptr uint32_t) *)
(* pwszFileMUIPath : LPWSTR optional, out -> (ptr uint16_t) *)
(* pcchFileMUIPath : DWORD* in/out -> (ptr uint32_t) *)
(* pululEnumerator : ULONGLONG* in/out -> (ptr uint64_t) *)
(* foreign は cdecl 前提。x64 Windows では WINAPI と一致。構造体は ctypes structure を定義のこと。 *)(cffi:define-foreign-library kernel32 (t "KERNEL32.dll"))
(cffi:use-foreign-library kernel32)
(cffi:defcfun ("GetFileMUIPath" get-file-muipath :convention :stdcall) :int32
(dw-flags :uint32) ; DWORD
(pcwsz-file-path (:string :encoding :utf-16le)) ; LPCWSTR
(pwsz-language :pointer) ; LPWSTR optional, in/out
(pcch-language :pointer) ; DWORD* in/out
(pwsz-file-muipath :pointer) ; LPWSTR optional, out
(pcch-file-muipath :pointer) ; DWORD* in/out
(pulul-enumerator :pointer)) ; ULONGLONG* in/out
; isize/usize(INT_PTR/SIZE_T)は x64 前提で :int64/:uint64。x86 では :int32/:uint32。use Win32::API;
my $GetFileMUIPath = Win32::API::More->new('KERNEL32',
'BOOL GetFileMUIPath(DWORD dwFlags, LPCWSTR pcwszFilePath, LPWSTR pwszLanguage, LPVOID pcchLanguage, LPWSTR pwszFileMUIPath, LPVOID pcchFileMUIPath, LPVOID pululEnumerator)');
# my $ret = $GetFileMUIPath->Call($dwFlags, $pcwszFilePath, $pwszLanguage, $pcchLanguage, $pwszFileMUIPath, $pcchFileMUIPath, $pululEnumerator);
# dwFlags : DWORD -> DWORD
# pcwszFilePath : LPCWSTR -> LPCWSTR
# pwszLanguage : LPWSTR optional, in/out -> LPWSTR
# pcchLanguage : DWORD* in/out -> LPVOID
# pwszFileMUIPath : LPWSTR optional, out -> LPWSTR
# pcchFileMUIPath : DWORD* in/out -> LPVOID
# pululEnumerator : ULONGLONG* in/out -> LPVOID
# 値渡し構造体は pack() した文字列、または Win32::API::Struct を使用。関連項目
- f GetThreadUILanguage — 現在のスレッドのUI言語識別子を取得する。
- f SetThreadPreferredUILanguages — 現在のスレッドの優先UI言語リストを設定する。
- f SetThreadUILanguage — 現在のスレッドのUI言語を設定する。