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., 59 Temple Place, Suite 330, Boston, MA  02111-1307  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
  34 #include "winerror.h"
  35 #include "windef.h"
  36 #include "winbase.h"
  37 #include "winreg.h"
  38 #include "wingdi.h"
  39 #include "winuser.h"
  40
  41 #include "ole2.h"
  42 #include "shlguid.h"
  43
  44 #include "pidl.h"
  45 #include "undocshell.h"
  46 #include "shell32_main.h"
  47 #include "shlwapi.h"
  48 #include "wine/debug.h"
  49 #include "shfldr.h"
  50
  51 WINE_DEFAULT_DEBUG_CHANNEL (shell);
  52
  53 static const WCHAR wszDotShellClassInfo[] = {
  54     '.','S','h','e','l','l','C','l','a','s','s','I','n','f','o',0};
  55
  56 /***************************************************************************
  57  *  SHELL32_GetCustomFolderAttribute (internal function)
  58  *
  59  * Gets a value from the folder's desktop.ini file, if one exists.
  60  *
  61  * PARAMETERS
  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
  67  *                    by pwszValue.
  68  *
  69  *  RETURNS
  70  *    TRUE if returned non-NULL value.
  71  *    FALSE otherwise.
  72  */
  73 BOOL SHELL32_GetCustomFolderAttribute(
  74     LPCITEMIDLIST pidl, LPCWSTR pwszHeading, LPCWSTR pwszAttribute,
  75     LPWSTR pwszValue, DWORD cchValue)
  76 {
  77     static const WCHAR wszDesktopIni[] =
  78             {'d','e','s','k','t','o','p','.','i','n','i',0};
  79     static const WCHAR wszDefault[] = {0};
  80     DWORD dwAttrib = FILE_ATTRIBUTE_SYSTEM;
  81
  82     /* Hack around not having system attribute on non-Windows file systems */
  83     if (0)
  84         dwAttrib = _ILGetFileAttributes(pidl, NULL, 0);
  85
  86     if (dwAttrib & FILE_ATTRIBUTE_SYSTEM)
  87     {
  88         DWORD ret;
  89         WCHAR wszDesktopIniPath[MAX_PATH];
  90
  91         if (!SHGetPathFromIDListW(pidl, wszDesktopIniPath))
  92             return FALSE;
  93         PathAppendW(wszDesktopIniPath, wszDesktopIni);
  94         ret = GetPrivateProfileStringW(pwszHeading, pwszAttribute,
  95             wszDefault, pwszValue, cchValue, wszDesktopIniPath);
  96         return ret;
  97     }
  98     return FALSE;
  99 }
 100
 101
 102 /***************************************************************************
 103  *  GetNextElement (internal function)
 104  *
 105  * gets a part of a string till the first backslash
 106  *
 107  * PARAMETERS
 108  *  pszNext [IN] string to get the element from
 109  *  pszOut  [IN] pointer to buffer whitch receives string
 110  *  dwOut   [IN] length of pszOut
 111  *
 112  *  RETURNS
 113  *    LPSTR pointer to first, not yet parsed char
 114  */
 115
 116 LPCWSTR GetNextElementW (LPCWSTR pszNext, LPWSTR pszOut, DWORD dwOut)
 117 {
 118     LPCWSTR pszTail = pszNext;
 119     DWORD dwCopy;
 120
 121     TRACE ("(%s %p 0x%08lx)\n", debugstr_w (pszNext), pszOut, dwOut);
 122
 123     *pszOut = 0x0000;
 124
 125     if (!pszNext || !*pszNext)
 126         return NULL;
 127
 128     while (*pszTail && (*pszTail != (WCHAR) '\\'))
 129         pszTail++;
 130
 131     dwCopy = (const WCHAR *) pszTail - (const WCHAR *) pszNext + 1;
 132     lstrcpynW (pszOut, pszNext, (dwOut < dwCopy) ? dwOut : dwCopy);
 133
 134     if (*pszTail)
 135         pszTail++;
 136     else
 137         pszTail = NULL;
 138
 139     TRACE ("--(%s %s 0x%08lx %p)\n", debugstr_w (pszNext), debugstr_w (pszOut), dwOut, pszTail);
 140     return pszTail;
 141 }
 142
 143 HRESULT SHELL32_ParseNextElement (IShellFolder2 * psf, HWND hwndOwner, LPBC pbc,
 144                                   LPITEMIDLIST * pidlInOut, LPOLESTR szNext, DWORD * pEaten, DWORD * pdwAttributes)
 145 {
 146     HRESULT hr = E_INVALIDARG;
 147     LPITEMIDLIST pidlOut = NULL,
 148       pidlTemp = NULL;
 149     IShellFolder *psfChild;
 150
 151     TRACE ("(%p, %p, %p, %s)\n", psf, pbc, pidlInOut ? *pidlInOut : NULL, debugstr_w (szNext));
 152
 153     /* get the shellfolder for the child pidl and let it analyse further */
 154     hr = IShellFolder_BindToObject (psf, *pidlInOut, pbc, &IID_IShellFolder, (LPVOID *) & psfChild);
 155
 156     if (SUCCEEDED(hr)) {
 157         hr = IShellFolder_ParseDisplayName (psfChild, hwndOwner, pbc, szNext, pEaten, &pidlOut, pdwAttributes);
 158         IShellFolder_Release (psfChild);
 159
 160         if (SUCCEEDED(hr)) {
 161             pidlTemp = ILCombine (*pidlInOut, pidlOut);
 162
 163             if (!pidlTemp)
 164                 hr = E_OUTOFMEMORY;
 165         }
 166
 167         if (pidlOut)
 168             ILFree (pidlOut);
 169     }
 170
 171     ILFree (*pidlInOut);
 172     *pidlInOut = pidlTemp;
 173
 174     TRACE ("-- pidl=%p ret=0x%08lx\n", pidlInOut ? *pidlInOut : NULL, hr);
 175     return hr;
 176 }
 177
 178 /***********************************************************************
 179  *      SHELL32_CoCreateInitSF
 180  *
 181  * Creates a shell folder and initializes it with a pidl and a root folder
 182  * via IPersistFolder3 or IPersistFolder.
 183  *
 184  * NOTES
 185  *   pathRoot can be NULL for Folders beeing a drive.
 186  *   In this case the absolute path is build from pidlChild (eg. C:)
 187  */
 188 HRESULT SHELL32_CoCreateInitSF (LPCITEMIDLIST pidlRoot, LPCSTR pathRoot,
 189     LPCITEMIDLIST pidlChild, REFCLSID clsid, REFIID riid, LPVOID * ppvOut)
 190 {
 191     HRESULT hr;
 192
 193     TRACE ("%p %s %p\n", pidlRoot, pathRoot, pidlChild);
 194
 195     if (SUCCEEDED ((hr = SHCoCreateInstance (NULL, clsid, NULL, riid, ppvOut)))) {
 196         LPITEMIDLIST pidlAbsolute = ILCombine (pidlRoot, pidlChild);
 197         IPersistFolder *pPF;
 198         IPersistFolder3 *ppf;
 199
 200         if (SUCCEEDED (IUnknown_QueryInterface ((IUnknown *) * ppvOut, &IID_IPersistFolder3, (LPVOID *) & ppf))) {
 201             PERSIST_FOLDER_TARGET_INFO ppfti;
 202             char szDestPath[MAX_PATH];
 203
 204             ZeroMemory (&ppfti, sizeof (ppfti));
 205
 206             /* build path */
 207             if (pathRoot) {
 208                 lstrcpyA (szDestPath, pathRoot);
 209                 PathAddBackslashA(szDestPath);          /* FIXME: why have drives a backslash here ? */
 210             } else {
 211                 szDestPath[0] = '\0';
 212             }
 213
 214             if (pidlChild) {
 215                 LPSTR pszChild = _ILGetTextPointer(pidlChild);
 216
 217                 if (pszChild)
 218                     lstrcatA (szDestPath, pszChild);
 219                 else
 220                     hr = E_INVALIDARG;
 221             }
 222
 223             /* fill the PERSIST_FOLDER_TARGET_INFO */
 224             ppfti.dwAttributes = -1;
 225             ppfti.csidl = -1;
 226             MultiByteToWideChar (CP_ACP, 0, szDestPath, -1, ppfti.szTargetParsingName, MAX_PATH);
 227
 228             IPersistFolder3_InitializeEx (ppf, NULL, pidlAbsolute, &ppfti);
 229             IPersistFolder3_Release (ppf);
 230         }
 231         else if (SUCCEEDED ((hr = IUnknown_QueryInterface ((IUnknown *) * ppvOut, &IID_IPersistFolder, (LPVOID *) & pPF)))) {
 232             IPersistFolder_Initialize (pPF, pidlAbsolute);
 233             IPersistFolder_Release (pPF);
 234         }
 235         ILFree (pidlAbsolute);
 236     }
 237     TRACE ("-- (%p) ret=0x%08lx\n", *ppvOut, hr);
 238     return hr;
 239 }
 240
 241 /***********************************************************************
 242  *      SHELL32_BindToChild [Internal]
 243  *
 244  * Common code for IShellFolder_BindToObject.
 245  *
 246  * PARAMS
 247  *  pidlRoot     [I] The parent shell folder's absolute pidl.
 248  *  pathRoot     [I] Absolute dos path of the parent shell folder.
 249  *  pidlComplete [I] PIDL of the child. Relative to pidlRoot.
 250  *  riid         [I] GUID of the interface, which ppvOut shall be bound to.
 251  *  ppvOut       [O] A reference to the child's interface (riid).
 252  *
 253  * NOTES
 254  *  pidlComplete has to contain at least one non empty SHITEMID.
 255  *  This function makes special assumptions on the shell namespace, which
 256  *  means you probably can't use it for your IShellFolder implementation.
 257  */
 258 HRESULT SHELL32_BindToChild (LPCITEMIDLIST pidlRoot,
 259                              LPCSTR pathRoot, LPCITEMIDLIST pidlComplete, REFIID riid, LPVOID * ppvOut)
 260 {
 261     GUID const *clsid;
 262     IShellFolder *pSF;
 263     HRESULT hr;
 264     LPITEMIDLIST pidlChild;
 265
 266     if (!pidlRoot || !ppvOut || !pidlComplete || !pidlComplete->mkid.cb)
 267         return E_INVALIDARG;
 268
 269     *ppvOut = NULL;
 270
 271     pidlChild = ILCloneFirst (pidlComplete);
 272
 273     if ((clsid = _ILGetGUIDPointer (pidlChild))) {
 274         /* virtual folder */
 275         hr = SHELL32_CoCreateInitSF (pidlRoot, pathRoot, pidlChild, clsid, &IID_IShellFolder, (LPVOID *) & pSF);
 276     } else {
 277         /* file system folder */
 278         CLSID clsidFolder = CLSID_ShellFSFolder;
 279         static const WCHAR wszCLSID[] = {'C','L','S','I','D',0};
 280         WCHAR wszCLSIDValue[CHARS_IN_GUID];
 281         LPITEMIDLIST pidlAbsolute = ILCombine (pidlRoot, pidlChild);
 282         /* see if folder CLSID should be overridden by desktop.ini file */
 283         if (SHELL32_GetCustomFolderAttribute (pidlAbsolute,
 284             wszDotShellClassInfo, wszCLSID, wszCLSIDValue, CHARS_IN_GUID))
 285             CLSIDFromString (wszCLSIDValue, &clsidFolder);
 286         ILFree (pidlAbsolute);
 287         hr = SHELL32_CoCreateInitSF (pidlRoot, pathRoot, pidlChild,
 288             &clsidFolder, &IID_IShellFolder, (LPVOID *)&pSF);
 289     }
 290     ILFree (pidlChild);
 291
 292     if (SUCCEEDED (hr)) {
 293         if (_ILIsPidlSimple (pidlComplete)) {
 294             /* no sub folders */
 295             hr = IShellFolder_QueryInterface (pSF, riid, ppvOut);
 296         } else {
 297             /* go deeper */
 298             hr = IShellFolder_BindToObject (pSF, ILGetNext (pidlComplete), NULL, riid, ppvOut);
 299         }
 300         IShellFolder_Release (pSF);
 301     }
 302
 303     TRACE ("-- returning (%p) %08lx\n", *ppvOut, hr);
 304
 305     return hr;
 306 }
 307
 308 /***********************************************************************
 309  *      SHELL32_GetDisplayNameOfChild
 310  *
 311  * Retrives the display name of a child object of a shellfolder.
 312  *
 313  * For a pidl eg. [subpidl1][subpidl2][subpidl3]:
 314  * - it binds to the child shellfolder [subpidl1]
 315  * - asks it for the displayname of [subpidl2][subpidl3]
 316  *
 317  * Is possible the pidl is a simple pidl. In this case it asks the
 318  * subfolder for the displayname of an empty pidl. The subfolder
 319  * returns the own displayname eg. "::{guid}". This is used for
 320  * virtual folders with the registry key WantsFORPARSING set.
 321  */
 322 HRESULT SHELL32_GetDisplayNameOfChild (IShellFolder2 * psf,
 323                                        LPCITEMIDLIST pidl, DWORD dwFlags, LPSTR szOut, DWORD dwOutLen)
 324 {
 325     LPITEMIDLIST pidlFirst;
 326     HRESULT hr = E_INVALIDARG;
 327
 328     TRACE ("(%p)->(pidl=%p 0x%08lx %p 0x%08lx)\n", psf, pidl, dwFlags, szOut, dwOutLen);
 329     pdump (pidl);
 330
 331     pidlFirst = ILCloneFirst (pidl);
 332     if (pidlFirst) {
 333         IShellFolder2 *psfChild;
 334
 335         hr = IShellFolder_BindToObject (psf, pidlFirst, NULL, &IID_IShellFolder, (LPVOID *) & psfChild);
 336         if (SUCCEEDED (hr)) {
 337             STRRET strTemp;
 338             LPITEMIDLIST pidlNext = ILGetNext (pidl);
 339
 340             hr = IShellFolder_GetDisplayNameOf (psfChild, pidlNext, dwFlags, &strTemp);
 341             if (SUCCEEDED (hr)) {
 342                 hr = StrRetToStrNA (szOut, dwOutLen, &strTemp, pidlNext);
 343             }
 344             IShellFolder_Release (psfChild);
 345         }
 346         ILFree (pidlFirst);
 347     } else
 348         hr = E_OUTOFMEMORY;
 349
 350     TRACE ("-- ret=0x%08lx %s\n", hr, szOut);
 351
 352     return hr;
 353 }
 354
 355 /***********************************************************************
 356  *  SHELL32_GetItemAttributes
 357  *
 358  * NOTES
 359  * observerd values:
 360  *  folder:     0xE0000177      FILESYSTEM | HASSUBFOLDER | FOLDER
 361  *  file:       0x40000177      FILESYSTEM
 362  *  drive:      0xf0000144      FILESYSTEM | HASSUBFOLDER | FOLDER | FILESYSANCESTOR
 363  *  mycomputer: 0xb0000154      HASSUBFOLDER | FOLDER | FILESYSANCESTOR
 364  *  (seems to be default for shell extensions if no registry entry exists)
 365  *
 366  * win2k:
 367  *  folder:    0xF0400177      FILESYSTEM | HASSUBFOLDER | FOLDER | FILESYSANCESTOR | CANMONIKER
 368  *  file:      0x40400177      FILESYSTEM | CANMONIKER
 369  *  drive      0xF0400154      FILESYSTEM | HASSUBFOLDER | FOLDER | FILESYSANCESTOR | CANMONIKER | CANRENAME (LABEL)
 370  *
 371  * This function does not set flags!! It only resets flags when necessary.
 372  */
 373 HRESULT SHELL32_GetItemAttributes (IShellFolder * psf, LPCITEMIDLIST pidl, LPDWORD pdwAttributes)
 374 {
 375     DWORD dwAttributes;
 376     static const DWORD dwSupportedAttr=
 377                           SFGAO_CANCOPY |           /*0x00000001 */
 378                           SFGAO_CANMOVE |           /*0x00000002 */
 379                           SFGAO_CANLINK |           /*0x00000004 */
 380                           SFGAO_CANRENAME |         /*0x00000010 */
 381                           SFGAO_CANDELETE |         /*0x00000020 */
 382                           SFGAO_HASPROPSHEET |      /*0x00000040 */
 383                           SFGAO_DROPTARGET |        /*0x00000100 */
 384                           SFGAO_LINK |              /*0x00010000 */
 385                           SFGAO_READONLY |          /*0x00040000 */
 386                           SFGAO_HIDDEN |            /*0x00080000 */
 387                           SFGAO_FILESYSANCESTOR |   /*0x10000000 */
 388                           SFGAO_FOLDER |            /*0x20000000 */
 389                           SFGAO_FILESYSTEM |        /*0x40000000 */
 390                           SFGAO_HASSUBFOLDER;       /*0x80000000 */
 391
 392     TRACE ("0x%08lx\n", *pdwAttributes);
 393
 394     if (*pdwAttributes & ~dwSupportedAttr)
 395     {
 396         WARN ("attributes 0x%08lx not implemented\n", (*pdwAttributes & ~dwSupportedAttr));
 397         *pdwAttributes &= dwSupportedAttr;
 398     }
 399
 400     if (_ILIsDrive (pidl)) {
 401         *pdwAttributes &= SFGAO_HASSUBFOLDER|SFGAO_FILESYSTEM|SFGAO_FOLDER|SFGAO_FILESYSANCESTOR|
 402             SFGAO_DROPTARGET|SFGAO_HASPROPSHEET|SFGAO_CANLINK;
 403     } else if (_ILGetGUIDPointer (pidl)) {
 404         if (!HCR_GetFolderAttributes (pidl, pdwAttributes)) {
 405             *pdwAttributes &= SFGAO_HASSUBFOLDER|SFGAO_FOLDER|SFGAO_FILESYSANCESTOR|
 406                 SFGAO_DROPTARGET|SFGAO_HASPROPSHEET|SFGAO_CANRENAME|SFGAO_CANLINK;
 407         }
 408     } else if (_ILGetDataPointer (pidl)) {
 409         dwAttributes = _ILGetFileAttributes (pidl, NULL, 0);
 410
 411         if ((SFGAO_FILESYSANCESTOR & *pdwAttributes) && !(dwAttributes & FILE_ATTRIBUTE_DIRECTORY))
 412             *pdwAttributes &= ~SFGAO_FILESYSANCESTOR;
 413
 414         if ((SFGAO_FOLDER & *pdwAttributes) && !(dwAttributes & FILE_ATTRIBUTE_DIRECTORY))
 415             *pdwAttributes &= ~(SFGAO_FOLDER | SFGAO_HASSUBFOLDER);
 416
 417         if ((SFGAO_HIDDEN & *pdwAttributes) && !(dwAttributes & FILE_ATTRIBUTE_HIDDEN))
 418             *pdwAttributes &= ~SFGAO_HIDDEN;
 419
 420         if ((SFGAO_READONLY & *pdwAttributes) && !(dwAttributes & FILE_ATTRIBUTE_READONLY))
 421             *pdwAttributes &= ~SFGAO_READONLY;
 422
 423         if (SFGAO_LINK & *pdwAttributes) {
 424             char ext[MAX_PATH];
 425
 426             if (!_ILGetExtension(pidl, ext, MAX_PATH) || lstrcmpiA(ext, "lnk"))
 427                 *pdwAttributes &= ~SFGAO_LINK;
 428         }
 429
 430         if (SFGAO_HASSUBFOLDER & *pdwAttributes)
 431         {
 432             IShellFolder *psf2;
 433             if (SUCCEEDED(IShellFolder_BindToObject(psf, pidl, 0, (REFIID)&IID_IShellFolder, (LPVOID *)&psf2)))
 434             {
 435                 IEnumIDList     *pEnumIL = NULL;
 436                 if (SUCCEEDED(IShellFolder_EnumObjects(psf2, 0, SHCONTF_FOLDERS, &pEnumIL)))
 437                 {
 438                     if (IEnumIDList_Skip(pEnumIL, 1) != S_OK)
 439                         *pdwAttributes &= ~SFGAO_HASSUBFOLDER;
 440                     IEnumIDList_Release(pEnumIL);
 441                 }
 442                 IShellFolder_Release(psf2);
 443             }
 444         }
 445     } else {
 446         *pdwAttributes &= SFGAO_HASSUBFOLDER|SFGAO_FOLDER|SFGAO_FILESYSANCESTOR|SFGAO_DROPTARGET|SFGAO_HASPROPSHEET|SFGAO_CANRENAME|SFGAO_CANLINK;
 447     }
 448     TRACE ("-- 0x%08lx\n", *pdwAttributes);
 449     return S_OK;
 450 }
 451
 452 /***********************************************************************
 453  *  SHELL32_CompareIDs
 454  */
 455 HRESULT SHELL32_CompareIDs (IShellFolder * iface, LPARAM lParam, LPCITEMIDLIST pidl1, LPCITEMIDLIST pidl2)
 456 {
 457     int type1,
 458       type2;
 459     char szTemp1[MAX_PATH];
 460     char szTemp2[MAX_PATH];
 461     HRESULT nReturn;
 462     LPITEMIDLIST firstpidl,
 463       nextpidl1,
 464       nextpidl2;
 465     IShellFolder *psf;
 466
 467     /* test for empty pidls */
 468     BOOL isEmpty1 = _ILIsDesktop (pidl1);
 469     BOOL isEmpty2 = _ILIsDesktop (pidl2);
 470
 471     if (isEmpty1 && isEmpty2)
 472         return MAKE_HRESULT( SEVERITY_SUCCESS, 0, 0 );
 473     if (isEmpty1)
 474         return MAKE_HRESULT( SEVERITY_SUCCESS, 0, (WORD)-1 );
 475     if (isEmpty2)
 476         return MAKE_HRESULT( SEVERITY_SUCCESS, 0, 1 );
 477
 478     /* test for different types. Sort order is the PT_* constant */
 479     type1 = _ILGetDataPointer (pidl1)->type;
 480     type2 = _ILGetDataPointer (pidl2)->type;
 481     if (type1 < type2)
 482         return MAKE_HRESULT( SEVERITY_SUCCESS, 0, (WORD)-1 );
 483     else if (type1 > type2)
 484         return MAKE_HRESULT( SEVERITY_SUCCESS, 0, 1 );
 485
 486     /* test for name of pidl */
 487     _ILSimpleGetText (pidl1, szTemp1, MAX_PATH);
 488     _ILSimpleGetText (pidl2, szTemp2, MAX_PATH);
 489     nReturn = lstrcmpiA (szTemp1, szTemp2);
 490     if (nReturn < 0)
 491         return MAKE_HRESULT( SEVERITY_SUCCESS, 0, (WORD)-1 );
 492     else if (nReturn > 0)
 493         return MAKE_HRESULT( SEVERITY_SUCCESS, 0, 1 );
 494
 495     /* test of complex pidls */
 496     firstpidl = ILCloneFirst (pidl1);
 497     nextpidl1 = ILGetNext (pidl1);
 498     nextpidl2 = ILGetNext (pidl2);
 499
 500     /* optimizing: test special cases and bind not deeper */
 501     /* the deeper shellfolder would do the same */
 502     isEmpty1 = _ILIsDesktop (nextpidl1);
 503     isEmpty2 = _ILIsDesktop (nextpidl2);
 504
 505     if (isEmpty1 && isEmpty2) {
 506         return MAKE_HRESULT( SEVERITY_SUCCESS, 0, 0 );
 507     } else if (isEmpty1) {
 508         return MAKE_HRESULT( SEVERITY_SUCCESS, 0, (WORD)-1 );
 509     } else if (isEmpty2) {
 510         return MAKE_HRESULT( SEVERITY_SUCCESS, 0, 1 );
 511     /* optimizing end */
 512     } else if (SUCCEEDED (IShellFolder_BindToObject (iface, firstpidl, NULL, &IID_IShellFolder, (LPVOID *) & psf))) {
 513         nReturn = IShellFolder_CompareIDs (psf, lParam, nextpidl1, nextpidl2);
 514         IShellFolder_Release (psf);
 515     }
 516     ILFree (firstpidl);
 517     return nReturn;
 518 }
 519
 520 /***********************************************************************
 521  *  SHCreateLinks
 522  *
 523  *   Undocumented.
 524  */
 525 HRESULT WINAPI SHCreateLinks( HWND hWnd, LPCSTR lpszDir, LPDATAOBJECT lpDataObject,
 526                               UINT uFlags, LPITEMIDLIST *lppidlLinks)
 527 {
 528     FIXME("%p %s %p %08x %p\n",hWnd,lpszDir,lpDataObject,uFlags,lppidlLinks);
 529     return E_NOTIMPL;
 530 }