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

LoadLibraryExA

関数
フラグ指定でDLLをANSIパスから読み込む。
DLLKERNEL32.dll文字セットANSI (-A)呼出規約winapiSetLastErrorあり対応OSWindows XP 以降

シグネチャ

// KERNEL32.dll  (ANSI / -A)
#include <windows.h>

HMODULE LoadLibraryExA(
    LPCSTR lpLibFileName,
    HANDLE hFile,   // optional
    LOAD_LIBRARY_FLAGS dwFlags
);

パラメーター

名前方向説明
lpLibFileNameLPCSTRin

ロードするモジュールのファイル名を指定する文字列です。この名前は、モジュール定義ファイル (.def) 内の LIBRARY キーワードで指定される、ライブラリ モジュール自身に格納された名前とは関係ありません。

モジュールには、ライブラリ モジュール (.dll ファイル) または実行可能モジュール (.exe ファイル) を指定できます。指定したモジュールが実行可能モジュールの場合、静的インポートはロードされず、代わりに DONT_RESOLVE_DLL_REFERENCES が指定された場合と同様にロードされます。詳細については dwFlags パラメーターを参照してください。

文字列でパスを伴わないモジュール名を指定し、ファイル名拡張子を省略した場合、この関数はモジュール名に既定のライブラリ拡張子 ".DLL" を付加します。".DLL" の付加を防ぐには、モジュール名文字列の末尾にピリオド文字 (.) を含めます。

文字列で完全修飾パスを指定した場合、この関数はそのパスのみでモジュールを検索します。パスを指定する際は、スラッシュ (/) ではなくバックスラッシュ (\) を使用してください。パスの詳細については、ファイル、パス、名前空間の名前付けを参照してください。

文字列でパスを伴わないモジュール名を指定し、同じ基本名と拡張子を持つモジュールが複数ロードされている場合、この関数は最初にロードされたモジュールのハンドルを返します。

文字列でパスを伴わないモジュール名を指定し、同じ名前のモジュールがまだロードされていない場合、または相対パス付きのモジュール名を指定した場合、この関数は指定したモジュールを検索します。また、指定したモジュールのロードによってシステムが他の関連モジュールをロードする場合 (つまりモジュールに依存関係がある場合)、それらのモジュールも検索します。検索されるディレクトリとその検索順序は、指定したパスと dwFlags パラメーターによって異なります。詳細については「解説」を参照してください。

この関数がモジュールまたはその依存関係のいずれかを見つけられない場合、関数は失敗します。

hFileHANDLEoptionalこのパラメーターは将来の使用のために予約されています。NULL でなければなりません。
dwFlagsLOAD_LIBRARY_FLAGSin

モジュールのロード時に実行するアクションです。フラグを指定しない場合、この関数の動作は LoadLibrary 関数と同一になります。このパラメーターには、次の値のいずれかを指定できます。

意味
DONT_RESOLVE_DLL_REFERENCES
0x00000001
この値を使用し、かつ実行可能モジュールが DLL である場合、システムはプロセスおよびスレッドの初期化と終了に対して DllMain を呼び出しません。また、指定したモジュールが参照する追加の実行可能モジュールもロードしません。
この値は使用しないでください。下位互換性のためにのみ提供されています。DLL 内のデータまたはリソースのみにアクセスする予定がある場合は、LOAD_LIBRARY_AS_DATAFILE_EXCLUSIVE または LOAD_LIBRARY_AS_IMAGE_RESOURCE、あるいはその両方を使用してください。それ以外の場合は、LoadLibrary 関数を使用してライブラリを DLL または実行可能モジュールとしてロードしてください。
LOAD_IGNORE_CODE_AUTHZ_LEVEL
0x00000010
この値を使用すると、システムは DLL に対して AppLocker ルールをチェックせず、ソフトウェアの制限ポリシーも適用しません。このアクションはロードされる DLL のみに適用され、その依存関係には適用されません。この値は、インストール中に抽出した DLL を実行する必要があるセットアップ プログラムでの使用が推奨されます。

