windowscodecs: Add stub JPEG encoder.
[wine] / dlls / shell32 / shlfolder.c
1 /*
2  *      Shell Folder stuff
3  *
4  *      Copyright 1997                  Marcus Meissner
5  *      Copyright 1998, 1999, 2002      Juergen Schmied
6  *
7  *      IShellFolder2 and related interfaces
8  *
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.
13  *
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.
18  *
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
22  */
23
24 #include "config.h"
25 #include "wine/port.h"
26
27 #include <stdlib.h>
28 #include <string.h>
29 #include <stdarg.h>
30 #include <stdio.h>
31
32 #define COBJMACROS
33 #define NONAMELESSUNION
34 #define NONAMELESSSTRUCT
35
36 #include "winerror.h"
37 #include "windef.h"
38 #include "winbase.h"
39 #include "winreg.h"
40 #include "wingdi.h"
41 #include "winuser.h"
42
43 #include "ole2.h"
44 #include "shlguid.h"
45
46 #include "pidl.h"
47 #include "undocshell.h"
48 #include "shell32_main.h"
49 #include "shlwapi.h"
50 #include "wine/debug.h"
51 #include "shfldr.h"
52
53 WINE_DEFAULT_DEBUG_CHANNEL (shell);
54
55 static const WCHAR wszDotShellClassInfo[] = {
56     '.','S','h','e','l','l','C','l','a','s','s','I','n','f','o',0};
57
58 /***************************************************************************
59  *  SHELL32_GetCustomFolderAttribute (internal function)
60  *
61  * Gets a value from the folder's desktop.ini file, if one exists.
62  *
63  * PARAMETERS
64  *  pidl          [I] Folder containing the desktop.ini file.
65  *  pwszHeading   [I] Heading in .ini file.
66  *  pwszAttribute [I] Attribute in .ini file.
67  *  pwszValue     [O] Buffer to store value into.
68  *  cchValue      [I] Size in characters including NULL of buffer pointed to
69  *                    by pwszValue.
70  *
71  *  RETURNS
72  *    TRUE if returned non-NULL value.
73  *    FALSE otherwise.
74  */
75 static inline BOOL SHELL32_GetCustomFolderAttributeFromPath(
76     LPWSTR pwszFolderPath, LPCWSTR pwszHeading, LPCWSTR pwszAttribute,
77     LPWSTR pwszValue, DWORD cchValue)
78 {
79     static const WCHAR wszDesktopIni[] =
80             {'d','e','s','k','t','o','p','.','i','n','i',0};
81     static const WCHAR wszDefault[] = {0};
82
83     PathAddBackslashW(pwszFolderPath);
84     PathAppendW(pwszFolderPath, wszDesktopIni);
85     return GetPrivateProfileStringW(pwszHeading, pwszAttribute, wszDefault, 
86                                     pwszValue, cchValue, pwszFolderPath);
87 }
88
89 BOOL SHELL32_GetCustomFolderAttribute(
90     LPCITEMIDLIST pidl, LPCWSTR pwszHeading, LPCWSTR pwszAttribute,
91     LPWSTR pwszValue, DWORD cchValue)
92 {
93     DWORD dwAttrib = FILE_ATTRIBUTE_SYSTEM;
94     WCHAR wszFolderPath[MAX_PATH];
95
96     /* Hack around not having system attribute on non-Windows file systems */
97     if (0)
98         dwAttrib = _ILGetFileAttributes(pidl, NULL, 0);
99
100     if (dwAttrib & FILE_ATTRIBUTE_SYSTEM)
101     {
102         if (!SHGetPathFromIDListW(pidl, wszFolderPath))
103             return FALSE;
104
105         return SHELL32_GetCustomFolderAttributeFromPath(wszFolderPath, pwszHeading, 
106                                                 pwszAttribute, pwszValue, cchValue);
107     }
108     return FALSE;
109 }
110
111 /***************************************************************************
112  *  GetNextElement (internal function)
113  *
114  * Gets a part of a string till the first backslash.
115  *
116  * PARAMETERS
117  *  pszNext [IN] string to get the element from
118  *  pszOut  [IN] pointer to buffer which receives string
119  *  dwOut   [IN] length of pszOut
120  *
121  *  RETURNS
122  *    LPSTR pointer to first, not yet parsed char
123  */
124
125 LPCWSTR GetNextElementW (LPCWSTR pszNext, LPWSTR pszOut, DWORD dwOut)
126 {
127     LPCWSTR pszTail = pszNext;
128     DWORD dwCopy;
129
130     TRACE ("(%s %p 0x%08x)\n", debugstr_w(pszNext), pszOut, dwOut);
131
132     *pszOut = 0;
133
134     if (!pszNext || !*pszNext)
135         return NULL;
136
137     while (*pszTail && (*pszTail != (WCHAR) '\\'))
138         pszTail++;
139
140     dwCopy = pszTail - pszNext + 1;
141     lstrcpynW (pszOut, pszNext, (dwOut < dwCopy) ? dwOut : dwCopy);
142
143     if (*pszTail)
144         pszTail++;
145     else
146         pszTail = NULL;
147
148     TRACE ("--(%s %s 0x%08x %p)\n", debugstr_w (pszNext), debugstr_w (pszOut), dwOut, pszTail);
149     return pszTail;
150 }
151
152 HRESULT SHELL32_ParseNextElement (IShellFolder2 * psf, HWND hwndOwner, LPBC pbc,
153                                   LPITEMIDLIST * pidlInOut, LPOLESTR szNext, DWORD * pEaten, DWORD * pdwAttributes)
154 {
155     LPITEMIDLIST pidlOut = NULL, pidlTemp = NULL;
156     IShellFolder *psfChild;
157     HRESULT hr;
158
159     TRACE ("(%p, %p, %p, %s)\n", psf, pbc, pidlInOut ? *pidlInOut : NULL, debugstr_w (szNext));
160
161     /* get the shellfolder for the child pidl and let it analyse further */
162     hr = IShellFolder_BindToObject (psf, *pidlInOut, pbc, &IID_IShellFolder, (LPVOID *) & psfChild);
163
164     if (SUCCEEDED(hr)) {
165         hr = IShellFolder_ParseDisplayName (psfChild, hwndOwner, pbc, szNext, pEaten, &pidlOut, pdwAttributes);
166         IShellFolder_Release (psfChild);
167
168         if (SUCCEEDED(hr)) {
169             pidlTemp = ILCombine (*pidlInOut, pidlOut);
170
171             if (!pidlTemp)
172                 hr = E_OUTOFMEMORY;
173         }
174
175         if (pidlOut)
176             ILFree (pidlOut);
177     }
178
179     ILFree (*pidlInOut);
180     *pidlInOut = pidlTemp;
181
182     TRACE ("-- pidl=%p ret=0x%08x\n", pidlInOut ? *pidlInOut : NULL, hr);
183     return hr;
184 }
185
186 /***********************************************************************
187  *      SHELL32_CoCreateInitSF
188  *
189  * Creates a shell folder and initializes it with a pidl and a root folder
190  * via IPersistFolder3 or IPersistFolder.
191  *
192  * NOTES
193  *   pathRoot can be NULL for Folders being a drive.
194  *   In this case the absolute path is built from pidlChild (eg. C:)
195  */
196 static HRESULT SHELL32_CoCreateInitSF (LPCITEMIDLIST pidlRoot, LPCWSTR pathRoot,
197                 LPCITEMIDLIST pidlChild, REFCLSID clsid, LPVOID * ppvOut)
198 {
199     HRESULT hr;
200
201     TRACE ("(%p %s %p %s %p)\n", pidlRoot, debugstr_w(pathRoot), pidlChild, debugstr_guid(clsid), ppvOut);
202
203     hr = SHCoCreateInstance(NULL, clsid, NULL, &IID_IShellFolder, ppvOut);
204     if (SUCCEEDED (hr))
205     {
206         LPITEMIDLIST pidlAbsolute = ILCombine (pidlRoot, pidlChild);
207         IPersistFolder *pPF;
208         IPersistFolder3 *ppf;
209
210         if (_ILIsFolder(pidlChild) &&
211             SUCCEEDED (IUnknown_QueryInterface ((IUnknown *) * ppvOut, &IID_IPersistFolder3, (LPVOID *) & ppf))) 
212         {
213             PERSIST_FOLDER_TARGET_INFO ppfti;
214
215             ZeroMemory (&ppfti, sizeof (ppfti));
216
217             /* fill the PERSIST_FOLDER_TARGET_INFO */
218             ppfti.dwAttributes = -1;
219             ppfti.csidl = -1;
220
221             /* build path */
222             if (pathRoot) {
223                 lstrcpynW (ppfti.szTargetParsingName, pathRoot, MAX_PATH - 1);
224                 PathAddBackslashW(ppfti.szTargetParsingName); /* FIXME: why have drives a backslash here ? */
225             }
226
227             if (pidlChild) {
228                 int len = lstrlenW(ppfti.szTargetParsingName);
229
230                 if (!_ILSimpleGetTextW(pidlChild, ppfti.szTargetParsingName + len, MAX_PATH - len))
231                         hr = E_INVALIDARG;
232             }
233
234             IPersistFolder3_InitializeEx (ppf, NULL, pidlAbsolute, &ppfti);
235             IPersistFolder3_Release (ppf);
236         }
237         else if (SUCCEEDED ((hr = IUnknown_QueryInterface ((IUnknown *) * ppvOut, &IID_IPersistFolder, (LPVOID *) & pPF)))) {
238             IPersistFolder_Initialize (pPF, pidlAbsolute);
239             IPersistFolder_Release (pPF);
240         }
241         ILFree (pidlAbsolute);
242     }
243     TRACE ("-- (%p) ret=0x%08x\n", *ppvOut, hr);
244     return hr;
245 }
246
247 /***********************************************************************
248  *      SHELL32_BindToChild [Internal]
249  *
250  * Common code for IShellFolder_BindToObject.
251  * 
252  * PARAMS
253  *  pidlRoot     [I] The parent shell folder's absolute pidl.
254  *  pathRoot     [I] Absolute dos path of the parent shell folder.
255  *  pidlComplete [I] PIDL of the child. Relative to pidlRoot.
256  *  riid         [I] GUID of the interface, which ppvOut shall be bound to.
257  *  ppvOut       [O] A reference to the child's interface (riid).
258  *
259  * NOTES
260  *  pidlComplete has to contain at least one non empty SHITEMID.
261  *  This function makes special assumptions on the shell namespace, which
262  *  means you probably can't use it for your IShellFolder implementation.
263  */
264 HRESULT SHELL32_BindToChild (LPCITEMIDLIST pidlRoot,
265                              LPCWSTR pathRoot, LPCITEMIDLIST pidlComplete, REFIID riid, LPVOID * ppvOut)
266 {
267     GUID const *clsid;
268     IShellFolder *pSF;
269     HRESULT hr;
270     LPITEMIDLIST pidlChild;
271
272     TRACE("(%p %s %p %s %p)\n", pidlRoot, debugstr_w(pathRoot), pidlComplete, debugstr_guid(riid), ppvOut);
273
274     if (!pidlRoot || !ppvOut || _ILIsEmpty(pidlComplete))
275         return E_INVALIDARG;
276
277     *ppvOut = NULL;
278
279     pidlChild = ILCloneFirst (pidlComplete);
280
281     if ((clsid = _ILGetGUIDPointer (pidlChild))) {
282         /* virtual folder */
283         hr = SHELL32_CoCreateInitSF (pidlRoot, pathRoot, pidlChild, clsid, (LPVOID *)&pSF);
284     } else if (_ILIsValue(pidlChild)) {
285         /* Don't bind to files */
286         hr = HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND);
287     } else {
288         /* file system folder */
289         CLSID clsidFolder = CLSID_ShellFSFolder;
290         static const WCHAR wszCLSID[] = {'C','L','S','I','D',0};
291         WCHAR wszCLSIDValue[CHARS_IN_GUID], wszFolderPath[MAX_PATH], *pwszPathTail = wszFolderPath;
292        
293         /* see if folder CLSID should be overridden by desktop.ini file */
294         if (pathRoot) {
295             lstrcpynW(wszFolderPath, pathRoot, MAX_PATH);
296             pwszPathTail = PathAddBackslashW(wszFolderPath);
297         }
298
299         _ILSimpleGetTextW(pidlChild,pwszPathTail,MAX_PATH - (int)(pwszPathTail - wszFolderPath));
300
301         if (SHELL32_GetCustomFolderAttributeFromPath (wszFolderPath,
302             wszDotShellClassInfo, wszCLSID, wszCLSIDValue, CHARS_IN_GUID))
303             CLSIDFromString (wszCLSIDValue, &clsidFolder);
304
305         hr = SHELL32_CoCreateInitSF (pidlRoot, pathRoot, pidlChild,
306                                      &clsidFolder, (LPVOID *)&pSF);
307     }
308     ILFree (pidlChild);
309
310     if (SUCCEEDED (hr)) {
311         if (_ILIsPidlSimple (pidlComplete)) {
312             /* no sub folders */
313             hr = IShellFolder_QueryInterface (pSF, riid, ppvOut);
314         } else {
315             /* go deeper */
316             hr = IShellFolder_BindToObject (pSF, ILGetNext (pidlComplete), NULL, riid, ppvOut);
317         }
318         IShellFolder_Release (pSF);
319     }
320
321     TRACE ("-- returning (%p) 0x%08x\n", *ppvOut, hr);
322
323     return hr;
324 }
325
326 /***********************************************************************
327  *      SHELL32_GetDisplayNameOfChild
328  *
329  * Retrieves the display name of a child object of a shellfolder.
330  *
331  * For a pidl eg. [subpidl1][subpidl2][subpidl3]:
332  * - it binds to the child shellfolder [subpidl1]
333  * - asks it for the displayname of [subpidl2][subpidl3]
334  *
335  * Is possible the pidl is a simple pidl. In this case it asks the
336  * subfolder for the displayname of an empty pidl. The subfolder
337  * returns the own displayname eg. "::{guid}". This is used for
338  * virtual folders with the registry key WantsFORPARSING set.
339  */
340 HRESULT SHELL32_GetDisplayNameOfChild (IShellFolder2 * psf,
341                                        LPCITEMIDLIST pidl, DWORD dwFlags, LPWSTR szOut, DWORD dwOutLen)
342 {
343     LPITEMIDLIST pidlFirst;
344     HRESULT hr;
345
346     TRACE ("(%p)->(pidl=%p 0x%08x %p 0x%08x)\n", psf, pidl, dwFlags, szOut, dwOutLen);
347     pdump (pidl);
348
349     pidlFirst = ILCloneFirst (pidl);
350     if (pidlFirst) {
351         IShellFolder2 *psfChild;
352
353         hr = IShellFolder_BindToObject (psf, pidlFirst, NULL, &IID_IShellFolder, (LPVOID *) & psfChild);
354         if (SUCCEEDED (hr)) {
355             STRRET strTemp;
356             LPITEMIDLIST pidlNext = ILGetNext (pidl);
357
358             hr = IShellFolder_GetDisplayNameOf (psfChild, pidlNext, dwFlags, &strTemp);
359             if (SUCCEEDED (hr)) {
360                 if(!StrRetToStrNW (szOut, dwOutLen, &strTemp, pidlNext))
361                     hr = E_FAIL;
362             }
363             IShellFolder_Release (psfChild);
364         }
365         ILFree (pidlFirst);
366     } else
367         hr = E_OUTOFMEMORY;
368
369     TRACE ("-- ret=0x%08x %s\n", hr, debugstr_w(szOut));
370
371     return hr;
372 }
373
374 /***********************************************************************
375  *  SHELL32_GetItemAttributes
376  *
377  * NOTES
378  * Observed values:
379  *  folder:     0xE0000177      FILESYSTEM | HASSUBFOLDER | FOLDER
380  *  file:       0x40000177      FILESYSTEM
381  *  drive:      0xf0000144      FILESYSTEM | HASSUBFOLDER | FOLDER | FILESYSANCESTOR
382  *  mycomputer: 0xb0000154      HASSUBFOLDER | FOLDER | FILESYSANCESTOR
383  *  (seems to be default for shell extensions if no registry entry exists)
384  *
385  * win2k:
386  *  folder:    0xF0400177      FILESYSTEM | HASSUBFOLDER | FOLDER | FILESYSANCESTOR | CANMONIKER
387  *  file:      0x40400177      FILESYSTEM | CANMONIKER
388  *  drive      0xF0400154      FILESYSTEM | HASSUBFOLDER | FOLDER | FILESYSANCESTOR | CANMONIKER | CANRENAME (LABEL)
389  *
390  * According to the MSDN documentation this function should not set flags. It claims only to reset flags when necessary.
391  * However it turns out the native shell32.dll _sets_ flags in several cases - so do we.
392  */
393 HRESULT SHELL32_GetItemAttributes (IShellFolder * psf, LPCITEMIDLIST pidl, LPDWORD pdwAttributes)
394 {
395     DWORD dwAttributes;
396     BOOL has_guid;
397     static const DWORD dwSupportedAttr=
398                           SFGAO_CANCOPY |           /*0x00000001 */
399                           SFGAO_CANMOVE |           /*0x00000002 */
400                           SFGAO_CANLINK |           /*0x00000004 */
401                           SFGAO_CANRENAME |         /*0x00000010 */
402                           SFGAO_CANDELETE |         /*0x00000020 */
403                           SFGAO_HASPROPSHEET |      /*0x00000040 */
404                           SFGAO_DROPTARGET |        /*0x00000100 */
405                           SFGAO_LINK |              /*0x00010000 */
406                           SFGAO_READONLY |          /*0x00040000 */
407                           SFGAO_HIDDEN |            /*0x00080000 */
408                           SFGAO_FILESYSANCESTOR |   /*0x10000000 */
409                           SFGAO_FOLDER |            /*0x20000000 */
410                           SFGAO_FILESYSTEM |        /*0x40000000 */
411                           SFGAO_HASSUBFOLDER;       /*0x80000000 */
412     
413     TRACE ("0x%08x\n", *pdwAttributes);
414
415     if (*pdwAttributes & ~dwSupportedAttr)
416     {
417         WARN ("attributes 0x%08x not implemented\n", (*pdwAttributes & ~dwSupportedAttr));
418         *pdwAttributes &= dwSupportedAttr;
419     }
420
421     has_guid = _ILGetGUIDPointer(pidl) != NULL;
422
423     dwAttributes = *pdwAttributes;
424
425     if (_ILIsDrive (pidl)) {
426         *pdwAttributes &= SFGAO_HASSUBFOLDER|SFGAO_FILESYSTEM|SFGAO_FOLDER|SFGAO_FILESYSANCESTOR|
427             SFGAO_DROPTARGET|SFGAO_HASPROPSHEET|SFGAO_CANLINK;
428     } else if (has_guid && HCR_GetFolderAttributes(pidl, &dwAttributes)) {
429         *pdwAttributes = dwAttributes;
430     } else if (_ILGetDataPointer (pidl)) {
431         dwAttributes = _ILGetFileAttributes (pidl, NULL, 0);
432
433         if (!dwAttributes && has_guid) {
434             WCHAR path[MAX_PATH];
435             STRRET strret;
436
437             /* File attributes are not present in the internal PIDL structure, so get them from the file system. */
438
439             HRESULT hr = IShellFolder_GetDisplayNameOf(psf, pidl, SHGDN_FORPARSING, &strret);
440
441             if (SUCCEEDED(hr)) {
442                 hr = StrRetToBufW(&strret, pidl, path, MAX_PATH);
443
444                 /* call GetFileAttributes() only for file system paths, not for parsing names like "::{...}" */
445                 if (SUCCEEDED(hr) && path[0]!=':')
446                     dwAttributes = GetFileAttributesW(path);
447             }
448         }
449
450         /* Set common attributes */
451         *pdwAttributes |= SFGAO_FILESYSTEM | SFGAO_DROPTARGET | SFGAO_HASPROPSHEET | SFGAO_CANDELETE | 
452                           SFGAO_CANRENAME | SFGAO_CANLINK | SFGAO_CANMOVE | SFGAO_CANCOPY;
453
454         if (dwAttributes & FILE_ATTRIBUTE_DIRECTORY)
455             *pdwAttributes |=  (SFGAO_FOLDER | SFGAO_HASSUBFOLDER | SFGAO_FILESYSANCESTOR);
456         else
457             *pdwAttributes &= ~(SFGAO_FOLDER | SFGAO_HASSUBFOLDER | SFGAO_FILESYSANCESTOR);
458
459         if (dwAttributes & FILE_ATTRIBUTE_HIDDEN)
460             *pdwAttributes |=  SFGAO_HIDDEN;
461         else
462             *pdwAttributes &= ~SFGAO_HIDDEN;
463
464         if (dwAttributes & FILE_ATTRIBUTE_READONLY)
465             *pdwAttributes |=  SFGAO_READONLY;
466         else
467             *pdwAttributes &= ~SFGAO_READONLY;
468
469         if (SFGAO_LINK & *pdwAttributes) {
470             char ext[MAX_PATH];
471
472             if (!_ILGetExtension(pidl, ext, MAX_PATH) || lstrcmpiA(ext, "lnk"))
473                 *pdwAttributes &= ~SFGAO_LINK;
474         }
475     } else {
476         *pdwAttributes &= SFGAO_HASSUBFOLDER|SFGAO_FOLDER|SFGAO_FILESYSANCESTOR|SFGAO_DROPTARGET|SFGAO_HASPROPSHEET|SFGAO_CANRENAME|SFGAO_CANLINK;
477     }
478     TRACE ("-- 0x%08x\n", *pdwAttributes);
479     return S_OK;
480 }
481
482 /***********************************************************************
483  *  SHELL32_CompareIDs
484  */
485 HRESULT SHELL32_CompareIDs (IShellFolder * iface, LPARAM lParam, LPCITEMIDLIST pidl1, LPCITEMIDLIST pidl2)
486 {
487     int type1,
488       type2;
489     char szTemp1[MAX_PATH];
490     char szTemp2[MAX_PATH];
491     HRESULT nReturn;
492     LPITEMIDLIST firstpidl,
493       nextpidl1,
494       nextpidl2;
495     IShellFolder *psf;
496
497     /* test for empty pidls */
498     BOOL isEmpty1 = _ILIsDesktop (pidl1);
499     BOOL isEmpty2 = _ILIsDesktop (pidl2);
500
501     if (isEmpty1 && isEmpty2)
502         return MAKE_HRESULT( SEVERITY_SUCCESS, 0, 0 );
503     if (isEmpty1)
504         return MAKE_HRESULT( SEVERITY_SUCCESS, 0, (WORD)-1 );
505     if (isEmpty2)
506         return MAKE_HRESULT( SEVERITY_SUCCESS, 0, 1 );
507
508     /* test for different types. Sort order is the PT_* constant */
509     type1 = _ILGetDataPointer (pidl1)->type;
510     type2 = _ILGetDataPointer (pidl2)->type;
511     if (type1 < type2)
512         return MAKE_HRESULT( SEVERITY_SUCCESS, 0, (WORD)-1 );
513     else if (type1 > type2)
514         return MAKE_HRESULT( SEVERITY_SUCCESS, 0, 1 );
515
516     /* test for name of pidl */
517     _ILSimpleGetText (pidl1, szTemp1, MAX_PATH);
518     _ILSimpleGetText (pidl2, szTemp2, MAX_PATH);
519     nReturn = lstrcmpiA (szTemp1, szTemp2);
520     if (nReturn < 0)
521         return MAKE_HRESULT( SEVERITY_SUCCESS, 0, (WORD)-1 );
522     else if (nReturn > 0)
523         return MAKE_HRESULT( SEVERITY_SUCCESS, 0, 1 );
524
525     /* test of complex pidls */
526     firstpidl = ILCloneFirst (pidl1);
527     nextpidl1 = ILGetNext (pidl1);
528     nextpidl2 = ILGetNext (pidl2);
529
530     /* optimizing: test special cases and bind not deeper */
531     /* the deeper shellfolder would do the same */
532     isEmpty1 = _ILIsDesktop (nextpidl1);
533     isEmpty2 = _ILIsDesktop (nextpidl2);
534
535     if (isEmpty1 && isEmpty2) {
536         return MAKE_HRESULT( SEVERITY_SUCCESS, 0, 0 );
537     } else if (isEmpty1) {
538         return MAKE_HRESULT( SEVERITY_SUCCESS, 0, (WORD)-1 );
539     } else if (isEmpty2) {
540         return MAKE_HRESULT( SEVERITY_SUCCESS, 0, 1 );
541     /* optimizing end */
542     } else if (SUCCEEDED (IShellFolder_BindToObject (iface, firstpidl, NULL, &IID_IShellFolder, (LPVOID *) & psf))) {
543         nReturn = IShellFolder_CompareIDs (psf, lParam, nextpidl1, nextpidl2);
544         IShellFolder_Release (psf);
545     }
546     ILFree (firstpidl);
547     return nReturn;
548 }
549
550 HRESULT SHELL32_GetColumnDetails(const shvheader *data, int column, SHELLDETAILS *details)
551 {
552     details->fmt = data[column].fmt;
553     details->cxChar = data[column].cxChar;
554
555     if (SHELL_OsIsUnicode())
556     {
557         details->str.u.pOleStr = CoTaskMemAlloc(MAX_PATH * sizeof(WCHAR));
558         if (!details->str.u.pOleStr) return E_OUTOFMEMORY;
559
560         details->str.uType = STRRET_WSTR;
561         LoadStringW(shell32_hInstance, data[column].colnameid, details->str.u.pOleStr, MAX_PATH);
562     }
563     else
564     {
565         details->str.uType = STRRET_CSTR;
566         LoadStringA(shell32_hInstance, data[column].colnameid, details->str.u.cStr, MAX_PATH);
567     }
568
569     return S_OK;
570 }
571
572 /***********************************************************************
573  *  SHCreateLinks
574  *
575  *   Undocumented.
576  */
577 HRESULT WINAPI SHCreateLinks( HWND hWnd, LPCSTR lpszDir, LPDATAOBJECT lpDataObject,
578                               UINT uFlags, LPITEMIDLIST *lppidlLinks)
579 {
580     FIXME("%p %s %p %08x %p\n",hWnd,lpszDir,lpDataObject,uFlags,lppidlLinks);
581     return E_NOTIMPL;
582 }
583
584 /***********************************************************************
585  *  SHOpenFolderAndSelectItems
586  *
587  *   Added in XP.
588  */
589 HRESULT WINAPI SHOpenFolderAndSelectItems( PCIDLIST_ABSOLUTE pidlFolder, UINT cidl,
590                               PCUITEMID_CHILD_ARRAY *apidl, DWORD flags )
591 {
592     FIXME("%p %u %p 0x%x: stub\n", pidlFolder, cidl, apidl, flags);
593     return E_NOTIMPL;
594 }