LoadResource

メモリ内の指定リソースの先頭バイトへのポインタを取得するために使用できるハンドルを取得する。

LoadResource hModule, hResInfo

hModule : [intptr] 型: HMODULE リソースを含む実行可能ファイルのモジュールのハンドル。hModule が NULL の場合、システムは現在のプロセスの作成に使用されたモジュールからリソースを読み込む。
hResInfo : [intptr] 型: HRSRC 読み込むリソースのハンドル。このハンドルは FindResource または FindResourceEx 関数によって返される。

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

解説

メモリ内の指定リソースの先頭バイトへのポインタを取得するために使用できるハンドルを取得する。

[戻り値]
型: HGLOBAL 関数が成功した場合、戻り値はリソースに関連付けられたデータのハンドルである。関数が失敗した場合、戻り値は NULL
である。拡張エラー情報を取得するには GetLastError を呼ぶ。

[備考]
LoadResource の戻り値の型が HGLOBAL
なのは下位互換性のためであり、関数がグローバルメモリブロックのハンドルを返すからではない。このハンドルを GlobalLockGlobalFree 関数に渡してはならない。リソースデータの先頭バイトへのポインタを得るには LockResource
関数を呼び、リソースのサイズを得るには SizeofResource
を呼ぶ。[GlobalSize](/windows/desktop/api/winbase/nf-winbase-globalsize)
はリソースの HGLOBAL に対して 0 を返す。結果として、HGLOBAL のサイズ判定に GlobalSize を用いる API
は正しく動作しない。例えば
[CreateStreamOnHGlobal](/windows/win32/api/combaseapi/nf-combaseapi-createstreamonhglobal)
の代わりに
[SHCreateMemStream](/windows/win32/api/shlwapi/nf-shlwapi-shcreatememstream)
を使う。リソースを直ちに使用するには、アプリケーションは次のリソース別関数を用いて一度の呼び出しでリソースの検索と読み込みを行うべきである。
(以下省略)

情報

プラグイン / モジュール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