4 * Copyright 1998, 1999, 2000 Juergen Schmied
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, write to the Free Software
18 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
22 * Many of these functions are in SHLWAPI.DLL also
27 #include "wine/port.h"
32 #include "wine/debug.h"
41 #include "shell32_main.h"
42 #include "undocshell.h"
44 #include "wine/unicode.h"
47 WINE_DEFAULT_DEBUG_CHANNEL(shell
);
50 ########## Combining and Constructing paths ##########
53 /*************************************************************************
54 * PathAppend [SHELL32.36]
56 BOOL WINAPI
PathAppendAW(
60 if (SHELL_OsIsUnicode())
61 return PathAppendW(lpszPath1
, lpszPath2
);
62 return PathAppendA(lpszPath1
, lpszPath2
);
65 /*************************************************************************
66 * PathCombine [SHELL32.37]
68 LPVOID WINAPI
PathCombineAW(
73 if (SHELL_OsIsUnicode())
74 return PathCombineW( szDest
, lpszDir
, lpszFile
);
75 return PathCombineA( szDest
, lpszDir
, lpszFile
);
78 /*************************************************************************
79 * PathAddBackslash [SHELL32.32]
81 LPVOID WINAPI
PathAddBackslashAW(LPVOID lpszPath
)
83 if(SHELL_OsIsUnicode())
84 return PathAddBackslashW(lpszPath
);
85 return PathAddBackslashA(lpszPath
);
88 /*************************************************************************
89 * PathBuildRoot [SHELL32.30]
91 LPVOID WINAPI
PathBuildRootAW(LPVOID lpszPath
, int drive
)
93 if(SHELL_OsIsUnicode())
94 return PathBuildRootW(lpszPath
, drive
);
95 return PathBuildRootA(lpszPath
, drive
);
99 Extracting Component Parts
102 /*************************************************************************
103 * PathFindFileName [SHELL32.34]
105 LPVOID WINAPI
PathFindFileNameAW(LPCVOID lpszPath
)
107 if(SHELL_OsIsUnicode())
108 return PathFindFileNameW(lpszPath
);
109 return PathFindFileNameA(lpszPath
);
112 /*************************************************************************
113 * PathFindExtension [SHELL32.31]
115 LPVOID WINAPI
PathFindExtensionAW(LPCVOID lpszPath
)
117 if (SHELL_OsIsUnicode())
118 return PathFindExtensionW(lpszPath
);
119 return PathFindExtensionA(lpszPath
);
123 /*************************************************************************
124 * PathGetExtensionA [internal]
127 * exported by ordinal
128 * return value points to the first char after the dot
130 static LPSTR
PathGetExtensionA(LPCSTR lpszPath
)
132 TRACE("(%s)\n",lpszPath
);
134 lpszPath
= PathFindExtensionA(lpszPath
);
135 return (LPSTR
)(*lpszPath
?(lpszPath
+1):lpszPath
);
138 /*************************************************************************
139 * PathGetExtensionW [internal]
141 static LPWSTR
PathGetExtensionW(LPCWSTR lpszPath
)
143 TRACE("(%s)\n",debugstr_w(lpszPath
));
145 lpszPath
= PathFindExtensionW(lpszPath
);
146 return (LPWSTR
)(*lpszPath
?(lpszPath
+1):lpszPath
);
149 /*************************************************************************
150 * PathGetExtension [SHELL32.158]
152 LPVOID WINAPI
PathGetExtensionAW(LPCVOID lpszPath
,DWORD void1
, DWORD void2
)
154 if (SHELL_OsIsUnicode())
155 return PathGetExtensionW(lpszPath
);
156 return PathGetExtensionA(lpszPath
);
159 /*************************************************************************
160 * PathGetArgs [SHELL32.52]
162 LPVOID WINAPI
PathGetArgsAW(LPVOID lpszPath
)
164 if (SHELL_OsIsUnicode())
165 return PathGetArgsW(lpszPath
);
166 return PathGetArgsA(lpszPath
);
169 /*************************************************************************
170 * PathGetDriveNumber [SHELL32.57]
172 int WINAPI
PathGetDriveNumberAW(LPVOID lpszPath
)
174 if (SHELL_OsIsUnicode())
175 return PathGetDriveNumberW(lpszPath
);
176 return PathGetDriveNumberA(lpszPath
);
179 /*************************************************************************
180 * PathRemoveFileSpec [SHELL32.35]
182 BOOL WINAPI
PathRemoveFileSpecAW(LPVOID lpszPath
)
184 if (SHELL_OsIsUnicode())
185 return PathRemoveFileSpecW(lpszPath
);
186 return PathRemoveFileSpecA(lpszPath
);
189 /*************************************************************************
190 * PathStripPath [SHELL32.38]
192 void WINAPI
PathStripPathAW(LPVOID lpszPath
)
194 if (SHELL_OsIsUnicode())
195 PathStripPathW(lpszPath
);
197 PathStripPathA(lpszPath
);
200 /*************************************************************************
201 * PathStripToRoot [SHELL32.50]
203 BOOL WINAPI
PathStripToRootAW(LPVOID lpszPath
)
205 if (SHELL_OsIsUnicode())
206 return PathStripToRootW(lpszPath
);
207 return PathStripToRootA(lpszPath
);
210 /*************************************************************************
211 * PathRemoveArgs [SHELL32.251]
213 void WINAPI
PathRemoveArgsAW(LPVOID lpszPath
)
215 if (SHELL_OsIsUnicode())
216 PathRemoveArgsW(lpszPath
);
218 PathRemoveArgsA(lpszPath
);
221 /*************************************************************************
222 * PathRemoveExtension [SHELL32.250]
224 void WINAPI
PathRemoveExtensionAW(LPVOID lpszPath
)
226 if (SHELL_OsIsUnicode())
227 PathRemoveExtensionW(lpszPath
);
229 PathRemoveExtensionA(lpszPath
);
237 /*************************************************************************
238 * PathGetShortPathA [internal]
240 static void PathGetShortPathA(LPSTR pszPath
)
244 TRACE("%s\n", pszPath
);
246 if (GetShortPathNameA(pszPath
, path
, MAX_PATH
))
248 lstrcpyA(pszPath
, path
);
252 /*************************************************************************
253 * PathGetShortPathW [internal]
255 static void PathGetShortPathW(LPWSTR pszPath
)
257 WCHAR path
[MAX_PATH
];
259 TRACE("%s\n", debugstr_w(pszPath
));
261 if (GetShortPathNameW(pszPath
, path
, MAX_PATH
))
263 lstrcpyW(pszPath
, path
);
267 /*************************************************************************
268 * PathGetShortPath [SHELL32.92]
270 VOID WINAPI
PathGetShortPathAW(LPVOID pszPath
)
272 if(SHELL_OsIsUnicode())
273 PathGetShortPathW(pszPath
);
274 PathGetShortPathA(pszPath
);
277 /*************************************************************************
278 * PathRemoveBlanks [SHELL32.33]
280 void WINAPI
PathRemoveBlanksAW(LPVOID str
)
282 if(SHELL_OsIsUnicode())
283 PathRemoveBlanksW(str
);
285 PathRemoveBlanksA(str
);
288 /*************************************************************************
289 * PathQuoteSpaces [SHELL32.55]
291 VOID WINAPI
PathQuoteSpacesAW (LPVOID lpszPath
)
293 if(SHELL_OsIsUnicode())
294 PathQuoteSpacesW(lpszPath
);
296 PathQuoteSpacesA(lpszPath
);
299 /*************************************************************************
300 * PathUnquoteSpaces [SHELL32.56]
302 VOID WINAPI
PathUnquoteSpacesAW(LPVOID str
)
304 if(SHELL_OsIsUnicode())
305 PathUnquoteSpacesW(str
);
307 PathUnquoteSpacesA(str
);
310 /*************************************************************************
311 * PathParseIconLocation [SHELL32.249]
313 int WINAPI
PathParseIconLocationAW (LPVOID lpszPath
)
315 if(SHELL_OsIsUnicode())
316 return PathParseIconLocationW(lpszPath
);
317 return PathParseIconLocationA(lpszPath
);
321 ########## Path Testing ##########
323 /*************************************************************************
324 * PathIsUNC [SHELL32.39]
326 BOOL WINAPI
PathIsUNCAW (LPCVOID lpszPath
)
328 if (SHELL_OsIsUnicode())
329 return PathIsUNCW( lpszPath
);
330 return PathIsUNCA( lpszPath
);
333 /*************************************************************************
334 * PathIsRelative [SHELL32.40]
336 BOOL WINAPI
PathIsRelativeAW (LPCVOID lpszPath
)
338 if (SHELL_OsIsUnicode())
339 return PathIsRelativeW( lpszPath
);
340 return PathIsRelativeA( lpszPath
);
343 /*************************************************************************
344 * PathIsRoot [SHELL32.29]
346 BOOL WINAPI
PathIsRootAW(LPCVOID lpszPath
)
348 if (SHELL_OsIsUnicode())
349 return PathIsRootW(lpszPath
);
350 return PathIsRootA(lpszPath
);
353 /*************************************************************************
354 * PathIsExeA [internal]
356 static BOOL
PathIsExeA (LPCSTR lpszPath
)
358 LPCSTR lpszExtension
= PathGetExtensionA(lpszPath
);
360 static const char * const lpszExtensions
[] =
361 {"exe", "com", "pif", "cmd", "bat", "scf", "scr", NULL
};
363 TRACE("path=%s\n",lpszPath
);
365 for(i
=0; lpszExtensions
[i
]; i
++)
366 if (!strcasecmp(lpszExtension
,lpszExtensions
[i
])) return TRUE
;
371 /*************************************************************************
372 * PathIsExeW [internal]
374 static BOOL
PathIsExeW (LPCWSTR lpszPath
)
376 LPCWSTR lpszExtension
= PathGetExtensionW(lpszPath
);
378 static const WCHAR lpszExtensions
[][4] =
379 {{'e','x','e','\0'}, {'c','o','m','\0'}, {'p','i','f','\0'},
380 {'c','m','d','\0'}, {'b','a','t','\0'}, {'s','c','f','\0'},
381 {'s','c','r','\0'}, {'\0'} };
383 TRACE("path=%s\n",debugstr_w(lpszPath
));
385 for(i
=0; lpszExtensions
[i
][0]; i
++)
386 if (!strcmpiW(lpszExtension
,lpszExtensions
[i
])) return TRUE
;
391 /*************************************************************************
392 * PathIsExe [SHELL32.43]
394 BOOL WINAPI
PathIsExeAW (LPCVOID path
)
396 if (SHELL_OsIsUnicode())
397 return PathIsExeW (path
);
398 return PathIsExeA(path
);
401 /*************************************************************************
402 * PathIsDirectory [SHELL32.159]
404 BOOL WINAPI
PathIsDirectoryAW (LPCVOID lpszPath
)
406 if (SHELL_OsIsUnicode())
407 return PathIsDirectoryW (lpszPath
);
408 return PathIsDirectoryA (lpszPath
);
411 /*************************************************************************
412 * PathFileExists [SHELL32.45]
414 BOOL WINAPI
PathFileExistsAW (LPCVOID lpszPath
)
416 if (SHELL_OsIsUnicode())
417 return PathFileExistsW (lpszPath
);
418 return PathFileExistsA (lpszPath
);
421 /*************************************************************************
422 * PathMatchSpec [SHELL32.46]
424 BOOL WINAPI
PathMatchSpecAW(LPVOID name
, LPVOID mask
)
426 if (SHELL_OsIsUnicode())
427 return PathMatchSpecW( name
, mask
);
428 return PathMatchSpecA( name
, mask
);
431 /*************************************************************************
432 * PathIsSameRoot [SHELL32.650]
434 BOOL WINAPI
PathIsSameRootAW(LPCVOID lpszPath1
, LPCVOID lpszPath2
)
436 if (SHELL_OsIsUnicode())
437 return PathIsSameRootW(lpszPath1
, lpszPath2
);
438 return PathIsSameRootA(lpszPath1
, lpszPath2
);
441 /*************************************************************************
442 * IsLFNDriveA [SHELL32.41]
444 BOOL WINAPI
IsLFNDriveA(LPCSTR lpszPath
)
448 if (!GetVolumeInformationA(lpszPath
, NULL
, 0, NULL
, &fnlen
, NULL
, NULL
, 0))
453 /*************************************************************************
454 * IsLFNDriveW [SHELL32.42]
456 BOOL WINAPI
IsLFNDriveW(LPCWSTR lpszPath
)
460 if (!GetVolumeInformationW(lpszPath
, NULL
, 0, NULL
, &fnlen
, NULL
, NULL
, 0))
465 /*************************************************************************
466 * IsLFNDrive [SHELL32.119]
468 BOOL WINAPI
IsLFNDriveAW(LPCVOID lpszPath
)
470 if (SHELL_OsIsUnicode())
471 return IsLFNDriveW(lpszPath
);
472 return IsLFNDriveA(lpszPath
);
476 ########## Creating Something Unique ##########
478 /*************************************************************************
479 * PathMakeUniqueNameA [internal]
481 BOOL WINAPI
PathMakeUniqueNameA(
484 LPCSTR lpszShortName
,
488 FIXME("%p %lu %s %s %s stub\n",
489 lpszBuffer
, dwBuffSize
, debugstr_a(lpszShortName
),
490 debugstr_a(lpszLongName
), debugstr_a(lpszPathName
));
494 /*************************************************************************
495 * PathMakeUniqueNameW [internal]
497 BOOL WINAPI
PathMakeUniqueNameW(
500 LPCWSTR lpszShortName
,
501 LPCWSTR lpszLongName
,
502 LPCWSTR lpszPathName
)
504 FIXME("%p %lu %s %s %s stub\n",
505 lpszBuffer
, dwBuffSize
, debugstr_w(lpszShortName
),
506 debugstr_w(lpszLongName
), debugstr_w(lpszPathName
));
510 /*************************************************************************
511 * PathMakeUniqueName [SHELL32.47]
513 BOOL WINAPI
PathMakeUniqueNameAW(
516 LPCVOID lpszShortName
,
517 LPCVOID lpszLongName
,
518 LPCVOID lpszPathName
)
520 if (SHELL_OsIsUnicode())
521 return PathMakeUniqueNameW(lpszBuffer
,dwBuffSize
, lpszShortName
,lpszLongName
,lpszPathName
);
522 return PathMakeUniqueNameA(lpszBuffer
,dwBuffSize
, lpszShortName
,lpszLongName
,lpszPathName
);
525 /*************************************************************************
526 * PathYetAnotherMakeUniqueName [SHELL32.75]
529 * exported by ordinal
531 BOOL WINAPI
PathYetAnotherMakeUniqueName(
533 LPCWSTR lpszPathName
,
534 LPCWSTR lpszShortName
,
535 LPCWSTR lpszLongName
)
537 FIXME("(%p, %s, %s ,%s):stub.\n",
538 lpszBuffer
, debugstr_w(lpszPathName
), debugstr_w(lpszShortName
), debugstr_w(lpszLongName
));
544 ########## cleaning and resolving paths ##########
547 /*************************************************************************
548 * PathFindOnPath [SHELL32.145]
550 BOOL WINAPI
PathFindOnPathAW(LPVOID sFile
, LPCVOID sOtherDirs
)
552 if (SHELL_OsIsUnicode())
553 return PathFindOnPathW(sFile
, (LPCWSTR
*)sOtherDirs
);
554 return PathFindOnPathA(sFile
, (LPCSTR
*)sOtherDirs
);
557 /*************************************************************************
558 * PathCleanupSpec [SHELL32.171]
560 DWORD WINAPI
PathCleanupSpecAW (LPCVOID x
, LPVOID y
)
562 FIXME("(%p, %p) stub\n",x
,y
);
566 /*************************************************************************
567 * PathQualifyA [SHELL32]
569 BOOL WINAPI
PathQualifyA(LPCSTR pszPath
)
571 FIXME("%s\n",pszPath
);
575 /*************************************************************************
576 * PathQualifyW [SHELL32]
578 BOOL WINAPI
PathQualifyW(LPCWSTR pszPath
)
580 FIXME("%s\n",debugstr_w(pszPath
));
584 /*************************************************************************
585 * PathQualify [SHELL32.49]
587 BOOL WINAPI
PathQualifyAW(LPCVOID pszPath
)
589 if (SHELL_OsIsUnicode())
590 return PathQualifyW(pszPath
);
591 return PathQualifyA(pszPath
);
594 /*************************************************************************
595 * PathResolveA [SHELL32.51]
597 BOOL WINAPI
PathResolveA(
602 FIXME("(%s,%p,0x%08lx),stub!\n",
603 lpszPath
, *alpszPaths
, dwFlags
);
607 /*************************************************************************
608 * PathResolveW [SHELL32]
610 BOOL WINAPI
PathResolveW(
615 FIXME("(%s,%p,0x%08lx),stub!\n",
616 debugstr_w(lpszPath
), debugstr_w(*alpszPaths
), dwFlags
);
620 /*************************************************************************
621 * PathResolve [SHELL32.51]
623 BOOL WINAPI
PathResolveAW(
628 if (SHELL_OsIsUnicode())
629 return PathResolveW(lpszPath
, (LPCWSTR
*)alpszPaths
, dwFlags
);
630 return PathResolveA(lpszPath
, (LPCSTR
*)alpszPaths
, dwFlags
);
633 /*************************************************************************
634 * PathProcessCommandA [SHELL32.653]
636 HRESULT WINAPI
PathProcessCommandA (
642 FIXME("%s %p 0x%04lx 0x%04lx stub\n",
643 lpszPath
, lpszBuff
, dwBuffSize
, dwFlags
);
644 strcpy(lpszBuff
, lpszPath
);
648 /*************************************************************************
649 * PathProcessCommandW
651 HRESULT WINAPI
PathProcessCommandW (
657 FIXME("(%s, %p, 0x%04lx, 0x%04lx) stub\n",
658 debugstr_w(lpszPath
), lpszBuff
, dwBuffSize
, dwFlags
);
659 strcpyW(lpszBuff
, lpszPath
);
663 /*************************************************************************
664 * PathProcessCommand (SHELL32.653)
666 HRESULT WINAPI
PathProcessCommandAW (
672 if (SHELL_OsIsUnicode())
673 return PathProcessCommandW(lpszPath
, lpszBuff
, dwBuffSize
, dwFlags
);
674 return PathProcessCommandA(lpszPath
, lpszBuff
, dwBuffSize
, dwFlags
);
678 ########## special ##########
681 /*************************************************************************
682 * PathSetDlgItemPath (SHELL32.48)
684 VOID WINAPI
PathSetDlgItemPathAW(HWND hDlg
, int id
, LPCVOID pszPath
)
686 if (SHELL_OsIsUnicode())
687 PathSetDlgItemPathW(hDlg
, id
, pszPath
);
689 PathSetDlgItemPathA(hDlg
, id
, pszPath
);
692 /*************************************************************************
693 * SHGetFolderPathW [SHELL32.@]
695 * converts csidl to path
698 static const WCHAR szSHFolders
[] = {'S','o','f','t','w','a','r','e','\\','M','i','c','r','o','s','o','f','t','\\','W','i','n','d','o','w','s','\\','C','u','r','r','e','n','t','V','e','r','s','i','o','n','\\','E','x','p','l','o','r','e','r','\\','S','h','e','l','l',' ','F','o','l','d','e','r','s','\0'};
699 static const WCHAR szSHUserFolders
[] = {'S','o','f','t','w','a','r','e','\\','M','i','c','r','o','s','o','f','t','\\','W','i','n','d','o','w','s','\\','C','u','r','r','e','n','t','V','e','r','s','i','o','n','\\','E','x','p','l','o','r','e','r','\\','U','s','e','r',' ','S','h','e','l','l',' ','F','o','l','d','e','r','s','\0'};
700 static const WCHAR szSetup
[] = {'S','o','f','t','w','a','r','e','\\','M','i','c','r','o','s','o','f','t','\\','W','i','n','d','o','w','s','\\','C','u','r','r','e','n','t','V','e','r','s','i','o','n','\\','E','x','p','l','o','r','e','r','\\','S','e','t','u','p','\0'};
701 static const WCHAR szCurrentVersion
[] = {'S','o','f','t','w','a','r','e','\\','M','i','c','r','o','s','o','f','t','\\','W','i','n','d','o','w','s','\\','C','u','r','r','e','n','t','V','e','r','s','i','o','n','\0'};
708 LPCSTR szDefaultPath
; /* fallback string; sub dir of windows directory */
711 #define CSIDL_MYFLAG_SHFOLDER 1
712 #define CSIDL_MYFLAG_SETUP 2
713 #define CSIDL_MYFLAG_CURRVER 4
714 #define CSIDL_MYFLAG_RELATIVE 8
716 #define HKLM HKEY_LOCAL_MACHINE
717 #define HKCU HKEY_CURRENT_USER
718 #define HKEY_DISALLOWED (HKEY)0
719 #define HKEY_UNIMPLEMENTED (HKEY)1
720 #define HKEY_WINDOWSPATH (HKEY)2
721 #define HKEY_NONEXISTENT (HKEY)3
722 static const CSIDL_DATA CSIDL_Data
[] =
724 { /* CSIDL_DESKTOP */
729 { /* CSIDL_INTERNET */
734 { /* CSIDL_PROGRAMS */
739 { /* CSIDL_CONTROLS (.CPL files) */
744 { /* CSIDL_PRINTERS */
749 { /* CSIDL_PERSONAL */
754 { /* CSIDL_FAVORITES */
759 { /* CSIDL_STARTUP */
762 "Start Menu\\Programs\\StartUp"
774 { /* CSIDL_BITBUCKET - Recycle Bin */
779 { /* CSIDL_STARTMENU */
784 { /* CSIDL_MYDOCUMENTS */
785 0, HKEY_UNIMPLEMENTED
, /* FIXME */
789 { /* CSIDL_MYMUSIC */
792 "My Documents\\My Music"
794 { /* CSIDL_MYVIDEO */
797 "My Documents\\My Video"
804 { /* CSIDL_DESKTOPDIRECTORY */
814 { /* CSIDL_NETWORK */
819 { /* CSIDL_NETHOOD */
829 { /* CSIDL_TEMPLATES */
834 { /* CSIDL_COMMON_STARTMENU */
839 { /* CSIDL_COMMON_PROGRAMS */
844 { /* CSIDL_COMMON_STARTUP */
847 "All Users\\Start Menu\\Programs\\StartUp"
849 { /* CSIDL_COMMON_DESKTOPDIRECTORY */
854 { /* CSIDL_APPDATA */
859 { /* CSIDL_PRINTHOOD */
864 { /* CSIDL_LOCAL_APPDATA (win2k only/undocumented) */
867 "Local Settings\\Application Data",
869 { /* CSIDL_ALTSTARTUP */
874 { /* CSIDL_COMMON_ALTSTARTUP */
879 { /* CSIDL_COMMON_FAVORITES */
884 { /* CSIDL_INTERNET_CACHE (32) */
887 "Temporary Internet Files"
889 { /* CSIDL_COOKIES (33) */
894 { /* CSIDL_HISTORY (34) */
899 { /* CSIDL_COMMON_APPDATA */
902 "All Users\\Application Data"
904 { /* CSIDL_WINDOWS */
914 { /* CSIDL_PROGRAM_FILES */
919 { /* CSIDL_MYPICTURES */
922 "My Documents\\My Pictures"
924 { /* CSIDL_PROFILE */
926 "WinDir", /* correct ? */
929 { /* CSIDL_SYSTEMX86 */
934 { /* CSIDL_PROGRAM_FILESX86 */
939 { /* CSIDL_PROGRAM_FILES_COMMON */
942 "Program Files\\Common Files" /* ? */
944 { /* CSIDL_PROGRAM_FILES_COMMONX86 */
947 "Program Files\\Common Files" /* ? */
949 { /* CSIDL_COMMON_TEMPLATES */
952 /*"Documents and Settings\\"*/"All Users\\Templates"
954 { /* CSIDL_COMMON_DOCUMENTS */
957 /*"Documents and Settings\\"*/"All Users\\Documents"
959 { /* CSIDL_COMMON_ADMINTOOLS */
961 "Common Administrative Tools",
962 /*"Documents and Settings\\"*/"All Users\\Start Menu\\Programs\\Administrative Tools"
964 { /* CSIDL_ADMINTOOLS */
966 "Administrative Tools",
967 "Start Menu\\Programs\\Administrative Tools"
969 { /* CSIDL_CONNECTIONS */
974 { /* unassigned 32 */
979 { /* unassigned 33 */
984 { /* unassigned 34 */
989 { /* CSIDL_COMMON_MUSIC */
992 /*"Documents and Settings\\"*/"All Users\\Documents\\My Music"
994 { /* CSIDL_COMMON_PICTURES */
997 /*"Documents and Settings\\"*/"All Users\\Documents\\My Pictures"
999 { /* CSIDL_COMMON_VIDEO */
1002 /*"Documents and Settings\\"*/"All Users\\Documents\\My Video"
1004 { /* CSIDL_RESOURCES */
1005 0, HKEY_WINDOWSPATH
,
1009 { /* CSIDL_RESOURCES_LOCALIZED */
1014 { /* CSIDL_COMMON_OEM_LINKS */
1019 { /* CSIDL_CDBURN_AREA */
1022 "Local Settings\\Application Data\\Microsoft\\CD Burning"
1024 { /* unassigned 3C */
1029 { /* CSIDL_COMPUTERSNEARME */
1034 { /* CSIDL_PROFILES */
1043 /**********************************************************************/
1045 HRESULT WINAPI
SHGetFolderPathW(
1048 HANDLE hToken
, /* [in] FIXME: get paths for specific user */
1049 DWORD dwFlags
, /* [in] FIXME: SHGFP_TYPE_CURRENT|SHGFP_TYPE_DEFAULT */
1052 WCHAR szValueName
[MAX_PATH
], szDefaultPath
[MAX_PATH
], szBuildPath
[MAX_PATH
];
1053 HKEY hRootKey
, hKey
;
1055 DWORD dwType
, dwDisp
, dwPathLen
= MAX_PATH
;
1056 DWORD folder
= csidl
& CSIDL_FOLDER_MASK
;
1059 TRACE("%p,%p,csidl=0x%04x\n", hwndOwner
,pszPath
,csidl
);
1062 return E_INVALIDARG
;
1065 if ((folder
>= sizeof(CSIDL_Data
) / sizeof(CSIDL_Data
[0])) ||
1066 (CSIDL_Data
[folder
].hRootKey
== HKEY_DISALLOWED
))
1067 return E_INVALIDARG
;
1068 if (CSIDL_Data
[folder
].hRootKey
== HKEY_UNIMPLEMENTED
)
1070 FIXME("folder 0x%04lx unknown, please add.\n", folder
);
1073 if (CSIDL_Data
[folder
].hRootKey
== HKEY_NONEXISTENT
)
1076 /* Special case for some values that don't exist in registry */
1077 if (CSIDL_Data
[folder
].hRootKey
== HKEY_WINDOWSPATH
)
1079 GetWindowsDirectoryW(pszPath
, MAX_PATH
);
1080 PathAddBackslashW(pszPath
);
1081 strcatW(pszPath
, szDefaultPath
);
1085 dwCsidlFlags
= CSIDL_Data
[folder
].dwFlags
;
1086 hRootKey
= CSIDL_Data
[folder
].hRootKey
;
1087 MultiByteToWideChar(CP_ACP
, 0, CSIDL_Data
[folder
].szValueName
, -1, szValueName
, MAX_PATH
);
1088 MultiByteToWideChar(CP_ACP
, 0, CSIDL_Data
[folder
].szDefaultPath
, -1, szDefaultPath
, MAX_PATH
);
1090 if (dwCsidlFlags
& CSIDL_MYFLAG_SHFOLDER
)
1092 /* user shell folders */
1093 if (RegCreateKeyExW(hRootKey
,szSHUserFolders
,0,NULL
,0,KEY_ALL_ACCESS
,NULL
,&hKey
,&dwDisp
)) return E_FAIL
;
1095 if (RegQueryValueExW(hKey
,szValueName
,NULL
,&dwType
,(LPBYTE
)pszPath
,&dwPathLen
))
1100 if (RegCreateKeyExW(hRootKey
,szSHFolders
,0,NULL
,0,KEY_ALL_ACCESS
,NULL
,&hKey
,&dwDisp
)) return E_FAIL
;
1102 if (RegQueryValueExW(hKey
,szValueName
,NULL
,&dwType
,(LPBYTE
)pszPath
,&dwPathLen
))
1104 /* value not existing */
1105 if (dwCsidlFlags
& CSIDL_MYFLAG_RELATIVE
)
1107 GetWindowsDirectoryW(pszPath
, MAX_PATH
);
1108 PathAddBackslashW(pszPath
);
1109 strcatW(pszPath
, szDefaultPath
);
1113 GetSystemDirectoryW(pszPath
, MAX_PATH
);
1114 strcpyW(pszPath
+ 3, szDefaultPath
);
1117 RegSetValueExW(hKey
,szValueName
,0,REG_SZ
,(LPBYTE
)pszPath
,strlenW(pszPath
)+1);
1126 if (dwCsidlFlags
& CSIDL_MYFLAG_SETUP
)
1128 else if (dwCsidlFlags
& CSIDL_MYFLAG_CURRVER
)
1129 pRegPath
= szCurrentVersion
;
1132 ERR("folder settings broken, please correct !\n");
1136 if (RegCreateKeyExW(hRootKey
,pRegPath
,0,NULL
,0,KEY_ALL_ACCESS
,NULL
,&hKey
,&dwDisp
)) return E_FAIL
;
1138 if (RegQueryValueExW(hKey
,szValueName
,NULL
,&dwType
,(LPBYTE
)pszPath
,&dwPathLen
))
1140 /* value not existing */
1141 if (dwCsidlFlags
& CSIDL_MYFLAG_RELATIVE
)
1143 GetWindowsDirectoryW(pszPath
, MAX_PATH
);
1144 PathAddBackslashW(pszPath
);
1145 strcatW(pszPath
, szDefaultPath
);
1149 GetSystemDirectoryW(pszPath
, MAX_PATH
);
1150 strcpyW(pszPath
+ 3, szDefaultPath
);
1153 RegSetValueExW(hKey
,szValueName
,0,REG_SZ
,(LPBYTE
)pszPath
,strlenW(pszPath
)+1);
1158 /* expand paths like %USERPROFILE% */
1159 if (dwType
== REG_EXPAND_SZ
)
1161 ExpandEnvironmentStringsW(pszPath
, szDefaultPath
, MAX_PATH
);
1162 strcpyW(pszPath
, szDefaultPath
);
1165 /* if we don't care about existing directories we are ready */
1166 if(csidl
& CSIDL_FLAG_DONT_VERIFY
) return S_OK
;
1168 if (PathFileExistsW(pszPath
)) return S_OK
;
1170 /* not existing but we are not allowed to create it */
1171 if (!(csidl
& CSIDL_FLAG_CREATE
)) return E_FAIL
;
1173 /* create directory/directories */
1174 strcpyW(szBuildPath
, pszPath
);
1175 p
= strchrW(szBuildPath
, '\\');
1179 if (!PathFileExistsW(szBuildPath
))
1181 if (!CreateDirectoryW(szBuildPath
,NULL
))
1183 ERR("Failed to create directory '%s'.\n", debugstr_w(pszPath
));
1188 p
= strchrW(p
+1, '\\');
1190 /* last component must be created too. */
1191 if (!PathFileExistsW(szBuildPath
))
1193 if (!CreateDirectoryW(szBuildPath
,NULL
))
1195 ERR("Failed to create directory '%s'.\n", debugstr_w(pszPath
));
1200 TRACE("Created missing system directory '%s'\n", debugstr_w(pszPath
));
1204 /*************************************************************************
1205 * SHGetFolderPathA [SHELL32.@]
1207 HRESULT WINAPI
SHGetFolderPathA(
1214 WCHAR szTemp
[MAX_PATH
];
1218 return E_INVALIDARG
;
1221 hr
= SHGetFolderPathW(hwndOwner
, csidl
, hToken
, dwFlags
, szTemp
);
1223 WideCharToMultiByte(CP_ACP
, 0, szTemp
, -1, pszPath
, MAX_PATH
, NULL
,
1226 TRACE("%p,%p,csidl=0x%04x\n",hwndOwner
,pszPath
,csidl
);
1231 /*************************************************************************
1232 * SHGetSpecialFolderPathA [SHELL32.@]
1234 BOOL WINAPI
SHGetSpecialFolderPathA (
1240 return (SHGetFolderPathA(
1242 csidl
+ (bCreate
? CSIDL_FLAG_CREATE
: 0),
1245 szPath
)) == S_OK
? TRUE
: FALSE
;
1248 /*************************************************************************
1249 * SHGetSpecialFolderPathW
1251 BOOL WINAPI
SHGetSpecialFolderPathW (
1257 return (SHGetFolderPathW(
1259 csidl
+ (bCreate
? CSIDL_FLAG_CREATE
: 0),
1262 szPath
)) == S_OK
? TRUE
: FALSE
;
1265 /*************************************************************************
1266 * SHGetSpecialFolderPath (SHELL32.175)
1268 BOOL WINAPI
SHGetSpecialFolderPathAW (
1275 if (SHELL_OsIsUnicode())
1276 return SHGetSpecialFolderPathW (hwndOwner
, szPath
, csidl
, bCreate
);
1277 return SHGetSpecialFolderPathA (hwndOwner
, szPath
, csidl
, bCreate
);
1280 /*************************************************************************
1281 * SHGetSpecialFolderLocation [SHELL32.@]
1283 * gets the folder locations from the registry and creates a pidl
1284 * creates missing reg keys and directories
1288 * nFolder [I] CSIDL_xxxxx
1289 * ppidl [O] PIDL of a special folder
1292 * In NT5, SHGetSpecialFolderLocation needs the <winntdir>/Recent
1293 * directory. If the directory is missing it returns a x80070002.
1294 * In most cases, this forwards to SHGetSpecialFolderPath, but
1295 * CSIDLs with virtual folders (not real paths) must be handled
1298 HRESULT WINAPI
SHGetSpecialFolderLocation(
1301 LPITEMIDLIST
* ppidl
)
1303 HRESULT hr
= E_INVALIDARG
;
1305 TRACE("(%p,0x%x,%p)\n", hwndOwner
,nFolder
,ppidl
);
1308 return E_INVALIDARG
;
1314 *ppidl
= _ILCreateDesktop();
1317 case CSIDL_INTERNET
:
1318 *ppidl
= _ILCreateIExplore();
1321 case CSIDL_CONTROLS
:
1322 *ppidl
= _ILCreateControlPanel();
1326 FIXME("virtual font folder");
1329 case CSIDL_PRINTERS
:
1330 *ppidl
= _ILCreatePrinters();
1333 case CSIDL_BITBUCKET
:
1334 *ppidl
= _ILCreateBitBucket();
1338 *ppidl
= _ILCreateMyComputer();
1342 *ppidl
= _ILCreateNetwork();
1345 case CSIDL_ALTSTARTUP
:
1346 case CSIDL_COMMON_ALTSTARTUP
:
1350 case CSIDL_COMPUTERSNEARME
:
1356 WCHAR szPath
[MAX_PATH
];
1358 if (SHGetSpecialFolderPathW(hwndOwner
, szPath
, nFolder
, TRUE
))
1362 TRACE("Value=%s\n", debugstr_w(szPath
));
1363 hr
= SHILCreateFromPathW(szPath
, ppidl
, &attributes
);
1370 TRACE("-- (new pidl %p)\n",*ppidl
);
1374 /*************************************************************************
1375 * SHGetFolderLocation [SHELL32.@]
1378 * the pidl can be a simple one. since we can't get the path out of the pidl
1379 * we have to take all data from the pidl
1380 * Mostly we forward to SHGetSpecialFolderLocation, but a few special cases
1383 HRESULT WINAPI
SHGetFolderLocation(
1388 LPITEMIDLIST
*ppidl
)
1392 TRACE_(shell
)("%p 0x%08x %p 0x%08lx %p\n",
1393 hwnd
, csidl
, hToken
, dwFlags
, ppidl
);
1396 return E_INVALIDARG
;
1400 case CSIDL_ALTSTARTUP
:
1401 case CSIDL_COMMON_ALTSTARTUP
:
1406 hr
= SHGetSpecialFolderLocation(hwnd
, csidl
, ppidl
);