NAME¶

SHGetFolderLocation (SHELL32.@)

SYNOPSIS¶

HRESULT SHGetFolderLocation
(
HWND hwndOwner,
int nFolder,
HANDLE hToken,
DWORD dwReserved,
LPITEMIDLIST* ppidl
)

DESCRIPTION¶

Gets the folder locations from the registry and creates a pidl.

PARAMS¶

hwndOwner [In] . nFolder [In] CSIDL_xxxxx. hToken [In] token representing user, or NULL for current user, or -1 for default user. dwReserved [In] must be zero. ppidl [Out] PIDL of a special folder.

RETURNS¶

Success: S_OK Failure: Standard OLE-defined error result, S_FALSE or E_INVALIDARG.

NOTES¶

Creates missing reg keys and directories. Mostly forwards to SHGetFolderPathW, but a few values of nFolder return virtual folders that are handled here.

IMPLEMENTATION¶

Declared in "shlobj.h". Implemented in "dlls/shell32/shellpath.c". Debug channel "shell".