共用方式為

Shell_GetCachedImageIndexA函式 （shlobj_core.h）

  • 發行項

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

擷取快取圖示的快取索引。

語法

int Shell_GetCachedImageIndexA(
  LPCSTR pszIconPath,
  int    iIconIndex,
  UINT   uIconFlags
);

參數

pszIconPath

待定

iIconIndex

類型：int

位於 pwszIconPath 之檔案中影像的索引。

uIconFlags

類型：UINT

未使用。

傳回值

類型：int

傳回影像的索引，或在失敗時傳回 –1。

言論

Windows Vista 中已新增此函式的 Shell_GetCachedImageIndexA 和 Shell_GetCachedImageIndexW 版本。 若為 Unicode 字串，請呼叫 Shell_GetCachedImageIndexW 或 Shell_GetCachedImageIndex。 針對 ANSI 字串，您必須明確呼叫 Shell_GetCachedImageIndexA。

Windows Server 2003 和 Windows XP：僅支援 Shell_GetCachedImageIndex。 Shell_GetCachedImageIndex 需要 Unicode 字串。

注意

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

要求

要求 價值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 shlobj_core.h （包括 Shlobj.h、Shlobj_core.h、Shlobj.h、Shlobj_core.h）
連結庫 Shell32.lib
DLL Shell32.dll 版 （5.0 版或更新版本）
API 集 ext-ms-win-shell-shell32-l1-2-1 （在 Windows 10 版本 10.0.10240 中引進）

另請參閱

FileIconInit