Use INVALID_FILE_ATTRIBUTES to test for failure of
[wine/gsoc_dplay.git] / dlls / shell32 / shellpath.c
blobb1e726ce220a3a1168dae3d93804f2064cc8b9c4
1 /*
2 * Path Functions
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
20 * NOTES:
22 * Many of these functions are in SHLWAPI.DLL also
26 #include "config.h"
27 #include "wine/port.h"
29 #include <stdarg.h>
30 #include <string.h>
31 #include <ctype.h>
32 #include "wine/debug.h"
33 #include "windef.h"
34 #include "winbase.h"
35 #include "winnls.h"
36 #include "winreg.h"
37 #include "wingdi.h"
38 #include "winuser.h"
40 #include "shlobj.h"
41 #include "shell32_main.h"
42 #include "undocshell.h"
43 #include "wine/unicode.h"
44 #include "shlwapi.h"
46 WINE_DEFAULT_DEBUG_CHANNEL(shell);
49 ########## Combining and Constructing paths ##########
52 /*************************************************************************
53 * PathAppend [SHELL32.36]
55 BOOL WINAPI PathAppendAW(
56 LPVOID lpszPath1,
57 LPCVOID lpszPath2)
59 if (SHELL_OsIsUnicode())
60 return PathAppendW(lpszPath1, lpszPath2);
61 return PathAppendA(lpszPath1, lpszPath2);
64 /*************************************************************************
65 * PathCombine [SHELL32.37]
67 LPVOID WINAPI PathCombineAW(
68 LPVOID szDest,
69 LPCVOID lpszDir,
70 LPCVOID lpszFile)
72 if (SHELL_OsIsUnicode())
73 return PathCombineW( szDest, lpszDir, lpszFile );
74 return PathCombineA( szDest, lpszDir, lpszFile );
77 /*************************************************************************
78 * PathAddBackslash [SHELL32.32]
80 LPVOID WINAPI PathAddBackslashAW(LPVOID lpszPath)
82 if(SHELL_OsIsUnicode())
83 return PathAddBackslashW(lpszPath);
84 return PathAddBackslashA(lpszPath);
87 /*************************************************************************
88 * PathBuildRoot [SHELL32.30]
90 LPVOID WINAPI PathBuildRootAW(LPVOID lpszPath, int drive)
92 if(SHELL_OsIsUnicode())
93 return PathBuildRootW(lpszPath, drive);
94 return PathBuildRootA(lpszPath, drive);
98 Extracting Component Parts
101 /*************************************************************************
102 * PathFindFileName [SHELL32.34]
104 LPVOID WINAPI PathFindFileNameAW(LPCVOID lpszPath)
106 if(SHELL_OsIsUnicode())
107 return PathFindFileNameW(lpszPath);
108 return PathFindFileNameA(lpszPath);
111 /*************************************************************************
112 * PathFindExtension [SHELL32.31]
114 LPVOID WINAPI PathFindExtensionAW(LPCVOID lpszPath)
116 if (SHELL_OsIsUnicode())
117 return PathFindExtensionW(lpszPath);
118 return PathFindExtensionA(lpszPath);
122 /*************************************************************************
123 * PathGetExtensionA [internal]
125 * NOTES
126 * exported by ordinal
127 * return value points to the first char after the dot
129 static LPSTR PathGetExtensionA(LPCSTR lpszPath)
131 TRACE("(%s)\n",lpszPath);
133 lpszPath = PathFindExtensionA(lpszPath);
134 return (LPSTR)(*lpszPath?(lpszPath+1):lpszPath);
137 /*************************************************************************
138 * PathGetExtensionW [internal]
140 static LPWSTR PathGetExtensionW(LPCWSTR lpszPath)
142 TRACE("(%s)\n",debugstr_w(lpszPath));
144 lpszPath = PathFindExtensionW(lpszPath);
145 return (LPWSTR)(*lpszPath?(lpszPath+1):lpszPath);
148 /*************************************************************************
149 * PathGetExtension [SHELL32.158]
151 LPVOID WINAPI PathGetExtensionAW(LPCVOID lpszPath,DWORD void1, DWORD void2)
153 if (SHELL_OsIsUnicode())
154 return PathGetExtensionW(lpszPath);
155 return PathGetExtensionA(lpszPath);
158 /*************************************************************************
159 * PathGetArgs [SHELL32.52]
161 LPVOID WINAPI PathGetArgsAW(LPVOID lpszPath)
163 if (SHELL_OsIsUnicode())
164 return PathGetArgsW(lpszPath);
165 return PathGetArgsA(lpszPath);
168 /*************************************************************************
169 * PathGetDriveNumber [SHELL32.57]
171 int WINAPI PathGetDriveNumberAW(LPVOID lpszPath)
173 if (SHELL_OsIsUnicode())
174 return PathGetDriveNumberW(lpszPath);
175 return PathGetDriveNumberA(lpszPath);
178 /*************************************************************************
179 * PathRemoveFileSpec [SHELL32.35]
181 BOOL WINAPI PathRemoveFileSpecAW(LPVOID lpszPath)
183 if (SHELL_OsIsUnicode())
184 return PathRemoveFileSpecW(lpszPath);
185 return PathRemoveFileSpecA(lpszPath);
188 /*************************************************************************
189 * PathStripPath [SHELL32.38]
191 void WINAPI PathStripPathAW(LPVOID lpszPath)
193 if (SHELL_OsIsUnicode())
194 PathStripPathW(lpszPath);
195 else
196 PathStripPathA(lpszPath);
199 /*************************************************************************
200 * PathStripToRoot [SHELL32.50]
202 BOOL WINAPI PathStripToRootAW(LPVOID lpszPath)
204 if (SHELL_OsIsUnicode())
205 return PathStripToRootW(lpszPath);
206 return PathStripToRootA(lpszPath);
209 /*************************************************************************
210 * PathRemoveArgs [SHELL32.251]
212 void WINAPI PathRemoveArgsAW(LPVOID lpszPath)
214 if (SHELL_OsIsUnicode())
215 PathRemoveArgsW(lpszPath);
216 else
217 PathRemoveArgsA(lpszPath);
220 /*************************************************************************
221 * PathRemoveExtension [SHELL32.250]
223 void WINAPI PathRemoveExtensionAW(LPVOID lpszPath)
225 if (SHELL_OsIsUnicode())
226 PathRemoveExtensionW(lpszPath);
227 else
228 PathRemoveExtensionA(lpszPath);
233 Path Manipulations
236 /*************************************************************************
237 * PathGetShortPathA [internal]
239 LPSTR WINAPI PathGetShortPathA(LPSTR lpszPath)
241 FIXME("%s stub\n", lpszPath);
242 return NULL;
245 /*************************************************************************
246 * PathGetShortPathW [internal]
248 LPWSTR WINAPI PathGetShortPathW(LPWSTR lpszPath)
250 FIXME("%s stub\n", debugstr_w(lpszPath));
251 return NULL;
254 /*************************************************************************
255 * PathGetShortPath [SHELL32.92]
257 LPVOID WINAPI PathGetShortPathAW(LPVOID lpszPath)
259 if(SHELL_OsIsUnicode())
260 return PathGetShortPathW(lpszPath);
261 return PathGetShortPathA(lpszPath);
264 /*************************************************************************
265 * PathRemoveBlanks [SHELL32.33]
267 void WINAPI PathRemoveBlanksAW(LPVOID str)
269 if(SHELL_OsIsUnicode())
270 PathRemoveBlanksW(str);
271 else
272 PathRemoveBlanksA(str);
275 /*************************************************************************
276 * PathQuoteSpaces [SHELL32.55]
278 VOID WINAPI PathQuoteSpacesAW (LPVOID lpszPath)
280 if(SHELL_OsIsUnicode())
281 PathQuoteSpacesW(lpszPath);
282 else
283 PathQuoteSpacesA(lpszPath);
286 /*************************************************************************
287 * PathUnquoteSpaces [SHELL32.56]
289 VOID WINAPI PathUnquoteSpacesAW(LPVOID str)
291 if(SHELL_OsIsUnicode())
292 PathUnquoteSpacesW(str);
293 else
294 PathUnquoteSpacesA(str);
297 /*************************************************************************
298 * PathParseIconLocation [SHELL32.249]
300 int WINAPI PathParseIconLocationAW (LPVOID lpszPath)
302 if(SHELL_OsIsUnicode())
303 return PathParseIconLocationW(lpszPath);
304 return PathParseIconLocationA(lpszPath);
308 ########## Path Testing ##########
310 /*************************************************************************
311 * PathIsUNC [SHELL32.39]
313 BOOL WINAPI PathIsUNCAW (LPCVOID lpszPath)
315 if (SHELL_OsIsUnicode())
316 return PathIsUNCW( lpszPath );
317 return PathIsUNCA( lpszPath );
320 /*************************************************************************
321 * PathIsRelative [SHELL32.40]
323 BOOL WINAPI PathIsRelativeAW (LPCVOID lpszPath)
325 if (SHELL_OsIsUnicode())
326 return PathIsRelativeW( lpszPath );
327 return PathIsRelativeA( lpszPath );
330 /*************************************************************************
331 * PathIsRoot [SHELL32.29]
333 BOOL WINAPI PathIsRootAW(LPCVOID lpszPath)
335 if (SHELL_OsIsUnicode())
336 return PathIsRootW(lpszPath);
337 return PathIsRootA(lpszPath);
340 /*************************************************************************
341 * PathIsExeA [internal]
343 static BOOL PathIsExeA (LPCSTR lpszPath)
345 LPCSTR lpszExtension = PathGetExtensionA(lpszPath);
346 int i;
347 static const char * const lpszExtensions[] =
348 {"exe", "com", "pif", "cmd", "bat", "scf", "scr", NULL };
350 TRACE("path=%s\n",lpszPath);
352 for(i=0; lpszExtensions[i]; i++)
353 if (!strcasecmp(lpszExtension,lpszExtensions[i])) return TRUE;
355 return FALSE;
358 /*************************************************************************
359 * PathIsExeW [internal]
361 static BOOL PathIsExeW (LPCWSTR lpszPath)
363 LPCWSTR lpszExtension = PathGetExtensionW(lpszPath);
364 int i;
365 static const WCHAR lpszExtensions[][4] =
366 {{'e','x','e','\0'}, {'c','o','m','\0'}, {'p','i','f','\0'},
367 {'c','m','d','\0'}, {'b','a','t','\0'}, {'s','c','f','\0'},
368 {'s','c','r','\0'}, {'\0'} };
370 TRACE("path=%s\n",debugstr_w(lpszPath));
372 for(i=0; lpszExtensions[i][0]; i++)
373 if (!strcmpiW(lpszExtension,lpszExtensions[i])) return TRUE;
375 return FALSE;
378 /*************************************************************************
379 * PathIsExe [SHELL32.43]
381 BOOL WINAPI PathIsExeAW (LPCVOID path)
383 if (SHELL_OsIsUnicode())
384 return PathIsExeW (path);
385 return PathIsExeA(path);
388 /*************************************************************************
389 * PathIsDirectory [SHELL32.159]
391 BOOL WINAPI PathIsDirectoryAW (LPCVOID lpszPath)
393 if (SHELL_OsIsUnicode())
394 return PathIsDirectoryW (lpszPath);
395 return PathIsDirectoryA (lpszPath);
398 /*************************************************************************
399 * PathFileExists [SHELL32.45]
401 BOOL WINAPI PathFileExistsAW (LPCVOID lpszPath)
403 if (SHELL_OsIsUnicode())
404 return PathFileExistsW (lpszPath);
405 return PathFileExistsA (lpszPath);
408 /*************************************************************************
409 * PathMatchSpec [SHELL32.46]
411 BOOL WINAPI PathMatchSpecAW(LPVOID name, LPVOID mask)
413 if (SHELL_OsIsUnicode())
414 return PathMatchSpecW( name, mask );
415 return PathMatchSpecA( name, mask );
418 /*************************************************************************
419 * PathIsSameRoot [SHELL32.650]
421 BOOL WINAPI PathIsSameRootAW(LPCVOID lpszPath1, LPCVOID lpszPath2)
423 if (SHELL_OsIsUnicode())
424 return PathIsSameRootW(lpszPath1, lpszPath2);
425 return PathIsSameRootA(lpszPath1, lpszPath2);
428 /*************************************************************************
429 * IsLFNDriveA [SHELL32.41]
431 BOOL WINAPI IsLFNDriveA(LPCSTR lpszPath)
433 DWORD fnlen;
435 if (!GetVolumeInformationA(lpszPath, NULL, 0, NULL, &fnlen, NULL, NULL, 0))
436 return FALSE;
437 return fnlen > 12;
440 /*************************************************************************
441 * IsLFNDriveW [SHELL32.42]
443 BOOL WINAPI IsLFNDriveW(LPCWSTR lpszPath)
445 DWORD fnlen;
447 if (!GetVolumeInformationW(lpszPath, NULL, 0, NULL, &fnlen, NULL, NULL, 0))
448 return FALSE;
449 return fnlen > 12;
452 /*************************************************************************
453 * IsLFNDrive [SHELL32.119]
455 BOOL WINAPI IsLFNDriveAW(LPCVOID lpszPath)
457 if (SHELL_OsIsUnicode())
458 return IsLFNDriveW(lpszPath);
459 return IsLFNDriveA(lpszPath);
463 ########## Creating Something Unique ##########
465 /*************************************************************************
466 * PathMakeUniqueNameA [internal]
468 BOOL WINAPI PathMakeUniqueNameA(
469 LPSTR lpszBuffer,
470 DWORD dwBuffSize,
471 LPCSTR lpszShortName,
472 LPCSTR lpszLongName,
473 LPCSTR lpszPathName)
475 FIXME("%p %lu %s %s %s stub\n",
476 lpszBuffer, dwBuffSize, debugstr_a(lpszShortName),
477 debugstr_a(lpszLongName), debugstr_a(lpszPathName));
478 return TRUE;
481 /*************************************************************************
482 * PathMakeUniqueNameW [internal]
484 BOOL WINAPI PathMakeUniqueNameW(
485 LPWSTR lpszBuffer,
486 DWORD dwBuffSize,
487 LPCWSTR lpszShortName,
488 LPCWSTR lpszLongName,
489 LPCWSTR lpszPathName)
491 FIXME("%p %lu %s %s %s stub\n",
492 lpszBuffer, dwBuffSize, debugstr_w(lpszShortName),
493 debugstr_w(lpszLongName), debugstr_w(lpszPathName));
494 return TRUE;
497 /*************************************************************************
498 * PathMakeUniqueName [SHELL32.47]
500 BOOL WINAPI PathMakeUniqueNameAW(
501 LPVOID lpszBuffer,
502 DWORD dwBuffSize,
503 LPCVOID lpszShortName,
504 LPCVOID lpszLongName,
505 LPCVOID lpszPathName)
507 if (SHELL_OsIsUnicode())
508 return PathMakeUniqueNameW(lpszBuffer,dwBuffSize, lpszShortName,lpszLongName,lpszPathName);
509 return PathMakeUniqueNameA(lpszBuffer,dwBuffSize, lpszShortName,lpszLongName,lpszPathName);
512 /*************************************************************************
513 * PathYetAnotherMakeUniqueName [SHELL32.75]
515 * NOTES
516 * exported by ordinal
518 BOOL WINAPI PathYetAnotherMakeUniqueNameA(
519 LPSTR lpszBuffer,
520 LPCSTR lpszPathName,
521 LPCSTR lpszShortName,
522 LPCSTR lpszLongName)
524 FIXME("(%p,%p, %p ,%p):stub.\n",
525 lpszBuffer, lpszPathName, lpszShortName, lpszLongName);
526 return TRUE;
531 ########## cleaning and resolving paths ##########
534 /*************************************************************************
535 * PathFindOnPath [SHELL32.145]
537 BOOL WINAPI PathFindOnPathAW(LPVOID sFile, LPCVOID sOtherDirs)
539 if (SHELL_OsIsUnicode())
540 return PathFindOnPathW(sFile, (LPCWSTR *)sOtherDirs);
541 return PathFindOnPathA(sFile, (LPCSTR *)sOtherDirs);
544 /*************************************************************************
545 * PathCleanupSpec [SHELL32.171]
547 DWORD WINAPI PathCleanupSpecAW (LPCVOID x, LPVOID y)
549 FIXME("(%p, %p) stub\n",x,y);
550 return TRUE;
553 /*************************************************************************
554 * PathQualifyA [SHELL32]
556 BOOL WINAPI PathQualifyA(LPCSTR pszPath)
558 FIXME("%s\n",pszPath);
559 return 0;
562 /*************************************************************************
563 * PathQualifyW [SHELL32]
565 BOOL WINAPI PathQualifyW(LPCWSTR pszPath)
567 FIXME("%s\n",debugstr_w(pszPath));
568 return 0;
571 /*************************************************************************
572 * PathQualify [SHELL32.49]
574 BOOL WINAPI PathQualifyAW(LPCVOID pszPath)
576 if (SHELL_OsIsUnicode())
577 return PathQualifyW(pszPath);
578 return PathQualifyA(pszPath);
581 /*************************************************************************
582 * PathResolveA [SHELL32.51]
584 BOOL WINAPI PathResolveA(
585 LPSTR lpszPath,
586 LPCSTR *alpszPaths,
587 DWORD dwFlags)
589 FIXME("(%s,%p,0x%08lx),stub!\n",
590 lpszPath, *alpszPaths, dwFlags);
591 return 0;
594 /*************************************************************************
595 * PathResolveW [SHELL32]
597 BOOL WINAPI PathResolveW(
598 LPWSTR lpszPath,
599 LPCWSTR *alpszPaths,
600 DWORD dwFlags)
602 FIXME("(%s,%p,0x%08lx),stub!\n",
603 debugstr_w(lpszPath), debugstr_w(*alpszPaths), dwFlags);
604 return 0;
607 /*************************************************************************
608 * PathResolve [SHELL32.51]
610 BOOL WINAPI PathResolveAW(
611 LPVOID lpszPath,
612 LPCVOID *alpszPaths,
613 DWORD dwFlags)
615 if (SHELL_OsIsUnicode())
616 return PathResolveW(lpszPath, (LPCWSTR*)alpszPaths, dwFlags);
617 return PathResolveA(lpszPath, (LPCSTR*)alpszPaths, dwFlags);
620 /*************************************************************************
621 * PathProcessCommandA [SHELL32.653]
623 HRESULT WINAPI PathProcessCommandA (
624 LPCSTR lpszPath,
625 LPSTR lpszBuff,
626 DWORD dwBuffSize,
627 DWORD dwFlags)
629 FIXME("%s %p 0x%04lx 0x%04lx stub\n",
630 lpszPath, lpszBuff, dwBuffSize, dwFlags);
631 strcpy(lpszBuff, lpszPath);
632 return 0;
635 /*************************************************************************
636 * PathProcessCommandW
638 HRESULT WINAPI PathProcessCommandW (
639 LPCWSTR lpszPath,
640 LPWSTR lpszBuff,
641 DWORD dwBuffSize,
642 DWORD dwFlags)
644 FIXME("(%s, %p, 0x%04lx, 0x%04lx) stub\n",
645 debugstr_w(lpszPath), lpszBuff, dwBuffSize, dwFlags);
646 strcpyW(lpszBuff, lpszPath);
647 return 0;
650 /*************************************************************************
651 * PathProcessCommand (SHELL32.653)
653 HRESULT WINAPI PathProcessCommandAW (
654 LPCVOID lpszPath,
655 LPVOID lpszBuff,
656 DWORD dwBuffSize,
657 DWORD dwFlags)
659 if (SHELL_OsIsUnicode())
660 return PathProcessCommandW(lpszPath, lpszBuff, dwBuffSize, dwFlags);
661 return PathProcessCommandA(lpszPath, lpszBuff, dwBuffSize, dwFlags);
665 ########## special ##########
668 /*************************************************************************
669 * PathSetDlgItemPath (SHELL32.48)
671 VOID WINAPI PathSetDlgItemPathAW(HWND hDlg, int id, LPCVOID pszPath)
673 if (SHELL_OsIsUnicode())
674 PathSetDlgItemPathW(hDlg, id, pszPath);
675 else
676 PathSetDlgItemPathA(hDlg, id, pszPath);
680 /*************************************************************************
681 * SHGetSpecialFolderPathA [SHELL32.@]
683 * converts csidl to path
686 static const char * const szSHFolders = "Software\\Microsoft\\Windows\\CurrentVersion\\Explorer\\Shell Folders";
687 static const char * const szSHUserFolders = "Software\\Microsoft\\Windows\\CurrentVersion\\Explorer\\User Shell Folders";
688 static const char * const szSetup = "Software\\Microsoft\\Windows\\CurrentVersion\\Setup";
689 static const char * const szCurrentVersion = "Software\\Microsoft\\Windows\\CurrentVersion";
690 #if 0
691 static const char * const szEnvUserProfile = "%USERPROFILE%";
692 static const char * const szEnvSystemRoot = "%SYSTEMROOT%";
693 #endif
695 typedef struct
697 DWORD dwFlags;
698 HKEY hRootKey;
699 LPCSTR szValueName;
700 LPCSTR szDefaultPath; /* fallback string; sub dir of windows directory */
701 } CSIDL_DATA;
703 #define CSIDL_MYFLAG_SHFOLDER 1
704 #define CSIDL_MYFLAG_SETUP 2
705 #define CSIDL_MYFLAG_CURRVER 4
706 #define CSIDL_MYFLAG_RELATIVE 8
708 #define HKLM HKEY_LOCAL_MACHINE
709 #define HKCU HKEY_CURRENT_USER
710 static const CSIDL_DATA CSIDL_Data[] =
712 { /* CSIDL_DESKTOP */
713 9, HKCU,
714 "Desktop",
715 "Desktop"
717 { /* CSIDL_INTERNET */
718 0, (HKEY)1, /* FIXME */
719 NULL,
720 NULL,
722 { /* CSIDL_PROGRAMS */
723 9, HKCU,
724 "Programs",
725 "Start Menu\\Programs"
727 { /* CSIDL_CONTROLS (.CPL files) */
728 10, HKLM,
729 "SysDir",
730 "SYSTEM"
732 { /* CSIDL_PRINTERS */
733 10, HKLM,
734 "SysDir",
735 "SYSTEM"
737 { /* CSIDL_PERSONAL */
738 1, HKCU,
739 "Personal",
740 "My Documents"
742 { /* CSIDL_FAVORITES */
743 9, HKCU,
744 "Favorites",
745 "Favorites"
747 { /* CSIDL_STARTUP */
748 9, HKCU,
749 "StartUp",
750 "Start Menu\\Programs\\StartUp"
752 { /* CSIDL_RECENT */
753 9, HKCU,
754 "Recent",
755 "Recent"
757 { /* CSIDL_SENDTO */
758 9, HKCU,
759 "SendTo",
760 "SendTo"
762 { /* CSIDL_BITBUCKET (is this c:\recycled ?) */
763 0, (HKEY)1, /* FIXME */
764 NULL,
765 "recycled"
767 { /* CSIDL_STARTMENU */
768 9, HKCU,
769 "Start Menu",
770 "Start Menu"
772 { /* CSIDL_MYDOCUMENTS */
773 0, (HKEY)1, /* FIXME */
774 NULL,
775 NULL,
777 { /* CSIDL_MYMUSIC */
778 0, (HKEY)1, /* FIXME */
779 NULL,
780 NULL,
782 { /* CSIDL_MYVIDEO */
783 0, (HKEY)1, /* FIXME */
784 NULL,
785 NULL,
787 { /* unassigned */
788 0, 0,
789 NULL,
790 NULL,
792 { /* CSIDL_DESKTOPDIRECTORY */
793 9, HKCU,
794 "Desktop",
795 "Desktop"
797 { /* CSIDL_DRIVES */
798 0, (HKEY)1, /* FIXME */
799 NULL,
800 "My Computer"
802 { /* CSIDL_NETWORK */
803 0, (HKEY)1, /* FIXME */
804 NULL,
805 "Network Neighborhood"
807 { /* CSIDL_NETHOOD */
808 9, HKCU,
809 "NetHood",
810 "NetHood"
812 { /* CSIDL_FONTS */
813 9, HKCU,
814 "Fonts",
815 "Fonts"
817 { /* CSIDL_TEMPLATES */
818 9, HKCU,
819 "Templates",
820 "ShellNew"
822 { /* CSIDL_COMMON_STARTMENU */
823 9, HKLM,
824 "Common Start Menu",
825 "Start Menu"
827 { /* CSIDL_COMMON_PROGRAMS */
828 9, HKLM,
829 "Common Programs",
832 { /* CSIDL_COMMON_STARTUP */
833 9, HKLM,
834 "Common StartUp",
835 "All Users\\Start Menu\\Programs\\StartUp"
837 { /* CSIDL_COMMON_DESKTOPDIRECTORY */
838 9, HKLM,
839 "Common Desktop",
840 "Desktop"
842 { /* CSIDL_APPDATA */
843 9, HKCU,
844 "AppData",
845 "Application Data"
847 { /* CSIDL_PRINTHOOD */
848 9, HKCU,
849 "PrintHood",
850 "PrintHood"
852 { /* CSIDL_LOCAL_APPDATA (win2k only/undocumented) */
853 1, HKCU,
854 "Local AppData",
855 "Local Settings\\Application Data",
857 { /* CSIDL_ALTSTARTUP */
858 0, (HKEY)1, /* FIXME */
859 NULL,
860 NULL
862 { /* CSIDL_COMMON_ALTSTARTUP */
863 0, (HKEY)1, /* FIXME */
864 NULL,
865 NULL
867 { /* CSIDL_COMMON_FAVORITES */
868 9, HKCU,
869 "Favorites",
870 "Favorites"
872 { /* CSIDL_INTERNET_CACHE */
873 9, HKCU,
874 "Cache",
875 "Temporary Internet Files"
877 { /* CSIDL_COOKIES */
878 9, HKCU,
879 "Cookies",
880 "Cookies"
882 { /* CSIDL_HISTORY */
883 9, HKCU,
884 "History",
885 "History"
887 { /* CSIDL_COMMON_APPDATA */
888 9, HKLM,
889 "Common AppData",
890 "All Users\\Application Data"
892 { /* CSIDL_WINDOWS */
893 2, HKLM,
894 "WinDir",
895 "Windows"
897 { /* CSIDL_SYSTEM */
898 10, HKLM,
899 "SysDir",
900 "SYSTEM"
902 { /* CSIDL_PROGRAM_FILES */
903 4, HKLM,
904 "ProgramFilesDir",
905 "Program Files"
907 { /* CSIDL_MYPICTURES */
908 1, HKCU,
909 "My Pictures",
910 "My Documents\\My Pictures"
912 { /* CSIDL_PROFILE */
913 10, HKLM,
914 "WinDir", /* correct ? */
917 { /* CSIDL_SYSTEMX86 */
918 10, HKLM,
919 "SysDir",
920 "SYSTEM"
922 { /* CSIDL_PROGRAM_FILESX86 */
923 4, HKLM,
924 "ProgramFilesDir",
925 "Program Files"
927 { /* CSIDL_PROGRAM_FILES_COMMON */
928 4, HKLM,
929 "CommonFilesDir",
930 "Program Files\\Common Files" /* ? */
932 { /* CSIDL_PROGRAM_FILES_COMMONX86 */
933 4, HKLM,
934 "CommonFilesDir",
935 "Program Files\\Common Files" /* ? */
937 { /* CSIDL_COMMON_TEMPLATES */
938 0, (HKEY)1, /* FIXME */
939 NULL,
940 NULL
942 { /* CSIDL_COMMON_DOCUMENTS */
943 0, (HKEY)1, /* FIXME */
944 NULL,
945 NULL
947 { /* CSIDL_COMMON_ADMINTOOLS */
948 0, (HKEY)1, /* FIXME */
949 NULL,
950 NULL
952 { /* CSIDL_ADMINTOOLS */
953 9, HKCU,
954 "Administrative Tools",
955 "Start Menu\\Programs\\Administrative Tools"
957 { /* CSIDL_CONNECTIONS */
958 0, (HKEY)1, /* FIXME */
959 NULL,
960 NULL
962 { /* unassigned 32*/
963 0, 0,
964 NULL,
965 NULL,
967 { /* unassigned 33*/
968 0, 0,
969 NULL,
970 NULL,
972 { /* unassigned 34*/
973 0, 0,
974 NULL,
975 NULL,
977 { /* CSIDL_COMMON_MUSIC */
978 0, 0, /* FIXME */
979 NULL,
980 NULL,
982 { /* CSIDL_COMMON_PICTURES */
983 0, 0, /* FIXME */
984 NULL,
985 NULL,
987 { /* CSIDL_COMMON_VIDEO */
988 0, 0, /* FIXME */
989 NULL,
990 NULL,
992 { /* CSIDL_RESOURCES */
993 0, 0, /* FIXME */
994 NULL,
995 NULL,
997 { /* CSIDL_RESOURCES_LOCALIZED */
998 0, 0, /* FIXME */
999 NULL,
1000 NULL,
1002 { /* CSIDL_COMMON_OEM_LINKS */
1003 0, 0, /* FIXME */
1004 NULL,
1005 NULL,
1007 { /* CSIDL_CDBURN_AREA */
1008 0, 0, /* FIXME */
1009 NULL,
1010 NULL,
1012 { /* unassigned 3C */
1013 0, 0,
1014 NULL,
1015 NULL,
1017 { /* CSIDL_COMPUTERSNEARME */
1018 0, 0, /* FIXME */
1019 NULL,
1020 NULL,
1022 { /* CSIDL_PROFILES */
1023 0, 0, /* FIXME */
1024 NULL,
1025 NULL,
1028 #undef HKCU
1029 #undef HKLM
1031 /**********************************************************************/
1033 BOOL WINAPI SHGetSpecialFolderPathA (
1034 HWND hwndOwner,
1035 LPSTR szPath,
1036 int csidl,
1037 BOOL bCreate)
1039 CHAR szValueName[MAX_PATH], szDefaultPath[MAX_PATH], szBuildPath[MAX_PATH];
1040 HKEY hRootKey, hKey;
1041 DWORD dwFlags;
1042 DWORD dwType, dwDisp, dwPathLen = MAX_PATH;
1043 DWORD folder = csidl & CSIDL_FOLDER_MASK;
1044 CHAR *p;
1046 TRACE("%p,%p,csidl=%d,0x%04x\n", hwndOwner,szPath,csidl,bCreate);
1048 if ((folder >= sizeof(CSIDL_Data) / sizeof(CSIDL_Data[0])) ||
1049 (CSIDL_Data[folder].hRootKey == 0))
1051 ERR("folder 0x%04lx unknown or not allowed\n", folder);
1052 return FALSE;
1054 if (CSIDL_Data[folder].hRootKey == (HKEY)1)
1056 FIXME("folder 0x%04lx unknown, please add.\n", folder);
1057 return FALSE;
1060 dwFlags = CSIDL_Data[folder].dwFlags;
1061 hRootKey = CSIDL_Data[folder].hRootKey;
1062 strcpy(szValueName, CSIDL_Data[folder].szValueName);
1063 strcpy(szDefaultPath, CSIDL_Data[folder].szDefaultPath);
1065 if (dwFlags & CSIDL_MYFLAG_SHFOLDER)
1067 /* user shell folders */
1068 if (RegCreateKeyExA(hRootKey,szSHUserFolders,0,NULL,0,KEY_ALL_ACCESS,NULL,&hKey,&dwDisp)) return FALSE;
1070 if (RegQueryValueExA(hKey,szValueName,NULL,&dwType,(LPBYTE)szPath,&dwPathLen))
1072 RegCloseKey(hKey);
1074 /* shell folders */
1075 if (RegCreateKeyExA(hRootKey,szSHFolders,0,NULL,0,KEY_ALL_ACCESS,NULL,&hKey,&dwDisp)) return FALSE;
1077 if (RegQueryValueExA(hKey,szValueName,NULL,&dwType,(LPBYTE)szPath,&dwPathLen))
1080 /* value not existing */
1081 if (dwFlags & CSIDL_MYFLAG_RELATIVE)
1083 GetWindowsDirectoryA(szPath, MAX_PATH);
1084 PathAddBackslashA(szPath);
1085 strcat(szPath, szDefaultPath);
1087 else
1089 strcpy(szPath, "C:\\"); /* FIXME ??? */
1090 strcat(szPath, szDefaultPath);
1092 RegSetValueExA(hKey,szValueName,0,REG_SZ,(LPBYTE)szPath,strlen(szPath)+1);
1095 RegCloseKey(hKey);
1097 else
1099 LPCSTR pRegPath;
1101 if (dwFlags & CSIDL_MYFLAG_SETUP)
1102 pRegPath = szSetup;
1103 else
1104 if (dwFlags & CSIDL_MYFLAG_CURRVER)
1105 pRegPath = szCurrentVersion;
1106 else
1108 ERR("folder settings broken, please correct !\n");
1109 return FALSE;
1112 if (RegCreateKeyExA(hRootKey,pRegPath,0,NULL,0,KEY_ALL_ACCESS,NULL,&hKey,&dwDisp)) return FALSE;
1114 if (RegQueryValueExA(hKey,szValueName,NULL,&dwType,(LPBYTE)szPath,&dwPathLen))
1116 /* value not existing */
1117 if (dwFlags & CSIDL_MYFLAG_RELATIVE)
1119 GetWindowsDirectoryA(szPath, MAX_PATH);
1120 PathAddBackslashA(szPath);
1121 strcat(szPath, szDefaultPath);
1123 else
1125 strcpy(szPath, "C:\\"); /* FIXME ??? */
1126 strcat(szPath, szDefaultPath);
1128 RegSetValueExA(hKey,szValueName,0,REG_SZ,(LPBYTE)szPath,strlen(szPath)+1);
1130 RegCloseKey(hKey);
1133 /* expand paths like %USERPROFILE% */
1134 if (dwType == REG_EXPAND_SZ)
1136 ExpandEnvironmentStringsA(szPath, szDefaultPath, MAX_PATH);
1137 strcpy(szPath, szDefaultPath);
1140 /* if we don't care about existing directories we are ready */
1141 if(csidl & CSIDL_FLAG_DONT_VERIFY) return TRUE;
1143 if (PathFileExistsA(szPath)) return TRUE;
1145 /* not existing but we are not allowed to create it */
1146 if (!bCreate) return FALSE;
1148 /* create directory/directories */
1149 strcpy(szBuildPath, szPath);
1150 p = strchr(szBuildPath, '\\');
1151 while (p)
1153 *p = 0;
1154 if (!PathFileExistsA(szBuildPath))
1156 if (!CreateDirectoryA(szBuildPath,NULL))
1158 ERR("Failed to create directory '%s'.\n", szPath);
1159 return FALSE;
1162 *p = '\\';
1163 p = strchr(p+1, '\\');
1165 /* last component must be created too. */
1166 if (!PathFileExistsA(szBuildPath))
1168 if (!CreateDirectoryA(szBuildPath,NULL))
1170 ERR("Failed to create directory '%s'.\n", szPath);
1171 return FALSE;
1175 TRACE("Created missing system directory '%s'\n", szPath);
1176 return TRUE;
1179 /*************************************************************************
1180 * SHGetSpecialFolderPathW
1182 BOOL WINAPI SHGetSpecialFolderPathW (
1183 HWND hwndOwner,
1184 LPWSTR szPath,
1185 int csidl,
1186 BOOL bCreate)
1188 char szTemp[MAX_PATH];
1190 if (SHGetSpecialFolderPathA(hwndOwner, szTemp, csidl, bCreate))
1192 if (!MultiByteToWideChar( CP_ACP, 0, szTemp, -1, szPath, MAX_PATH ))
1193 szPath[MAX_PATH-1] = 0;
1196 TRACE("%p,%p,csidl=%d,0x%04x\n", hwndOwner,szPath,csidl,bCreate);
1198 return TRUE;
1201 /*************************************************************************
1202 * SHGetSpecialFolderPath (SHELL32.175)
1204 BOOL WINAPI SHGetSpecialFolderPathAW (
1205 HWND hwndOwner,
1206 LPVOID szPath,
1207 int csidl,
1208 BOOL bCreate)
1211 if (SHELL_OsIsUnicode())
1212 return SHGetSpecialFolderPathW (hwndOwner, szPath, csidl, bCreate);
1213 return SHGetSpecialFolderPathA (hwndOwner, szPath, csidl, bCreate);
1216 /*************************************************************************
1217 * SHGetFolderPathA [SHELL32.@]
1219 HRESULT WINAPI SHGetFolderPathA(
1220 HWND hwndOwner,
1221 int nFolder,
1222 HANDLE hToken, /* [in] FIXME: get paths for specific user */
1223 DWORD dwFlags, /* [in] FIXME: SHGFP_TYPE_CURRENT|SHGFP_TYPE_DEFAULT */
1224 LPSTR pszPath)
1226 return (SHGetSpecialFolderPathA(
1227 hwndOwner,
1228 pszPath,
1229 CSIDL_FOLDER_MASK & nFolder,
1230 CSIDL_FLAG_CREATE & nFolder )) ? S_OK : E_FAIL;
1233 /*************************************************************************
1234 * SHGetFolderPathW [SHELL32.@]
1236 HRESULT WINAPI SHGetFolderPathW(
1237 HWND hwndOwner,
1238 int nFolder,
1239 HANDLE hToken,
1240 DWORD dwFlags,
1241 LPWSTR pszPath)
1243 return (SHGetSpecialFolderPathW(
1244 hwndOwner,
1245 pszPath,
1246 CSIDL_FOLDER_MASK & nFolder,
1247 CSIDL_FLAG_CREATE & nFolder )) ? S_OK : E_FAIL;