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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
23 #include "wine/port.h"
29 #include "wine/unicode.h"
36 #define NO_SHLWAPI_STREAM
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) \
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; \
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.
67 * lpszPath [I/O] Initial part of path, and destination for output
68 * lpszAppend [I] Path to append
71 * Success: TRUE. lpszPath contains the newly created path.
72 * Failure: FALSE, if either path is NULL, or PathCombineA() fails.
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
== '\\')
88 if (PathCombineA(lpszPath
, lpszPath
, lpszAppend
))
94 /*************************************************************************
95 * PathAppendW [SHLWAPI.@]
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
== '\\')
108 if (PathCombineW(lpszPath
, lpszPath
, lpszAppend
))
114 /*************************************************************************
115 * PathCombineA [SHLWAPI.@]
117 * Combine two paths together.
120 * lpszDest [O] Destination for combined path
121 * lpszDir [I] Directory path
122 * lpszFile [I] File path
125 * Success: The output path
126 * Failure: NULL, if inputs are invalid.
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 */
140 WCHAR szDest
[MAX_PATH
];
141 WCHAR szDir
[MAX_PATH
];
142 WCHAR szFile
[MAX_PATH
];
144 MultiByteToWideChar(CP_ACP
,0,lpszDir
,-1,szDir
,MAX_PATH
);
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);
153 /*************************************************************************
154 * PathCombineW [SHLWAPI.@]
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 lpszDest
; /* Invalid parameters */
168 if (!lpszFile
|| !*lpszFile
)
171 strncpyW(szTemp
, lpszDir
, MAX_PATH
);
173 else if (!lpszDir
|| !*lpszDir
|| !PathIsRelativeW(lpszFile
))
175 if (!lpszDir
|| !*lpszDir
|| *lpszFile
!= '\\' || PathIsUNCW(lpszFile
))
178 strncpyW(szTemp
, lpszFile
, MAX_PATH
);
191 strncpyW(szTemp
, lpszDir
, MAX_PATH
);
194 PathStripToRootW(szTemp
);
195 lpszFile
++; /* Skip '\' */
197 if (!PathAddBackslashW(szTemp
))
199 if (strlenW(szTemp
) + strlenW(lpszFile
) >= MAX_PATH
)
201 strcatW(szTemp
, lpszFile
);
204 PathCanonicalizeW(lpszDest
, szTemp
);
208 /*************************************************************************
209 * PathAddBackslashA [SHLWAPI.@]
211 * Append a backslash ('\') to a path if one doesn't exist.
214 * lpszPath [I/O] The path to append a backslash to.
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
)
224 TRACE("(%s)\n",debugstr_a(lpszPath
));
226 if (!lpszPath
|| (iLen
= strlen(lpszPath
)) >= MAX_PATH
)
232 if (lpszPath
[-1] != '\\')
241 /*************************************************************************
242 * PathAddBackslashW [SHLWAPI.@]
244 * See PathAddBackslashA.
246 LPWSTR WINAPI
PathAddBackslashW( LPWSTR lpszPath
)
250 TRACE("(%s)\n",debugstr_w(lpszPath
));
252 if (!lpszPath
|| (iLen
= strlenW(lpszPath
)) >= MAX_PATH
)
258 if (lpszPath
[-1] != '\\')
267 /*************************************************************************
268 * PathBuildRootA [SHLWAPI.@]
270 * Create a root drive string (e.g. "A:\") from a drive number.
273 * lpszPath [O] Destination for the drive string
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
;
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
;
314 /*************************************************************************
315 * PathFindFileNameA [SHLWAPI.@]
317 * Locate the start of the file name in a path
320 * lpszPath [I] Path to search
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
368 * lpszPath [I] The path to search
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
));
384 if (*lpszPath
== '\\' || *lpszPath
==' ')
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
));
409 if (*lpszPath
== '\\' || *lpszPath
==' ')
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.
425 * lpszPath [I] The string to search for arguments in
428 * The start of the next argument in lpszPath, or NULL if lpszPath is NULL
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
));
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.@]
458 LPWSTR WINAPI
PathGetArgsW(LPCWSTR lpszPath
)
460 BOOL bSeenQuote
= FALSE
;
462 TRACE("(%s)\n",debugstr_w(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
484 * lpszPath [I] Path to get the drive number from
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';
500 /*************************************************************************
501 * PathGetDriveNumberW [SHLWAPI.@]
503 * See PathGetDriveNumberA.
505 int WINAPI
PathGetDriveNumberW(LPCWSTR lpszPath
)
507 TRACE ("(%s)\n",debugstr_w(lpszPath
));
509 if (lpszPath
&& lpszPath
[1] == ':' &&
510 tolowerW(*lpszPath
) >= 'a' && tolowerW(*lpszPath
) <= 'z')
511 return tolowerW(*lpszPath
) - 'a';
515 /*************************************************************************
516 * PathRemoveFileSpecA [SHLWAPI.@]
518 * Remove the file specification from a path.
521 * lpszPath [I/O] Path to remove the file spec from
524 * TRUE If the path was valid and modified
527 BOOL WINAPI
PathRemoveFileSpecA(LPSTR lpszPath
)
529 LPSTR lpszFileSpec
= lpszPath
;
530 BOOL bModified
= FALSE
;
532 TRACE("(%s)\n",debugstr_a(lpszPath
));
536 /* Skip directory or UNC path */
537 if (*lpszPath
== '\\')
538 lpszFileSpec
= ++lpszPath
;
539 if (*lpszPath
== '\\')
540 lpszFileSpec
= ++lpszPath
;
544 if(*lpszPath
== '\\')
545 lpszFileSpec
= lpszPath
; /* Skip dir */
546 else if(*lpszPath
== ':')
548 lpszFileSpec
= ++lpszPath
; /* Skip drive */
549 if (*lpszPath
== '\\')
552 if (!(lpszPath
= CharNextA(lpszPath
)))
558 *lpszFileSpec
= '\0';
565 /*************************************************************************
566 * PathRemoveFileSpecW [SHLWAPI.@]
568 * See PathRemoveFileSpecA.
570 BOOL WINAPI
PathRemoveFileSpecW(LPWSTR lpszPath
)
572 LPWSTR lpszFileSpec
= lpszPath
;
573 BOOL bModified
= FALSE
;
575 TRACE("(%s)\n",debugstr_w(lpszPath
));
579 /* Skip directory or UNC path */
580 if (*lpszPath
== '\\')
581 lpszFileSpec
= ++lpszPath
;
582 if (*lpszPath
== '\\')
583 lpszFileSpec
= ++lpszPath
;
587 if(*lpszPath
== '\\')
588 lpszFileSpec
= lpszPath
; /* Skip dir */
589 else if(*lpszPath
== ':')
591 lpszFileSpec
= ++lpszPath
; /* Skip drive */
592 if (*lpszPath
== '\\')
595 if (!(lpszPath
= CharNextW(lpszPath
)))
601 *lpszFileSpec
= '\0';
608 /*************************************************************************
609 * PathStripPathA [SHLWAPI.@]
611 * Remove the initial path from the beginning of a filename
614 * lpszPath [I/O] Path to remove the initial path from
619 void WINAPI
PathStripPathA(LPSTR lpszPath
)
621 TRACE("(%s)\n", debugstr_a(lpszPath
));
625 LPSTR lpszFileName
= PathFindFileNameA(lpszPath
);
627 RtlMoveMemory(lpszPath
, lpszFileName
, strlen(lpszFileName
)+1);
631 /*************************************************************************
632 * PathStripPathW [SHLWAPI.@]
634 * See PathStripPathA.
636 void WINAPI
PathStripPathW(LPWSTR lpszPath
)
640 TRACE("(%s)\n", debugstr_w(lpszPath
));
641 lpszFileName
= PathFindFileNameW(lpszPath
);
643 RtlMoveMemory(lpszPath
, lpszFileName
, (strlenW(lpszFileName
)+1)*sizeof(WCHAR
));
646 /*************************************************************************
647 * PathStripToRootA [SHLWAPI.@]
649 * Reduce a path to its root.
652 * lpszPath [I/O] the path to reduce
655 * Success: TRUE if the stripped path is a root path
656 * Failure: FALSE if the path cannot be stripped or is NULL
658 BOOL WINAPI
PathStripToRootA(LPSTR lpszPath
)
660 TRACE("(%s)\n", debugstr_a(lpszPath
));
664 while(!PathIsRootA(lpszPath
))
665 if (!PathRemoveFileSpecA(lpszPath
))
670 /*************************************************************************
671 * PathStripToRootW [SHLWAPI.@]
673 * See PathStripToRootA.
675 BOOL WINAPI
PathStripToRootW(LPWSTR lpszPath
)
677 TRACE("(%s)\n", debugstr_w(lpszPath
));
681 while(!PathIsRootW(lpszPath
))
682 if (!PathRemoveFileSpecW(lpszPath
))
687 /*************************************************************************
688 * PathRemoveArgsA [SHLWAPI.@]
690 * Strip space separated arguments from a path.
693 * lpszPath [I/O] Path to remove arguments from
698 void WINAPI
PathRemoveArgsA(LPSTR lpszPath
)
700 TRACE("(%s)\n",debugstr_a(lpszPath
));
704 LPSTR lpszArgs
= PathGetArgsA(lpszPath
);
709 LPSTR lpszLastChar
= CharPrevA(lpszPath
, lpszArgs
);
710 if(*lpszLastChar
== ' ')
711 *lpszLastChar
= '\0';
716 /*************************************************************************
717 * PathRemoveArgsW [SHLWAPI.@]
719 * See PathRemoveArgsA.
721 void WINAPI
PathRemoveArgsW(LPWSTR lpszPath
)
723 TRACE("(%s)\n",debugstr_w(lpszPath
));
727 LPWSTR lpszArgs
= PathGetArgsW(lpszPath
);
732 LPWSTR lpszLastChar
= CharPrevW(lpszPath
, lpszArgs
);
733 if(*lpszLastChar
== ' ')
734 *lpszLastChar
= '\0';
739 /*************************************************************************
740 * PathRemoveExtensionA [SHLWAPI.@]
742 * Remove the file extension from a path
745 * lpszPath [I/O] Path to remove the extension from
750 void WINAPI
PathRemoveExtensionA(LPSTR lpszPath
)
752 TRACE("(%s)\n", debugstr_a(lpszPath
));
756 lpszPath
= PathFindExtensionA(lpszPath
);
761 /*************************************************************************
762 * PathRemoveExtensionW [SHLWAPI.@]
764 * See PathRemoveExtensionA.
766 void WINAPI
PathRemoveExtensionW(LPWSTR lpszPath
)
768 TRACE("(%s)\n", debugstr_w(lpszPath
));
772 lpszPath
= PathFindExtensionW(lpszPath
);
777 /*************************************************************************
778 * PathRemoveBackslashA [SHLWAPI.@]
780 * Remove a trailing backslash from a path.
783 * lpszPath [I/O] Path to remove backslash from
786 * Success: A pointer to the end of the path
787 * Failure: NULL, if lpszPath is NULL
789 LPSTR WINAPI
PathRemoveBackslashA( LPSTR lpszPath
)
793 TRACE("(%s)\n", debugstr_a(lpszPath
));
797 szTemp
= CharPrevA(lpszPath
, lpszPath
+ strlen(lpszPath
));
798 if (!PathIsRootA(lpszPath
) && *szTemp
== '\\')
804 /*************************************************************************
805 * PathRemoveBackslashW [SHLWAPI.@]
807 * See PathRemoveBackslashA.
809 LPWSTR WINAPI
PathRemoveBackslashW( LPWSTR lpszPath
)
811 LPWSTR szTemp
= NULL
;
813 TRACE("(%s)\n", debugstr_w(lpszPath
));
817 szTemp
= CharPrevW(lpszPath
, lpszPath
+ strlenW(lpszPath
));
818 if (!PathIsRootW(lpszPath
) && *szTemp
== '\\')
824 /*************************************************************************
825 * PathRemoveBlanksA [SHLWAPI.@]
827 * Remove Spaces from the start and end of a path.
830 * lpszPath [I/O] Path to strip blanks from
835 VOID WINAPI
PathRemoveBlanksA(LPSTR lpszPath
)
837 TRACE("(%s)\n", debugstr_a(lpszPath
));
839 if(lpszPath
&& *lpszPath
)
841 LPSTR start
= lpszPath
;
843 while (*lpszPath
== ' ')
844 lpszPath
= CharNextA(lpszPath
);
847 *start
++ = *lpszPath
++;
849 if (start
!= lpszPath
)
850 while (start
[-1] == ' ')
856 /*************************************************************************
857 * PathRemoveBlanksW [SHLWAPI.@]
859 * See PathRemoveBlanksA.
861 VOID WINAPI
PathRemoveBlanksW(LPWSTR lpszPath
)
863 TRACE("(%s)\n", debugstr_w(lpszPath
));
865 if(lpszPath
&& *lpszPath
)
867 LPWSTR start
= lpszPath
;
869 while (*lpszPath
== ' ')
873 *start
++ = *lpszPath
++;
875 if (start
!= lpszPath
)
876 while (start
[-1] == ' ')
882 /*************************************************************************
883 * PathQuoteSpacesA [SHLWAPI.@]
885 * Surround a path containg spaces in quotes.
888 * lpszPath [I/O] Path to quote
894 * The path is not changed if it is invalid or has no spaces.
896 VOID WINAPI
PathQuoteSpacesA(LPSTR lpszPath
)
898 TRACE("(%s)\n", debugstr_a(lpszPath
));
900 if(lpszPath
&& StrChrA(lpszPath
,' '))
902 size_t iLen
= strlen(lpszPath
) + 1;
904 if (iLen
+ 2 < MAX_PATH
)
906 memmove(lpszPath
+ 1, lpszPath
, iLen
);
908 lpszPath
[iLen
] = '"';
909 lpszPath
[iLen
+ 1] = '\0';
914 /*************************************************************************
915 * PathQuoteSpacesW [SHLWAPI.@]
917 * See PathQuoteSpacesA.
919 VOID WINAPI
PathQuoteSpacesW(LPWSTR lpszPath
)
921 TRACE("(%s)\n", debugstr_w(lpszPath
));
923 if(lpszPath
&& StrChrW(lpszPath
,' '))
925 int iLen
= strlenW(lpszPath
) + 1;
927 if (iLen
+ 2 < MAX_PATH
)
929 memmove(lpszPath
+ 1, lpszPath
, iLen
* sizeof(WCHAR
));
931 lpszPath
[iLen
] = '"';
932 lpszPath
[iLen
+ 1] = '\0';
937 /*************************************************************************
938 * PathUnquoteSpacesA [SHLWAPI.@]
940 * Remove quotes ("") from around a path, if present.
943 * lpszPath [I/O] Path to strip quotes from
949 * If the path contains a single quote only, an empty string will result.
950 * Otherwise quotes are only removed if they appear at the start and end
953 VOID WINAPI
PathUnquoteSpacesA(LPSTR lpszPath
)
955 TRACE("(%s)\n", debugstr_a(lpszPath
));
957 if (lpszPath
&& *lpszPath
== '"')
959 DWORD dwLen
= strlen(lpszPath
) - 1;
961 if (lpszPath
[dwLen
] == '"')
963 lpszPath
[dwLen
] = '\0';
964 for (; *lpszPath
; lpszPath
++)
965 *lpszPath
= lpszPath
[1];
970 /*************************************************************************
971 * PathUnquoteSpacesW [SHLWAPI.@]
973 * See PathUnquoteSpacesA.
975 VOID WINAPI
PathUnquoteSpacesW(LPWSTR lpszPath
)
977 TRACE("(%s)\n", debugstr_w(lpszPath
));
979 if (lpszPath
&& *lpszPath
== '"')
981 DWORD dwLen
= strlenW(lpszPath
) - 1;
983 if (lpszPath
[dwLen
] == '"')
985 lpszPath
[dwLen
] = '\0';
986 for (; *lpszPath
; lpszPath
++)
987 *lpszPath
= lpszPath
[1];
992 /*************************************************************************
993 * PathParseIconLocationA [SHLWAPI.@]
995 * Parse the location of an icon from a path.
998 * lpszPath [I/O] The path to parse the icon location from.
1001 * Success: The number of the icon
1002 * Failure: 0 if the path does not contain an icon location or is NULL
1005 * The path has surrounding quotes and spaces removed regardless
1006 * of whether the call succeeds or not.
1008 int WINAPI
PathParseIconLocationA(LPSTR lpszPath
)
1013 TRACE("(%s)\n", debugstr_a(lpszPath
));
1017 if ((lpszComma
= strchr(lpszPath
, ',')))
1019 *lpszComma
++ = '\0';
1020 iRet
= StrToIntA(lpszComma
);
1022 PathUnquoteSpacesA(lpszPath
);
1023 PathRemoveBlanksA(lpszPath
);
1028 /*************************************************************************
1029 * PathParseIconLocationW [SHLWAPI.@]
1031 * See PathParseIconLocationA.
1033 int WINAPI
PathParseIconLocationW(LPWSTR lpszPath
)
1038 TRACE("(%s)\n", debugstr_w(lpszPath
));
1042 if ((lpszComma
= StrChrW(lpszPath
, ',')))
1044 *lpszComma
++ = '\0';
1045 iRet
= StrToIntW(lpszComma
);
1047 PathUnquoteSpacesW(lpszPath
);
1048 PathRemoveBlanksW(lpszPath
);
1053 /*************************************************************************
1056 * Unicode version of PathFileExistsDefExtA.
1058 BOOL WINAPI
PathFileExistsDefExtW(LPWSTR lpszPath
,DWORD dwWhich
)
1060 static const WCHAR pszExts
[7][5] = { { '.', 'p', 'i', 'f', 0},
1061 { '.', 'c', 'o', 'm', 0},
1062 { '.', 'e', 'x', 'e', 0},
1063 { '.', 'b', 'a', 't', 0},
1064 { '.', 'l', 'n', 'k', 0},
1065 { '.', 'c', 'm', 'd', 0},
1068 TRACE("(%s,%ld)\n", debugstr_w(lpszPath
), dwWhich
);
1070 if (!lpszPath
|| PathIsUNCServerW(lpszPath
) || PathIsUNCServerShareW(lpszPath
))
1075 LPCWSTR szExt
= PathFindExtensionW(lpszPath
);
1076 if (!*szExt
|| dwWhich
& 0x40)
1079 int iLen
= lstrlenW(lpszPath
);
1080 if (iLen
> (MAX_PATH
- 5))
1082 while ( (dwWhich
& 0x1) && pszExts
[iChoose
][0] )
1084 lstrcpyW(lpszPath
+ iLen
, pszExts
[iChoose
]);
1085 if (PathFileExistsW(lpszPath
))
1090 *(lpszPath
+ iLen
) = (WCHAR
)'\0';
1094 return PathFileExistsW(lpszPath
);
1097 /*************************************************************************
1100 * Determine if a file exists locally and is of an executable type.
1103 * lpszPath [I/O] File to search for
1104 * dwWhich [I] Type of executable to search for
1107 * TRUE If the file was found. lpszPath contains the file name.
1111 * lpszPath is modified in place and must be at least MAX_PATH in length.
1112 * If the function returns FALSE, the path is modified to its orginal state.
1113 * If the given path contains an extension or dwWhich is 0, executable
1114 * extensions are not checked.
1116 * Ordinals 3-6 are a classic case of MS exposing limited functionality to
1117 * users (here through PathFindOnPathA()) and keeping advanced functionality for
1118 * their own developers exclusive use. Monopoly, anyone?
1120 BOOL WINAPI
PathFileExistsDefExtA(LPSTR lpszPath
,DWORD dwWhich
)
1124 TRACE("(%s,%ld)\n", debugstr_a(lpszPath
), dwWhich
);
1128 WCHAR szPath
[MAX_PATH
];
1129 MultiByteToWideChar(CP_ACP
,0,lpszPath
,-1,szPath
,MAX_PATH
);
1130 bRet
= PathFileExistsDefExtW(szPath
, dwWhich
);
1132 WideCharToMultiByte(CP_ACP
,0,szPath
,-1,lpszPath
,MAX_PATH
,0,0);
1137 /*************************************************************************
1138 * SHLWAPI_PathFindInOtherDirs
1140 * Internal helper for SHLWAPI_PathFindOnPathExA/W.
1142 static BOOL WINAPI
SHLWAPI_PathFindInOtherDirs(LPWSTR lpszFile
, DWORD dwWhich
)
1144 static const WCHAR szSystem
[] = { 'S','y','s','t','e','m','\0'};
1145 static const WCHAR szPath
[] = { 'P','A','T','H','\0'};
1149 WCHAR buff
[MAX_PATH
];
1151 TRACE("(%s,%08lx)\n", debugstr_w(lpszFile
), dwWhich
);
1153 /* Try system directories */
1154 GetSystemDirectoryW(buff
, MAX_PATH
);
1155 if (!PathAppendW(buff
, lpszFile
))
1157 if (PathFileExistsDefExtW(buff
, dwWhich
))
1159 strcpyW(lpszFile
, buff
);
1162 GetWindowsDirectoryW(buff
, MAX_PATH
);
1163 if (!PathAppendW(buff
, szSystem
) || !PathAppendW(buff
, lpszFile
))
1165 if (PathFileExistsDefExtW(buff
, dwWhich
))
1167 strcpyW(lpszFile
, buff
);
1170 GetWindowsDirectoryW(buff
, MAX_PATH
);
1171 if (!PathAppendW(buff
, lpszFile
))
1173 if (PathFileExistsDefExtW(buff
, dwWhich
))
1175 strcpyW(lpszFile
, buff
);
1178 /* Try dirs listed in %PATH% */
1179 dwLenPATH
= GetEnvironmentVariableW(szPath
, buff
, MAX_PATH
);
1181 if (!dwLenPATH
|| !(lpszPATH
= malloc((dwLenPATH
+ 1) * sizeof (WCHAR
))))
1184 GetEnvironmentVariableW(szPath
, lpszPATH
, dwLenPATH
+ 1);
1185 lpszCurr
= lpszPATH
;
1188 LPCWSTR lpszEnd
= lpszCurr
;
1189 LPWSTR pBuff
= buff
;
1191 while (*lpszEnd
== ' ')
1193 while (*lpszEnd
&& *lpszEnd
!= ';')
1194 *pBuff
++ = *lpszEnd
++;
1198 lpszCurr
= lpszEnd
+ 1;
1200 lpszCurr
= NULL
; /* Last Path, terminate after this */
1202 if (!PathAppendW(buff
, lpszFile
))
1207 if (PathFileExistsDefExtW(buff
, dwWhich
))
1209 strcpyW(lpszFile
, buff
);
1218 /*************************************************************************
1221 * Search a range of paths for a specific type of executable.
1224 * lpszFile [I/O] File to search for
1225 * lppszOtherDirs [I] Other directories to look in
1226 * dwWhich [I] Type of executable to search for
1229 * Success: TRUE. The path to the executable is stored in lpszFile.
1230 * Failure: FALSE. The path to the executable is unchanged.
1232 BOOL WINAPI
PathFindOnPathExA(LPSTR lpszFile
,LPCSTR
*lppszOtherDirs
,DWORD dwWhich
)
1234 WCHAR szFile
[MAX_PATH
];
1235 WCHAR buff
[MAX_PATH
];
1237 TRACE("(%s,%p,%08lx)\n", debugstr_a(lpszFile
), lppszOtherDirs
, dwWhich
);
1239 if (!lpszFile
|| !PathIsFileSpecA(lpszFile
))
1242 MultiByteToWideChar(CP_ACP
,0,lpszFile
,-1,szFile
,MAX_PATH
);
1244 /* Search provided directories first */
1245 if (lppszOtherDirs
&& *lppszOtherDirs
)
1247 WCHAR szOther
[MAX_PATH
];
1248 LPCSTR
*lpszOtherPath
= lppszOtherDirs
;
1250 while (lpszOtherPath
&& *lpszOtherPath
&& (*lpszOtherPath
)[0])
1252 MultiByteToWideChar(CP_ACP
,0,*lpszOtherPath
,-1,szOther
,MAX_PATH
);
1253 PathCombineW(buff
, szOther
, szFile
);
1254 if (PathFileExistsDefExtW(buff
, dwWhich
))
1256 WideCharToMultiByte(CP_ACP
,0,buff
,-1,lpszFile
,MAX_PATH
,0,0);
1262 /* Not found, try system and path dirs */
1263 if (SHLWAPI_PathFindInOtherDirs(szFile
, dwWhich
))
1265 WideCharToMultiByte(CP_ACP
,0,szFile
,-1,lpszFile
,MAX_PATH
,0,0);
1271 /*************************************************************************
1274 * Unicode version of PathFindOnPathExA.
1276 BOOL WINAPI
PathFindOnPathExW(LPWSTR lpszFile
,LPCWSTR
*lppszOtherDirs
,DWORD dwWhich
)
1278 WCHAR buff
[MAX_PATH
];
1280 TRACE("(%s,%p,%08lx)\n", debugstr_w(lpszFile
), lppszOtherDirs
, dwWhich
);
1282 if (!lpszFile
|| !PathIsFileSpecW(lpszFile
))
1285 /* Search provided directories first */
1286 if (lppszOtherDirs
&& *lppszOtherDirs
)
1288 LPCWSTR
*lpszOtherPath
= lppszOtherDirs
;
1289 while (lpszOtherPath
&& *lpszOtherPath
&& (*lpszOtherPath
)[0])
1291 PathCombineW(buff
, *lpszOtherPath
, lpszFile
);
1292 if (PathFileExistsDefExtW(buff
, dwWhich
))
1294 strcpyW(lpszFile
, buff
);
1300 /* Not found, try system and path dirs */
1301 return SHLWAPI_PathFindInOtherDirs(lpszFile
, dwWhich
);
1304 /*************************************************************************
1305 * PathFindOnPathA [SHLWAPI.@]
1307 * Search a range of paths for an executable.
1310 * lpszFile [I/O] File to search for
1311 * lppszOtherDirs [I] Other directories to look in
1314 * Success: TRUE. The path to the executable is stored in lpszFile.
1315 * Failure: FALSE. The path to the executable is unchanged.
1317 BOOL WINAPI
PathFindOnPathA(LPSTR lpszFile
, LPCSTR
*lppszOtherDirs
)
1319 TRACE("(%s,%p)\n", debugstr_a(lpszFile
), lppszOtherDirs
);
1320 return PathFindOnPathExA(lpszFile
, lppszOtherDirs
, 0);
1323 /*************************************************************************
1324 * PathFindOnPathW [SHLWAPI.@]
1326 * See PathFindOnPathA.
1328 BOOL WINAPI
PathFindOnPathW(LPWSTR lpszFile
, LPCWSTR
*lppszOtherDirs
)
1330 TRACE("(%s,%p)\n", debugstr_w(lpszFile
), lppszOtherDirs
);
1331 return PathFindOnPathExW(lpszFile
,lppszOtherDirs
, 0);
1334 /*************************************************************************
1335 * PathCompactPathExA [SHLWAPI.@]
1337 * Compact a path into a given number of characters.
1340 * lpszDest [O] Destination for compacted path
1341 * lpszPath [I] Source path
1342 * cchMax [I] Maximum size of compacted path
1343 * dwFlags [I] Reserved
1346 * Success: TRUE. The compacted path is written to lpszDest.
1347 * Failure: FALSE. lpszPath is undefined.
1350 * If cchMax is given as 0, lpszDest will still be NUL terminated.
1352 * The Win32 version of this function contains a bug: When cchMax == 7,
1353 * 8 bytes will be written to lpszDest. This bug is fixed in the Wine
1356 * Some relative paths will be different when cchMax == 5 or 6. This occurs
1357 * because Win32 will insert a "\" in lpszDest, even if one is
1358 * not present in the original path.
1360 BOOL WINAPI
PathCompactPathExA(LPSTR lpszDest
, LPCSTR lpszPath
,
1361 UINT cchMax
, DWORD dwFlags
)
1365 TRACE("(%p,%s,%d,0x%08lx)\n", lpszDest
, debugstr_a(lpszPath
), cchMax
, dwFlags
);
1367 if (lpszPath
&& lpszDest
)
1369 WCHAR szPath
[MAX_PATH
];
1370 WCHAR szDest
[MAX_PATH
];
1372 MultiByteToWideChar(CP_ACP
,0,lpszPath
,-1,szPath
,MAX_PATH
);
1374 bRet
= PathCompactPathExW(szDest
, szPath
, cchMax
, dwFlags
);
1375 WideCharToMultiByte(CP_ACP
,0,szDest
,-1,lpszDest
,MAX_PATH
,0,0);
1380 /*************************************************************************
1381 * PathCompactPathExW [SHLWAPI.@]
1383 * See PathCompactPathExA.
1385 BOOL WINAPI
PathCompactPathExW(LPWSTR lpszDest
, LPCWSTR lpszPath
,
1386 UINT cchMax
, DWORD dwFlags
)
1388 static const WCHAR szEllipses
[] = { '.', '.', '.', '\0' };
1390 DWORD dwLen
, dwFileLen
= 0;
1392 TRACE("(%p,%s,%d,0x%08lx)\n", lpszDest
, debugstr_w(lpszPath
), cchMax
, dwFlags
);
1399 WARN("Invalid lpszDest would crash under Win32!\n");
1408 dwLen
= strlenW(lpszPath
) + 1;
1412 /* Don't need to compact */
1413 memcpy(lpszDest
, lpszPath
, dwLen
* sizeof(WCHAR
));
1417 /* Path must be compacted to fit into lpszDest */
1418 lpszFile
= PathFindFileNameW(lpszPath
);
1419 dwFileLen
= lpszPath
+ dwLen
- lpszFile
;
1421 if (dwFileLen
== dwLen
)
1423 /* No root in psth */
1426 while (--cchMax
> 0) /* No room left for anything but ellipses */
1431 /* Compact the file name with ellipses at the end */
1433 memcpy(lpszDest
, lpszFile
, cchMax
* sizeof(WCHAR
));
1434 strcpyW(lpszDest
+ cchMax
, szEllipses
);
1437 /* We have a root in the path */
1438 lpszFile
--; /* Start compacted filename with the path separator */
1441 if (dwFileLen
+ 3 > cchMax
)
1443 /* Compact the file name */
1446 while (--cchMax
> 0) /* No room left for anything but ellipses */
1451 strcpyW(lpszDest
, szEllipses
);
1454 *lpszDest
++ = *lpszFile
++;
1457 while (--cchMax
> 0) /* No room left for anything but ellipses */
1463 memcpy(lpszDest
, lpszFile
, cchMax
* sizeof(WCHAR
));
1464 strcpyW(lpszDest
+ cchMax
, szEllipses
);
1468 /* Only the root needs to be Compacted */
1469 dwLen
= cchMax
- dwFileLen
- 3;
1470 memcpy(lpszDest
, lpszPath
, dwLen
* sizeof(WCHAR
));
1471 strcpyW(lpszDest
+ dwLen
, szEllipses
);
1472 strcpyW(lpszDest
+ dwLen
+ 3, lpszFile
);
1476 /*************************************************************************
1477 * PathIsRelativeA [SHLWAPI.@]
1479 * Determine if a path is a relative path.
1482 * lpszPath [I] Path to check
1485 * TRUE: The path is relative, or is invalid.
1486 * FALSE: The path is not relative.
1488 BOOL WINAPI
PathIsRelativeA (LPCSTR lpszPath
)
1490 TRACE("(%s)\n",debugstr_a(lpszPath
));
1492 if (!lpszPath
|| !*lpszPath
|| IsDBCSLeadByte(*lpszPath
))
1494 if (*lpszPath
== '\\' || (*lpszPath
&& lpszPath
[1] == ':'))
1499 /*************************************************************************
1500 * PathIsRelativeW [SHLWAPI.@]
1502 * See PathIsRelativeA.
1504 BOOL WINAPI
PathIsRelativeW (LPCWSTR lpszPath
)
1506 TRACE("(%s)\n",debugstr_w(lpszPath
));
1508 if (!lpszPath
|| !*lpszPath
)
1510 if (*lpszPath
== '\\' || (*lpszPath
&& lpszPath
[1] == ':'))
1515 /*************************************************************************
1516 * PathIsRootA [SHLWAPI.@]
1518 * Determine if a path is a root path.
1521 * lpszPath [I] Path to check
1524 * TRUE If lpszPath is valid and a root path,
1527 BOOL WINAPI
PathIsRootA(LPCSTR lpszPath
)
1529 TRACE("(%s)\n", debugstr_a(lpszPath
));
1531 if (lpszPath
&& *lpszPath
)
1533 if (*lpszPath
== '\\')
1536 return TRUE
; /* \ */
1537 else if (lpszPath
[1]=='\\')
1539 BOOL bSeenSlash
= FALSE
;
1542 /* Check for UNC root path */
1545 if (*lpszPath
== '\\')
1551 lpszPath
= CharNextA(lpszPath
);
1556 else if (lpszPath
[1] == ':' && lpszPath
[2] == '\\' && lpszPath
[3] == '\0')
1557 return TRUE
; /* X:\ */
1562 /*************************************************************************
1563 * PathIsRootW [SHLWAPI.@]
1567 BOOL WINAPI
PathIsRootW(LPCWSTR lpszPath
)
1569 TRACE("(%s)\n", debugstr_w(lpszPath
));
1571 if (lpszPath
&& *lpszPath
)
1573 if (*lpszPath
== '\\')
1576 return TRUE
; /* \ */
1577 else if (lpszPath
[1]=='\\')
1579 BOOL bSeenSlash
= FALSE
;
1582 /* Check for UNC root path */
1585 if (*lpszPath
== '\\')
1591 lpszPath
= CharNextW(lpszPath
);
1596 else if (lpszPath
[1] == ':' && lpszPath
[2] == '\\' && lpszPath
[3] == '\0')
1597 return TRUE
; /* X:\ */
1602 /*************************************************************************
1603 * PathIsDirectoryA [SHLWAPI.@]
1605 * Determine if a path is a valid directory
1608 * lpszPath [I] Path to check.
1611 * FILE_ATTRIBUTE_DIRECTORY if lpszPath exists and can be read (See Notes)
1612 * FALSE if lpszPath is invalid or not a directory.
1615 * Although this function is prototyped as returning a BOOL, it returns
1616 * FILE_ATTRIBUTE_DIRECTORY for success. This means that code such as:
1618 *| if (PathIsDirectoryA("c:\\windows\\") == TRUE)
1623 BOOL WINAPI
PathIsDirectoryA(LPCSTR lpszPath
)
1627 TRACE("(%s)\n", debugstr_a(lpszPath
));
1629 if (!lpszPath
|| PathIsUNCServerA(lpszPath
))
1632 if (PathIsUNCServerShareA(lpszPath
))
1634 FIXME("UNC Server Share not yet supported - FAILING\n");
1638 if ((dwAttr
= GetFileAttributesA(lpszPath
)) == INVALID_FILE_ATTRIBUTES
)
1640 return dwAttr
& FILE_ATTRIBUTE_DIRECTORY
;
1643 /*************************************************************************
1644 * PathIsDirectoryW [SHLWAPI.@]
1646 * See PathIsDirectoryA.
1648 BOOL WINAPI
PathIsDirectoryW(LPCWSTR lpszPath
)
1652 TRACE("(%s)\n", debugstr_w(lpszPath
));
1654 if (!lpszPath
|| PathIsUNCServerW(lpszPath
))
1657 if (PathIsUNCServerShareW(lpszPath
))
1659 FIXME("UNC Server Share not yet supported - FAILING\n");
1663 if ((dwAttr
= GetFileAttributesW(lpszPath
)) == INVALID_FILE_ATTRIBUTES
)
1665 return dwAttr
& FILE_ATTRIBUTE_DIRECTORY
;
1668 /*************************************************************************
1669 * PathFileExistsA [SHLWAPI.@]
1671 * Determine if a file exists.
1674 * lpszPath [I] Path to check
1677 * TRUE If the file exists and is readable
1680 BOOL WINAPI
PathFileExistsA(LPCSTR lpszPath
)
1685 TRACE("(%s)\n",debugstr_a(lpszPath
));
1690 iPrevErrMode
= SetErrorMode(1);
1691 dwAttr
= GetFileAttributesA(lpszPath
);
1692 SetErrorMode(iPrevErrMode
);
1693 return dwAttr
== INVALID_FILE_ATTRIBUTES
? FALSE
: TRUE
;
1696 /*************************************************************************
1697 * PathFileExistsW [SHLWAPI.@]
1699 * See PathFileExistsA.
1701 BOOL WINAPI
PathFileExistsW(LPCWSTR lpszPath
)
1706 TRACE("(%s)\n",debugstr_w(lpszPath
));
1711 iPrevErrMode
= SetErrorMode(1);
1712 dwAttr
= GetFileAttributesW(lpszPath
);
1713 SetErrorMode(iPrevErrMode
);
1714 return dwAttr
== INVALID_FILE_ATTRIBUTES
? FALSE
: TRUE
;
1717 /*************************************************************************
1718 * PathFileExistsAndAttributesA [SHLWAPI.445]
1720 * Determine if a file exists.
1723 * lpszPath [I] Path to check
1724 * dwAttr [O] attributes of file
1727 * TRUE If the file exists and is readable
1730 BOOL WINAPI
PathFileExistsAndAttributesA(LPCSTR lpszPath
, DWORD
*dwAttr
)
1735 TRACE("(%s %p)\n", debugstr_a(lpszPath
), dwAttr
);
1738 *dwAttr
= INVALID_FILE_ATTRIBUTES
;
1743 iPrevErrMode
= SetErrorMode(SEM_FAILCRITICALERRORS
);
1744 dwVal
= GetFileAttributesA(lpszPath
);
1745 SetErrorMode(iPrevErrMode
);
1748 return (dwVal
!= INVALID_FILE_ATTRIBUTES
);
1751 /*************************************************************************
1752 * PathFileExistsAndAttributesW [SHLWAPI.446]
1754 * See PathFileExistsA.
1756 BOOL WINAPI
PathFileExistsAndAttributesW(LPCWSTR lpszPath
, DWORD
*dwAttr
)
1761 TRACE("(%s %p)\n", debugstr_w(lpszPath
), dwAttr
);
1766 iPrevErrMode
= SetErrorMode(SEM_FAILCRITICALERRORS
);
1767 dwVal
= GetFileAttributesW(lpszPath
);
1768 SetErrorMode(iPrevErrMode
);
1771 return (dwVal
!= INVALID_FILE_ATTRIBUTES
);
1774 /*************************************************************************
1775 * PathMatchSingleMaskA [internal]
1777 static BOOL WINAPI
PathMatchSingleMaskA(LPCSTR name
, LPCSTR mask
)
1779 while (*name
&& *mask
&& *mask
!=';')
1785 if (PathMatchSingleMaskA(name
,mask
+1))
1786 return TRUE
; /* try substrings */
1791 if (toupper(*mask
) != toupper(*name
) && *mask
!= '?')
1794 name
= CharNextA(name
);
1795 mask
= CharNextA(mask
);
1800 while (*mask
== '*')
1802 if (!*mask
|| *mask
== ';')
1808 /*************************************************************************
1809 * PathMatchSingleMaskW [internal]
1811 static BOOL WINAPI
PathMatchSingleMaskW(LPCWSTR name
, LPCWSTR mask
)
1813 while (*name
&& *mask
&& *mask
!= ';')
1819 if (PathMatchSingleMaskW(name
,mask
+1))
1820 return TRUE
; /* try substrings */
1825 if (toupperW(*mask
) != toupperW(*name
) && *mask
!= '?')
1828 name
= CharNextW(name
);
1829 mask
= CharNextW(mask
);
1833 while (*mask
== '*')
1835 if (!*mask
|| *mask
== ';')
1841 /*************************************************************************
1842 * PathMatchSpecA [SHLWAPI.@]
1844 * Determine if a path matches one or more search masks.
1847 * lpszPath [I] Path to check
1848 * lpszMask [I] Search mask(s)
1851 * TRUE If lpszPath is valid and is matched
1855 * Multiple search masks may be given if they are separated by ";". The
1856 * pattern "*.*" is treated specially in that it matches all paths (for
1857 * backwards compatibility with DOS).
1859 BOOL WINAPI
PathMatchSpecA(LPCSTR lpszPath
, LPCSTR lpszMask
)
1861 TRACE("(%s,%s)\n", lpszPath
, lpszMask
);
1863 if (!lstrcmpA(lpszMask
, "*.*"))
1864 return TRUE
; /* Matches every path */
1868 if (PathMatchSingleMaskA(lpszPath
, lpszMask
))
1869 return TRUE
; /* Matches the current mask */
1871 while (*lpszMask
&& *lpszMask
!= ';')
1872 lpszMask
= CharNextA(lpszMask
);
1874 if (*lpszMask
== ';')
1877 while (*lpszMask
== ' ')
1878 lpszMask
++; /* masks may be separated by "; " */
1884 /*************************************************************************
1885 * PathMatchSpecW [SHLWAPI.@]
1887 * See PathMatchSpecA.
1889 BOOL WINAPI
PathMatchSpecW(LPCWSTR lpszPath
, LPCWSTR lpszMask
)
1891 static const WCHAR szStarDotStar
[] = { '*', '.', '*', '\0' };
1893 TRACE("(%s,%s)\n", debugstr_w(lpszPath
), debugstr_w(lpszMask
));
1895 if (!lstrcmpW(lpszMask
, szStarDotStar
))
1896 return TRUE
; /* Matches every path */
1900 if (PathMatchSingleMaskW(lpszPath
, lpszMask
))
1901 return TRUE
; /* Matches the current path */
1903 while (*lpszMask
&& *lpszMask
!= ';')
1906 if (*lpszMask
== ';')
1909 while (*lpszMask
== ' ')
1910 lpszMask
++; /* Masks may be separated by "; " */
1916 /*************************************************************************
1917 * PathIsSameRootA [SHLWAPI.@]
1919 * Determine if two paths share the same root.
1922 * lpszPath1 [I] Source path
1923 * lpszPath2 [I] Path to compare with
1926 * TRUE If both paths are valid and share the same root.
1927 * FALSE If either path is invalid or the paths do not share the same root.
1929 BOOL WINAPI
PathIsSameRootA(LPCSTR lpszPath1
, LPCSTR lpszPath2
)
1934 TRACE("(%s,%s)\n", debugstr_a(lpszPath1
), debugstr_a(lpszPath2
));
1936 if (!lpszPath1
|| !lpszPath2
|| !(lpszStart
= PathSkipRootA(lpszPath1
)))
1939 dwLen
= PathCommonPrefixA(lpszPath1
, lpszPath2
, NULL
) + 1;
1940 if (lpszStart
- lpszPath1
> dwLen
)
1941 return FALSE
; /* Paths not common up to length of the root */
1945 /*************************************************************************
1946 * PathIsSameRootW [SHLWAPI.@]
1948 * See PathIsSameRootA.
1950 BOOL WINAPI
PathIsSameRootW(LPCWSTR lpszPath1
, LPCWSTR lpszPath2
)
1955 TRACE("(%s,%s)\n", debugstr_w(lpszPath1
), debugstr_w(lpszPath2
));
1957 if (!lpszPath1
|| !lpszPath2
|| !(lpszStart
= PathSkipRootW(lpszPath1
)))
1960 dwLen
= PathCommonPrefixW(lpszPath1
, lpszPath2
, NULL
) + 1;
1961 if (lpszStart
- lpszPath1
> dwLen
)
1962 return FALSE
; /* Paths not common up to length of the root */
1966 /*************************************************************************
1967 * PathIsContentTypeA [SHLWAPI.@]
1969 * Determine if a file is of a given registered content type.
1972 * lpszPath [I] File to check
1973 * lpszContentType [I] Content type to check for
1976 * TRUE If lpszPath is a given registered content type,
1980 * This function looks up the registered content type for lpszPath. If
1981 * a content type is registered, it is compared (case insensitively) to
1982 * lpszContentType. Only if this matches does the function succeed.
1984 BOOL WINAPI
PathIsContentTypeA(LPCSTR lpszPath
, LPCSTR lpszContentType
)
1988 char szBuff
[MAX_PATH
];
1990 TRACE("(%s,%s)\n", debugstr_a(lpszPath
), debugstr_a(lpszContentType
));
1992 if (lpszPath
&& (szExt
= PathFindExtensionA(lpszPath
)) && *szExt
&&
1993 !SHGetValueA(HKEY_CLASSES_ROOT
, szExt
, "Content Type",
1994 REG_NONE
, szBuff
, &dwDummy
) &&
1995 !strcasecmp(lpszContentType
, szBuff
))
2002 /*************************************************************************
2003 * PathIsContentTypeW [SHLWAPI.@]
2005 * See PathIsContentTypeA.
2007 BOOL WINAPI
PathIsContentTypeW(LPCWSTR lpszPath
, LPCWSTR lpszContentType
)
2009 static const WCHAR szContentType
[] = { 'C','o','n','t','e','n','t',' ','T','y','p','e','\0' };
2012 WCHAR szBuff
[MAX_PATH
];
2014 TRACE("(%s,%s)\n", debugstr_w(lpszPath
), debugstr_w(lpszContentType
));
2016 if (lpszPath
&& (szExt
= PathFindExtensionW(lpszPath
)) && *szExt
&&
2017 !SHGetValueW(HKEY_CLASSES_ROOT
, szExt
, szContentType
,
2018 REG_NONE
, szBuff
, &dwDummy
) &&
2019 !strcmpiW(lpszContentType
, szBuff
))
2026 /*************************************************************************
2027 * PathIsFileSpecA [SHLWAPI.@]
2029 * Determine if a path is a file specification.
2032 * lpszPath [I] Path to chack
2035 * TRUE If lpszPath is a file specification (i.e. Contains no directories).
2038 BOOL WINAPI
PathIsFileSpecA(LPCSTR lpszPath
)
2040 TRACE("(%s)\n", debugstr_a(lpszPath
));
2047 if (*lpszPath
== '\\' || *lpszPath
== ':')
2049 lpszPath
= CharNextA(lpszPath
);
2054 /*************************************************************************
2055 * PathIsFileSpecW [SHLWAPI.@]
2057 * See PathIsFileSpecA.
2059 BOOL WINAPI
PathIsFileSpecW(LPCWSTR lpszPath
)
2061 TRACE("(%s)\n", debugstr_w(lpszPath
));
2068 if (*lpszPath
== '\\' || *lpszPath
== ':')
2070 lpszPath
= CharNextW(lpszPath
);
2075 /*************************************************************************
2076 * PathIsPrefixA [SHLWAPI.@]
2078 * Determine if a path is a prefix of another.
2081 * lpszPrefix [I] Prefix
2082 * lpszPath [I] Path to check
2085 * TRUE If lpszPath has lpszPrefix as its prefix,
2086 * FALSE If either path is NULL or lpszPrefix is not a prefix
2088 BOOL WINAPI
PathIsPrefixA (LPCSTR lpszPrefix
, LPCSTR lpszPath
)
2090 TRACE("(%s,%s)\n", debugstr_a(lpszPrefix
), debugstr_a(lpszPath
));
2092 if (lpszPrefix
&& lpszPath
&&
2093 PathCommonPrefixA(lpszPath
, lpszPrefix
, NULL
) == (int)strlen(lpszPrefix
))
2098 /*************************************************************************
2099 * PathIsPrefixW [SHLWAPI.@]
2101 * See PathIsPrefixA.
2103 BOOL WINAPI
PathIsPrefixW(LPCWSTR lpszPrefix
, LPCWSTR lpszPath
)
2105 TRACE("(%s,%s)\n", debugstr_w(lpszPrefix
), debugstr_w(lpszPath
));
2107 if (lpszPrefix
&& lpszPath
&&
2108 PathCommonPrefixW(lpszPath
, lpszPrefix
, NULL
) == (int)strlenW(lpszPrefix
))
2113 /*************************************************************************
2114 * PathIsSystemFolderA [SHLWAPI.@]
2116 * Determine if a path or file attributes are a system folder.
2119 * lpszPath [I] Path to check.
2120 * dwAttrib [I] Attributes to check, if lpszPath is NULL.
2123 * TRUE If lpszPath or dwAttrib are a system folder.
2124 * FALSE If GetFileAttributesA() fails or neither parameter is a system folder.
2126 BOOL WINAPI
PathIsSystemFolderA(LPCSTR lpszPath
, DWORD dwAttrib
)
2128 TRACE("(%s,0x%08lx)\n", debugstr_a(lpszPath
), dwAttrib
);
2130 if (lpszPath
&& *lpszPath
)
2131 dwAttrib
= GetFileAttributesA(lpszPath
);
2133 if (dwAttrib
== INVALID_FILE_ATTRIBUTES
|| !(dwAttrib
& FILE_ATTRIBUTE_DIRECTORY
) ||
2134 !(dwAttrib
& (FILE_ATTRIBUTE_SYSTEM
| FILE_ATTRIBUTE_READONLY
)))
2139 /*************************************************************************
2140 * PathIsSystemFolderW [SHLWAPI.@]
2142 * See PathIsSystemFolderA.
2144 BOOL WINAPI
PathIsSystemFolderW(LPCWSTR lpszPath
, DWORD dwAttrib
)
2146 TRACE("(%s,0x%08lx)\n", debugstr_w(lpszPath
), dwAttrib
);
2148 if (lpszPath
&& *lpszPath
)
2149 dwAttrib
= GetFileAttributesW(lpszPath
);
2151 if (dwAttrib
== INVALID_FILE_ATTRIBUTES
|| !(dwAttrib
& FILE_ATTRIBUTE_DIRECTORY
) ||
2152 !(dwAttrib
& (FILE_ATTRIBUTE_SYSTEM
| FILE_ATTRIBUTE_READONLY
)))
2157 /*************************************************************************
2158 * PathIsUNCA [SHLWAPI.@]
2160 * Determine if a path is in UNC format.
2163 * lpszPath [I] Path to check
2166 * TRUE: The path is UNC.
2167 * FALSE: The path is not UNC or is NULL.
2169 BOOL WINAPI
PathIsUNCA(LPCSTR lpszPath
)
2171 TRACE("(%s)\n",debugstr_a(lpszPath
));
2173 if (lpszPath
&& (lpszPath
[0]=='\\') && (lpszPath
[1]=='\\'))
2178 /*************************************************************************
2179 * PathIsUNCW [SHLWAPI.@]
2183 BOOL WINAPI
PathIsUNCW(LPCWSTR lpszPath
)
2185 TRACE("(%s)\n",debugstr_w(lpszPath
));
2187 if (lpszPath
&& (lpszPath
[0]=='\\') && (lpszPath
[1]=='\\'))
2192 /*************************************************************************
2193 * PathIsUNCServerA [SHLWAPI.@]
2195 * Determine if a path is a UNC server name ("\\SHARENAME").
2198 * lpszPath [I] Path to check.
2201 * TRUE If lpszPath is a valid UNC server name.
2205 * This routine is bug compatible with Win32: Server names with a
2206 * trailing backslash (e.g. "\\FOO\"), return FALSE incorrectly.
2207 * Fixing this bug may break other shlwapi functions!
2209 BOOL WINAPI
PathIsUNCServerA(LPCSTR lpszPath
)
2211 TRACE("(%s)\n", debugstr_a(lpszPath
));
2213 if (lpszPath
&& *lpszPath
++ == '\\' && *lpszPath
++ == '\\')
2217 if (*lpszPath
== '\\')
2219 lpszPath
= CharNextA(lpszPath
);
2226 /*************************************************************************
2227 * PathIsUNCServerW [SHLWAPI.@]
2229 * See PathIsUNCServerA.
2231 BOOL WINAPI
PathIsUNCServerW(LPCWSTR lpszPath
)
2233 TRACE("(%s)\n", debugstr_w(lpszPath
));
2235 if (lpszPath
&& *lpszPath
++ == '\\' && *lpszPath
++ == '\\')
2239 if (*lpszPath
== '\\')
2241 lpszPath
= CharNextW(lpszPath
);
2248 /*************************************************************************
2249 * PathIsUNCServerShareA [SHLWAPI.@]
2251 * Determine if a path is a UNC server share ("\\SHARENAME\SHARE").
2254 * lpszPath [I] Path to check.
2257 * TRUE If lpszPath is a valid UNC server share.
2261 * This routine is bug compatible with Win32: Server shares with a
2262 * trailing backslash (e.g. "\\FOO\BAR\"), return FALSE incorrectly.
2263 * Fixing this bug may break other shlwapi functions!
2265 BOOL WINAPI
PathIsUNCServerShareA(LPCSTR lpszPath
)
2267 TRACE("(%s)\n", debugstr_a(lpszPath
));
2269 if (lpszPath
&& *lpszPath
++ == '\\' && *lpszPath
++ == '\\')
2271 BOOL bSeenSlash
= FALSE
;
2274 if (*lpszPath
== '\\')
2280 lpszPath
= CharNextA(lpszPath
);
2287 /*************************************************************************
2288 * PathIsUNCServerShareW [SHLWAPI.@]
2290 * See PathIsUNCServerShareA.
2292 BOOL WINAPI
PathIsUNCServerShareW(LPCWSTR lpszPath
)
2294 TRACE("(%s)\n", debugstr_w(lpszPath
));
2296 if (lpszPath
&& *lpszPath
++ == '\\' && *lpszPath
++ == '\\')
2298 BOOL bSeenSlash
= FALSE
;
2301 if (*lpszPath
== '\\')
2307 lpszPath
= CharNextW(lpszPath
);
2314 /*************************************************************************
2315 * PathCanonicalizeA [SHLWAPI.@]
2317 * Convert a path to its canonical form.
2320 * lpszBuf [O] Output path
2321 * lpszPath [I] Path to cnonicalize
2324 * Success: TRUE. lpszBuf contains the output path,
2325 * Failure: FALSE, If input path is invalid. lpszBuf is undefined
2327 BOOL WINAPI
PathCanonicalizeA(LPSTR lpszBuf
, LPCSTR lpszPath
)
2331 TRACE("(%p,%s)\n", lpszBuf
, debugstr_a(lpszPath
));
2336 if (!lpszBuf
|| !lpszPath
)
2337 SetLastError(ERROR_INVALID_PARAMETER
);
2340 WCHAR szPath
[MAX_PATH
];
2341 WCHAR szBuff
[MAX_PATH
];
2342 MultiByteToWideChar(CP_ACP
,0,lpszPath
,-1,szPath
,MAX_PATH
);
2343 bRet
= PathCanonicalizeW(szBuff
, szPath
);
2344 WideCharToMultiByte(CP_ACP
,0,szBuff
,-1,lpszBuf
,MAX_PATH
,0,0);
2350 /*************************************************************************
2351 * PathCanonicalizeW [SHLWAPI.@]
2353 * See PathCanonicalizeA.
2355 BOOL WINAPI
PathCanonicalizeW(LPWSTR lpszBuf
, LPCWSTR lpszPath
)
2357 LPWSTR lpszDst
= lpszBuf
;
2358 LPCWSTR lpszSrc
= lpszPath
;
2360 TRACE("(%p,%s)\n", lpszBuf
, debugstr_w(lpszPath
));
2365 if (!lpszBuf
|| !lpszPath
)
2367 SetLastError(ERROR_INVALID_PARAMETER
);
2378 /* Copy path root */
2379 if (*lpszSrc
== '\\')
2381 *lpszDst
++ = *lpszSrc
++;
2383 else if (*lpszSrc
&& lpszSrc
[1] == ':')
2386 *lpszDst
++ = *lpszSrc
++;
2387 *lpszDst
++ = *lpszSrc
++;
2388 if (*lpszSrc
== '\\')
2389 *lpszDst
++ = *lpszSrc
++;
2392 /* Canonicalize the rest of the path */
2395 if (*lpszSrc
== '.')
2397 if (lpszSrc
[1] == '\\' && (lpszSrc
== lpszPath
|| lpszSrc
[-1] == '\\' || lpszSrc
[-1] == ':'))
2399 lpszSrc
+= 2; /* Skip .\ */
2401 else if (lpszSrc
[1] == '.' && (lpszDst
== lpszBuf
|| lpszDst
[-1] == '\\'))
2403 /* \.. backs up a directory, over the root if it has no \ following X:.
2404 * .. is ignored if it would remove a UNC server name or inital \\
2406 if (lpszDst
!= lpszBuf
)
2408 *lpszDst
= '\0'; /* Allow PathIsUNCServerShareA test on lpszBuf */
2409 if (lpszDst
> lpszBuf
+1 && lpszDst
[-1] == '\\' &&
2410 (lpszDst
[-2] != '\\' || lpszDst
> lpszBuf
+2))
2412 if (lpszDst
[-2] == ':' && (lpszDst
> lpszBuf
+3 || lpszDst
[-3] == ':'))
2415 while (lpszDst
> lpszBuf
&& *lpszDst
!= '\\')
2417 if (*lpszDst
== '\\')
2418 lpszDst
++; /* Reset to last '\' */
2420 lpszDst
= lpszBuf
; /* Start path again from new root */
2422 else if (lpszDst
[-2] != ':' && !PathIsUNCServerShareW(lpszBuf
))
2425 while (lpszDst
> lpszBuf
&& *lpszDst
!= '\\')
2427 if (lpszDst
== lpszBuf
)
2433 lpszSrc
+= 2; /* Skip .. in src path */
2436 *lpszDst
++ = *lpszSrc
++;
2439 *lpszDst
++ = *lpszSrc
++;
2441 /* Append \ to naked drive specs */
2442 if (lpszDst
- lpszBuf
== 2 && lpszDst
[-1] == ':')
2448 /*************************************************************************
2449 * PathFindNextComponentA [SHLWAPI.@]
2451 * Find the next component in a path.
2454 * lpszPath [I] Path to find next component in
2457 * Success: A pointer to the next component, or the end of the string.
2458 * Failure: NULL, If lpszPath is invalid
2461 * A 'component' is either a backslash character (\) or UNC marker (\\).
2462 * Because of this, relative paths (e.g "c:foo") are regarded as having
2463 * only one component.
2465 LPSTR WINAPI
PathFindNextComponentA(LPCSTR lpszPath
)
2469 TRACE("(%s)\n", debugstr_a(lpszPath
));
2471 if(!lpszPath
|| !*lpszPath
)
2474 if ((lpszSlash
= StrChrA(lpszPath
, '\\')))
2476 if (lpszSlash
[1] == '\\')
2478 return lpszSlash
+ 1;
2480 return (LPSTR
)lpszPath
+ strlen(lpszPath
);
2483 /*************************************************************************
2484 * PathFindNextComponentW [SHLWAPI.@]
2486 * See PathFindNextComponentA.
2488 LPWSTR WINAPI
PathFindNextComponentW(LPCWSTR lpszPath
)
2492 TRACE("(%s)\n", debugstr_w(lpszPath
));
2494 if(!lpszPath
|| !*lpszPath
)
2497 if ((lpszSlash
= StrChrW(lpszPath
, '\\')))
2499 if (lpszSlash
[1] == '\\')
2501 return lpszSlash
+ 1;
2503 return (LPWSTR
)lpszPath
+ strlenW(lpszPath
);
2506 /*************************************************************************
2507 * PathAddExtensionA [SHLWAPI.@]
2509 * Add a file extension to a path
2512 * lpszPath [I/O] Path to add extension to
2513 * lpszExtension [I] Extension to add to lpszPath
2516 * TRUE If the path was modified,
2517 * FALSE If lpszPath or lpszExtension are invalid, lpszPath has an
2518 * extension allready, or the new path length is too big.
2521 * What version of shlwapi.dll adds "exe" if lpszExtension is NULL? Win2k
2522 * does not do this, so the behaviour was removed.
2524 BOOL WINAPI
PathAddExtensionA(LPSTR lpszPath
, LPCSTR lpszExtension
)
2528 TRACE("(%s,%s)\n", debugstr_a(lpszPath
), debugstr_a(lpszExtension
));
2530 if (!lpszPath
|| !lpszExtension
|| *(PathFindExtensionA(lpszPath
)))
2533 dwLen
= strlen(lpszPath
);
2535 if (dwLen
+ strlen(lpszExtension
) >= MAX_PATH
)
2538 strcpy(lpszPath
+ dwLen
, lpszExtension
);
2542 /*************************************************************************
2543 * PathAddExtensionW [SHLWAPI.@]
2545 * See PathAddExtensionA.
2547 BOOL WINAPI
PathAddExtensionW(LPWSTR lpszPath
, LPCWSTR lpszExtension
)
2551 TRACE("(%s,%s)\n", debugstr_w(lpszPath
), debugstr_w(lpszExtension
));
2553 if (!lpszPath
|| !lpszExtension
|| *(PathFindExtensionW(lpszPath
)))
2556 dwLen
= strlenW(lpszPath
);
2558 if (dwLen
+ strlenW(lpszExtension
) >= MAX_PATH
)
2561 strcpyW(lpszPath
+ dwLen
, lpszExtension
);
2565 /*************************************************************************
2566 * PathMakePrettyA [SHLWAPI.@]
2568 * Convert an uppercase DOS filename into lowercase.
2571 * lpszPath [I/O] Path to convert.
2574 * TRUE If the path was an uppercase DOS path and was converted,
2577 BOOL WINAPI
PathMakePrettyA(LPSTR lpszPath
)
2579 LPSTR pszIter
= lpszPath
;
2581 TRACE("(%s)\n", debugstr_a(lpszPath
));
2583 if (!pszIter
|| !*pszIter
)
2588 if (islower(*pszIter
) || IsDBCSLeadByte(*pszIter
))
2589 return FALSE
; /* Not DOS path */
2592 pszIter
= lpszPath
+ 1;
2595 *pszIter
= tolower(*pszIter
);
2601 /*************************************************************************
2602 * PathMakePrettyW [SHLWAPI.@]
2604 * See PathMakePrettyA.
2606 BOOL WINAPI
PathMakePrettyW(LPWSTR lpszPath
)
2608 LPWSTR pszIter
= lpszPath
;
2610 TRACE("(%s)\n", debugstr_w(lpszPath
));
2612 if (!pszIter
|| !*pszIter
)
2617 if (islowerW(*pszIter
))
2618 return FALSE
; /* Not DOS path */
2621 pszIter
= lpszPath
+ 1;
2624 *pszIter
= tolowerW(*pszIter
);
2630 /*************************************************************************
2631 * PathCommonPrefixA [SHLWAPI.@]
2633 * Determine the length of the common prefix between two paths.
2636 * lpszFile1 [I] First path for comparison
2637 * lpszFile2 [I] Second path for comparison
2638 * achPath [O] Destination for common prefix string
2641 * The length of the common prefix. This is 0 if there is no common
2642 * prefix between the paths or if any parameters are invalid. If the prefix
2643 * is non-zero and achPath is not NULL, achPath is filled with the common
2644 * part of the prefix and NUL terminated.
2647 * A common prefix of 2 is always returned as 3. It is thus possible for
2648 * the length returned to be invalid (i.e. Longer than one or both of the
2649 * strings given as parameters). This Win32 behaviour has been implemented
2650 * here, and cannot be changed (fixed?) without breaking other SHLWAPI calls.
2651 * To work around this when using this function, always check that the byte
2652 * at [common_prefix_len-1] is not a NUL. If it is, deduct 1 from the prefix.
2654 int WINAPI
PathCommonPrefixA(LPCSTR lpszFile1
, LPCSTR lpszFile2
, LPSTR achPath
)
2657 LPCSTR lpszIter1
= lpszFile1
;
2658 LPCSTR lpszIter2
= lpszFile2
;
2660 TRACE("(%s,%s,%p)\n", debugstr_a(lpszFile1
), debugstr_a(lpszFile2
), achPath
);
2665 if (!lpszFile1
|| !lpszFile2
)
2668 /* Handle roots first */
2669 if (PathIsUNCA(lpszFile1
))
2671 if (!PathIsUNCA(lpszFile2
))
2676 else if (PathIsUNCA(lpszFile2
))
2677 return 0; /* Know already lpszFile1 is not UNC */
2682 if ((!*lpszIter1
|| *lpszIter1
== '\\') &&
2683 (!*lpszIter2
|| *lpszIter2
== '\\'))
2684 iLen
= lpszIter1
- lpszFile1
; /* Common to this point */
2686 if (!*lpszIter1
|| (tolower(*lpszIter1
) != tolower(*lpszIter2
)))
2687 break; /* Strings differ at this point */
2694 iLen
++; /* Feature/Bug compatible with Win32 */
2696 if (iLen
&& achPath
)
2698 memcpy(achPath
,lpszFile1
,iLen
);
2699 achPath
[iLen
] = '\0';
2704 /*************************************************************************
2705 * PathCommonPrefixW [SHLWAPI.@]
2707 * See PathCommonPrefixA.
2709 int WINAPI
PathCommonPrefixW(LPCWSTR lpszFile1
, LPCWSTR lpszFile2
, LPWSTR achPath
)
2712 LPCWSTR lpszIter1
= lpszFile1
;
2713 LPCWSTR lpszIter2
= lpszFile2
;
2715 TRACE("(%s,%s,%p)\n", debugstr_w(lpszFile1
), debugstr_w(lpszFile2
), achPath
);
2720 if (!lpszFile1
|| !lpszFile2
)
2723 /* Handle roots first */
2724 if (PathIsUNCW(lpszFile1
))
2726 if (!PathIsUNCW(lpszFile2
))
2731 else if (PathIsUNCW(lpszFile2
))
2732 return 0; /* Know already lpszFile1 is not UNC */
2737 if ((!*lpszIter1
|| *lpszIter1
== '\\') &&
2738 (!*lpszIter2
|| *lpszIter2
== '\\'))
2739 iLen
= lpszIter1
- lpszFile1
; /* Common to this point */
2741 if (!*lpszIter1
|| (tolowerW(*lpszIter1
) != tolowerW(*lpszIter2
)))
2742 break; /* Strings differ at this point */
2749 iLen
++; /* Feature/Bug compatible with Win32 */
2751 if (iLen
&& achPath
)
2753 memcpy(achPath
,lpszFile1
,iLen
* sizeof(WCHAR
));
2754 achPath
[iLen
] = '\0';
2759 /*************************************************************************
2760 * PathCompactPathA [SHLWAPI.@]
2762 * Make a path fit into a given width when printed to a DC.
2765 * hDc [I] Destination DC
2766 * lpszPath [I/O] Path to be printed to hDc
2767 * dx [I] Desired width
2770 * TRUE If the path was modified.
2773 BOOL WINAPI
PathCompactPathA(HDC hDC
, LPSTR lpszPath
, UINT dx
)
2777 TRACE("(%p,%s,%d)\n", hDC
, debugstr_a(lpszPath
), dx
);
2781 WCHAR szPath
[MAX_PATH
];
2782 MultiByteToWideChar(CP_ACP
,0,lpszPath
,-1,szPath
,MAX_PATH
);
2783 bRet
= PathCompactPathW(hDC
, szPath
, dx
);
2784 WideCharToMultiByte(CP_ACP
,0,szPath
,-1,lpszPath
,MAX_PATH
,0,0);
2789 /*************************************************************************
2790 * PathCompactPathW [SHLWAPI.@]
2792 * See PathCompactPathA.
2794 BOOL WINAPI
PathCompactPathW(HDC hDC
, LPWSTR lpszPath
, UINT dx
)
2796 static const WCHAR szEllipses
[] = { '.', '.', '.', '\0' };
2799 WCHAR buff
[MAX_PATH
];
2803 TRACE("(%p,%s,%d)\n", hDC
, debugstr_w(lpszPath
), dx
);
2809 hdc
= hDC
= GetDC(0);
2811 /* Get the length of the whole path */
2812 dwLen
= strlenW(lpszPath
);
2813 GetTextExtentPointW(hDC
, lpszPath
, dwLen
, &size
);
2815 if ((UINT
)size
.cx
> dx
)
2817 /* Path too big, must reduce it */
2819 DWORD dwEllipsesLen
= 0, dwPathLen
= 0;
2821 sFile
= PathFindFileNameW(lpszPath
);
2822 if (sFile
!= lpszPath
)
2823 sFile
= CharPrevW(lpszPath
, sFile
);
2825 /* Get the size of ellipses */
2826 GetTextExtentPointW(hDC
, szEllipses
, 3, &size
);
2827 dwEllipsesLen
= size
.cx
;
2828 /* Get the size of the file name */
2829 GetTextExtentPointW(hDC
, sFile
, strlenW(sFile
), &size
);
2830 dwPathLen
= size
.cx
;
2832 if (sFile
!= lpszPath
)
2834 LPWSTR sPath
= sFile
;
2835 BOOL bEllipses
= FALSE
;
2837 /* The path includes a file name. Include as much of the path prior to
2838 * the file name as possible, allowing for the ellipses, e.g:
2839 * c:\some very long path\filename ==> c:\some v...\filename
2841 strncpyW(buff
, sFile
, MAX_PATH
);
2845 DWORD dwTotalLen
= bEllipses
? dwPathLen
+ dwEllipsesLen
: dwPathLen
;
2847 GetTextExtentPointW(hDC
, lpszPath
, sPath
- lpszPath
, &size
);
2848 dwTotalLen
+= size
.cx
;
2849 if (dwTotalLen
<= dx
)
2851 sPath
= CharPrevW(lpszPath
, sPath
);
2855 sPath
= CharPrevW(lpszPath
, sPath
);
2856 sPath
= CharPrevW(lpszPath
, sPath
);
2858 } while (sPath
> lpszPath
);
2860 if (sPath
> lpszPath
)
2864 strcpyW(sPath
, szEllipses
);
2865 strcpyW(sPath
+3, buff
);
2870 strcpyW(lpszPath
, szEllipses
);
2871 strcpyW(lpszPath
+3, buff
);
2876 /* Trim the path by adding ellipses to the end, e.g:
2877 * A very long file name.txt ==> A very...
2879 dwLen
= strlenW(lpszPath
);
2881 if (dwLen
> MAX_PATH
- 3)
2882 dwLen
= MAX_PATH
- 3;
2883 strncpyW(buff
, sFile
, dwLen
);
2887 GetTextExtentPointW(hDC
, buff
, dwLen
, &size
);
2888 } while (dwLen
&& size
.cx
+ dwEllipsesLen
> dx
);
2892 DWORD dwWritten
= 0;
2894 dwEllipsesLen
/= 3; /* Size of a single '.' */
2896 /* Write as much of the Ellipses string as possible */
2897 while (dwWritten
+ dwEllipsesLen
< dx
&& dwLen
< 3)
2900 dwWritten
+= dwEllipsesLen
;
2908 strcpyW(buff
+ dwLen
, szEllipses
);
2909 strcpyW(lpszPath
, buff
);
2920 /*************************************************************************
2921 * PathGetCharTypeA [SHLWAPI.@]
2923 * Categorise a character from a file path.
2926 * ch [I] Character to get the type of
2929 * A set of GCT_ bit flags (from "shlwapi.h") indicating the character type.
2931 UINT WINAPI
PathGetCharTypeA(UCHAR ch
)
2933 return PathGetCharTypeW(ch
);
2936 /*************************************************************************
2937 * PathGetCharTypeW [SHLWAPI.@]
2939 * See PathGetCharTypeA.
2941 UINT WINAPI
PathGetCharTypeW(WCHAR ch
)
2945 TRACE("(%d)\n", ch
);
2947 if (!ch
|| ch
< ' ' || ch
== '<' || ch
== '>' ||
2948 ch
== '"' || ch
== '|' || ch
== '/')
2949 flags
= GCT_INVALID
; /* Invalid */
2950 else if (ch
== '*' || ch
=='?')
2951 flags
= GCT_WILD
; /* Wildchars */
2952 else if ((ch
== '\\') || (ch
== ':'))
2953 return GCT_SEPARATOR
; /* Path separators */
2958 if ((ch
& 0x1 && ch
!= ';') || !ch
|| isalnum(ch
) || ch
== '$' || ch
== '&' || ch
== '(' ||
2959 ch
== '.' || ch
== '@' || ch
== '^' ||
2960 ch
== '\'' || ch
== 130 || ch
== '`')
2961 flags
|= GCT_SHORTCHAR
; /* All these are valid for DOS */
2964 flags
|= GCT_SHORTCHAR
; /* Bug compatible with win32 */
2965 flags
|= GCT_LFNCHAR
; /* Valid for long file names */
2970 /*************************************************************************
2971 * SHLWAPI_UseSystemForSystemFolders
2973 * Internal helper for PathMakeSystemFolderW.
2975 static BOOL WINAPI
SHLWAPI_UseSystemForSystemFolders()
2977 static BOOL bCheckedReg
= FALSE
;
2978 static BOOL bUseSystemForSystemFolders
= FALSE
;
2984 /* Key tells Win what file attributes to use on system folders */
2985 if (SHGetValueA(HKEY_LOCAL_MACHINE
,
2986 "Software\\Microsoft\\Windows\\CurrentVersion\\Explorer",
2987 "UseSystemForSystemFolders", 0, 0, 0))
2988 bUseSystemForSystemFolders
= TRUE
;
2990 return bUseSystemForSystemFolders
;
2993 /*************************************************************************
2994 * PathMakeSystemFolderA [SHLWAPI.@]
2996 * Set system folder attribute for a path.
2999 * lpszPath [I] The path to turn into a system folder
3002 * TRUE If the path was changed to/already was a system folder
3003 * FALSE If the path is invalid or SetFileAttributesA() fails
3005 BOOL WINAPI
PathMakeSystemFolderA(LPCSTR lpszPath
)
3009 TRACE("(%s)\n", debugstr_a(lpszPath
));
3011 if (lpszPath
&& *lpszPath
)
3013 WCHAR szPath
[MAX_PATH
];
3014 MultiByteToWideChar(CP_ACP
,0,lpszPath
,-1,szPath
,MAX_PATH
);
3015 bRet
= PathMakeSystemFolderW(szPath
);
3020 /*************************************************************************
3021 * PathMakeSystemFolderW [SHLWAPI.@]
3023 * See PathMakeSystemFolderA.
3025 BOOL WINAPI
PathMakeSystemFolderW(LPCWSTR lpszPath
)
3027 DWORD dwDefaultAttr
= FILE_ATTRIBUTE_READONLY
, dwAttr
;
3028 WCHAR buff
[MAX_PATH
];
3030 TRACE("(%s)\n", debugstr_w(lpszPath
));
3032 if (!lpszPath
|| !*lpszPath
)
3035 /* If the directory is already a system directory, don't do anything */
3036 GetSystemDirectoryW(buff
, MAX_PATH
);
3037 if (!strcmpW(buff
, lpszPath
))
3040 GetWindowsDirectoryW(buff
, MAX_PATH
);
3041 if (!strcmpW(buff
, lpszPath
))
3044 /* "UseSystemForSystemFolders" Tells Win what attributes to use */
3045 if (SHLWAPI_UseSystemForSystemFolders())
3046 dwDefaultAttr
= FILE_ATTRIBUTE_SYSTEM
;
3048 if ((dwAttr
= GetFileAttributesW(lpszPath
)) == INVALID_FILE_ATTRIBUTES
)
3051 /* Change file attributes to system attributes */
3052 dwAttr
&= ~(FILE_ATTRIBUTE_SYSTEM
|FILE_ATTRIBUTE_HIDDEN
|FILE_ATTRIBUTE_READONLY
);
3053 return SetFileAttributesW(lpszPath
, dwAttr
| dwDefaultAttr
);
3056 /*************************************************************************
3057 * PathRenameExtensionA [SHLWAPI.@]
3059 * Swap the file extension in a path with another extension.
3062 * lpszPath [I/O] Path to swap the extension in
3063 * lpszExt [I] The new extension
3066 * TRUE if lpszPath was modified,
3067 * FALSE if lpszPath or lpszExt is NULL, or the new path is too long
3069 BOOL WINAPI
PathRenameExtensionA(LPSTR lpszPath
, LPCSTR lpszExt
)
3071 LPSTR lpszExtension
;
3073 TRACE("(%s,%s)\n", debugstr_a(lpszPath
), debugstr_a(lpszExt
));
3075 lpszExtension
= PathFindExtensionA(lpszPath
);
3077 if (!lpszExtension
|| (lpszExtension
- lpszPath
+ strlen(lpszExt
) >= MAX_PATH
))
3080 strcpy(lpszExtension
, lpszExt
);
3084 /*************************************************************************
3085 * PathRenameExtensionW [SHLWAPI.@]
3087 * See PathRenameExtensionA.
3089 BOOL WINAPI
PathRenameExtensionW(LPWSTR lpszPath
, LPCWSTR lpszExt
)
3091 LPWSTR lpszExtension
;
3093 TRACE("(%s,%s)\n", debugstr_w(lpszPath
), debugstr_w(lpszExt
));
3095 lpszExtension
= PathFindExtensionW(lpszPath
);
3097 if (!lpszExtension
|| (lpszExtension
- lpszPath
+ strlenW(lpszExt
) >= MAX_PATH
))
3100 strcpyW(lpszExtension
, lpszExt
);
3104 /*************************************************************************
3105 * PathSearchAndQualifyA [SHLWAPI.@]
3107 * Determine if a given path is correct and fully qualified.
3110 * lpszPath [I] Path to check
3111 * lpszBuf [O] Output for correct path
3112 * cchBuf [I] Size of lpszBuf
3117 BOOL WINAPI
PathSearchAndQualifyA(LPCSTR lpszPath
, LPSTR lpszBuf
, UINT cchBuf
)
3119 FIXME("(%s,%p,0x%08x)-stub\n", debugstr_a(lpszPath
), lpszBuf
, cchBuf
);
3123 /*************************************************************************
3124 * PathSearchAndQualifyW [SHLWAPI.@]
3126 * See PathSearchAndQualifyA.
3128 BOOL WINAPI
PathSearchAndQualifyW(LPCWSTR lpszPath
, LPWSTR lpszBuf
, UINT cchBuf
)
3130 FIXME("(%s,%p,0x%08x)-stub\n", debugstr_w(lpszPath
), lpszBuf
, cchBuf
);
3134 /*************************************************************************
3135 * PathSkipRootA [SHLWAPI.@]
3137 * Return the portion of a path following the drive letter or mount point.
3140 * lpszPath [I] The path to skip on
3143 * Success: A pointer to the next character after the root.
3144 * Failure: NULL, if lpszPath is invalid, has no root or is a multibyte string.
3146 LPSTR WINAPI
PathSkipRootA(LPCSTR lpszPath
)
3148 TRACE("(%s)\n", debugstr_a(lpszPath
));
3150 if (!lpszPath
|| !*lpszPath
)
3153 if (*lpszPath
== '\\' && lpszPath
[1] == '\\')
3155 /* Network share: skip share server and mount point */
3157 if ((lpszPath
= StrChrA(lpszPath
, '\\')) &&
3158 (lpszPath
= StrChrA(lpszPath
+ 1, '\\')))
3160 return (LPSTR
)lpszPath
;
3163 if (IsDBCSLeadByte(*lpszPath
))
3167 if (lpszPath
[0] && lpszPath
[1] == ':' && lpszPath
[2] == '\\')
3168 return (LPSTR
)lpszPath
+ 3;
3172 /*************************************************************************
3173 * PathSkipRootW [SHLWAPI.@]
3175 * See PathSkipRootA.
3177 LPWSTR WINAPI
PathSkipRootW(LPCWSTR lpszPath
)
3179 TRACE("(%s)\n", debugstr_w(lpszPath
));
3181 if (!lpszPath
|| !*lpszPath
)
3184 if (*lpszPath
== '\\' && lpszPath
[1] == '\\')
3186 /* Network share: skip share server and mount point */
3188 if ((lpszPath
= StrChrW(lpszPath
, '\\')) &&
3189 (lpszPath
= StrChrW(lpszPath
+ 1, '\\')))
3191 return (LPWSTR
)lpszPath
;
3195 if (lpszPath
[0] && lpszPath
[1] == ':' && lpszPath
[2] == '\\')
3196 return (LPWSTR
)lpszPath
+ 3;
3200 /*************************************************************************
3201 * PathCreateFromUrlA [SHLWAPI.@]
3203 * Create a path from a URL
3206 * lpszUrl [I] URL to convert into a path
3207 * lpszPath [O] Output buffer for the resulting Path
3208 * pcchPath [I] Length of lpszPath
3209 * dwFlags [I] Flags controlling the conversion
3212 * Success: S_OK. lpszPath contains the URL in path format,
3213 * Failure: An HRESULT error code such as E_INVALIDARG.
3215 HRESULT WINAPI
PathCreateFromUrlA(LPCSTR lpszUrl
, LPSTR lpszPath
,
3216 LPDWORD pcchPath
, DWORD dwFlags
)
3219 TRACE("(%s,%p,%p,0x%08lx)\n", debugstr_a(lpszUrl
), lpszPath
, pcchPath
, dwFlags
);
3221 if (!lpszUrl
|| !lpszPath
|| !pcchPath
|| !*pcchPath
)
3222 return E_INVALIDARG
;
3224 pszPathPart
= StrChrA(lpszUrl
, ':');
3225 if ((((pszPathPart
- lpszUrl
) == 1) && isalpha(*lpszUrl
)) ||
3226 !lstrcmpA(lpszUrl
, "file:"))
3228 return UrlUnescapeA(pszPathPart
, lpszPath
, pcchPath
, dwFlags
);
3230 /* extracts thing prior to : in pszURL and checks against:
3234 * about - if match returns E_INVALIDARG
3237 return E_INVALIDARG
;
3240 /*************************************************************************
3241 * PathCreateFromUrlW [SHLWAPI.@]
3243 * See PathCreateFromUrlA.
3245 HRESULT WINAPI
PathCreateFromUrlW(LPCWSTR lpszUrl
, LPWSTR lpszPath
,
3246 LPDWORD pcchPath
, DWORD dwFlags
)
3248 static const WCHAR stemp
[] = { 'f','i','l','e',':','/','/','/',0 };
3249 LPWSTR pwszPathPart
;
3252 TRACE("(%s,%p,%p,0x%08lx)\n", debugstr_w(lpszUrl
), lpszPath
, pcchPath
, dwFlags
);
3254 if (!lpszUrl
|| !lpszPath
|| !pcchPath
|| !*pcchPath
)
3255 return E_INVALIDARG
;
3257 /* Path of the form file:///... */
3258 if (!strncmpW(lpszUrl
, stemp
, 8))
3262 /* Path of the form file://... */
3263 else if (!strncmpW(lpszUrl
, stemp
, 7))
3267 /* Path of the form file:... */
3268 else if (!strncmpW(lpszUrl
, stemp
, 5))
3273 /* Ensure that path is of the form c:... or c|... */
3274 if (lpszUrl
[1] != ':' && lpszUrl
[1] != '|' && isalphaW(*lpszUrl
))
3275 return E_INVALIDARG
;
3277 hr
= UrlUnescapeW((LPWSTR
) lpszUrl
, lpszPath
, pcchPath
, dwFlags
);
3278 if (lpszPath
[1] == '|')
3281 for (pwszPathPart
= lpszPath
; *pwszPathPart
; pwszPathPart
++)
3282 if (*pwszPathPart
== '/')
3283 *pwszPathPart
= '\\';
3285 TRACE("Returning %s\n",debugstr_w(lpszPath
));
3290 /*************************************************************************
3291 * PathRelativePathToA [SHLWAPI.@]
3293 * Create a relative path from one path to another.
3296 * lpszPath [O] Destination for relative path
3297 * lpszFrom [I] Source path
3298 * dwAttrFrom [I] File attribute of source path
3299 * lpszTo [I] Destination path
3300 * dwAttrTo [I] File attributes of destination path
3303 * TRUE If a relative path can be formed. lpszPath contains the new path
3304 * FALSE If the paths are not relavtive or any parameters are invalid
3307 * lpszTo should be at least MAX_PATH in length.
3309 * Calling this function with relative paths for lpszFrom or lpszTo may
3310 * give erroneous results.
3312 * The Win32 version of this function contains a bug where the lpszTo string
3313 * may be referenced 1 byte beyond the end of the string. As a result random
3314 * garbage may be written to the output path, depending on what lies beyond
3315 * the last byte of the string. This bug occurs because of the behaviour of
3316 * PathCommonPrefix() (see notes for that function), and no workaround seems
3317 * possible with Win32.
3319 * This bug has been fixed here, so for example the relative path from "\\"
3320 * to "\\" is correctly determined as "." in this implementation.
3322 BOOL WINAPI
PathRelativePathToA(LPSTR lpszPath
, LPCSTR lpszFrom
, DWORD dwAttrFrom
,
3323 LPCSTR lpszTo
, DWORD dwAttrTo
)
3327 TRACE("(%p,%s,0x%08lx,%s,0x%08lx)\n", lpszPath
, debugstr_a(lpszFrom
),
3328 dwAttrFrom
, debugstr_a(lpszTo
), dwAttrTo
);
3330 if(lpszPath
&& lpszFrom
&& lpszTo
)
3332 WCHAR szPath
[MAX_PATH
];
3333 WCHAR szFrom
[MAX_PATH
];
3334 WCHAR szTo
[MAX_PATH
];
3335 MultiByteToWideChar(CP_ACP
,0,lpszFrom
,-1,szFrom
,MAX_PATH
);
3336 MultiByteToWideChar(CP_ACP
,0,lpszTo
,-1,szTo
,MAX_PATH
);
3337 bRet
= PathRelativePathToW(szPath
,szFrom
,dwAttrFrom
,szTo
,dwAttrTo
);
3338 WideCharToMultiByte(CP_ACP
,0,szPath
,-1,lpszPath
,MAX_PATH
,0,0);
3343 /*************************************************************************
3344 * PathRelativePathToW [SHLWAPI.@]
3346 * See PathRelativePathToA.
3348 BOOL WINAPI
PathRelativePathToW(LPWSTR lpszPath
, LPCWSTR lpszFrom
, DWORD dwAttrFrom
,
3349 LPCWSTR lpszTo
, DWORD dwAttrTo
)
3351 static const WCHAR szPrevDirSlash
[] = { '.', '.', '\\', '\0' };
3352 static const WCHAR szPrevDir
[] = { '.', '.', '\0' };
3353 WCHAR szFrom
[MAX_PATH
];
3354 WCHAR szTo
[MAX_PATH
];
3357 TRACE("(%p,%s,0x%08lx,%s,0x%08lx)\n", lpszPath
, debugstr_w(lpszFrom
),
3358 dwAttrFrom
, debugstr_w(lpszTo
), dwAttrTo
);
3360 if(!lpszPath
|| !lpszFrom
|| !lpszTo
)
3364 strncpyW(szFrom
, lpszFrom
, MAX_PATH
);
3365 strncpyW(szTo
, lpszTo
, MAX_PATH
);
3367 if(!(dwAttrFrom
& FILE_ATTRIBUTE_DIRECTORY
))
3368 PathRemoveFileSpecW(szFrom
);
3369 if(!(dwAttrFrom
& FILE_ATTRIBUTE_DIRECTORY
))
3370 PathRemoveFileSpecW(szTo
);
3372 /* Paths can only be relative if they have a common root */
3373 if(!(dwLen
= PathCommonPrefixW(szFrom
, szTo
, 0)))
3376 /* Strip off lpszFrom components to the root, by adding "..\" */
3377 lpszFrom
= szFrom
+ dwLen
;
3383 if (*lpszFrom
== '\\')
3388 lpszFrom
= PathFindNextComponentW(lpszFrom
);
3389 strcatW(lpszPath
, *lpszFrom
? szPrevDirSlash
: szPrevDir
);
3392 /* From the root add the components of lpszTo */
3394 /* We check lpszTo[-1] to avoid skipping end of string. See the notes for
3397 if (*lpszTo
&& lpszTo
[-1])
3399 if (*lpszTo
!= '\\')
3401 dwLen
= strlenW(lpszPath
);
3402 if (dwLen
+ strlenW(lpszTo
) >= MAX_PATH
)
3407 strcpyW(lpszPath
+ dwLen
, lpszTo
);
3412 /*************************************************************************
3413 * PathUnmakeSystemFolderA [SHLWAPI.@]
3415 * Remove the system folder attributes from a path.
3418 * lpszPath [I] The path to remove attributes from
3422 * Failure: FALSE, if lpszPath is NULL, empty, not a directory, or calling
3423 * SetFileAttributesA() fails.
3425 BOOL WINAPI
PathUnmakeSystemFolderA(LPCSTR lpszPath
)
3429 TRACE("(%s)\n", debugstr_a(lpszPath
));
3431 if (!lpszPath
|| !*lpszPath
|| (dwAttr
= GetFileAttributesA(lpszPath
)) == INVALID_FILE_ATTRIBUTES
||
3432 !(dwAttr
& FILE_ATTRIBUTE_DIRECTORY
))
3435 dwAttr
&= ~(FILE_ATTRIBUTE_HIDDEN
| FILE_ATTRIBUTE_SYSTEM
);
3436 return SetFileAttributesA(lpszPath
, dwAttr
);
3439 /*************************************************************************
3440 * PathUnmakeSystemFolderW [SHLWAPI.@]
3442 * See PathUnmakeSystemFolderA.
3444 BOOL WINAPI
PathUnmakeSystemFolderW(LPCWSTR lpszPath
)
3448 TRACE("(%s)\n", debugstr_w(lpszPath
));
3450 if (!lpszPath
|| !*lpszPath
|| (dwAttr
= GetFileAttributesW(lpszPath
)) == INVALID_FILE_ATTRIBUTES
||
3451 !(dwAttr
& FILE_ATTRIBUTE_DIRECTORY
))
3454 dwAttr
&= ~(FILE_ATTRIBUTE_HIDDEN
| FILE_ATTRIBUTE_SYSTEM
);
3455 return SetFileAttributesW(lpszPath
, dwAttr
);
3459 /*************************************************************************
3460 * PathSetDlgItemPathA [SHLWAPI.@]
3462 * Set the text of a dialog item to a path, shrinking the path to fit
3463 * if it is too big for the item.
3466 * hDlg [I] Dialog handle
3467 * id [I] ID of item in the dialog
3468 * lpszPath [I] Path to set as the items text
3474 * If lpszPath is NULL, a blank string ("") is set (i.e. The previous
3475 * window text is erased).
3477 VOID WINAPI
PathSetDlgItemPathA(HWND hDlg
, int id
, LPCSTR lpszPath
)
3479 WCHAR szPath
[MAX_PATH
];
3481 TRACE("(%p,%8x,%s)\n",hDlg
, id
, debugstr_a(lpszPath
));
3484 MultiByteToWideChar(CP_ACP
,0,lpszPath
,-1,szPath
,MAX_PATH
);
3487 PathSetDlgItemPathW(hDlg
, id
, szPath
);
3490 /*************************************************************************
3491 * PathSetDlgItemPathW [SHLWAPI.@]
3493 * See PathSetDlgItemPathA.
3495 VOID WINAPI
PathSetDlgItemPathW(HWND hDlg
, int id
, LPCWSTR lpszPath
)
3497 WCHAR path
[MAX_PATH
+ 1];
3503 TRACE("(%p,%8x,%s)\n",hDlg
, id
, debugstr_w(lpszPath
));
3505 if (!(hwItem
= GetDlgItem(hDlg
, id
)))
3509 lstrcpynW(path
, lpszPath
, sizeof(path
) / sizeof(WCHAR
));
3513 GetClientRect(hwItem
, &rect
);
3515 hPrevObj
= SelectObject(hdc
, (HGDIOBJ
)SendMessageW(hwItem
,WM_GETFONT
,0,0));
3519 PathCompactPathW(hdc
, path
, rect
.right
);
3520 SelectObject(hdc
, hPrevObj
);
3523 ReleaseDC(hDlg
, hdc
);
3524 SetWindowTextW(hwItem
, path
);
3527 /*************************************************************************
3528 * PathIsNetworkPathA [SHLWAPI.@]
3530 * Determine if the given path is a network path.
3533 * lpszPath [I] Path to check
3536 * TRUE If lpszPath is a UNC share or mapped network drive, or
3537 * FALSE If lpszPath is a local drive or cannot be determined
3539 BOOL WINAPI
PathIsNetworkPathA(LPCSTR lpszPath
)
3543 TRACE("(%s)\n",debugstr_a(lpszPath
));
3547 if (*lpszPath
== '\\' && lpszPath
[1] == '\\')
3549 dwDriveNum
= PathGetDriveNumberA(lpszPath
);
3550 if (dwDriveNum
== -1)
3552 GET_FUNC(pIsNetDrive
, shell32
, (LPCSTR
)66, FALSE
); /* ord 66 = shell32.IsNetDrive */
3553 return pIsNetDrive(dwDriveNum
);
3556 /*************************************************************************
3557 * PathIsNetworkPathW [SHLWAPI.@]
3559 * See PathIsNetworkPathA.
3561 BOOL WINAPI
PathIsNetworkPathW(LPCWSTR lpszPath
)
3565 TRACE("(%s)\n", debugstr_w(lpszPath
));
3569 if (*lpszPath
== '\\' && lpszPath
[1] == '\\')
3571 dwDriveNum
= PathGetDriveNumberW(lpszPath
);
3572 if (dwDriveNum
== -1)
3574 GET_FUNC(pIsNetDrive
, shell32
, (LPCSTR
)66, FALSE
); /* ord 66 = shell32.IsNetDrive */
3575 return pIsNetDrive(dwDriveNum
);
3578 /*************************************************************************
3579 * PathIsLFNFileSpecA [SHLWAPI.@]
3581 * Determine if the given path is a long file name
3584 * lpszPath [I] Path to check
3587 * TRUE If path is a long file name,
3588 * FALSE If path is a valid DOS short file name
3590 BOOL WINAPI
PathIsLFNFileSpecA(LPCSTR lpszPath
)
3592 DWORD dwNameLen
= 0, dwExtLen
= 0;
3594 TRACE("(%s)\n",debugstr_a(lpszPath
));
3601 if (*lpszPath
== ' ')
3602 return TRUE
; /* DOS names cannot have spaces */
3603 if (*lpszPath
== '.')
3606 return TRUE
; /* DOS names have only one dot */
3613 return TRUE
; /* DOS extensions are <= 3 chars*/
3619 return TRUE
; /* DOS names are <= 8 chars */
3621 lpszPath
+= IsDBCSLeadByte(*lpszPath
) ? 2 : 1;
3623 return FALSE
; /* Valid DOS path */
3626 /*************************************************************************
3627 * PathIsLFNFileSpecW [SHLWAPI.@]
3629 * See PathIsLFNFileSpecA.
3631 BOOL WINAPI
PathIsLFNFileSpecW(LPCWSTR lpszPath
)
3633 DWORD dwNameLen
= 0, dwExtLen
= 0;
3635 TRACE("(%s)\n",debugstr_w(lpszPath
));
3642 if (*lpszPath
== ' ')
3643 return TRUE
; /* DOS names cannot have spaces */
3644 if (*lpszPath
== '.')
3647 return TRUE
; /* DOS names have only one dot */
3654 return TRUE
; /* DOS extensions are <= 3 chars*/
3660 return TRUE
; /* DOS names are <= 8 chars */
3664 return FALSE
; /* Valid DOS path */
3667 /*************************************************************************
3668 * PathIsDirectoryEmptyA [SHLWAPI.@]
3670 * Determine if a given directory is empty.
3673 * lpszPath [I] Directory to check
3676 * TRUE If the directory exists and contains no files,
3679 BOOL WINAPI
PathIsDirectoryEmptyA(LPCSTR lpszPath
)
3683 TRACE("(%s)\n",debugstr_a(lpszPath
));
3687 WCHAR szPath
[MAX_PATH
];
3688 MultiByteToWideChar(CP_ACP
,0,lpszPath
,-1,szPath
,MAX_PATH
);
3689 bRet
= PathIsDirectoryEmptyW(szPath
);
3694 /*************************************************************************
3695 * PathIsDirectoryEmptyW [SHLWAPI.@]
3697 * See PathIsDirectoryEmptyA.
3699 BOOL WINAPI
PathIsDirectoryEmptyW(LPCWSTR lpszPath
)
3701 static const WCHAR szAllFiles
[] = { '*', '.', '*', '\0' };
3702 WCHAR szSearch
[MAX_PATH
];
3705 BOOL retVal
= FALSE
;
3706 WIN32_FIND_DATAW find_data
;
3708 TRACE("(%s)\n",debugstr_w(lpszPath
));
3710 if (!lpszPath
|| !PathIsDirectoryW(lpszPath
))
3713 strncpyW(szSearch
, lpszPath
, MAX_PATH
);
3714 PathAddBackslashW(szSearch
);
3715 dwLen
= strlenW(szSearch
);
3716 if (dwLen
> MAX_PATH
- 4)
3719 strcpyW(szSearch
+ dwLen
, szAllFiles
);
3720 hfind
= FindFirstFileW(szSearch
, &find_data
);
3722 if (hfind
!= INVALID_HANDLE_VALUE
&&
3723 find_data
.cFileName
[0] == '.' &&
3724 find_data
.cFileName
[1] == '.')
3726 /* The only directory entry should be the parent */
3727 if (!FindNextFileW(hfind
, &find_data
))
3735 /*************************************************************************
3736 * PathFindSuffixArrayA [SHLWAPI.@]
3738 * Find a suffix string in an array of suffix strings
3741 * lpszSuffix [I] Suffix string to search for
3742 * lppszArray [I] Array of suffix strings to search
3743 * dwCount [I] Number of elements in lppszArray
3746 * Success: The index of the position of lpszSuffix in lppszArray
3747 * Failure: 0, if any parameters are invalid or lpszSuffix is not found
3750 * The search is case sensitive.
3751 * The match is made against the end of the suffix string, so for example:
3752 * lpszSuffix="fooBAR" matches "BAR", but lpszSuffix="fooBARfoo" does not.
3754 LPCSTR WINAPI
PathFindSuffixArrayA(LPCSTR lpszSuffix
, LPCSTR
*lppszArray
, int dwCount
)
3759 TRACE("(%s,%p,%d)\n",debugstr_a(lpszSuffix
), lppszArray
, dwCount
);
3761 if (lpszSuffix
&& lppszArray
&& dwCount
> 0)
3763 dwLen
= strlen(lpszSuffix
);
3765 while (dwRet
< dwCount
)
3767 size_t dwCompareLen
= strlen(*lppszArray
);
3768 if (dwCompareLen
< dwLen
)
3770 if (!strcmp(lpszSuffix
+ dwLen
- dwCompareLen
, *lppszArray
))
3771 return *lppszArray
; /* Found */
3780 /*************************************************************************
3781 * PathFindSuffixArrayW [SHLWAPI.@]
3783 * See PathFindSuffixArrayA.
3785 LPCWSTR WINAPI
PathFindSuffixArrayW(LPCWSTR lpszSuffix
, LPCWSTR
*lppszArray
, int dwCount
)
3790 TRACE("(%s,%p,%d)\n",debugstr_w(lpszSuffix
), lppszArray
, dwCount
);
3792 if (lpszSuffix
&& lppszArray
&& dwCount
> 0)
3794 dwLen
= strlenW(lpszSuffix
);
3796 while (dwRet
< dwCount
)
3798 size_t dwCompareLen
= strlenW(*lppszArray
);
3799 if (dwCompareLen
< dwLen
)
3801 if (!strcmpW(lpszSuffix
+ dwLen
- dwCompareLen
, *lppszArray
))
3802 return *lppszArray
; /* Found */
3811 /*************************************************************************
3812 * PathUndecorateA [SHLWAPI.@]
3814 * Undecorate a file path
3817 * lpszPath [I/O] Path to remove any decoration from
3823 * A decorations form is "path[n].ext" where "n" is an optional decimal number.
3825 VOID WINAPI
PathUndecorateA(LPSTR lpszPath
)
3827 TRACE("(%s)\n",debugstr_a(lpszPath
));
3831 LPSTR lpszExt
= PathFindExtensionA(lpszPath
);
3832 if (lpszExt
> lpszPath
&& lpszExt
[-1] == ']')
3834 LPSTR lpszSkip
= lpszExt
- 2;
3835 if (*lpszSkip
== '[')
3836 lpszSkip
++; /* [] (no number) */
3838 while (lpszSkip
> lpszPath
&& isdigit(lpszSkip
[-1]))
3840 if (lpszSkip
> lpszPath
&& lpszSkip
[-1] == '[' && lpszSkip
[-2] != '\\')
3842 /* remove the [n] */
3845 *lpszSkip
++ = *lpszExt
++;
3852 /*************************************************************************
3853 * PathUndecorateW [SHLWAPI.@]
3855 * See PathUndecorateA.
3857 VOID WINAPI
PathUndecorateW(LPWSTR lpszPath
)
3859 TRACE("(%s)\n",debugstr_w(lpszPath
));
3863 LPWSTR lpszExt
= PathFindExtensionW(lpszPath
);
3864 if (lpszExt
> lpszPath
&& lpszExt
[-1] == ']')
3866 LPWSTR lpszSkip
= lpszExt
- 2;
3867 if (*lpszSkip
== '[')
3868 lpszSkip
++; /* [] (no number) */
3870 while (lpszSkip
> lpszPath
&& isdigitW(lpszSkip
[-1]))
3872 if (lpszSkip
> lpszPath
&& lpszSkip
[-1] == '[' && lpszSkip
[-2] != '\\')
3874 /* remove the [n] */
3877 *lpszSkip
++ = *lpszExt
++;
3884 /*************************************************************************
3887 * Find localised or default web content in "%WINDOWS%\web\".
3890 * lpszFile [I] File name containing content to look for
3891 * lpszPath [O] Buffer to contain the full path to the file
3892 * dwPathLen [I] Length of lpszPath
3895 * Success: S_OK. lpszPath contains the full path to the content.
3896 * Failure: E_FAIL. The content does not exist or lpszPath is too short.
3898 HRESULT WINAPI
SHGetWebFolderFilePathA(LPCSTR lpszFile
, LPSTR lpszPath
, DWORD dwPathLen
)
3900 WCHAR szFile
[MAX_PATH
], szPath
[MAX_PATH
];
3903 TRACE("(%s,%p,%ld)\n", lpszFile
, lpszPath
, dwPathLen
);
3905 MultiByteToWideChar(CP_ACP
, 0, lpszFile
, -1, szFile
, MAX_PATH
);
3907 hRet
= SHGetWebFolderFilePathW(szFile
, szPath
, dwPathLen
);
3908 WideCharToMultiByte(CP_ACP
, 0, szPath
, -1, lpszPath
, dwPathLen
, 0, 0);
3912 /*************************************************************************
3915 * Unicode version of SHGetWebFolderFilePathA.
3917 HRESULT WINAPI
SHGetWebFolderFilePathW(LPCWSTR lpszFile
, LPWSTR lpszPath
, DWORD dwPathLen
)
3919 static const WCHAR szWeb
[] = {'\\','W','e','b','\\','\0'};
3920 static const WCHAR szWebMui
[] = {'m','u','i','\\','%','0','4','x','\\','\0'};
3921 #define szWebLen (sizeof(szWeb)/sizeof(WCHAR))
3922 #define szWebMuiLen ((sizeof(szWebMui)+1)/sizeof(WCHAR))
3923 DWORD dwLen
, dwFileLen
;
3924 LANGID lidSystem
, lidUser
;
3926 TRACE("(%s,%p,%ld)\n", debugstr_w(lpszFile
), lpszPath
, dwPathLen
);
3928 /* Get base directory for web content */
3929 dwLen
= GetSystemWindowsDirectoryW(lpszPath
, dwPathLen
);
3930 if (dwLen
> 0 && lpszPath
[dwLen
-1] == '\\')
3933 dwFileLen
= strlenW(lpszFile
);
3935 if (dwLen
+ dwFileLen
+ szWebLen
>= dwPathLen
)
3936 return E_FAIL
; /* lpszPath too short */
3938 strcpyW(lpszPath
+dwLen
, szWeb
);
3940 dwPathLen
= dwPathLen
- dwLen
; /* Remaining space */
3942 lidSystem
= GetSystemDefaultUILanguage();
3943 lidUser
= GetUserDefaultUILanguage();
3945 if (lidSystem
!= lidUser
)
3947 if (dwFileLen
+ szWebMuiLen
< dwPathLen
)
3949 /* Use localised content in the users UI language if present */
3950 wsprintfW(lpszPath
+ dwLen
, szWebMui
, lidUser
);
3951 strcpyW(lpszPath
+ dwLen
+ szWebMuiLen
, lpszFile
);
3952 if (PathFileExistsW(lpszPath
))
3957 /* Fall back to OS default installed content */
3958 strcpyW(lpszPath
+ dwLen
, lpszFile
);
3959 if (PathFileExistsW(lpszPath
))