Win32 API 日本語リファレンス
ホームGlobalization › GetFileMUIPath

GetFileMUIPath

関数
指定ファイルに対応する言語別MUIファイルのパスを取得する。
DLLKERNEL32.dll呼出規約winapiSetLastErrorあり対応OSWindows Vista 以降

シグネチャ

// KERNEL32.dll
#include <windows.h>

BOOL GetFileMUIPath(
    DWORD dwFlags,
    LPCWSTR pcwszFilePath,
    LPWSTR pwszLanguage,   // optional
    DWORD* pcchLanguage,
    LPWSTR pwszFileMUIPath,   // optional
    DWORD* pcchFileMUIPath,
    ULONGLONG* pululEnumerator
);

パラメーター

名前方向説明
dwFlagsDWORDin

言語の形式とフィルタリングを指定するフラグです。次のフラグは、pwszLanguage で示される言語の形式を指定します。これらのフラグは相互排他的であり、既定値は MUI_LANGUAGE_NAME です。

Value Meaning
MUI_LANGUAGE_ID
言語文字列を language identifier 形式で取得します。
MUI_LANGUAGE_NAME
言語文字列を language name 形式で取得します。

次のフラグは、pwszLanguageNULL に設定されている場合に、関数が言語固有リソースファイルを探す際に使用するフィルタリングを指定します。これらのフィルタリングフラグは相互排他的であり、既定値は MUI_USER_PREFERRED_UI_LANGUAGES です。

Value Meaning
MUI_USE_SEARCH_ALL_LANGUAGES
ファイルのライセンスを考慮せずに、pcwszFilePath で示されるパスに対するすべての言語固有リソースファイルを取得します。このフラグは、アプリケーションが pwszLanguage に空文字列を指定した場合にのみ有効です。
MUI_USER_PREFERRED_UI_LANGUAGES
フォールバックリストに含まれる言語を実装するファイルのみを取得します。連続して呼び出すと、適切な順序でフォールバックが順に列挙されます。pcchFileMUIPath の出力値で示される最初のファイルが、最も適合するものになります。このフラグは、アプリケーションが pwszLanguage に空文字列を指定した場合にのみ有効です。
MUI_USE_INSTALLED_LANGUAGES
コンピューターにインストールされている言語のファイルのみを取得します。このフラグは、アプリケーションが pwszLanguage に空文字列を指定した場合にのみ有効です。

次のフラグを使用すると、ユーザーは pcwszFilePath で指定されるファイルの種類を示すことができ、関数はファイル名に ".mui" を追加する必要があるかどうかを判断できます。これらのフラグは相互排他的です。アプリケーションが両方のフラグを渡した場合、関数は失敗します。どちらのフラグも渡さなかった場合、関数はルートフォルダー内のファイルを調べてファイルの種類を確認し、ファイル名の付け方を決定します。

Value Meaning
MUI_LANG_NEUTRAL_PE_FILE
pcwszFilePath で渡されたファイルを検証せず、処理前にファイル名に ".mui" を追加します。たとえば、Abc.exe を Abc.exe.mui に変更します。
MUI_NON_LANG_NEUTRAL_FILE
pcwszFilePath で渡されたファイルを検証せず、処理前にファイル名に ".mui" を追加しません。たとえば、Abc.txt や Abc.chm をそのまま使用します。
pcwszFilePathLPCWSTRin

ファイルパスを指定する、null 終端文字列へのポインターです。このパスは、既存の LN ファイル、または .txt、.inf、.msc などのファイルのいずれかを指します。ファイルが LN ファイルの場合、関数は関連する言語固有リソースを含むファイルを探します。それ以外のすべての種類のファイルについては、指定されたファイル名およびパスに正確に対応するファイルを探します。アプリケーションは、MUI_LANG_NEUTRAL_PE_FILE フラグまたは MUI_NON_LANG_NEUTRAL_FILE フラグを使用することで、ファイル種別チェックの動作を上書きできます。詳細については、「解説」セクションを参照してください。

Note 指定するファイルパスはネットワークパスでもかまいません。たとえば、"\\machinename\c$\windows\system32\notepad.exe" のように指定できます。
pwszLanguageLPWSTRinoutoptional

言語文字列を含むバッファーへのポインターです。入力時、このバッファーには、dwFlags の設定に応じて、アプリケーションが言語固有リソースファイルを探す対象となる言語識別子または言語名が格納されます。関数が正常に戻ると、このパラメーターには、関数が見つけた言語固有リソースファイルの言語が格納されます。

あるいは、アプリケーションはこのパラメーターを NULL に設定し、pcchLanguage が参照する値を 0 に設定することもできます。この場合、関数は必要なバッファーサイズを pcchLanguage に取得します。

pcchLanguageDWORD*inoutpwszLanguage で示される言語文字列のバッファーサイズ(文字数)へのポインターです。アプリケーションがこのパラメーターが参照する値を 0 に設定し、pwszLanguageNULL を渡した場合、必要なバッファーサイズが pcchLanguage に返されます。この関数は通常、連続して複数回呼び出されるため、返されるバッファーサイズは常に LOCALE_NAME_MAX_LENGTH になります。関数は後続のすべての呼び出しにおける言語名の正確なサイズを判断できず、後続の呼び出しでバッファーを拡張することもできません。したがって、安全な最大値は LOCALE_NAME_MAX_LENGTH のみです。
pwszFileMUIPathLPWSTRoutoptional

