共用方式為

IExtractIconW：：Extract 方法 (shlobj_core.h)

  • 發行項

從指定的位置擷取圖示影像。

語法

HRESULT Extract(
  [in]            PCWSTR pszFile,
                  UINT   nIconIndex,
  [out, optional] HICON  *phiconLarge,
  [out, optional] HICON  *phiconSmall,
                  UINT   nIconSize
);

參數

[in] pszFile

類型： PCTSTR

指定圖示位置之 Null 終止字串的指標。

nIconIndex

類型： UINT

pszFile指向之檔案中的圖示索引。

[out, optional] phiconLarge

類型： HICON*

HICON值的指標，可接收大型圖示的控制碼。 此參數可以是 Null。

[out, optional] phiconSmall

類型： HICON*

接收小圖示控制碼的 HICON 值指標。 此參數可以是 Null。

nIconSize

類型： UINT

圖示所需的大小，以圖元為單位。 低字包含大型圖示的大小，而高字則包含小型圖示的大小。 指定的大小可以是寬度或高度。 圖示的寬度一律等於其高度。

傳回值

類型： HRESULT

如果函式擷取圖示，則傳回S_OK;如果呼叫的應用程式應該擷取圖示，則傳回S_FALSE。

備註

圖示位置和索引是 IExtractIcon：：GetIconLocation 方法所傳回的相同值。 如果 IExtractIcon：：Extract 函式傳回S_FALSE，這些值必須指定圖示檔案名和索引，該圖示檔案名和索引會形成對 ExtractIcon的呼叫。 如果 IExtractIcon：：Extract 未傳回S_FALSE，則不應假設 pszFile 和 nIconIndex 參數的意義。

需求

   
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 shlobj_core.h
Dll Shell32.dll (4.0 版或更新版本)

另請參閱

IExtractIcon