共用方式為

ExtractAssociatedIconExW 函式 （shellapi.h）

  • 發行項

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

取得儲存為檔案中資源之圖示的句柄，或儲存在檔案相關聯可執行檔中的圖示。 它會從可執行檔擷取圖示標識碼，藉此擴充 ExtractAssociatedIcon 函式。

語法

HICON ExtractAssociatedIconExW(
  [in]      HINSTANCE hInst,
  [in, out] LPWSTR    pszIconPath,
  [in, out] WORD      *piIconIndex,
  [in, out] WORD      *piIconId
);

參數

[in] hInst

類型：HINSTANCE

要從中擷取圖示之模組的句柄。

[in, out] pszIconPath

類型：LPTSTR

在專案上，字串的指標會指定包含圖示之檔案的完整路徑和檔名。 函式會從該檔案或與該檔案相關聯的可執行檔擷取圖示句柄。

當這個函式傳回時，如果圖示句柄是從可執行檔取得的（這個參數直接指向的可執行檔或相關聯的可執行檔），函式會將該可執行檔的完整路徑和檔名儲存在此參數指向的緩衝區中。

[in, out] piIconIndex

類型：LPWORD

WORD 的指標 值，在專案上指定要取得其句柄的圖示索引。

當函式傳回時，如果圖示句柄是從可執行檔取得的（lpIconPath 所指向的可執行檔 或相關聯的可執行檔），這個值會指向該檔案中的圖示索引。

[in, out] piIconId

類型：LPWORD

WORD 的指標 值，在專案上，指定要取得其句柄的圖示標識符。

當函式傳回時，如果圖示句柄是從可執行檔取得的（lpIconPath 所指向的可執行檔 或相關聯的可執行檔），這個值會指向該檔案內的圖示標識符。

傳回值

類型：HICON

如果成功，則傳回圖示的句柄，否則 NULL。

言論

此函式傳回的圖示句柄必須藉由呼叫 DestroyIcon 不再需要時釋放。

注意

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

要求

要求 價值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 shellapi.h
連結庫 Shell32.lib
DLL Shell32.dll 版 （5.0 版或更新版本）

另請參閱

ExtractAssociatedIcon

ExtractIcon

ExtractIconEx