Windows Server 2008 R2 および Windows 7: KB2532445 がインストールされているシステムでは、呼び出し元は "LocalSystem" または "TrustedInstaller" として実行されている必要があります。そうでない場合、システムはこのフラグを無視します。詳細については、ヘルプとサポートのナレッジ ベース内の「You can circumvent AppLocker rules by using an Office macro on a computer that is running Windows 7 or Windows Server 2008 R2」(https://support.microsoft.com/kb/2532445) を参照してください。

Windows Server 2008、Windows Vista、Windows Server 2003 および Windows XP: AppLocker は Windows 7 および Windows Server 2008 R2 で導入されました。

LOAD_LIBRARY_AS_DATAFILE
0x00000002
この値を使用すると、システムはファイルをデータ ファイルであるかのように呼び出し元プロセスの仮想アドレス空間にマップします。マップされたファイルの実行や実行準備は一切行われません。したがって、この DLL に対して GetModuleFileNameGetModuleHandleGetProcAddress などの関数を呼び出すことはできません。この値を使用すると、読み取り専用メモリへの書き込みはアクセス違反を発生させます。DLL からメッセージまたはリソースを抽出する目的のみで DLL をロードする場合に、このフラグを使用してください。

この値は LOAD_LIBRARY_AS_IMAGE_RESOURCE と組み合わせて使用できます。詳細については「解説」を参照してください。

LOAD_LIBRARY_AS_DATAFILE_EXCLUSIVE
0x00000040
LOAD_LIBRARY_AS_DATAFILE に似ていますが、DLL ファイルが呼び出し元プロセスに対して排他的書き込みアクセスで開かれる点が異なります。使用中、他のプロセスはその DLL ファイルを書き込みアクセスで開くことはできません。ただし、他のプロセスがその DLL を開くこと自体は可能です。

この値は LOAD_LIBRARY_AS_IMAGE_RESOURCE と組み合わせて使用できます。詳細については「解説」を参照してください。

Windows Server 2003 および Windows XP: この値は Windows Vista までサポートされていません。

LOAD_LIBRARY_AS_IMAGE_RESOURCE
0x00000020
この値を使用すると、システムはファイルをイメージ ファイルとしてプロセスの仮想アドレス空間にマップします。ただし、ローダーは静的インポートのロードやその他の通常の初期化手順を実行しません。DLL からメッセージまたはリソースを抽出する目的のみで DLL をロードする場合に、このフラグを使用してください。

アプリケーションがファイルのインメモリ レイアウトがイメージであることに依存していない限り、この値は LOAD_LIBRARY_AS_DATAFILE_EXCLUSIVE または LOAD_LIBRARY_AS_DATAFILE のいずれかと組み合わせて使用してください。詳細については「解説」セクションを参照してください。

Windows Server 2003 および Windows XP: この値は Windows Vista までサポートされていません。

LOAD_LIBRARY_SEARCH_APPLICATION_DIR
0x00000200
この値を使用すると、DLL とその依存関係についてアプリケーションのインストール ディレクトリが検索されます。標準検索パス内のディレクトリは検索されません。この値は LOAD_WITH_ALTERED_SEARCH_PATH と組み合わせることはできません。

Windows 7、Windows Server 2008 R2、Windows Vista および Windows Server 2008: この値には KB2533623 のインストールが必要です。

Windows Server 2003 および Windows XP: この値はサポートされていません。

LOAD_LIBRARY_SEARCH_DEFAULT_DIRS
0x00001000
この値は LOAD_LIBRARY_SEARCH_APPLICATION_DIRLOAD_LIBRARY_SEARCH_SYSTEM32LOAD_LIBRARY_SEARCH_USER_DIRS の組み合わせです。標準検索パス内のディレクトリは検索されません。この値は LOAD_WITH_ALTERED_SEARCH_PATH と組み合わせることはできません。

この値は、アプリケーションが DLL 検索パスに含めるべきディレクトリの推奨最大数を表します。

Windows 7、Windows Server 2008 R2、Windows Vista および Windows Server 2008: この値には KB2533623 のインストールが必要です。

Windows Server 2003 および Windows XP: この値はサポートされていません。

LOAD_LIBRARY_SEARCH_DLL_LOAD_DIR
0x00000100
この値を使用すると、DLL を含むディレクトリが、その DLL の依存関係を検索するディレクトリ一覧の先頭に一時的に追加されます。標準検索パス内のディレクトリは検索されません。

lpFileName パラメーターには完全修飾パスを指定する必要があります。この値は LOAD_WITH_ALTERED_SEARCH_PATH と組み合わせることはできません。

たとえば、Lib2.dll が C:\Dir1\Lib1.dll の依存関係である場合、この値を指定して Lib1.dll をロードすると、システムは C:\Dir1 内でのみ Lib2.dll を検索します。C:\Dir1 と DLL 検索パス内のすべてのディレクトリで Lib2.dll を検索するには、この値を LOAD_LIBRARY_SEARCH_DEFAULT_DIRS と組み合わせてください。

Windows 7、Windows Server 2008 R2、Windows Vista および Windows Server 2008: この値には KB2533623 のインストールが必要です。

Windows Server 2003 および Windows XP: この値はサポートされていません。

LOAD_LIBRARY_SEARCH_SYSTEM32
0x00000800
この値を使用すると、DLL とその依存関係について %windows%\system32 が検索されます。標準検索パス内のディレクトリは検索されません。この値は LOAD_WITH_ALTERED_SEARCH_PATH と組み合わせることはできません。

Windows 7、Windows Server 2008 R2、Windows Vista および Windows Server 2008: この値には KB2533623 のインストールが必要です。

Windows Server 2003 および Windows XP: この値はサポートされていません。

LOAD_LIBRARY_SEARCH_USER_DIRS
0x00000400
この値を使用すると、AddDllDirectory 関数または SetDllDirectory 関数を使用して追加されたディレクトリが、DLL とその依存関係について検索されます。複数のディレクトリが追加されている場合、それらが検索される順序は不定です。標準検索パス内のディレクトリは検索されません。この値は LOAD_WITH_ALTERED_SEARCH_PATH と組み合わせることはできません。

Windows 7、Windows Server 2008 R2、Windows Vista および Windows Server 2008: この値には KB2533623 のインストールが必要です。

Windows Server 2003 および Windows XP: この値はサポートされていません。

LOAD_WITH_ALTERED_SEARCH_PATH
0x00000008
この値を使用し、かつ lpFileName が絶対パスを指定している場合、システムは、指定したモジュールがロードを引き起こす関連実行可能モジュールを見つけるために、「解説」セクションで説明する代替ファイル検索方式を使用します。この値を使用し、かつ lpFileName が相対パスを指定している場合、動作は未定義です。

この値を使用しない場合、または lpFileName がパスを指定していない場合、システムは、指定したモジュールがロードを引き起こす関連実行可能モジュールを見つけるために、「解説」セクションで説明する標準検索方式を使用します。

この値はいかなる LOAD_LIBRARY_SEARCH フラグとも組み合わせることはできません。

LOAD_LIBRARY_REQUIRE_SIGNED_TARGET
0x00000080
ロード時にバイナリ イメージのデジタル署名をチェックする必要があることを指定します。

この値には Windows 8.1、Windows 10 以降が必要です。

LOAD_LIBRARY_SAFE_CURRENT_DIRS
0x00002000
この値を使用すると、現在のディレクトリから実行用に DLL をロードできるのは、それが安全なロード一覧 (Safe load list) 内のディレクトリの配下にある場合に限られます。

戻り値の型: HMODULE

公式ドキュメント

指定したモジュールを、呼び出し元プロセスのアドレス空間にロードします。(LoadLibraryExA)

戻り値

関数が成功した場合、戻り値はロードされたモジュールへのハンドルです。

関数が失敗した場合、戻り値は NULL です。拡張エラー情報を取得するには、GetLastError を呼び出してください。

解説(Remarks)

LoadLibraryEx 関数は LoadLibrary 関数に非常によく似ています。違いは、LoadLibraryEx が提供する一連のオプション動作にあります。

これらのオプション動作は dwFlags パラメーターを設定して選択します。dwFlags がゼロの場合、LoadLibraryExLoadLibrary と同一の動作をします。

呼び出し元プロセスは、LoadLibraryEx が返したハンドルを使用して、GetProcAddressFindResourceLoadResource 関数の呼び出しでモジュールを識別できます。

DLL ロード中にローダーが表示するエラー メッセージを有効または無効にするには、SetErrorMode 関数を使用してください。

DllMain から LoadLibraryEx を呼び出すのは安全ではありません。詳細については、DllMain の「解説」セクションを参照してください。

Visual C++: Visual C++ コンパイラは、スレッド ローカル変数を宣言できる構文 _declspec(thread) をサポートしています。この構文を DLL 内で使用すると、Windows Vista より前のバージョンの Windows では LoadLibraryEx を使用してその DLL を明示的にロードできなくなります。DLL を明示的にロードする予定がある場合は、_declspec(thread) の代わりにスレッド ローカル ストレージ関数を使用する必要があります。例については、ダイナミック リンク ライブラリでのスレッド ローカル ストレージの使用を参照してください。

DLL をデータ ファイルまたはイメージ リソースとしてロードする

LOAD_LIBRARY_AS_DATAFILELOAD_LIBRARY_AS_DATAFILE_EXCLUSIVELOAD_LIBRARY_AS_IMAGE_RESOURCE の各値は、プロセスごとの参照カウントと、指定したモジュールのロードに影響します。これらの値のいずれかが dwFlags パラメーターに指定されると、ローダーはそのモジュールがプロセスによって既に実行可能 DLL としてロードされているかどうかをチェックします。ロードされている場合、それはモジュールが既に呼び出し元プロセスの仮想アドレス空間にマップされていることを意味します。この場合、LoadLibraryEx はその DLL へのハンドルを返し、DLL の参照カウントをインクリメントします。DLL モジュールがまだ DLL としてロードされていなかった場合、システムはそのモジュールを実行可能 DLL としてではなくデータ ファイルまたはイメージ ファイルとしてマップします。この場合、LoadLibraryEx はロードされたデータ ファイルまたはイメージ ファイルへのハンドルを返しますが、そのモジュールの参照カウントはインクリメントせず、CreateToolhelp32SnapshotEnumProcessModules などの関数からモジュールが見えるようにはしません。

同じファイルに対して LOAD_LIBRARY_AS_DATAFILELOAD_LIBRARY_AS_DATAFILE_EXCLUSIVELOAD_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 関数は、次の場合に標準検索パスを使用します。

lpFileName が相対パスを指定している場合、その相対パス全体が DLL 検索パス内の各トークンに付加されます。他のパスを検索せずに相対パスからモジュールをロードするには、GetFullPathName を使用して非相対パスを取得し、その非相対パスを指定して LoadLibraryEx を呼び出してください。モジュールがデータ ファイルとしてロードされ、相対パスが "." または ".." で始まる場合、その相対パスは絶対パスとして扱われます。

lpFileName が絶対パスを指定し、かつ dwFlagsLOAD_WITH_ALTERED_SEARCH_PATH に設定されている場合、LoadLibraryEx は代替検索パスを使用します。LOAD_WITH_ALTERED_SEARCH_PATH フラグが設定され、かつ lpFileName が相対パスを指定している場合、動作は未定義です。

SetDllDirectory 関数を使用して検索パスを変更できます。この方法は、SetCurrentDirectory を使用したり DLL への完全パスをハードコーディングしたりするよりも優れています。ただし、SetDllDirectory を使用すると、指定したディレクトリが検索パスに含まれている間は安全な DLL 検索モードが実質的に無効になり、またスレッド セーフではない点に注意してください。可能であれば、AddDllDirectory を使用して既定のプロセス検索パスを変更するのが最善です。詳細については、ダイナミック リンク ライブラリの検索順序を参照してください。

アプリケーションは、LOAD_LIBRARY_SEARCH_* フラグを使用することで、単一の LoadLibraryEx 呼び出しに対して検索するディレクトリを指定できます。複数の LOAD_LIBRARY_SEARCH フラグが指定された場合、ディレクトリは次の順序で検索されます。

Windows 7、Windows Server 2008 R2、Windows Vista および Windows Server 2008: LOAD_LIBRARY_SEARCH_* フラグは、KB2533623 がインストールされているシステムで利用できます。これらのフラグが利用可能かどうかを判別するには、GetProcAddress を使用して AddDllDirectoryRemoveDllDirectory、または 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_DATAFILELOAD_LIBRARY_AS_DATAFILE_EXCLUSIVE を同じ呼び出しで指定しないでください。

後続の LoadLibraryEx 呼び出しのために DLL へのパスを取得する目的で SearchPath 関数を使用しないでください。SearchPath 関数は LoadLibraryEx とは異なる検索順序を使用し、また SetSearchPathModeBASE_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 の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
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   // HMODULE
function 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 を使用。

関連項目

文字セット違い
類似 API
公式の関連項目
使用する型