言語固有リソースファイルへのパスを含むバッファーへのポインターです。このバッファーは MAX_PATH のサイズで確保することを強く推奨します。

あるいは、pcchFileMUIPath が参照する値を 0 に設定した場合、このパラメーターには NULL が取得されます。この場合、関数はファイルパスバッファーに必要なサイズを pcchFileMUIPath に取得します。

pcchFileMUIPathDWORD*inoutpwszFileMUIPath で示されるファイルパスのバッファーサイズ(文字数)へのポインターです。関数が正常に戻ると、このパラメーターは取得されたファイルパスのサイズを示します。アプリケーションがこのパラメーターが参照する値を 0 に設定した場合、関数は pwszFileMUIPathNULL を取得し、必要なバッファーサイズが pcchFileMUIPath に返されます。この関数は通常、連続して複数回呼び出されるため、返されるバッファーサイズは常に MAX_PATH になります。関数は後続のすべての呼び出しにおけるパスの正確なサイズを判断できず、後続の呼び出しでバッファーを拡張することもできません。したがって、安全な最大値は MAX_PATH のみです。
pululEnumeratorULONGLONG*inout列挙用変数へのポインターです。この関数を初めて呼び出すとき、変数の値は 0 にする必要があります。以降の呼び出しの間は、アプリケーションはこのパラメーターの値を変更してはなりません。関数がすべての可能な言語固有リソースファイルパスを取得し終えると、FALSE を返します。

戻り値の型: BOOL

公式ドキュメント

指定された LN ファイルに関連付けられた、すべての言語固有リソースファイルへのパスを取得します。各リソースファイルのパスを取得するには、アプリケーションがこの関数を繰り返し呼び出す必要があります。

戻り値

成功した場合は TRUE を、それ以外の場合は FALSE を返します。関数が失敗した場合、出力パラメーターは変更されません。

拡張エラー情報を取得するには、アプリケーションは GetLastError を呼び出すことができます。この関数は次のエラーコードを返すことがあります。

解説(Remarks)

この関数は言語固有リソースファイルが存在することを検証しますが、それらが正しいことは検証しません。リソースファイルは、Application Deployment で説明されている格納規則に従って保存されている必要があります。

この関数の呼び出しで MUI_LANGUAGE_ID フラグを指定する場合、指定する言語文字列は、

先頭の 0x を含まない 16 進数の言語識別子を使用し、長さは 4 文字でなければなりません。

たとえば、en-US は "0409"、en は "0009" として渡します。返される言語文字列も

同じ形式になります。

MUI_LANGUAGE_ID を指定する場合、指定する言語文字列内の各 16 進数値は、実際の言語識別子を表していなければなりません。特に、次のロケールに対応する値は指定できません。

列挙された情報を受け取るには、アプリケーションはこの関数が FALSE を返すまで繰り返し呼び出し、その間 pululEnumerator の内容を変更しないでください。各呼び出しは異なる言語固有リソースファイルへのパスを取得するため、アプリケーションは呼び出しの間に言語バッファーを空文字列にクリアしなければなりません。これを行わない場合、pwszLanguage の入力値が dwFlags の設定より優先されます。

通常、リソースファイルを見つけるにはリソースローダーが使用されます。ただし、アプリケーションはこの関数を使用してファイルを見つけることもできます。入力ファイルパスが LN ファイルのものである場合、関数は対応する言語固有リソースファイルを探す際に ".mui" というサフィックスを付加します。

たとえば、アプリケーションが pcwszFilePath にルートファイルパスとして文字列 "C:\mydir\Example1.dll" を渡し、dwFlagsMUI_LANGUAGE_NAME | MUI_USE_SEARCH_ALL_LANGUAGES を設定した場合、関数は次のファイルを取得します。

関数の最初の呼び出しでは、pwszFileMUIPath が "C:\mydir\en-US\Example1.dll.mui" に設定されます。2 回目の呼び出しでは、ファイルパスが "C:\mydir\ja-JP\Example1.dll.mui" に設定されます。3 回目に呼び出すと関数は FALSE を返し、GetLastErrorERROR_NO_MORE_FILES を返します。

pcwszFilePath で示されるファイルにリソース構成データがない場合、またはファイルが存在しない場合、関数は対応する言語固有リソースファイルを探す際にファイル名をそのままにします。

たとえば、アプリケーションが pcwszFilePath にルートファイルパスとして文字列 "C:\mydir\Example2.txt" を渡し、dwFlagsMUI_LANGUAGE_NAME | MUI_USER_PREFERRED_UI_LANGUAGES を設定したとします。ユーザーの優先 UI 言語が(順に)カタロニア語 "ca-ES" およびスペイン語(スペイン)"es-ES" であり、次のファイルが存在する場合を考えます。

関数の最初の呼び出しでは、"ca-ES" およびニュートラル言語 "ca" に対するリソースが存在しないと判断されます。次に関数は次の選択肢である "es-ES" を試し、一致を見つけることに成功します。戻る前に、関数は pwszFileMUIPath を "C:\mydir\es-ES\Example2.txt" に設定します。アプリケーションが 2 回目に関数を呼び出すと、列挙が続行され、pwszFileMUIPath が "C:\mydir\es\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 の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
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 方式にも切替可。
出力引数:
; 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 方式にも切替可。
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   // BOOL
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';
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 を使用。

関連項目

公式の関連項目