4 * Copyright 1997 Marcus Meissner
5 * Copyright 1998, 1999, 2002 Juergen Schmied
7 * IShellFolder2 and related interfaces
9 * This library is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU Lesser General Public
11 * License as published by the Free Software Foundation; either
12 * version 2.1 of the License, or (at your option) any later version.
14 * This library is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 * Lesser General Public License for more details.
19 * You should have received a copy of the GNU Lesser General Public
20 * License along with this library; if not, write to the Free Software
21 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
25 #include "wine/port.h"
45 #include "undocshell.h"
46 #include "shell32_main.h"
48 #include "wine/debug.h"
51 WINE_DEFAULT_DEBUG_CHANNEL (shell
);
53 static const WCHAR wszDotShellClassInfo
[] = {
54 '.','S','h','e','l','l','C','l','a','s','s','I','n','f','o',0};
56 /***************************************************************************
57 * SHELL32_GetCustomFolderAttribute (internal function)
59 * Gets a value from the folder's desktop.ini file, if one exists.
62 * pidl [I] Folder containing the desktop.ini file.
63 * pwszHeading [I] Heading in .ini file.
64 * pwszAttribute [I] Attribute in .ini file.
65 * pwszValue [O] Buffer to store value into.
66 * cchValue [I] Size in characters including NULL of buffer pointed to
70 * TRUE if returned non-NULL value.
73 static inline BOOL
SHELL32_GetCustomFolderAttributeFromPath(
74 LPWSTR pwszFolderPath
, LPCWSTR pwszHeading
, LPCWSTR pwszAttribute
,
75 LPWSTR pwszValue
, DWORD cchValue
)
77 static const WCHAR wszDesktopIni
[] =
78 {'d','e','s','k','t','o','p','.','i','n','i',0};
79 static const WCHAR wszDefault
[] = {0};
81 PathAddBackslashW(pwszFolderPath
);
82 PathAppendW(pwszFolderPath
, wszDesktopIni
);
83 return GetPrivateProfileStringW(pwszHeading
, pwszAttribute
, wszDefault
,
84 pwszValue
, cchValue
, pwszFolderPath
);
87 BOOL
SHELL32_GetCustomFolderAttribute(
88 LPCITEMIDLIST pidl
, LPCWSTR pwszHeading
, LPCWSTR pwszAttribute
,
89 LPWSTR pwszValue
, DWORD cchValue
)
91 DWORD dwAttrib
= FILE_ATTRIBUTE_SYSTEM
;
92 WCHAR wszFolderPath
[MAX_PATH
];
94 /* Hack around not having system attribute on non-Windows file systems */
96 dwAttrib
= _ILGetFileAttributes(pidl
, NULL
, 0);
98 if (dwAttrib
& FILE_ATTRIBUTE_SYSTEM
)
100 if (!SHGetPathFromIDListW(pidl
, wszFolderPath
))
103 return SHELL32_GetCustomFolderAttributeFromPath(wszFolderPath
, pwszHeading
,
104 pwszAttribute
, pwszValue
, cchValue
);
109 /***************************************************************************
110 * GetNextElement (internal function)
112 * Gets a part of a string till the first backslash.
115 * pszNext [IN] string to get the element from
116 * pszOut [IN] pointer to buffer whitch receives string
117 * dwOut [IN] length of pszOut
120 * LPSTR pointer to first, not yet parsed char
123 LPCWSTR
GetNextElementW (LPCWSTR pszNext
, LPWSTR pszOut
, DWORD dwOut
)
125 LPCWSTR pszTail
= pszNext
;
128 TRACE ("(%s %p 0x%08x)\n", debugstr_w (pszNext
), pszOut
, dwOut
);
132 if (!pszNext
|| !*pszNext
)
135 while (*pszTail
&& (*pszTail
!= (WCHAR
) '\\'))
138 dwCopy
= (const WCHAR
*) pszTail
- (const WCHAR
*) pszNext
+ 1;
139 lstrcpynW (pszOut
, pszNext
, (dwOut
< dwCopy
) ? dwOut
: dwCopy
);
146 TRACE ("--(%s %s 0x%08x %p)\n", debugstr_w (pszNext
), debugstr_w (pszOut
), dwOut
, pszTail
);
150 HRESULT
SHELL32_ParseNextElement (IShellFolder2
* psf
, HWND hwndOwner
, LPBC pbc
,
151 LPITEMIDLIST
* pidlInOut
, LPOLESTR szNext
, DWORD
* pEaten
, DWORD
* pdwAttributes
)
153 HRESULT hr
= E_INVALIDARG
;
154 LPITEMIDLIST pidlOut
= NULL
,
156 IShellFolder
*psfChild
;
158 TRACE ("(%p, %p, %p, %s)\n", psf
, pbc
, pidlInOut
? *pidlInOut
: NULL
, debugstr_w (szNext
));
160 /* get the shellfolder for the child pidl and let it analyse further */
161 hr
= IShellFolder_BindToObject (psf
, *pidlInOut
, pbc
, &IID_IShellFolder
, (LPVOID
*) & psfChild
);
164 hr
= IShellFolder_ParseDisplayName (psfChild
, hwndOwner
, pbc
, szNext
, pEaten
, &pidlOut
, pdwAttributes
);
165 IShellFolder_Release (psfChild
);
168 pidlTemp
= ILCombine (*pidlInOut
, pidlOut
);
179 *pidlInOut
= pidlTemp
;
181 TRACE ("-- pidl=%p ret=0x%08x\n", pidlInOut
? *pidlInOut
: NULL
, hr
);
185 /***********************************************************************
186 * SHELL32_CoCreateInitSF
188 * Creates a shell folder and initializes it with a pidl and a root folder
189 * via IPersistFolder3 or IPersistFolder.
192 * pathRoot can be NULL for Folders being a drive.
193 * In this case the absolute path is built from pidlChild (eg. C:)
195 static HRESULT
SHELL32_CoCreateInitSF (LPCITEMIDLIST pidlRoot
, LPCWSTR pathRoot
,
196 LPCITEMIDLIST pidlChild
, REFCLSID clsid
, REFIID riid
, LPVOID
* ppvOut
)
200 TRACE ("%p %s %p\n", pidlRoot
, debugstr_w(pathRoot
), pidlChild
);
202 if (SUCCEEDED ((hr
= SHCoCreateInstance (NULL
, clsid
, NULL
, riid
, ppvOut
)))) {
203 LPITEMIDLIST pidlAbsolute
= ILCombine (pidlRoot
, pidlChild
);
205 IPersistFolder3
*ppf
;
207 if (_ILIsFolder(pidlChild
) &&
208 SUCCEEDED (IUnknown_QueryInterface ((IUnknown
*) * ppvOut
, &IID_IPersistFolder3
, (LPVOID
*) & ppf
)))
210 PERSIST_FOLDER_TARGET_INFO ppfti
;
212 ZeroMemory (&ppfti
, sizeof (ppfti
));
214 /* fill the PERSIST_FOLDER_TARGET_INFO */
215 ppfti
.dwAttributes
= -1;
220 lstrcpynW (ppfti
.szTargetParsingName
, pathRoot
, MAX_PATH
- 1);
221 PathAddBackslashW(ppfti
.szTargetParsingName
); /* FIXME: why have drives a backslash here ? */
225 int len
= lstrlenW(ppfti
.szTargetParsingName
);
227 if (!_ILSimpleGetTextW(pidlChild
, ppfti
.szTargetParsingName
+ len
, MAX_PATH
- len
))
231 IPersistFolder3_InitializeEx (ppf
, NULL
, pidlAbsolute
, &ppfti
);
232 IPersistFolder3_Release (ppf
);
234 else if (SUCCEEDED ((hr
= IUnknown_QueryInterface ((IUnknown
*) * ppvOut
, &IID_IPersistFolder
, (LPVOID
*) & pPF
)))) {
235 IPersistFolder_Initialize (pPF
, pidlAbsolute
);
236 IPersistFolder_Release (pPF
);
238 ILFree (pidlAbsolute
);
240 TRACE ("-- (%p) ret=0x%08x\n", *ppvOut
, hr
);
244 /***********************************************************************
245 * SHELL32_BindToChild [Internal]
247 * Common code for IShellFolder_BindToObject.
250 * pidlRoot [I] The parent shell folder's absolute pidl.
251 * pathRoot [I] Absolute dos path of the parent shell folder.
252 * pidlComplete [I] PIDL of the child. Relative to pidlRoot.
253 * riid [I] GUID of the interface, which ppvOut shall be bound to.
254 * ppvOut [O] A reference to the child's interface (riid).
257 * pidlComplete has to contain at least one non empty SHITEMID.
258 * This function makes special assumptions on the shell namespace, which
259 * means you probably can't use it for your IShellFolder implementation.
261 HRESULT
SHELL32_BindToChild (LPCITEMIDLIST pidlRoot
,
262 LPCWSTR pathRoot
, LPCITEMIDLIST pidlComplete
, REFIID riid
, LPVOID
* ppvOut
)
267 LPITEMIDLIST pidlChild
;
269 if (!pidlRoot
|| !ppvOut
|| !pidlComplete
|| !pidlComplete
->mkid
.cb
)
274 pidlChild
= ILCloneFirst (pidlComplete
);
276 if ((clsid
= _ILGetGUIDPointer (pidlChild
))) {
278 hr
= SHELL32_CoCreateInitSF (pidlRoot
, pathRoot
, pidlChild
, clsid
, &IID_IShellFolder
, (LPVOID
*) & pSF
);
280 /* file system folder */
281 CLSID clsidFolder
= CLSID_ShellFSFolder
;
282 static const WCHAR wszCLSID
[] = {'C','L','S','I','D',0};
283 WCHAR wszCLSIDValue
[CHARS_IN_GUID
], wszFolderPath
[MAX_PATH
], *pwszPathTail
= wszFolderPath
;
285 /* see if folder CLSID should be overridden by desktop.ini file */
287 lstrcpynW(wszFolderPath
, pathRoot
, MAX_PATH
);
288 pwszPathTail
= PathAddBackslashW(wszFolderPath
);
291 _ILSimpleGetTextW(pidlChild
,pwszPathTail
,MAX_PATH
- (int)(pwszPathTail
- wszFolderPath
));
293 if (SHELL32_GetCustomFolderAttributeFromPath (wszFolderPath
,
294 wszDotShellClassInfo
, wszCLSID
, wszCLSIDValue
, CHARS_IN_GUID
))
295 CLSIDFromString (wszCLSIDValue
, &clsidFolder
);
297 hr
= SHELL32_CoCreateInitSF (pidlRoot
, pathRoot
, pidlChild
,
298 &clsidFolder
, &IID_IShellFolder
, (LPVOID
*)&pSF
);
302 if (SUCCEEDED (hr
)) {
303 if (_ILIsPidlSimple (pidlComplete
)) {
305 hr
= IShellFolder_QueryInterface (pSF
, riid
, ppvOut
);
308 hr
= IShellFolder_BindToObject (pSF
, ILGetNext (pidlComplete
), NULL
, riid
, ppvOut
);
310 IShellFolder_Release (pSF
);
314 * Return the correct interface
316 if ((hr
==S_OK
)&&(riid
))
318 IShellFolder
**check
= (IShellFolder
**)ppvOut
;
319 hr
= IShellView_QueryInterface(*check
, riid
, ppvOut
);
321 IShellFolder_Release(*check
);
324 TRACE ("-- returning (%p) %08x\n", *ppvOut
, hr
);
329 /***********************************************************************
330 * SHELL32_GetDisplayNameOfChild
332 * Retrieves the display name of a child object of a shellfolder.
334 * For a pidl eg. [subpidl1][subpidl2][subpidl3]:
335 * - it binds to the child shellfolder [subpidl1]
336 * - asks it for the displayname of [subpidl2][subpidl3]
338 * Is possible the pidl is a simple pidl. In this case it asks the
339 * subfolder for the displayname of an empty pidl. The subfolder
340 * returns the own displayname eg. "::{guid}". This is used for
341 * virtual folders with the registry key WantsFORPARSING set.
343 HRESULT
SHELL32_GetDisplayNameOfChild (IShellFolder2
* psf
,
344 LPCITEMIDLIST pidl
, DWORD dwFlags
, LPWSTR szOut
, DWORD dwOutLen
)
346 LPITEMIDLIST pidlFirst
;
347 HRESULT hr
= E_INVALIDARG
;
349 TRACE ("(%p)->(pidl=%p 0x%08x %p 0x%08x)\n", psf
, pidl
, dwFlags
, szOut
, dwOutLen
);
352 pidlFirst
= ILCloneFirst (pidl
);
354 IShellFolder2
*psfChild
;
356 hr
= IShellFolder_BindToObject (psf
, pidlFirst
, NULL
, &IID_IShellFolder
, (LPVOID
*) & psfChild
);
357 if (SUCCEEDED (hr
)) {
359 LPITEMIDLIST pidlNext
= ILGetNext (pidl
);
361 hr
= IShellFolder_GetDisplayNameOf (psfChild
, pidlNext
, dwFlags
, &strTemp
);
362 if (SUCCEEDED (hr
)) {
363 if(!StrRetToStrNW (szOut
, dwOutLen
, &strTemp
, pidlNext
))
366 IShellFolder_Release (psfChild
);
372 TRACE ("-- ret=0x%08x %s\n", hr
, debugstr_w(szOut
));
377 /***********************************************************************
378 * SHELL32_GetItemAttributes
382 * folder: 0xE0000177 FILESYSTEM | HASSUBFOLDER | FOLDER
383 * file: 0x40000177 FILESYSTEM
384 * drive: 0xf0000144 FILESYSTEM | HASSUBFOLDER | FOLDER | FILESYSANCESTOR
385 * mycomputer: 0xb0000154 HASSUBFOLDER | FOLDER | FILESYSANCESTOR
386 * (seems to be default for shell extensions if no registry entry exists)
389 * folder: 0xF0400177 FILESYSTEM | HASSUBFOLDER | FOLDER | FILESYSANCESTOR | CANMONIKER
390 * file: 0x40400177 FILESYSTEM | CANMONIKER
391 * drive 0xF0400154 FILESYSTEM | HASSUBFOLDER | FOLDER | FILESYSANCESTOR | CANMONIKER | CANRENAME (LABEL)
393 * According to the MSDN documentation this function should not set flags. It claims only to reset flags when necessary.
394 * However it turns out the native shell32.dll _sets_ flags in several cases - so do we.
396 HRESULT
SHELL32_GetItemAttributes (IShellFolder
* psf
, LPCITEMIDLIST pidl
, LPDWORD pdwAttributes
)
400 static const DWORD dwSupportedAttr
=
401 SFGAO_CANCOPY
| /*0x00000001 */
402 SFGAO_CANMOVE
| /*0x00000002 */
403 SFGAO_CANLINK
| /*0x00000004 */
404 SFGAO_CANRENAME
| /*0x00000010 */
405 SFGAO_CANDELETE
| /*0x00000020 */
406 SFGAO_HASPROPSHEET
| /*0x00000040 */
407 SFGAO_DROPTARGET
| /*0x00000100 */
408 SFGAO_LINK
| /*0x00010000 */
409 SFGAO_READONLY
| /*0x00040000 */
410 SFGAO_HIDDEN
| /*0x00080000 */
411 SFGAO_FILESYSANCESTOR
| /*0x10000000 */
412 SFGAO_FOLDER
| /*0x20000000 */
413 SFGAO_FILESYSTEM
| /*0x40000000 */
414 SFGAO_HASSUBFOLDER
; /*0x80000000 */
416 TRACE ("0x%08x\n", *pdwAttributes
);
418 if (*pdwAttributes
& ~dwSupportedAttr
)
420 WARN ("attributes 0x%08x not implemented\n", (*pdwAttributes
& ~dwSupportedAttr
));
421 *pdwAttributes
&= dwSupportedAttr
;
424 has_guid
= _ILGetGUIDPointer(pidl
) != NULL
;
426 dwAttributes
= *pdwAttributes
;
428 if (_ILIsDrive (pidl
)) {
429 *pdwAttributes
&= SFGAO_HASSUBFOLDER
|SFGAO_FILESYSTEM
|SFGAO_FOLDER
|SFGAO_FILESYSANCESTOR
|
430 SFGAO_DROPTARGET
|SFGAO_HASPROPSHEET
|SFGAO_CANLINK
;
431 } else if (has_guid
&& HCR_GetFolderAttributes(pidl
, &dwAttributes
)) {
432 *pdwAttributes
= dwAttributes
;
433 } else if (_ILGetDataPointer (pidl
)) {
434 dwAttributes
= _ILGetFileAttributes (pidl
, NULL
, 0);
436 if (!dwAttributes
&& has_guid
) {
437 WCHAR path
[MAX_PATH
];
440 /* File attributes are not present in the internal PIDL structure, so get them from the file system. */
442 HRESULT hr
= IShellFolder_GetDisplayNameOf(psf
, pidl
, SHGDN_FORPARSING
, &strret
);
445 hr
= StrRetToBufW(&strret
, pidl
, path
, MAX_PATH
);
447 /* call GetFileAttributes() only for file system paths, not for parsing names like "::{...}" */
448 if (SUCCEEDED(hr
) && path
[0]!=':')
449 dwAttributes
= GetFileAttributesW(path
);
453 /* Set common attributes */
454 *pdwAttributes
|= SFGAO_FILESYSTEM
| SFGAO_DROPTARGET
| SFGAO_HASPROPSHEET
| SFGAO_CANDELETE
|
455 SFGAO_CANRENAME
| SFGAO_CANLINK
| SFGAO_CANMOVE
| SFGAO_CANCOPY
;
457 if (dwAttributes
& FILE_ATTRIBUTE_DIRECTORY
)
458 *pdwAttributes
|= (SFGAO_FOLDER
| SFGAO_HASSUBFOLDER
| SFGAO_FILESYSANCESTOR
);
460 *pdwAttributes
&= ~(SFGAO_FOLDER
| SFGAO_HASSUBFOLDER
| SFGAO_FILESYSANCESTOR
);
462 if (dwAttributes
& FILE_ATTRIBUTE_HIDDEN
)
463 *pdwAttributes
|= SFGAO_HIDDEN
;
465 *pdwAttributes
&= ~SFGAO_HIDDEN
;
467 if (dwAttributes
& FILE_ATTRIBUTE_READONLY
)
468 *pdwAttributes
|= SFGAO_READONLY
;
470 *pdwAttributes
&= ~SFGAO_READONLY
;
472 if (SFGAO_LINK
& *pdwAttributes
) {
475 if (!_ILGetExtension(pidl
, ext
, MAX_PATH
) || lstrcmpiA(ext
, "lnk"))
476 *pdwAttributes
&= ~SFGAO_LINK
;
479 if (SFGAO_HASSUBFOLDER
& *pdwAttributes
)
482 if (SUCCEEDED(IShellFolder_BindToObject(psf
, pidl
, 0, (REFIID
)&IID_IShellFolder
, (LPVOID
*)&psf2
)))
484 IEnumIDList
*pEnumIL
= NULL
;
485 if (SUCCEEDED(IShellFolder_EnumObjects(psf2
, 0, SHCONTF_FOLDERS
, &pEnumIL
)))
487 if (IEnumIDList_Skip(pEnumIL
, 1) != S_OK
)
488 *pdwAttributes
&= ~SFGAO_HASSUBFOLDER
;
489 IEnumIDList_Release(pEnumIL
);
491 IShellFolder_Release(psf2
);
495 *pdwAttributes
&= SFGAO_HASSUBFOLDER
|SFGAO_FOLDER
|SFGAO_FILESYSANCESTOR
|SFGAO_DROPTARGET
|SFGAO_HASPROPSHEET
|SFGAO_CANRENAME
|SFGAO_CANLINK
;
497 TRACE ("-- 0x%08x\n", *pdwAttributes
);
501 /***********************************************************************
504 HRESULT
SHELL32_CompareIDs (IShellFolder
* iface
, LPARAM lParam
, LPCITEMIDLIST pidl1
, LPCITEMIDLIST pidl2
)
508 char szTemp1
[MAX_PATH
];
509 char szTemp2
[MAX_PATH
];
511 LPITEMIDLIST firstpidl
,
516 /* test for empty pidls */
517 BOOL isEmpty1
= _ILIsDesktop (pidl1
);
518 BOOL isEmpty2
= _ILIsDesktop (pidl2
);
520 if (isEmpty1
&& isEmpty2
)
521 return MAKE_HRESULT( SEVERITY_SUCCESS
, 0, 0 );
523 return MAKE_HRESULT( SEVERITY_SUCCESS
, 0, (WORD
)-1 );
525 return MAKE_HRESULT( SEVERITY_SUCCESS
, 0, 1 );
527 /* test for different types. Sort order is the PT_* constant */
528 type1
= _ILGetDataPointer (pidl1
)->type
;
529 type2
= _ILGetDataPointer (pidl2
)->type
;
531 return MAKE_HRESULT( SEVERITY_SUCCESS
, 0, (WORD
)-1 );
532 else if (type1
> type2
)
533 return MAKE_HRESULT( SEVERITY_SUCCESS
, 0, 1 );
535 /* test for name of pidl */
536 _ILSimpleGetText (pidl1
, szTemp1
, MAX_PATH
);
537 _ILSimpleGetText (pidl2
, szTemp2
, MAX_PATH
);
538 nReturn
= lstrcmpiA (szTemp1
, szTemp2
);
540 return MAKE_HRESULT( SEVERITY_SUCCESS
, 0, (WORD
)-1 );
541 else if (nReturn
> 0)
542 return MAKE_HRESULT( SEVERITY_SUCCESS
, 0, 1 );
544 /* test of complex pidls */
545 firstpidl
= ILCloneFirst (pidl1
);
546 nextpidl1
= ILGetNext (pidl1
);
547 nextpidl2
= ILGetNext (pidl2
);
549 /* optimizing: test special cases and bind not deeper */
550 /* the deeper shellfolder would do the same */
551 isEmpty1
= _ILIsDesktop (nextpidl1
);
552 isEmpty2
= _ILIsDesktop (nextpidl2
);
554 if (isEmpty1
&& isEmpty2
) {
555 return MAKE_HRESULT( SEVERITY_SUCCESS
, 0, 0 );
556 } else if (isEmpty1
) {
557 return MAKE_HRESULT( SEVERITY_SUCCESS
, 0, (WORD
)-1 );
558 } else if (isEmpty2
) {
559 return MAKE_HRESULT( SEVERITY_SUCCESS
, 0, 1 );
561 } else if (SUCCEEDED (IShellFolder_BindToObject (iface
, firstpidl
, NULL
, &IID_IShellFolder
, (LPVOID
*) & psf
))) {
562 nReturn
= IShellFolder_CompareIDs (psf
, lParam
, nextpidl1
, nextpidl2
);
563 IShellFolder_Release (psf
);
569 /***********************************************************************
574 HRESULT WINAPI
SHCreateLinks( HWND hWnd
, LPCSTR lpszDir
, LPDATAOBJECT lpDataObject
,
575 UINT uFlags
, LPITEMIDLIST
*lppidlLinks
)
577 FIXME("%p %s %p %08x %p\n",hWnd
,lpszDir
,lpDataObject
,uFlags
,lppidlLinks
);