Skip to content

Latest commit

 

History

History
104 lines (77 loc) · 3.58 KB

nf-shlobj_core-shgetspecialfolderpathw.md

File metadata and controls

104 lines (77 loc) · 3.58 KB
Raw
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.SHGetSpecialFolderPathW
SHGetSpecialFolderPathW function (shlobj_core.h)
SHGetSpecialFolderPath is not supported. Instead, use ShGetFolderPath. (Unicode)
SHGetSpecialFolderPath
SHGetSpecialFolderPath function [Windows Shell]
SHGetSpecialFolderPathW
_win32_SHGetSpecialFolderPath
shell.SHGetSpecialFolderPath
shlobj_core/SHGetSpecialFolderPath
shlobj_core/SHGetSpecialFolderPathW
shell\SHGetSpecialFolderPath.htm
shell
4c39fdc1-5e43-4042-8703-fb72c88e2637
12/05/2018
SHGetSpecialFolderPath, SHGetSpecialFolderPath function [Windows Shell], SHGetSpecialFolderPathA, SHGetSpecialFolderPathW, _win32_SHGetSpecialFolderPath, shell.SHGetSpecialFolderPath, shlobj_core/SHGetSpecialFolderPath, shlobj_core/SHGetSpecialFolderPathA, shlobj_core/SHGetSpecialFolderPathW
shlobj_core.h
Shlobj.h, Shlobj_core.h
Windows
Windows 2000 Professional [desktop apps only]
Windows 2000 Server [desktop apps only]
SHGetSpecialFolderPathW (Unicode) and SHGetSpecialFolderPathA (ANSI)
Shell32.lib
Shell32.dll (version 4.71 or later)
Windows
19H1
SHGetSpecialFolderPathW
shlobj_core/SHGetSpecialFolderPathW
c++
APIRef
kbSyntax
DllExport
Shell32.dll
API-MS-Win-shell-shellfolders-l1-1-0.dll
KernelBase.dll
Ext-MS-Win-Shell32-Shellfolders-L1-1-0.dll
Ext-MS-Win-Shell32-Shellfolders-L1-1-1.dll
Windows.Storage.dll
SHGetSpecialFolderPath
SHGetSpecialFolderPathA
SHGetSpecialFolderPathW

SHGetSpecialFolderPathW function

-description

[SHGetSpecialFolderPath is not supported. Instead, use SHGetFolderPath.]

Retrieves the path of a special folder, identified by its CSIDL.

-parameters

-param hwnd

Type: HWND

Reserved.

-param pszPath [out]

Type: LPTSTR

A pointer to a null-terminated string that receives the drive and path of the specified folder. This buffer must be at least MAX_PATH characters in size.

-param csidl [in]

Type: int

A CSIDL that identifies the folder of interest. If a virtual folder is specified, this function will fail.

-param fCreate [in]

Type: BOOL

Indicates whether the folder should be created if it does not already exist. If this value is nonzero, the folder is created. If this value is zero, the folder is not created.

-returns

Type: BOOL

TRUE if successful; otherwise, FALSE.

-remarks

The Microsoft Internet Explorer 4.0 Desktop Update must be installed for this function to be available.

Note

The shlobj_core.h header defines SHGetSpecialFolderPath as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.