git.oblomov.eu Git - wine/blob - dlls/shell32/tests/shellpath.c

   1 /*
   2  * Unit tests for shell32 SHGet{Special}Folder{Path|Location} functions.
   3  *
   4  * Copyright 2004 Juan Lang
   5  *
   6  * This library is free software; you can redistribute it and/or
   7  * modify it under the terms of the GNU Lesser General Public
   8  * License as published by the Free Software Foundation; either
   9  * version 2.1 of the License, or (at your option) any later version.
  10  *
  11  * This library is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14  * Lesser General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Lesser General Public
  17  * License along with this library; if not, write to the Free Software
  18  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
  19  * This is a test program for the SHGet{Special}Folder{Path|Location} functions
  20  * of shell32, that get either a filesystem path or a LPITEMIDLIST (shell
  21  * namespace) path for a given folder (CSIDL value).
  22  */
  23
  24 #define COBJMACROS
  25
  26 #include <stdarg.h>
  27 #include <stdio.h>
  28 #include "windef.h"
  29 #include "winbase.h"
  30 #include "shlguid.h"
  31 #include "shlobj.h"
  32 #include "shlwapi.h"
  33 #include "knownfolders.h"
  34 #include "wine/test.h"
  35
  36 #include "initguid.h"
  37
  38 /* CSIDL_MYDOCUMENTS is now the same as CSIDL_PERSONAL, but what we want
  39  * here is its original value.
  40  */
  41 #define OLD_CSIDL_MYDOCUMENTS  0x000c
  42
  43 DEFINE_GUID(GUID_NULL,0,0,0,0,0,0,0,0,0,0,0);
  44
  45 #ifndef ARRAY_SIZE
  46 #define ARRAY_SIZE(x) ( sizeof(x) / sizeof((x)[0]) )
  47 #endif
  48
  49 /* from pidl.h, not included here: */
  50 #ifndef PT_CPL             /* Guess, Win7 uses this for CSIDL_CONTROLS */
  51 #define PT_CPL        0x01 /* no path */
  52 #endif
  53 #ifndef PT_GUID
  54 #define PT_GUID       0x1f /* no path */
  55 #endif
  56 #ifndef PT_DRIVE
  57 #define PT_DRIVE      0x23 /* has path */
  58 #endif
  59 #ifndef PT_DRIVE2
  60 #define PT_DRIVE2     0x25 /* has path */
  61 #endif
  62 #ifndef PT_SHELLEXT
  63 #define PT_SHELLEXT   0x2e /* no path */
  64 #endif
  65 #ifndef PT_FOLDER
  66 #define PT_FOLDER     0x31 /* has path */
  67 #endif
  68 #ifndef PT_FOLDERW
  69 #define PT_FOLDERW    0x35 /* has path */
  70 #endif
  71 #ifndef PT_WORKGRP
  72 #define PT_WORKGRP    0x41 /* no path */
  73 #endif
  74 #ifndef PT_YAGUID
  75 #define PT_YAGUID     0x70 /* no path */
  76 #endif
  77 /* FIXME: this is used for history/favorites folders; what's a better name? */
  78 #ifndef PT_IESPECIAL2
  79 #define PT_IESPECIAL2 0xb1 /* has path */
  80 #endif
  81
  82 static GUID CLSID_CommonDocuments = { 0x0000000c, 0x0000, 0x0000, { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x74, 0x1a } };
  83
  84 struct shellExpectedValues {
  85     int folder;
  86     int numTypes;
  87     const BYTE *types;
  88 };
  89
  90 static HRESULT (WINAPI *pDllGetVersion)(DLLVERSIONINFO *);
  91 static HRESULT (WINAPI *pSHGetFolderPathA)(HWND, int, HANDLE, DWORD, LPSTR);
  92 static HRESULT (WINAPI *pSHGetFolderLocation)(HWND, int, HANDLE, DWORD,
  93  LPITEMIDLIST *);
  94 static BOOL    (WINAPI *pSHGetSpecialFolderPathA)(HWND, LPSTR, int, BOOL);
  95 static HRESULT (WINAPI *pSHGetSpecialFolderLocation)(HWND, int, LPITEMIDLIST *);
  96 static LPITEMIDLIST (WINAPI *pILFindLastID)(LPCITEMIDLIST);
  97 static int (WINAPI *pSHFileOperationA)(LPSHFILEOPSTRUCTA);
  98 static HRESULT (WINAPI *pSHGetMalloc)(LPMALLOC *);
  99 static UINT (WINAPI *pGetSystemWow64DirectoryA)(LPSTR,UINT);
 100 static HRESULT (WINAPI *pSHGetKnownFolderPath)(REFKNOWNFOLDERID, DWORD, HANDLE, PWSTR *);
 101 static HRESULT (WINAPI *pSHSetKnownFolderPath)(REFKNOWNFOLDERID, DWORD, HANDLE, PWSTR);
 102 static HRESULT (WINAPI *pSHGetFolderPathEx)(REFKNOWNFOLDERID, DWORD, HANDLE, LPWSTR, DWORD);
 103
 104 static DLLVERSIONINFO shellVersion = { 0 };
 105 static LPMALLOC pMalloc;
 106 static const BYTE guidType[] = { PT_GUID };
 107 static const BYTE controlPanelType[] = { PT_SHELLEXT, PT_GUID, PT_CPL };
 108 static const BYTE folderType[] = { PT_FOLDER, PT_FOLDERW };
 109 static const BYTE favoritesType[] = { PT_FOLDER, PT_FOLDERW, 0, PT_IESPECIAL2 /* Win98 */ };
 110 static const BYTE folderOrSpecialType[] = { PT_FOLDER, PT_IESPECIAL2 };
 111 static const BYTE personalType[] = { PT_FOLDER, PT_GUID, PT_DRIVE, 0xff /* Win9x */,
 112  PT_IESPECIAL2 /* Win98 */, 0 /* Vista */ };
 113 /* FIXME: don't know the type of 0x71 returned by Vista/2008 for printers */
 114 static const BYTE printersType[] = { PT_YAGUID, PT_SHELLEXT, 0x71 };
 115 static const BYTE ieSpecialType[] = { PT_IESPECIAL2 };
 116 static const BYTE shellExtType[] = { PT_SHELLEXT };
 117 static const BYTE workgroupType[] = { PT_WORKGRP };
 118 #define DECLARE_TYPE(x, y) { x, sizeof(y) / sizeof(y[0]), y }
 119 static const struct shellExpectedValues requiredShellValues[] = {
 120  DECLARE_TYPE(CSIDL_BITBUCKET, guidType),
 121  DECLARE_TYPE(CSIDL_CONTROLS, controlPanelType),
 122  DECLARE_TYPE(CSIDL_COOKIES, folderType),
 123  DECLARE_TYPE(CSIDL_DESKTOPDIRECTORY, folderType),
 124  DECLARE_TYPE(CSIDL_DRIVES, guidType),
 125  DECLARE_TYPE(CSIDL_FAVORITES, favoritesType),
 126  DECLARE_TYPE(CSIDL_FONTS, folderOrSpecialType),
 127 /* FIXME: the following fails in Wine, returns type PT_FOLDER
 128  DECLARE_TYPE(CSIDL_HISTORY, ieSpecialType),
 129  */
 130  DECLARE_TYPE(CSIDL_INTERNET, guidType),
 131  DECLARE_TYPE(CSIDL_NETHOOD, folderType),
 132  DECLARE_TYPE(CSIDL_NETWORK, guidType),
 133  DECLARE_TYPE(CSIDL_PERSONAL, personalType),
 134  DECLARE_TYPE(CSIDL_PRINTERS, printersType),
 135  DECLARE_TYPE(CSIDL_PRINTHOOD, folderType),
 136  DECLARE_TYPE(CSIDL_PROGRAMS, folderType),
 137  DECLARE_TYPE(CSIDL_RECENT, folderOrSpecialType),
 138  DECLARE_TYPE(CSIDL_SENDTO, folderType),
 139  DECLARE_TYPE(CSIDL_STARTMENU, folderType),
 140  DECLARE_TYPE(CSIDL_STARTUP, folderType),
 141  DECLARE_TYPE(CSIDL_TEMPLATES, folderType),
 142 };
 143 static const struct shellExpectedValues optionalShellValues[] = {
 144 /* FIXME: the following only semi-succeed; they return NULL PIDLs on XP.. hmm.
 145  DECLARE_TYPE(CSIDL_ALTSTARTUP, folderType),
 146  DECLARE_TYPE(CSIDL_COMMON_ALTSTARTUP, folderType),
 147  DECLARE_TYPE(CSIDL_COMMON_OEM_LINKS, folderType),
 148  */
 149 /* Windows NT-only: */
 150  DECLARE_TYPE(CSIDL_COMMON_DESKTOPDIRECTORY, folderType),
 151  DECLARE_TYPE(CSIDL_COMMON_DOCUMENTS, shellExtType),
 152  DECLARE_TYPE(CSIDL_COMMON_FAVORITES, folderType),
 153  DECLARE_TYPE(CSIDL_COMMON_PROGRAMS, folderType),
 154  DECLARE_TYPE(CSIDL_COMMON_STARTMENU, folderType),
 155  DECLARE_TYPE(CSIDL_COMMON_STARTUP, folderType),
 156  DECLARE_TYPE(CSIDL_COMMON_TEMPLATES, folderType),
 157 /* first appearing in shell32 version 4.71: */
 158  DECLARE_TYPE(CSIDL_APPDATA, folderType),
 159 /* first appearing in shell32 version 4.72: */
 160  DECLARE_TYPE(CSIDL_INTERNET_CACHE, ieSpecialType),
 161 /* first appearing in shell32 version 5.0: */
 162  DECLARE_TYPE(CSIDL_ADMINTOOLS, folderType),
 163  DECLARE_TYPE(CSIDL_COMMON_APPDATA, folderType),
 164  DECLARE_TYPE(CSIDL_LOCAL_APPDATA, folderType),
 165  DECLARE_TYPE(OLD_CSIDL_MYDOCUMENTS, folderType),
 166  DECLARE_TYPE(CSIDL_MYMUSIC, folderType),
 167  DECLARE_TYPE(CSIDL_MYPICTURES, folderType),
 168  DECLARE_TYPE(CSIDL_MYVIDEO, folderType),
 169  DECLARE_TYPE(CSIDL_PROFILE, folderType),
 170  DECLARE_TYPE(CSIDL_PROGRAM_FILES, folderType),
 171  DECLARE_TYPE(CSIDL_PROGRAM_FILESX86, folderType),
 172  DECLARE_TYPE(CSIDL_PROGRAM_FILES_COMMON, folderType),
 173  DECLARE_TYPE(CSIDL_PROGRAM_FILES_COMMONX86, folderType),
 174  DECLARE_TYPE(CSIDL_SYSTEM, folderType),
 175  DECLARE_TYPE(CSIDL_WINDOWS, folderType),
 176 /* first appearing in shell32 6.0: */
 177  DECLARE_TYPE(CSIDL_CDBURN_AREA, folderType),
 178  DECLARE_TYPE(CSIDL_COMMON_MUSIC, folderType),
 179  DECLARE_TYPE(CSIDL_COMMON_PICTURES, folderType),
 180  DECLARE_TYPE(CSIDL_COMMON_VIDEO, folderType),
 181  DECLARE_TYPE(CSIDL_COMPUTERSNEARME, workgroupType),
 182  DECLARE_TYPE(CSIDL_RESOURCES, folderType),
 183  DECLARE_TYPE(CSIDL_RESOURCES_LOCALIZED, folderType),
 184 };
 185 #undef DECLARE_TYPE
 186
 187 static void loadShell32(void)
 188 {
 189     HMODULE hShell32 = GetModuleHandleA("shell32");
 190
 191 #define GET_PROC(func) \
 192     p ## func = (void*)GetProcAddress(hShell32, #func); \
 193     if(!p ## func) \
 194       trace("GetProcAddress(%s) failed\n", #func);
 195
 196     GET_PROC(DllGetVersion)
 197     GET_PROC(SHGetFolderPathA)
 198     GET_PROC(SHGetFolderPathEx)
 199     GET_PROC(SHGetFolderLocation)
 200     GET_PROC(SHGetKnownFolderPath)
 201     GET_PROC(SHSetKnownFolderPath)
 202     GET_PROC(SHGetSpecialFolderPathA)
 203     GET_PROC(SHGetSpecialFolderLocation)
 204     GET_PROC(ILFindLastID)
 205     if (!pILFindLastID)
 206         pILFindLastID = (void *)GetProcAddress(hShell32, (LPCSTR)16);
 207     GET_PROC(SHFileOperationA)
 208     GET_PROC(SHGetMalloc)
 209
 210     ok(pSHGetMalloc != NULL, "shell32 is missing SHGetMalloc\n");
 211     if (pSHGetMalloc)
 212     {
 213         HRESULT hr = pSHGetMalloc(&pMalloc);
 214
 215         ok(hr == S_OK, "SHGetMalloc failed: 0x%08x\n", hr);
 216         ok(pMalloc != NULL, "SHGetMalloc returned a NULL IMalloc\n");
 217     }
 218
 219     if (pDllGetVersion)
 220     {
 221         shellVersion.cbSize = sizeof(shellVersion);
 222         pDllGetVersion(&shellVersion);
 223         trace("shell32 version is %d.%d\n",
 224               shellVersion.dwMajorVersion, shellVersion.dwMinorVersion);
 225     }
 226 #undef GET_PROC
 227 }
 228
 229 #ifndef CSIDL_PROFILES
 230 #define CSIDL_PROFILES          0x003e
 231 #endif
 232
 233 /* A couple utility printing functions */
 234 static const char *getFolderName(int folder)
 235 {
 236     static char unknown[32];
 237
 238 #define CSIDL_TO_STR(x) case x: return#x;
 239     switch (folder)
 240     {
 241     CSIDL_TO_STR(CSIDL_DESKTOP);
 242     CSIDL_TO_STR(CSIDL_INTERNET);
 243     CSIDL_TO_STR(CSIDL_PROGRAMS);
 244     CSIDL_TO_STR(CSIDL_CONTROLS);
 245     CSIDL_TO_STR(CSIDL_PRINTERS);
 246     CSIDL_TO_STR(CSIDL_PERSONAL);
 247     CSIDL_TO_STR(CSIDL_FAVORITES);
 248     CSIDL_TO_STR(CSIDL_STARTUP);
 249     CSIDL_TO_STR(CSIDL_RECENT);
 250     CSIDL_TO_STR(CSIDL_SENDTO);
 251     CSIDL_TO_STR(CSIDL_BITBUCKET);
 252     CSIDL_TO_STR(CSIDL_STARTMENU);
 253     CSIDL_TO_STR(OLD_CSIDL_MYDOCUMENTS);
 254     CSIDL_TO_STR(CSIDL_MYMUSIC);
 255     CSIDL_TO_STR(CSIDL_MYVIDEO);
 256     CSIDL_TO_STR(CSIDL_DESKTOPDIRECTORY);
 257     CSIDL_TO_STR(CSIDL_DRIVES);
 258     CSIDL_TO_STR(CSIDL_NETWORK);
 259     CSIDL_TO_STR(CSIDL_NETHOOD);
 260     CSIDL_TO_STR(CSIDL_FONTS);
 261     CSIDL_TO_STR(CSIDL_TEMPLATES);
 262     CSIDL_TO_STR(CSIDL_COMMON_STARTMENU);
 263     CSIDL_TO_STR(CSIDL_COMMON_PROGRAMS);
 264     CSIDL_TO_STR(CSIDL_COMMON_STARTUP);
 265     CSIDL_TO_STR(CSIDL_COMMON_DESKTOPDIRECTORY);
 266     CSIDL_TO_STR(CSIDL_APPDATA);
 267     CSIDL_TO_STR(CSIDL_PRINTHOOD);
 268     CSIDL_TO_STR(CSIDL_LOCAL_APPDATA);
 269     CSIDL_TO_STR(CSIDL_ALTSTARTUP);
 270     CSIDL_TO_STR(CSIDL_COMMON_ALTSTARTUP);
 271     CSIDL_TO_STR(CSIDL_COMMON_FAVORITES);
 272     CSIDL_TO_STR(CSIDL_INTERNET_CACHE);
 273     CSIDL_TO_STR(CSIDL_COOKIES);
 274     CSIDL_TO_STR(CSIDL_HISTORY);
 275     CSIDL_TO_STR(CSIDL_COMMON_APPDATA);
 276     CSIDL_TO_STR(CSIDL_WINDOWS);
 277     CSIDL_TO_STR(CSIDL_SYSTEM);
 278     CSIDL_TO_STR(CSIDL_PROGRAM_FILES);
 279     CSIDL_TO_STR(CSIDL_MYPICTURES);
 280     CSIDL_TO_STR(CSIDL_PROFILE);
 281     CSIDL_TO_STR(CSIDL_SYSTEMX86);
 282     CSIDL_TO_STR(CSIDL_PROGRAM_FILESX86);
 283     CSIDL_TO_STR(CSIDL_PROGRAM_FILES_COMMON);
 284     CSIDL_TO_STR(CSIDL_PROGRAM_FILES_COMMONX86);
 285     CSIDL_TO_STR(CSIDL_COMMON_TEMPLATES);
 286     CSIDL_TO_STR(CSIDL_COMMON_DOCUMENTS);
 287     CSIDL_TO_STR(CSIDL_COMMON_ADMINTOOLS);
 288     CSIDL_TO_STR(CSIDL_ADMINTOOLS);
 289     CSIDL_TO_STR(CSIDL_CONNECTIONS);
 290     CSIDL_TO_STR(CSIDL_PROFILES);
 291     CSIDL_TO_STR(CSIDL_COMMON_MUSIC);
 292     CSIDL_TO_STR(CSIDL_COMMON_PICTURES);
 293     CSIDL_TO_STR(CSIDL_COMMON_VIDEO);
 294     CSIDL_TO_STR(CSIDL_RESOURCES);
 295     CSIDL_TO_STR(CSIDL_RESOURCES_LOCALIZED);
 296     CSIDL_TO_STR(CSIDL_COMMON_OEM_LINKS);
 297     CSIDL_TO_STR(CSIDL_CDBURN_AREA);
 298     CSIDL_TO_STR(CSIDL_COMPUTERSNEARME);
 299 #undef CSIDL_TO_STR
 300     default:
 301         sprintf(unknown, "unknown (0x%04x)", folder);
 302         return unknown;
 303     }
 304 }
 305
 306 static const char *printGUID(const GUID *guid, char * guidSTR)
 307 {
 308     if (!guid) return NULL;
 309
 310     sprintf(guidSTR, "{%08x-%04x-%04x-%02x%02x-%02x%02x%02x%02x%02x%02x}",
 311      guid->Data1, guid->Data2, guid->Data3,
 312      guid->Data4[0], guid->Data4[1], guid->Data4[2], guid->Data4[3],
 313      guid->Data4[4], guid->Data4[5], guid->Data4[6], guid->Data4[7]);
 314     return guidSTR;
 315 }
 316
 317 static void test_parameters(void)
 318 {
 319     LPITEMIDLIST pidl = NULL;
 320     char path[MAX_PATH];
 321     HRESULT hr;
 322
 323     if (pSHGetFolderLocation)
 324     {
 325         /* check a bogus CSIDL: */
 326         pidl = NULL;
 327         hr = pSHGetFolderLocation(NULL, 0xeeee, NULL, 0, &pidl);
 328         ok(hr == E_INVALIDARG, "got 0x%08x, expected E_INVALIDARG\n", hr);
 329         if (hr == S_OK) IMalloc_Free(pMalloc, pidl);
 330
 331         /* check a bogus user token: */
 332         pidl = NULL;
 333         hr = pSHGetFolderLocation(NULL, CSIDL_FAVORITES, (HANDLE)2, 0, &pidl);
 334         ok(hr == E_FAIL || hr == E_HANDLE, "got 0x%08x, expected E_FAIL or E_HANDLE\n", hr);
 335         if (hr == S_OK) IMalloc_Free(pMalloc, pidl);
 336
 337         /* a NULL pidl pointer crashes, so don't test it */
 338     }
 339
 340     if (pSHGetSpecialFolderLocation)
 341     {
 342         if (0)
 343             /* crashes */
 344             SHGetSpecialFolderLocation(NULL, 0, NULL);
 345
 346         hr = pSHGetSpecialFolderLocation(NULL, 0xeeee, &pidl);
 347         ok(hr == E_INVALIDARG, "got returned 0x%08x\n", hr);
 348     }
 349
 350     if (pSHGetFolderPathA)
 351     {
 352         /* expect 2's a bogus handle, especially since we didn't open it */
 353         hr = pSHGetFolderPathA(NULL, CSIDL_DESKTOP, (HANDLE)2, SHGFP_TYPE_DEFAULT, path);
 354         ok(hr == E_FAIL || hr == E_HANDLE || /* Vista and 2k8 */
 355            broken(hr == S_OK), /* W2k and Me */ "got 0x%08x, expected E_FAIL\n", hr);
 356
 357         hr = pSHGetFolderPathA(NULL, 0xeeee, NULL, SHGFP_TYPE_DEFAULT, path);
 358         ok(hr == E_INVALIDARG, "got 0x%08x, expected E_INVALIDARG\n", hr);
 359     }
 360
 361     if (pSHGetSpecialFolderPathA)
 362     {
 363         BOOL ret;
 364
 365         if (0)
 366            pSHGetSpecialFolderPathA(NULL, NULL, CSIDL_BITBUCKET, FALSE);
 367
 368         /* odd but true: calling with a NULL path still succeeds if it's a real
 369          * dir (on some windows platform).  on winME it generates exception.
 370          */
 371         ret = pSHGetSpecialFolderPathA(NULL, path, CSIDL_PROGRAMS, FALSE);
 372         ok(ret, "got %d\n", ret);
 373
 374         ret = pSHGetSpecialFolderPathA(NULL, path, 0xeeee, FALSE);
 375         ok(!ret, "got %d\n", ret);
 376     }
 377 }
 378
 379 /* Returns the folder's PIDL type, or 0xff if one can't be found. */
 380 static BYTE testSHGetFolderLocation(int folder)
 381 {
 382     LPITEMIDLIST pidl;
 383     HRESULT hr;
 384     BYTE ret = 0xff;
 385
 386     /* treat absence of function as success */
 387     if (!pSHGetFolderLocation) return TRUE;
 388
 389     pidl = NULL;
 390     hr = pSHGetFolderLocation(NULL, folder, NULL, 0, &pidl);
 391     if (hr == S_OK)
 392     {
 393         if (pidl)
 394         {
 395             LPITEMIDLIST pidlLast = pILFindLastID(pidl);
 396
 397             ok(pidlLast != NULL, "%s: ILFindLastID failed\n",
 398              getFolderName(folder));
 399             if (pidlLast)
 400                 ret = pidlLast->mkid.abID[0];
 401             IMalloc_Free(pMalloc, pidl);
 402         }
 403     }
 404     return ret;
 405 }
 406
 407 /* Returns the folder's PIDL type, or 0xff if one can't be found. */
 408 static BYTE testSHGetSpecialFolderLocation(int folder)
 409 {
 410     LPITEMIDLIST pidl;
 411     HRESULT hr;
 412     BYTE ret = 0xff;
 413
 414     /* treat absence of function as success */
 415     if (!pSHGetSpecialFolderLocation) return TRUE;
 416
 417     pidl = NULL;
 418     hr = pSHGetSpecialFolderLocation(NULL, folder, &pidl);
 419     if (hr == S_OK)
 420     {
 421         if (pidl)
 422         {
 423             LPITEMIDLIST pidlLast = pILFindLastID(pidl);
 424
 425             ok(pidlLast != NULL,
 426                 "%s: ILFindLastID failed\n", getFolderName(folder));
 427             if (pidlLast)
 428                 ret = pidlLast->mkid.abID[0];
 429             IMalloc_Free(pMalloc, pidl);
 430         }
 431     }
 432     return ret;
 433 }
 434
 435 static void test_SHGetFolderPath(BOOL optional, int folder)
 436 {
 437     char path[MAX_PATH];
 438     HRESULT hr;
 439
 440     if (!pSHGetFolderPathA) return;
 441
 442     hr = pSHGetFolderPathA(NULL, folder, NULL, SHGFP_TYPE_CURRENT, path);
 443     ok(hr == S_OK || optional,
 444      "SHGetFolderPathA(NULL, %s, NULL, SHGFP_TYPE_CURRENT, path) failed: 0x%08x\n", getFolderName(folder), hr);
 445 }
 446
 447 static void test_SHGetSpecialFolderPath(BOOL optional, int folder)
 448 {
 449     char path[MAX_PATH];
 450     BOOL ret;
 451
 452     if (!pSHGetSpecialFolderPathA) return;
 453
 454     ret = pSHGetSpecialFolderPathA(NULL, path, folder, FALSE);
 455     if (ret && winetest_interactive)
 456         printf("%s: %s\n", getFolderName(folder), path);
 457     ok(ret || optional,
 458      "SHGetSpecialFolderPathA(NULL, path, %s, FALSE) failed\n",
 459      getFolderName(folder));
 460 }
 461
 462 static void test_ShellValues(const struct shellExpectedValues testEntries[],
 463  int numEntries, BOOL optional)
 464 {
 465     int i;
 466
 467     for (i = 0; i < numEntries; i++)
 468     {
 469         BYTE type;
 470         int j;
 471         BOOL foundTypeMatch = FALSE;
 472
 473         if (pSHGetFolderLocation)
 474         {
 475             type = testSHGetFolderLocation(testEntries[i].folder);
 476             for (j = 0; !foundTypeMatch && j < testEntries[i].numTypes; j++)
 477                 if (testEntries[i].types[j] == type)
 478                     foundTypeMatch = TRUE;
 479             ok(foundTypeMatch || optional || broken(type == 0xff) /* Win9x */,
 480              "%s has unexpected type %d (0x%02x)\n",
 481              getFolderName(testEntries[i].folder), type, type);
 482         }
 483         type = testSHGetSpecialFolderLocation(testEntries[i].folder);
 484         for (j = 0, foundTypeMatch = FALSE; !foundTypeMatch &&
 485          j < testEntries[i].numTypes; j++)
 486             if (testEntries[i].types[j] == type)
 487                 foundTypeMatch = TRUE;
 488         ok(foundTypeMatch || optional || broken(type == 0xff) /* Win9x */,
 489          "%s has unexpected type %d (0x%02x)\n",
 490          getFolderName(testEntries[i].folder), type, type);
 491         switch (type)
 492         {
 493             case PT_FOLDER:
 494             case PT_DRIVE:
 495             case PT_DRIVE2:
 496             case PT_IESPECIAL2:
 497                 test_SHGetFolderPath(optional, testEntries[i].folder);
 498                 test_SHGetSpecialFolderPath(optional, testEntries[i].folder);
 499                 break;
 500         }
 501     }
 502 }
 503
 504 /* Attempts to verify that the folder path corresponding to the folder CSIDL
 505  * value has the same value as the environment variable with name envVar.
 506  * Doesn't mind if SHGetSpecialFolderPath fails for folder or if envVar isn't
 507  * set in this environment; different OS and shell version behave differently.
 508  * However, if both are present, fails if envVar's value is not the same
 509  * (byte-for-byte) as what SHGetSpecialFolderPath returns.
 510  */
 511 static void matchSpecialFolderPathToEnv(int folder, const char *envVar)
 512 {
 513     char path[MAX_PATH];
 514
 515     if (!pSHGetSpecialFolderPathA) return;
 516
 517     if (pSHGetSpecialFolderPathA(NULL, path, folder, FALSE))
 518     {
 519         char *envVal = getenv(envVar);
 520
 521         ok(!envVal || !lstrcmpiA(envVal, path),
 522          "%%%s%% does not match SHGetSpecialFolderPath:\n"
 523          "%%%s%% is %s\nSHGetSpecialFolderPath returns %s\n",
 524          envVar, envVar, envVal, path);
 525     }
 526 }
 527
 528 /* Attempts to match the GUID returned by SHGetFolderLocation for folder with
 529  * GUID.  Assumes the type of the returned PIDL is in fact a GUID, but doesn't
 530  * fail if it isn't--that check should already have been done.
 531  * Fails if the returned PIDL is a GUID whose value does not match guid.
 532  */
 533 static void matchGUID(int folder, const GUID *guid, const GUID *guid_alt)
 534 {
 535     LPITEMIDLIST pidl;
 536     HRESULT hr;
 537
 538     if (!pSHGetFolderLocation) return;
 539     if (!guid) return;
 540
 541     pidl = NULL;
 542     hr = pSHGetFolderLocation(NULL, folder, NULL, 0, &pidl);
 543     if (hr == S_OK)
 544     {
 545         LPITEMIDLIST pidlLast = pILFindLastID(pidl);
 546
 547         if (pidlLast && (pidlLast->mkid.abID[0] == PT_SHELLEXT ||
 548          pidlLast->mkid.abID[0] == PT_GUID))
 549         {
 550             GUID *shellGuid = (GUID *)(pidlLast->mkid.abID + 2);
 551             char shellGuidStr[39], guidStr[39], guid_altStr[39];
 552
 553             if (!guid_alt)
 554              ok(IsEqualIID(shellGuid, guid),
 555               "%s: got GUID %s, expected %s\n", getFolderName(folder),
 556               printGUID(shellGuid, shellGuidStr), printGUID(guid, guidStr));
 557             else
 558              ok(IsEqualIID(shellGuid, guid) ||
 559               IsEqualIID(shellGuid, guid_alt),
 560               "%s: got GUID %s, expected %s or %s\n", getFolderName(folder),
 561               printGUID(shellGuid, shellGuidStr), printGUID(guid, guidStr),
 562               printGUID(guid_alt, guid_altStr));
 563         }
 564         IMalloc_Free(pMalloc, pidl);
 565     }
 566 }
 567
 568 /* Checks the PIDL type of all the known values. */
 569 static void test_PidlTypes(void)
 570 {
 571     /* Desktop */
 572     test_SHGetFolderPath(FALSE, CSIDL_DESKTOP);
 573     test_SHGetSpecialFolderPath(FALSE, CSIDL_DESKTOP);
 574
 575     test_ShellValues(requiredShellValues, ARRAY_SIZE(requiredShellValues), FALSE);
 576     test_ShellValues(optionalShellValues, ARRAY_SIZE(optionalShellValues), TRUE);
 577 }
 578
 579 /* FIXME: Should be in shobjidl.idl */
 580 DEFINE_GUID(CLSID_NetworkExplorerFolder, 0xF02C1A0D, 0xBE21, 0x4350, 0x88, 0xB0, 0x73, 0x67, 0xFC, 0x96, 0xEF, 0x3C);
 581
 582 /* Verifies various shell virtual folders have the correct well-known GUIDs. */
 583 static void test_GUIDs(void)
 584 {
 585     matchGUID(CSIDL_BITBUCKET, &CLSID_RecycleBin, NULL);
 586     matchGUID(CSIDL_CONTROLS, &CLSID_ControlPanel, NULL);
 587     matchGUID(CSIDL_DRIVES, &CLSID_MyComputer, NULL);
 588     matchGUID(CSIDL_INTERNET, &CLSID_Internet, NULL);
 589     matchGUID(CSIDL_NETWORK, &CLSID_NetworkPlaces, &CLSID_NetworkExplorerFolder); /* Vista and higher */
 590     matchGUID(CSIDL_PERSONAL, &CLSID_MyDocuments, NULL);
 591     matchGUID(CSIDL_COMMON_DOCUMENTS, &CLSID_CommonDocuments, NULL);
 592     matchGUID(CSIDL_PRINTERS, &CLSID_Printers, NULL);
 593 }
 594
 595 /* Verifies various shell paths match the environment variables to which they
 596  * correspond.
 597  */
 598 static void test_EnvVars(void)
 599 {
 600     matchSpecialFolderPathToEnv(CSIDL_PROGRAM_FILES, "ProgramFiles");
 601     matchSpecialFolderPathToEnv(CSIDL_APPDATA, "APPDATA");
 602     matchSpecialFolderPathToEnv(CSIDL_PROFILE, "USERPROFILE");
 603     matchSpecialFolderPathToEnv(CSIDL_WINDOWS, "SystemRoot");
 604     matchSpecialFolderPathToEnv(CSIDL_WINDOWS, "windir");
 605     matchSpecialFolderPathToEnv(CSIDL_PROGRAM_FILES_COMMON, "CommonProgramFiles");
 606     /* this is only set on Wine, but can't hurt to verify it: */
 607     matchSpecialFolderPathToEnv(CSIDL_SYSTEM, "winsysdir");
 608 }
 609
 610 /* Loosely based on PathRemoveBackslashA from dlls/shlwapi/path.c */
 611 static BOOL myPathIsRootA(LPCSTR lpszPath)
 612 {
 613   if (lpszPath && *lpszPath &&
 614       lpszPath[1] == ':' && lpszPath[2] == '\\' && lpszPath[3] == '\0')
 615       return TRUE; /* X:\ */
 616   return FALSE;
 617 }
 618 static LPSTR myPathRemoveBackslashA( LPSTR lpszPath )
 619 {
 620   LPSTR szTemp = NULL;
 621
 622   if(lpszPath)
 623   {
 624     szTemp = CharPrevA(lpszPath, lpszPath + strlen(lpszPath));
 625     if (!myPathIsRootA(lpszPath) && *szTemp == '\\')
 626       *szTemp = '\0';
 627   }
 628   return szTemp;
 629 }
 630
 631 /* Verifies the shell path for CSIDL_WINDOWS matches the return from
 632  * GetWindowsDirectory.  If SHGetSpecialFolderPath fails, no harm, no foul--not
 633  * every shell32 version supports CSIDL_WINDOWS.
 634  */
 635 static void testWinDir(void)
 636 {
 637     char windowsShellPath[MAX_PATH], windowsDir[MAX_PATH] = { 0 };
 638
 639     if (!pSHGetSpecialFolderPathA) return;
 640
 641     if (pSHGetSpecialFolderPathA(NULL, windowsShellPath, CSIDL_WINDOWS, FALSE))
 642     {
 643         myPathRemoveBackslashA(windowsShellPath);
 644         GetWindowsDirectoryA(windowsDir, sizeof(windowsDir));
 645         myPathRemoveBackslashA(windowsDir);
 646         ok(!lstrcmpiA(windowsDir, windowsShellPath),
 647          "GetWindowsDirectory returns %s SHGetSpecialFolderPath returns %s\n",
 648          windowsDir, windowsShellPath);
 649     }
 650 }
 651
 652 /* Verifies the shell path for CSIDL_SYSTEM matches the return from
 653  * GetSystemDirectory.  If SHGetSpecialFolderPath fails, no harm,
 654  * no foul--not every shell32 version supports CSIDL_SYSTEM.
 655  */
 656 static void testSystemDir(void)
 657 {
 658     char systemShellPath[MAX_PATH], systemDir[MAX_PATH], systemDirx86[MAX_PATH];
 659
 660     if (!pSHGetSpecialFolderPathA) return;
 661
 662     GetSystemDirectoryA(systemDir, sizeof(systemDir));
 663     myPathRemoveBackslashA(systemDir);
 664     if (pSHGetSpecialFolderPathA(NULL, systemShellPath, CSIDL_SYSTEM, FALSE))
 665     {
 666         myPathRemoveBackslashA(systemShellPath);
 667         ok(!lstrcmpiA(systemDir, systemShellPath),
 668          "GetSystemDirectory returns %s SHGetSpecialFolderPath returns %s\n",
 669          systemDir, systemShellPath);
 670     }
 671
 672     if (!pGetSystemWow64DirectoryA || !pGetSystemWow64DirectoryA(systemDirx86, sizeof(systemDirx86)))
 673         GetSystemDirectoryA(systemDirx86, sizeof(systemDirx86));
 674     myPathRemoveBackslashA(systemDirx86);
 675     if (pSHGetSpecialFolderPathA(NULL, systemShellPath, CSIDL_SYSTEMX86, FALSE))
 676     {
 677         myPathRemoveBackslashA(systemShellPath);
 678         ok(!lstrcmpiA(systemDirx86, systemShellPath) || broken(!lstrcmpiA(systemDir, systemShellPath)),
 679          "GetSystemDirectory returns %s SHGetSpecialFolderPath returns %s\n",
 680          systemDir, systemShellPath);
 681     }
 682 }
 683
 684 /* Globals used by subprocesses */
 685 static int    myARGC;
 686 static char **myARGV;
 687 static char   base[MAX_PATH];
 688 static char   selfname[MAX_PATH];
 689
 690 static int init(void)
 691 {
 692     myARGC = winetest_get_mainargs(&myARGV);
 693     if (!GetCurrentDirectoryA(sizeof(base), base)) return 0;
 694     strcpy(selfname, myARGV[0]);
 695     return 1;
 696 }
 697
 698 static void doChild(const char *arg)
 699 {
 700     char path[MAX_PATH];
 701     HRESULT hr;
 702
 703     if (arg[0] == '1')
 704     {
 705         LPITEMIDLIST pidl;
 706         char *p;
 707
 708         /* test what happens when CSIDL_FAVORITES is set to a nonexistent directory */
 709
 710         /* test some failure cases first: */
 711         hr = pSHGetFolderPathA(NULL, CSIDL_FAVORITES, NULL, SHGFP_TYPE_CURRENT, path);
 712         ok(hr == HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND),
 713             "SHGetFolderPath returned 0x%08x, expected 0x80070002\n", hr);
 714
 715         pidl = NULL;
 716         hr = pSHGetFolderLocation(NULL, CSIDL_FAVORITES, NULL, 0, &pidl);
 717         ok(hr == E_FAIL || hr == HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND),
 718             "SHGetFolderLocation returned 0x%08x\n", hr);
 719         if (hr == S_OK && pidl) IMalloc_Free(pMalloc, pidl);
 720
 721         ok(!pSHGetSpecialFolderPathA(NULL, path, CSIDL_FAVORITES, FALSE),
 722             "SHGetSpecialFolderPath succeeded, expected failure\n");
 723
 724         pidl = NULL;
 725         hr = pSHGetSpecialFolderLocation(NULL, CSIDL_FAVORITES, &pidl);
 726         ok(hr == E_FAIL || hr == HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND),
 727             "SHGetFolderLocation returned 0x%08x\n", hr);
 728
 729         if (hr == S_OK && pidl) IMalloc_Free(pMalloc, pidl);
 730
 731         /* now test success: */
 732         hr = pSHGetFolderPathA(NULL, CSIDL_FAVORITES | CSIDL_FLAG_CREATE, NULL,
 733                                SHGFP_TYPE_CURRENT, path);
 734         ok (hr == S_OK, "got 0x%08x\n", hr);
 735         if (hr == S_OK)
 736         {
 737             BOOL ret;
 738
 739             trace("CSIDL_FAVORITES was changed to %s\n", path);
 740             ret = CreateDirectoryA(path, NULL);
 741             ok(!ret, "expected failure with ERROR_ALREADY_EXISTS\n");
 742             if (!ret)
 743                 ok(GetLastError() == ERROR_ALREADY_EXISTS,
 744                   "got %d, expected ERROR_ALREADY_EXISTS\n", GetLastError());
 745
 746             p = path + strlen(path);
 747             strcpy(p, "\\desktop.ini");
 748             DeleteFileA(path);
 749             *p = 0;
 750             SetFileAttributesA( path, FILE_ATTRIBUTE_NORMAL );
 751             ret = RemoveDirectoryA(path);
 752             ok( ret, "failed to remove %s error %u\n", path, GetLastError() );
 753         }
 754     }
 755     else if (arg[0] == '2')
 756     {
 757         /* make sure SHGetFolderPath still succeeds when the
 758            original value of CSIDL_FAVORITES is restored. */
 759         hr = pSHGetFolderPathA(NULL, CSIDL_FAVORITES | CSIDL_FLAG_CREATE, NULL,
 760             SHGFP_TYPE_CURRENT, path);
 761         ok(hr == S_OK, "SHGetFolderPath failed: 0x%08x\n", hr);
 762     }
 763 }
 764
 765 /* Tests the return values from the various shell functions both with and
 766  * without the use of the CSIDL_FLAG_CREATE flag.  This flag only appeared in
 767  * version 5 of the shell, so don't test unless it's at least version 5.
 768  * The test reads a value from the registry, modifies it, calls
 769  * SHGetFolderPath once with the CSIDL_FLAG_CREATE flag, and immediately
 770  * afterward without it.  Then it restores the registry and deletes the folder
 771  * that was created.
 772  * One oddity with respect to restoration: shell32 caches somehow, so it needs
 773  * to be reloaded in order to see the correct (restored) value.
 774  * Some APIs unrelated to the ones under test may fail, but I expect they're
 775  * covered by other unit tests; I just print out something about failure to
 776  * help trace what's going on.
 777  */
 778 static void test_NonExistentPath(void)
 779 {
 780     static const char userShellFolders[] =
 781      "Software\\Microsoft\\Windows\\CurrentVersion\\Explorer\\User Shell Folders";
 782     char originalPath[MAX_PATH], modifiedPath[MAX_PATH];
 783     HKEY key;
 784
 785     if (!pSHGetFolderPathA) return;
 786     if (!pSHGetFolderLocation) return;
 787     if (!pSHGetSpecialFolderPathA) return;
 788     if (!pSHGetSpecialFolderLocation) return;
 789     if (!pSHFileOperationA) return;
 790     if (shellVersion.dwMajorVersion < 5) return;
 791
 792     if (!RegOpenKeyExA(HKEY_CURRENT_USER, userShellFolders, 0, KEY_ALL_ACCESS,
 793      &key))
 794     {
 795         DWORD len, type;
 796
 797         len = sizeof(originalPath);
 798         if (!RegQueryValueExA(key, "Favorites", NULL, &type,
 799          (LPBYTE)&originalPath, &len))
 800         {
 801             size_t len = strlen(originalPath);
 802
 803             memcpy(modifiedPath, originalPath, len);
 804             modifiedPath[len++] = '2';
 805             modifiedPath[len++] = '\0';
 806             trace("Changing CSIDL_FAVORITES to %s\n", modifiedPath);
 807             if (!RegSetValueExA(key, "Favorites", 0, type,
 808              (LPBYTE)modifiedPath, len))
 809             {
 810                 char buffer[MAX_PATH+20];
 811                 STARTUPINFOA startup;
 812                 PROCESS_INFORMATION info;
 813
 814                 sprintf(buffer, "%s tests/shellpath.c 1", selfname);
 815                 memset(&startup, 0, sizeof(startup));
 816                 startup.cb = sizeof(startup);
 817                 startup.dwFlags = STARTF_USESHOWWINDOW;
 818                 startup.dwFlags = SW_SHOWNORMAL;
 819                 CreateProcessA(NULL, buffer, NULL, NULL, FALSE, 0L, NULL, NULL,
 820                  &startup, &info);
 821                 winetest_wait_child_process( info.hProcess );
 822
 823                 /* restore original values: */
 824                 trace("Restoring CSIDL_FAVORITES to %s\n", originalPath);
 825                 RegSetValueExA(key, "Favorites", 0, type, (LPBYTE) originalPath,
 826                  strlen(originalPath) + 1);
 827                 RegFlushKey(key);
 828
 829                 sprintf(buffer, "%s tests/shellpath.c 2", selfname);
 830                 memset(&startup, 0, sizeof(startup));
 831                 startup.cb = sizeof(startup);
 832                 startup.dwFlags = STARTF_USESHOWWINDOW;
 833                 startup.dwFlags = SW_SHOWNORMAL;
 834                 CreateProcessA(NULL, buffer, NULL, NULL, FALSE, 0L, NULL, NULL,
 835                  &startup, &info);
 836                 ok(WaitForSingleObject(info.hProcess, 30000) == WAIT_OBJECT_0,
 837                  "child process termination\n");
 838             }
 839         }
 840         else skip("RegQueryValueExA(key, Favorites, ...) failed\n");
 841         if (key)
 842             RegCloseKey(key);
 843     }
 844     else skip("RegOpenKeyExA(HKEY_CURRENT_USER, %s, ...) failed\n", userShellFolders);
 845 }
 846
 847 static void test_SHGetFolderPathEx(void)
 848 {
 849     HRESULT hr;
 850     WCHAR buffer[MAX_PATH], *path;
 851     DWORD len;
 852
 853     if (!pSHGetKnownFolderPath || !pSHGetFolderPathEx)
 854     {
 855         win_skip("SHGetKnownFolderPath or SHGetFolderPathEx not available\n");
 856         return;
 857     }
 858
 859 if (0) { /* crashes */
 860     hr = pSHGetKnownFolderPath(&FOLDERID_Desktop, 0, NULL, NULL);
 861     ok(hr == E_INVALIDARG, "expected E_INVALIDARG, got 0x%08x\n", hr);
 862 }
 863     /* non-existent folder id */
 864     path = (void *)0xdeadbeef;
 865     hr = pSHGetKnownFolderPath(&IID_IOleObject, 0, NULL, &path);
 866     ok(hr == HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND), "got 0x%08x\n", hr);
 867     ok(path == NULL, "got %p\n", path);
 868
 869     path = NULL;
 870     hr = pSHGetKnownFolderPath(&FOLDERID_Desktop, 0, NULL, &path);
 871     ok(hr == S_OK, "expected S_OK, got 0x%08x\n", hr);
 872     ok(path != NULL, "expected path != NULL\n");
 873
 874     hr = pSHGetFolderPathEx(&FOLDERID_Desktop, 0, NULL, buffer, MAX_PATH);
 875     ok(hr == S_OK, "expected S_OK, got 0x%08x\n", hr);
 876     ok(!lstrcmpiW(path, buffer), "expected equal paths\n");
 877     len = lstrlenW(buffer);
 878     CoTaskMemFree(path);
 879
 880     hr = pSHGetFolderPathEx(&FOLDERID_Desktop, 0, NULL, buffer, 0);
 881     ok(hr == E_INVALIDARG, "expected E_INVALIDARG, got 0x%08x\n", hr);
 882
 883 if (0) { /* crashes */
 884     hr = pSHGetFolderPathEx(&FOLDERID_Desktop, 0, NULL, NULL, len + 1);
 885     ok(hr == E_INVALIDARG, "expected E_INVALIDARG, got 0x%08x\n", hr);
 886
 887     hr = pSHGetFolderPathEx(NULL, 0, NULL, buffer, MAX_PATH);
 888     ok(hr == E_INVALIDARG, "expected E_INVALIDARG, got 0x%08x\n", hr);
 889 }
 890     hr = pSHGetFolderPathEx(&FOLDERID_Desktop, 0, NULL, buffer, len);
 891     ok(hr == HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER), "expected 0x8007007a, got 0x%08x\n", hr);
 892
 893     hr = pSHGetFolderPathEx(&FOLDERID_Desktop, 0, NULL, buffer, len + 1);
 894     ok(hr == S_OK, "expected S_OK, got 0x%08x\n", hr);
 895 }
 896
 897 /* Standard CSIDL values (and their flags) uses only two less-significant bytes */
 898 #define NO_CSIDL 0x10000
 899 #define CSIDL_TODO_WINE 0x20000
 900 #define KNOWN_FOLDER(id, csidl, name, category, parent, relative_path, parsing_name, attributes, definitionFlags) \
 901     { &id, # id, csidl, # csidl, name, category, &parent, # parent, relative_path, parsing_name, attributes, definitionFlags, __LINE__ }
 902
 903 /* non-published known folders test */
 904 static const GUID _FOLDERID_CryptoKeys =            {0xB88F4DAA, 0xE7BD, 0x49A9, {0xB7, 0x4D, 0x02, 0x88, 0x5A, 0x5D, 0xC7, 0x65} };
 905 static const GUID _FOLDERID_DpapiKeys =             {0x10C07CD0, 0xEF91, 0x4567, {0xB8, 0x50, 0x44, 0x8B, 0x77, 0xCB, 0x37, 0xF9} };
 906 static const GUID _FOLDERID_SystemCertificates =    {0x54EED2E0, 0xE7CA, 0x4FDB, {0x91, 0x48, 0x0F, 0x42, 0x47, 0x29, 0x1C, 0xFA} };
 907 static const GUID _FOLDERID_CredentialManager =     {0x915221FB, 0x9EFE, 0x4BDA, {0x8F, 0xD7, 0xF7, 0x8D, 0xCA, 0x77, 0x4F, 0x87} };
 908
 909 struct knownFolderDef {
 910     const KNOWNFOLDERID *folderId;
 911     const char *sFolderId;
 912     const int csidl;
 913     const char *sCsidl;
 914     const char *sName;
 915     const KF_CATEGORY category;
 916     const KNOWNFOLDERID *fidParent;
 917     const char *sParent;
 918     const char *sRelativePath;
 919     const char *sParsingName;
 920     const DWORD attributes;
 921     const KF_DEFINITION_FLAGS definitionFlags;
 922     const int line;
 923 };
 924
 925 /* Note: content of parsing name may vary between Windows versions.
 926  * As a base, values from 6.0 (Vista) were used. Some entries may contain
 927  * alternative values. In that case, Windows version where the value was
 928  * found is noted.
 929  *
 930  * The list of values for parsing name was encoded as a number of null-
 931  * terminated strings placed one by one (separated by null byte only).
 932  * End of list is marked by two consecutive null bytes.
 933  */
 934 static const struct knownFolderDef known_folders[] = {
 935     KNOWN_FOLDER(FOLDERID_AddNewPrograms,
 936                  NO_CSIDL,
 937                  "AddNewProgramsFolder",
 938                  KF_CATEGORY_VIRTUAL,
 939                  GUID_NULL,
 940                  NULL,
 941                  "::{21EC2020-3AEA-1069-A2DD-08002B30309D}\\::{15eae92e-f17a-4431-9f28-805e482dafd4}\0"
 942                 "shell:::{26EE0668-A00A-44D7-9371-BEB064C98683}\\0\\::{15eae92e-f17a-4431-9f28-805e482dafd4}\0\0" /* 6.1 */,
 943                 0,
 944                 0),
 945     KNOWN_FOLDER(FOLDERID_AdminTools,
 946                  CSIDL_ADMINTOOLS,
 947                  "Administrative Tools",
 948                  KF_CATEGORY_PERUSER,
 949                  FOLDERID_Programs,
 950                  "Administrative Tools",
 951                  NULL,
 952                  FILE_ATTRIBUTE_READONLY,
 953                  KFDF_PRECREATE),
 954     KNOWN_FOLDER(FOLDERID_AppUpdates,
 955                  NO_CSIDL,
 956                  "AppUpdatesFolder",
 957                  KF_CATEGORY_VIRTUAL,
 958                  GUID_NULL,
 959                  NULL,
 960                  "::{21EC2020-3AEA-1069-A2DD-08002B30309D}\\::{7b81be6a-ce2b-4676-a29e-eb907a5126c5}\\::{d450a8a1-9568-45c7-9c0e-b4f9fb4537bd}\0"
 961                  "::{26EE0668-A00A-44D7-9371-BEB064C98683}\\0\\::{7b81be6a-ce2b-4676-a29e-eb907a5126c5}\\::{d450a8a1-9568-45c7-9c0e-b4f9fb4537bd}\0\0" /* 6.1 */,
 962                  0,
 963                  0),
 964     KNOWN_FOLDER(FOLDERID_CDBurning,
 965                  CSIDL_CDBURN_AREA,
 966                  "CD Burning",
 967                  KF_CATEGORY_PERUSER,
 968                  FOLDERID_LocalAppData,
 969                  "Microsoft\\Windows\\Burn\\Burn",
 970                  NULL,
 971                  FILE_ATTRIBUTE_READONLY,
 972                  KFDF_LOCAL_REDIRECT_ONLY),
 973     KNOWN_FOLDER(FOLDERID_ChangeRemovePrograms,
 974                  NO_CSIDL,
 975                  "ChangeRemoveProgramsFolder",
 976                  KF_CATEGORY_VIRTUAL,
 977                  GUID_NULL,
 978                  NULL,
 979                  "::{21EC2020-3AEA-1069-A2DD-08002B30309D}\\::{7b81be6a-ce2b-4676-a29e-eb907a5126c5}\0"
 980                  "::{26EE0668-A00A-44D7-9371-BEB064C98683}\\0\\::{7b81be6a-ce2b-4676-a29e-eb907a5126c5}\0\0" /* 6.1 */,
 981                  0,
 982                  0),
 983     KNOWN_FOLDER(FOLDERID_CommonAdminTools,
 984                  CSIDL_COMMON_ADMINTOOLS,
 985                  "Common Administrative Tools",
 986                  KF_CATEGORY_COMMON,
 987                  FOLDERID_CommonPrograms,
 988                  "Administrative Tools",
 989                  NULL,
 990                  FILE_ATTRIBUTE_READONLY,
 991                  KFDF_PRECREATE),
 992     KNOWN_FOLDER(FOLDERID_CommonOEMLinks,
 993                  CSIDL_COMMON_OEM_LINKS,"OEM Links",
 994                  KF_CATEGORY_COMMON,
 995                  FOLDERID_ProgramData,
 996                  "OEM Links",
 997                  NULL,
 998                  0,
 999                  0),
1000     KNOWN_FOLDER(FOLDERID_CommonPrograms,
1001                  CSIDL_COMMON_PROGRAMS,
1002                  "Common Programs",
1003                  KF_CATEGORY_COMMON,
1004                  FOLDERID_CommonStartMenu,
1005                  "Programs",
1006                  NULL,
1007                  FILE_ATTRIBUTE_READONLY,
1008                  KFDF_PRECREATE),
1009     KNOWN_FOLDER(FOLDERID_CommonStartMenu,
1010                  CSIDL_COMMON_STARTMENU,
1011                  "Common Start Menu",
1012                  KF_CATEGORY_COMMON,
1013                  FOLDERID_ProgramData,
1014                  "Microsoft\\Windows\\Start Menu",
1015                  NULL,
1016                  FILE_ATTRIBUTE_READONLY,
1017                  KFDF_PRECREATE),
1018     KNOWN_FOLDER(FOLDERID_CommonStartup,
1019                  CSIDL_COMMON_STARTUP,
1020                  "Common Startup",
1021                  KF_CATEGORY_COMMON,
1022                  FOLDERID_CommonPrograms,
1023                  "StartUp",
1024                  NULL,
1025                  FILE_ATTRIBUTE_READONLY,
1026                  KFDF_PRECREATE),
1027     KNOWN_FOLDER(FOLDERID_CommonTemplates,
1028                  CSIDL_COMMON_TEMPLATES,
1029                  "Common Templates",
1030                  KF_CATEGORY_COMMON,
1031                  FOLDERID_ProgramData,
1032                  "Microsoft\\Windows\\Templates",
1033                  NULL,
1034                  0,
1035                  0),
1036     KNOWN_FOLDER(FOLDERID_ComputerFolder,
1037                  CSIDL_DRIVES,
1038                  "MyComputerFolder",
1039                  KF_CATEGORY_VIRTUAL,
1040                  GUID_NULL,
1041                  NULL,
1042                  "::{20D04FE0-3AEA-1069-A2D8-08002B30309D}\0\0",
1043                  0,
1044                  0),
1045     KNOWN_FOLDER(FOLDERID_ConflictFolder,
1046                  NO_CSIDL,
1047                  "ConflictFolder",
1048                  KF_CATEGORY_VIRTUAL,
1049                  GUID_NULL,
1050                  NULL,
1051                  "::{21EC2020-3AEA-1069-A2DD-08002B30309D}\\::{9C73F5E5-7AE7-4E32-A8E8-8D23B85255BF}\\::{E413D040-6788-4C22-957E-175D1C513A34},\0"
1052                  "::{26EE0668-A00A-44D7-9371-BEB064C98683}\\0\\::{9C73F5E5-7AE7-4E32-A8E8-8D23B85255BF}\\::{E413D040-6788-4C22-957E-175D1C513A34},\0\0" /* 6.1 */,
1053                  0,
1054                  0),
1055     KNOWN_FOLDER(FOLDERID_ConnectionsFolder,
1056                  CSIDL_CONNECTIONS,
1057                  "ConnectionsFolder",
1058                  KF_CATEGORY_VIRTUAL,
1059                  GUID_NULL,
1060                  NULL,
1061                  "::{21EC2020-3AEA-1069-A2DD-08002B30309D}\\::{7007ACC7-3202-11D1-AAD2-00805FC1270E}\0"
1062                  "::{26EE0668-A00A-44D7-9371-BEB064C98683}\\0\\::{7007ACC7-3202-11D1-AAD2-00805FC1270E}\0\0" /* 6.1 */,
1063                  0,
1064                  0),
1065     KNOWN_FOLDER(FOLDERID_Contacts,
1066                  NO_CSIDL,
1067                  "Contacts",
1068                  KF_CATEGORY_PERUSER,
1069                  FOLDERID_Profile,
1070                  "Contacts",
1071                  "::{59031a47-3f72-44a7-89c5-5595fe6b30ee}\\{56784854-C6CB-462B-8169-88E350ACB882}\0\0",
1072                  FILE_ATTRIBUTE_READONLY,
1073                  KFDF_ROAMABLE | KFDF_PRECREATE | KFDF_PUBLISHEXPANDEDPATH),
1074     KNOWN_FOLDER(FOLDERID_ControlPanelFolder,
1075                  CSIDL_CONTROLS,
1076                  "ControlPanelFolder",
1077                  KF_CATEGORY_VIRTUAL,
1078                  GUID_NULL,
1079                  NULL,
1080                  "::{21EC2020-3AEA-1069-A2DD-08002B30309D}\0"
1081                  "::{26EE0668-A00A-44D7-9371-BEB064C98683}\\0\0\0" /* 6.1 */,
1082                  0,
1083                  0),
1084     KNOWN_FOLDER(FOLDERID_Cookies,
1085                  CSIDL_COOKIES,
1086                  "Cookies",
1087                  KF_CATEGORY_PERUSER,
1088                  FOLDERID_RoamingAppData,
1089                  "Microsoft\\Windows\\Cookies",
1090                  NULL,
1091                  0,
1092                  0),
1093     KNOWN_FOLDER(FOLDERID_Desktop,
1094                  CSIDL_DESKTOP,
1095                  "Desktop",
1096                  KF_CATEGORY_PERUSER,
1097                  FOLDERID_Profile,
1098                  "Desktop",
1099                  NULL,
1100                  FILE_ATTRIBUTE_READONLY,
1101                  KFDF_ROAMABLE | KFDF_PRECREATE | KFDF_PUBLISHEXPANDEDPATH),
1102     KNOWN_FOLDER(FOLDERID_DeviceMetadataStore,
1103                  NO_CSIDL,
1104                  "Device Metadata Store",
1105                  KF_CATEGORY_COMMON,
1106                  FOLDERID_ProgramData,
1107                  "Microsoft\\Windows\\DeviceMetadataStore",
1108                  NULL,
1109                  0,
1110                  0),
1111     KNOWN_FOLDER(FOLDERID_Documents,
1112                  CSIDL_MYDOCUMENTS,
1113                  "Personal",
1114                  KF_CATEGORY_PERUSER,
1115                  FOLDERID_Profile,
1116                  "Documents",
1117                  "::{59031a47-3f72-44a7-89c5-5595fe6b30ee}\\{FDD39AD0-238F-46AF-ADB4-6C85480369C7}\0\0",
1118                  FILE_ATTRIBUTE_READONLY,
1119                  KFDF_ROAMABLE | KFDF_PRECREATE),
1120     KNOWN_FOLDER(FOLDERID_DocumentsLibrary,
1121                  NO_CSIDL,
1122                  "DocumentsLibrary",
1123                  KF_CATEGORY_PERUSER,
1124                  FOLDERID_Libraries,
1125                  "Documents.library-ms",
1126                  "::{031E4825-7B94-4dc3-B131-E946B44C8DD5}\\{7b0db17d-9cd2-4a93-9733-46cc89022e7c}\0\0",
1127                  0,
1128                  KFDF_PRECREATE | KFDF_STREAM),
1129     KNOWN_FOLDER(FOLDERID_Downloads,
1130                  NO_CSIDL,
1131                  "Downloads",
1132                  KF_CATEGORY_PERUSER,
1133                  FOLDERID_Profile,
1134                  "Downloads",
1135                  NULL,
1136                  FILE_ATTRIBUTE_READONLY,
1137                  KFDF_ROAMABLE | KFDF_PRECREATE | KFDF_PUBLISHEXPANDEDPATH),
1138     KNOWN_FOLDER(FOLDERID_Favorites,
1139                  CSIDL_FAVORITES,
1140                  "Favorites",
1141                  KF_CATEGORY_PERUSER,
1142                  FOLDERID_Profile,
1143                  "Favorites",
1144                  NULL,
1145                  FILE_ATTRIBUTE_READONLY,
1146                  KFDF_ROAMABLE | KFDF_PRECREATE | KFDF_PUBLISHEXPANDEDPATH),
1147     KNOWN_FOLDER(FOLDERID_Fonts,
1148                  CSIDL_FONTS,
1149                  "Fonts",
1150                  KF_CATEGORY_FIXED,
1151                  FOLDERID_Windows,
1152                  NULL,
1153                  NULL,
1154                  0,
1155                  0),
1156     KNOWN_FOLDER(FOLDERID_Games,
1157                  NO_CSIDL,
1158                  "Games",
1159                  KF_CATEGORY_VIRTUAL,
1160                  GUID_NULL,
1161                  NULL,
1162                  "::{ED228FDF-9EA8-4870-83b1-96b02CFE0D52}\0\0",
1163                  0,
1164                  0),
1165     KNOWN_FOLDER(FOLDERID_GameTasks,
1166                  NO_CSIDL,
1167                  "GameTasks",
1168                  KF_CATEGORY_PERUSER,
1169                  FOLDERID_LocalAppData,
1170                  "Microsoft\\Windows\\GameExplorer",
1171                  NULL,
1172                  0,
1173                  KFDF_LOCAL_REDIRECT_ONLY),
1174     KNOWN_FOLDER(FOLDERID_History,
1175                  CSIDL_HISTORY,
1176                  "History",
1177                  KF_CATEGORY_PERUSER,
1178                  FOLDERID_LocalAppData,
1179                  "Microsoft\\Windows\\History",
1180                  NULL,
1181                  0,
1182                  KFDF_LOCAL_REDIRECT_ONLY),
1183     KNOWN_FOLDER(FOLDERID_HomeGroup,
1184                  NO_CSIDL,
1185                  "HomeGroupFolder",
1186                  KF_CATEGORY_VIRTUAL,
1187                  GUID_NULL,
1188                  NULL,
1189                  "::{B4FB3F98-C1EA-428d-A78A-D1F5659CBA93}\0\0",
1190                  0,
1191                  0),
1192     KNOWN_FOLDER(FOLDERID_ImplicitAppShortcuts,
1193                  NO_CSIDL,
1194                  "ImplicitAppShortcuts",
1195                  KF_CATEGORY_PERUSER,
1196                  FOLDERID_UserPinned,
1197                  "ImplicitAppShortcuts",
1198                  NULL,
1199                  0,
1200                  KFDF_PRECREATE),
1201     KNOWN_FOLDER(FOLDERID_InternetCache,
1202                  CSIDL_INTERNET_CACHE,
1203                  "Cache",
1204                  KF_CATEGORY_PERUSER,
1205                  FOLDERID_LocalAppData,
1206                  "Microsoft\\Windows\\Temporary Internet Files",
1207                  NULL,
1208                  0,
1209                  KFDF_LOCAL_REDIRECT_ONLY),
1210     KNOWN_FOLDER(FOLDERID_InternetFolder,
1211                  CSIDL_INTERNET,
1212                  "InternetFolder",
1213                  KF_CATEGORY_VIRTUAL,
1214                  GUID_NULL,
1215                  NULL,
1216                  "::{871C5380-42A0-1069-A2EA-08002B30309D}\0\0",
1217                  0,
1218                  0),
1219     KNOWN_FOLDER(FOLDERID_Libraries,
1220                  NO_CSIDL,
1221                  "Libraries",
1222                  KF_CATEGORY_PERUSER,
1223                  FOLDERID_RoamingAppData,
1224                  "Microsoft\\Windows\\Libraries",
1225                  NULL,
1226                  0,
1227                  KFDF_PRECREATE | KFDF_PUBLISHEXPANDEDPATH),
1228     KNOWN_FOLDER(FOLDERID_Links,
1229                  NO_CSIDL,
1230                  "Links",
1231                  KF_CATEGORY_PERUSER,
1232                  FOLDERID_Profile,
1233                  "Links",
1234                  "::{59031a47-3f72-44a7-89c5-5595fe6b30ee}\\{bfb9d5e0-c6a9-404c-b2b2-ae6db6af4968}\0\0",
1235                  FILE_ATTRIBUTE_READONLY,
1236                  KFDF_ROAMABLE | KFDF_PRECREATE | KFDF_PUBLISHEXPANDEDPATH),
1237     KNOWN_FOLDER(FOLDERID_LocalAppData,
1238                  CSIDL_LOCAL_APPDATA,
1239                  "Local AppData",
1240                  KF_CATEGORY_PERUSER,
1241                  FOLDERID_Profile,
1242                  "AppData\\Local",
1243                  NULL,
1244                  0,
1245                  KFDF_LOCAL_REDIRECT_ONLY | KFDF_PUBLISHEXPANDEDPATH),
1246     KNOWN_FOLDER(FOLDERID_LocalAppDataLow,
1247                  NO_CSIDL,
1248                  "LocalAppDataLow",
1249                  KF_CATEGORY_PERUSER,
1250                  FOLDERID_Profile,
1251                  "AppData\\LocalLow",
1252                  NULL,
1253                  FILE_ATTRIBUTE_NOT_CONTENT_INDEXED,
1254                  KFDF_LOCAL_REDIRECT_ONLY | KFDF_PRECREATE | KFDF_PUBLISHEXPANDEDPATH),
1255     KNOWN_FOLDER(FOLDERID_LocalizedResourcesDir,
1256                  CSIDL_RESOURCES_LOCALIZED,
1257                  "LocalizedResourcesDir",
1258                  KF_CATEGORY_FIXED,
1259                  GUID_NULL,
1260                  NULL,
1261                  NULL,
1262                  0,
1263                  0),
1264     KNOWN_FOLDER(FOLDERID_Music,
1265                  CSIDL_MYMUSIC,
1266                  "My Music",
1267                  KF_CATEGORY_PERUSER,
1268                  FOLDERID_Profile,
1269                  "Music",
1270                  "::{59031a47-3f72-44a7-89c5-5595fe6b30ee}\\{4BD8D571-6D19-48D3-BE97-422220080E43}\0\0",
1271                  FILE_ATTRIBUTE_READONLY,
1272                  KFDF_ROAMABLE | KFDF_PRECREATE),
1273     KNOWN_FOLDER(FOLDERID_MusicLibrary,
1274                  NO_CSIDL,
1275                  "MusicLibrary",
1276                  KF_CATEGORY_PERUSER,
1277                  FOLDERID_Libraries,
1278                  "Music.library-ms",
1279                  "::{031E4825-7B94-4dc3-B131-E946B44C8DD5}\\{2112AB0A-C86A-4ffe-A368-0DE96E47012E}\0\0",
1280                  0,
1281                  KFDF_PRECREATE | KFDF_STREAM),
1282     KNOWN_FOLDER(FOLDERID_NetHood,
1283                  CSIDL_NETHOOD,
1284                  "NetHood",
1285                  KF_CATEGORY_PERUSER,
1286                  FOLDERID_RoamingAppData,
1287                  "Microsoft\\Windows\\Network Shortcuts",
1288                  NULL,
1289                  0,
1290                  0),
1291     KNOWN_FOLDER(FOLDERID_NetworkFolder,
1292                  CSIDL_NETWORK,
1293                  "NetworkPlacesFolder",
1294                  KF_CATEGORY_VIRTUAL,
1295                  GUID_NULL,
1296                  NULL,
1297                  "::{F02C1A0D-BE21-4350-88B0-7367FC96EF3C}\0\0",
1298                  0,
1299                  0),
1300     KNOWN_FOLDER(FOLDERID_OriginalImages,
1301                  NO_CSIDL,
1302                  "Original Images",
1303                  KF_CATEGORY_PERUSER,
1304                  FOLDERID_LocalAppData,
1305                  "Microsoft\\Windows Photo Gallery\\Original Images",
1306                  NULL,
1307                  0,
1308                  0),
1309     KNOWN_FOLDER(FOLDERID_PhotoAlbums,
1310                  NO_CSIDL,
1311                  "PhotoAlbums",
1312                  KF_CATEGORY_PERUSER,
1313                  FOLDERID_Pictures,
1314                  "Slide Shows",
1315                  NULL,
1316                  FILE_ATTRIBUTE_READONLY,
1317                  0),
1318     KNOWN_FOLDER(FOLDERID_Pictures,
1319                  CSIDL_MYPICTURES,
1320                  "My Pictures",
1321                  KF_CATEGORY_PERUSER,
1322                  FOLDERID_Profile,
1323                  "Pictures",
1324                  "::{59031a47-3f72-44a7-89c5-5595fe6b30ee}\\{33E28130-4E1E-4676-835A-98395C3BC3BB}\0\0",
1325                  FILE_ATTRIBUTE_READONLY,
1326                  KFDF_ROAMABLE | KFDF_PRECREATE),
1327     KNOWN_FOLDER(FOLDERID_PicturesLibrary,
1328                  NO_CSIDL,
1329                  "PicturesLibrary",
1330                  KF_CATEGORY_PERUSER,
1331                  FOLDERID_Libraries,
1332                  "Pictures.library-ms",
1333                  "::{031E4825-7B94-4dc3-B131-E946B44C8DD5}\\{A990AE9F-A03B-4e80-94BC-9912D7504104}\0\0",
1334                  0,
1335                  KFDF_PRECREATE | KFDF_STREAM),
1336     KNOWN_FOLDER(FOLDERID_Playlists,
1337                  NO_CSIDL,
1338                  "Playlists",
1339                  KF_CATEGORY_PERUSER,
1340                  FOLDERID_Music,
1341                  "Playlists",
1342                  NULL,
1343                  FILE_ATTRIBUTE_READONLY,
1344                  0),
1345     KNOWN_FOLDER(FOLDERID_PrintersFolder,
1346                  CSIDL_PRINTERS,
1347                  "PrintersFolder",
1348                  KF_CATEGORY_VIRTUAL,
1349                  GUID_NULL,
1350                  NULL,
1351                  "::{21EC2020-3AEA-1069-A2DD-08002B30309D}\\::{2227A280-3AEA-1069-A2DE-08002B30309D}\0\0",
1352                  0,
1353                  0),
1354     KNOWN_FOLDER(FOLDERID_PrintHood,
1355                  CSIDL_PRINTHOOD,
1356                  "PrintHood",
1357                  KF_CATEGORY_PERUSER,
1358                  FOLDERID_RoamingAppData,
1359                  "Microsoft\\Windows\\Printer Shortcuts",
1360                  NULL,
1361                  0,
1362                  0),
1363     KNOWN_FOLDER(FOLDERID_Profile,
1364                  CSIDL_PROFILE,
1365                  "Profile",
1366                  KF_CATEGORY_FIXED,
1367                  GUID_NULL,
1368                  NULL,
1369                  NULL,
1370                  0,
1371                  0),
1372     KNOWN_FOLDER(FOLDERID_ProgramData,
1373                  CSIDL_COMMON_APPDATA,
1374                  "Common AppData",
1375                  KF_CATEGORY_FIXED,
1376                  GUID_NULL,
1377                  NULL,
1378                  NULL,
1379                  0,
1380                  0),
1381     KNOWN_FOLDER(FOLDERID_ProgramFiles,
1382                  CSIDL_PROGRAM_FILES,
1383                  "ProgramFiles",
1384                  KF_CATEGORY_FIXED,
1385                  GUID_NULL,
1386                  NULL,
1387                  NULL,
1388                  FILE_ATTRIBUTE_READONLY,
1389                  KFDF_PRECREATE
1390                 ),
1391     KNOWN_FOLDER(FOLDERID_ProgramFilesCommon,
1392                  CSIDL_PROGRAM_FILES_COMMON,
1393                  "ProgramFilesCommon",
1394                  KF_CATEGORY_FIXED,
1395                  GUID_NULL,
1396                  NULL,
1397                  NULL,
1398                  0,
1399                  0),
1400     KNOWN_FOLDER(FOLDERID_ProgramFilesCommonX64,
1401                  NO_CSIDL,
1402                  "ProgramFilesCommonX64",
1403                  KF_CATEGORY_FIXED,
1404                  GUID_NULL,
1405                  NULL,
1406                  NULL,
1407                  0,
1408                  0),
1409     KNOWN_FOLDER(FOLDERID_ProgramFilesCommonX86,
1410                  NO_CSIDL,
1411                  "ProgramFilesCommonX86",
1412                  KF_CATEGORY_FIXED,
1413                  GUID_NULL,
1414                  NULL,
1415                  NULL,
1416                  0,
1417                  0),
1418     KNOWN_FOLDER(FOLDERID_ProgramFilesX64,
1419                  NO_CSIDL,
1420                  "ProgramFilesX64",
1421                  KF_CATEGORY_FIXED,
1422                  GUID_NULL,
1423                  NULL,
1424                  NULL,
1425                  0,
1426                  0),
1427     KNOWN_FOLDER(FOLDERID_ProgramFilesX86,
1428                  CSIDL_PROGRAM_FILESX86,
1429                  "ProgramFilesX86",
1430                  KF_CATEGORY_FIXED,
1431                  GUID_NULL,
1432                  NULL,
1433                  NULL,
1434                  FILE_ATTRIBUTE_READONLY,
1435                  KFDF_PRECREATE),
1436     KNOWN_FOLDER(FOLDERID_Programs,
1437                  CSIDL_PROGRAMS,
1438                  "Programs",
1439                  KF_CATEGORY_PERUSER,
1440                  FOLDERID_StartMenu,
1441                  "Programs",
1442                  NULL,
1443                  FILE_ATTRIBUTE_READONLY,
1444                  KFDF_PRECREATE),
1445     KNOWN_FOLDER(FOLDERID_Public,
1446                  NO_CSIDL,
1447                  "Public",
1448                  KF_CATEGORY_FIXED,
1449                  GUID_NULL,
1450                  NULL,
1451                  "::{4336a54d-038b-4685-ab02-99bb52d3fb8b}\0"
1452                  "(null)\0\0" /* 6.1 */,
1453                  FILE_ATTRIBUTE_READONLY,
1454                  KFDF_PRECREATE),
1455     KNOWN_FOLDER(FOLDERID_PublicDesktop,
1456                  CSIDL_COMMON_DESKTOPDIRECTORY,
1457                  "Common Desktop",
1458                  KF_CATEGORY_COMMON,
1459                  FOLDERID_Public,
1460                  "Desktop",
1461                  NULL,
1462                  FILE_ATTRIBUTE_READONLY | FILE_ATTRIBUTE_HIDDEN,
1463                  KFDF_PRECREATE),
1464     KNOWN_FOLDER(FOLDERID_PublicDocuments,
1465                  CSIDL_COMMON_DOCUMENTS,
1466                  "Common Documents",
1467                  KF_CATEGORY_COMMON,
1468                  FOLDERID_Public,
1469                  "Documents",
1470                  NULL,
1471                  FILE_ATTRIBUTE_READONLY,
1472                  KFDF_PRECREATE),
1473     KNOWN_FOLDER(FOLDERID_PublicDownloads,
1474                  NO_CSIDL,
1475                  "CommonDownloads",
1476                  KF_CATEGORY_COMMON,
1477                  FOLDERID_Public,
1478                  "Downloads",
1479                  NULL,
1480                  FILE_ATTRIBUTE_READONLY,
1481                  KFDF_PRECREATE),
1482     KNOWN_FOLDER(FOLDERID_PublicGameTasks,
1483                  NO_CSIDL,
1484                  "PublicGameTasks",
1485                  KF_CATEGORY_COMMON,
1486                  FOLDERID_ProgramData,
1487                  "Microsoft\\Windows\\GameExplorer",
1488                  NULL,
1489                  0,
1490                  KFDF_LOCAL_REDIRECT_ONLY),
1491     KNOWN_FOLDER(FOLDERID_PublicLibraries,
1492                  NO_CSIDL,
1493                  "PublicLibraries",
1494                  KF_CATEGORY_COMMON,
1495                  FOLDERID_Public,
1496                  "Libraries",
1497                  NULL,
1498                  FILE_ATTRIBUTE_READONLY | FILE_ATTRIBUTE_HIDDEN,
1499                  KFDF_PRECREATE),
1500     KNOWN_FOLDER(FOLDERID_PublicMusic,
1501                  CSIDL_COMMON_MUSIC,
1502                  "CommonMusic",
1503                  KF_CATEGORY_COMMON,
1504                  FOLDERID_Public,
1505                  "Music",
1506                  NULL,
1507                  FILE_ATTRIBUTE_READONLY,
1508                  KFDF_PRECREATE),
1509     KNOWN_FOLDER(FOLDERID_PublicPictures,
1510                  CSIDL_COMMON_PICTURES,
1511                  "CommonPictures",
1512                  KF_CATEGORY_COMMON,
1513                  FOLDERID_Public,
1514                  "Pictures",
1515                  NULL,
1516                  FILE_ATTRIBUTE_READONLY,
1517                  KFDF_PRECREATE),
1518     KNOWN_FOLDER(FOLDERID_PublicRingtones,
1519                  NO_CSIDL,
1520                  "CommonRingtones",
1521                  KF_CATEGORY_COMMON,
1522                  FOLDERID_ProgramData,
1523                  "Microsoft\\Windows\\Ringtones",
1524                  NULL,
1525                  0,
1526                  KFDF_PRECREATE),
1527     KNOWN_FOLDER(FOLDERID_PublicVideos,
1528                  CSIDL_COMMON_VIDEO,
1529                  "CommonVideo",
1530                  KF_CATEGORY_COMMON,
1531                  FOLDERID_Public,
1532                  "Videos",
1533                  NULL,
1534                  FILE_ATTRIBUTE_READONLY,
1535                  KFDF_PRECREATE),
1536     KNOWN_FOLDER(FOLDERID_QuickLaunch,
1537                  NO_CSIDL,
1538                  "Quick Launch",
1539                  KF_CATEGORY_PERUSER,
1540                  FOLDERID_RoamingAppData,
1541                  "Microsoft\\Internet Explorer\\Quick Launch",
1542                  NULL,
1543                  0,
1544                  0),
1545     KNOWN_FOLDER(FOLDERID_Recent,
1546                  CSIDL_RECENT,
1547                  "Recent",
1548                  KF_CATEGORY_PERUSER,
1549                  FOLDERID_RoamingAppData,
1550                  "Microsoft\\Windows\\Recent",
1551                  NULL,
1552                  FILE_ATTRIBUTE_READONLY,
1553                  KFDF_PRECREATE),
1554     KNOWN_FOLDER(FOLDERID_RecordedTVLibrary,
1555                  NO_CSIDL,
1556                  "RecordedTVLibrary",
1557                  KF_CATEGORY_COMMON,
1558                  FOLDERID_PublicLibraries,
1559                  "RecordedTV.library-ms",
1560                  NULL,
1561                  0,
1562                  KFDF_PRECREATE | KFDF_STREAM),
1563     KNOWN_FOLDER(FOLDERID_RecycleBinFolder,
1564                  CSIDL_BITBUCKET,
1565                  "RecycleBinFolder",
1566                  KF_CATEGORY_VIRTUAL,
1567                  GUID_NULL,
1568                  NULL,
1569                  "::{645FF040-5081-101B-9F08-00AA002F954E}\0\0",
1570                  0,
1571                  0),
1572     KNOWN_FOLDER(FOLDERID_ResourceDir,
1573                  CSIDL_RESOURCES,
1574                  "ResourceDir",
1575                  KF_CATEGORY_FIXED,
1576                  GUID_NULL,
1577                  NULL,
1578                  NULL,
1579                  0,
1580                  0),
1581     KNOWN_FOLDER(FOLDERID_Ringtones,
1582                  NO_CSIDL,
1583                  "Ringtones",
1584                  KF_CATEGORY_PERUSER,
1585                  FOLDERID_LocalAppData,
1586                  "Microsoft\\Windows\\Ringtones",
1587                  NULL,
1588                  0,
1589                  KFDF_PRECREATE),
1590     KNOWN_FOLDER(FOLDERID_RoamingAppData,
1591                  CSIDL_APPDATA,
1592                  "AppData",
1593                  KF_CATEGORY_PERUSER,
1594                  FOLDERID_Profile,
1595                  "AppData\\Roaming",
1596                  NULL,
1597                  0,
1598                  0),
1599     KNOWN_FOLDER(FOLDERID_SampleMusic,
1600                  NO_CSIDL,
1601                  "SampleMusic",
1602                  KF_CATEGORY_COMMON,
1603                  FOLDERID_PublicMusic,
1604                  "Sample Music",
1605                  NULL,
1606                  FILE_ATTRIBUTE_READONLY,
1607                  KFDF_PRECREATE),
1608     KNOWN_FOLDER(FOLDERID_SamplePictures,
1609                  NO_CSIDL,
1610                  "SamplePictures",
1611                  KF_CATEGORY_COMMON,
1612                  FOLDERID_PublicPictures,
1613                  "Sample Pictures",
1614                  NULL,
1615                  FILE_ATTRIBUTE_READONLY,
1616                  KFDF_PRECREATE),
1617     KNOWN_FOLDER(FOLDERID_SamplePlaylists,
1618                  NO_CSIDL,
1619                  "SamplePlaylists",
1620                  KF_CATEGORY_COMMON,
1621                  FOLDERID_PublicMusic,
1622                  "Sample Playlists",
1623                  NULL,
1624                  FILE_ATTRIBUTE_READONLY,
1625                  0),
1626     KNOWN_FOLDER(FOLDERID_SampleVideos,
1627                  NO_CSIDL,
1628                  "SampleVideos",
1629                  KF_CATEGORY_COMMON,
1630                  FOLDERID_PublicVideos,
1631                  "Sample Videos",
1632                  NULL,
1633                  FILE_ATTRIBUTE_READONLY,
1634                  KFDF_PRECREATE),
1635     KNOWN_FOLDER(FOLDERID_SavedGames,
1636                  NO_CSIDL,
1637                  "SavedGames",
1638                  KF_CATEGORY_PERUSER,
1639                  FOLDERID_Profile,
1640                  "Saved Games",
1641                  "::{59031a47-3f72-44a7-89c5-5595fe6b30ee}\\{4C5C32FF-BB9D-43b0-B5B4-2D72E54EAAA4}\0\0",
1642                  FILE_ATTRIBUTE_READONLY,
1643                  KFDF_ROAMABLE | KFDF_PRECREATE | KFDF_PUBLISHEXPANDEDPATH),
1644     KNOWN_FOLDER(FOLDERID_SavedSearches,
1645                  NO_CSIDL,
1646                  "Searches",
1647                  KF_CATEGORY_PERUSER,
1648                  FOLDERID_Profile,
1649                  "Searches",
1650                  "::{59031a47-3f72-44a7-89c5-5595fe6b30ee}\\{7d1d3a04-debb-4115-95cf-2f29da2920da}\0\0",
1651                  FILE_ATTRIBUTE_READONLY,
1652                  KFDF_PRECREATE | KFDF_PUBLISHEXPANDEDPATH),
1653     KNOWN_FOLDER(FOLDERID_SEARCH_CSC,
1654                  NO_CSIDL,
1655                  "CSCFolder",
1656                  KF_CATEGORY_VIRTUAL,
1657                  GUID_NULL,
1658                  NULL,
1659                  "shell:::{BD7A2E7B-21CB-41b2-A086-B309680C6B7E}\\*\0\0",
1660                  0,
1661                  0),
1662     KNOWN_FOLDER(FOLDERID_SearchHome,
1663                  NO_CSIDL,
1664                  "SearchHomeFolder",
1665                  KF_CATEGORY_VIRTUAL,
1666                  GUID_NULL,
1667                  NULL,
1668                  "::{9343812e-1c37-4a49-a12e-4b2d810d956b}\0\0",
1669                  0,
1670                  0),
1671     KNOWN_FOLDER(FOLDERID_SEARCH_MAPI,
1672                  NO_CSIDL,
1673                  "MAPIFolder",
1674                  KF_CATEGORY_VIRTUAL,
1675                  GUID_NULL,
1676                  NULL,
1677                  "shell:::{89D83576-6BD1-4C86-9454-BEB04E94C819}\\*\0\0",
1678                  0,
1679                  0),
1680     KNOWN_FOLDER(FOLDERID_SendTo,
1681                  CSIDL_SENDTO,
1682                  "SendTo",
1683                  KF_CATEGORY_PERUSER,
1684                  FOLDERID_RoamingAppData,
1685                  "Microsoft\\Windows\\SendTo",
1686                  NULL,
1687                  0,
1688                  0),
1689     KNOWN_FOLDER(FOLDERID_SidebarDefaultParts,
1690                  NO_CSIDL,
1691                  "Default Gadgets",
1692                  KF_CATEGORY_COMMON,
1693                  FOLDERID_ProgramFiles,
1694                  "Windows Sidebar\\Gadgets",
1695                  NULL,
1696                  0,
1697                  0),
1698     KNOWN_FOLDER(FOLDERID_SidebarParts,
1699                  NO_CSIDL,
1700                  "Gadgets",
1701                  KF_CATEGORY_PERUSER,
1702                  FOLDERID_LocalAppData,
1703                  "Microsoft\\Windows Sidebar\\Gadgets",
1704                  NULL,
1705                  0,
1706                  0),
1707     KNOWN_FOLDER(FOLDERID_StartMenu,
1708                  CSIDL_STARTMENU,
1709                  "Start Menu",
1710                  KF_CATEGORY_PERUSER,
1711                  FOLDERID_RoamingAppData,
1712                  "Microsoft\\Windows\\Start Menu",
1713                  NULL,
1714                  FILE_ATTRIBUTE_READONLY,
1715                  KFDF_PRECREATE),
1716     KNOWN_FOLDER(FOLDERID_Startup,
1717                  CSIDL_STARTUP,
1718                  "Startup",
1719                  KF_CATEGORY_PERUSER,
1720                  FOLDERID_Programs,
1721                  "StartUp",
1722                  NULL,
1723                  FILE_ATTRIBUTE_READONLY,
1724                  KFDF_PRECREATE),
1725     KNOWN_FOLDER(FOLDERID_SyncManagerFolder,
1726                  NO_CSIDL,
1727                  "SyncCenterFolder",
1728                  KF_CATEGORY_VIRTUAL,
1729                  GUID_NULL,
1730                  NULL,
1731                  "::{21EC2020-3AEA-1069-A2DD-08002B30309D}\\::{9C73F5E5-7AE7-4E32-A8E8-8D23B85255BF}\0"
1732                  "::{26EE0668-A00A-44D7-9371-BEB064C98683}\\0\\::{9C73F5E5-7AE7-4E32-A8E8-8D23B85255BF}\0\0" /* 6.1 */,
1733                  0,
1734                  0),
1735     KNOWN_FOLDER(FOLDERID_SyncResultsFolder,
1736                  NO_CSIDL,
1737                  "SyncResultsFolder",
1738                  KF_CATEGORY_VIRTUAL,
1739                  GUID_NULL,
1740                  NULL,
1741                  "::{21EC2020-3AEA-1069-A2DD-08002B30309D}\\::{9C73F5E5-7AE7-4E32-A8E8-8D23B85255BF}\\::{BC48B32F-5910-47F5-8570-5074A8A5636A},\0"
1742                  "::{26EE0668-A00A-44D7-9371-BEB064C98683}\\0\\::{9C73F5E5-7AE7-4E32-A8E8-8D23B85255BF}\\::{BC48B32F-5910-47F5-8570-5074A8A5636A},\0\0",
1743                  0,
1744                  0),
1745     KNOWN_FOLDER(FOLDERID_SyncSetupFolder,
1746                  NO_CSIDL,
1747                  "SyncSetupFolder",
1748                  KF_CATEGORY_VIRTUAL,
1749                  GUID_NULL,
1750                  NULL,
1751                  "::{21EC2020-3AEA-1069-A2DD-08002B30309D}\\::{9C73F5E5-7AE7-4E32-A8E8-8D23B85255BF}\\::{F1390A9A-A3F4-4E5D-9C5F-98F3BD8D935C},\0"
1752                  "::{26EE0668-A00A-44D7-9371-BEB064C98683}\\0\\::{9C73F5E5-7AE7-4E32-A8E8-8D23B85255BF}\\::{F1390A9A-A3F4-4E5D-9C5F-98F3BD8D935C},\0\0" /* 6.1 */,
1753                  0,
1754                  0),
1755     KNOWN_FOLDER(FOLDERID_System,
1756                  CSIDL_SYSTEM,
1757                  "System",
1758                  KF_CATEGORY_FIXED,
1759                  GUID_NULL,
1760                  NULL,
1761                  NULL,
1762                  0,
1763                  0),
1764     KNOWN_FOLDER(FOLDERID_SystemX86,
1765                  CSIDL_SYSTEMX86,
1766                  "SystemX86",
1767                  KF_CATEGORY_FIXED,
1768                  GUID_NULL,
1769                  NULL,
1770                  NULL,
1771                  0,
1772                  0),
1773     KNOWN_FOLDER(FOLDERID_Templates,
1774                  CSIDL_TEMPLATES,
1775                  "Templates",
1776                  KF_CATEGORY_PERUSER,
1777                  FOLDERID_RoamingAppData,
1778                  "Microsoft\\Windows\\Templates",
1779                  NULL,
1780                  0,
1781                  0),
1782     KNOWN_FOLDER(FOLDERID_UserPinned,
1783                  NO_CSIDL,
1784                  "User Pinned",
1785                  KF_CATEGORY_PERUSER,
1786                  FOLDERID_QuickLaunch,
1787                  "User Pinned",
1788                  NULL,
1789                  FILE_ATTRIBUTE_HIDDEN,
1790                  KFDF_PRECREATE),
1791     KNOWN_FOLDER(FOLDERID_UserProfiles,
1792                  NO_CSIDL,
1793                  "UserProfiles",
1794                  KF_CATEGORY_FIXED,
1795                  GUID_NULL,
1796                  NULL,
1797                  NULL,
1798                  FILE_ATTRIBUTE_READONLY,
1799                  KFDF_PRECREATE),
1800     KNOWN_FOLDER(FOLDERID_UserProgramFiles,
1801                  NO_CSIDL,
1802                  "UserProgramFiles",
1803                  KF_CATEGORY_PERUSER,
1804                  FOLDERID_LocalAppData,
1805                  "Programs",
1806                  NULL,
1807                  0,
1808                  0),
1809     KNOWN_FOLDER(FOLDERID_UserProgramFilesCommon,
1810                  NO_CSIDL,
1811                  "UserProgramFilesCommon",
1812                  KF_CATEGORY_PERUSER,
1813                  FOLDERID_UserProgramFiles,
1814                  "Common",
1815                  NULL,
1816                  0,
1817                  0),
1818     KNOWN_FOLDER(FOLDERID_UsersFiles,
1819                  NO_CSIDL,
1820                  "UsersFilesFolder",
1821                  KF_CATEGORY_VIRTUAL,
1822                  GUID_NULL,
1823                  NULL,
1824                  "::{59031a47-3f72-44a7-89c5-5595fe6b30ee}\0\0",
1825                  0,
1826                  0),
1827     KNOWN_FOLDER(FOLDERID_UsersLibraries,
1828                  NO_CSIDL,
1829                  "UsersLibrariesFolder",
1830                  KF_CATEGORY_VIRTUAL,
1831                  GUID_NULL,
1832                  NULL,
1833                  "::{031E4825-7B94-4dc3-B131-E946B44C8DD5}\0\0",
1834                  0,
1835                  0),
1836     KNOWN_FOLDER(FOLDERID_Videos,
1837                  CSIDL_MYVIDEO,
1838                  "My Video",
1839                  KF_CATEGORY_PERUSER,
1840                  FOLDERID_Profile,
1841                  "Videos",
1842                  "::{59031a47-3f72-44a7-89c5-5595fe6b30ee}\\{18989B1D-99B5-455B-841C-AB7C74E4DDFC}\0\0",
1843                  FILE_ATTRIBUTE_READONLY,
1844                  KFDF_ROAMABLE | KFDF_PRECREATE),
1845     KNOWN_FOLDER(FOLDERID_VideosLibrary,
1846                  NO_CSIDL,
1847                  "VideosLibrary",
1848                  KF_CATEGORY_PERUSER,
1849                  FOLDERID_Libraries,
1850                  "Videos.library-ms",
1851                  "::{031E4825-7B94-4dc3-B131-E946B44C8DD5}\\{491E922F-5643-4af4-A7EB-4E7A138D8174}\0\0",
1852                  0,
1853                  KFDF_PRECREATE | KFDF_STREAM),
1854     KNOWN_FOLDER(FOLDERID_Windows,
1855                  CSIDL_WINDOWS,
1856                  "Windows",
1857                  KF_CATEGORY_FIXED,
1858                  GUID_NULL,
1859                  NULL,
1860                  NULL,
1861                  0,
1862                  0),
1863     KNOWN_FOLDER(_FOLDERID_CredentialManager,
1864                  NO_CSIDL,
1865                  "CredentialManager",
1866                  KF_CATEGORY_FIXED,
1867                  GUID_NULL,
1868                  NULL,
1869                  NULL,
1870                  0,
1871                  0),
1872     KNOWN_FOLDER(_FOLDERID_CryptoKeys,
1873                  NO_CSIDL,
1874                  "CryptoKeys",
1875                  KF_CATEGORY_FIXED,
1876                  GUID_NULL,
1877                  NULL,
1878                  NULL,
1879                  0,
1880                  0),
1881     KNOWN_FOLDER(_FOLDERID_DpapiKeys,
1882                  NO_CSIDL,
1883                  "DpapiKeys",
1884                  KF_CATEGORY_FIXED,
1885                  GUID_NULL,
1886                  NULL,
1887                  NULL,
1888                  0,
1889                  0),
1890     KNOWN_FOLDER(_FOLDERID_SystemCertificates,
1891                  NO_CSIDL,
1892                  "SystemCertificates",
1893                  KF_CATEGORY_FIXED,
1894                  GUID_NULL,
1895                  NULL,
1896                  NULL,
1897                  0,
1898                  0),
1899     { NULL, NULL, 0, NULL, NULL, 0, 0 }
1900 };
1901 #undef KNOWN_FOLDER
1902 BOOL known_folder_found[sizeof(known_folders)/sizeof(known_folders[0])-1];
1903
1904 static void check_known_folder(IKnownFolderManager *mgr, KNOWNFOLDERID *folderId)
1905 {
1906     HRESULT hr;
1907     const struct knownFolderDef *known_folder = &known_folders[0];
1908     int csidl, expectedCsidl, ret;
1909     KNOWNFOLDER_DEFINITION kfd;
1910     IKnownFolder *folder;
1911     WCHAR sName[1024], sRelativePath[MAX_PATH], sParsingName[MAX_PATH];
1912     BOOL validPath;
1913     char sParentGuid[39];
1914     BOOL *current_known_folder_found = &known_folder_found[0];
1915     BOOL found = FALSE;
1916     const char *srcParsingName;
1917
1918     while(known_folder->folderId != NULL)
1919     {
1920         if(IsEqualGUID(known_folder->folderId, folderId))
1921         {
1922             *current_known_folder_found = TRUE;
1923             found = TRUE;
1924             /* verify CSIDL */
1925             if(known_folder->csidl != NO_CSIDL)
1926             {
1927                 expectedCsidl = known_folder->csidl & (~CSIDL_TODO_WINE);
1928
1929                 hr = IKnownFolderManager_FolderIdToCsidl(mgr, folderId, &csidl);
1930                 ok_(__FILE__, known_folder->line)(hr == S_OK, "cannot retrieve CSIDL for folder %s\n", known_folder->sFolderId);
1931
1932                 if(known_folder->csidl & CSIDL_TODO_WINE)
1933                     todo_wine ok_(__FILE__, known_folder->line)(csidl == expectedCsidl, "invalid CSIDL retrieved for folder %s. %d (%s) expected, but %d found\n", known_folder->sFolderId, expectedCsidl, known_folder->sCsidl, csidl);
1934                 else
1935                     ok_(__FILE__, known_folder->line)(csidl == expectedCsidl, "invalid CSIDL retrieved for folder %s. %d (%s) expected, but %d found\n", known_folder->sFolderId, expectedCsidl, known_folder->sCsidl, csidl);
1936             }
1937
1938             hr = IKnownFolderManager_GetFolder(mgr, folderId, &folder);
1939             ok_(__FILE__, known_folder->line)(hr == S_OK, "cannot get known folder for %s\n", known_folder->sFolderId);
1940             if(SUCCEEDED(hr))
1941             {
1942                 hr = IKnownFolder_GetFolderDefinition(folder, &kfd);
1943                 todo_wine
1944                 ok_(__FILE__, known_folder->line)(hr == S_OK, "cannot get known folder definition for %s\n", known_folder->sFolderId);
1945                 if(SUCCEEDED(hr))
1946                 {
1947                     ret = MultiByteToWideChar(CP_ACP, 0, known_folder->sName, -1,  sName, sizeof(sName)/sizeof(sName[0]));
1948                     ok_(__FILE__, known_folder->line)(ret != 0, "cannot convert known folder name \"%s\" to wide characters\n", known_folder->sName);
1949
1950                     todo_wine
1951                     ok_(__FILE__, known_folder->line)(lstrcmpW(kfd.pszName, sName)==0, "invalid known folder name returned for %s: %s expected, but %s retrieved\n", known_folder->sFolderId, wine_dbgstr_w(sName), wine_dbgstr_w(kfd.pszName));
1952
1953                     ok_(__FILE__, known_folder->line)(kfd.category == known_folder->category, "invalid known folder category for %s: %d expected, but %d retrieved\n", known_folder->sFolderId, known_folder->category, kfd.category);
1954
1955                     printGUID(&kfd.fidParent, sParentGuid);
1956                     ok_(__FILE__, known_folder->line)(IsEqualGUID(known_folder->fidParent, &kfd.fidParent), "invalid known folder parent for %s: %s expected, but %s retrieved\n", known_folder->sFolderId, known_folder->sParent, sParentGuid);
1957
1958                     if(!known_folder->sRelativePath)
1959                         validPath = (kfd.pszRelativePath==NULL);
1960                     else
1961                     {
1962                         ret = MultiByteToWideChar(CP_ACP, 0, known_folder->sRelativePath, -1, sRelativePath, sizeof(sRelativePath)/sizeof(sRelativePath[0]));
1963                         ok_(__FILE__, known_folder->line)(ret != 0, "cannot convert known folder path \"%s\" to wide characters\n", known_folder->sRelativePath);
1964
1965                         validPath = (lstrcmpW(kfd.pszRelativePath, sRelativePath)==0);
1966                     }
1967
1968                     ok_(__FILE__, known_folder->line)(validPath, "invalid known folder relative path returned for %s: %s expected, but %s retrieved\n", known_folder->sFolderId, known_folder->sRelativePath, wine_dbgstr_w(kfd.pszRelativePath));
1969
1970                     /* to check parsing name, we need to iterate list */
1971                     srcParsingName = known_folder->sParsingName;
1972
1973                     /* if we expect NULL, then we don't even check the list */
1974                     validPath = (srcParsingName==NULL) && (kfd.pszParsingName==NULL);
1975
1976                     if(srcParsingName)
1977                         while(*srcParsingName && !validPath)
1978                         {
1979                             /* when NULL is only one of possible value, we mark path as valid */
1980                             validPath = (strcmp(srcParsingName, "(null)")==0) && (kfd.pszParsingName==NULL);
1981
1982                             /* in the other case, we compare string from list with retrieved value */
1983                             if(!validPath)
1984                             {
1985                                 ret = MultiByteToWideChar(CP_ACP, 0, srcParsingName, -1, sParsingName, sizeof(sParsingName)/sizeof(sParsingName[0]));
1986                                 ok_(__FILE__, known_folder->line)(ret != 0, "cannot convert known folder path \"%s\" to wide characters\n", srcParsingName);
1987
1988                                 validPath = (lstrcmpW(kfd.pszParsingName, sParsingName)==0);
1989                             }
1990
1991                             srcParsingName += strlen(srcParsingName)+1;
1992                         }
1993
1994                     ok_(__FILE__, known_folder->line)(validPath, "invalid known folder parsing name returned for %s: %s retrieved\n", known_folder->sFolderId, wine_dbgstr_w(kfd.pszParsingName));
1995
1996                     ok_(__FILE__, known_folder->line)(known_folder->attributes == kfd.dwAttributes, "invalid known folder attributes for %s: 0x%08x expected, but 0x%08x retrieved\n", known_folder->sFolderId, known_folder->attributes, kfd.dwAttributes);
1997
1998                     ok_(__FILE__, known_folder->line)(!(kfd.kfdFlags & (~known_folder->definitionFlags)), "invalid known folder flags for %s: 0x%08x expected, but 0x%08x retrieved\n", known_folder->sFolderId, known_folder->definitionFlags, kfd.kfdFlags);
1999
2000                     FreeKnownFolderDefinitionFields(&kfd);
2001                 }
2002
2003             IKnownFolder_Release(folder);
2004             }
2005
2006             break;
2007         }
2008         known_folder++;
2009         current_known_folder_found++;
2010     }
2011
2012     if(!found)
2013     {
2014         printGUID(folderId, sParentGuid);
2015         trace("unknown known folder found: %s\n", sParentGuid);
2016
2017         hr = IKnownFolderManager_GetFolder(mgr, folderId, &folder);
2018         ok(hr == S_OK, "cannot get known folder for %s\n", sParentGuid);
2019         if(SUCCEEDED(hr))
2020         {
2021             hr = IKnownFolder_GetFolderDefinition(folder, &kfd);
2022             todo_wine
2023             ok(hr == S_OK, "cannot get known folder definition for %s\n", sParentGuid);
2024             if(SUCCEEDED(hr))
2025             {
2026                 trace("  category: %d\n", kfd.category);
2027                 trace("  name: %s\n", wine_dbgstr_w(kfd.pszName));
2028                 trace("  description: %s\n", wine_dbgstr_w(kfd.pszDescription));
2029                 printGUID(&kfd.fidParent, sParentGuid);
2030                 trace("  parent: %s\n", sParentGuid);
2031                 trace("  relative path: %s\n", wine_dbgstr_w(kfd.pszRelativePath));
2032                 trace("  parsing name: %s\n", wine_dbgstr_w(kfd.pszParsingName));
2033                 trace("  tooltip: %s\n", wine_dbgstr_w(kfd.pszTooltip));
2034                 trace("  localized name: %s\n", wine_dbgstr_w(kfd.pszLocalizedName));
2035                 trace("  icon: %s\n", wine_dbgstr_w(kfd.pszIcon));
2036                 trace("  security: %s\n", wine_dbgstr_w(kfd.pszSecurity));
2037                 trace("  attributes: 0x%08x\n", kfd.dwAttributes);
2038                 trace("  flags: 0x%08x\n", kfd.kfdFlags);
2039                 printGUID(&kfd.ftidType, sParentGuid);
2040                 trace("  type: %s\n", sParentGuid);
2041                 FreeKnownFolderDefinitionFields(&kfd);
2042             }
2043
2044             IKnownFolder_Release(folder);
2045         }
2046     }
2047 }
2048 #undef NO_CSIDL
2049 #undef CSIDL_TODO_WINE
2050
2051 static void test_knownFolders(void)
2052 {
2053     static const WCHAR sWindows[] = {'W','i','n','d','o','w','s',0};
2054     static const WCHAR sExample[] = {'E','x','a','m','p','l','e',0};
2055     static const WCHAR sExample2[] = {'E','x','a','m','p','l','e','2',0};
2056     static const WCHAR sSubFolder[] = {'S','u','b','F','o','l','d','e','r',0};
2057     static const WCHAR sBackslash[] = {'\\',0};
2058     static const KNOWNFOLDERID newFolderId = {0x01234567, 0x89AB, 0xCDEF, {0xFE, 0xDC, 0xBA, 0x98, 0x76, 0x54, 0x32, 0x01} };
2059     static const KNOWNFOLDERID subFolderId = {0xFEDCBA98, 0x7654, 0x3210, {0x01, 0x23, 0x45, 0x67, 0x89, 0xAB, 0xCD, 0xEF} };
2060     HRESULT hr;
2061     IKnownFolderManager *mgr = NULL;
2062     IKnownFolder *folder = NULL, *subFolder = NULL;
2063     KNOWNFOLDERID folderId, *folders;
2064     KF_CATEGORY cat = 0;
2065     KNOWNFOLDER_DEFINITION kfDefinition, kfSubDefinition;
2066     int csidl, i;
2067     UINT nCount = 0;
2068     LPWSTR folderPath, errorMsg;
2069     KF_REDIRECTION_CAPABILITIES redirectionCapabilities = 1;
2070     WCHAR sWinDir[MAX_PATH], sExamplePath[MAX_PATH], sExample2Path[MAX_PATH], sSubFolderPath[MAX_PATH], sSubFolder2Path[MAX_PATH];
2071     BOOL bRes;
2072     DWORD dwAttributes;
2073
2074     GetWindowsDirectoryW( sWinDir, MAX_PATH );
2075
2076     GetTempPathW(sizeof(sExamplePath)/sizeof(sExamplePath[0]), sExamplePath);
2077     lstrcatW(sExamplePath, sExample);
2078
2079     GetTempPathW(sizeof(sExample2Path)/sizeof(sExample2Path[0]), sExample2Path);
2080     lstrcatW(sExample2Path, sExample2);
2081
2082     lstrcpyW(sSubFolderPath, sExamplePath);
2083     lstrcatW(sSubFolderPath, sBackslash);
2084     lstrcatW(sSubFolderPath, sSubFolder);
2085
2086     lstrcpyW(sSubFolder2Path, sExample2Path);
2087     lstrcatW(sSubFolder2Path, sBackslash);
2088     lstrcatW(sSubFolder2Path, sSubFolder);
2089
2090     CoInitialize(NULL);
2091
2092     hr = CoCreateInstance(&CLSID_KnownFolderManager, NULL, CLSCTX_INPROC_SERVER,
2093                           &IID_IKnownFolderManager, (LPVOID*)&mgr);
2094     if(hr == REGDB_E_CLASSNOTREG)
2095         win_skip("IKnownFolderManager unavailable\n");
2096     else
2097     {
2098         ok(hr == S_OK, "failed to create KnownFolderManager instance: 0x%08x\n", hr);
2099
2100         hr = IKnownFolderManager_FolderIdFromCsidl(mgr, CSIDL_WINDOWS, &folderId);
2101         ok(hr == S_OK, "failed to convert CSIDL to KNOWNFOLDERID: 0x%08x\n", hr);
2102         ok(IsEqualGUID(&folderId, &FOLDERID_Windows)==TRUE, "invalid KNOWNFOLDERID returned\n");
2103
2104         hr = IKnownFolderManager_FolderIdToCsidl(mgr, &FOLDERID_Windows, &csidl);
2105         ok(hr == S_OK, "failed to convert CSIDL to KNOWNFOLDERID: 0x%08x\n", hr);
2106         ok(csidl == CSIDL_WINDOWS, "invalid CSIDL returned\n");
2107
2108         hr = IKnownFolderManager_GetFolder(mgr, &FOLDERID_Windows, &folder);
2109         ok(hr == S_OK, "failed to get known folder: 0x%08x\n", hr);
2110         if(SUCCEEDED(hr))
2111         {
2112             hr = IKnownFolder_GetCategory(folder, &cat);
2113             todo_wine
2114             ok(hr == S_OK, "failed to get folder category: 0x%08x\n", hr);
2115             todo_wine
2116             ok(cat==KF_CATEGORY_FIXED, "invalid folder category: %d\n", cat);
2117
2118             hr = IKnownFolder_GetId(folder, &folderId);
2119             ok(hr == S_OK, "failed to get folder id: 0x%08x\n", hr);
2120             ok(IsEqualGUID(&folderId, &FOLDERID_Windows)==TRUE, "invalid KNOWNFOLDERID returned\n");
2121
2122             hr = IKnownFolder_GetPath(folder, 0, &folderPath);
2123             ok(lstrcmpiW(sWinDir, folderPath)==0, "invalid path returned: \"%s\", expected: \"%s\"\n", wine_dbgstr_w(folderPath), wine_dbgstr_w(sWinDir));
2124             CoTaskMemFree(folderPath);
2125
2126             hr = IKnownFolder_GetRedirectionCapabilities(folder, &redirectionCapabilities);
2127             todo_wine
2128             ok(hr == S_OK, "failed to get redirection capabilities: 0x%08x\n", hr);
2129             todo_wine
2130             ok(redirectionCapabilities==0, "invalid redirection capabilities returned: %d\n", redirectionCapabilities);
2131
2132             hr = IKnownFolder_SetPath(folder, 0, sWinDir);
2133             todo_wine
2134             ok(hr == E_INVALIDARG, "unexpected value from SetPath: 0x%08x\n", hr);
2135
2136             hr = IKnownFolder_GetFolderDefinition(folder, &kfDefinition);
2137             todo_wine
2138             ok(hr == S_OK, "failed to get folder definition: 0x%08x\n", hr);
2139             if(SUCCEEDED(hr))
2140             {
2141                 todo_wine
2142                 ok(kfDefinition.category==KF_CATEGORY_FIXED, "invalid folder category: 0x%08x\n", kfDefinition.category);
2143                 todo_wine
2144                 ok(lstrcmpW(kfDefinition.pszName, sWindows)==0, "invalid folder name: %s\n", wine_dbgstr_w(kfDefinition.pszName));
2145                 todo_wine
2146                 ok(kfDefinition.dwAttributes==0, "invalid folder attributes: %d\n", kfDefinition.dwAttributes);
2147                 FreeKnownFolderDefinitionFields(&kfDefinition);
2148             }
2149
2150             hr = IKnownFolder_Release(folder);
2151             ok(hr == S_OK, "failed to release KnownFolder instance: 0x%08x\n", hr);
2152         }
2153
2154         hr = IKnownFolderManager_GetFolderByName(mgr, sWindows, &folder);
2155         todo_wine
2156         ok(hr == S_OK, "failed to get known folder: 0x%08x\n", hr);
2157         if(SUCCEEDED(hr))
2158         {
2159             hr = IKnownFolder_GetId(folder, &folderId);
2160             ok(hr == S_OK, "failed to get folder id: 0x%08x\n", hr);
2161             ok(IsEqualGUID(&folderId, &FOLDERID_Windows)==TRUE, "invalid KNOWNFOLDERID returned\n");
2162
2163             hr = IKnownFolder_Release(folder);
2164             ok(hr == S_OK, "failed to release KnownFolder instance: 0x%08x\n", hr);
2165         }
2166
2167         for(i=0; i<sizeof(known_folder_found)/sizeof(known_folder_found[0]); ++i)
2168             known_folder_found[i] = FALSE;
2169
2170         hr = IKnownFolderManager_GetFolderIds(mgr, &folders, &nCount);
2171         ok(hr == S_OK, "failed to get known folders: 0x%08x\n", hr);
2172         for(i=0;i<nCount;++i)
2173             check_known_folder(mgr, &folders[i]);
2174
2175         for(i=0; i<sizeof(known_folder_found)/sizeof(known_folder_found[0]); ++i)
2176             if(!known_folder_found[i])
2177                 trace("Known folder %s not found on current platform\n", known_folders[i].sFolderId);
2178
2179         CoTaskMemFree(folders);
2180
2181         /* test of registering new known folders */
2182         bRes = CreateDirectoryW(sExamplePath, NULL);
2183         ok(bRes, "cannot create example directory: %s\n", wine_dbgstr_w(sExamplePath));
2184         bRes = CreateDirectoryW(sExample2Path, NULL);
2185         ok(bRes, "cannot create example directory: %s\n", wine_dbgstr_w(sExample2Path));
2186         bRes = CreateDirectoryW(sSubFolderPath, NULL);
2187         ok(bRes, "cannot create example directory: %s\n", wine_dbgstr_w(sSubFolderPath));
2188
2189         ZeroMemory(&kfDefinition, sizeof(kfDefinition));
2190         kfDefinition.category = KF_CATEGORY_PERUSER;
2191         kfDefinition.pszName = CoTaskMemAlloc(sizeof(sExample));
2192         lstrcpyW(kfDefinition.pszName, sExample);
2193         kfDefinition.pszDescription = CoTaskMemAlloc(sizeof(sExample));
2194         lstrcpyW(kfDefinition.pszDescription, sExample);
2195         kfDefinition.pszRelativePath = CoTaskMemAlloc(sizeof(sExamplePath));
2196         lstrcpyW(kfDefinition.pszRelativePath, sExamplePath);
2197
2198         hr = IKnownFolderManager_RegisterFolder(mgr, &newFolderId, &kfDefinition);
2199         if(hr == HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED))
2200             win_skip("No permissions required to register custom known folder\n");
2201         else
2202         {
2203             ok(hr == S_OK, "failed to register known folder: 0x%08x\n", hr);
2204             if(SUCCEEDED(hr))
2205             {
2206                 hr = IKnownFolderManager_GetFolder(mgr, &newFolderId, &folder);
2207                 ok(hr == S_OK, "failed to get known folder: 0x%08x\n", hr);
2208                 if(SUCCEEDED(hr))
2209                 {
2210                     hr = IKnownFolder_GetCategory(folder, &cat);
2211                     ok(hr == S_OK, "failed to get folder category: hr=0x%0x\n", hr);
2212                     ok(cat == KF_CATEGORY_PERUSER, "invalid category returned: %d, while %d (KF_CATEGORY_PERUSER) expected\n", cat, KF_CATEGORY_PERUSER);
2213
2214                     hr = IKnownFolder_GetId(folder, &folderId);
2215                     ok(hr == S_OK, "failed to get folder id: 0x%08x\n", hr);
2216                     ok(IsEqualGUID(&folderId, &newFolderId)==TRUE, "invalid KNOWNFOLDERID returned\n");
2217
2218                     /* current path should be Temp\Example */
2219                     hr = IKnownFolder_GetPath(folder, 0, &folderPath);
2220                     ok(hr == S_OK, "failed to get path from known folder: 0x%08x\n", hr);
2221                     ok(lstrcmpiW(folderPath, sExamplePath)==0, "invalid known folder path retrieved: \"%s\" when \"%s\" was expected\n", wine_dbgstr_w(folderPath), wine_dbgstr_w(sExamplePath));
2222                     CoTaskMemFree(folderPath);
2223
2224                     /* register sub-folder and mark it as child of Example folder */
2225                     ZeroMemory(&kfSubDefinition, sizeof(kfSubDefinition));
2226                     kfSubDefinition.category = KF_CATEGORY_PERUSER;
2227                     kfSubDefinition.pszName = CoTaskMemAlloc(sizeof(sSubFolder));
2228                     lstrcpyW(kfSubDefinition.pszName, sSubFolder);
2229                     kfSubDefinition.pszDescription = CoTaskMemAlloc(sizeof(sSubFolder));
2230                     lstrcpyW(kfSubDefinition.pszDescription, sSubFolder);
2231                     kfSubDefinition.pszRelativePath = CoTaskMemAlloc(sizeof(sSubFolder));
2232                     lstrcpyW(kfSubDefinition.pszRelativePath, sSubFolder);
2233                     kfSubDefinition.fidParent = newFolderId;
2234
2235                     hr = IKnownFolderManager_RegisterFolder(mgr, &subFolderId, &kfSubDefinition);
2236                     ok(hr == S_OK, "failed to register known folder: 0x%08x\n", hr);
2237                     if(SUCCEEDED(hr))
2238                     {
2239
2240                         hr = IKnownFolderManager_GetFolder(mgr, &subFolderId, &subFolder);
2241                         ok(hr == S_OK, "failed to get known folder: 0x%08x\n", hr);
2242                         if(SUCCEEDED(hr))
2243                         {
2244                             /* check sub folder path */
2245                             hr = IKnownFolder_GetPath(subFolder, 0, &folderPath);
2246                             ok(hr == S_OK, "failed to get known folder path: 0x%08x\n", hr);
2247                             ok(lstrcmpiW(folderPath, sSubFolderPath)==0, "invalid known folder path retrieved: \"%s\" when \"%s\" was expected\n", wine_dbgstr_w(folderPath), wine_dbgstr_w(sSubFolderPath));
2248                             CoTaskMemFree(folderPath);
2249
2250
2251                             /* try to redirect Example to Temp\Example2  */
2252                             hr = IKnownFolderManager_Redirect(mgr, &newFolderId, NULL, 0, sExample2Path, 0, NULL, &errorMsg);
2253                             ok(hr == S_OK, "failed to redirect known folder: 0x%08x, errorMsg: %s\n", hr, wine_dbgstr_w(errorMsg));
2254
2255                             /* verify */
2256                             hr = IKnownFolder_GetPath(folder, 0, &folderPath);
2257                             ok(hr == S_OK, "failed to get known folder path: 0x%08x\n", hr);
2258                             ok(lstrcmpiW(folderPath, sExample2Path)==0, "invalid known folder path retrieved: \"%s\" when \"%s\" was expected\n", wine_dbgstr_w(folderPath), wine_dbgstr_w(sExample2Path));
2259                             CoTaskMemFree(folderPath);
2260
2261                             /* verify sub folder - it should fail now, as we redirected it's parent folder, but we have no sub folder in new location */
2262                             hr = IKnownFolder_GetPath(subFolder, 0, &folderPath);
2263                             ok(hr == HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND), "unexpected value from GetPath(): 0x%08x\n", hr);
2264                             ok(folderPath==NULL, "invalid known folder path retrieved: \"%s\" when NULL pointer was expected\n", wine_dbgstr_w(folderPath));
2265                             CoTaskMemFree(folderPath);
2266
2267
2268                             /* set Example path to original. Using SetPath() is valid here, as it also uses redirection internally */
2269                             hr = IKnownFolder_SetPath(folder, 0, sExamplePath);
2270                             ok(hr == S_OK, "SetPath() failed: 0x%08x\n", hr);
2271
2272                             /* verify */
2273                             hr = IKnownFolder_GetPath(folder, 0, &folderPath);
2274                             ok(hr == S_OK, "failed to get known folder path: 0x%08x\n", hr);
2275                             ok(lstrcmpiW(folderPath, sExamplePath)==0, "invalid known folder path retrieved: \"%s\" when \"%s\" was expected\n", wine_dbgstr_w(folderPath), wine_dbgstr_w(sExamplePath));
2276                             CoTaskMemFree(folderPath);
2277
2278
2279                             /* create sub folder in Temp\Example2 */
2280                             bRes = CreateDirectoryW(sSubFolder2Path, NULL);
2281                             ok(bRes, "cannot create example directory: %s\n", wine_dbgstr_w(sSubFolder2Path));
2282
2283                             /* again perform that same redirection */
2284                             hr = IKnownFolderManager_Redirect(mgr, &newFolderId, NULL, 0, sExample2Path, 0, NULL, &errorMsg);
2285                             ok(hr == S_OK, "failed to redirect known folder: 0x%08x, errorMsg: %s\n", hr, wine_dbgstr_w(errorMsg));
2286
2287                             /* verify sub folder. It should succeed now, as the required sub folder exists */
2288                             hr = IKnownFolder_GetPath(subFolder, 0, &folderPath);
2289                             ok(hr == S_OK, "failed to get known folder path: 0x%08x\n", hr);
2290                             ok(lstrcmpiW(folderPath, sSubFolder2Path)==0, "invalid known folder path retrieved: \"%s\" when \"%s\" was expected\n", wine_dbgstr_w(folderPath), wine_dbgstr_w(sSubFolder2Path));
2291                             CoTaskMemFree(folderPath);
2292
2293                             /* remove newly created directory */
2294                             RemoveDirectoryW(sSubFolder2Path);
2295
2296                             /* verify sub folder. It still succeedes, so Windows does not check folder presence each time */
2297                             hr = IKnownFolder_GetPath(subFolder, 0, &folderPath);
2298                             todo_wine
2299                             ok(hr == S_OK, "failed to get known folder path: 0x%08x\n", hr);
2300                             todo_wine
2301                             ok(lstrcmpiW(folderPath, sSubFolder2Path)==0, "invalid known folder path retrieved: \"%s\" when \"%s\" was expected\n", wine_dbgstr_w(folderPath), wine_dbgstr_w(sSubFolder2Path));
2302                             CoTaskMemFree(folderPath);
2303
2304
2305                             /* set Example path to original */
2306                             hr = IKnownFolder_SetPath(folder, 0, sExamplePath);
2307                             ok(hr == S_OK, "SetPath() failed: 0x%08x\n", hr);
2308
2309                             /* verify */
2310                             hr = IKnownFolder_GetPath(folder, 0, &folderPath);
2311                             ok(hr == S_OK, "failed to get known folder path: 0x%08x\n", hr);
2312                             ok(lstrcmpiW(folderPath, sExamplePath)==0, "invalid known folder path retrieved: \"%s\" when \"%s\" was expected\n", wine_dbgstr_w(folderPath), wine_dbgstr_w(sExamplePath));
2313                             CoTaskMemFree(folderPath);
2314
2315                             /* verify sub folder */
2316                             hr = IKnownFolder_GetPath(subFolder, 0, &folderPath);
2317                             ok(hr == S_OK, "failed to get known folder path: 0x%08x\n", hr);
2318                             ok(lstrcmpiW(folderPath, sSubFolderPath)==0, "invalid known folder path retrieved: \"%s\" when \"%s\" was expected\n", wine_dbgstr_w(folderPath), wine_dbgstr_w(sSubFolderPath));
2319                             CoTaskMemFree(folderPath);
2320
2321
2322                             /* create sub folder in Temp\Example2 */
2323                             bRes = CreateDirectoryW(sSubFolder2Path, NULL);
2324                             ok(bRes, "cannot create example directory: %s\n", wine_dbgstr_w(sSubFolder2Path));
2325
2326                             /* do that same redirection, but try to exclude sub-folder */
2327                             hr = IKnownFolderManager_Redirect(mgr, &newFolderId, NULL, 0, sExample2Path, 1, &subFolderId, &errorMsg);
2328                             ok(hr == S_OK, "failed to redirect known folder: 0x%08x, errorMsg: %s\n", hr, wine_dbgstr_w(errorMsg));
2329
2330                             /* verify */
2331                             hr = IKnownFolder_GetPath(folder, 0, &folderPath);
2332                             ok(hr == S_OK, "failed to get known folder path: 0x%08x\n", hr);
2333                             ok(lstrcmpiW(folderPath, sExample2Path)==0, "invalid known folder path retrieved: \"%s\" when \"%s\" was expected\n", wine_dbgstr_w(folderPath), wine_dbgstr_w(sExample2Path));
2334                             CoTaskMemFree(folderPath);
2335
2336                             /* verify sub folder. Unexpectedly, this path was also changed. So, exclusion seems to be ignored (Windows bug)? This test however will let us know, if this behavior is changed */
2337                             hr = IKnownFolder_GetPath(subFolder, 0, &folderPath);
2338                             ok(hr == S_OK, "failed to get known folder path: 0x%08x\n", hr);
2339                             ok(lstrcmpiW(folderPath, sSubFolder2Path)==0, "invalid known folder path retrieved: \"%s\" when \"%s\" was expected\n", wine_dbgstr_w(folderPath), wine_dbgstr_w(sSubFolder2Path));
2340                             CoTaskMemFree(folderPath);
2341
2342                             /* remove newly created directory */
2343                             RemoveDirectoryW(sSubFolder2Path);
2344
2345
2346                             /* set Example path to original */
2347                             hr = IKnownFolder_SetPath(folder, 0, sExamplePath);
2348                             ok(hr == S_OK, "SetPath() failed: 0x%08x\n", hr);
2349
2350                             /* verify */
2351                             hr = IKnownFolder_GetPath(folder, 0, &folderPath);
2352                             ok(hr == S_OK, "failed to get known folder path: 0x%08x\n", hr);
2353                             ok(lstrcmpiW(folderPath, sExamplePath)==0, "invalid known folder path retrieved: \"%s\" when \"%s\" was expected\n", wine_dbgstr_w(folderPath), wine_dbgstr_w(sExamplePath));
2354                             CoTaskMemFree(folderPath);
2355
2356                             /* verify sub folder */
2357                             hr = IKnownFolder_GetPath(subFolder, 0, &folderPath);
2358                             ok(hr == S_OK, "failed to get known folder path: 0x%08x\n", hr);
2359                             ok(lstrcmpiW(folderPath, sSubFolderPath)==0, "invalid known folder path retrieved: \"%s\" when \"%s\" was expected\n", wine_dbgstr_w(folderPath), wine_dbgstr_w(sSubFolderPath));
2360                             CoTaskMemFree(folderPath);
2361
2362
2363                             /* do that same redirection again, but set it to copy content. It should also copy the sub folder, so checking it would succeed now */
2364                             hr = IKnownFolderManager_Redirect(mgr, &newFolderId, NULL, KF_REDIRECT_COPY_CONTENTS, sExample2Path, 0, NULL, &errorMsg);
2365                             ok(hr == S_OK, "failed to redirect known folder: 0x%08x, errorMsg: %s\n", hr, wine_dbgstr_w(errorMsg));
2366
2367                             /* verify */
2368                             hr = IKnownFolder_GetPath(folder, 0, &folderPath);
2369                             ok(hr == S_OK, "failed to get known folder path: 0x%08x\n", hr);
2370                             ok(lstrcmpiW(folderPath, sExample2Path)==0, "invalid known folder path retrieved: \"%s\" when \"%s\" was expected\n", wine_dbgstr_w(folderPath), wine_dbgstr_w(sExample2Path));
2371                             CoTaskMemFree(folderPath);
2372
2373                             /* verify sub folder */
2374                             hr = IKnownFolder_GetPath(subFolder, 0, &folderPath);
2375                             ok(hr == S_OK, "failed to get known folder path: 0x%08x\n", hr);
2376                             ok(lstrcmpiW(folderPath, sSubFolder2Path)==0, "invalid known folder path retrieved: \"%s\" when \"%s\" was expected\n", wine_dbgstr_w(folderPath), wine_dbgstr_w(sSubFolder2Path));
2377                             CoTaskMemFree(folderPath);
2378
2379                             /* remove copied directory */
2380                             RemoveDirectoryW(sSubFolder2Path);
2381
2382
2383                             /* set Example path to original */
2384                             hr = IKnownFolder_SetPath(folder, 0, sExamplePath);
2385                             ok(hr == S_OK, "SetPath() failed: 0x%08x\n", hr);
2386
2387                             /* verify */
2388                             hr = IKnownFolder_GetPath(folder, 0, &folderPath);
2389                             ok(hr == S_OK, "failed to get known folder path: 0x%08x\n", hr);
2390                             ok(lstrcmpiW(folderPath, sExamplePath)==0, "invalid known folder path retrieved: \"%s\" when \"%s\" was expected\n", wine_dbgstr_w(folderPath), wine_dbgstr_w(sExamplePath));
2391                             CoTaskMemFree(folderPath);
2392
2393                             /* verify sub folder */
2394                             hr = IKnownFolder_GetPath(subFolder, 0, &folderPath);
2395                             ok(hr == S_OK, "failed to get known folder path: 0x%08x\n", hr);
2396                             ok(lstrcmpiW(folderPath, sSubFolderPath)==0, "invalid known folder path retrieved: \"%s\" when \"%s\" was expected\n", wine_dbgstr_w(folderPath), wine_dbgstr_w(sSubFolderPath));
2397                             CoTaskMemFree(folderPath);
2398
2399
2400                             /* redirect again, set it to copy content and remove originals */
2401                             hr = IKnownFolderManager_Redirect(mgr, &newFolderId, NULL, KF_REDIRECT_COPY_CONTENTS | KF_REDIRECT_DEL_SOURCE_CONTENTS, sExample2Path, 0, NULL, &errorMsg);
2402                             ok(hr == S_OK, "failed to redirect known folder: 0x%08x, errorMsg: %s\n", hr, wine_dbgstr_w(errorMsg));
2403
2404                             /* verify */
2405                             hr = IKnownFolder_GetPath(folder, 0, &folderPath);
2406                             ok(hr == S_OK, "failed to get known folder path: 0x%08x\n", hr);
2407                             ok(lstrcmpiW(folderPath, sExample2Path)==0, "invalid known folder path retrieved: \"%s\" when \"%s\" was expected\n", wine_dbgstr_w(folderPath), wine_dbgstr_w(sExample2Path));
2408                             CoTaskMemFree(folderPath);
2409
2410                             /* verify sub folder */
2411                             hr = IKnownFolder_GetPath(subFolder, 0, &folderPath);
2412                             ok(hr == S_OK, "failed to get known folder path: 0x%08x\n", hr);
2413                             ok(lstrcmpiW(folderPath, sSubFolder2Path)==0, "invalid known folder path retrieved: \"%s\" when \"%s\" was expected\n", wine_dbgstr_w(folderPath), wine_dbgstr_w(sSubFolder2Path));
2414                             CoTaskMemFree(folderPath);
2415
2416                             /* check if original directory was really removed */
2417                             dwAttributes = GetFileAttributesW(sExamplePath);
2418                             ok(dwAttributes==INVALID_FILE_ATTRIBUTES, "directory should not exist, but has attributes: 0x%08x\n", dwAttributes );
2419
2420
2421                             /* redirect (with copy) to original path */
2422                             hr = IKnownFolderManager_Redirect(mgr, &newFolderId, NULL, KF_REDIRECT_COPY_CONTENTS,  sExamplePath, 0, NULL, &errorMsg);
2423                             ok(hr == S_OK, "failed to redirect known folder: 0x%08x, errorMsg: %s\n", hr, wine_dbgstr_w(errorMsg));
2424
2425                             /* verify */
2426                             hr = IKnownFolder_GetPath(folder, 0, &folderPath);
2427                             ok(hr == S_OK, "failed to get known folder path: 0x%08x\n", hr);
2428                             ok(lstrcmpiW(folderPath, sExamplePath)==0, "invalid known folder path retrieved: \"%s\" when \"%s\" was expected\n", wine_dbgstr_w(folderPath), wine_dbgstr_w(sExamplePath));
2429                             CoTaskMemFree(folderPath);
2430
2431                             /* verify sub folder */
2432                             hr = IKnownFolder_GetPath(subFolder, 0, &folderPath);
2433                             ok(hr == S_OK, "failed to get known folder path: 0x%08x\n", hr);
2434                             ok(lstrcmpiW(folderPath, sSubFolderPath)==0, "invalid known folder path retrieved: \"%s\" when \"%s\" was expected\n", wine_dbgstr_w(folderPath), wine_dbgstr_w(sSubFolderPath));
2435                             CoTaskMemFree(folderPath);
2436
2437                             /* check shell utility functions */
2438                             if(!pSHGetKnownFolderPath || !pSHSetKnownFolderPath)
2439                                 todo_wine
2440                                 win_skip("cannot get SHGet/SetKnownFolderPath routines\n");
2441                             else
2442                             {
2443                                 /* try to get current known folder path */
2444                                 hr = pSHGetKnownFolderPath(&newFolderId, 0, NULL, &folderPath);
2445                                 todo_wine
2446                                 ok(hr==S_OK, "cannot get known folder path: hr=0x%0x\n", hr);
2447                                 todo_wine
2448                                 ok(lstrcmpW(folderPath, sExamplePath)==0, "invalid path returned: %s\n", wine_dbgstr_w(folderPath));
2449
2450                                 /* set it to new value */
2451                                 hr = pSHSetKnownFolderPath(&newFolderId, 0, NULL, sExample2Path);
2452                                 todo_wine
2453                                 ok(hr==S_OK, "cannot set known folder path: hr=0x%0x\n", hr);
2454
2455                                 /* check if it changed */
2456                                 hr = pSHGetKnownFolderPath(&newFolderId, 0, NULL, &folderPath);
2457                                 todo_wine
2458                                 ok(hr==S_OK, "cannot get known folder path: hr=0x%0x\n", hr);
2459                                 todo_wine
2460                                 ok(lstrcmpW(folderPath, sExample2Path)==0, "invalid path returned: %s\n", wine_dbgstr_w(folderPath));
2461
2462                                 /* set it back */
2463                                 hr = pSHSetKnownFolderPath(&newFolderId, 0, NULL, sExamplePath);
2464                                 todo_wine
2465                                 ok(hr==S_OK, "cannot set known folder path: hr=0x%0x\n", hr);
2466                             }
2467
2468                             IKnownFolder_Release(subFolder);
2469                         }
2470
2471                         hr = IKnownFolderManager_UnregisterFolder(mgr, &subFolderId);
2472                         ok(hr == S_OK, "failed to unregister folder: 0x%08x\n", hr);
2473                     }
2474
2475                     FreeKnownFolderDefinitionFields(&kfSubDefinition);
2476
2477                     hr = IKnownFolder_Release(folder);
2478                     ok(hr == S_OK, "failed to release KnownFolder instance: 0x%08x\n", hr);
2479                 }
2480
2481                 hr = IKnownFolderManager_UnregisterFolder(mgr, &newFolderId);
2482                 ok(hr == S_OK, "failed to unregister folder: 0x%08x\n", hr);
2483             }
2484         }
2485         FreeKnownFolderDefinitionFields(&kfDefinition);
2486
2487         RemoveDirectoryW(sSubFolder2Path);
2488         RemoveDirectoryW(sSubFolderPath);
2489         RemoveDirectoryW(sExamplePath);
2490         RemoveDirectoryW(sExample2Path);
2491
2492         hr = IKnownFolderManager_Release(mgr);
2493         ok(hr == S_OK, "failed to release KnownFolderManager instance: 0x%08x\n", hr);
2494     }
2495     CoUninitialize();
2496 }
2497
2498
2499 static void test_DoEnvironmentSubst(void)
2500 {
2501     WCHAR expectedW[MAX_PATH];
2502     WCHAR bufferW[MAX_PATH];
2503     CHAR  expectedA[MAX_PATH];
2504     CHAR  bufferA[MAX_PATH];
2505     DWORD res;
2506     DWORD res2;
2507     DWORD len;
2508     INT   i;
2509     static const WCHAR does_not_existW[] = {'%','D','O','E','S','_','N','O','T','_','E','X','I','S','T','%',0};
2510     static const CHAR  does_not_existA[] = "%DOES_NOT_EXIST%";
2511     static const CHAR  *names[] = {
2512                             /* interactive apps and services (works on all windows versions) */
2513                             "%ALLUSERSPROFILE%", "%APPDATA%", "%LOCALAPPDATA%",
2514                             "%NUMBER_OF_PROCESSORS%", "%OS%", "%PROCESSOR_ARCHITECTURE%",
2515                             "%PROCESSOR_IDENTIFIER%", "%PROCESSOR_LEVEL%", "%PROCESSOR_REVISION%",
2516                             "%ProgramFiles%", "%SystemDrive%",
2517                             "%SystemRoot%", "%USERPROFILE%", "%windir%",
2518                             /* todo_wine: "%COMPUTERNAME%", "%ProgramData%", "%PUBLIC%", */
2519
2520                             /* replace more than one var is allowed */
2521                             "%HOMEDRIVE%%HOMEPATH%",
2522                             "%OS% %windir%"}; /* always the last entry in the table */
2523
2524     for (i = 0; i < (sizeof(names)/sizeof(LPSTR)); i++)
2525     {
2526         memset(bufferA, '#', MAX_PATH - 1);
2527         bufferA[MAX_PATH - 1] = 0;
2528         lstrcpyA(bufferA, names[i]);
2529         MultiByteToWideChar(CP_ACP, 0, bufferA, MAX_PATH, bufferW, sizeof(bufferW)/sizeof(WCHAR));
2530
2531         res2 = ExpandEnvironmentStringsA(names[i], expectedA, MAX_PATH);
2532         res = DoEnvironmentSubstA(bufferA, MAX_PATH);
2533
2534         /* is the space for the terminating 0 included? */
2535         if (!i && HIWORD(res) && (LOWORD(res) == (lstrlenA(bufferA))))
2536         {
2537             win_skip("DoEnvironmentSubstA/W are broken on NT 4\n");
2538             return;
2539         }
2540         ok(HIWORD(res) && (LOWORD(res) == res2),
2541             "%d: got %d/%d (expected TRUE/%d)\n", i, HIWORD(res), LOWORD(res), res2);
2542         ok(!lstrcmpA(bufferA, expectedA),
2543             "%d: got %s (expected %s)\n", i, bufferA, expectedA);
2544
2545         res2 = ExpandEnvironmentStringsW(bufferW, expectedW, MAX_PATH);
2546         res = DoEnvironmentSubstW(bufferW, MAX_PATH);
2547         ok(HIWORD(res) && (LOWORD(res) == res2),
2548             "%d: got %d/%d (expected TRUE/%d)\n", i, HIWORD(res), LOWORD(res), res2);
2549         ok(!lstrcmpW(bufferW, expectedW),
2550             "%d: got %s (expected %s)\n", i, wine_dbgstr_w(bufferW), wine_dbgstr_w(expectedW));
2551     }
2552
2553     i--; /* reuse data in the last table entry */
2554     len = LOWORD(res); /* needed length */
2555
2556     /* one character extra is fine */
2557     memset(bufferA, '#', MAX_PATH - 1);
2558     bufferA[len + 2] = 0;
2559     lstrcpyA(bufferA, names[i]);
2560     MultiByteToWideChar(CP_ACP, 0, bufferA, MAX_PATH, bufferW, sizeof(bufferW)/sizeof(WCHAR));
2561
2562     res2 = ExpandEnvironmentStringsA(bufferA, expectedA, MAX_PATH);
2563     res = DoEnvironmentSubstA(bufferA, len + 1);
2564     ok(HIWORD(res) && (LOWORD(res) == res2),
2565         "+1: got %d/%d (expected TRUE/%d)\n", HIWORD(res), LOWORD(res), res2);
2566     ok(!lstrcmpA(bufferA, expectedA),
2567         "+1: got %s (expected %s)\n", bufferA, expectedA);
2568
2569     res2 = ExpandEnvironmentStringsW(bufferW, expectedW, MAX_PATH);
2570     res = DoEnvironmentSubstW(bufferW, len + 1);
2571     ok(HIWORD(res) && (LOWORD(res) == res2),
2572         "+1: got %d/%d (expected TRUE/%d)\n", HIWORD(res), LOWORD(res), res2);
2573     ok(!lstrcmpW(bufferW, expectedW),
2574         "+1: got %s (expected %s)\n", wine_dbgstr_w(bufferW), wine_dbgstr_w(expectedW));
2575
2576
2577     /* minimal buffer length (result string and terminating 0) */
2578     memset(bufferA, '#', MAX_PATH - 1);
2579     bufferA[len + 2] = 0;
2580     lstrcpyA(bufferA, names[i]);
2581     MultiByteToWideChar(CP_ACP, 0, bufferA, MAX_PATH, bufferW, sizeof(bufferW)/sizeof(WCHAR));
2582
2583     /* ANSI version failed without an extra byte, as documented on msdn */
2584     res = DoEnvironmentSubstA(bufferA, len);
2585     ok(!HIWORD(res) && (LOWORD(res) == len),
2586         " 0: got %d/%d  (expected FALSE/%d)\n", HIWORD(res), LOWORD(res), len);
2587     ok(!lstrcmpA(bufferA, names[i]),
2588         " 0: got %s (expected %s)\n", bufferA, names[i]);
2589
2590     /* DoEnvironmentSubstW works as expected */
2591     res2 = ExpandEnvironmentStringsW(bufferW, expectedW, MAX_PATH);
2592     res = DoEnvironmentSubstW(bufferW, len);
2593     ok(HIWORD(res) && (LOWORD(res) == res2),
2594         " 0: got %d/%d (expected TRUE/%d)\n", HIWORD(res), LOWORD(res), res2);
2595     ok(!lstrcmpW(bufferW, expectedW),
2596         " 0: got %s (expected %s)\n", wine_dbgstr_w(bufferW), wine_dbgstr_w(expectedW));
2597
2598
2599     /* buffer to small */
2600     /* result: FALSE / provided buffer length / the buffer is untouched */
2601     memset(bufferA, '#', MAX_PATH - 1);
2602     bufferA[len + 2] = 0;
2603     lstrcpyA(bufferA, names[i]);
2604     MultiByteToWideChar(CP_ACP, 0, bufferA, MAX_PATH, bufferW, sizeof(bufferW)/sizeof(WCHAR));
2605
2606     res = DoEnvironmentSubstA(bufferA, len - 1);
2607     ok(!HIWORD(res) && (LOWORD(res) == (len - 1)),
2608         "-1: got %d/%d  (expected FALSE/%d)\n", HIWORD(res), LOWORD(res), len - 1);
2609     ok(!lstrcmpA(bufferA, names[i]),
2610         "-1: got %s (expected %s)\n", bufferA, names[i]);
2611
2612     lstrcpyW(expectedW, bufferW);
2613     res = DoEnvironmentSubstW(bufferW, len - 1);
2614     ok(!HIWORD(res) && (LOWORD(res) == (len - 1)),
2615         "-1: got %d/%d  (expected FALSE/%d)\n", HIWORD(res), LOWORD(res), len - 1);
2616     ok(!lstrcmpW(bufferW, expectedW),
2617         "-1: got %s (expected %s)\n", wine_dbgstr_w(bufferW), wine_dbgstr_w(expectedW));
2618
2619
2620     /* unknown variable */
2621     /* result: TRUE / string length including terminating 0 / the buffer is untouched */
2622     memset(bufferA, '#', MAX_PATH - 1);
2623     bufferA[MAX_PATH - 1] = 0;
2624     lstrcpyA(bufferA, does_not_existA);
2625     MultiByteToWideChar(CP_ACP, 0, bufferA, MAX_PATH, bufferW, sizeof(bufferW)/sizeof(WCHAR));
2626
2627     res2 = lstrlenA(does_not_existA) + 1;
2628     res = DoEnvironmentSubstA(bufferA, MAX_PATH);
2629     ok(HIWORD(res) && (LOWORD(res) == res2),
2630             "%d: got %d/%d (expected TRUE/%d)\n", i, HIWORD(res), LOWORD(res), res2);
2631     ok(!lstrcmpA(bufferA, does_not_existA),
2632         "%d: got %s (expected %s)\n", i, bufferA, does_not_existA);
2633
2634     res = DoEnvironmentSubstW(bufferW, MAX_PATH);
2635     ok(HIWORD(res) && (LOWORD(res) == res2),
2636         "%d: got %d/%d (expected TRUE/%d)\n", i, HIWORD(res), LOWORD(res), res2);
2637     ok(!lstrcmpW(bufferW, does_not_existW),
2638         "%d: got %s (expected %s)\n", i, wine_dbgstr_w(bufferW), wine_dbgstr_w(does_not_existW));
2639
2640
2641     if (0)
2642     {
2643         /* NULL crashes on windows */
2644         res = DoEnvironmentSubstA(NULL, MAX_PATH);
2645         res = DoEnvironmentSubstW(NULL, MAX_PATH);
2646     }
2647 }
2648
2649 START_TEST(shellpath)
2650 {
2651     if (!init()) return;
2652
2653     loadShell32();
2654     pGetSystemWow64DirectoryA = (void *)GetProcAddress( GetModuleHandleA("kernel32.dll"),
2655                                                         "GetSystemWow64DirectoryA" );
2656     if (myARGC >= 3)
2657         doChild(myARGV[2]);
2658     else
2659     {
2660         /* Report missing functions once */
2661         if (!pSHGetFolderLocation)
2662             win_skip("SHGetFolderLocation is not available\n");
2663
2664         /* first test various combinations of parameters: */
2665         test_parameters();
2666
2667         /* check known values: */
2668         test_PidlTypes();
2669         test_GUIDs();
2670         test_EnvVars();
2671         testWinDir();
2672         testSystemDir();
2673         test_NonExistentPath();
2674         test_SHGetFolderPathEx();
2675         test_knownFolders();
2676         test_DoEnvironmentSubst();
2677     }
2678 }