共用方式為

ExtractIconExW 函式 （shellapi.h）

  • 發行項

ExtractIconEx 函式會建立從指定可執行檔、DLL 或圖示檔擷取之大型或小型圖標的句柄陣列。

語法

UINT ExtractIconExW(
  [in]  LPCWSTR lpszFile,
  [in]  int     nIconIndex,
  [out] HICON   *phiconLarge,
  [out] HICON   *phiconSmall,
        UINT    nIcons
);

參數

[in] lpszFile

類型：LPCTSTR

Null 終止字串的指標，指定要從中擷取圖示之可執行檔、DLL 或圖示檔的名稱。

[in] nIconIndex

類型：int

指定要擷取之第一個圖示之以零起始的索引。 例如，如果此值為零，函式會擷取指定檔案中的第一個圖示。

如果此值為 –1，且 phiconLarge 和 phiconSmall 都是 NULL，則函式會傳回指定檔案中的圖示總數。 如果檔案是可執行檔或 DLL，傳回值就是RT_GROUP_ICON資源的數目。 如果檔案是.ico檔案，則傳回值為 1。

如果此值為負數，而且 phiconLarge 或 phiconSmall 不是 NULL，則函式會從擷取資源標識符等於 nIconIndex 絕對值的圖示開始。 例如，使用 -3 來擷取資源標識碼為 3 的圖示。

[out] phiconLarge

類型：HICON*

圖示句柄陣列的指標，這個陣列會接收從檔案擷取之大型圖示的句柄。 如果此參數 NULL，則不會從檔案擷取任何大型圖示。

[out] phiconSmall

類型：HICON*

圖示句柄陣列的指標，這個陣列會接收從檔案擷取的小圖示句柄。 如果此參數 NULL，則不會從檔案擷取任何小型圖示。

nIcons

類型：UINT

要從檔案擷取的圖示數目。

傳回值

類型：UINT

如果 nIconIndex 參數是 -1，而且 phiconLarge 和 phiconSmall 參數都是 NULL，則傳回值會是指定檔案中包含的圖示數目。

如果 nIconIndex 參數是 -1 以外的任何值，而且 phiconLarge 或 phiconSmall 不是 NULL，則傳回值是從檔案成功擷取的圖示數目。

注意

如果函式發生錯誤，則會傳回 UINT_MAX。 在此情況下，您可以呼叫 getLastError 來擷取錯誤碼。 例如，如果找不到 lpszFile 所指定的檔案，而 nIconIndex 參數不是 -1 以外的任何值，而且 phiconLarge 或 phiconSmall 不是 NULL以外的任何值，則此函式會傳回 UINT_MAX。 在此情況下，GetLastError 會傳回 ERROR_FILE_NOT_FOUND （2）。

言論

不再需要它們時，您必須呼叫 DestroyIcon 函式，以終結擷取 ExtractIconEx 擷取的所有圖示。

若要擷取大型和小型圖示的維度，請使用此函式搭配SM_CXICON、SM_CYICON、SM_CXSMICON和SM_CYSMICON旗標。

注意

shellapi.h 標頭會將 ExtractIconEx 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 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 中引進）

另請參閱

ExtractAssociatedIcon

ExtractAssociatedIconEx

ExtractIcon