GetDllDirectoryW

アプリケーションが DLL を見つけるために使う検索パスのアプリケーション固有部分を取得する。(Unicode)

GetDllDirectoryW nBufferLength, lpBuffer

nBufferLength : [int] 出力バッファのサイズ。文字数で指定する。
lpBuffer : [wstr] 検索パスのアプリケーション固有部分を受け取るバッファへのポインタ。

(プラグイン / モジュール : kernel32.dll)

解説

アプリケーションが DLL を見つけるために使う検索パスのアプリケーション固有部分を取得する。(Unicode)

[戻り値]
関数が成功した場合、戻り値は lpBuffer にコピーされた文字列の長さ(文字数)であり、終端 NULL 文字は含まない。戻り値が
nBufferLength より大きい場合、それはパスに必要なバッファサイズを示す。関数が失敗した場合、戻り値は 0
である。拡張エラー情報を取得するには GetLastError を呼ぶ。

[備考]
この関数を使うアプリケーションをコンパイルするには、_WIN32_WINNT を 0x0502 以降として定義する。詳細は Using
the Windows Headers を参照。
> [!NOTE] > winbase.h ヘッダでは GetDllDirectory が、UNICODE
プリプロセッサ定数の定義に応じて自動的に ANSI 版または Unicode
版を選択するエイリアスとして定義されている。エンコーディング中立のエイリアスを中立でないコードと混在させるとコンパイルや実行時のエラーになる可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照。

情報

プラグイン / モジュールkernel32.dll
バージョン1.0
作成日2026/04/16
著作者IronHSP / CsWin32 bridge
URLhttps://github.com/inovia/IronHSP
備考Win32 API の kernel32.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。
タイプ拡張命令
グループWin32API
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\win32_kernel32_gen2.hs