LoadStringW

指定モジュールに関連付けられた実行ファイルから文字列リソースを読み込み、バッファにコピーし、終端 null 文字を付加する。(Unicode)

LoadStringW hInstance, uID, lpBuffer, cchBufferMax

hInstance : [intptr] 型: HINSTANCE 文字列リソースを実行ファイルに含むモジュールのインスタンスへのハンドル。アプリケーション自身へのハンドルを得るには GetModuleHandle を NULL で呼ぶ。
uID : [int] 型: UINT 読み込む文字列の識別子。
lpBuffer : [wstr] 型: LPTSTR 文字列を受け取るバッファ(cchBufferMax が非ゼロの場合)、または文字列リソース自体への読み取り専用ポインタ(cchBufferMax が 0 の場合)。ポインタを保持するのに十分な長さ(8 バイト)が必要。
cchBufferMax : [int] 型: int バッファのサイズ(文字単位)。文字列が指定文字数より長い場合は切り詰められ null 終端される。0 の場合、lpBuffer は文字列リソース自体への読み取り専用ポインタを受け取る。

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

解説

指定モジュールに関連付けられた実行ファイルから文字列リソースを読み込み、バッファにコピーし、終端 null
文字を付加する。(Unicode)

[戻り値]
型: int 関数が成功した場合、戻り値は次のいずれか: バッファにコピーされた文字数(cchBufferMax が非ゼロの場合、終端
null 文字を含まない)。lpBuffer が指す文字列リソースの文字数(cchBufferMax が 0
の場合)。文字列リソースが存在しない場合は 0。拡張エラー情報を取得するには GetLastError を呼ぶ。

[備考]
cchBufferMax に 0
を渡して文字列リソースへの読み取り専用ポインタを返す場合、文字列リソースの長さを判定するには戻り値の文字数を使用する。文字列リソースはモジュールのリソーステーブル内で
null 終端されていることが保証されない。

情報

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