IExtractIconA：：Extract 方法 (shlobj_core.h)

  • 發行項

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

語法

HRESULT Extract(
  [in]            PCSTR 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