ddraw: Double buffered primary surfaces can only be created in EXLUSIVE mode.
[wine.git] / dlls / shlwapi / path.c
blob32e7b74d6906daae0189eb0e4fae5ad9be0c506f
1 /*
2 * Path Functions
4 * Copyright 1999, 2000 Juergen Schmied
5 * Copyright 2001, 2002 Jon Griffiths
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with this library; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
22 #include "config.h"
23 #include "wine/port.h"
25 #include <stdarg.h>
26 #include <string.h>
27 #include <stdlib.h>
29 #include "wine/unicode.h"
30 #include "windef.h"
31 #include "winbase.h"
32 #include "wingdi.h"
33 #include "winuser.h"
34 #include "winreg.h"
35 #include "winternl.h"
36 #define NO_SHLWAPI_STREAM
37 #include "shlwapi.h"
38 #include "wine/debug.h"
40 WINE_DEFAULT_DEBUG_CHANNEL(shell);
42 /* Get a function pointer from a DLL handle */
43 #define GET_FUNC(func, module, name, fail) \
44 do { \
45 if (!func) { \
46 if (!SHLWAPI_h##module && !(SHLWAPI_h##module = LoadLibraryA(#module ".dll"))) return fail; \
47 func = (fn##func)GetProcAddress(SHLWAPI_h##module, name); \
48 if (!func) return fail; \
49 } \
50 } while (0)
52 /* DLL handles for late bound calls */
53 extern HMODULE SHLWAPI_hshell32;
55 /* Function pointers for GET_FUNC macro; these need to be global because of gcc bug */
56 typedef BOOL (WINAPI *fnpIsNetDrive)(int);
57 static fnpIsNetDrive pIsNetDrive;
59 HRESULT WINAPI SHGetWebFolderFilePathW(LPCWSTR,LPWSTR,DWORD);
61 /*************************************************************************
62 * PathAppendA [SHLWAPI.@]
64 * Append one path to another.
66 * PARAMS
67 * lpszPath [I/O] Initial part of path, and destination for output
68 * lpszAppend [I] Path to append
70 * RETURNS
71 * Success: TRUE. lpszPath contains the newly created path.
72 * Failure: FALSE, if either path is NULL, or PathCombineA() fails.
74 * NOTES
75 * lpszAppend must contain at least one backslash ('\') if not NULL.
76 * Because PathCombineA() is used to join the paths, the resulting
77 * path is also canonicalized.
79 BOOL WINAPI PathAppendA (LPSTR lpszPath, LPCSTR lpszAppend)
81 TRACE("(%s,%s)\n",debugstr_a(lpszPath), debugstr_a(lpszAppend));
83 if (lpszPath && lpszAppend)
85 if (!PathIsUNCA(lpszAppend))
86 while (*lpszAppend == '\\')
87 lpszAppend++;
88 if (PathCombineA(lpszPath, lpszPath, lpszAppend))
89 return TRUE;
91 return FALSE;
94 /*************************************************************************
95 * PathAppendW [SHLWAPI.@]
97 * See PathAppendA.
99 BOOL WINAPI PathAppendW(LPWSTR lpszPath, LPCWSTR lpszAppend)
101 TRACE("(%s,%s)\n",debugstr_w(lpszPath), debugstr_w(lpszAppend));
103 if (lpszPath && lpszAppend)
105 if (!PathIsUNCW(lpszAppend))
106 while (*lpszAppend == '\\')
107 lpszAppend++;
108 if (PathCombineW(lpszPath, lpszPath, lpszAppend))
109 return TRUE;
111 return FALSE;
114 /*************************************************************************
115 * PathCombineA [SHLWAPI.@]
117 * Combine two paths together.
119 * PARAMS
120 * lpszDest [O] Destination for combined path
121 * lpszDir [I] Directory path
122 * lpszFile [I] File path
124 * RETURNS
125 * Success: The output path
126 * Failure: NULL, if inputs are invalid.
128 * NOTES
129 * lpszDest should be at least MAX_PATH in size, and may point to the same
130 * memory location as lpszDir. The combined path is canonicalised.
132 LPSTR WINAPI PathCombineA(LPSTR lpszDest, LPCSTR lpszDir, LPCSTR lpszFile)
134 TRACE("(%p,%s,%s)\n", lpszDest, debugstr_a(lpszDir), debugstr_a(lpszFile));
136 if (!lpszDest || (!lpszDir && !lpszFile))
137 return NULL; /* Invalid parameters */
138 else
140 WCHAR szDest[MAX_PATH];
141 WCHAR szDir[MAX_PATH];
142 WCHAR szFile[MAX_PATH];
143 if (lpszDir)
144 MultiByteToWideChar(CP_ACP,0,lpszDir,-1,szDir,MAX_PATH);
145 if (lpszFile)
146 MultiByteToWideChar(CP_ACP,0,lpszFile,-1,szFile,MAX_PATH);
147 PathCombineW(szDest, lpszDir ? szDir : NULL, lpszFile ? szFile : NULL);
148 WideCharToMultiByte(CP_ACP,0,szDest,-1,lpszDest,MAX_PATH,0,0);
150 return lpszDest;
153 /*************************************************************************
154 * PathCombineW [SHLWAPI.@]
156 * See PathCombineA.
158 LPWSTR WINAPI PathCombineW(LPWSTR lpszDest, LPCWSTR lpszDir, LPCWSTR lpszFile)
160 WCHAR szTemp[MAX_PATH];
161 BOOL bUseBoth = FALSE, bStrip = FALSE;
163 TRACE("(%p,%s,%s)\n", lpszDest, debugstr_w(lpszDir), debugstr_w(lpszFile));
165 if (!lpszDest || (!lpszDir && !lpszFile))
166 return NULL; /* Invalid parameters */
168 if ((!lpszFile || !*lpszFile) && lpszDir)
170 /* Use dir only */
171 lstrcpynW(szTemp, lpszDir, MAX_PATH);
173 else if (!lpszDir || !*lpszDir || !PathIsRelativeW(lpszFile))
175 if (!lpszDir || !*lpszDir || *lpszFile != '\\' || PathIsUNCW(lpszFile))
177 /* Use file only */
178 lstrcpynW(szTemp, lpszFile, MAX_PATH);
180 else
182 bUseBoth = TRUE;
183 bStrip = TRUE;
186 else
187 bUseBoth = TRUE;
189 if (bUseBoth)
191 lstrcpynW(szTemp, lpszDir, MAX_PATH);
192 if (bStrip)
194 PathStripToRootW(szTemp);
195 lpszFile++; /* Skip '\' */
197 if (!PathAddBackslashW(szTemp))
198 return NULL;
199 if (strlenW(szTemp) + strlenW(lpszFile) >= MAX_PATH)
200 return NULL;
201 strcatW(szTemp, lpszFile);
204 PathCanonicalizeW(lpszDest, szTemp);
205 return lpszDest;
208 /*************************************************************************
209 * PathAddBackslashA [SHLWAPI.@]
211 * Append a backslash ('\') to a path if one doesn't exist.
213 * PARAMS
214 * lpszPath [I/O] The path to append a backslash to.
216 * RETURNS
217 * Success: The position of the last backslash in the path.
218 * Failure: NULL, if lpszPath is NULL or the path is too large.
220 LPSTR WINAPI PathAddBackslashA(LPSTR lpszPath)
222 size_t iLen;
224 TRACE("(%s)\n",debugstr_a(lpszPath));
226 if (!lpszPath || (iLen = strlen(lpszPath)) >= MAX_PATH)
227 return NULL;
229 if (iLen)
231 lpszPath += iLen;
232 if (lpszPath[-1] != '\\')
234 *lpszPath++ = '\\';
235 *lpszPath = '\0';
238 return lpszPath;
241 /*************************************************************************
242 * PathAddBackslashW [SHLWAPI.@]
244 * See PathAddBackslashA.
246 LPWSTR WINAPI PathAddBackslashW( LPWSTR lpszPath )
248 size_t iLen;
250 TRACE("(%s)\n",debugstr_w(lpszPath));
252 if (!lpszPath || (iLen = strlenW(lpszPath)) >= MAX_PATH)
253 return NULL;
255 if (iLen)
257 lpszPath += iLen;
258 if (lpszPath[-1] != '\\')
260 *lpszPath++ = '\\';
261 *lpszPath = '\0';
264 return lpszPath;
267 /*************************************************************************
268 * PathBuildRootA [SHLWAPI.@]
270 * Create a root drive string (e.g. "A:\") from a drive number.
272 * PARAMS
273 * lpszPath [O] Destination for the drive string
275 * RETURNS
276 * lpszPath
278 * NOTES
279 * If lpszPath is NULL or drive is invalid, nothing is written to lpszPath.
281 LPSTR WINAPI PathBuildRootA(LPSTR lpszPath, int drive)
283 TRACE("(%p,%d)\n", lpszPath, drive);
285 if (lpszPath && drive >= 0 && drive < 26)
287 lpszPath[0] = 'A' + drive;
288 lpszPath[1] = ':';
289 lpszPath[2] = '\\';
290 lpszPath[3] = '\0';
292 return lpszPath;
295 /*************************************************************************
296 * PathBuildRootW [SHLWAPI.@]
298 * See PathBuildRootA.
300 LPWSTR WINAPI PathBuildRootW(LPWSTR lpszPath, int drive)
302 TRACE("(%p,%d)\n", lpszPath, drive);
304 if (lpszPath && drive >= 0 && drive < 26)
306 lpszPath[0] = 'A' + drive;
307 lpszPath[1] = ':';
308 lpszPath[2] = '\\';
309 lpszPath[3] = '\0';
311 return lpszPath;
314 /*************************************************************************
315 * PathFindFileNameA [SHLWAPI.@]
317 * Locate the start of the file name in a path
319 * PARAMS
320 * lpszPath [I] Path to search
322 * RETURNS
323 * A pointer to the first character of the file name
325 LPSTR WINAPI PathFindFileNameA(LPCSTR lpszPath)
327 LPCSTR lastSlash = lpszPath;
329 TRACE("(%s)\n",debugstr_a(lpszPath));
331 while (lpszPath && *lpszPath)
333 if ((*lpszPath == '\\' || *lpszPath == '/' || *lpszPath == ':') &&
334 lpszPath[1] && lpszPath[1] != '\\' && lpszPath[1] != '/')
335 lastSlash = lpszPath + 1;
336 lpszPath = CharNextA(lpszPath);
338 return (LPSTR)lastSlash;
341 /*************************************************************************
342 * PathFindFileNameW [SHLWAPI.@]
344 * See PathFindFileNameA.
346 LPWSTR WINAPI PathFindFileNameW(LPCWSTR lpszPath)
348 LPCWSTR lastSlash = lpszPath;
350 TRACE("(%s)\n",debugstr_w(lpszPath));
352 while (lpszPath && *lpszPath)
354 if ((*lpszPath == '\\' || *lpszPath == '/' || *lpszPath == ':') &&
355 lpszPath[1] && lpszPath[1] != '\\' && lpszPath[1] != '/')
356 lastSlash = lpszPath + 1;
357 lpszPath = CharNextW(lpszPath);
359 return (LPWSTR)lastSlash;
362 /*************************************************************************
363 * PathFindExtensionA [SHLWAPI.@]
365 * Locate the start of the file extension in a path
367 * PARAMS
368 * lpszPath [I] The path to search
370 * RETURNS
371 * A pointer to the first character of the extension, the end of
372 * the string if the path has no extension, or NULL If lpszPath is NULL
374 LPSTR WINAPI PathFindExtensionA( LPCSTR lpszPath )
376 LPCSTR lastpoint = NULL;
378 TRACE("(%s)\n", debugstr_a(lpszPath));
380 if (lpszPath)
382 while (*lpszPath)
384 if (*lpszPath == '\\' || *lpszPath==' ')
385 lastpoint = NULL;
386 else if (*lpszPath == '.')
387 lastpoint = lpszPath;
388 lpszPath = CharNextA(lpszPath);
391 return (LPSTR)(lastpoint ? lastpoint : lpszPath);
394 /*************************************************************************
395 * PathFindExtensionW [SHLWAPI.@]
397 * See PathFindExtensionA.
399 LPWSTR WINAPI PathFindExtensionW( LPCWSTR lpszPath )
401 LPCWSTR lastpoint = NULL;
403 TRACE("(%s)\n", debugstr_w(lpszPath));
405 if (lpszPath)
407 while (*lpszPath)
409 if (*lpszPath == '\\' || *lpszPath==' ')
410 lastpoint = NULL;
411 else if (*lpszPath == '.')
412 lastpoint = lpszPath;
413 lpszPath = CharNextW(lpszPath);
416 return (LPWSTR)(lastpoint ? lastpoint : lpszPath);
419 /*************************************************************************
420 * PathGetArgsA [SHLWAPI.@]
422 * Find the next argument in a string delimited by spaces.
424 * PARAMS
425 * lpszPath [I] The string to search for arguments in
427 * RETURNS
428 * The start of the next argument in lpszPath, or NULL if lpszPath is NULL
430 * NOTES
431 * Spaces in quoted strings are ignored as delimiters.
433 LPSTR WINAPI PathGetArgsA(LPCSTR lpszPath)
435 BOOL bSeenQuote = FALSE;
437 TRACE("(%s)\n",debugstr_a(lpszPath));
439 if (lpszPath)
441 while (*lpszPath)
443 if ((*lpszPath==' ') && !bSeenQuote)
444 return (LPSTR)lpszPath + 1;
445 if (*lpszPath == '"')
446 bSeenQuote = !bSeenQuote;
447 lpszPath = CharNextA(lpszPath);
450 return (LPSTR)lpszPath;
453 /*************************************************************************
454 * PathGetArgsW [SHLWAPI.@]
456 * See PathGetArgsA.
458 LPWSTR WINAPI PathGetArgsW(LPCWSTR lpszPath)
460 BOOL bSeenQuote = FALSE;
462 TRACE("(%s)\n",debugstr_w(lpszPath));
464 if (lpszPath)
466 while (*lpszPath)
468 if ((*lpszPath==' ') && !bSeenQuote)
469 return (LPWSTR)lpszPath + 1;
470 if (*lpszPath == '"')
471 bSeenQuote = !bSeenQuote;
472 lpszPath = CharNextW(lpszPath);
475 return (LPWSTR)lpszPath;
478 /*************************************************************************
479 * PathGetDriveNumberA [SHLWAPI.@]
481 * Return the drive number from a path
483 * PARAMS
484 * lpszPath [I] Path to get the drive number from
486 * RETURNS
487 * Success: The drive number corresponding to the drive in the path
488 * Failure: -1, if lpszPath contains no valid drive
490 int WINAPI PathGetDriveNumberA(LPCSTR lpszPath)
492 TRACE ("(%s)\n",debugstr_a(lpszPath));
494 if (lpszPath && !IsDBCSLeadByte(*lpszPath) && lpszPath[1] == ':' &&
495 tolower(*lpszPath) >= 'a' && tolower(*lpszPath) <= 'z')
496 return tolower(*lpszPath) - 'a';
497 return -1;
500 /*************************************************************************
501 * PathGetDriveNumberW [SHLWAPI.@]
503 * See PathGetDriveNumberA.
505 int WINAPI PathGetDriveNumberW(LPCWSTR lpszPath)
507 TRACE ("(%s)\n",debugstr_w(lpszPath));
509 if (lpszPath)
511 WCHAR tl = tolowerW(lpszPath[0]);
512 if (tl >= 'a' && tl <= 'z' && lpszPath[1] == ':')
513 return tl - 'a';
515 return -1;
518 /*************************************************************************
519 * PathRemoveFileSpecA [SHLWAPI.@]
521 * Remove the file specification from a path.
523 * PARAMS
524 * lpszPath [I/O] Path to remove the file spec from
526 * RETURNS
527 * TRUE If the path was valid and modified
528 * FALSE Otherwise
530 BOOL WINAPI PathRemoveFileSpecA(LPSTR lpszPath)
532 LPSTR lpszFileSpec = lpszPath;
533 BOOL bModified = FALSE;
535 TRACE("(%s)\n",debugstr_a(lpszPath));
537 if(lpszPath)
539 /* Skip directory or UNC path */
540 if (*lpszPath == '\\')
541 lpszFileSpec = ++lpszPath;
542 if (*lpszPath == '\\')
543 lpszFileSpec = ++lpszPath;
545 while (*lpszPath)
547 if(*lpszPath == '\\')
548 lpszFileSpec = lpszPath; /* Skip dir */
549 else if(*lpszPath == ':')
551 lpszFileSpec = ++lpszPath; /* Skip drive */
552 if (*lpszPath == '\\')
553 lpszFileSpec++;
555 if (!(lpszPath = CharNextA(lpszPath)))
556 break;
559 if (*lpszFileSpec)
561 *lpszFileSpec = '\0';
562 bModified = TRUE;
565 return bModified;
568 /*************************************************************************
569 * PathRemoveFileSpecW [SHLWAPI.@]
571 * See PathRemoveFileSpecA.
573 BOOL WINAPI PathRemoveFileSpecW(LPWSTR lpszPath)
575 LPWSTR lpszFileSpec = lpszPath;
576 BOOL bModified = FALSE;
578 TRACE("(%s)\n",debugstr_w(lpszPath));
580 if(lpszPath)
582 /* Skip directory or UNC path */
583 if (*lpszPath == '\\')
584 lpszFileSpec = ++lpszPath;
585 if (*lpszPath == '\\')
586 lpszFileSpec = ++lpszPath;
588 while (*lpszPath)
590 if(*lpszPath == '\\')
591 lpszFileSpec = lpszPath; /* Skip dir */
592 else if(*lpszPath == ':')
594 lpszFileSpec = ++lpszPath; /* Skip drive */
595 if (*lpszPath == '\\')
596 lpszFileSpec++;
598 if (!(lpszPath = CharNextW(lpszPath)))
599 break;
602 if (*lpszFileSpec)
604 *lpszFileSpec = '\0';
605 bModified = TRUE;
608 return bModified;
611 /*************************************************************************
612 * PathStripPathA [SHLWAPI.@]
614 * Remove the initial path from the beginning of a filename
616 * PARAMS
617 * lpszPath [I/O] Path to remove the initial path from
619 * RETURNS
620 * Nothing.
622 void WINAPI PathStripPathA(LPSTR lpszPath)
624 TRACE("(%s)\n", debugstr_a(lpszPath));
626 if (lpszPath)
628 LPSTR lpszFileName = PathFindFileNameA(lpszPath);
629 if(lpszFileName)
630 RtlMoveMemory(lpszPath, lpszFileName, strlen(lpszFileName)+1);
634 /*************************************************************************
635 * PathStripPathW [SHLWAPI.@]
637 * See PathStripPathA.
639 void WINAPI PathStripPathW(LPWSTR lpszPath)
641 LPWSTR lpszFileName;
643 TRACE("(%s)\n", debugstr_w(lpszPath));
644 lpszFileName = PathFindFileNameW(lpszPath);
645 if(lpszFileName)
646 RtlMoveMemory(lpszPath, lpszFileName, (strlenW(lpszFileName)+1)*sizeof(WCHAR));
649 /*************************************************************************
650 * PathStripToRootA [SHLWAPI.@]
652 * Reduce a path to its root.
654 * PARAMS
655 * lpszPath [I/O] the path to reduce
657 * RETURNS
658 * Success: TRUE if the stripped path is a root path
659 * Failure: FALSE if the path cannot be stripped or is NULL
661 BOOL WINAPI PathStripToRootA(LPSTR lpszPath)
663 TRACE("(%s)\n", debugstr_a(lpszPath));
665 if (!lpszPath)
666 return FALSE;
667 while(!PathIsRootA(lpszPath))
668 if (!PathRemoveFileSpecA(lpszPath))
669 return FALSE;
670 return TRUE;
673 /*************************************************************************
674 * PathStripToRootW [SHLWAPI.@]
676 * See PathStripToRootA.
678 BOOL WINAPI PathStripToRootW(LPWSTR lpszPath)
680 TRACE("(%s)\n", debugstr_w(lpszPath));
682 if (!lpszPath)
683 return FALSE;
684 while(!PathIsRootW(lpszPath))
685 if (!PathRemoveFileSpecW(lpszPath))
686 return FALSE;
687 return TRUE;
690 /*************************************************************************
691 * PathRemoveArgsA [SHLWAPI.@]
693 * Strip space separated arguments from a path.
695 * PARAMS
696 * lpszPath [I/O] Path to remove arguments from
698 * RETURNS
699 * Nothing.
701 void WINAPI PathRemoveArgsA(LPSTR lpszPath)
703 TRACE("(%s)\n",debugstr_a(lpszPath));
705 if(lpszPath)
707 LPSTR lpszArgs = PathGetArgsA(lpszPath);
708 if (*lpszArgs)
709 lpszArgs[-1] = '\0';
710 else
712 LPSTR lpszLastChar = CharPrevA(lpszPath, lpszArgs);
713 if(*lpszLastChar == ' ')
714 *lpszLastChar = '\0';
719 /*************************************************************************
720 * PathRemoveArgsW [SHLWAPI.@]
722 * See PathRemoveArgsA.
724 void WINAPI PathRemoveArgsW(LPWSTR lpszPath)
726 TRACE("(%s)\n",debugstr_w(lpszPath));
728 if(lpszPath)
730 LPWSTR lpszArgs = PathGetArgsW(lpszPath);
731 if (*lpszArgs)
732 lpszArgs[-1] = '\0';
733 else
735 LPWSTR lpszLastChar = CharPrevW(lpszPath, lpszArgs);
736 if(*lpszLastChar == ' ')
737 *lpszLastChar = '\0';
742 /*************************************************************************
743 * PathRemoveExtensionA [SHLWAPI.@]
745 * Remove the file extension from a path
747 * PARAMS
748 * lpszPath [I/O] Path to remove the extension from
750 * RETURNS
751 * Nothing.
753 void WINAPI PathRemoveExtensionA(LPSTR lpszPath)
755 TRACE("(%s)\n", debugstr_a(lpszPath));
757 if (lpszPath)
759 lpszPath = PathFindExtensionA(lpszPath);
760 *lpszPath = '\0';
764 /*************************************************************************
765 * PathRemoveExtensionW [SHLWAPI.@]
767 * See PathRemoveExtensionA.
769 void WINAPI PathRemoveExtensionW(LPWSTR lpszPath)
771 TRACE("(%s)\n", debugstr_w(lpszPath));
773 if (lpszPath)
775 lpszPath = PathFindExtensionW(lpszPath);
776 *lpszPath = '\0';
780 /*************************************************************************
781 * PathRemoveBackslashA [SHLWAPI.@]
783 * Remove a trailing backslash from a path.
785 * PARAMS
786 * lpszPath [I/O] Path to remove backslash from
788 * RETURNS
789 * Success: A pointer to the end of the path
790 * Failure: NULL, if lpszPath is NULL
792 LPSTR WINAPI PathRemoveBackslashA( LPSTR lpszPath )
794 LPSTR szTemp = NULL;
796 TRACE("(%s)\n", debugstr_a(lpszPath));
798 if(lpszPath)
800 szTemp = CharPrevA(lpszPath, lpszPath + strlen(lpszPath));
801 if (!PathIsRootA(lpszPath) && *szTemp == '\\')
802 *szTemp = '\0';
804 return szTemp;
807 /*************************************************************************
808 * PathRemoveBackslashW [SHLWAPI.@]
810 * See PathRemoveBackslashA.
812 LPWSTR WINAPI PathRemoveBackslashW( LPWSTR lpszPath )
814 LPWSTR szTemp = NULL;
816 TRACE("(%s)\n", debugstr_w(lpszPath));
818 if(lpszPath)
820 szTemp = CharPrevW(lpszPath, lpszPath + strlenW(lpszPath));
821 if (!PathIsRootW(lpszPath) && *szTemp == '\\')
822 *szTemp = '\0';
824 return szTemp;
827 /*************************************************************************
828 * PathRemoveBlanksA [SHLWAPI.@]
830 * Remove Spaces from the start and end of a path.
832 * PARAMS
833 * lpszPath [I/O] Path to strip blanks from
835 * RETURNS
836 * Nothing.
838 VOID WINAPI PathRemoveBlanksA(LPSTR lpszPath)
840 TRACE("(%s)\n", debugstr_a(lpszPath));
842 if(lpszPath && *lpszPath)
844 LPSTR start = lpszPath;
846 while (*lpszPath == ' ')
847 lpszPath = CharNextA(lpszPath);
849 while(*lpszPath)
850 *start++ = *lpszPath++;
852 if (start != lpszPath)
853 while (start[-1] == ' ')
854 start--;
855 *start = '\0';
859 /*************************************************************************
860 * PathRemoveBlanksW [SHLWAPI.@]
862 * See PathRemoveBlanksA.
864 VOID WINAPI PathRemoveBlanksW(LPWSTR lpszPath)
866 TRACE("(%s)\n", debugstr_w(lpszPath));
868 if(lpszPath && *lpszPath)
870 LPWSTR start = lpszPath;
872 while (*lpszPath == ' ')
873 lpszPath++;
875 while(*lpszPath)
876 *start++ = *lpszPath++;
878 if (start != lpszPath)
879 while (start[-1] == ' ')
880 start--;
881 *start = '\0';
885 /*************************************************************************
886 * PathQuoteSpacesA [SHLWAPI.@]
888 * Surround a path containg spaces in quotes.
890 * PARAMS
891 * lpszPath [I/O] Path to quote
893 * RETURNS
894 * Nothing.
896 * NOTES
897 * The path is not changed if it is invalid or has no spaces.
899 VOID WINAPI PathQuoteSpacesA(LPSTR lpszPath)
901 TRACE("(%s)\n", debugstr_a(lpszPath));
903 if(lpszPath && StrChrA(lpszPath,' '))
905 size_t iLen = strlen(lpszPath) + 1;
907 if (iLen + 2 < MAX_PATH)
909 memmove(lpszPath + 1, lpszPath, iLen);
910 lpszPath[0] = '"';
911 lpszPath[iLen] = '"';
912 lpszPath[iLen + 1] = '\0';
917 /*************************************************************************
918 * PathQuoteSpacesW [SHLWAPI.@]
920 * See PathQuoteSpacesA.
922 VOID WINAPI PathQuoteSpacesW(LPWSTR lpszPath)
924 TRACE("(%s)\n", debugstr_w(lpszPath));
926 if(lpszPath && StrChrW(lpszPath,' '))
928 int iLen = strlenW(lpszPath) + 1;
930 if (iLen + 2 < MAX_PATH)
932 memmove(lpszPath + 1, lpszPath, iLen * sizeof(WCHAR));
933 lpszPath[0] = '"';
934 lpszPath[iLen] = '"';
935 lpszPath[iLen + 1] = '\0';
940 /*************************************************************************
941 * PathUnquoteSpacesA [SHLWAPI.@]
943 * Remove quotes ("") from around a path, if present.
945 * PARAMS
946 * lpszPath [I/O] Path to strip quotes from
948 * RETURNS
949 * Nothing
951 * NOTES
952 * If the path contains a single quote only, an empty string will result.
953 * Otherwise quotes are only removed if they appear at the start and end
954 * of the path.
956 VOID WINAPI PathUnquoteSpacesA(LPSTR lpszPath)
958 TRACE("(%s)\n", debugstr_a(lpszPath));
960 if (lpszPath && *lpszPath == '"')
962 DWORD dwLen = strlen(lpszPath) - 1;
964 if (lpszPath[dwLen] == '"')
966 lpszPath[dwLen] = '\0';
967 for (; *lpszPath; lpszPath++)
968 *lpszPath = lpszPath[1];
973 /*************************************************************************
974 * PathUnquoteSpacesW [SHLWAPI.@]
976 * See PathUnquoteSpacesA.
978 VOID WINAPI PathUnquoteSpacesW(LPWSTR lpszPath)
980 TRACE("(%s)\n", debugstr_w(lpszPath));
982 if (lpszPath && *lpszPath == '"')
984 DWORD dwLen = strlenW(lpszPath) - 1;
986 if (lpszPath[dwLen] == '"')
988 lpszPath[dwLen] = '\0';
989 for (; *lpszPath; lpszPath++)
990 *lpszPath = lpszPath[1];
995 /*************************************************************************
996 * PathParseIconLocationA [SHLWAPI.@]
998 * Parse the location of an icon from a path.
1000 * PARAMS
1001 * lpszPath [I/O] The path to parse the icon location from.
1003 * RETURNS
1004 * Success: The number of the icon
1005 * Failure: 0 if the path does not contain an icon location or is NULL
1007 * NOTES
1008 * The path has surrounding quotes and spaces removed regardless
1009 * of whether the call succeeds or not.
1011 int WINAPI PathParseIconLocationA(LPSTR lpszPath)
1013 int iRet = 0;
1014 LPSTR lpszComma;
1016 TRACE("(%s)\n", debugstr_a(lpszPath));
1018 if (lpszPath)
1020 if ((lpszComma = strchr(lpszPath, ',')))
1022 *lpszComma++ = '\0';
1023 iRet = StrToIntA(lpszComma);
1025 PathUnquoteSpacesA(lpszPath);
1026 PathRemoveBlanksA(lpszPath);
1028 return iRet;
1031 /*************************************************************************
1032 * PathParseIconLocationW [SHLWAPI.@]
1034 * See PathParseIconLocationA.
1036 int WINAPI PathParseIconLocationW(LPWSTR lpszPath)
1038 int iRet = 0;
1039 LPWSTR lpszComma;
1041 TRACE("(%s)\n", debugstr_w(lpszPath));
1043 if (lpszPath)
1045 if ((lpszComma = StrChrW(lpszPath, ',')))
1047 *lpszComma++ = '\0';
1048 iRet = StrToIntW(lpszComma);
1050 PathUnquoteSpacesW(lpszPath);
1051 PathRemoveBlanksW(lpszPath);
1053 return iRet;
1056 /*************************************************************************
1057 * @ [SHLWAPI.4]
1059 * Unicode version of PathFileExistsDefExtA.
1061 BOOL WINAPI PathFileExistsDefExtW(LPWSTR lpszPath,DWORD dwWhich)
1063 static const WCHAR pszExts[7][5] = { { '.', 'p', 'i', 'f', 0},
1064 { '.', 'c', 'o', 'm', 0},
1065 { '.', 'e', 'x', 'e', 0},
1066 { '.', 'b', 'a', 't', 0},
1067 { '.', 'l', 'n', 'k', 0},
1068 { '.', 'c', 'm', 'd', 0},
1069 { 0, 0, 0, 0, 0} };
1071 TRACE("(%s,%ld)\n", debugstr_w(lpszPath), dwWhich);
1073 if (!lpszPath || PathIsUNCServerW(lpszPath) || PathIsUNCServerShareW(lpszPath))
1074 return FALSE;
1076 if (dwWhich)
1078 LPCWSTR szExt = PathFindExtensionW(lpszPath);
1079 if (!*szExt || dwWhich & 0x40)
1081 size_t iChoose = 0;
1082 int iLen = lstrlenW(lpszPath);
1083 if (iLen > (MAX_PATH - 5))
1084 return FALSE;
1085 while ( (dwWhich & 0x1) && pszExts[iChoose][0] )
1087 lstrcpyW(lpszPath + iLen, pszExts[iChoose]);
1088 if (PathFileExistsW(lpszPath))
1089 return TRUE;
1090 iChoose++;
1091 dwWhich >>= 1;
1093 *(lpszPath + iLen) = (WCHAR)'\0';
1094 return FALSE;
1097 return PathFileExistsW(lpszPath);
1100 /*************************************************************************
1101 * @ [SHLWAPI.3]
1103 * Determine if a file exists locally and is of an executable type.
1105 * PARAMS
1106 * lpszPath [I/O] File to search for
1107 * dwWhich [I] Type of executable to search for
1109 * RETURNS
1110 * TRUE If the file was found. lpszPath contains the file name.
1111 * FALSE Otherwise.
1113 * NOTES
1114 * lpszPath is modified in place and must be at least MAX_PATH in length.
1115 * If the function returns FALSE, the path is modified to its orginal state.
1116 * If the given path contains an extension or dwWhich is 0, executable
1117 * extensions are not checked.
1119 * Ordinals 3-6 are a classic case of MS exposing limited functionality to
1120 * users (here through PathFindOnPathA()) and keeping advanced functionality for
1121 * their own developers exclusive use. Monopoly, anyone?
1123 BOOL WINAPI PathFileExistsDefExtA(LPSTR lpszPath,DWORD dwWhich)
1125 BOOL bRet = FALSE;
1127 TRACE("(%s,%ld)\n", debugstr_a(lpszPath), dwWhich);
1129 if (lpszPath)
1131 WCHAR szPath[MAX_PATH];
1132 MultiByteToWideChar(CP_ACP,0,lpszPath,-1,szPath,MAX_PATH);
1133 bRet = PathFileExistsDefExtW(szPath, dwWhich);
1134 if (bRet)
1135 WideCharToMultiByte(CP_ACP,0,szPath,-1,lpszPath,MAX_PATH,0,0);
1137 return bRet;
1140 /*************************************************************************
1141 * SHLWAPI_PathFindInOtherDirs
1143 * Internal helper for SHLWAPI_PathFindOnPathExA/W.
1145 static BOOL WINAPI SHLWAPI_PathFindInOtherDirs(LPWSTR lpszFile, DWORD dwWhich)
1147 static const WCHAR szSystem[] = { 'S','y','s','t','e','m','\0'};
1148 static const WCHAR szPath[] = { 'P','A','T','H','\0'};
1149 DWORD dwLenPATH;
1150 LPCWSTR lpszCurr;
1151 WCHAR *lpszPATH;
1152 WCHAR buff[MAX_PATH];
1154 TRACE("(%s,%08lx)\n", debugstr_w(lpszFile), dwWhich);
1156 /* Try system directories */
1157 GetSystemDirectoryW(buff, MAX_PATH);
1158 if (!PathAppendW(buff, lpszFile))
1159 return FALSE;
1160 if (PathFileExistsDefExtW(buff, dwWhich))
1162 strcpyW(lpszFile, buff);
1163 return TRUE;
1165 GetWindowsDirectoryW(buff, MAX_PATH);
1166 if (!PathAppendW(buff, szSystem ) || !PathAppendW(buff, lpszFile))
1167 return FALSE;
1168 if (PathFileExistsDefExtW(buff, dwWhich))
1170 strcpyW(lpszFile, buff);
1171 return TRUE;
1173 GetWindowsDirectoryW(buff, MAX_PATH);
1174 if (!PathAppendW(buff, lpszFile))
1175 return FALSE;
1176 if (PathFileExistsDefExtW(buff, dwWhich))
1178 strcpyW(lpszFile, buff);
1179 return TRUE;
1181 /* Try dirs listed in %PATH% */
1182 dwLenPATH = GetEnvironmentVariableW(szPath, buff, MAX_PATH);
1184 if (!dwLenPATH || !(lpszPATH = malloc((dwLenPATH + 1) * sizeof (WCHAR))))
1185 return FALSE;
1187 GetEnvironmentVariableW(szPath, lpszPATH, dwLenPATH + 1);
1188 lpszCurr = lpszPATH;
1189 while (lpszCurr)
1191 LPCWSTR lpszEnd = lpszCurr;
1192 LPWSTR pBuff = buff;
1194 while (*lpszEnd == ' ')
1195 lpszEnd++;
1196 while (*lpszEnd && *lpszEnd != ';')
1197 *pBuff++ = *lpszEnd++;
1198 *pBuff = '\0';
1200 if (*lpszEnd)
1201 lpszCurr = lpszEnd + 1;
1202 else
1203 lpszCurr = NULL; /* Last Path, terminate after this */
1205 if (!PathAppendW(buff, lpszFile))
1207 free(lpszPATH);
1208 return FALSE;
1210 if (PathFileExistsDefExtW(buff, dwWhich))
1212 strcpyW(lpszFile, buff);
1213 free(lpszPATH);
1214 return TRUE;
1217 free(lpszPATH);
1218 return FALSE;
1221 /*************************************************************************
1222 * @ [SHLWAPI.5]
1224 * Search a range of paths for a specific type of executable.
1226 * PARAMS
1227 * lpszFile [I/O] File to search for
1228 * lppszOtherDirs [I] Other directories to look in
1229 * dwWhich [I] Type of executable to search for
1231 * RETURNS
1232 * Success: TRUE. The path to the executable is stored in lpszFile.
1233 * Failure: FALSE. The path to the executable is unchanged.
1235 BOOL WINAPI PathFindOnPathExA(LPSTR lpszFile,LPCSTR *lppszOtherDirs,DWORD dwWhich)
1237 WCHAR szFile[MAX_PATH];
1238 WCHAR buff[MAX_PATH];
1240 TRACE("(%s,%p,%08lx)\n", debugstr_a(lpszFile), lppszOtherDirs, dwWhich);
1242 if (!lpszFile || !PathIsFileSpecA(lpszFile))
1243 return FALSE;
1245 MultiByteToWideChar(CP_ACP,0,lpszFile,-1,szFile,MAX_PATH);
1247 /* Search provided directories first */
1248 if (lppszOtherDirs && *lppszOtherDirs)
1250 WCHAR szOther[MAX_PATH];
1251 LPCSTR *lpszOtherPath = lppszOtherDirs;
1253 while (lpszOtherPath && *lpszOtherPath && (*lpszOtherPath)[0])
1255 MultiByteToWideChar(CP_ACP,0,*lpszOtherPath,-1,szOther,MAX_PATH);
1256 PathCombineW(buff, szOther, szFile);
1257 if (PathFileExistsDefExtW(buff, dwWhich))
1259 WideCharToMultiByte(CP_ACP,0,buff,-1,lpszFile,MAX_PATH,0,0);
1260 return TRUE;
1262 lpszOtherPath++;
1265 /* Not found, try system and path dirs */
1266 if (SHLWAPI_PathFindInOtherDirs(szFile, dwWhich))
1268 WideCharToMultiByte(CP_ACP,0,szFile,-1,lpszFile,MAX_PATH,0,0);
1269 return TRUE;
1271 return FALSE;
1274 /*************************************************************************
1275 * @ [SHLWAPI.6]
1277 * Unicode version of PathFindOnPathExA.
1279 BOOL WINAPI PathFindOnPathExW(LPWSTR lpszFile,LPCWSTR *lppszOtherDirs,DWORD dwWhich)
1281 WCHAR buff[MAX_PATH];
1283 TRACE("(%s,%p,%08lx)\n", debugstr_w(lpszFile), lppszOtherDirs, dwWhich);
1285 if (!lpszFile || !PathIsFileSpecW(lpszFile))
1286 return FALSE;
1288 /* Search provided directories first */
1289 if (lppszOtherDirs && *lppszOtherDirs)
1291 LPCWSTR *lpszOtherPath = lppszOtherDirs;
1292 while (lpszOtherPath && *lpszOtherPath && (*lpszOtherPath)[0])
1294 PathCombineW(buff, *lpszOtherPath, lpszFile);
1295 if (PathFileExistsDefExtW(buff, dwWhich))
1297 strcpyW(lpszFile, buff);
1298 return TRUE;
1300 lpszOtherPath++;
1303 /* Not found, try system and path dirs */
1304 return SHLWAPI_PathFindInOtherDirs(lpszFile, dwWhich);
1307 /*************************************************************************
1308 * PathFindOnPathA [SHLWAPI.@]
1310 * Search a range of paths for an executable.
1312 * PARAMS
1313 * lpszFile [I/O] File to search for
1314 * lppszOtherDirs [I] Other directories to look in
1316 * RETURNS
1317 * Success: TRUE. The path to the executable is stored in lpszFile.
1318 * Failure: FALSE. The path to the executable is unchanged.
1320 BOOL WINAPI PathFindOnPathA(LPSTR lpszFile, LPCSTR *lppszOtherDirs)
1322 TRACE("(%s,%p)\n", debugstr_a(lpszFile), lppszOtherDirs);
1323 return PathFindOnPathExA(lpszFile, lppszOtherDirs, 0);
1326 /*************************************************************************
1327 * PathFindOnPathW [SHLWAPI.@]
1329 * See PathFindOnPathA.
1331 BOOL WINAPI PathFindOnPathW(LPWSTR lpszFile, LPCWSTR *lppszOtherDirs)
1333 TRACE("(%s,%p)\n", debugstr_w(lpszFile), lppszOtherDirs);
1334 return PathFindOnPathExW(lpszFile,lppszOtherDirs, 0);
1337 /*************************************************************************
1338 * PathCompactPathExA [SHLWAPI.@]
1340 * Compact a path into a given number of characters.
1342 * PARAMS
1343 * lpszDest [O] Destination for compacted path
1344 * lpszPath [I] Source path
1345 * cchMax [I] Maximum size of compacted path
1346 * dwFlags [I] Reserved
1348 * RETURNS
1349 * Success: TRUE. The compacted path is written to lpszDest.
1350 * Failure: FALSE. lpszPath is undefined.
1352 * NOTES
1353 * If cchMax is given as 0, lpszDest will still be NUL terminated.
1355 * The Win32 version of this function contains a bug: When cchMax == 7,
1356 * 8 bytes will be written to lpszDest. This bug is fixed in the Wine
1357 * implementation.
1359 * Some relative paths will be different when cchMax == 5 or 6. This occurs
1360 * because Win32 will insert a "\" in lpszDest, even if one is
1361 * not present in the original path.
1363 BOOL WINAPI PathCompactPathExA(LPSTR lpszDest, LPCSTR lpszPath,
1364 UINT cchMax, DWORD dwFlags)
1366 BOOL bRet = FALSE;
1368 TRACE("(%p,%s,%d,0x%08lx)\n", lpszDest, debugstr_a(lpszPath), cchMax, dwFlags);
1370 if (lpszPath && lpszDest)
1372 WCHAR szPath[MAX_PATH];
1373 WCHAR szDest[MAX_PATH];
1375 MultiByteToWideChar(CP_ACP,0,lpszPath,-1,szPath,MAX_PATH);
1376 szDest[0] = '\0';
1377 bRet = PathCompactPathExW(szDest, szPath, cchMax, dwFlags);
1378 WideCharToMultiByte(CP_ACP,0,szDest,-1,lpszDest,MAX_PATH,0,0);
1380 return bRet;
1383 /*************************************************************************
1384 * PathCompactPathExW [SHLWAPI.@]
1386 * See PathCompactPathExA.
1388 BOOL WINAPI PathCompactPathExW(LPWSTR lpszDest, LPCWSTR lpszPath,
1389 UINT cchMax, DWORD dwFlags)
1391 static const WCHAR szEllipses[] = { '.', '.', '.', '\0' };
1392 LPCWSTR lpszFile;
1393 DWORD dwLen, dwFileLen = 0;
1395 TRACE("(%p,%s,%d,0x%08lx)\n", lpszDest, debugstr_w(lpszPath), cchMax, dwFlags);
1397 if (!lpszPath)
1398 return FALSE;
1400 if (!lpszDest)
1402 WARN("Invalid lpszDest would crash under Win32!\n");
1403 return FALSE;
1406 *lpszDest = '\0';
1408 if (cchMax < 2)
1409 return TRUE;
1411 dwLen = strlenW(lpszPath) + 1;
1413 if (dwLen < cchMax)
1415 /* Don't need to compact */
1416 memcpy(lpszDest, lpszPath, dwLen * sizeof(WCHAR));
1417 return TRUE;
1420 /* Path must be compacted to fit into lpszDest */
1421 lpszFile = PathFindFileNameW(lpszPath);
1422 dwFileLen = lpszPath + dwLen - lpszFile;
1424 if (dwFileLen == dwLen)
1426 /* No root in psth */
1427 if (cchMax <= 4)
1429 while (--cchMax > 0) /* No room left for anything but ellipses */
1430 *lpszDest++ = '.';
1431 *lpszDest = '\0';
1432 return TRUE;
1434 /* Compact the file name with ellipses at the end */
1435 cchMax -= 4;
1436 memcpy(lpszDest, lpszFile, cchMax * sizeof(WCHAR));
1437 strcpyW(lpszDest + cchMax, szEllipses);
1438 return TRUE;
1440 /* We have a root in the path */
1441 lpszFile--; /* Start compacted filename with the path separator */
1442 dwFileLen++;
1444 if (dwFileLen + 3 > cchMax)
1446 /* Compact the file name */
1447 if (cchMax <= 4)
1449 while (--cchMax > 0) /* No room left for anything but ellipses */
1450 *lpszDest++ = '.';
1451 *lpszDest = '\0';
1452 return TRUE;
1454 strcpyW(lpszDest, szEllipses);
1455 lpszDest += 3;
1456 cchMax -= 4;
1457 *lpszDest++ = *lpszFile++;
1458 if (cchMax <= 4)
1460 while (--cchMax > 0) /* No room left for anything but ellipses */
1461 *lpszDest++ = '.';
1462 *lpszDest = '\0';
1463 return TRUE;
1465 cchMax -= 4;
1466 memcpy(lpszDest, lpszFile, cchMax * sizeof(WCHAR));
1467 strcpyW(lpszDest + cchMax, szEllipses);
1468 return TRUE;
1471 /* Only the root needs to be Compacted */
1472 dwLen = cchMax - dwFileLen - 3;
1473 memcpy(lpszDest, lpszPath, dwLen * sizeof(WCHAR));
1474 strcpyW(lpszDest + dwLen, szEllipses);
1475 strcpyW(lpszDest + dwLen + 3, lpszFile);
1476 return TRUE;
1479 /*************************************************************************
1480 * PathIsRelativeA [SHLWAPI.@]
1482 * Determine if a path is a relative path.
1484 * PARAMS
1485 * lpszPath [I] Path to check
1487 * RETURNS
1488 * TRUE: The path is relative, or is invalid.
1489 * FALSE: The path is not relative.
1491 BOOL WINAPI PathIsRelativeA (LPCSTR lpszPath)
1493 TRACE("(%s)\n",debugstr_a(lpszPath));
1495 if (!lpszPath || !*lpszPath || IsDBCSLeadByte(*lpszPath))
1496 return TRUE;
1497 if (*lpszPath == '\\' || (*lpszPath && lpszPath[1] == ':'))
1498 return FALSE;
1499 return TRUE;
1502 /*************************************************************************
1503 * PathIsRelativeW [SHLWAPI.@]
1505 * See PathIsRelativeA.
1507 BOOL WINAPI PathIsRelativeW (LPCWSTR lpszPath)
1509 TRACE("(%s)\n",debugstr_w(lpszPath));
1511 if (!lpszPath || !*lpszPath)
1512 return TRUE;
1513 if (*lpszPath == '\\' || (*lpszPath && lpszPath[1] == ':'))
1514 return FALSE;
1515 return TRUE;
1518 /*************************************************************************
1519 * PathIsRootA [SHLWAPI.@]
1521 * Determine if a path is a root path.
1523 * PARAMS
1524 * lpszPath [I] Path to check
1526 * RETURNS
1527 * TRUE If lpszPath is valid and a root path,
1528 * FALSE Otherwise
1530 BOOL WINAPI PathIsRootA(LPCSTR lpszPath)
1532 TRACE("(%s)\n", debugstr_a(lpszPath));
1534 if (lpszPath && *lpszPath)
1536 if (*lpszPath == '\\')
1538 if (!lpszPath[1])
1539 return TRUE; /* \ */
1540 else if (lpszPath[1]=='\\')
1542 BOOL bSeenSlash = FALSE;
1543 lpszPath += 2;
1545 /* Check for UNC root path */
1546 while (*lpszPath)
1548 if (*lpszPath == '\\')
1550 if (bSeenSlash)
1551 return FALSE;
1552 bSeenSlash = TRUE;
1554 lpszPath = CharNextA(lpszPath);
1556 return TRUE;
1559 else if (lpszPath[1] == ':' && lpszPath[2] == '\\' && lpszPath[3] == '\0')
1560 return TRUE; /* X:\ */
1562 return FALSE;
1565 /*************************************************************************
1566 * PathIsRootW [SHLWAPI.@]
1568 * See PathIsRootA.
1570 BOOL WINAPI PathIsRootW(LPCWSTR lpszPath)
1572 TRACE("(%s)\n", debugstr_w(lpszPath));
1574 if (lpszPath && *lpszPath)
1576 if (*lpszPath == '\\')
1578 if (!lpszPath[1])
1579 return TRUE; /* \ */
1580 else if (lpszPath[1]=='\\')
1582 BOOL bSeenSlash = FALSE;
1583 lpszPath += 2;
1585 /* Check for UNC root path */
1586 while (*lpszPath)
1588 if (*lpszPath == '\\')
1590 if (bSeenSlash)
1591 return FALSE;
1592 bSeenSlash = TRUE;
1594 lpszPath = CharNextW(lpszPath);
1596 return TRUE;
1599 else if (lpszPath[1] == ':' && lpszPath[2] == '\\' && lpszPath[3] == '\0')
1600 return TRUE; /* X:\ */
1602 return FALSE;
1605 /*************************************************************************
1606 * PathIsDirectoryA [SHLWAPI.@]
1608 * Determine if a path is a valid directory
1610 * PARAMS
1611 * lpszPath [I] Path to check.
1613 * RETURNS
1614 * FILE_ATTRIBUTE_DIRECTORY if lpszPath exists and can be read (See Notes)
1615 * FALSE if lpszPath is invalid or not a directory.
1617 * NOTES
1618 * Although this function is prototyped as returning a BOOL, it returns
1619 * FILE_ATTRIBUTE_DIRECTORY for success. This means that code such as:
1621 *| if (PathIsDirectoryA("c:\\windows\\") == TRUE)
1622 *| ...
1624 * will always fail.
1626 BOOL WINAPI PathIsDirectoryA(LPCSTR lpszPath)
1628 DWORD dwAttr;
1630 TRACE("(%s)\n", debugstr_a(lpszPath));
1632 if (!lpszPath || PathIsUNCServerA(lpszPath))
1633 return FALSE;
1635 if (PathIsUNCServerShareA(lpszPath))
1637 FIXME("UNC Server Share not yet supported - FAILING\n");
1638 return FALSE;
1641 if ((dwAttr = GetFileAttributesA(lpszPath)) == INVALID_FILE_ATTRIBUTES)
1642 return FALSE;
1643 return dwAttr & FILE_ATTRIBUTE_DIRECTORY;
1646 /*************************************************************************
1647 * PathIsDirectoryW [SHLWAPI.@]
1649 * See PathIsDirectoryA.
1651 BOOL WINAPI PathIsDirectoryW(LPCWSTR lpszPath)
1653 DWORD dwAttr;
1655 TRACE("(%s)\n", debugstr_w(lpszPath));
1657 if (!lpszPath || PathIsUNCServerW(lpszPath))
1658 return FALSE;
1660 if (PathIsUNCServerShareW(lpszPath))
1662 FIXME("UNC Server Share not yet supported - FAILING\n");
1663 return FALSE;
1666 if ((dwAttr = GetFileAttributesW(lpszPath)) == INVALID_FILE_ATTRIBUTES)
1667 return FALSE;
1668 return dwAttr & FILE_ATTRIBUTE_DIRECTORY;
1671 /*************************************************************************
1672 * PathFileExistsA [SHLWAPI.@]
1674 * Determine if a file exists.
1676 * PARAMS
1677 * lpszPath [I] Path to check
1679 * RETURNS
1680 * TRUE If the file exists and is readable
1681 * FALSE Otherwise
1683 BOOL WINAPI PathFileExistsA(LPCSTR lpszPath)
1685 UINT iPrevErrMode;
1686 DWORD dwAttr;
1688 TRACE("(%s)\n",debugstr_a(lpszPath));
1690 if (!lpszPath)
1691 return FALSE;
1693 /* Prevent a dialog box if path is on a disk that has been ejected. */
1694 iPrevErrMode = SetErrorMode(SEM_FAILCRITICALERRORS);
1695 dwAttr = GetFileAttributesA(lpszPath);
1696 SetErrorMode(iPrevErrMode);
1697 return dwAttr == INVALID_FILE_ATTRIBUTES ? FALSE : TRUE;
1700 /*************************************************************************
1701 * PathFileExistsW [SHLWAPI.@]
1703 * See PathFileExistsA.
1705 BOOL WINAPI PathFileExistsW(LPCWSTR lpszPath)
1707 UINT iPrevErrMode;
1708 DWORD dwAttr;
1710 TRACE("(%s)\n",debugstr_w(lpszPath));
1712 if (!lpszPath)
1713 return FALSE;
1715 iPrevErrMode = SetErrorMode(SEM_FAILCRITICALERRORS);
1716 dwAttr = GetFileAttributesW(lpszPath);
1717 SetErrorMode(iPrevErrMode);
1718 return dwAttr == INVALID_FILE_ATTRIBUTES ? FALSE : TRUE;
1721 /*************************************************************************
1722 * PathFileExistsAndAttributesA [SHLWAPI.445]
1724 * Determine if a file exists.
1726 * PARAMS
1727 * lpszPath [I] Path to check
1728 * dwAttr [O] attributes of file
1730 * RETURNS
1731 * TRUE If the file exists and is readable
1732 * FALSE Otherwise
1734 BOOL WINAPI PathFileExistsAndAttributesA(LPCSTR lpszPath, DWORD *dwAttr)
1736 UINT iPrevErrMode;
1737 DWORD dwVal = 0;
1739 TRACE("(%s %p)\n", debugstr_a(lpszPath), dwAttr);
1741 if (dwAttr)
1742 *dwAttr = INVALID_FILE_ATTRIBUTES;
1744 if (!lpszPath)
1745 return FALSE;
1747 iPrevErrMode = SetErrorMode(SEM_FAILCRITICALERRORS);
1748 dwVal = GetFileAttributesA(lpszPath);
1749 SetErrorMode(iPrevErrMode);
1750 if (dwAttr)
1751 *dwAttr = dwVal;
1752 return (dwVal != INVALID_FILE_ATTRIBUTES);
1755 /*************************************************************************
1756 * PathFileExistsAndAttributesW [SHLWAPI.446]
1758 * See PathFileExistsA.
1760 BOOL WINAPI PathFileExistsAndAttributesW(LPCWSTR lpszPath, DWORD *dwAttr)
1762 UINT iPrevErrMode;
1763 DWORD dwVal;
1765 TRACE("(%s %p)\n", debugstr_w(lpszPath), dwAttr);
1767 if (!lpszPath)
1768 return FALSE;
1770 iPrevErrMode = SetErrorMode(SEM_FAILCRITICALERRORS);
1771 dwVal = GetFileAttributesW(lpszPath);
1772 SetErrorMode(iPrevErrMode);
1773 if (dwAttr)
1774 *dwAttr = dwVal;
1775 return (dwVal != INVALID_FILE_ATTRIBUTES);
1778 /*************************************************************************
1779 * PathMatchSingleMaskA [internal]
1781 static BOOL WINAPI PathMatchSingleMaskA(LPCSTR name, LPCSTR mask)
1783 while (*name && *mask && *mask!=';')
1785 if (*mask == '*')
1789 if (PathMatchSingleMaskA(name,mask+1))
1790 return TRUE; /* try substrings */
1791 } while (*name++);
1792 return FALSE;
1795 if (toupper(*mask) != toupper(*name) && *mask != '?')
1796 return FALSE;
1798 name = CharNextA(name);
1799 mask = CharNextA(mask);
1802 if (!*name)
1804 while (*mask == '*')
1805 mask++;
1806 if (!*mask || *mask == ';')
1807 return TRUE;
1809 return FALSE;
1812 /*************************************************************************
1813 * PathMatchSingleMaskW [internal]
1815 static BOOL WINAPI PathMatchSingleMaskW(LPCWSTR name, LPCWSTR mask)
1817 while (*name && *mask && *mask != ';')
1819 if (*mask == '*')
1823 if (PathMatchSingleMaskW(name,mask+1))
1824 return TRUE; /* try substrings */
1825 } while (*name++);
1826 return FALSE;
1829 if (toupperW(*mask) != toupperW(*name) && *mask != '?')
1830 return FALSE;
1832 name = CharNextW(name);
1833 mask = CharNextW(mask);
1835 if (!*name)
1837 while (*mask == '*')
1838 mask++;
1839 if (!*mask || *mask == ';')
1840 return TRUE;
1842 return FALSE;
1845 /*************************************************************************
1846 * PathMatchSpecA [SHLWAPI.@]
1848 * Determine if a path matches one or more search masks.
1850 * PARAMS
1851 * lpszPath [I] Path to check
1852 * lpszMask [I] Search mask(s)
1854 * RETURNS
1855 * TRUE If lpszPath is valid and is matched
1856 * FALSE Otherwise
1858 * NOTES
1859 * Multiple search masks may be given if they are separated by ";". The
1860 * pattern "*.*" is treated specially in that it matches all paths (for
1861 * backwards compatibility with DOS).
1863 BOOL WINAPI PathMatchSpecA(LPCSTR lpszPath, LPCSTR lpszMask)
1865 TRACE("(%s,%s)\n", lpszPath, lpszMask);
1867 if (!lstrcmpA(lpszMask, "*.*"))
1868 return TRUE; /* Matches every path */
1870 while (*lpszMask)
1872 while (*lpszMask == ' ')
1873 lpszMask++; /* Eat leading spaces */
1875 if (PathMatchSingleMaskA(lpszPath, lpszMask))
1876 return TRUE; /* Matches the current mask */
1878 while (*lpszMask && *lpszMask != ';')
1879 lpszMask = CharNextA(lpszMask); /* masks separated by ';' */
1881 if (*lpszMask == ';')
1882 lpszMask++;
1884 return FALSE;
1887 /*************************************************************************
1888 * PathMatchSpecW [SHLWAPI.@]
1890 * See PathMatchSpecA.
1892 BOOL WINAPI PathMatchSpecW(LPCWSTR lpszPath, LPCWSTR lpszMask)
1894 static const WCHAR szStarDotStar[] = { '*', '.', '*', '\0' };
1896 TRACE("(%s,%s)\n", debugstr_w(lpszPath), debugstr_w(lpszMask));
1898 if (!lstrcmpW(lpszMask, szStarDotStar))
1899 return TRUE; /* Matches every path */
1901 while (*lpszMask)
1903 while (*lpszMask == ' ')
1904 lpszMask++; /* Eat leading spaces */
1906 if (PathMatchSingleMaskW(lpszPath, lpszMask))
1907 return TRUE; /* Matches the current path */
1909 while (*lpszMask && *lpszMask != ';')
1910 lpszMask++; /* masks separated by ';' */
1912 if (*lpszMask == ';')
1913 lpszMask++;
1915 return FALSE;
1918 /*************************************************************************
1919 * PathIsSameRootA [SHLWAPI.@]
1921 * Determine if two paths share the same root.
1923 * PARAMS
1924 * lpszPath1 [I] Source path
1925 * lpszPath2 [I] Path to compare with
1927 * RETURNS
1928 * TRUE If both paths are valid and share the same root.
1929 * FALSE If either path is invalid or the paths do not share the same root.
1931 BOOL WINAPI PathIsSameRootA(LPCSTR lpszPath1, LPCSTR lpszPath2)
1933 LPCSTR lpszStart;
1934 int dwLen;
1936 TRACE("(%s,%s)\n", debugstr_a(lpszPath1), debugstr_a(lpszPath2));
1938 if (!lpszPath1 || !lpszPath2 || !(lpszStart = PathSkipRootA(lpszPath1)))
1939 return FALSE;
1941 dwLen = PathCommonPrefixA(lpszPath1, lpszPath2, NULL) + 1;
1942 if (lpszStart - lpszPath1 > dwLen)
1943 return FALSE; /* Paths not common up to length of the root */
1944 return TRUE;
1947 /*************************************************************************
1948 * PathIsSameRootW [SHLWAPI.@]
1950 * See PathIsSameRootA.
1952 BOOL WINAPI PathIsSameRootW(LPCWSTR lpszPath1, LPCWSTR lpszPath2)
1954 LPCWSTR lpszStart;
1955 int dwLen;
1957 TRACE("(%s,%s)\n", debugstr_w(lpszPath1), debugstr_w(lpszPath2));
1959 if (!lpszPath1 || !lpszPath2 || !(lpszStart = PathSkipRootW(lpszPath1)))
1960 return FALSE;
1962 dwLen = PathCommonPrefixW(lpszPath1, lpszPath2, NULL) + 1;
1963 if (lpszStart - lpszPath1 > dwLen)
1964 return FALSE; /* Paths not common up to length of the root */
1965 return TRUE;
1968 /*************************************************************************
1969 * PathIsContentTypeA [SHLWAPI.@]
1971 * Determine if a file is of a given registered content type.
1973 * PARAMS
1974 * lpszPath [I] File to check
1975 * lpszContentType [I] Content type to check for
1977 * RETURNS
1978 * TRUE If lpszPath is a given registered content type,
1979 * FALSE Otherwise.
1981 * NOTES
1982 * This function looks up the registered content type for lpszPath. If
1983 * a content type is registered, it is compared (case insensitively) to
1984 * lpszContentType. Only if this matches does the function succeed.
1986 BOOL WINAPI PathIsContentTypeA(LPCSTR lpszPath, LPCSTR lpszContentType)
1988 LPCSTR szExt;
1989 DWORD dwDummy;
1990 char szBuff[MAX_PATH];
1992 TRACE("(%s,%s)\n", debugstr_a(lpszPath), debugstr_a(lpszContentType));
1994 if (lpszPath && (szExt = PathFindExtensionA(lpszPath)) && *szExt &&
1995 !SHGetValueA(HKEY_CLASSES_ROOT, szExt, "Content Type",
1996 REG_NONE, szBuff, &dwDummy) &&
1997 !strcasecmp(lpszContentType, szBuff))
1999 return TRUE;
2001 return FALSE;
2004 /*************************************************************************
2005 * PathIsContentTypeW [SHLWAPI.@]
2007 * See PathIsContentTypeA.
2009 BOOL WINAPI PathIsContentTypeW(LPCWSTR lpszPath, LPCWSTR lpszContentType)
2011 static const WCHAR szContentType[] = { 'C','o','n','t','e','n','t',' ','T','y','p','e','\0' };
2012 LPCWSTR szExt;
2013 DWORD dwDummy;
2014 WCHAR szBuff[MAX_PATH];
2016 TRACE("(%s,%s)\n", debugstr_w(lpszPath), debugstr_w(lpszContentType));
2018 if (lpszPath && (szExt = PathFindExtensionW(lpszPath)) && *szExt &&
2019 !SHGetValueW(HKEY_CLASSES_ROOT, szExt, szContentType,
2020 REG_NONE, szBuff, &dwDummy) &&
2021 !strcmpiW(lpszContentType, szBuff))
2023 return TRUE;
2025 return FALSE;
2028 /*************************************************************************
2029 * PathIsFileSpecA [SHLWAPI.@]
2031 * Determine if a path is a file specification.
2033 * PARAMS
2034 * lpszPath [I] Path to chack
2036 * RETURNS
2037 * TRUE If lpszPath is a file specification (i.e. Contains no directories).
2038 * FALSE Otherwise.
2040 BOOL WINAPI PathIsFileSpecA(LPCSTR lpszPath)
2042 TRACE("(%s)\n", debugstr_a(lpszPath));
2044 if (!lpszPath)
2045 return FALSE;
2047 while (*lpszPath)
2049 if (*lpszPath == '\\' || *lpszPath == ':')
2050 return FALSE;
2051 lpszPath = CharNextA(lpszPath);
2053 return TRUE;
2056 /*************************************************************************
2057 * PathIsFileSpecW [SHLWAPI.@]
2059 * See PathIsFileSpecA.
2061 BOOL WINAPI PathIsFileSpecW(LPCWSTR lpszPath)
2063 TRACE("(%s)\n", debugstr_w(lpszPath));
2065 if (!lpszPath)
2066 return FALSE;
2068 while (*lpszPath)
2070 if (*lpszPath == '\\' || *lpszPath == ':')
2071 return FALSE;
2072 lpszPath = CharNextW(lpszPath);
2074 return TRUE;
2077 /*************************************************************************
2078 * PathIsPrefixA [SHLWAPI.@]
2080 * Determine if a path is a prefix of another.
2082 * PARAMS
2083 * lpszPrefix [I] Prefix
2084 * lpszPath [I] Path to check
2086 * RETURNS
2087 * TRUE If lpszPath has lpszPrefix as its prefix,
2088 * FALSE If either path is NULL or lpszPrefix is not a prefix
2090 BOOL WINAPI PathIsPrefixA (LPCSTR lpszPrefix, LPCSTR lpszPath)
2092 TRACE("(%s,%s)\n", debugstr_a(lpszPrefix), debugstr_a(lpszPath));
2094 if (lpszPrefix && lpszPath &&
2095 PathCommonPrefixA(lpszPath, lpszPrefix, NULL) == (int)strlen(lpszPrefix))
2096 return TRUE;
2097 return FALSE;
2100 /*************************************************************************
2101 * PathIsPrefixW [SHLWAPI.@]
2103 * See PathIsPrefixA.
2105 BOOL WINAPI PathIsPrefixW(LPCWSTR lpszPrefix, LPCWSTR lpszPath)
2107 TRACE("(%s,%s)\n", debugstr_w(lpszPrefix), debugstr_w(lpszPath));
2109 if (lpszPrefix && lpszPath &&
2110 PathCommonPrefixW(lpszPath, lpszPrefix, NULL) == (int)strlenW(lpszPrefix))
2111 return TRUE;
2112 return FALSE;
2115 /*************************************************************************
2116 * PathIsSystemFolderA [SHLWAPI.@]
2118 * Determine if a path or file attributes are a system folder.
2120 * PARAMS
2121 * lpszPath [I] Path to check.
2122 * dwAttrib [I] Attributes to check, if lpszPath is NULL.
2124 * RETURNS
2125 * TRUE If lpszPath or dwAttrib are a system folder.
2126 * FALSE If GetFileAttributesA() fails or neither parameter is a system folder.
2128 BOOL WINAPI PathIsSystemFolderA(LPCSTR lpszPath, DWORD dwAttrib)
2130 TRACE("(%s,0x%08lx)\n", debugstr_a(lpszPath), dwAttrib);
2132 if (lpszPath && *lpszPath)
2133 dwAttrib = GetFileAttributesA(lpszPath);
2135 if (dwAttrib == INVALID_FILE_ATTRIBUTES || !(dwAttrib & FILE_ATTRIBUTE_DIRECTORY) ||
2136 !(dwAttrib & (FILE_ATTRIBUTE_SYSTEM | FILE_ATTRIBUTE_READONLY)))
2137 return FALSE;
2138 return TRUE;
2141 /*************************************************************************
2142 * PathIsSystemFolderW [SHLWAPI.@]
2144 * See PathIsSystemFolderA.
2146 BOOL WINAPI PathIsSystemFolderW(LPCWSTR lpszPath, DWORD dwAttrib)
2148 TRACE("(%s,0x%08lx)\n", debugstr_w(lpszPath), dwAttrib);
2150 if (lpszPath && *lpszPath)
2151 dwAttrib = GetFileAttributesW(lpszPath);
2153 if (dwAttrib == INVALID_FILE_ATTRIBUTES || !(dwAttrib & FILE_ATTRIBUTE_DIRECTORY) ||
2154 !(dwAttrib & (FILE_ATTRIBUTE_SYSTEM | FILE_ATTRIBUTE_READONLY)))
2155 return FALSE;
2156 return TRUE;
2159 /*************************************************************************
2160 * PathIsUNCA [SHLWAPI.@]
2162 * Determine if a path is in UNC format.
2164 * PARAMS
2165 * lpszPath [I] Path to check
2167 * RETURNS
2168 * TRUE: The path is UNC.
2169 * FALSE: The path is not UNC or is NULL.
2171 BOOL WINAPI PathIsUNCA(LPCSTR lpszPath)
2173 TRACE("(%s)\n",debugstr_a(lpszPath));
2175 if (lpszPath && (lpszPath[0]=='\\') && (lpszPath[1]=='\\'))
2176 return TRUE;
2177 return FALSE;
2180 /*************************************************************************
2181 * PathIsUNCW [SHLWAPI.@]
2183 * See PathIsUNCA.
2185 BOOL WINAPI PathIsUNCW(LPCWSTR lpszPath)
2187 TRACE("(%s)\n",debugstr_w(lpszPath));
2189 if (lpszPath && (lpszPath[0]=='\\') && (lpszPath[1]=='\\'))
2190 return TRUE;
2191 return FALSE;
2194 /*************************************************************************
2195 * PathIsUNCServerA [SHLWAPI.@]
2197 * Determine if a path is a UNC server name ("\\SHARENAME").
2199 * PARAMS
2200 * lpszPath [I] Path to check.
2202 * RETURNS
2203 * TRUE If lpszPath is a valid UNC server name.
2204 * FALSE Otherwise.
2206 * NOTES
2207 * This routine is bug compatible with Win32: Server names with a
2208 * trailing backslash (e.g. "\\FOO\"), return FALSE incorrectly.
2209 * Fixing this bug may break other shlwapi functions!
2211 BOOL WINAPI PathIsUNCServerA(LPCSTR lpszPath)
2213 TRACE("(%s)\n", debugstr_a(lpszPath));
2215 if (lpszPath && *lpszPath++ == '\\' && *lpszPath++ == '\\')
2217 while (*lpszPath)
2219 if (*lpszPath == '\\')
2220 return FALSE;
2221 lpszPath = CharNextA(lpszPath);
2223 return TRUE;
2225 return FALSE;
2228 /*************************************************************************
2229 * PathIsUNCServerW [SHLWAPI.@]
2231 * See PathIsUNCServerA.
2233 BOOL WINAPI PathIsUNCServerW(LPCWSTR lpszPath)
2235 TRACE("(%s)\n", debugstr_w(lpszPath));
2237 if (lpszPath && *lpszPath++ == '\\' && *lpszPath++ == '\\')
2239 while (*lpszPath)
2241 if (*lpszPath == '\\')
2242 return FALSE;
2243 lpszPath = CharNextW(lpszPath);
2245 return TRUE;
2247 return FALSE;
2250 /*************************************************************************
2251 * PathIsUNCServerShareA [SHLWAPI.@]
2253 * Determine if a path is a UNC server share ("\\SHARENAME\SHARE").
2255 * PARAMS
2256 * lpszPath [I] Path to check.
2258 * RETURNS
2259 * TRUE If lpszPath is a valid UNC server share.
2260 * FALSE Otherwise.
2262 * NOTES
2263 * This routine is bug compatible with Win32: Server shares with a
2264 * trailing backslash (e.g. "\\FOO\BAR\"), return FALSE incorrectly.
2265 * Fixing this bug may break other shlwapi functions!
2267 BOOL WINAPI PathIsUNCServerShareA(LPCSTR lpszPath)
2269 TRACE("(%s)\n", debugstr_a(lpszPath));
2271 if (lpszPath && *lpszPath++ == '\\' && *lpszPath++ == '\\')
2273 BOOL bSeenSlash = FALSE;
2274 while (*lpszPath)
2276 if (*lpszPath == '\\')
2278 if (bSeenSlash)
2279 return FALSE;
2280 bSeenSlash = TRUE;
2282 lpszPath = CharNextA(lpszPath);
2284 return bSeenSlash;
2286 return FALSE;
2289 /*************************************************************************
2290 * PathIsUNCServerShareW [SHLWAPI.@]
2292 * See PathIsUNCServerShareA.
2294 BOOL WINAPI PathIsUNCServerShareW(LPCWSTR lpszPath)
2296 TRACE("(%s)\n", debugstr_w(lpszPath));
2298 if (lpszPath && *lpszPath++ == '\\' && *lpszPath++ == '\\')
2300 BOOL bSeenSlash = FALSE;
2301 while (*lpszPath)
2303 if (*lpszPath == '\\')
2305 if (bSeenSlash)
2306 return FALSE;
2307 bSeenSlash = TRUE;
2309 lpszPath = CharNextW(lpszPath);
2311 return bSeenSlash;
2313 return FALSE;
2316 /*************************************************************************
2317 * PathCanonicalizeA [SHLWAPI.@]
2319 * Convert a path to its canonical form.
2321 * PARAMS
2322 * lpszBuf [O] Output path
2323 * lpszPath [I] Path to cnonicalize
2325 * RETURNS
2326 * Success: TRUE. lpszBuf contains the output path,
2327 * Failure: FALSE, If input path is invalid. lpszBuf is undefined
2329 BOOL WINAPI PathCanonicalizeA(LPSTR lpszBuf, LPCSTR lpszPath)
2331 BOOL bRet = FALSE;
2333 TRACE("(%p,%s)\n", lpszBuf, debugstr_a(lpszPath));
2335 if (lpszBuf)
2336 *lpszBuf = '\0';
2338 if (!lpszBuf || !lpszPath)
2339 SetLastError(ERROR_INVALID_PARAMETER);
2340 else
2342 WCHAR szPath[MAX_PATH];
2343 WCHAR szBuff[MAX_PATH];
2344 MultiByteToWideChar(CP_ACP,0,lpszPath,-1,szPath,MAX_PATH);
2345 bRet = PathCanonicalizeW(szBuff, szPath);
2346 WideCharToMultiByte(CP_ACP,0,szBuff,-1,lpszBuf,MAX_PATH,0,0);
2348 return bRet;
2352 /*************************************************************************
2353 * PathCanonicalizeW [SHLWAPI.@]
2355 * See PathCanonicalizeA.
2357 BOOL WINAPI PathCanonicalizeW(LPWSTR lpszBuf, LPCWSTR lpszPath)
2359 LPWSTR lpszDst = lpszBuf;
2360 LPCWSTR lpszSrc = lpszPath;
2362 TRACE("(%p,%s)\n", lpszBuf, debugstr_w(lpszPath));
2364 if (lpszBuf)
2365 *lpszDst = '\0';
2367 if (!lpszBuf || !lpszPath)
2369 SetLastError(ERROR_INVALID_PARAMETER);
2370 return FALSE;
2373 if (!*lpszPath)
2375 *lpszBuf++ = '\\';
2376 *lpszBuf = '\0';
2377 return TRUE;
2380 /* Copy path root */
2381 if (*lpszSrc == '\\')
2383 *lpszDst++ = *lpszSrc++;
2385 else if (*lpszSrc && lpszSrc[1] == ':')
2387 /* X:\ */
2388 *lpszDst++ = *lpszSrc++;
2389 *lpszDst++ = *lpszSrc++;
2390 if (*lpszSrc == '\\')
2391 *lpszDst++ = *lpszSrc++;
2394 /* Canonicalize the rest of the path */
2395 while (*lpszSrc)
2397 if (*lpszSrc == '.')
2399 if (lpszSrc[1] == '\\' && (lpszSrc == lpszPath || lpszSrc[-1] == '\\' || lpszSrc[-1] == ':'))
2401 lpszSrc += 2; /* Skip .\ */
2403 else if (lpszSrc[1] == '.' && (lpszDst == lpszBuf || lpszDst[-1] == '\\'))
2405 /* \.. backs up a directory, over the root if it has no \ following X:.
2406 * .. is ignored if it would remove a UNC server name or inital \\
2408 if (lpszDst != lpszBuf)
2410 *lpszDst = '\0'; /* Allow PathIsUNCServerShareA test on lpszBuf */
2411 if (lpszDst > lpszBuf+1 && lpszDst[-1] == '\\' &&
2412 (lpszDst[-2] != '\\' || lpszDst > lpszBuf+2))
2414 if (lpszDst[-2] == ':' && (lpszDst > lpszBuf+3 || lpszDst[-3] == ':'))
2416 lpszDst -= 2;
2417 while (lpszDst > lpszBuf && *lpszDst != '\\')
2418 lpszDst--;
2419 if (*lpszDst == '\\')
2420 lpszDst++; /* Reset to last '\' */
2421 else
2422 lpszDst = lpszBuf; /* Start path again from new root */
2424 else if (lpszDst[-2] != ':' && !PathIsUNCServerShareW(lpszBuf))
2425 lpszDst -= 2;
2427 while (lpszDst > lpszBuf && *lpszDst != '\\')
2428 lpszDst--;
2429 if (lpszDst == lpszBuf)
2431 *lpszDst++ = '\\';
2432 lpszSrc++;
2435 lpszSrc += 2; /* Skip .. in src path */
2437 else
2438 *lpszDst++ = *lpszSrc++;
2440 else
2441 *lpszDst++ = *lpszSrc++;
2443 /* Append \ to naked drive specs */
2444 if (lpszDst - lpszBuf == 2 && lpszDst[-1] == ':')
2445 *lpszDst++ = '\\';
2446 *lpszDst++ = '\0';
2447 return TRUE;
2450 /*************************************************************************
2451 * PathFindNextComponentA [SHLWAPI.@]
2453 * Find the next component in a path.
2455 * PARAMS
2456 * lpszPath [I] Path to find next component in
2458 * RETURNS
2459 * Success: A pointer to the next component, or the end of the string.
2460 * Failure: NULL, If lpszPath is invalid
2462 * NOTES
2463 * A 'component' is either a backslash character (\) or UNC marker (\\).
2464 * Because of this, relative paths (e.g "c:foo") are regarded as having
2465 * only one component.
2467 LPSTR WINAPI PathFindNextComponentA(LPCSTR lpszPath)
2469 LPSTR lpszSlash;
2471 TRACE("(%s)\n", debugstr_a(lpszPath));
2473 if(!lpszPath || !*lpszPath)
2474 return NULL;
2476 if ((lpszSlash = StrChrA(lpszPath, '\\')))
2478 if (lpszSlash[1] == '\\')
2479 lpszSlash++;
2480 return lpszSlash + 1;
2482 return (LPSTR)lpszPath + strlen(lpszPath);
2485 /*************************************************************************
2486 * PathFindNextComponentW [SHLWAPI.@]
2488 * See PathFindNextComponentA.
2490 LPWSTR WINAPI PathFindNextComponentW(LPCWSTR lpszPath)
2492 LPWSTR lpszSlash;
2494 TRACE("(%s)\n", debugstr_w(lpszPath));
2496 if(!lpszPath || !*lpszPath)
2497 return NULL;
2499 if ((lpszSlash = StrChrW(lpszPath, '\\')))
2501 if (lpszSlash[1] == '\\')
2502 lpszSlash++;
2503 return lpszSlash + 1;
2505 return (LPWSTR)lpszPath + strlenW(lpszPath);
2508 /*************************************************************************
2509 * PathAddExtensionA [SHLWAPI.@]
2511 * Add a file extension to a path
2513 * PARAMS
2514 * lpszPath [I/O] Path to add extension to
2515 * lpszExtension [I] Extension to add to lpszPath
2517 * RETURNS
2518 * TRUE If the path was modified,
2519 * FALSE If lpszPath or lpszExtension are invalid, lpszPath has an
2520 * extension already, or the new path length is too big.
2522 * FIXME
2523 * What version of shlwapi.dll adds "exe" if lpszExtension is NULL? Win2k
2524 * does not do this, so the behaviour was removed.
2526 BOOL WINAPI PathAddExtensionA(LPSTR lpszPath, LPCSTR lpszExtension)
2528 size_t dwLen;
2530 TRACE("(%s,%s)\n", debugstr_a(lpszPath), debugstr_a(lpszExtension));
2532 if (!lpszPath || !lpszExtension || *(PathFindExtensionA(lpszPath)))
2533 return FALSE;
2535 dwLen = strlen(lpszPath);
2537 if (dwLen + strlen(lpszExtension) >= MAX_PATH)
2538 return FALSE;
2540 strcpy(lpszPath + dwLen, lpszExtension);
2541 return TRUE;
2544 /*************************************************************************
2545 * PathAddExtensionW [SHLWAPI.@]
2547 * See PathAddExtensionA.
2549 BOOL WINAPI PathAddExtensionW(LPWSTR lpszPath, LPCWSTR lpszExtension)
2551 size_t dwLen;
2553 TRACE("(%s,%s)\n", debugstr_w(lpszPath), debugstr_w(lpszExtension));
2555 if (!lpszPath || !lpszExtension || *(PathFindExtensionW(lpszPath)))
2556 return FALSE;
2558 dwLen = strlenW(lpszPath);
2560 if (dwLen + strlenW(lpszExtension) >= MAX_PATH)
2561 return FALSE;
2563 strcpyW(lpszPath + dwLen, lpszExtension);
2564 return TRUE;
2567 /*************************************************************************
2568 * PathMakePrettyA [SHLWAPI.@]
2570 * Convert an uppercase DOS filename into lowercase.
2572 * PARAMS
2573 * lpszPath [I/O] Path to convert.
2575 * RETURNS
2576 * TRUE If the path was an uppercase DOS path and was converted,
2577 * FALSE Otherwise.
2579 BOOL WINAPI PathMakePrettyA(LPSTR lpszPath)
2581 LPSTR pszIter = lpszPath;
2583 TRACE("(%s)\n", debugstr_a(lpszPath));
2585 if (!pszIter)
2586 return FALSE;
2588 if (*pszIter)
2592 if (islower(*pszIter) || IsDBCSLeadByte(*pszIter))
2593 return FALSE; /* Not DOS path */
2594 pszIter++;
2595 } while (*pszIter);
2596 pszIter = lpszPath + 1;
2597 while (*pszIter)
2599 *pszIter = tolower(*pszIter);
2600 pszIter++;
2603 return TRUE;
2606 /*************************************************************************
2607 * PathMakePrettyW [SHLWAPI.@]
2609 * See PathMakePrettyA.
2611 BOOL WINAPI PathMakePrettyW(LPWSTR lpszPath)
2613 LPWSTR pszIter = lpszPath;
2615 TRACE("(%s)\n", debugstr_w(lpszPath));
2617 if (!pszIter)
2618 return FALSE;
2620 if (*pszIter)
2624 if (islowerW(*pszIter))
2625 return FALSE; /* Not DOS path */
2626 pszIter++;
2627 } while (*pszIter);
2628 pszIter = lpszPath + 1;
2629 while (*pszIter)
2631 *pszIter = tolowerW(*pszIter);
2632 pszIter++;
2635 return TRUE;
2638 /*************************************************************************
2639 * PathCommonPrefixA [SHLWAPI.@]
2641 * Determine the length of the common prefix between two paths.
2643 * PARAMS
2644 * lpszFile1 [I] First path for comparison
2645 * lpszFile2 [I] Second path for comparison
2646 * achPath [O] Destination for common prefix string
2648 * RETURNS
2649 * The length of the common prefix. This is 0 if there is no common
2650 * prefix between the paths or if any parameters are invalid. If the prefix
2651 * is non-zero and achPath is not NULL, achPath is filled with the common
2652 * part of the prefix and NUL terminated.
2654 * NOTES
2655 * A common prefix of 2 is always returned as 3. It is thus possible for
2656 * the length returned to be invalid (i.e. Longer than one or both of the
2657 * strings given as parameters). This Win32 behaviour has been implemented
2658 * here, and cannot be changed (fixed?) without breaking other SHLWAPI calls.
2659 * To work around this when using this function, always check that the byte
2660 * at [common_prefix_len-1] is not a NUL. If it is, deduct 1 from the prefix.
2662 int WINAPI PathCommonPrefixA(LPCSTR lpszFile1, LPCSTR lpszFile2, LPSTR achPath)
2664 size_t iLen = 0;
2665 LPCSTR lpszIter1 = lpszFile1;
2666 LPCSTR lpszIter2 = lpszFile2;
2668 TRACE("(%s,%s,%p)\n", debugstr_a(lpszFile1), debugstr_a(lpszFile2), achPath);
2670 if (achPath)
2671 *achPath = '\0';
2673 if (!lpszFile1 || !lpszFile2)
2674 return 0;
2676 /* Handle roots first */
2677 if (PathIsUNCA(lpszFile1))
2679 if (!PathIsUNCA(lpszFile2))
2680 return 0;
2681 lpszIter1 += 2;
2682 lpszIter2 += 2;
2684 else if (PathIsUNCA(lpszFile2))
2685 return 0; /* Know already lpszFile1 is not UNC */
2689 /* Update len */
2690 if ((!*lpszIter1 || *lpszIter1 == '\\') &&
2691 (!*lpszIter2 || *lpszIter2 == '\\'))
2692 iLen = lpszIter1 - lpszFile1; /* Common to this point */
2694 if (!*lpszIter1 || (tolower(*lpszIter1) != tolower(*lpszIter2)))
2695 break; /* Strings differ at this point */
2697 lpszIter1++;
2698 lpszIter2++;
2699 } while (1);
2701 if (iLen == 2)
2702 iLen++; /* Feature/Bug compatible with Win32 */
2704 if (iLen && achPath)
2706 memcpy(achPath,lpszFile1,iLen);
2707 achPath[iLen] = '\0';
2709 return iLen;
2712 /*************************************************************************
2713 * PathCommonPrefixW [SHLWAPI.@]
2715 * See PathCommonPrefixA.
2717 int WINAPI PathCommonPrefixW(LPCWSTR lpszFile1, LPCWSTR lpszFile2, LPWSTR achPath)
2719 size_t iLen = 0;
2720 LPCWSTR lpszIter1 = lpszFile1;
2721 LPCWSTR lpszIter2 = lpszFile2;
2723 TRACE("(%s,%s,%p)\n", debugstr_w(lpszFile1), debugstr_w(lpszFile2), achPath);
2725 if (achPath)
2726 *achPath = '\0';
2728 if (!lpszFile1 || !lpszFile2)
2729 return 0;
2731 /* Handle roots first */
2732 if (PathIsUNCW(lpszFile1))
2734 if (!PathIsUNCW(lpszFile2))
2735 return 0;
2736 lpszIter1 += 2;
2737 lpszIter2 += 2;
2739 else if (PathIsUNCW(lpszFile2))
2740 return 0; /* Know already lpszFile1 is not UNC */
2744 /* Update len */
2745 if ((!*lpszIter1 || *lpszIter1 == '\\') &&
2746 (!*lpszIter2 || *lpszIter2 == '\\'))
2747 iLen = lpszIter1 - lpszFile1; /* Common to this point */
2749 if (!*lpszIter1 || (tolowerW(*lpszIter1) != tolowerW(*lpszIter2)))
2750 break; /* Strings differ at this point */
2752 lpszIter1++;
2753 lpszIter2++;
2754 } while (1);
2756 if (iLen == 2)
2757 iLen++; /* Feature/Bug compatible with Win32 */
2759 if (iLen && achPath)
2761 memcpy(achPath,lpszFile1,iLen * sizeof(WCHAR));
2762 achPath[iLen] = '\0';
2764 return iLen;
2767 /*************************************************************************
2768 * PathCompactPathA [SHLWAPI.@]
2770 * Make a path fit into a given width when printed to a DC.
2772 * PARAMS
2773 * hDc [I] Destination DC
2774 * lpszPath [I/O] Path to be printed to hDc
2775 * dx [I] Desired width
2777 * RETURNS
2778 * TRUE If the path was modified/went well.
2779 * FALSE Otherwise.
2781 BOOL WINAPI PathCompactPathA(HDC hDC, LPSTR lpszPath, UINT dx)
2783 BOOL bRet = FALSE;
2785 TRACE("(%p,%s,%d)\n", hDC, debugstr_a(lpszPath), dx);
2787 if (lpszPath)
2789 WCHAR szPath[MAX_PATH];
2790 MultiByteToWideChar(CP_ACP,0,lpszPath,-1,szPath,MAX_PATH);
2791 bRet = PathCompactPathW(hDC, szPath, dx);
2792 WideCharToMultiByte(CP_ACP,0,szPath,-1,lpszPath,MAX_PATH,0,0);
2794 return bRet;
2797 /*************************************************************************
2798 * PathCompactPathW [SHLWAPI.@]
2800 * See PathCompactPathA.
2802 BOOL WINAPI PathCompactPathW(HDC hDC, LPWSTR lpszPath, UINT dx)
2804 static const WCHAR szEllipses[] = { '.', '.', '.', '\0' };
2805 BOOL bRet = TRUE;
2806 HDC hdc = 0;
2807 WCHAR buff[MAX_PATH];
2808 SIZE size;
2809 DWORD dwLen;
2811 TRACE("(%p,%s,%d)\n", hDC, debugstr_w(lpszPath), dx);
2813 if (!lpszPath)
2814 return FALSE;
2816 if (!hDC)
2817 hdc = hDC = GetDC(0);
2819 /* Get the length of the whole path */
2820 dwLen = strlenW(lpszPath);
2821 GetTextExtentPointW(hDC, lpszPath, dwLen, &size);
2823 if ((UINT)size.cx > dx)
2825 /* Path too big, must reduce it */
2826 LPWSTR sFile;
2827 DWORD dwEllipsesLen = 0, dwPathLen = 0;
2829 sFile = PathFindFileNameW(lpszPath);
2830 if (sFile != lpszPath)
2831 sFile = CharPrevW(lpszPath, sFile);
2833 /* Get the size of ellipses */
2834 GetTextExtentPointW(hDC, szEllipses, 3, &size);
2835 dwEllipsesLen = size.cx;
2836 /* Get the size of the file name */
2837 GetTextExtentPointW(hDC, sFile, strlenW(sFile), &size);
2838 dwPathLen = size.cx;
2840 if (sFile != lpszPath)
2842 LPWSTR sPath = sFile;
2843 BOOL bEllipses = FALSE;
2845 /* The path includes a file name. Include as much of the path prior to
2846 * the file name as possible, allowing for the ellipses, e.g:
2847 * c:\some very long path\filename ==> c:\some v...\filename
2849 lstrcpynW(buff, sFile, MAX_PATH);
2853 DWORD dwTotalLen = bEllipses? dwPathLen + dwEllipsesLen : dwPathLen;
2855 GetTextExtentPointW(hDC, lpszPath, sPath - lpszPath, &size);
2856 dwTotalLen += size.cx;
2857 if (dwTotalLen <= dx)
2858 break;
2859 sPath = CharPrevW(lpszPath, sPath);
2860 if (!bEllipses)
2862 bEllipses = TRUE;
2863 sPath = CharPrevW(lpszPath, sPath);
2864 sPath = CharPrevW(lpszPath, sPath);
2866 } while (sPath > lpszPath);
2868 if (sPath > lpszPath)
2870 if (bEllipses)
2872 strcpyW(sPath, szEllipses);
2873 strcpyW(sPath+3, buff);
2875 bRet = TRUE;
2876 goto end;
2878 strcpyW(lpszPath, szEllipses);
2879 strcpyW(lpszPath+3, buff);
2880 bRet = FALSE;
2881 goto end;
2884 /* Trim the path by adding ellipses to the end, e.g:
2885 * A very long file name.txt ==> A very...
2887 dwLen = strlenW(lpszPath);
2889 if (dwLen > MAX_PATH - 3)
2890 dwLen = MAX_PATH - 3;
2891 lstrcpynW(buff, sFile, dwLen);
2893 do {
2894 dwLen--;
2895 GetTextExtentPointW(hDC, buff, dwLen, &size);
2896 } while (dwLen && size.cx + dwEllipsesLen > dx);
2898 if (!dwLen)
2900 DWORD dwWritten = 0;
2902 dwEllipsesLen /= 3; /* Size of a single '.' */
2904 /* Write as much of the Ellipses string as possible */
2905 while (dwWritten + dwEllipsesLen < dx && dwLen < 3)
2907 *lpszPath++ = '.';
2908 dwWritten += dwEllipsesLen;
2909 dwLen++;
2911 *lpszPath = '\0';
2912 bRet = FALSE;
2914 else
2916 strcpyW(buff + dwLen, szEllipses);
2917 strcpyW(lpszPath, buff);
2921 end:
2922 if (hdc)
2923 ReleaseDC(0, hdc);
2925 return bRet;
2928 /*************************************************************************
2929 * PathGetCharTypeA [SHLWAPI.@]
2931 * Categorise a character from a file path.
2933 * PARAMS
2934 * ch [I] Character to get the type of
2936 * RETURNS
2937 * A set of GCT_ bit flags (from "shlwapi.h") indicating the character type.
2939 UINT WINAPI PathGetCharTypeA(UCHAR ch)
2941 return PathGetCharTypeW(ch);
2944 /*************************************************************************
2945 * PathGetCharTypeW [SHLWAPI.@]
2947 * See PathGetCharTypeA.
2949 UINT WINAPI PathGetCharTypeW(WCHAR ch)
2951 UINT flags = 0;
2953 TRACE("(%d)\n", ch);
2955 if (!ch || ch < ' ' || ch == '<' || ch == '>' ||
2956 ch == '"' || ch == '|' || ch == '/')
2957 flags = GCT_INVALID; /* Invalid */
2958 else if (ch == '*' || ch=='?')
2959 flags = GCT_WILD; /* Wildchars */
2960 else if ((ch == '\\') || (ch == ':'))
2961 return GCT_SEPARATOR; /* Path separators */
2962 else
2964 if (ch < 126)
2966 if ((ch & 0x1 && ch != ';') || !ch || isalnum(ch) || ch == '$' || ch == '&' || ch == '(' ||
2967 ch == '.' || ch == '@' || ch == '^' ||
2968 ch == '\'' || ch == 130 || ch == '`')
2969 flags |= GCT_SHORTCHAR; /* All these are valid for DOS */
2971 else
2972 flags |= GCT_SHORTCHAR; /* Bug compatible with win32 */
2973 flags |= GCT_LFNCHAR; /* Valid for long file names */
2975 return flags;
2978 /*************************************************************************
2979 * SHLWAPI_UseSystemForSystemFolders
2981 * Internal helper for PathMakeSystemFolderW.
2983 static BOOL WINAPI SHLWAPI_UseSystemForSystemFolders(void)
2985 static BOOL bCheckedReg = FALSE;
2986 static BOOL bUseSystemForSystemFolders = FALSE;
2988 if (!bCheckedReg)
2990 bCheckedReg = TRUE;
2992 /* Key tells Win what file attributes to use on system folders */
2993 if (SHGetValueA(HKEY_LOCAL_MACHINE,
2994 "Software\\Microsoft\\Windows\\CurrentVersion\\Explorer",
2995 "UseSystemForSystemFolders", 0, 0, 0))
2996 bUseSystemForSystemFolders = TRUE;
2998 return bUseSystemForSystemFolders;
3001 /*************************************************************************
3002 * PathMakeSystemFolderA [SHLWAPI.@]
3004 * Set system folder attribute for a path.
3006 * PARAMS
3007 * lpszPath [I] The path to turn into a system folder
3009 * RETURNS
3010 * TRUE If the path was changed to/already was a system folder
3011 * FALSE If the path is invalid or SetFileAttributesA() fails
3013 BOOL WINAPI PathMakeSystemFolderA(LPCSTR lpszPath)
3015 BOOL bRet = FALSE;
3017 TRACE("(%s)\n", debugstr_a(lpszPath));
3019 if (lpszPath && *lpszPath)
3021 WCHAR szPath[MAX_PATH];
3022 MultiByteToWideChar(CP_ACP,0,lpszPath,-1,szPath,MAX_PATH);
3023 bRet = PathMakeSystemFolderW(szPath);
3025 return bRet;
3028 /*************************************************************************
3029 * PathMakeSystemFolderW [SHLWAPI.@]
3031 * See PathMakeSystemFolderA.
3033 BOOL WINAPI PathMakeSystemFolderW(LPCWSTR lpszPath)
3035 DWORD dwDefaultAttr = FILE_ATTRIBUTE_READONLY, dwAttr;
3036 WCHAR buff[MAX_PATH];
3038 TRACE("(%s)\n", debugstr_w(lpszPath));
3040 if (!lpszPath || !*lpszPath)
3041 return FALSE;
3043 /* If the directory is already a system directory, don't do anything */
3044 GetSystemDirectoryW(buff, MAX_PATH);
3045 if (!strcmpW(buff, lpszPath))
3046 return TRUE;
3048 GetWindowsDirectoryW(buff, MAX_PATH);
3049 if (!strcmpW(buff, lpszPath))
3050 return TRUE;
3052 /* "UseSystemForSystemFolders" Tells Win what attributes to use */
3053 if (SHLWAPI_UseSystemForSystemFolders())
3054 dwDefaultAttr = FILE_ATTRIBUTE_SYSTEM;
3056 if ((dwAttr = GetFileAttributesW(lpszPath)) == INVALID_FILE_ATTRIBUTES)
3057 return FALSE;
3059 /* Change file attributes to system attributes */
3060 dwAttr &= ~(FILE_ATTRIBUTE_SYSTEM|FILE_ATTRIBUTE_HIDDEN|FILE_ATTRIBUTE_READONLY);
3061 return SetFileAttributesW(lpszPath, dwAttr | dwDefaultAttr);
3064 /*************************************************************************
3065 * PathRenameExtensionA [SHLWAPI.@]
3067 * Swap the file extension in a path with another extension.
3069 * PARAMS
3070 * lpszPath [I/O] Path to swap the extension in
3071 * lpszExt [I] The new extension
3073 * RETURNS
3074 * TRUE if lpszPath was modified,
3075 * FALSE if lpszPath or lpszExt is NULL, or the new path is too long
3077 BOOL WINAPI PathRenameExtensionA(LPSTR lpszPath, LPCSTR lpszExt)
3079 LPSTR lpszExtension;
3081 TRACE("(%s,%s)\n", debugstr_a(lpszPath), debugstr_a(lpszExt));
3083 lpszExtension = PathFindExtensionA(lpszPath);
3085 if (!lpszExtension || (lpszExtension - lpszPath + strlen(lpszExt) >= MAX_PATH))
3086 return FALSE;
3088 strcpy(lpszExtension, lpszExt);
3089 return TRUE;
3092 /*************************************************************************
3093 * PathRenameExtensionW [SHLWAPI.@]
3095 * See PathRenameExtensionA.
3097 BOOL WINAPI PathRenameExtensionW(LPWSTR lpszPath, LPCWSTR lpszExt)
3099 LPWSTR lpszExtension;
3101 TRACE("(%s,%s)\n", debugstr_w(lpszPath), debugstr_w(lpszExt));
3103 lpszExtension = PathFindExtensionW(lpszPath);
3105 if (!lpszExtension || (lpszExtension - lpszPath + strlenW(lpszExt) >= MAX_PATH))
3106 return FALSE;
3108 strcpyW(lpszExtension, lpszExt);
3109 return TRUE;
3112 /*************************************************************************
3113 * PathSearchAndQualifyA [SHLWAPI.@]
3115 * Determine if a given path is correct and fully qualified.
3117 * PARAMS
3118 * lpszPath [I] Path to check
3119 * lpszBuf [O] Output for correct path
3120 * cchBuf [I] Size of lpszBuf
3122 * RETURNS
3123 * Unknown.
3125 BOOL WINAPI PathSearchAndQualifyA(LPCSTR lpszPath, LPSTR lpszBuf, UINT cchBuf)
3127 TRACE("(%s,%p,0x%08x)\n", debugstr_a(lpszPath), lpszBuf, cchBuf);
3129 if(SearchPathA(NULL, lpszPath, NULL, cchBuf, lpszBuf, NULL))
3130 return TRUE;
3131 return !!GetFullPathNameA(lpszPath, cchBuf, lpszBuf, NULL);
3134 /*************************************************************************
3135 * PathSearchAndQualifyW [SHLWAPI.@]
3137 * See PathSearchAndQualifyA.
3139 BOOL WINAPI PathSearchAndQualifyW(LPCWSTR lpszPath, LPWSTR lpszBuf, UINT cchBuf)
3141 TRACE("(%s,%p,0x%08x)\n", debugstr_w(lpszPath), lpszBuf, cchBuf);
3143 if(SearchPathW(NULL, lpszPath, NULL, cchBuf, lpszBuf, NULL))
3144 return TRUE;
3145 return !!GetFullPathNameW(lpszPath, cchBuf, lpszBuf, NULL);
3148 /*************************************************************************
3149 * PathSkipRootA [SHLWAPI.@]
3151 * Return the portion of a path following the drive letter or mount point.
3153 * PARAMS
3154 * lpszPath [I] The path to skip on
3156 * RETURNS
3157 * Success: A pointer to the next character after the root.
3158 * Failure: NULL, if lpszPath is invalid, has no root or is a multibyte string.
3160 LPSTR WINAPI PathSkipRootA(LPCSTR lpszPath)
3162 TRACE("(%s)\n", debugstr_a(lpszPath));
3164 if (!lpszPath || !*lpszPath)
3165 return NULL;
3167 if (*lpszPath == '\\' && lpszPath[1] == '\\')
3169 /* Network share: skip share server and mount point */
3170 lpszPath += 2;
3171 if ((lpszPath = StrChrA(lpszPath, '\\')) &&
3172 (lpszPath = StrChrA(lpszPath + 1, '\\')))
3173 lpszPath++;
3174 return (LPSTR)lpszPath;
3177 if (IsDBCSLeadByte(*lpszPath))
3178 return NULL;
3180 /* Check x:\ */
3181 if (lpszPath[0] && lpszPath[1] == ':' && lpszPath[2] == '\\')
3182 return (LPSTR)lpszPath + 3;
3183 return NULL;
3186 /*************************************************************************
3187 * PathSkipRootW [SHLWAPI.@]
3189 * See PathSkipRootA.
3191 LPWSTR WINAPI PathSkipRootW(LPCWSTR lpszPath)
3193 TRACE("(%s)\n", debugstr_w(lpszPath));
3195 if (!lpszPath || !*lpszPath)
3196 return NULL;
3198 if (*lpszPath == '\\' && lpszPath[1] == '\\')
3200 /* Network share: skip share server and mount point */
3201 lpszPath += 2;
3202 if ((lpszPath = StrChrW(lpszPath, '\\')) &&
3203 (lpszPath = StrChrW(lpszPath + 1, '\\')))
3204 lpszPath++;
3205 return (LPWSTR)lpszPath;
3208 /* Check x:\ */
3209 if (lpszPath[0] && lpszPath[1] == ':' && lpszPath[2] == '\\')
3210 return (LPWSTR)lpszPath + 3;
3211 return NULL;
3214 /*************************************************************************
3215 * PathCreateFromUrlA [SHLWAPI.@]
3217 * See PathCreateFromUrlW
3219 HRESULT WINAPI PathCreateFromUrlA(LPCSTR pszUrl, LPSTR pszPath,
3220 LPDWORD pcchPath, DWORD dwReserved)
3222 WCHAR bufW[MAX_PATH];
3223 WCHAR *pathW = bufW;
3224 UNICODE_STRING urlW;
3225 HRESULT ret;
3226 DWORD lenW = sizeof(bufW)/sizeof(WCHAR), lenA;
3228 if(!RtlCreateUnicodeStringFromAsciiz(&urlW, pszUrl))
3229 return E_INVALIDARG;
3230 if((ret = PathCreateFromUrlW(urlW.Buffer, pathW, &lenW, dwReserved)) == E_POINTER) {
3231 pathW = HeapAlloc(GetProcessHeap(), 0, lenW * sizeof(WCHAR));
3232 ret = PathCreateFromUrlW(urlW.Buffer, pathW, &lenW, dwReserved);
3234 if(ret == S_OK) {
3235 RtlUnicodeToMultiByteSize(&lenA, pathW, lenW * sizeof(WCHAR));
3236 if(*pcchPath > lenA) {
3237 RtlUnicodeToMultiByteN(pszPath, *pcchPath - 1, &lenA, pathW, lenW * sizeof(WCHAR));
3238 pszPath[lenA] = 0;
3239 *pcchPath = lenA;
3240 } else {
3241 *pcchPath = lenA + 1;
3242 ret = E_POINTER;
3245 if(pathW != bufW) HeapFree(GetProcessHeap(), 0, pathW);
3246 RtlFreeUnicodeString(&urlW);
3247 return ret;
3250 /*************************************************************************
3251 * PathCreateFromUrlW [SHLWAPI.@]
3253 * Create a path from a URL
3255 * PARAMS
3256 * lpszUrl [I] URL to convert into a path
3257 * lpszPath [O] Output buffer for the resulting Path
3258 * pcchPath [I] Length of lpszPath
3259 * dwFlags [I] Flags controlling the conversion
3261 * RETURNS
3262 * Success: S_OK. lpszPath contains the URL in path format,
3263 * Failure: An HRESULT error code such as E_INVALIDARG.
3265 HRESULT WINAPI PathCreateFromUrlW(LPCWSTR pszUrl, LPWSTR pszPath,
3266 LPDWORD pcchPath, DWORD dwReserved)
3268 static const WCHAR file_colon[] = { 'f','i','l','e',':',0 };
3269 HRESULT hr;
3270 DWORD nslashes = 0;
3271 WCHAR *ptr;
3273 TRACE("(%s,%p,%p,0x%08lx)\n", debugstr_w(pszUrl), pszPath, pcchPath, dwReserved);
3275 if (!pszUrl || !pszPath || !pcchPath || !*pcchPath)
3276 return E_INVALIDARG;
3279 if (strncmpW(pszUrl, file_colon, 5))
3280 return E_INVALIDARG;
3281 pszUrl += 5;
3283 while(*pszUrl == '/' || *pszUrl == '\\') {
3284 nslashes++;
3285 pszUrl++;
3288 if(isalphaW(*pszUrl) && (pszUrl[1] == ':' || pszUrl[1] == '|') && (pszUrl[2] == '/' || pszUrl[2] == '\\'))
3289 nslashes = 0;
3291 switch(nslashes) {
3292 case 2:
3293 pszUrl -= 2;
3294 break;
3295 case 0:
3296 break;
3297 default:
3298 pszUrl -= 1;
3299 break;
3302 hr = UrlUnescapeW((LPWSTR)pszUrl, pszPath, pcchPath, 0);
3303 if(hr != S_OK) return hr;
3305 for(ptr = pszPath; *ptr; ptr++)
3306 if(*ptr == '/') *ptr = '\\';
3308 while(*pszPath == '\\')
3309 pszPath++;
3311 if(isalphaW(*pszPath) && pszPath[1] == '|' && pszPath[2] == '\\') /* c|\ -> c:\ */
3312 pszPath[1] = ':';
3314 if(nslashes == 2 && (ptr = strchrW(pszPath, '\\'))) { /* \\host\c:\ -> \\hostc:\ */
3315 ptr++;
3316 if(isalphaW(*ptr) && (ptr[1] == ':' || ptr[1] == '|') && ptr[2] == '\\') {
3317 memmove(ptr - 1, ptr, (strlenW(ptr) + 1) * sizeof(WCHAR));
3318 (*pcchPath)--;
3322 TRACE("Returning %s\n",debugstr_w(pszPath));
3324 return hr;
3327 /*************************************************************************
3328 * PathRelativePathToA [SHLWAPI.@]
3330 * Create a relative path from one path to another.
3332 * PARAMS
3333 * lpszPath [O] Destination for relative path
3334 * lpszFrom [I] Source path
3335 * dwAttrFrom [I] File attribute of source path
3336 * lpszTo [I] Destination path
3337 * dwAttrTo [I] File attributes of destination path
3339 * RETURNS
3340 * TRUE If a relative path can be formed. lpszPath contains the new path
3341 * FALSE If the paths are not relavtive or any parameters are invalid
3343 * NOTES
3344 * lpszTo should be at least MAX_PATH in length.
3346 * Calling this function with relative paths for lpszFrom or lpszTo may
3347 * give erroneous results.
3349 * The Win32 version of this function contains a bug where the lpszTo string
3350 * may be referenced 1 byte beyond the end of the string. As a result random
3351 * garbage may be written to the output path, depending on what lies beyond
3352 * the last byte of the string. This bug occurs because of the behaviour of
3353 * PathCommonPrefix() (see notes for that function), and no workaround seems
3354 * possible with Win32.
3356 * This bug has been fixed here, so for example the relative path from "\\"
3357 * to "\\" is correctly determined as "." in this implementation.
3359 BOOL WINAPI PathRelativePathToA(LPSTR lpszPath, LPCSTR lpszFrom, DWORD dwAttrFrom,
3360 LPCSTR lpszTo, DWORD dwAttrTo)
3362 BOOL bRet = FALSE;
3364 TRACE("(%p,%s,0x%08lx,%s,0x%08lx)\n", lpszPath, debugstr_a(lpszFrom),
3365 dwAttrFrom, debugstr_a(lpszTo), dwAttrTo);
3367 if(lpszPath && lpszFrom && lpszTo)
3369 WCHAR szPath[MAX_PATH];
3370 WCHAR szFrom[MAX_PATH];
3371 WCHAR szTo[MAX_PATH];
3372 MultiByteToWideChar(CP_ACP,0,lpszFrom,-1,szFrom,MAX_PATH);
3373 MultiByteToWideChar(CP_ACP,0,lpszTo,-1,szTo,MAX_PATH);
3374 bRet = PathRelativePathToW(szPath,szFrom,dwAttrFrom,szTo,dwAttrTo);
3375 WideCharToMultiByte(CP_ACP,0,szPath,-1,lpszPath,MAX_PATH,0,0);
3377 return bRet;
3380 /*************************************************************************
3381 * PathRelativePathToW [SHLWAPI.@]
3383 * See PathRelativePathToA.
3385 BOOL WINAPI PathRelativePathToW(LPWSTR lpszPath, LPCWSTR lpszFrom, DWORD dwAttrFrom,
3386 LPCWSTR lpszTo, DWORD dwAttrTo)
3388 static const WCHAR szPrevDirSlash[] = { '.', '.', '\\', '\0' };
3389 static const WCHAR szPrevDir[] = { '.', '.', '\0' };
3390 WCHAR szFrom[MAX_PATH];
3391 WCHAR szTo[MAX_PATH];
3392 DWORD dwLen;
3394 TRACE("(%p,%s,0x%08lx,%s,0x%08lx)\n", lpszPath, debugstr_w(lpszFrom),
3395 dwAttrFrom, debugstr_w(lpszTo), dwAttrTo);
3397 if(!lpszPath || !lpszFrom || !lpszTo)
3398 return FALSE;
3400 *lpszPath = '\0';
3401 lstrcpynW(szFrom, lpszFrom, MAX_PATH);
3402 lstrcpynW(szTo, lpszTo, MAX_PATH);
3404 if(!(dwAttrFrom & FILE_ATTRIBUTE_DIRECTORY))
3405 PathRemoveFileSpecW(szFrom);
3406 if(!(dwAttrFrom & FILE_ATTRIBUTE_DIRECTORY))
3407 PathRemoveFileSpecW(szTo);
3409 /* Paths can only be relative if they have a common root */
3410 if(!(dwLen = PathCommonPrefixW(szFrom, szTo, 0)))
3411 return FALSE;
3413 /* Strip off lpszFrom components to the root, by adding "..\" */
3414 lpszFrom = szFrom + dwLen;
3415 if (!*lpszFrom)
3417 lpszPath[0] = '.';
3418 lpszPath[1] = '\0';
3420 if (*lpszFrom == '\\')
3421 lpszFrom++;
3423 while (*lpszFrom)
3425 lpszFrom = PathFindNextComponentW(lpszFrom);
3426 strcatW(lpszPath, *lpszFrom ? szPrevDirSlash : szPrevDir);
3429 /* From the root add the components of lpszTo */
3430 lpszTo += dwLen;
3431 /* We check lpszTo[-1] to avoid skipping end of string. See the notes for
3432 * this function.
3434 if (*lpszTo && lpszTo[-1])
3436 if (*lpszTo != '\\')
3437 lpszTo--;
3438 dwLen = strlenW(lpszPath);
3439 if (dwLen + strlenW(lpszTo) >= MAX_PATH)
3441 *lpszPath = '\0';
3442 return FALSE;
3444 strcpyW(lpszPath + dwLen, lpszTo);
3446 return TRUE;
3449 /*************************************************************************
3450 * PathUnmakeSystemFolderA [SHLWAPI.@]
3452 * Remove the system folder attributes from a path.
3454 * PARAMS
3455 * lpszPath [I] The path to remove attributes from
3457 * RETURNS
3458 * Success: TRUE.
3459 * Failure: FALSE, if lpszPath is NULL, empty, not a directory, or calling
3460 * SetFileAttributesA() fails.
3462 BOOL WINAPI PathUnmakeSystemFolderA(LPCSTR lpszPath)
3464 DWORD dwAttr;
3466 TRACE("(%s)\n", debugstr_a(lpszPath));
3468 if (!lpszPath || !*lpszPath || (dwAttr = GetFileAttributesA(lpszPath)) == INVALID_FILE_ATTRIBUTES ||
3469 !(dwAttr & FILE_ATTRIBUTE_DIRECTORY))
3470 return FALSE;
3472 dwAttr &= ~(FILE_ATTRIBUTE_HIDDEN | FILE_ATTRIBUTE_SYSTEM);
3473 return SetFileAttributesA(lpszPath, dwAttr);
3476 /*************************************************************************
3477 * PathUnmakeSystemFolderW [SHLWAPI.@]
3479 * See PathUnmakeSystemFolderA.
3481 BOOL WINAPI PathUnmakeSystemFolderW(LPCWSTR lpszPath)
3483 DWORD dwAttr;
3485 TRACE("(%s)\n", debugstr_w(lpszPath));
3487 if (!lpszPath || !*lpszPath || (dwAttr = GetFileAttributesW(lpszPath)) == INVALID_FILE_ATTRIBUTES ||
3488 !(dwAttr & FILE_ATTRIBUTE_DIRECTORY))
3489 return FALSE;
3491 dwAttr &= ~(FILE_ATTRIBUTE_HIDDEN | FILE_ATTRIBUTE_SYSTEM);
3492 return SetFileAttributesW(lpszPath, dwAttr);
3496 /*************************************************************************
3497 * PathSetDlgItemPathA [SHLWAPI.@]
3499 * Set the text of a dialog item to a path, shrinking the path to fit
3500 * if it is too big for the item.
3502 * PARAMS
3503 * hDlg [I] Dialog handle
3504 * id [I] ID of item in the dialog
3505 * lpszPath [I] Path to set as the items text
3507 * RETURNS
3508 * Nothing.
3510 * NOTES
3511 * If lpszPath is NULL, a blank string ("") is set (i.e. The previous
3512 * window text is erased).
3514 VOID WINAPI PathSetDlgItemPathA(HWND hDlg, int id, LPCSTR lpszPath)
3516 WCHAR szPath[MAX_PATH];
3518 TRACE("(%p,%8x,%s)\n",hDlg, id, debugstr_a(lpszPath));
3520 if (lpszPath)
3521 MultiByteToWideChar(CP_ACP,0,lpszPath,-1,szPath,MAX_PATH);
3522 else
3523 szPath[0] = '\0';
3524 PathSetDlgItemPathW(hDlg, id, szPath);
3527 /*************************************************************************
3528 * PathSetDlgItemPathW [SHLWAPI.@]
3530 * See PathSetDlgItemPathA.
3532 VOID WINAPI PathSetDlgItemPathW(HWND hDlg, int id, LPCWSTR lpszPath)
3534 WCHAR path[MAX_PATH + 1];
3535 HWND hwItem;
3536 RECT rect;
3537 HDC hdc;
3538 HGDIOBJ hPrevObj;
3540 TRACE("(%p,%8x,%s)\n",hDlg, id, debugstr_w(lpszPath));
3542 if (!(hwItem = GetDlgItem(hDlg, id)))
3543 return;
3545 if (lpszPath)
3546 lstrcpynW(path, lpszPath, sizeof(path) / sizeof(WCHAR));
3547 else
3548 path[0] = '\0';
3550 GetClientRect(hwItem, &rect);
3551 hdc = GetDC(hDlg);
3552 hPrevObj = SelectObject(hdc, (HGDIOBJ)SendMessageW(hwItem,WM_GETFONT,0,0));
3554 if (hPrevObj)
3556 PathCompactPathW(hdc, path, rect.right);
3557 SelectObject(hdc, hPrevObj);
3560 ReleaseDC(hDlg, hdc);
3561 SetWindowTextW(hwItem, path);
3564 /*************************************************************************
3565 * PathIsNetworkPathA [SHLWAPI.@]
3567 * Determine if the given path is a network path.
3569 * PARAMS
3570 * lpszPath [I] Path to check
3572 * RETURNS
3573 * TRUE If lpszPath is a UNC share or mapped network drive, or
3574 * FALSE If lpszPath is a local drive or cannot be determined
3576 BOOL WINAPI PathIsNetworkPathA(LPCSTR lpszPath)
3578 int dwDriveNum;
3580 TRACE("(%s)\n",debugstr_a(lpszPath));
3582 if (!lpszPath)
3583 return FALSE;
3584 if (*lpszPath == '\\' && lpszPath[1] == '\\')
3585 return TRUE;
3586 dwDriveNum = PathGetDriveNumberA(lpszPath);
3587 if (dwDriveNum == -1)
3588 return FALSE;
3589 GET_FUNC(pIsNetDrive, shell32, (LPCSTR)66, FALSE); /* ord 66 = shell32.IsNetDrive */
3590 return pIsNetDrive(dwDriveNum);
3593 /*************************************************************************
3594 * PathIsNetworkPathW [SHLWAPI.@]
3596 * See PathIsNetworkPathA.
3598 BOOL WINAPI PathIsNetworkPathW(LPCWSTR lpszPath)
3600 int dwDriveNum;
3602 TRACE("(%s)\n", debugstr_w(lpszPath));
3604 if (!lpszPath)
3605 return FALSE;
3606 if (*lpszPath == '\\' && lpszPath[1] == '\\')
3607 return TRUE;
3608 dwDriveNum = PathGetDriveNumberW(lpszPath);
3609 if (dwDriveNum == -1)
3610 return FALSE;
3611 GET_FUNC(pIsNetDrive, shell32, (LPCSTR)66, FALSE); /* ord 66 = shell32.IsNetDrive */
3612 return pIsNetDrive(dwDriveNum);
3615 /*************************************************************************
3616 * PathIsLFNFileSpecA [SHLWAPI.@]
3618 * Determine if the given path is a long file name
3620 * PARAMS
3621 * lpszPath [I] Path to check
3623 * RETURNS
3624 * TRUE If path is a long file name,
3625 * FALSE If path is a valid DOS short file name
3627 BOOL WINAPI PathIsLFNFileSpecA(LPCSTR lpszPath)
3629 DWORD dwNameLen = 0, dwExtLen = 0;
3631 TRACE("(%s)\n",debugstr_a(lpszPath));
3633 if (!lpszPath)
3634 return FALSE;
3636 while (*lpszPath)
3638 if (*lpszPath == ' ')
3639 return TRUE; /* DOS names cannot have spaces */
3640 if (*lpszPath == '.')
3642 if (dwExtLen)
3643 return TRUE; /* DOS names have only one dot */
3644 dwExtLen = 1;
3646 else if (dwExtLen)
3648 dwExtLen++;
3649 if (dwExtLen > 4)
3650 return TRUE; /* DOS extensions are <= 3 chars*/
3652 else
3654 dwNameLen++;
3655 if (dwNameLen > 8)
3656 return TRUE; /* DOS names are <= 8 chars */
3658 lpszPath += IsDBCSLeadByte(*lpszPath) ? 2 : 1;
3660 return FALSE; /* Valid DOS path */
3663 /*************************************************************************
3664 * PathIsLFNFileSpecW [SHLWAPI.@]
3666 * See PathIsLFNFileSpecA.
3668 BOOL WINAPI PathIsLFNFileSpecW(LPCWSTR lpszPath)
3670 DWORD dwNameLen = 0, dwExtLen = 0;
3672 TRACE("(%s)\n",debugstr_w(lpszPath));
3674 if (!lpszPath)
3675 return FALSE;
3677 while (*lpszPath)
3679 if (*lpszPath == ' ')
3680 return TRUE; /* DOS names cannot have spaces */
3681 if (*lpszPath == '.')
3683 if (dwExtLen)
3684 return TRUE; /* DOS names have only one dot */
3685 dwExtLen = 1;
3687 else if (dwExtLen)
3689 dwExtLen++;
3690 if (dwExtLen > 4)
3691 return TRUE; /* DOS extensions are <= 3 chars*/
3693 else
3695 dwNameLen++;
3696 if (dwNameLen > 8)
3697 return TRUE; /* DOS names are <= 8 chars */
3699 lpszPath++;
3701 return FALSE; /* Valid DOS path */
3704 /*************************************************************************
3705 * PathIsDirectoryEmptyA [SHLWAPI.@]
3707 * Determine if a given directory is empty.
3709 * PARAMS
3710 * lpszPath [I] Directory to check
3712 * RETURNS
3713 * TRUE If the directory exists and contains no files,
3714 * FALSE Otherwise
3716 BOOL WINAPI PathIsDirectoryEmptyA(LPCSTR lpszPath)
3718 BOOL bRet = FALSE;
3720 TRACE("(%s)\n",debugstr_a(lpszPath));
3722 if (lpszPath)
3724 WCHAR szPath[MAX_PATH];
3725 MultiByteToWideChar(CP_ACP,0,lpszPath,-1,szPath,MAX_PATH);
3726 bRet = PathIsDirectoryEmptyW(szPath);
3728 return bRet;
3731 /*************************************************************************
3732 * PathIsDirectoryEmptyW [SHLWAPI.@]
3734 * See PathIsDirectoryEmptyA.
3736 BOOL WINAPI PathIsDirectoryEmptyW(LPCWSTR lpszPath)
3738 static const WCHAR szAllFiles[] = { '*', '.', '*', '\0' };
3739 WCHAR szSearch[MAX_PATH];
3740 DWORD dwLen;
3741 HANDLE hfind;
3742 BOOL retVal = FALSE;
3743 WIN32_FIND_DATAW find_data;
3745 TRACE("(%s)\n",debugstr_w(lpszPath));
3747 if (!lpszPath || !PathIsDirectoryW(lpszPath))
3748 return FALSE;
3750 lstrcpynW(szSearch, lpszPath, MAX_PATH);
3751 PathAddBackslashW(szSearch);
3752 dwLen = strlenW(szSearch);
3753 if (dwLen > MAX_PATH - 4)
3754 return FALSE;
3756 strcpyW(szSearch + dwLen, szAllFiles);
3757 hfind = FindFirstFileW(szSearch, &find_data);
3759 if (hfind != INVALID_HANDLE_VALUE &&
3760 find_data.cFileName[0] == '.' &&
3761 find_data.cFileName[1] == '.')
3763 /* The only directory entry should be the parent */
3764 if (!FindNextFileW(hfind, &find_data))
3765 retVal = TRUE;
3766 FindClose(hfind);
3768 return retVal;
3772 /*************************************************************************
3773 * PathFindSuffixArrayA [SHLWAPI.@]
3775 * Find a suffix string in an array of suffix strings
3777 * PARAMS
3778 * lpszSuffix [I] Suffix string to search for
3779 * lppszArray [I] Array of suffix strings to search
3780 * dwCount [I] Number of elements in lppszArray
3782 * RETURNS
3783 * Success: The index of the position of lpszSuffix in lppszArray
3784 * Failure: 0, if any parameters are invalid or lpszSuffix is not found
3786 * NOTES
3787 * The search is case sensitive.
3788 * The match is made against the end of the suffix string, so for example:
3789 * lpszSuffix="fooBAR" matches "BAR", but lpszSuffix="fooBARfoo" does not.
3791 LPCSTR WINAPI PathFindSuffixArrayA(LPCSTR lpszSuffix, LPCSTR *lppszArray, int dwCount)
3793 size_t dwLen;
3794 int dwRet = 0;
3796 TRACE("(%s,%p,%d)\n",debugstr_a(lpszSuffix), lppszArray, dwCount);
3798 if (lpszSuffix && lppszArray && dwCount > 0)
3800 dwLen = strlen(lpszSuffix);
3802 while (dwRet < dwCount)
3804 size_t dwCompareLen = strlen(*lppszArray);
3805 if (dwCompareLen < dwLen)
3807 if (!strcmp(lpszSuffix + dwLen - dwCompareLen, *lppszArray))
3808 return *lppszArray; /* Found */
3810 dwRet++;
3811 lppszArray++;
3814 return NULL;
3817 /*************************************************************************
3818 * PathFindSuffixArrayW [SHLWAPI.@]
3820 * See PathFindSuffixArrayA.
3822 LPCWSTR WINAPI PathFindSuffixArrayW(LPCWSTR lpszSuffix, LPCWSTR *lppszArray, int dwCount)
3824 size_t dwLen;
3825 int dwRet = 0;
3827 TRACE("(%s,%p,%d)\n",debugstr_w(lpszSuffix), lppszArray, dwCount);
3829 if (lpszSuffix && lppszArray && dwCount > 0)
3831 dwLen = strlenW(lpszSuffix);
3833 while (dwRet < dwCount)
3835 size_t dwCompareLen = strlenW(*lppszArray);
3836 if (dwCompareLen < dwLen)
3838 if (!strcmpW(lpszSuffix + dwLen - dwCompareLen, *lppszArray))
3839 return *lppszArray; /* Found */
3841 dwRet++;
3842 lppszArray++;
3845 return NULL;
3848 /*************************************************************************
3849 * PathUndecorateA [SHLWAPI.@]
3851 * Undecorate a file path
3853 * PARAMS
3854 * lpszPath [I/O] Path to remove any decoration from
3856 * RETURNS
3857 * Nothing
3859 * NOTES
3860 * A decorations form is "path[n].ext" where "n" is an optional decimal number.
3862 VOID WINAPI PathUndecorateA(LPSTR lpszPath)
3864 TRACE("(%s)\n",debugstr_a(lpszPath));
3866 if (lpszPath)
3868 LPSTR lpszExt = PathFindExtensionA(lpszPath);
3869 if (lpszExt > lpszPath && lpszExt[-1] == ']')
3871 LPSTR lpszSkip = lpszExt - 2;
3872 if (*lpszSkip == '[')
3873 lpszSkip++; /* [] (no number) */
3874 else
3875 while (lpszSkip > lpszPath && isdigit(lpszSkip[-1]))
3876 lpszSkip--;
3877 if (lpszSkip > lpszPath && lpszSkip[-1] == '[' && lpszSkip[-2] != '\\')
3879 /* remove the [n] */
3880 lpszSkip--;
3881 while (*lpszExt)
3882 *lpszSkip++ = *lpszExt++;
3883 *lpszSkip = '\0';
3889 /*************************************************************************
3890 * PathUndecorateW [SHLWAPI.@]
3892 * See PathUndecorateA.
3894 VOID WINAPI PathUndecorateW(LPWSTR lpszPath)
3896 TRACE("(%s)\n",debugstr_w(lpszPath));
3898 if (lpszPath)
3900 LPWSTR lpszExt = PathFindExtensionW(lpszPath);
3901 if (lpszExt > lpszPath && lpszExt[-1] == ']')
3903 LPWSTR lpszSkip = lpszExt - 2;
3904 if (*lpszSkip == '[')
3905 lpszSkip++; /* [] (no number) */
3906 else
3907 while (lpszSkip > lpszPath && isdigitW(lpszSkip[-1]))
3908 lpszSkip--;
3909 if (lpszSkip > lpszPath && lpszSkip[-1] == '[' && lpszSkip[-2] != '\\')
3911 /* remove the [n] */
3912 lpszSkip--;
3913 while (*lpszExt)
3914 *lpszSkip++ = *lpszExt++;
3915 *lpszSkip = '\0';
3921 /*************************************************************************
3922 * PathUnExpandEnvStringsA [SHLWAPI.@]
3924 * Substitute folder names in a path with their corresponding environment
3925 * strings.
3927 * PARAMS
3928 * pszPath [I] Buffer containing the path to unexpand.
3929 * pszBuf [O] Buffer to receive the unexpanded path.
3930 * cchBuf [I] Size of pszBuf in characters.
3932 * RETURNS
3933 * Success: TRUE
3934 * Failure: FALSE
3936 BOOL WINAPI PathUnExpandEnvStringsA(LPCSTR pszPath, LPSTR pszBuf, UINT cchBuf)
3938 FIXME("(%s,%s,0x%08x)\n", debugstr_a(pszPath), debugstr_a(pszBuf), cchBuf);
3939 return FALSE;
3942 /*************************************************************************
3943 * PathUnExpandEnvStringsW [SHLWAPI.@]
3945 * Unicode version of PathUnExpandEnvStringsA.
3947 BOOL WINAPI PathUnExpandEnvStringsW(LPCWSTR pszPath, LPWSTR pszBuf, UINT cchBuf)
3949 FIXME("(%s,%s,0x%08x)\n", debugstr_w(pszPath), debugstr_w(pszBuf), cchBuf);
3950 return FALSE;
3953 /*************************************************************************
3954 * @ [SHLWAPI.440]
3956 * Find localised or default web content in "%WINDOWS%\web\".
3958 * PARAMS
3959 * lpszFile [I] File name containing content to look for
3960 * lpszPath [O] Buffer to contain the full path to the file
3961 * dwPathLen [I] Length of lpszPath
3963 * RETURNS
3964 * Success: S_OK. lpszPath contains the full path to the content.
3965 * Failure: E_FAIL. The content does not exist or lpszPath is too short.
3967 HRESULT WINAPI SHGetWebFolderFilePathA(LPCSTR lpszFile, LPSTR lpszPath, DWORD dwPathLen)
3969 WCHAR szFile[MAX_PATH], szPath[MAX_PATH];
3970 HRESULT hRet;
3972 TRACE("(%s,%p,%ld)\n", lpszFile, lpszPath, dwPathLen);
3974 MultiByteToWideChar(CP_ACP, 0, lpszFile, -1, szFile, MAX_PATH);
3975 szPath[0] = '\0';
3976 hRet = SHGetWebFolderFilePathW(szFile, szPath, dwPathLen);
3977 WideCharToMultiByte(CP_ACP, 0, szPath, -1, lpszPath, dwPathLen, 0, 0);
3978 return hRet;
3981 /*************************************************************************
3982 * @ [SHLWAPI.441]
3984 * Unicode version of SHGetWebFolderFilePathA.
3986 HRESULT WINAPI SHGetWebFolderFilePathW(LPCWSTR lpszFile, LPWSTR lpszPath, DWORD dwPathLen)
3988 static const WCHAR szWeb[] = {'\\','W','e','b','\\','\0'};
3989 static const WCHAR szWebMui[] = {'m','u','i','\\','%','0','4','x','\\','\0'};
3990 #define szWebLen (sizeof(szWeb)/sizeof(WCHAR))
3991 #define szWebMuiLen ((sizeof(szWebMui)+1)/sizeof(WCHAR))
3992 DWORD dwLen, dwFileLen;
3993 LANGID lidSystem, lidUser;
3995 TRACE("(%s,%p,%ld)\n", debugstr_w(lpszFile), lpszPath, dwPathLen);
3997 /* Get base directory for web content */
3998 dwLen = GetSystemWindowsDirectoryW(lpszPath, dwPathLen);
3999 if (dwLen > 0 && lpszPath[dwLen-1] == '\\')
4000 dwLen--;
4002 dwFileLen = strlenW(lpszFile);
4004 if (dwLen + dwFileLen + szWebLen >= dwPathLen)
4005 return E_FAIL; /* lpszPath too short */
4007 strcpyW(lpszPath+dwLen, szWeb);
4008 dwLen += szWebLen;
4009 dwPathLen = dwPathLen - dwLen; /* Remaining space */
4011 lidSystem = GetSystemDefaultUILanguage();
4012 lidUser = GetUserDefaultUILanguage();
4014 if (lidSystem != lidUser)
4016 if (dwFileLen + szWebMuiLen < dwPathLen)
4018 /* Use localised content in the users UI language if present */
4019 wsprintfW(lpszPath + dwLen, szWebMui, lidUser);
4020 strcpyW(lpszPath + dwLen + szWebMuiLen, lpszFile);
4021 if (PathFileExistsW(lpszPath))
4022 return S_OK;
4026 /* Fall back to OS default installed content */
4027 strcpyW(lpszPath + dwLen, lpszFile);
4028 if (PathFileExistsW(lpszPath))
4029 return S_OK;
4030 return E_FAIL;
4033 #define PATH_CHAR_CLASS_LETTER 0x00000001
4034 #define PATH_CHAR_CLASS_ASTERIX 0x00000002
4035 #define PATH_CHAR_CLASS_DOT 0x00000004
4036 #define PATH_CHAR_CLASS_BACKSLASH 0x00000008
4037 #define PATH_CHAR_CLASS_COLON 0x00000010
4038 #define PATH_CHAR_CLASS_SEMICOLON 0x00000020
4039 #define PATH_CHAR_CLASS_COMMA 0x00000040
4040 #define PATH_CHAR_CLASS_SPACE 0x00000080
4041 #define PATH_CHAR_CLASS_OTHER_VALID 0x00000100
4042 #define PATH_CHAR_CLASS_DOUBLEQUOTE 0x00000200
4044 #define PATH_CHAR_CLASS_INVALID 0x00000000
4045 #define PATH_CHAR_CLASS_ANY 0xffffffff
4047 static const DWORD SHELL_charclass[] =
4049 /* 0x00 */ PATH_CHAR_CLASS_INVALID, /* 0x01 */ PATH_CHAR_CLASS_INVALID,
4050 /* 0x02 */ PATH_CHAR_CLASS_INVALID, /* 0x03 */ PATH_CHAR_CLASS_INVALID,
4051 /* 0x04 */ PATH_CHAR_CLASS_INVALID, /* 0x05 */ PATH_CHAR_CLASS_INVALID,
4052 /* 0x06 */ PATH_CHAR_CLASS_INVALID, /* 0x07 */ PATH_CHAR_CLASS_INVALID,
4053 /* 0x08 */ PATH_CHAR_CLASS_INVALID, /* 0x09 */ PATH_CHAR_CLASS_INVALID,
4054 /* 0x0a */ PATH_CHAR_CLASS_INVALID, /* 0x0b */ PATH_CHAR_CLASS_INVALID,
4055 /* 0x0c */ PATH_CHAR_CLASS_INVALID, /* 0x0d */ PATH_CHAR_CLASS_INVALID,
4056 /* 0x0e */ PATH_CHAR_CLASS_INVALID, /* 0x0f */ PATH_CHAR_CLASS_INVALID,
4057 /* 0x10 */ PATH_CHAR_CLASS_INVALID, /* 0x11 */ PATH_CHAR_CLASS_INVALID,
4058 /* 0x12 */ PATH_CHAR_CLASS_INVALID, /* 0x13 */ PATH_CHAR_CLASS_INVALID,
4059 /* 0x14 */ PATH_CHAR_CLASS_INVALID, /* 0x15 */ PATH_CHAR_CLASS_INVALID,
4060 /* 0x16 */ PATH_CHAR_CLASS_INVALID, /* 0x17 */ PATH_CHAR_CLASS_INVALID,
4061 /* 0x18 */ PATH_CHAR_CLASS_INVALID, /* 0x19 */ PATH_CHAR_CLASS_INVALID,
4062 /* 0x1a */ PATH_CHAR_CLASS_INVALID, /* 0x1b */ PATH_CHAR_CLASS_INVALID,
4063 /* 0x1c */ PATH_CHAR_CLASS_INVALID, /* 0x1d */ PATH_CHAR_CLASS_INVALID,
4064 /* 0x1e */ PATH_CHAR_CLASS_INVALID, /* 0x1f */ PATH_CHAR_CLASS_INVALID,
4065 /* ' ' */ PATH_CHAR_CLASS_SPACE, /* '!' */ PATH_CHAR_CLASS_OTHER_VALID,
4066 /* '"' */ PATH_CHAR_CLASS_DOUBLEQUOTE, /* '#' */ PATH_CHAR_CLASS_OTHER_VALID,
4067 /* '$' */ PATH_CHAR_CLASS_OTHER_VALID, /* '%' */ PATH_CHAR_CLASS_OTHER_VALID,
4068 /* '&' */ PATH_CHAR_CLASS_OTHER_VALID, /* '\'' */ PATH_CHAR_CLASS_OTHER_VALID,
4069 /* '(' */ PATH_CHAR_CLASS_OTHER_VALID, /* ')' */ PATH_CHAR_CLASS_OTHER_VALID,
4070 /* '*' */ PATH_CHAR_CLASS_ASTERIX, /* '+' */ PATH_CHAR_CLASS_OTHER_VALID,
4071 /* ',' */ PATH_CHAR_CLASS_COMMA, /* '-' */ PATH_CHAR_CLASS_OTHER_VALID,
4072 /* '.' */ PATH_CHAR_CLASS_DOT, /* '/' */ PATH_CHAR_CLASS_INVALID,
4073 /* '0' */ PATH_CHAR_CLASS_OTHER_VALID, /* '1' */ PATH_CHAR_CLASS_OTHER_VALID,
4074 /* '2' */ PATH_CHAR_CLASS_OTHER_VALID, /* '3' */ PATH_CHAR_CLASS_OTHER_VALID,
4075 /* '4' */ PATH_CHAR_CLASS_OTHER_VALID, /* '5' */ PATH_CHAR_CLASS_OTHER_VALID,
4076 /* '6' */ PATH_CHAR_CLASS_OTHER_VALID, /* '7' */ PATH_CHAR_CLASS_OTHER_VALID,
4077 /* '8' */ PATH_CHAR_CLASS_OTHER_VALID, /* '9' */ PATH_CHAR_CLASS_OTHER_VALID,
4078 /* ':' */ PATH_CHAR_CLASS_COLON, /* ';' */ PATH_CHAR_CLASS_SEMICOLON,
4079 /* '<' */ PATH_CHAR_CLASS_INVALID, /* '=' */ PATH_CHAR_CLASS_OTHER_VALID,
4080 /* '>' */ PATH_CHAR_CLASS_INVALID, /* '?' */ PATH_CHAR_CLASS_LETTER,
4081 /* '@' */ PATH_CHAR_CLASS_OTHER_VALID, /* 'A' */ PATH_CHAR_CLASS_ANY,
4082 /* 'B' */ PATH_CHAR_CLASS_ANY, /* 'C' */ PATH_CHAR_CLASS_ANY,
4083 /* 'D' */ PATH_CHAR_CLASS_ANY, /* 'E' */ PATH_CHAR_CLASS_ANY,
4084 /* 'F' */ PATH_CHAR_CLASS_ANY, /* 'G' */ PATH_CHAR_CLASS_ANY,
4085 /* 'H' */ PATH_CHAR_CLASS_ANY, /* 'I' */ PATH_CHAR_CLASS_ANY,
4086 /* 'J' */ PATH_CHAR_CLASS_ANY, /* 'K' */ PATH_CHAR_CLASS_ANY,
4087 /* 'L' */ PATH_CHAR_CLASS_ANY, /* 'M' */ PATH_CHAR_CLASS_ANY,
4088 /* 'N' */ PATH_CHAR_CLASS_ANY, /* 'O' */ PATH_CHAR_CLASS_ANY,
4089 /* 'P' */ PATH_CHAR_CLASS_ANY, /* 'Q' */ PATH_CHAR_CLASS_ANY,
4090 /* 'R' */ PATH_CHAR_CLASS_ANY, /* 'S' */ PATH_CHAR_CLASS_ANY,
4091 /* 'T' */ PATH_CHAR_CLASS_ANY, /* 'U' */ PATH_CHAR_CLASS_ANY,
4092 /* 'V' */ PATH_CHAR_CLASS_ANY, /* 'W' */ PATH_CHAR_CLASS_ANY,
4093 /* 'X' */ PATH_CHAR_CLASS_ANY, /* 'Y' */ PATH_CHAR_CLASS_ANY,
4094 /* 'Z' */ PATH_CHAR_CLASS_ANY, /* '[' */ PATH_CHAR_CLASS_OTHER_VALID,
4095 /* '\\' */ PATH_CHAR_CLASS_BACKSLASH, /* ']' */ PATH_CHAR_CLASS_OTHER_VALID,
4096 /* '^' */ PATH_CHAR_CLASS_OTHER_VALID, /* '_' */ PATH_CHAR_CLASS_OTHER_VALID,
4097 /* '`' */ PATH_CHAR_CLASS_OTHER_VALID, /* 'a' */ PATH_CHAR_CLASS_ANY,
4098 /* 'b' */ PATH_CHAR_CLASS_ANY, /* 'c' */ PATH_CHAR_CLASS_ANY,
4099 /* 'd' */ PATH_CHAR_CLASS_ANY, /* 'e' */ PATH_CHAR_CLASS_ANY,
4100 /* 'f' */ PATH_CHAR_CLASS_ANY, /* 'g' */ PATH_CHAR_CLASS_ANY,
4101 /* 'h' */ PATH_CHAR_CLASS_ANY, /* 'i' */ PATH_CHAR_CLASS_ANY,
4102 /* 'j' */ PATH_CHAR_CLASS_ANY, /* 'k' */ PATH_CHAR_CLASS_ANY,
4103 /* 'l' */ PATH_CHAR_CLASS_ANY, /* 'm' */ PATH_CHAR_CLASS_ANY,
4104 /* 'n' */ PATH_CHAR_CLASS_ANY, /* 'o' */ PATH_CHAR_CLASS_ANY,
4105 /* 'p' */ PATH_CHAR_CLASS_ANY, /* 'q' */ PATH_CHAR_CLASS_ANY,
4106 /* 'r' */ PATH_CHAR_CLASS_ANY, /* 's' */ PATH_CHAR_CLASS_ANY,
4107 /* 't' */ PATH_CHAR_CLASS_ANY, /* 'u' */ PATH_CHAR_CLASS_ANY,
4108 /* 'v' */ PATH_CHAR_CLASS_ANY, /* 'w' */ PATH_CHAR_CLASS_ANY,
4109 /* 'x' */ PATH_CHAR_CLASS_ANY, /* 'y' */ PATH_CHAR_CLASS_ANY,
4110 /* 'z' */ PATH_CHAR_CLASS_ANY, /* '{' */ PATH_CHAR_CLASS_OTHER_VALID,
4111 /* '|' */ PATH_CHAR_CLASS_INVALID, /* '}' */ PATH_CHAR_CLASS_OTHER_VALID,
4112 /* '~' */ PATH_CHAR_CLASS_OTHER_VALID
4115 /*************************************************************************
4116 * @ [SHLWAPI.455]
4118 * Check if an ASCII char is of a certain class
4120 BOOL WINAPI PathIsValidCharA( char c, DWORD class )
4122 if ((unsigned)c > 0x7e)
4123 return class & PATH_CHAR_CLASS_OTHER_VALID;
4125 return class & SHELL_charclass[(unsigned)c];
4128 /*************************************************************************
4129 * @ [SHLWAPI.456]
4131 * Check if a Unicode char is of a certain class
4133 BOOL WINAPI PathIsValidCharW( WCHAR c, DWORD class )
4135 if (c > 0x7e)
4136 return class & PATH_CHAR_CLASS_OTHER_VALID;
4138 return class & SHELL_charclass[c];