共用方式為

SHMapPIDLToSystemImageListIndex 函式 (shlobj_core.h)

  • 發行項

[SHMapPIDLToSystemImageListIndex 可用於需求一節中指定的作業系統。 後續版本可能會變更或無法使用。]

從與資料夾專案相關聯的系統映射清單中擷取圖示索引。

語法

int SHMapPIDLToSystemImageListIndex(
  [in]            IShellFolder    *pshf,
  [in]            PCUITEMID_CHILD pidl,
  [out, optional] int             *piIndexSel
);

參數

[in] pshf

類型： IShellFolder*

包含專案之資料夾的 IShellFolder 介面指標。

[in] pidl

類型： PCUITEMID_CHILD

專案 ITEMIDLIST 結構的指標。

[out, optional] piIndexSel

類型： int*

int的指標，當此函式成功傳回時，會在系統映射清單中收到專案開啟圖示的索引。 如果專案沒有特殊的 開啟 圖示，則會傳回其一般圖示的索引。 如果 開啟 的圖示存在且無法取得， 則 piIndex 指向的值會設定為 -1。 如果呼叫的應用程式對開啟的圖示不感興趣，這個參數可以是Null。

傳回值

類型： int

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

規格需求

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