SHGetIconOverlayIndexW 函式 (shlobj_core.h)

發行項
03/02/2024

傳回系統映像清單中的重迭圖示索引。

語法

int SHGetIconOverlayIndexW(
  [in, optional] LPCWSTR pszIconPath,
                 int     iIconIndex
);

參數

[in, optional] pszIconPath

類型： LPCTSTR

長度上限之 null 終止字串的指標 ，MAX_PATH 包含包含圖示之檔案的完整路徑。

iIconIndex

類型： int

pszIconPath 所指向檔案中的圖示索引。若要要求標準重迭圖示，請將 pszIconPath 設定為 NULL， 並將 iIconIndex 設定為下列其中一項：

IDO_SHGIOI_SHARE (0x0FFFFFFF)

表示共用資料夾的重迭圖示。

IDO_SHGIOI_LINK (0x0FFFFFFE)

表示連結資料夾或檔案的重迭圖示。

IDO_SHGIOI_SLOWFILE (0x0FFFFFFD)

表示慢速檔案的重迭圖示。

IDO_SHGIOI_DEFAULT (0x0FFFFFFC)

Windows 7 和更新版本。重迭圖示，指出專案是集合中的預設值。其中一個範例是預設印表機。

傳回值

類型： int

如果成功，則會傳回系統映射清單中的重迭圖示索引，否則傳回 -1。

備註

圖示重疊是系統映像清單的一部分。它們有兩個標識碼。第一個是單一式重疊索引，可識別相對於影像清單中其他重疊的重疊。另一個是識別實際影像的影像索引。這兩個索引相當於您在將圖示重疊新增至具有ImageList_SetOverlayImage的私人影像清單時，分別指派給 iOverlay 和 iImage 參數的值。 SHGetIconOverlayIndex 會傳回重疊索引。若要將重疊索引轉換成其對等影像索引，請呼叫 INDEXTOOVERLAYMASK。

注意在初始化期間將映射載入系統映像清單中之後，就無法變更。 pszIconPath 和 iIconIndex 指定的檔名和索引只會用來識別圖示重疊。 SHGetIconOverlayIndex 無法用來修改系統映射清單。

注意

shlobj_core.h 標頭會根據 UNICODE 預處理器常數的定義，將 SHGetIconOverlayIndex 定義為別名，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	shlobj_core.h (包含 Shlobj.h、Shlobj_core.h)
程式庫	Shell32.lib
Dll	Shell32.dll (5.0 版或更新版本)

另請參閱

IShellIconOverlay

IShellIconOverlayIdentifier

共用方式為