PrivateExtractIconsW

指定ファイルから抽出したアイコンのハンドル配列を作成する。(Unicode)

PrivateExtractIconsW szFileName, nIconIndex, cxIcon, cyIcon, phicon, piconid, nIcons, flags

szFileName : [wstr] 型: LPCTSTR アイコンを抽出するファイルのパスと名前。
nIconIndex : [int] 型: int 抽出する最初のアイコンの 0 ベースのインデックス。
cxIcon : [int] 型: int 希望する水平アイコンサイズ。
cyIcon : [int] 型: int 希望する垂直アイコンサイズ。
phicon : [intptr] 型: HICON* 返されるアイコンハンドル配列へのポインタ。
piconid : [var] 型: UINT* 現在のディスプレイデバイスに最適なアイコンの返されるリソース識別子へのポインタ。
nIcons : [int] 型: UINT ファイルから抽出するアイコン数。.exe および .dll からの抽出時のみ有効。
flags : [int] 型: UINT この関数を制御するフラグ。LoadImage 関数で使用される LR_* フラグ。

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

解説

指定ファイルから抽出したアイコンのハンドル配列を作成する。(Unicode)

[戻り値]
型: UINT phicon が NULL で関数が成功した場合、戻り値はファイル内のアイコン数。関数が失敗した場合、戻り値は
0。phicon が非 NULL で成功した場合、戻り値は抽出されたアイコン数。ファイルが見つからない場合は 0xFFFFFFFF。

[備考]
この関数は実行ファイル (.exe)、DLL (.dll)、アイコン (.ico)、カーソル (.cur)、アニメーションカーソル
(.ani)、ビットマップ (.bmp) ファイルから抽出する。Windows 3.x の 16
ビット実行ファイルからの抽出もサポートされる。

情報

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