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