LoadLibraryExA
関数シグネチャ
// KERNEL32.dll (ANSI / -A)
#include <windows.h>
HMODULE LoadLibraryExA(
LPCSTR lpLibFileName,
HANDLE hFile, // optional
LOAD_LIBRARY_FLAGS dwFlags
);パラメーター
| 名前 | 型 | 方向 | 説明 | ||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| lpLibFileName | LPCSTR | in | ロードするモジュールのファイル名を指定する文字列です。この名前は、モジュール定義ファイル (.def) 内の LIBRARY キーワードで指定される、ライブラリ モジュール自身に格納された名前とは関係ありません。 モジュールには、ライブラリ モジュール (.dll ファイル) または実行可能モジュール (.exe ファイル) を指定できます。指定したモジュールが実行可能モジュールの場合、静的インポートはロードされず、代わりに DONT_RESOLVE_DLL_REFERENCES が指定された場合と同様にロードされます。詳細については dwFlags パラメーターを参照してください。 文字列でパスを伴わないモジュール名を指定し、ファイル名拡張子を省略した場合、この関数はモジュール名に既定のライブラリ拡張子 ".DLL" を付加します。".DLL" の付加を防ぐには、モジュール名文字列の末尾にピリオド文字 (.) を含めます。 文字列で完全修飾パスを指定した場合、この関数はそのパスのみでモジュールを検索します。パスを指定する際は、スラッシュ (/) ではなくバックスラッシュ (\) を使用してください。パスの詳細については、ファイル、パス、名前空間の名前付けを参照してください。 文字列でパスを伴わないモジュール名を指定し、同じ基本名と拡張子を持つモジュールが複数ロードされている場合、この関数は最初にロードされたモジュールのハンドルを返します。 文字列でパスを伴わないモジュール名を指定し、同じ名前のモジュールがまだロードされていない場合、または相対パス付きのモジュール名を指定した場合、この関数は指定したモジュールを検索します。また、指定したモジュールのロードによってシステムが他の関連モジュールをロードする場合 (つまりモジュールに依存関係がある場合)、それらのモジュールも検索します。検索されるディレクトリとその検索順序は、指定したパスと dwFlags パラメーターによって異なります。詳細については「解説」を参照してください。 この関数がモジュールまたはその依存関係のいずれかを見つけられない場合、関数は失敗します。 | ||||||||||||||||||||||||||||
| hFile | HANDLE | optional | このパラメーターは将来の使用のために予約されています。NULL でなければなりません。 | ||||||||||||||||||||||||||||
| dwFlags | LOAD_LIBRARY_FLAGS | in | モジュールのロード時に実行するアクションです。フラグを指定しない場合、この関数の動作は LoadLibrary 関数と同一になります。このパラメーターには、次の値のいずれかを指定できます。
|
戻り値の型: HMODULE
公式ドキュメント
指定したモジュールを、呼び出し元プロセスのアドレス空間にロードします。(LoadLibraryExA)
戻り値
関数が成功した場合、戻り値はロードされたモジュールへのハンドルです。
関数が失敗した場合、戻り値は NULL です。拡張エラー情報を取得するには、GetLastError を呼び出してください。
解説(Remarks)
LoadLibraryEx 関数は LoadLibrary 関数に非常によく似ています。違いは、LoadLibraryEx が提供する一連のオプション動作にあります。
- LoadLibraryEx は、DLL の DllMain 関数を呼び出さずに DLL モジュールをロードできます。
- LoadLibraryEx は、モジュールが実行されることがないケースに最適化された方法で、モジュールをデータ ファイルであるかのようにロードできます。
- LoadLibraryEx は、2 つの検索方式のいずれかを使用してモジュールとその関連モジュールを見つけることも、プロセス固有のディレクトリ セットを検索することもできます。
呼び出し元プロセスは、LoadLibraryEx が返したハンドルを使用して、GetProcAddress、FindResource、LoadResource 関数の呼び出しでモジュールを識別できます。
DLL ロード中にローダーが表示するエラー メッセージを有効または無効にするには、SetErrorMode 関数を使用してください。
DllMain から LoadLibraryEx を呼び出すのは安全ではありません。詳細については、DllMain の「解説」セクションを参照してください。
Visual C++: Visual C++ コンパイラは、スレッド ローカル変数を宣言できる構文 _declspec(thread) をサポートしています。この構文を DLL 内で使用すると、Windows Vista より前のバージョンの Windows では LoadLibraryEx を使用してその DLL を明示的にロードできなくなります。DLL を明示的にロードする予定がある場合は、_declspec(thread) の代わりにスレッド ローカル ストレージ関数を使用する必要があります。例については、ダイナミック リンク ライブラリでのスレッド ローカル ストレージの使用を参照してください。
DLL をデータ ファイルまたはイメージ リソースとしてロードする
LOAD_LIBRARY_AS_DATAFILE、LOAD_LIBRARY_AS_DATAFILE_EXCLUSIVE、LOAD_LIBRARY_AS_IMAGE_RESOURCE の各値は、プロセスごとの参照カウントと、指定したモジュールのロードに影響します。これらの値のいずれかが dwFlags パラメーターに指定されると、ローダーはそのモジュールがプロセスによって既に実行可能 DLL としてロードされているかどうかをチェックします。ロードされている場合、それはモジュールが既に呼び出し元プロセスの仮想アドレス空間にマップされていることを意味します。この場合、LoadLibraryEx はその DLL へのハンドルを返し、DLL の参照カウントをインクリメントします。DLL モジュールがまだ DLL としてロードされていなかった場合、システムはそのモジュールを実行可能 DLL としてではなくデータ ファイルまたはイメージ ファイルとしてマップします。この場合、LoadLibraryEx はロードされたデータ ファイルまたはイメージ ファイルへのハンドルを返しますが、そのモジュールの参照カウントはインクリメントせず、CreateToolhelp32Snapshot や EnumProcessModules などの関数からモジュールが見えるようにはしません。同じファイルに対して LOAD_LIBRARY_AS_DATAFILE、LOAD_LIBRARY_AS_DATAFILE_EXCLUSIVE、LOAD_LIBRARY_AS_IMAGE_RESOURCE を指定して LoadLibraryEx を 2 回呼び出すと、そのファイルに対して 2 つの別々のマッピングが作成されます。
LOAD_LIBRARY_AS_IMAGE_RESOURCE 値を使用すると、モジュールはポータブル実行可能ファイル (PE) のセクション アライメント拡張を使用してイメージとしてロードされます。相対仮想アドレス (RVA) をディスク アドレスにマップする必要がないため、モジュールからリソースをより高速に取得できます。LOAD_LIBRARY_AS_IMAGE_RESOURCE を指定すると、ロード中に他のプロセスがそのモジュールを変更できなくなります。
アプリケーションが特定のイメージ マッピング特性に依存していない限り、LOAD_LIBRARY_AS_IMAGE_RESOURCE 値は LOAD_LIBRARY_AS_DATAFILE_EXCLUSIVE または LOAD_LIBRARY_AS_DATAFILE のいずれかと組み合わせて使用してください。これにより、ローダーはモジュールをイメージ リソースとしてロードするかデータ ファイルとしてロードするかを選択でき、システムがページをより効果的に共有できる方を選択します。FindResource などのリソース関数は、どちらのマッピングでも使用できます。
モジュールがどのようにロードされたかを判別するには、次のマクロのいずれかを使用して、LoadLibraryEx が返したハンドルをテストします。
#define LDR_IS_DATAFILE(handle) (((ULONG_PTR)(handle)) & (ULONG_PTR)1)
#define LDR_IS_IMAGEMAPPING(handle) (((ULONG_PTR)(handle)) & (ULONG_PTR)2)
#define LDR_IS_RESOURCE(handle) (LDR_IS_IMAGEMAPPING(handle) || LDR_IS_DATAFILE(handle))
次の表はこれらのマクロを説明しています。
| マクロ | 説明 |
|---|---|
| LDR_IS_DATAFILE(handle) | このマクロが TRUE を返す場合、モジュールはデータ ファイルとしてロードされました (LOAD_LIBRARY_AS_DATAFILE または LOAD_LIBRARY_AS_DATAFILE_EXCLUSIVE)。 |
| LDR_IS_IMAGEMAPPING(handle) | このマクロが TRUE を返す場合、モジュールはイメージ ファイルとしてロードされました (LOAD_LIBRARY_AS_IMAGE_RESOURCE)。 |
| LDR_IS_RESOURCE(handle) | このマクロが TRUE を返す場合、モジュールはデータ ファイルまたはイメージ ファイルのいずれかとしてロードされました。 |
ロードしたモジュールを解放するには、モジュールのロードによって参照カウントがインクリメントされたかどうかに関係なく、FreeLibrary 関数を使用してください。モジュールがデータ ファイルまたはイメージ ファイルとしてロードされた場合、マッピングは破棄されますが参照カウントはデクリメントされません。それ以外の場合は、DLL の参照カウントがデクリメントされます。したがって、LoadLibraryEx が返したどのハンドルに対しても FreeLibrary を呼び出すのは安全です。
DLL と依存関係の検索
検索パスとは、DLL を検索するディレクトリのセットです。LoadLibraryEx 関数は、標準検索パスまたは代替検索パスを使用して DLL を検索できるほか、SetDefaultDllDirectories 関数および AddDllDirectory 関数で確立されたプロセス固有の検索パスを使用することもできます。検索されるディレクトリの一覧とその検索順序については、ダイナミック リンク ライブラリの検索順序を参照してください。LoadLibraryEx 関数は、次の場合に標準検索パスを使用します。
- ファイル名がパスなしで指定され、その基本ファイル名がロード済みモジュールの基本ファイル名と一致せず、いずれの LOAD_LIBRARY_SEARCH フラグも使用されていない場合。
- パスが指定されているが LOAD_WITH_ALTERED_SEARCH_PATH が使用されていない場合。
- アプリケーションが SetDefaultDllDirectories を使用してプロセスの既定の DLL 検索パスを指定していない場合。
lpFileName が相対パスを指定している場合、その相対パス全体が DLL 検索パス内の各トークンに付加されます。他のパスを検索せずに相対パスからモジュールをロードするには、GetFullPathName を使用して非相対パスを取得し、その非相対パスを指定して LoadLibraryEx を呼び出してください。モジュールがデータ ファイルとしてロードされ、相対パスが "." または ".." で始まる場合、その相対パスは絶対パスとして扱われます。
lpFileName が絶対パスを指定し、かつ dwFlags が LOAD_WITH_ALTERED_SEARCH_PATH に設定されている場合、LoadLibraryEx は代替検索パスを使用します。LOAD_WITH_ALTERED_SEARCH_PATH フラグが設定され、かつ lpFileName が相対パスを指定している場合、動作は未定義です。
SetDllDirectory 関数を使用して検索パスを変更できます。この方法は、SetCurrentDirectory を使用したり DLL への完全パスをハードコーディングしたりするよりも優れています。ただし、SetDllDirectory を使用すると、指定したディレクトリが検索パスに含まれている間は安全な DLL 検索モードが実質的に無効になり、またスレッド セーフではない点に注意してください。可能であれば、AddDllDirectory を使用して既定のプロセス検索パスを変更するのが最善です。詳細については、ダイナミック リンク ライブラリの検索順序を参照してください。
アプリケーションは、LOAD_LIBRARY_SEARCH_* フラグを使用することで、単一の LoadLibraryEx 呼び出しに対して検索するディレクトリを指定できます。複数の LOAD_LIBRARY_SEARCH フラグが指定された場合、ディレクトリは次の順序で検索されます。
- DLL を含むディレクトリ (LOAD_LIBRARY_SEARCH_DLL_LOAD_DIR)。このディレクトリは、ロードする DLL の依存関係についてのみ検索されます。
- アプリケーション ディレクトリ (LOAD_LIBRARY_SEARCH_APPLICATION_DIR)。
- AddDllDirectory 関数 (LOAD_LIBRARY_SEARCH_USER_DIRS) または SetDllDirectory 関数を使用してアプリケーション検索パスに明示的に追加されたパス。複数のパスが追加されている場合、それらが検索される順序は不定です。
- System32 ディレクトリ (LOAD_LIBRARY_SEARCH_SYSTEM32)。
Windows 7、Windows Server 2008 R2、Windows Vista および Windows Server 2008: LOAD_LIBRARY_SEARCH_* フラグは、KB2533623 がインストールされているシステムで利用できます。これらのフラグが利用可能かどうかを判別するには、GetProcAddress を使用して AddDllDirectory、RemoveDllDirectory、または SetDefaultDllDirectories 関数のアドレスを取得してください。GetProcAddress が成功した場合、LOAD_LIBRARY_SEARCH_* フラグを LoadLibraryEx で使用できます。
アプリケーションが SetDefaultDllDirectories 関数を使用してプロセスの DLL 検索パスを確立し、かつ LOAD_LIBRARY_SEARCH_* フラグのいずれも使用されていない場合、LoadLibraryEx 関数は標準検索パスの代わりにプロセスの DLL 検索パスを使用します。
パスが指定され、かつアプリケーションに関連付けられたリダイレクト ファイルが存在する場合、LoadLibraryEx 関数はアプリケーション ディレクトリ内でモジュールを検索します。モジュールがアプリケーション ディレクトリ内に存在する場合、LoadLibraryEx はパス指定を無視し、アプリケーション ディレクトリからモジュールをロードします。モジュールがアプリケーション ディレクトリ内に存在しない場合、関数は指定されたディレクトリからモジュールをロードします。詳細については、ダイナミック リンク ライブラリのリダイレクトを参照してください。
パス指定なしでアセンブリ名を指定して LoadLibraryEx を呼び出し、そのアセンブリがシステムの互換マニフェストに記載されている場合、呼び出しは自動的に side-by-side アセンブリにリダイレクトされます。
セキュリティに関する注意
LOAD_LIBRARY_AS_DATAFILE は、ロード中に他のプロセスがモジュールを変更することを防ぎません。これによりアプリケーションの安全性が低下する可能性があるため、モジュールをデータ ファイルとしてロードする際は、LOAD_LIBRARY_AS_DATAFILE を特に使用する必要がある場合を除き、LOAD_LIBRARY_AS_DATAFILE ではなく LOAD_LIBRARY_AS_DATAFILE_EXCLUSIVE を使用してください。LOAD_LIBRARY_AS_DATAFILE_EXCLUSIVE を指定すると、ロード中に他のプロセスがモジュールを変更できなくなります。LOAD_LIBRARY_AS_DATAFILE と LOAD_LIBRARY_AS_DATAFILE_EXCLUSIVE を同じ呼び出しで指定しないでください。後続の LoadLibraryEx 呼び出しのために DLL へのパスを取得する目的で SearchPath 関数を使用しないでください。SearchPath 関数は LoadLibraryEx とは異なる検索順序を使用し、また SetSearchPathMode を BASE_SEARCH_PATH_ENABLE_SAFE_SEARCHMODE で呼び出して明示的に有効にしない限り、安全なプロセス検索モードを使用しません。したがって、SearchPath は指定された DLL についてユーザーの現在の作業ディレクトリを最初に検索する可能性が高くなります。攻撃者が悪意のあるバージョンの DLL を現在の作業ディレクトリにコピーしている場合、SearchPath が取得するパスはその悪意のある DLL を指し、LoadLibraryEx がそれをロードしてしまいます。
DLL を検索する LoadLibraryEx 呼び出しに基づいてオペレーティング システムのバージョンを推測しないでください。アプリケーションが、正当には DLL が存在しないものの悪意のあるバージョンの DLL が検索パス内に存在する環境で実行されている場合、悪意のあるバージョンの DLL がロードされる可能性があります。代わりに、システム バージョンの取得で説明されている推奨される手法を使用してください。
DLL のセキュリティ問題に関する一般的な説明については、ダイナミック リンク ライブラリのセキュリティを参照してください。
例
次のコード例は、LoadLibraryExA の呼び出しを示しています。
//Load the FMAPI DLL
hLib = ::LoadLibraryEx(L"fmapi.dll", NULL, NULL);
if ( !hLib )
{
wprintf(L"Could not load fmapi.dll, Error #%d.\n", GetLastError());
return;
}
その他の例については、エラー コード番号に対応するテキストの参照を参照してください。
libloaderapi.h ヘッダーは LoadLibraryEx を、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして定義しています。エンコード中立のエイリアスの使用と、エンコード中立でないコードを混在させると、コンパイル エラーまたは実行時エラーを引き起こす不一致につながる可能性があります。詳細については、関数プロトタイプの規則を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での呼び出し定義
// KERNEL32.dll (ANSI / -A)
#include <windows.h>
HMODULE LoadLibraryExA(
LPCSTR lpLibFileName,
HANDLE hFile, // optional
LOAD_LIBRARY_FLAGS dwFlags
);[DllImport("KERNEL32.dll", CharSet = CharSet.Ansi, SetLastError = true, ExactSpelling = true)]
static extern IntPtr LoadLibraryExA(
[MarshalAs(UnmanagedType.LPStr)] string lpLibFileName, // LPCSTR
IntPtr hFile, // HANDLE optional
uint dwFlags // LOAD_LIBRARY_FLAGS
);<DllImport("KERNEL32.dll", CharSet:=CharSet.Ansi, SetLastError:=True, ExactSpelling:=True)>
Public Shared Function LoadLibraryExA(
<MarshalAs(UnmanagedType.LPStr)> lpLibFileName As String, ' LPCSTR
hFile As IntPtr, ' HANDLE optional
dwFlags As UInteger ' LOAD_LIBRARY_FLAGS
) As IntPtr
End Function' lpLibFileName : LPCSTR
' hFile : HANDLE optional
' dwFlags : LOAD_LIBRARY_FLAGS
Declare PtrSafe Function LoadLibraryExA Lib "kernel32" ( _
ByVal lpLibFileName As String, _
ByVal hFile As LongPtr, _
ByVal dwFlags As Long) As LongPtr
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
LoadLibraryExA = ctypes.windll.kernel32.LoadLibraryExA
LoadLibraryExA.restype = ctypes.c_void_p
LoadLibraryExA.argtypes = [
wintypes.LPCSTR, # lpLibFileName : LPCSTR
wintypes.HANDLE, # hFile : HANDLE optional
wintypes.DWORD, # dwFlags : LOAD_LIBRARY_FLAGS
]
# GetLastError: use ctypes.GetLastError() (or ctypes.WinDLL(use_last_error=True))require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('KERNEL32.dll')
LoadLibraryExA = Fiddle::Function.new(
lib['LoadLibraryExA'],
[
Fiddle::TYPE_VOIDP, # lpLibFileName : LPCSTR
Fiddle::TYPE_VOIDP, # hFile : HANDLE optional
-Fiddle::TYPE_INT, # dwFlags : LOAD_LIBRARY_FLAGS
],
Fiddle::TYPE_VOIDP)#[link(name = "kernel32")]
extern "system" {
fn LoadLibraryExA(
lpLibFileName: *const u8, // LPCSTR
hFile: *mut core::ffi::c_void, // HANDLE optional
dwFlags: u32 // LOAD_LIBRARY_FLAGS
) -> *mut core::ffi::c_void;
}
// crates: windows-sys provides ready-made bindings for this API.$sig = @"
[DllImport("KERNEL32.dll", CharSet = CharSet.Ansi, SetLastError = true)]
public static extern IntPtr LoadLibraryExA([MarshalAs(UnmanagedType.LPStr)] string lpLibFileName, IntPtr hFile, uint dwFlags);
"@
$api = Add-Type -MemberDefinition $sig -Name 'KERNEL32_LoadLibraryExA' -Namespace Win32 -PassThru
# $api::LoadLibraryExA(lpLibFileName, hFile, dwFlags)#uselib "KERNEL32.dll"
#func global LoadLibraryExA "LoadLibraryExA" sptr, sptr, sptr
; LoadLibraryExA lpLibFileName, hFile, dwFlags ; 戻り値は stat
; lpLibFileName : LPCSTR -> "sptr"
; hFile : HANDLE optional -> "sptr"
; dwFlags : LOAD_LIBRARY_FLAGS -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。#uselib "KERNEL32.dll"
#cfunc global LoadLibraryExA "LoadLibraryExA" str, sptr, int
; res = LoadLibraryExA(lpLibFileName, hFile, dwFlags)
; lpLibFileName : LPCSTR -> "str"
; hFile : HANDLE optional -> "sptr"
; dwFlags : LOAD_LIBRARY_FLAGS -> "int"; HMODULE LoadLibraryExA(LPCSTR lpLibFileName, HANDLE hFile, LOAD_LIBRARY_FLAGS dwFlags)
#uselib "KERNEL32.dll"
#cfunc global LoadLibraryExA "LoadLibraryExA" str, intptr, int
; res = LoadLibraryExA(lpLibFileName, hFile, dwFlags)
; lpLibFileName : LPCSTR -> "str"
; hFile : HANDLE optional -> "intptr"
; dwFlags : LOAD_LIBRARY_FLAGS -> "int"import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
kernel32 = windows.NewLazySystemDLL("KERNEL32.dll")
procLoadLibraryExA = kernel32.NewProc("LoadLibraryExA")
)
// lpLibFileName (LPCSTR), hFile (HANDLE optional), dwFlags (LOAD_LIBRARY_FLAGS)
r1, _, err := procLoadLibraryExA.Call(
uintptr(unsafe.Pointer(windows.BytePtrFromString(lpLibFileName))),
uintptr(hFile),
uintptr(dwFlags),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // HMODULEfunction LoadLibraryExA(
lpLibFileName: PAnsiChar; // LPCSTR
hFile: THandle; // HANDLE optional
dwFlags: DWORD // LOAD_LIBRARY_FLAGS
): THandle; stdcall;
external 'KERNEL32.dll' name 'LoadLibraryExA';result := DllCall("KERNEL32\LoadLibraryExA"
, "AStr", lpLibFileName ; LPCSTR
, "Ptr", hFile ; HANDLE optional
, "UInt", dwFlags ; LOAD_LIBRARY_FLAGS
, "Ptr") ; return: HMODULE●LoadLibraryExA(lpLibFileName, hFile, dwFlags) = DLL("KERNEL32.dll", "void* LoadLibraryExA(char*, void*, dword)")
# 呼び出し: LoadLibraryExA(lpLibFileName, hFile, dwFlags)
# lpLibFileName : LPCSTR -> "char*"
# hFile : HANDLE optional -> "void*"
# dwFlags : LOAD_LIBRARY_FLAGS -> "dword"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。const std = @import("std");
extern "kernel32" fn LoadLibraryExA(
lpLibFileName: [*c]const u8, // LPCSTR
hFile: ?*anyopaque, // HANDLE optional
dwFlags: u32 // LOAD_LIBRARY_FLAGS
) callconv(std.os.windows.WINAPI) ?*anyopaque;proc LoadLibraryExA(
lpLibFileName: cstring, # LPCSTR
hFile: pointer, # HANDLE optional
dwFlags: uint32 # LOAD_LIBRARY_FLAGS
): pointer {.importc: "LoadLibraryExA", stdcall, dynlib: "KERNEL32.dll".}pragma(lib, "kernel32");
extern(Windows)
void* LoadLibraryExA(
const(char)* lpLibFileName, // LPCSTR
void* hFile, // HANDLE optional
uint dwFlags // LOAD_LIBRARY_FLAGS
);ccall((:LoadLibraryExA, "KERNEL32.dll"), stdcall, Ptr{Cvoid},
(Cstring, Ptr{Cvoid}, UInt32),
lpLibFileName, hFile, dwFlags)
# lpLibFileName : LPCSTR -> Cstring
# hFile : HANDLE optional -> Ptr{Cvoid}
# dwFlags : LOAD_LIBRARY_FLAGS -> UInt32
# stdcall は 32bit のみ意味を持つ(x64 では無視)。local ffi = require("ffi")
ffi.cdef[[
void* LoadLibraryExA(
const char* lpLibFileName,
void* hFile,
uint32_t dwFlags);
]]
local kernel32 = ffi.load("kernel32")
-- kernel32.LoadLibraryExA(lpLibFileName, hFile, dwFlags)
-- lpLibFileName : LPCSTR
-- hFile : HANDLE optional
-- dwFlags : LOAD_LIBRARY_FLAGS
-- 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。const koffi = require('koffi');
const lib = koffi.load('KERNEL32.dll');
const LoadLibraryExA = lib.func('__stdcall', 'LoadLibraryExA', 'void *', ['str', 'void *', 'uint32_t']);
// LoadLibraryExA(lpLibFileName, hFile, dwFlags)
// lpLibFileName : LPCSTR -> 'str'
// hFile : HANDLE optional -> 'void *'
// dwFlags : LOAD_LIBRARY_FLAGS -> 'uint32_t'
// 出力ポインタは koffi.out(...) で包む。構造体は koffi.struct で定義。const lib = Deno.dlopen("KERNEL32.dll", {
LoadLibraryExA: { parameters: ["buffer", "pointer", "u32"], result: "pointer" },
});
// lib.symbols.LoadLibraryExA(lpLibFileName, hFile, dwFlags)
// lpLibFileName : LPCSTR -> "buffer"
// hFile : HANDLE optional -> "pointer"
// dwFlags : LOAD_LIBRARY_FLAGS -> "u32"
// 文字列は "buffer"。ANSI(-A) は new TextEncoder() で UTF-8/ANSI バイト列(末尾に \x00)を渡す。
// 値渡し構造体は { struct: [ ...field types... ] } を使用。<?php
$ffi = FFI::cdef(<<<C
void* LoadLibraryExA(
const char* lpLibFileName,
void* hFile,
uint32_t dwFlags);
C, "KERNEL32.dll");
// $ffi->LoadLibraryExA(lpLibFileName, hFile, dwFlags);
// lpLibFileName : LPCSTR
// hFile : HANDLE optional
// dwFlags : LOAD_LIBRARY_FLAGS
// 構造体/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, W32APIOptions.ASCII_OPTIONS);
Pointer LoadLibraryExA(
String lpLibFileName, // LPCSTR
Pointer hFile, // HANDLE optional
int dwFlags // LOAD_LIBRARY_FLAGS
);
}@[Link("kernel32")]
lib LibKERNEL32
fun LoadLibraryExA = LoadLibraryExA(
lpLibFileName : UInt8*, # LPCSTR
hFile : Void*, # HANDLE optional
dwFlags : UInt32 # LOAD_LIBRARY_FLAGS
) : Void*
end
# 構造体/GUID/enum は lib 内に対応する型定義が必要。
# 呼出規約: x64 は規約統一のため OK。x86(32bit)は WINAPI=stdcall だが Crystal の fun に stdcall 付与構文がなく非対応。import 'dart:ffi';
import 'package:ffi/ffi.dart';
typedef LoadLibraryExANative = Pointer<Void> Function(Pointer<Utf8>, Pointer<Void>, Uint32);
typedef LoadLibraryExADart = Pointer<Void> Function(Pointer<Utf8>, Pointer<Void>, int);
final LoadLibraryExA = DynamicLibrary.open('KERNEL32.dll')
.lookupFunction<LoadLibraryExANative, LoadLibraryExADart>('LoadLibraryExA');
// lpLibFileName : LPCSTR -> Pointer<Utf8>
// hFile : HANDLE optional -> Pointer<Void>
// dwFlags : LOAD_LIBRARY_FLAGS -> Uint32
// 文字列は package:ffi の "...".toNativeUtf16()/toNativeUtf8() で変換。{$mode objfpc}{$H+}
function LoadLibraryExA(
lpLibFileName: PAnsiChar; // LPCSTR
hFile: THandle; // HANDLE optional
dwFlags: DWORD // LOAD_LIBRARY_FLAGS
): THandle; stdcall;
external 'KERNEL32.dll' name 'LoadLibraryExA';import Foreign
import Foreign.C.Types
import Foreign.C.String
foreign import stdcall safe "LoadLibraryExA"
c_LoadLibraryExA :: CString -> Ptr () -> Word32 -> IO (Ptr ())
-- lpLibFileName : LPCSTR -> CString
-- hFile : HANDLE optional -> Ptr ()
-- dwFlags : LOAD_LIBRARY_FLAGS -> Word32
-- 要 GHC(Windows)。stdcall は x64 では ccall として扱われる。ブロックする API は safe 呼び出し推奨。open Ctypes
open Foreign
let loadlibraryexa =
foreign "LoadLibraryExA"
(string @-> (ptr void) @-> uint32_t @-> returning (ptr void))
(* lpLibFileName : LPCSTR -> string *)
(* hFile : HANDLE optional -> (ptr void) *)
(* dwFlags : LOAD_LIBRARY_FLAGS -> uint32_t *)
(* foreign は cdecl 前提。x64 Windows では WINAPI と一致。構造体は ctypes structure を定義のこと。 *)(cffi:define-foreign-library kernel32 (t "KERNEL32.dll"))
(cffi:use-foreign-library kernel32)
(cffi:defcfun ("LoadLibraryExA" load-library-ex-a :convention :stdcall) :pointer
(lp-lib-file-name :string) ; LPCSTR
(h-file :pointer) ; HANDLE optional
(dw-flags :uint32)) ; LOAD_LIBRARY_FLAGS
; isize/usize(INT_PTR/SIZE_T)は x64 前提で :int64/:uint64。x86 では :int32/:uint32。use Win32::API;
my $LoadLibraryExA = Win32::API::More->new('KERNEL32',
'HANDLE LoadLibraryExA(LPCSTR lpLibFileName, HANDLE hFile, DWORD dwFlags)');
# my $ret = $LoadLibraryExA->Call($lpLibFileName, $hFile, $dwFlags);
# lpLibFileName : LPCSTR -> LPCSTR
# hFile : HANDLE optional -> HANDLE
# dwFlags : LOAD_LIBRARY_FLAGS -> DWORD
# 値渡し構造体は pack() した文字列、または Win32::API::Struct を使用。関連項目
- f LoadLibraryExW (Unicode版) — フラグ指定でDLLをUnicodeパスから読み込む。
- f LoadLibraryA — 指定DLLをANSIパスで読み込みハンドルを返す。
- f FindResourceA — モジュール内のリソースをANSI名で検索する。
- f FreeLibrary — ロードしたDLLモジュールを解放する。
- f GetProcAddress — DLLからエクスポート関数のアドレスを取得する。
- f GetSystemDirectoryA — Windowsシステムディレクトリのパスを取得する(ANSI版)。
- f GetWindowsDirectoryA — Windowsディレクトリのパスを取得する(ANSI版)。
- f LoadResource — リソースをメモリへ読み込みハンドルを取得する。
- f OpenFile — ファイルを作成・開く・存在確認する古いファイル操作関数。
- f SearchPathA — 指定パスから条件に合うファイルを検索しフルパスを取得する(ANSI版)。
- f SetDllDirectoryA — DLL検索ディレクトリをANSIパスで設定する。
- f SetErrorMode — 重大エラー時のシステム既定処理を制御するエラーモードを設定する。