ExtractAssociatedIconW 函式 （shellapi.h）
取得儲存為檔案中資源之圖示的句柄，或儲存在檔案相關聯可執行檔中的圖示。
語法
HICON ExtractAssociatedIconW(
[in] HINSTANCE hInst,
[in, out] LPWSTR pszIconPath,
[in, out] WORD *piIcon
);
參數
[in] hInst
類型：HINSTANCE
呼叫應用程式的實例句柄。
[in, out] pszIconPath
類型：LPTSTR
在專案上，字串的指標會指定包含圖示之檔案的完整路徑和檔名。 函式會從該檔案或與該檔案相關聯的可執行檔擷取圖示句柄。
當此函式傳回時，如果圖示句柄是從可執行檔取得的（由 lpIconPath 所指向的可執行檔 或相關聯的可執行檔），則函式會將該可執行檔的完整路徑和檔名儲存在此參數所指向的緩衝區中。
[in, out] piIcon
類型：LPWORD
WORD 的指標 值，在專案上指定要取得其句柄的圖示索引。
當函式傳回時，如果圖示句柄是從可執行檔取得的（lpIconPath 所指向的可執行檔 或相關聯的可執行檔），這個值會指向該檔案中的圖示索引。
傳回值
類型：HICON
如果函式成功，傳回值就是圖示句柄。 如果圖示是從相關聯的可執行檔案中擷取，函式會將可執行檔的完整路徑和檔名儲存在 lpIconPath所指向的字串中，並將圖示的標識符儲存在 WORD 中，lpiIcon 所指向。
如果函式失敗，則傳回值 NULL。
言論
當不再需要時，呼叫者會負責透過呼叫 DestroyIcon 函式，釋放 ExtractAssociatedIcon 傳回的圖示句柄。
ExtractAssociatedIcon 函式會先在 lpIconPath所指定的檔案中尋找索引圖示。 如果函式無法從該檔案取得圖示句柄，而且該檔案具有相關聯的可執行檔，它會在該可執行檔中尋找圖示。 與可執行文件的關聯是以擴展名為基礎，並儲存在登錄的每個使用者部分。
注意
Shellapi.h 標頭會根據 UNICODE 預處理器常數的定義，將 ExtractAssociatedIcon 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 支援的最低伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平臺 | 窗戶 |
| 標頭 | shellapi.h |
| DLL | Shell32.dll |
| API 集 | ext-ms-win-shell-shell32-l1-2-1 （在 Windows 10 版本 10.0.10240 中引進） |