ExtractlconEx

ExtractlconEx函式從限定的執行檔；動態程式庫（DLL），或者圖示檔案中生成圖示句柄數組。

基本介紹

• 外文名：ExtractlconEx
• 類別：計算機函式
• 功能：生成圖示句柄數組
• 原型：UINT ExtractIconEx

參數說明

IpszFile:定義可獲取圖示的執行檔，DLL,或者圖示檔案的名字的空結束字元串指針。

nlconlndex:指定抽取第一個圖示基於零的變址；例如，如果該值是零；函式在限定的檔案中抽取第一圖示；如該值是C1且phlconLarge和phiconSmall參數均為NULL，函式返回限定檔案中圖示的總數；如果檔案是執行檔或DLL；返回值是RT_GROUP_ICON資源的數目；如果檔案是一個ICO檔案，返回值是1；在Windows95，WindowsNT4.0,和更高版本中，如果值為負數且phlconLarge和phiconSmall均不為NULL，函式從獲取圖示開始，該圖示的資源標識符等於nlconlndex絕對值。例如，使用-3來獲取資源標識符為3的圖示。

phiconLarge:指向圖示句柄數組的指針，它可接收從檔案獲取的大圖示的句柄。如果該參數是NULL沒有從檔案抽取大圖示。

phiconSmall：指向圖示句柄數組的指針，它可接收從檔案獲取的小圖示的句柄。如果該參數是NULL，沒有從檔案抽取小圖示。

nlcons:指定要從檔案中抽取圖示的數目。

返回值：如果nlconlndex參數是-1，PhiconLarge和PhiconSmall參數是NULL，返回值是包含在指定檔案中的圖示數目；否則，返回值是成功地從檔案中獲取圖示的數目。

備註：必須調用Destroylcon函式來清除由ExtractlconEx函式返回的圖示。為恢復大小圖示尺寸,可使用SM_CXICON,SM_CYICON,SM_CXSMICON,SM_CYSMICON標記來調用GetSystemMetrics函式。

Windows CE：nlconlndex參數必須是零或CN（N是指定的資源標識符）；nlcons參數必須是1。

速查：Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：1.0及以上版本；頭檔案：shellspi.h；庫檔案：shell32.lib；Unicodg：在Windows NT上實現為Unicode和ANSI兩種版本。