IAssocHandler：：GetIconLocation 方法 (shobjidl_core.h)

擷取與應用程式相關聯的圖示位置。

語法

HRESULT GetIconLocation(
  [out] LPWSTR *ppszPath,
  [out] int    *pIndex
);

[out] ppszPath

類型： LPWSTR*

當這個方法傳回時，會包含以 Null 終止之 Unicode 字串的指標位址，其中包含應用程式圖示的路徑。

[out] pIndex

類型： int*

當這個方法傳回時，會包含 ppszPath 中名為之資源內圖示索引的指標。

類型： HRESULT

如果此方法成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

如果找不到圖示，函式會傳回可執行文件的路徑，以及零的圖示索引。

基於效能考慮，應用程式可能會使用殼層映射快取來擷取圖示，而不是直接從傳回的路徑載入圖示。路徑和圖示索引可以直接傳遞至 Shell_GetCachedImageIndex。其中一個優點是殼層快取可以在沒有圖示可供應用程式使用的情況下提供預設圖示。