Skip to content

Latest commit

 

History

History
83 lines (63 loc) · 2.45 KB

nf-shlobj_core-shcreatefileextracticona.md

File metadata and controls

83 lines (63 loc) · 2.45 KB
UID tech.root title ms.date targetos description req.assembly req.construct-type req.ddi-compliance req.dll req.header req.idl req.include-header req.irql req.kmdf-ver req.lib req.max-support req.namespace req.redist req.target-min-winverclnt req.target-min-winversvr req.target-type req.type-library req.umdf-ver req.unicode-ansi topic_type api_type api_location api_name f1_keywords dev_langs
NF:shlobj_core.SHCreateFileExtractIconA
shell
SHCreateFileExtractIconA
04/14/2021
Windows
SHCreateFileExtractIcon may be altered or unavailable. (ANSI)
function
Shell32.dll (version 5.0 or later)
shlobj_core.h
Shlobj.h
Shell32.lib
Windows XP [desktop apps only]
Windows Server 2003 [desktop apps only]
Windows
apiref
DllExport
Shell32.dll
SHCreateFileExtractIconA
SHCreateFileExtractIcon
SHCreateFileExtractIconA
shlobj_core/SHCreateFileExtractIconA
SHCreateFileExtractIcon
shlobj_core/SHCreateFileExtractIcon
c++

SHCreateFileExtractIconA 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.