SHCreateFileExtractIconA 函式 (shlobj_core.h)

[SHCreateFileExtractIcon 可用於需求一節中指定的作業系統。後續版本可能會變更或無法使用。]

建立檔案系統物件的預設 IExtractIcon 處理常式。顯示檔案系統物件的命名空間延伸模組通常會使用此函式。延伸模組和檔案屬性衍生簡單圖示擷取器所需的所有專案。

語法

SHSTDAPI SHCreateFileExtractIconA(
  [in] LPCSTR pszFile,
  [in] DWORD  dwFileAttributes,
  [in] REFIID riid,
       void   **ppv
);

[in] pszFile

類型： LPCTSTR

指定檔案系統物件的 Null 終止字串指標。緩衝區長度不能超過MAX_PATH個字元。

[in] dwFileAttributes

類型： DWORD

一或多個檔案屬性旗標的組合， (FILE_ATTRIBUTE_* 值，如 Winnt.h) 中所定義，指定物件的類型。

[in] riid

類型： REFIID

要建立之圖示擷取器介面所需介面識別碼的參考。這必須是IID_IExtractIconA或IID_IExtractIconW。

ppv

類型： void**

當此函式傳回時，包含 riid中要求的介面指標。這通常是 IExtractIcon。

類型： HRESULT

如果此函式成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。