ExtractAssociatedIconA 函式 (shellapi.h)

取得儲存為檔案中資源之圖示的句柄，或儲存在檔案相關聯可執行檔中的圖示。

語法

HICON ExtractAssociatedIconA(
  [in]      HINSTANCE hInst,
  [in, out] LPSTR     pszIconPath,
  [in, out] WORD      *piIcon
);

[in] hInst

類型： HINSTANCE

呼叫應用程式的實例句柄。

[in, out] pszIconPath

類型： LPTSTR

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

當此函式傳回時，如果圖示句柄是從可執行檔取得， (lpIconPath 所指向的可執行檔或相關聯的可執行檔) ，則函式會儲存此參數所指向之緩衝區中該可執行檔的完整路徑和檔名。

[in, out] piIcon

類型： LPWORD

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

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

類型： HICON

如果函式成功，則傳回值是圖示句柄。如果圖示是從相關聯的可執行檔擷取，函式會將可執行檔的完整路徑和檔名儲存在 lpIconPath 所指向的字串中，並將圖標的標識符儲存在 lpiIcon 所指向的 WORD 中。

如果函式失敗，則傳回值為 NULL。

不再需要時，呼叫端會負責藉由呼叫 DestroyIcon 函式釋放 ExtractAssociatedIcon 所傳回的圖示句柄。

ExtractAssociatedIcon 函式會先在 lpIconPath 指定的檔案中尋找索引圖示。如果函式無法從該檔案取得圖示句柄，而且檔案具有相關聯的可執行檔，它會在該可執行檔中尋找圖示。與可執行文件的關聯是以擴展名為基礎，並儲存在登錄的每個使用者部分。

注意

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