IShellIconOverlay::GetOverlayIconIndex 方法 (shlobj_core.h)

取得系統映像清單中的圖示重疊索引。

語法

HRESULT GetOverlayIconIndex(
  [in]      PCUITEMID_CHILD pidl,
  [in, out] int             *pIconIndex
);

參數

[in] pidl

類型: PCUITEMID_CHILD

ITEMIDLIST 結構的指標,識別其圖示正在顯示的物件。

[in, out] pIconIndex

類型: int*

圖示重疊影像在系統映射清單中的索引指標。 此索引相當於當您使用 ImageList::SetOverlayImage 函式將重疊影像新增至私人影像清單時所指定的 iImage 值。

傳回值

類型: HRESULT

這個方法可以傳回下列其中一個值。

傳回碼 描述
S_OK
找到重疊的索引。
S_FALSE
此檔案沒有重疊。
E_FAIL
PIDL 無效。

備註

若要擷取系統映射清單中的重疊影像索引,您必須先呼叫 SHGetIconOverlayIndex 以擷取重疊索引。 然後使用 INDEXTOOVERLAYMASK 宏,將重疊索引轉換成對等影像索引。

規格需求

需求
最低支援的用戶端 Windows 2000 Professional、Windows XP [僅限桌面應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 shlobj_core.h
Dll Shell32.dll (5.0 版或更新版本)

另請參閱

IShellIconOverlay