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