擷取影像清單。
語法
SHSTDAPI SHGetImageList(
[in] int iImageList,
[in] REFIID riid,
[out] void **ppvObj
);
參數
[in] iImageList
類型： int
清單中包含的影像類型。 下列其中一個值：
SHIL_LARGE （0x0）
0x0。 圖像尺寸通常為 32x32 像素。 但是，如果從「顯示屬性」中「外觀」標籤的「效果」區段中選取「使用大圖示」選項，則影像為 48x48 像素。
SHIL_SMALL （0x1）
0x1。 這些圖像是 Shell 標準的 16x16 小圖標大小，但大小可以由用戶自定義。
SHIL_EXTRALARGE （0x2）
0x2。 這些圖像是 Shell 標準超大圖標大小。 這通常為 48x48，但尺寸可以由使用者自訂。
SHIL_SYSSMALL （0x3）
0x3。 這些映像是使用 SM_CXSMICON 呼叫的 GetSystemMetrics 和使用 SM_CYSMICON 呼叫的 GetSystemMetrics 所指定的大小。
SHIL_JUMBO （0x4）
0x4。 Windows Vista 和更新版本。 圖像通常為 256x256 像素。
SHIL_LAST
最大的有效旗標值，用於驗證目的。
[in] riid
類型： REFIID
對映像清單介面識別碼的引用，通常IID_IImageList。
[out] ppvObj
類型： 無效**
當這個方法傳回時，包含 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 像素。
需求
| Requirement | 價值觀 |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 支援的最低伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平臺 | 窗戶 |
| Header | shellapi.h |
| Library | OneCore.Lib |
| DLL | Shell32.dll |
| API 集 | ext-ms-win-shell-shell32-l1-2-2 （Windows 10 版本 10.0.14393 中引進） |