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