SHGetFolderLocation(3w)

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

Defined in "shlobj.h".

Implemented in "build/buildd-wine-unstable_1.1.32-1+b1-amd64-KnxYu0/wine-unstable-1.1.32/build32/dlls/shell32/shellpath.c".

Debug channel "shell".

Wine API Aug 2010 SHGetFolderLocation(3w)