SHGetImageList 函式 (shellapi.h)
擷取影像清單。
語法
SHSTDAPI SHGetImageList(
[in] int iImageList,
[in] REFIID riid,
[out] void **ppvObj
);
參數
[in] iImageList
類型： int
清單中所包含的映射類型。 下列其中一個值：
SHIL_LARGE (0x0)
0x0。 影像大小通常是 32x32 圖元。 不過，如果已從 [顯示內容] 中 [外觀] 索引標籤的 [效果] 區段選取 [使用大型圖示] 選項，則影像為 48x48 圖元。
SHIL_SMALL (0x1)
0x1。 這些影像是殼層標準小型圖示大小 16x16，但可由使用者自訂大小。
SHIL_EXTRALARGE (0x2)
0x2。 這些影像是殼層標準超大型圖示大小。 這通常是 48x48，但大小可由使用者自訂。
SHIL_SYSSMALL (0x3)
0x3。 這些映射是由呼叫的 GetSystemMetrics所指定的大小，並以 SM_CXSMICON和以SM_CYSMICON呼叫的 GetSystemMetrics。
SHIL_JUMBO (0x4)
0x4。 Windows Vista 和更新版本。 影像通常是 256x256 圖元。
SHIL_LAST
驗證用途的最大有效旗標值。
[in] riid
類型： REFIID
映射清單介面識別碼的參考，通常IID_IImageList。
[out] ppvObj
類型： void**
當這個方法傳回時，包含 riid中要求的介面指標。 這通常是 IImageList。
傳回值
類型： HRESULT
如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。
備註
IImageList指標類型，例如在 ppv參數中傳回的指標類型，可以視需要轉換成HIMAGELIST;例如，用於清單檢視。 相反地， HIMAGELIST 可以轉換成 IImageList的指標。
從 Windows Vista 起， 如果進程標示為 DPI 感知，SHIL_SMALL、 SHIL_LARGE和 SHIL_EXTRALARGE 縮放比例，每英吋 (DPI) 。 若要將這些類型設定為 DPI 感知，請呼叫 SetProcessDPIAware。 不論 DPI 感知設定為何，SHIL_JUMBO固定為 256 圖元。
規格需求
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平臺 | Windows |
| 標頭 | shellapi.h |
| DLL | Shell32.dll |
| API 集合 | ext-ms-win-shell32-l1-2-2 (于 Windows 10 10.0.14393 版中引進) |