nf-shlobj_core-shcreatefileextracticonw.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:shlobj_core.SHCreateFileExtractIconW	SHCreateFileExtractIconW function (shlobj_core.h)	SHCreateFileExtractIcon may be altered or unavailable. (Unicode)	SHCreateFileExtractIcon SHCreateFileExtractIcon function [Windows Shell] SHCreateFileExtractIconW _win32_SHCreateFileExtractIcon shell.SHCreateFileExtractIcon shlobj_core/SHCreateFileExtractIcon shlobj_core/SHCreateFileExtractIconW	shell\SHCreateFileExtractIcon.htm	shell	af3beb0a-892b-43e5-b5b8-8005f497b6e5	12/05/2018	SHCreateFileExtractIcon, SHCreateFileExtractIcon function [Windows Shell], SHCreateFileExtractIconW, _win32_SHCreateFileExtractIcon, shell.SHCreateFileExtractIcon, shlobj_core/SHCreateFileExtractIcon, shlobj_core/SHCreateFileExtractIconW	shlobj_core.h	Shlobj.h	Windows	Windows XP [desktop apps only]	Windows Server 2003 [desktop apps only]				SHCreateFileExtractIconW (Unicode)						Shell32.lib	Shell32.dll (version 5.0 or later)		Windows			19H1	SHCreateFileExtractIconW shlobj_core/SHCreateFileExtractIconW	c++	APIRef kbSyntax	DllExport	Shell32.dll	SHCreateFileExtractIcon SHCreateFileExtractIconW

SHCreateFileExtractIconW function

-description

[SHCreateFileExtractIcon is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

Creates a default IExtractIcon handler for a file system object. Namespace extensions that display file system objects typically use this function. The extension and file attributes derive all that is needed for a simple icon extractor.

-parameters

-param pszFile [in]

Type: LPCTSTR

A pointer to a null-terminated string that specifies the file system object. The buffer must not exceed MAX_PATH characters in length.

-param dwFileAttributes [in]

Type: DWORD

A combination of one or more file attribute flags (FILE_ATTRIBUTE_* values as defined in Winnt.h) that specify the type of object.

-param riid [in]

Type: REFIID

Reference to the desired interface ID of the icon extractor interface to create. This must be either IID_IExtractIconA or IID_IExtractIconW.

-param ppv

Type: void**

When this function returns, contains the interface pointer requested in riid. This is typically IExtractIcon.

-returns

Type: HRESULT

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.