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