SHDefExtractIconW 函式 (shlobj_core.h)

提供從檔案擷取圖標的默認處理程式。

語法

SHSTDAPI SHDefExtractIconW(
  [in]            LPCWSTR pszIconFile,
                  int     iIndex,
  [in]            UINT    uFlags,
  [out, optional] HICON   *phiconLarge,
  [out, optional] HICON   *phiconSmall,
                  UINT    nIconSize
);

參數

[in] pszIconFile

類型： LPCTSTR

Null 終止緩衝區的指標，其中包含從中擷取圖示之檔案的路徑和名稱。

iIndex

類型： int

在 pszIconFile 中名為 的檔案中圖示的位置。 如果這是正數，則會參考檔案中圖示以零起始的位置。 例如，0 是指資源檔中的第1個圖示，而2則是指第3個圖示。 如果這是負數，則會參考圖示的資源標識符。

[in] uFlags

類型： UINT

控制圖示擷取的旗標。

GIL_SIMULATEDOC

重迭預設文件圖示上的擷取圖示，以建立最終圖示。 找不到或擷取任何適當的圖示時，可以使用此圖示。

[out, optional] phiconLarge

類型： HICON*

HICON 的指標，當此函式成功傳回時，會收到 nIconSize之 LOWORD 中指定的大型圖示版本的句柄。 此值可以是 NULL。

[out, optional] phiconSmall

類型： HICON*

HICON 的指標，當此函式成功傳回時，會收到 nIconSize之 HIWORD 中指定的小型圖示版本的句柄。

nIconSize

類型： UINT

值，其中包含 LOWORD 中的大型圖示大小，以及 HIWORD 中的小型圖示大小。 大小是以像素為單位。 傳遞 0 以指定預設的大型和小型大小。

傳回值

類型： HRESULT

此函式可以傳回下列其中一個值。

備註

當不再需要圖示資源時，呼叫者必須負責釋放透過此函式建立的圖示資源。 這可以透過 DestroyIcon 函式來完成。

規格需求