projects / reactos.git / blob
? search:
summary | shortlog | log | commit | commitdiff | tree
history | raw | HEAD
[SHELL32]
[reactos.git] / reactos / dll / win32 / shell32 / CShellLink.cpp
1 /*
2 *
3 * Copyright 1997 Marcus Meissner
4 * Copyright 1998 Juergen Schmied
5 * Copyright 2005 Mike McCormack
6 * Copyright 2009 Andrew Hill
7 * Copyright 2013 Dominik Hornung
8 * Copyright 2017 Hermes Belusca-Maito
9 *
10 * This library is free software; you can redistribute it and/or
11 * modify it under the terms of the GNU Lesser General Public
12 * License as published by the Free Software Foundation; either
13 * version 2.1 of the License, or (at your option) any later version.
14 *
15 * This library is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
18 * Lesser General Public License for more details.
19 *
20 * You should have received a copy of the GNU Lesser General Public
21 * License along with this library; if not, write to the Free Software
22 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
23 *
24 * NOTES
25 * Nearly complete information about the binary formats
26 * of .lnk files available at http://www.wotsit.org
27 *
28 * You can use winedump to examine the contents of a link file:
29 * winedump lnk sc.lnk
30 *
31 * MSI advertised shortcuts are totally undocumented. They provide an
32 * icon for a program that is not yet installed, and invoke MSI to
33 * install the program when the shortcut is clicked on. They are
34 * created by passing a special string to SetPath, and the information
35 * in that string is parsed an stored.
36 */
37 /*
38 * In the following is listed more documentation about the Shell Link file format,
39 * as well as its interface.
40 *
41 * General introduction about "Shell Links" (MSDN):
42 * https://msdn.microsoft.com/en-us/library/windows/desktop/bb776891(v=vs.85).aspx
43 *
44 *
45 * Details of the file format:
46 *
47 * - Official MSDN documentation "[MS-SHLLINK]: Shell Link (.LNK) Binary File Format":
48 * https://msdn.microsoft.com/en-us/library/dd871305.aspx
49 *
50 * - Forensics:
51 * http://forensicswiki.org/wiki/LNK
52 * http://computerforensics.parsonage.co.uk/downloads/TheMeaningofLIFE.pdf
53 * https://ithreats.files.wordpress.com/2009/05/lnk_the_windows_shortcut_file_format.pdf
54 * https://github.com/libyal/liblnk/blob/master/documentation/Windows%20Shortcut%20File%20(LNK)%20format.asciidoc
55 *
56 * - List of possible shell link header flags (SHELL_LINK_DATA_FLAGS enumeration):
57 * https://msdn.microsoft.com/en-us/library/windows/desktop/bb762540(v=vs.85).aspx
58 * https://msdn.microsoft.com/en-us/library/dd891314.aspx
59 *
60 *
61 * In addition to storing its target by using a PIDL, a shell link file also
62 * stores metadata to make the shell able to track the link target, in situations
63 * where the link target is moved amongst local or network directories, or moved
64 * to different volumes. For this, two structures are used:
65 *
66 * - The first and oldest one (from NewShell/WinNT4) is the "LinkInfo" structure,
67 * stored in a serialized manner at the beginning of the shell link file:
68 * https://msdn.microsoft.com/en-us/library/dd871404.aspx
69 * The official API for manipulating this is located in LINKINFO.DLL .
70 *
71 * - The second, more recent one, is an extra binary block appended to the
72 * extra-data list of the shell link file: this is the "TrackerDataBlock":
73 * https://msdn.microsoft.com/en-us/library/dd891376.aspx
74 * Its purpose is for link tracking, and works in coordination with the
75 * "Distributed Link Tracking" service ('TrkWks' client, 'TrkSvr' server).
76 * See a detailed explanation at:
77 * http://www.serverwatch.com/tutorials/article.php/1476701/Searching-for-the-Missing-Link-Distributed-Link-Tracking.htm
78 *
79 *
80 * MSI installations most of the time create so-called "advertised shortcuts".
81 * They provide an icon for a program that may not be installed yet, and invoke
82 * MSI to install the program when the shortcut is opened (resolved).
83 * The philosophy of this approach is explained in detail inside the MSDN article
84 * "Application Resiliency: Unlock the Hidden Features of Windows Installer"
85 * (by Michael Sanford), here:
86 * https://msdn.microsoft.com/en-us/library/aa302344.aspx
87 *
88 * This functionality is implemented by adding a binary "Darwin" data block
89 * of type "EXP_DARWIN_LINK", signature EXP_DARWIN_ID_SIG == 0xA0000006,
90 * to the shell link file:
91 * https://msdn.microsoft.com/en-us/library/dd871369.aspx
92 * or, this could be done more simply by specifying a special link target path
93 * with the IShellLink::SetPath() function. Defining the following GUID:
94 * SHELL32_AdvtShortcutComponent = "::{9db1186e-40df-11d1-aa8c-00c04fb67863}:"
95 * setting a target of the form:
96 * "::{SHELL32_AdvtShortcutComponent}:<MSI_App_ID>"
97 * would automatically create the necessary binary block.
98 *
99 * With that, the target of the shortcut now becomes the MSI data. The latter
100 * is parsed from MSI and retrieved by the shell that then can run the program.
101 *
102 * This MSI functionality, dubbed "link blessing", actually originates from an
103 * older technology introduced in Internet Explorer 3 (and now obsolete since
104 * Internet Explorer 7), called "MS Internet Component Download (MSICD)", see
105 * this MSDN introductory article:
106 * https://msdn.microsoft.com/en-us/library/aa741198(v=vs.85).aspx
107 * and leveraged in Internet Explorer 4 with "Software Update Channels", see:
108 * https://msdn.microsoft.com/en-us/library/aa740931(v=vs.85).aspx
109 * Applications supporting this technology could present shell links having
110 * a special target, see subsection "Modifying the Shortcut" in the article:
111 * https://msdn.microsoft.com/en-us/library/aa741201(v=vs.85).aspx#pub_shor
112 *
113 * Similarly as for the MSI shortcuts, these MSICD shortcuts are created by
114 * specifying a special link target path with the IShellLink::SetPath() function,
115 * defining the following GUID:
116 * SHELL32_AdvtShortcutProduct = "::{9db1186f-40df-11d1-aa8c-00c04fb67863}:"
117 * and setting a target of the form:
118 * "::{SHELL32_AdvtShortcutProduct}:<AppName>::<Path>" .
119 * A tool, called "blesslnk.exe", was also provided for automatizing the process;
120 * its ReadMe can be found in the (now outdated) MS "Internet Client SDK" (INetSDK,
121 * for MS Windows 95 and NT), whose contents can be read at:
122 * http://www.msfn.org/board/topic/145352-new-windows-lnk-vulnerability/?page=4#comment-944223
123 * The MS INetSDK can be found at:
124 * https://web.archive.org/web/20100924000013/http://support.microsoft.com/kb/177877
125 *
126 * Internally the shell link target of these MSICD shortcuts is converted into
127 * a binary data block of a type similar to Darwin / "EXP_DARWIN_LINK", but with
128 * a different signature EXP_LOGO3_ID_SIG == 0xA0000007 . Such shell links are
129 * called "Logo3" shortcuts. They were evoked in this user comment in "The Old
130 * New Thing" blog:
131 * https://blogs.msdn.microsoft.com/oldnewthing/20121210-00/?p=5883#comment-1025083
132 *
133 * The shell exports the API 'SoftwareUpdateMessageBox' (in shdocvw.dll) that
134 * displays a message when an update for an application supporting this
135 * technology is available.
136 *
137 */
138
139 #include "precomp.h"
140
141 #include <appmgmt.h>
142
143 WINE_DEFAULT_DEBUG_CHANNEL(shell);
144
145 #define SHLINK_LOCAL 0
146 #define SHLINK_REMOTE 1
147 #define MAX_PROPERTY_SHEET_PAGE 32
148
149 /* link file formats */
150
151 #include "pshpack1.h"
152
153 struct LOCATION_INFO
154 {
155 DWORD dwTotalSize;
156 DWORD dwHeaderSize;
157 DWORD dwFlags;
158 DWORD dwVolTableOfs;
159 DWORD dwLocalPathOfs;
160 DWORD dwNetworkVolTableOfs;
161 DWORD dwFinalPathOfs;
162 };
163
164 struct LOCAL_VOLUME_INFO
165 {
166 DWORD dwSize;
167 DWORD dwType;
168 DWORD dwVolSerial;
169 DWORD dwVolLabelOfs;
170 };
171
172 struct volume_info
173 {
174 DWORD type;
175 DWORD serial;
176 WCHAR label[12]; /* assume 8.3 */
177 };
178
179 #include "poppack.h"
180
181 /* IShellLink Implementation */
182
183 static HRESULT ShellLink_UpdatePath(LPCWSTR sPathRel, LPCWSTR path, LPCWSTR sWorkDir, LPWSTR* psPath);
184
185 /* strdup on the process heap */
186 static LPWSTR __inline HEAP_strdupAtoW(HANDLE heap, DWORD flags, LPCSTR str)
187 {
188 INT len;
189 LPWSTR p;
190
191 assert(str);
192
193 len = MultiByteToWideChar(CP_ACP, 0, str, -1, NULL, 0);
194 p = (LPWSTR)HeapAlloc(heap, flags, len * sizeof(WCHAR));
195 if (!p)
196 return p;
197 MultiByteToWideChar(CP_ACP, 0, str, -1, p, len);
198 return p;
199 }
200
201 static LPWSTR __inline strdupW(LPCWSTR src)
202 {
203 LPWSTR dest;
204 if (!src) return NULL;
205 dest = (LPWSTR)HeapAlloc(GetProcessHeap(), 0, (wcslen(src) + 1) * sizeof(WCHAR));
206 if (dest)
207 wcscpy(dest, src);
208 return dest;
209 }
210
211 // TODO: Use it for constructor & destructor too
212 VOID CShellLink::Reset()
213 {
214 ILFree(m_pPidl);
215 m_pPidl = NULL;
216
217 HeapFree(GetProcessHeap(), 0, m_sPath);
218 m_sPath = NULL;
219 ZeroMemory(&volume, sizeof(volume));
220
221 HeapFree(GetProcessHeap(), 0, m_sDescription);
222 m_sDescription = NULL;
223 HeapFree(GetProcessHeap(), 0, m_sPathRel);
224 m_sPathRel = NULL;
225 HeapFree(GetProcessHeap(), 0, m_sWorkDir);
226 m_sWorkDir = NULL;
227 HeapFree(GetProcessHeap(), 0, m_sArgs);
228 m_sArgs = NULL;
229 HeapFree(GetProcessHeap(), 0, m_sIcoPath);
230 m_sIcoPath = NULL;
231
232 m_bRunAs = FALSE;
233 m_bDirty = FALSE;
234
235 if (m_pDBList)
236 SHFreeDataBlockList(m_pDBList);
237 m_pDBList = NULL;
238
239 /**/sProduct = sComponent = NULL;/**/
240 }
241
242 CShellLink::CShellLink()
243 {
244 m_Header.dwSize = sizeof(m_Header);
245 m_Header.clsid = CLSID_ShellLink;
246 m_Header.dwFlags = 0;
247
248 m_Header.dwFileAttributes = 0;
249 ZeroMemory(&m_Header.ftCreationTime, sizeof(m_Header.ftCreationTime));
250 ZeroMemory(&m_Header.ftLastAccessTime, sizeof(m_Header.ftLastAccessTime));
251 ZeroMemory(&m_Header.ftLastWriteTime, sizeof(m_Header.ftLastWriteTime));
252 m_Header.nFileSizeLow = 0;
253
254 m_Header.nIconIndex = 0;
255 m_Header.nShowCommand = SW_SHOWNORMAL;
256 m_Header.wHotKey = 0;
257
258 m_pPidl = NULL;
259
260 m_sPath = NULL;
261 ZeroMemory(&volume, sizeof(volume));
262
263 m_sDescription = NULL;
264 m_sPathRel = NULL;
265 m_sWorkDir = NULL;
266 m_sArgs = NULL;
267 m_sIcoPath = NULL;
268 m_bRunAs = FALSE;
269 m_bDirty = FALSE;
270 m_pDBList = NULL;
271
272 m_sLinkPath = NULL;
273 m_iIdOpen = -1;
274
275 /**/sProduct = sComponent = NULL;/**/
276 }
277
278 CShellLink::~CShellLink()
279 {
280 TRACE("-- destroying IShellLink(%p)\n", this);
281
282 ILFree(m_pPidl);
283
284 HeapFree(GetProcessHeap(), 0, m_sPath);
285
286 HeapFree(GetProcessHeap(), 0, m_sDescription);
287 HeapFree(GetProcessHeap(), 0, m_sPathRel);
288 HeapFree(GetProcessHeap(), 0, m_sWorkDir);
289 HeapFree(GetProcessHeap(), 0, m_sArgs);
290 HeapFree(GetProcessHeap(), 0, m_sIcoPath);
291 HeapFree(GetProcessHeap(), 0, m_sLinkPath);
292 SHFreeDataBlockList(m_pDBList);
293 }
294
295 HRESULT STDMETHODCALLTYPE CShellLink::GetClassID(CLSID *pclsid)
296 {
297 TRACE("%p %p\n", this, pclsid);
298
299 if (pclsid == NULL)
300 return E_POINTER;
301 *pclsid = CLSID_ShellLink;
302 return S_OK;
303 }
304
305 /************************************************************************
306 * IPersistStream_IsDirty (IPersistStream)
307 */
308 HRESULT STDMETHODCALLTYPE CShellLink::IsDirty()
309 {
310 TRACE("(%p)\n", this);
311 return (m_bDirty ? S_OK : S_FALSE);
312 }
313
314 HRESULT STDMETHODCALLTYPE CShellLink::Load(LPCOLESTR pszFileName, DWORD dwMode)
315 {
316 TRACE("(%p, %s, %x)\n", this, debugstr_w(pszFileName), dwMode);
317
318 if (dwMode == 0)
319 dwMode = STGM_READ | STGM_SHARE_DENY_WRITE;
320
321 CComPtr<IStream> stm;
322 HRESULT hr = SHCreateStreamOnFileW(pszFileName, dwMode, &stm);
323 if (SUCCEEDED(hr))
324 {
325 HeapFree(GetProcessHeap(), 0, m_sLinkPath);
326 m_sLinkPath = strdupW(pszFileName);
327 hr = Load(stm);
328 ShellLink_UpdatePath(m_sPathRel, pszFileName, m_sWorkDir, &m_sPath);
329 m_bDirty = FALSE;
330 }
331 TRACE("-- returning hr %08x\n", hr);
332 return hr;
333 }
334
335 HRESULT STDMETHODCALLTYPE CShellLink::Save(LPCOLESTR pszFileName, BOOL fRemember)
336 {
337 TRACE("(%p)->(%s)\n", this, debugstr_w(pszFileName));
338
339 if (!pszFileName)
340 return E_FAIL;
341
342 CComPtr<IStream> stm;
343 HRESULT hr = SHCreateStreamOnFileW(pszFileName, STGM_READWRITE | STGM_CREATE | STGM_SHARE_EXCLUSIVE, &stm);
344 if (SUCCEEDED(hr))
345 {
346 hr = Save(stm, FALSE);
347
348 if (SUCCEEDED(hr))
349 {
350 if (m_sLinkPath)
351 HeapFree(GetProcessHeap(), 0, m_sLinkPath);
352
353 m_sLinkPath = (LPWSTR)HeapAlloc(GetProcessHeap(), 0, (wcslen(pszFileName) + 1) * sizeof(WCHAR));
354 if (m_sLinkPath)
355 wcscpy(m_sLinkPath, pszFileName);
356
357 m_bDirty = FALSE;
358 }
359 else
360 {
361 DeleteFileW(pszFileName);
362 WARN("Failed to create shortcut %s\n", debugstr_w(pszFileName));
363 }
364 }
365
366 return hr;
367 }
368
369 HRESULT STDMETHODCALLTYPE CShellLink::SaveCompleted(LPCOLESTR pszFileName)
370 {
371 FIXME("(%p)->(%s)\n", this, debugstr_w(pszFileName));
372 return S_OK;
373 }
374
375 HRESULT STDMETHODCALLTYPE CShellLink::GetCurFile(LPOLESTR *ppszFileName)
376 {
377 *ppszFileName = NULL;
378
379 if (!m_sLinkPath)
380 {
381 /* IPersistFile::GetCurFile called before IPersistFile::Save */
382 return S_FALSE;
383 }
384
385 *ppszFileName = (LPOLESTR)CoTaskMemAlloc((wcslen(m_sLinkPath) + 1) * sizeof(WCHAR));
386 if (!*ppszFileName)
387 {
388 /* out of memory */
389 return E_OUTOFMEMORY;
390 }
391
392 /* copy last saved filename */
393 wcscpy(*ppszFileName, m_sLinkPath);
394
395 return S_OK;
396 }
397
398 static HRESULT Stream_LoadString(IStream* stm, BOOL unicode, LPWSTR *pstr)
399 {
400 TRACE("%p\n", stm);
401
402 USHORT len;
403 DWORD count = 0;
404 HRESULT hr = stm->Read(&len, sizeof(len), &count);
405 if (FAILED(hr) || count != sizeof(len))
406 return E_FAIL;
407
408 if (unicode)
409 len *= sizeof(WCHAR);
410
411 TRACE("reading %d\n", len);
412 LPSTR temp = (LPSTR)HeapAlloc(GetProcessHeap(), 0, len + sizeof(WCHAR));
413 if (!temp)
414 return E_OUTOFMEMORY;
415 count = 0;
416 hr = stm->Read(temp, len, &count);
417 if (FAILED(hr) || count != len)
418 {
419 HeapFree(GetProcessHeap(), 0, temp);
420 return E_FAIL;
421 }
422
423 TRACE("read %s\n", debugstr_an(temp, len));
424
425 /* convert to unicode if necessary */
426 LPWSTR str;
427 if (!unicode)
428 {
429 count = MultiByteToWideChar(CP_ACP, 0, temp, len, NULL, 0);
430 str = (LPWSTR)HeapAlloc(GetProcessHeap(), 0, (count + 1) * sizeof(WCHAR));
431 if (!str)
432 {
433 HeapFree(GetProcessHeap(), 0, temp);
434 return E_OUTOFMEMORY;
435 }
436 MultiByteToWideChar(CP_ACP, 0, temp, len, str, count);
437 HeapFree(GetProcessHeap(), 0, temp);
438 }
439 else
440 {
441 count /= sizeof(WCHAR);
442 str = (LPWSTR)temp;
443 }
444 str[count] = 0;
445
446 *pstr = str;
447
448 return S_OK;
449 }
450
451
452 /*
453 * NOTE: The following 5 functions are part of LINKINFO.DLL
454 */
455 static BOOL ShellLink_GetVolumeInfo(LPCWSTR path, CShellLink::volume_info *volume)
456 {
457 WCHAR drive[4] = { path[0], ':', '\\', 0 };
458
459 volume->type = GetDriveTypeW(drive);
460 BOOL bRet = GetVolumeInformationW(drive, volume->label, _countof(volume->label), &volume->serial, NULL, NULL, NULL, 0);
461 TRACE("ret = %d type %d serial %08x name %s\n", bRet,
462 volume->type, volume->serial, debugstr_w(volume->label));
463 return bRet;
464 }
465
466 static HRESULT Stream_ReadChunk(IStream* stm, LPVOID *data)
467 {
468 struct sized_chunk
469 {
470 DWORD size;
471 unsigned char data[1];
472 } *chunk;
473
474 TRACE("%p\n", stm);
475
476 DWORD size;
477 ULONG count;
478 HRESULT hr = stm->Read(&size, sizeof(size), &count);
479 if (FAILED(hr) || count != sizeof(size))
480 return E_FAIL;
481
482 chunk = static_cast<sized_chunk *>(HeapAlloc(GetProcessHeap(), 0, size));
483 if (!chunk)
484 return E_OUTOFMEMORY;
485
486 chunk->size = size;
487 hr = stm->Read(chunk->data, size - sizeof(size), &count);
488 if (FAILED(hr) || count != (size - sizeof(size)))
489 {
490 HeapFree(GetProcessHeap(), 0, chunk);
491 return E_FAIL;
492 }
493
494 TRACE("Read %d bytes\n", chunk->size);
495
496 *data = chunk;
497
498 return S_OK;
499 }
500
501 static BOOL Stream_LoadVolume(LOCAL_VOLUME_INFO *vol, CShellLink::volume_info *volume)
502 {
503 volume->serial = vol->dwVolSerial;
504 volume->type = vol->dwType;
505
506 if (!vol->dwVolLabelOfs)
507 return FALSE;
508 if (vol->dwSize <= vol->dwVolLabelOfs)
509 return FALSE;
510 INT len = vol->dwSize - vol->dwVolLabelOfs;
511
512 LPSTR label = (LPSTR)vol;
513 label += vol->dwVolLabelOfs;
514 MultiByteToWideChar(CP_ACP, 0, label, len, volume->label, _countof(volume->label));
515
516 return TRUE;
517 }
518
519 static LPWSTR Stream_LoadPath(LPCSTR p, DWORD maxlen)
520 {
521 UINT len = 0;
522
523 while (p[len] && len < maxlen)
524 len++;
525
526 UINT wlen = MultiByteToWideChar(CP_ACP, 0, p, len, NULL, 0);
527 LPWSTR path = (LPWSTR)HeapAlloc(GetProcessHeap(), 0, (wlen + 1) * sizeof(WCHAR));
528 if (!path)
529 return NULL;
530 MultiByteToWideChar(CP_ACP, 0, p, len, path, wlen);
531 path[wlen] = 0;
532
533 return path;
534 }
535
536 static HRESULT Stream_LoadLocation(IStream *stm,
537 CShellLink::volume_info *volume, LPWSTR *path)
538 {
539 char *p = NULL;
540 HRESULT hr = Stream_ReadChunk(stm, (LPVOID*) &p);
541 if (FAILED(hr))
542 return hr;
543
544 LOCATION_INFO *loc = reinterpret_cast<LOCATION_INFO *>(p);
545 if (loc->dwTotalSize < sizeof(LOCATION_INFO))
546 {
547 HeapFree(GetProcessHeap(), 0, p);
548 return E_FAIL;
549 }
550
551 /* if there's valid local volume information, load it */
552 if (loc->dwVolTableOfs &&
553 ((loc->dwVolTableOfs + sizeof(LOCAL_VOLUME_INFO)) <= loc->dwTotalSize))
554 {
555 LOCAL_VOLUME_INFO *volume_info;
556
557 volume_info = (LOCAL_VOLUME_INFO*) &p[loc->dwVolTableOfs];
558 Stream_LoadVolume(volume_info, volume);
559 }
560
561 /* if there's a local path, load it */
562 DWORD n = loc->dwLocalPathOfs;
563 if (n && n < loc->dwTotalSize)
564 *path = Stream_LoadPath(&p[n], loc->dwTotalSize - n);
565
566 TRACE("type %d serial %08x name %s path %s\n", volume->type,
567 volume->serial, debugstr_w(volume->label), debugstr_w(*path));
568
569 HeapFree(GetProcessHeap(), 0, p);
570 return S_OK;
571 }
572
573
574 /*
575 * The format of the advertised shortcut info is:
576 *
577 * Offset Description
578 * ------ -----------
579 * 0 Length of the block (4 bytes, usually 0x314)
580 * 4 tag (dword)
581 * 8 string data in ASCII
582 * 8+0x104 string data in UNICODE
583 *
584 * In the original Win32 implementation the buffers are not initialized
585 * to zero, so data trailing the string is random garbage.
586 */
587 HRESULT CShellLink::GetAdvertiseInfo(LPWSTR *str, DWORD dwSig)
588 {
589 LPEXP_DARWIN_LINK pInfo;
590
591 *str = NULL;
592
593 pInfo = (LPEXP_DARWIN_LINK)SHFindDataBlock(m_pDBList, dwSig);
594 if (!pInfo)
595 return E_FAIL;
596
597 /* Make sure that the size of the structure is valid */
598 if (pInfo->dbh.cbSize != sizeof(*pInfo))
599 {
600 ERR("Ooops. This structure is not as expected...\n");
601 return E_FAIL;
602 }
603
604 TRACE("dwSig %08x string = '%s'\n", pInfo->dbh.dwSignature, debugstr_w(pInfo->szwDarwinID));
605
606 *str = pInfo->szwDarwinID;
607 return S_OK;
608 }
609
610 /************************************************************************
611 * IPersistStream_Load (IPersistStream)
612 */
613 HRESULT STDMETHODCALLTYPE CShellLink::Load(IStream *stm)
614 {
615 TRACE("%p %p\n", this, stm);
616
617 if (!stm)
618 return STG_E_INVALIDPOINTER;
619
620 /* Free all the old stuff */
621 Reset();
622
623 ULONG dwBytesRead = 0;
624 HRESULT hr = stm->Read(&m_Header, sizeof(m_Header), &dwBytesRead);
625 if (FAILED(hr))
626 return hr;
627
628 if (dwBytesRead != sizeof(m_Header))
629 return E_FAIL;
630 if (m_Header.dwSize != sizeof(m_Header))
631 return E_FAIL;
632 if (!IsEqualIID(m_Header.clsid, CLSID_ShellLink))
633 return E_FAIL;
634
635 /* Load the new data in order */
636
637 if (TRACE_ON(shell))
638 {
639 SYSTEMTIME stCreationTime;
640 SYSTEMTIME stLastAccessTime;
641 SYSTEMTIME stLastWriteTime;
642 WCHAR sTemp[MAX_PATH];
643
644 FileTimeToSystemTime(&m_Header.ftCreationTime, &stCreationTime);
645 FileTimeToSystemTime(&m_Header.ftLastAccessTime, &stLastAccessTime);
646 FileTimeToSystemTime(&m_Header.ftLastWriteTime, &stLastWriteTime);
647
648 GetDateFormatW(LOCALE_USER_DEFAULT, DATE_SHORTDATE, &stCreationTime,
649 NULL, sTemp, _countof(sTemp));
650 TRACE("-- stCreationTime: %s\n", debugstr_w(sTemp));
651 GetDateFormatW(LOCALE_USER_DEFAULT, DATE_SHORTDATE, &stLastAccessTime,
652 NULL, sTemp, _countof(sTemp));
653 TRACE("-- stLastAccessTime: %s\n", debugstr_w(sTemp));
654 GetDateFormatW(LOCALE_USER_DEFAULT, DATE_SHORTDATE, &stLastWriteTime,
655 NULL, sTemp, _countof(sTemp));
656 TRACE("-- stLastWriteTime: %s\n", debugstr_w(sTemp));
657 }
658
659 /* load all the new stuff */
660 if (m_Header.dwFlags & SLDF_HAS_ID_LIST)
661 {
662 hr = ILLoadFromStream(stm, &m_pPidl);
663 if (FAILED(hr))
664 return hr;
665 }
666 pdump(m_pPidl);
667
668 /* Load the location information... */
669 if (m_Header.dwFlags & SLDF_HAS_LINK_INFO)
670 {
671 hr = Stream_LoadLocation(stm, &volume, &m_sPath);
672 if (FAILED(hr))
673 return hr;
674 }
675 /* ... but if it is required not to use it, clear it */
676 if (m_Header.dwFlags & SLDF_FORCE_NO_LINKINFO)
677 {
678 HeapFree(GetProcessHeap(), 0, m_sPath);
679 m_sPath = NULL;
680 ZeroMemory(&volume, sizeof(volume));
681 }
682
683 BOOL unicode = !!(m_Header.dwFlags & SLDF_UNICODE);
684
685 if (m_Header.dwFlags & SLDF_HAS_NAME)
686 {
687 hr = Stream_LoadString(stm, unicode, &m_sDescription);
688 if (FAILED(hr))
689 return hr;
690 TRACE("Description -> %s\n", debugstr_w(m_sDescription));
691 }
692
693 if (m_Header.dwFlags & SLDF_HAS_RELPATH)
694 {
695 hr = Stream_LoadString(stm, unicode, &m_sPathRel);
696 if (FAILED(hr))
697 return hr;
698 TRACE("Relative Path-> %s\n", debugstr_w(m_sPathRel));
699 }
700
701 if (m_Header.dwFlags & SLDF_HAS_WORKINGDIR)
702 {
703 hr = Stream_LoadString(stm, unicode, &m_sWorkDir);
704 if (FAILED(hr))
705 return hr;
706 PathRemoveBackslash(m_sWorkDir);
707 TRACE("Working Dir -> %s\n", debugstr_w(m_sWorkDir));
708 }
709
710 if (m_Header.dwFlags & SLDF_HAS_ARGS)
711 {
712 hr = Stream_LoadString(stm, unicode, &m_sArgs);
713 if (FAILED(hr))
714 return hr;
715 TRACE("Arguments -> %s\n", debugstr_w(m_sArgs));
716 }
717
718 if (m_Header.dwFlags & SLDF_HAS_ICONLOCATION)
719 {
720 hr = Stream_LoadString(stm, unicode, &m_sIcoPath);
721 if (FAILED(hr))
722 return hr;
723 TRACE("Icon file -> %s\n", debugstr_w(m_sIcoPath));
724 }
725
726 /* Now load the optional data block list */
727 hr = SHReadDataBlockList(stm, &m_pDBList);
728 if (FAILED(hr)) // FIXME: Should we fail?
729 return hr;
730
731 if (TRACE_ON(shell))
732 {
733 #if (NTDDI_VERSION < NTDDI_LONGHORN)
734 if (m_Header.dwFlags & SLDF_HAS_LOGO3ID)
735 {
736 hr = GetAdvertiseInfo(&sProduct, EXP_LOGO3_ID_SIG);
737 if (SUCCEEDED(hr))
738 TRACE("Product -> %s\n", debugstr_w(sProduct));
739 }
740 #endif
741 if (m_Header.dwFlags & SLDF_HAS_DARWINID)
742 {
743 hr = GetAdvertiseInfo(&sComponent, EXP_DARWIN_ID_SIG);
744 if (SUCCEEDED(hr))
745 TRACE("Component -> %s\n", debugstr_w(sComponent));
746 }
747 }
748
749 if (m_Header.dwFlags & SLDF_RUNAS_USER)
750 m_bRunAs = TRUE;
751 else
752 m_bRunAs = FALSE;
753
754 TRACE("OK\n");
755
756 pdump(m_pPidl);
757
758 return S_OK;
759 }
760
761 /************************************************************************
762 * Stream_WriteString
763 *
764 * Helper function for IPersistStream_Save. Writes a unicode string
765 * with terminating nul byte to a stream, preceded by the its length.
766 */
767 static HRESULT Stream_WriteString(IStream* stm, LPCWSTR str)
768 {
769 USHORT len = wcslen(str) + 1; // FIXME: Possible overflows?
770 DWORD count;
771
772 HRESULT hr = stm->Write(&len, sizeof(len), &count);
773 if (FAILED(hr))
774 return hr;
775
776 len *= sizeof(WCHAR);
777
778 hr = stm->Write(str, len, &count);
779 if (FAILED(hr))
780 return hr;
781
782 return S_OK;
783 }
784
785 /************************************************************************
786 * Stream_WriteLocationInfo
787 *
788 * Writes the location info to a stream
789 *
790 * FIXME: One day we might want to write the network volume information
791 * and the final path.
792 * Figure out how Windows deals with unicode paths here.
793 */
794 static HRESULT Stream_WriteLocationInfo(IStream* stm, LPCWSTR path,
795 CShellLink::volume_info *volume)
796 {
797 LOCAL_VOLUME_INFO *vol;
798 LOCATION_INFO *loc;
799
800 TRACE("%p %s %p\n", stm, debugstr_w(path), volume);
801
802 /* figure out the size of everything */
803 DWORD label_size = WideCharToMultiByte(CP_ACP, 0, volume->label, -1,
804 NULL, 0, NULL, NULL);
805 DWORD path_size = WideCharToMultiByte(CP_ACP, 0, path, -1,
806 NULL, 0, NULL, NULL);
807 DWORD volume_info_size = sizeof(*vol) + label_size;
808 DWORD final_path_size = 1;
809 DWORD total_size = sizeof(*loc) + volume_info_size + path_size + final_path_size;
810
811 /* create pointers to everything */
812 loc = static_cast<LOCATION_INFO *>(HeapAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY, total_size));
813 vol = (LOCAL_VOLUME_INFO*) &loc[1];
814 LPSTR szLabel = (LPSTR) &vol[1];
815 LPSTR szPath = &szLabel[label_size];
816 LPSTR szFinalPath = &szPath[path_size];
817
818 /* fill in the location information header */
819 loc->dwTotalSize = total_size;
820 loc->dwHeaderSize = sizeof(*loc);
821 loc->dwFlags = 1;
822 loc->dwVolTableOfs = sizeof(*loc);
823 loc->dwLocalPathOfs = sizeof(*loc) + volume_info_size;
824 loc->dwNetworkVolTableOfs = 0;
825 loc->dwFinalPathOfs = sizeof(*loc) + volume_info_size + path_size;
826
827 /* fill in the volume information */
828 vol->dwSize = volume_info_size;
829 vol->dwType = volume->type;
830 vol->dwVolSerial = volume->serial;
831 vol->dwVolLabelOfs = sizeof(*vol);
832
833 /* copy in the strings */
834 WideCharToMultiByte(CP_ACP, 0, volume->label, -1,
835 szLabel, label_size, NULL, NULL);
836 WideCharToMultiByte(CP_ACP, 0, path, -1,
837 szPath, path_size, NULL, NULL);
838 *szFinalPath = 0;
839
840 ULONG count = 0;
841 HRESULT hr = stm->Write(loc, total_size, &count);
842 HeapFree(GetProcessHeap(), 0, loc);
843
844 return hr;
845 }
846
847 /************************************************************************
848 * IPersistStream_Save (IPersistStream)
849 *
850 * FIXME: makes assumptions about byte order
851 */
852 HRESULT STDMETHODCALLTYPE CShellLink::Save(IStream *stm, BOOL fClearDirty)
853 {
854 TRACE("%p %p %x\n", this, stm, fClearDirty);
855
856 m_Header.dwSize = sizeof(m_Header);
857 m_Header.clsid = CLSID_ShellLink;
858
859 /*
860 * Reset the flags: keep only the flags related to data blocks as they were
861 * already set in accordance by the different mutator member functions.
862 * The other flags will be determined now by the presence or absence of data.
863 */
864 m_Header.dwFlags &= (SLDF_RUN_WITH_SHIMLAYER | SLDF_RUNAS_USER |
865 SLDF_RUN_IN_SEPARATE | SLDF_HAS_DARWINID |
866 #if (NTDDI_VERSION < NTDDI_LONGHORN)
867 SLDF_HAS_LOGO3ID |
868 #endif
869 SLDF_HAS_EXP_ICON_SZ | SLDF_HAS_EXP_SZ);
870 // TODO: When we will support Vista+ functionality, add other flags to this list.
871
872 /* The stored strings are in UNICODE */
873 m_Header.dwFlags |= SLDF_UNICODE;
874
875 if (m_pPidl)
876 m_Header.dwFlags |= SLDF_HAS_ID_LIST;
877 if (m_sPath)
878 m_Header.dwFlags |= SLDF_HAS_LINK_INFO;
879 if (m_sDescription && *m_sDescription)
880 m_Header.dwFlags |= SLDF_HAS_NAME;
881 if (m_sPathRel && *m_sPathRel)
882 m_Header.dwFlags |= SLDF_HAS_RELPATH;
883 if (m_sWorkDir && *m_sWorkDir)
884 m_Header.dwFlags |= SLDF_HAS_WORKINGDIR;
885 if (m_sArgs && *m_sArgs)
886 m_Header.dwFlags |= SLDF_HAS_ARGS;
887 if (m_sIcoPath && *m_sIcoPath)
888 m_Header.dwFlags |= SLDF_HAS_ICONLOCATION;
889 if (m_bRunAs)
890 m_Header.dwFlags |= SLDF_RUNAS_USER;
891
892 /* Write the shortcut header */
893 ULONG count;
894 HRESULT hr = stm->Write(&m_Header, sizeof(m_Header), &count);
895 if (FAILED(hr))
896 {
897 ERR("Write failed\n");
898 return hr;
899 }
900
901 /* Save the data in order */
902
903 if (m_pPidl)
904 {
905 hr = ILSaveToStream(stm, m_pPidl);
906 if (FAILED(hr))
907 {
908 ERR("Failed to write PIDL\n");
909 return hr;
910 }
911 }
912
913 if (m_sPath)
914 {
915 hr = Stream_WriteLocationInfo(stm, m_sPath, &volume);
916 if (FAILED(hr))
917 return hr;
918 }
919
920 if (m_Header.dwFlags & SLDF_HAS_NAME)
921 {
922 hr = Stream_WriteString(stm, m_sDescription);
923 if (FAILED(hr))
924 return hr;
925 }
926
927 if (m_Header.dwFlags & SLDF_HAS_RELPATH)
928 {
929 hr = Stream_WriteString(stm, m_sPathRel);
930 if (FAILED(hr))
931 return hr;
932 }
933
934 if (m_Header.dwFlags & SLDF_HAS_WORKINGDIR)
935 {
936 hr = Stream_WriteString(stm, m_sWorkDir);
937 if (FAILED(hr))
938 return hr;
939 }
940
941 if (m_Header.dwFlags & SLDF_HAS_ARGS)
942 {
943 hr = Stream_WriteString(stm, m_sArgs);
944 if (FAILED(hr))
945 return hr;
946 }
947
948 if (m_Header.dwFlags & SLDF_HAS_ICONLOCATION)
949 {
950 hr = Stream_WriteString(stm, m_sIcoPath);
951 if (FAILED(hr))
952 return hr;
953 }
954
955 /*
956 * Now save the data block list.
957 *
958 * NOTE that both advertised Product and Component are already saved
959 * inside Logo3 and Darwin data blocks in the m_pDBList list, and the
960 * m_Header.dwFlags is suitably initialized.
961 */
962 hr = SHWriteDataBlockList(stm, m_pDBList);
963 if (FAILED(hr))
964 return hr;
965
966 /* Clear the dirty bit if requested */
967 if (fClearDirty)
968 m_bDirty = FALSE;
969
970 return hr;
971 }
972
973 /************************************************************************
974 * IPersistStream_GetSizeMax (IPersistStream)
975 */
976 HRESULT STDMETHODCALLTYPE CShellLink::GetSizeMax(ULARGE_INTEGER *pcbSize)
977 {
978 TRACE("(%p)\n", this);
979 return E_NOTIMPL;
980 }
981
982 static BOOL SHELL_ExistsFileW(LPCWSTR path)
983 {
984 if (INVALID_FILE_ATTRIBUTES == GetFileAttributesW(path))
985 return FALSE;
986
987 return TRUE;
988 }
989
990 /**************************************************************************
991 * ShellLink_UpdatePath
992 * update absolute path in sPath using relative path in sPathRel
993 */
994 static HRESULT ShellLink_UpdatePath(LPCWSTR sPathRel, LPCWSTR path, LPCWSTR sWorkDir, LPWSTR* psPath)
995 {
996 if (!path || !psPath)
997 return E_INVALIDARG;
998
999 if (!*psPath && sPathRel)
1000 {
1001 WCHAR buffer[2*MAX_PATH], abs_path[2*MAX_PATH];
1002 LPWSTR final = NULL;
1003
1004 /* first try if [directory of link file] + [relative path] finds an existing file */
1005
1006 GetFullPathNameW(path, MAX_PATH * 2, buffer, &final);
1007 if (!final)
1008 final = buffer;
1009 wcscpy(final, sPathRel);
1010
1011 *abs_path = '\0';
1012
1013 if (SHELL_ExistsFileW(buffer))
1014 {
1015 if (!GetFullPathNameW(buffer, MAX_PATH, abs_path, &final))
1016 wcscpy(abs_path, buffer);
1017 }
1018 else
1019 {
1020 /* try if [working directory] + [relative path] finds an existing file */
1021 if (sWorkDir)
1022 {
1023 wcscpy(buffer, sWorkDir);
1024 wcscpy(PathAddBackslashW(buffer), sPathRel);
1025
1026 if (SHELL_ExistsFileW(buffer))
1027 if (!GetFullPathNameW(buffer, MAX_PATH, abs_path, &final))
1028 wcscpy(abs_path, buffer);
1029 }
1030 }
1031
1032 /* FIXME: This is even not enough - not all shell links can be resolved using this algorithm. */
1033 if (!*abs_path)
1034 wcscpy(abs_path, sPathRel);
1035
1036 *psPath = (LPWSTR)HeapAlloc(GetProcessHeap(), 0, (wcslen(abs_path) + 1) * sizeof(WCHAR));
1037 if (!*psPath)
1038 return E_OUTOFMEMORY;
1039
1040 wcscpy(*psPath, abs_path);
1041 }
1042
1043 return S_OK;
1044 }
1045
1046 HRESULT STDMETHODCALLTYPE CShellLink::GetPath(LPSTR pszFile, INT cchMaxPath, WIN32_FIND_DATAA *pfd, DWORD fFlags)
1047 {
1048 HRESULT hr;
1049 LPWSTR pszFileW;
1050 WIN32_FIND_DATAW wfd;
1051
1052 TRACE("(%p)->(pfile=%p len=%u find_data=%p flags=%u)(%s)\n",
1053 this, pszFile, cchMaxPath, pfd, fFlags, debugstr_w(m_sPath));
1054
1055 /* Allocate a temporary UNICODE buffer */
1056 pszFileW = (LPWSTR)HeapAlloc(GetProcessHeap(), 0, cchMaxPath * sizeof(WCHAR));
1057 if (!pszFileW)
1058 return E_OUTOFMEMORY;
1059
1060 /* Call the UNICODE function */
1061 hr = GetPath(pszFileW, cchMaxPath, &wfd, fFlags);
1062
1063 /* Convert the file path back to ANSI */
1064 WideCharToMultiByte(CP_ACP, 0, pszFileW, -1,
1065 pszFile, cchMaxPath, NULL, NULL);
1066
1067 /* Free the temporary buffer */
1068 HeapFree(GetProcessHeap(), 0, pszFileW);
1069
1070 if (pfd)
1071 {
1072 ZeroMemory(pfd, sizeof(*pfd));
1073
1074 /* Copy the file data if a file path was returned */
1075 if (*pszFile)
1076 {
1077 DWORD len;
1078
1079 /* Copy the fixed part */
1080 CopyMemory(pfd, &wfd, FIELD_OFFSET(WIN32_FIND_DATAA, cFileName));
1081
1082 /* Convert the file names to ANSI */
1083 len = lstrlenW(wfd.cFileName);
1084 WideCharToMultiByte(CP_ACP, 0, wfd.cFileName, len + 1,
1085 pfd->cFileName, sizeof(pfd->cFileName), NULL, NULL);
1086 len = lstrlenW(wfd.cAlternateFileName);
1087 WideCharToMultiByte(CP_ACP, 0, wfd.cAlternateFileName, len + 1,
1088 pfd->cAlternateFileName, sizeof(pfd->cAlternateFileName), NULL, NULL);
1089 }
1090 }
1091
1092 return hr;
1093 }
1094
1095 HRESULT STDMETHODCALLTYPE CShellLink::GetIDList(LPITEMIDLIST *ppidl)
1096 {
1097 TRACE("(%p)->(ppidl=%p)\n", this, ppidl);
1098
1099 if (!m_pPidl)
1100 {
1101 *ppidl = NULL;
1102 return S_FALSE;
1103 }
1104
1105 *ppidl = ILClone(m_pPidl);
1106 return S_OK;
1107 }
1108
1109 HRESULT STDMETHODCALLTYPE CShellLink::SetIDList(LPCITEMIDLIST pidl)
1110 {
1111 TRACE("(%p)->(pidl=%p)\n", this, pidl);
1112 return SetTargetFromPIDLOrPath(pidl, NULL);
1113 }
1114
1115 HRESULT STDMETHODCALLTYPE CShellLink::GetDescription(LPSTR pszName, INT cchMaxName)
1116 {
1117 TRACE("(%p)->(%p len=%u)\n", this, pszName, cchMaxName);
1118
1119 if (cchMaxName)
1120 *pszName = 0;
1121
1122 if (m_sDescription)
1123 WideCharToMultiByte(CP_ACP, 0, m_sDescription, -1,
1124 pszName, cchMaxName, NULL, NULL);
1125
1126 return S_OK;
1127 }
1128
1129 HRESULT STDMETHODCALLTYPE CShellLink::SetDescription(LPCSTR pszName)
1130 {
1131 TRACE("(%p)->(pName=%s)\n", this, pszName);
1132
1133 HeapFree(GetProcessHeap(), 0, m_sDescription);
1134 m_sDescription = NULL;
1135
1136 if (pszName)
1137 {
1138 m_sDescription = HEAP_strdupAtoW(GetProcessHeap(), 0, pszName);
1139 if (!m_sDescription)
1140 return E_OUTOFMEMORY;
1141 }
1142 m_bDirty = TRUE;
1143
1144 return S_OK;
1145 }
1146
1147 HRESULT STDMETHODCALLTYPE CShellLink::GetWorkingDirectory(LPSTR pszDir, INT cchMaxPath)
1148 {
1149 TRACE("(%p)->(%p len=%u)\n", this, pszDir, cchMaxPath);
1150
1151 if (cchMaxPath)
1152 *pszDir = 0;
1153
1154 if (m_sWorkDir)
1155 WideCharToMultiByte(CP_ACP, 0, m_sWorkDir, -1,
1156 pszDir, cchMaxPath, NULL, NULL);
1157
1158 return S_OK;
1159 }
1160
1161 HRESULT STDMETHODCALLTYPE CShellLink::SetWorkingDirectory(LPCSTR pszDir)
1162 {
1163 TRACE("(%p)->(dir=%s)\n", this, pszDir);
1164
1165 HeapFree(GetProcessHeap(), 0, m_sWorkDir);
1166 m_sWorkDir = NULL;
1167
1168 if (pszDir)
1169 {
1170 m_sWorkDir = HEAP_strdupAtoW(GetProcessHeap(), 0, pszDir);
1171 if (!m_sWorkDir)
1172 return E_OUTOFMEMORY;
1173 }
1174 m_bDirty = TRUE;
1175
1176 return S_OK;
1177 }
1178
1179 HRESULT STDMETHODCALLTYPE CShellLink::GetArguments(LPSTR pszArgs, INT cchMaxPath)
1180 {
1181 TRACE("(%p)->(%p len=%u)\n", this, pszArgs, cchMaxPath);
1182
1183 if (cchMaxPath)
1184 *pszArgs = 0;
1185
1186 if (m_sArgs)
1187 WideCharToMultiByte(CP_ACP, 0, m_sArgs, -1,
1188 pszArgs, cchMaxPath, NULL, NULL);
1189
1190 return S_OK;
1191 }
1192
1193 HRESULT STDMETHODCALLTYPE CShellLink::SetArguments(LPCSTR pszArgs)
1194 {
1195 TRACE("(%p)->(args=%s)\n", this, pszArgs);
1196
1197 HeapFree(GetProcessHeap(), 0, m_sArgs);
1198 m_sArgs = NULL;
1199
1200 if (pszArgs)
1201 {
1202 m_sArgs = HEAP_strdupAtoW(GetProcessHeap(), 0, pszArgs);
1203 if (!m_sArgs)
1204 return E_OUTOFMEMORY;
1205 }
1206
1207 m_bDirty = TRUE;
1208
1209 return S_OK;
1210 }
1211
1212 HRESULT STDMETHODCALLTYPE CShellLink::GetHotkey(WORD *pwHotkey)
1213 {
1214 TRACE("(%p)->(%p)(0x%08x)\n", this, pwHotkey, m_Header.wHotKey);
1215 *pwHotkey = m_Header.wHotKey;
1216 return S_OK;
1217 }
1218
1219 HRESULT STDMETHODCALLTYPE CShellLink::SetHotkey(WORD wHotkey)
1220 {
1221 TRACE("(%p)->(hotkey=%x)\n", this, wHotkey);
1222
1223 m_Header.wHotKey = wHotkey;
1224 m_bDirty = TRUE;
1225
1226 return S_OK;
1227 }
1228
1229 HRESULT STDMETHODCALLTYPE CShellLink::GetShowCmd(INT *piShowCmd)
1230 {
1231 TRACE("(%p)->(%p) %d\n", this, piShowCmd, m_Header.nShowCommand);
1232 *piShowCmd = m_Header.nShowCommand;
1233 return S_OK;
1234 }
1235
1236 HRESULT STDMETHODCALLTYPE CShellLink::SetShowCmd(INT iShowCmd)
1237 {
1238 TRACE("(%p) %d\n", this, iShowCmd);
1239
1240 m_Header.nShowCommand = iShowCmd;
1241 m_bDirty = TRUE;
1242
1243 return S_OK;
1244 }
1245
1246 HRESULT STDMETHODCALLTYPE CShellLink::GetIconLocation(LPSTR pszIconPath, INT cchIconPath, INT *piIcon)
1247 {
1248 HRESULT hr;
1249 LPWSTR pszIconPathW;
1250
1251 TRACE("(%p)->(%p len=%u iicon=%p)\n", this, pszIconPath, cchIconPath, piIcon);
1252
1253 /* Allocate a temporary UNICODE buffer */
1254 pszIconPathW = (LPWSTR)HeapAlloc(GetProcessHeap(), 0, cchIconPath * sizeof(WCHAR));
1255 if (!pszIconPathW)
1256 return E_OUTOFMEMORY;
1257
1258 /* Call the UNICODE function */
1259 hr = GetIconLocation(pszIconPathW, cchIconPath, piIcon);
1260
1261 /* Convert the file path back to ANSI */
1262 WideCharToMultiByte(CP_ACP, 0, pszIconPathW, -1,
1263 pszIconPath, cchIconPath, NULL, NULL);
1264
1265 /* Free the temporary buffer */
1266 HeapFree(GetProcessHeap(), 0, pszIconPathW);
1267
1268 return hr;
1269 }
1270
1271 HRESULT STDMETHODCALLTYPE CShellLink::GetIconLocation(UINT uFlags, PSTR pszIconFile, UINT cchMax, int *piIndex, UINT *pwFlags)
1272 {
1273 HRESULT hr;
1274 LPWSTR pszIconFileW;
1275
1276 TRACE("(%p)->(%u %p len=%u piIndex=%p pwFlags=%p)\n", this, uFlags, pszIconFile, cchMax, piIndex, pwFlags);
1277
1278 /* Allocate a temporary UNICODE buffer */
1279 pszIconFileW = (LPWSTR)HeapAlloc(GetProcessHeap(), 0, cchMax * sizeof(WCHAR));
1280 if (!pszIconFileW)
1281 return E_OUTOFMEMORY;
1282
1283 /* Call the UNICODE function */
1284 hr = GetIconLocation(uFlags, pszIconFileW, cchMax, piIndex, pwFlags);
1285
1286 /* Convert the file path back to ANSI */
1287 WideCharToMultiByte(CP_ACP, 0, pszIconFileW, -1,
1288 pszIconFile, cchMax, NULL, NULL);
1289
1290 /* Free the temporary buffer */
1291 HeapFree(GetProcessHeap(), 0, pszIconFileW);
1292
1293 return hr;
1294 }
1295
1296 HRESULT STDMETHODCALLTYPE CShellLink::Extract(PCSTR pszFile, UINT nIconIndex, HICON *phiconLarge, HICON *phiconSmall, UINT nIconSize)
1297 {
1298 TRACE("(%p)->(path=%s iicon=%u)\n", this, pszFile, nIconIndex);
1299
1300 LPWSTR str = NULL;
1301 if (pszFile)
1302 {
1303 str = HEAP_strdupAtoW(GetProcessHeap(), 0, pszFile);
1304 if (!str)
1305 return E_OUTOFMEMORY;
1306 }
1307
1308 HRESULT hr = Extract(str, nIconIndex, phiconLarge, phiconSmall, nIconSize);
1309
1310 if (str)
1311 HeapFree(GetProcessHeap(), 0, str);
1312
1313 return hr;
1314 }
1315
1316 HRESULT STDMETHODCALLTYPE CShellLink::SetIconLocation(LPCSTR pszIconPath, INT iIcon)
1317 {
1318 TRACE("(%p)->(path=%s iicon=%u)\n", this, pszIconPath, iIcon);
1319
1320 LPWSTR str = NULL;
1321 if (pszIconPath)
1322 {
1323 str = HEAP_strdupAtoW(GetProcessHeap(), 0, pszIconPath);
1324 if (!str)
1325 return E_OUTOFMEMORY;
1326 }
1327
1328 HRESULT hr = SetIconLocation(str, iIcon);
1329
1330 if (str)
1331 HeapFree(GetProcessHeap(), 0, str);
1332
1333 return hr;
1334 }
1335
1336 HRESULT STDMETHODCALLTYPE CShellLink::SetRelativePath(LPCSTR pszPathRel, DWORD dwReserved)
1337 {
1338 TRACE("(%p)->(path=%s %x)\n", this, pszPathRel, dwReserved);
1339
1340 HeapFree(GetProcessHeap(), 0, m_sPathRel);
1341 m_sPathRel = NULL;
1342
1343 if (pszPathRel)
1344 {
1345 m_sPathRel = HEAP_strdupAtoW(GetProcessHeap(), 0, pszPathRel);
1346 m_bDirty = TRUE;
1347 }
1348
1349 return ShellLink_UpdatePath(m_sPathRel, m_sPath, m_sWorkDir, &m_sPath);
1350 }
1351
1352 static LPWSTR
1353 shelllink_get_msi_component_path(LPWSTR component)
1354 {
1355 DWORD Result, sz = 0;
1356
1357 Result = CommandLineFromMsiDescriptor(component, NULL, &sz);
1358 if (Result != ERROR_SUCCESS)
1359 return NULL;
1360
1361 sz++;
1362 LPWSTR path = (LPWSTR)HeapAlloc(GetProcessHeap(), 0, sz * sizeof(WCHAR));
1363 Result = CommandLineFromMsiDescriptor(component, path, &sz);
1364 if (Result != ERROR_SUCCESS)
1365 {
1366 HeapFree(GetProcessHeap(), 0, path);
1367 path = NULL;
1368 }
1369
1370 TRACE("returning %s\n", debugstr_w(path));
1371
1372 return path;
1373 }
1374
1375 HRESULT STDMETHODCALLTYPE CShellLink::Resolve(HWND hwnd, DWORD fFlags)
1376 {
1377 HRESULT hr = S_OK;
1378 BOOL bSuccess;
1379
1380 TRACE("(%p)->(hwnd=%p flags=%x)\n", this, hwnd, fFlags);
1381
1382 /* FIXME: use IResolveShellLink interface? */
1383
1384 // FIXME: See InvokeCommand().
1385
1386 #if (NTDDI_VERSION < NTDDI_LONGHORN)
1387 // NOTE: For Logo3 (EXP_LOGO3_ID_SIG), check also for SHRestricted(REST_NOLOGO3CHANNELNOTIFY)
1388 if (m_Header.dwFlags & SLDF_HAS_LOGO3ID)
1389 {
1390 FIXME("Logo3 links are not supported yet!\n");
1391 return E_FAIL;
1392 }
1393 #endif
1394
1395 /* Resolve Darwin (MSI) target */
1396 if (m_Header.dwFlags & SLDF_HAS_DARWINID)
1397 {
1398 LPWSTR component = NULL;
1399 hr = GetAdvertiseInfo(&component, EXP_DARWIN_ID_SIG);
1400 if (FAILED(hr))
1401 return E_FAIL;
1402
1403 /* Clear the cached path */
1404 HeapFree(GetProcessHeap(), 0, m_sPath);
1405 m_sPath = NULL;
1406 m_sPath = shelllink_get_msi_component_path(component);
1407 if (!m_sPath)
1408 return E_FAIL;
1409 }
1410
1411 if (!m_sPath && m_pPidl)
1412 {
1413 WCHAR buffer[MAX_PATH];
1414
1415 bSuccess = SHGetPathFromIDListW(m_pPidl, buffer);
1416 if (bSuccess && *buffer)
1417 {
1418 m_sPath = (LPWSTR)HeapAlloc(GetProcessHeap(), 0, (wcslen(buffer) + 1) * sizeof(WCHAR));
1419 if (!m_sPath)
1420 return E_OUTOFMEMORY;
1421
1422 wcscpy(m_sPath, buffer);
1423
1424 m_bDirty = TRUE;
1425 }
1426 else
1427 {
1428 hr = S_OK; /* don't report an error occurred while just caching information */
1429 }
1430 }
1431
1432 // FIXME: Strange to do that here...
1433 if (!m_sIcoPath && m_sPath)
1434 {
1435 m_sIcoPath = (LPWSTR)HeapAlloc(GetProcessHeap(), 0, (wcslen(m_sPath) + 1) * sizeof(WCHAR));
1436 if (!m_sIcoPath)
1437 return E_OUTOFMEMORY;
1438
1439 wcscpy(m_sIcoPath, m_sPath);
1440 m_Header.nIconIndex = 0;
1441
1442 m_bDirty = TRUE;
1443 }
1444
1445 return hr;
1446 }
1447
1448 HRESULT STDMETHODCALLTYPE CShellLink::SetPath(LPCSTR pszFile)
1449 {
1450 TRACE("(%p)->(path=%s)\n", this, pszFile);
1451
1452 if (!pszFile)
1453 return E_INVALIDARG;
1454
1455 LPWSTR str = HEAP_strdupAtoW(GetProcessHeap(), 0, pszFile);
1456 if (!str)
1457 return E_OUTOFMEMORY;
1458
1459 HRESULT hr = SetPath(str);
1460 HeapFree(GetProcessHeap(), 0, str);
1461
1462 return hr;
1463 }
1464
1465 HRESULT STDMETHODCALLTYPE CShellLink::GetPath(LPWSTR pszFile, INT cchMaxPath, WIN32_FIND_DATAW *pfd, DWORD fFlags)
1466 {
1467 WCHAR buffer[MAX_PATH];
1468
1469 TRACE("(%p)->(pfile=%p len=%u find_data=%p flags=%u)(%s)\n",
1470 this, pszFile, cchMaxPath, pfd, fFlags, debugstr_w(m_sPath));
1471
1472 if (cchMaxPath)
1473 *pszFile = 0;
1474 // FIXME: What if cchMaxPath == 0 , or pszFile == NULL ??
1475
1476 // FIXME: What about Darwin??
1477
1478 /*
1479 * Retrieve the path to the target from the PIDL (if we have one).
1480 * NOTE: Do NOT use the cached path (m_sPath from link info).
1481 */
1482 if (m_pPidl && SHGetPathFromIDListW(m_pPidl, buffer))
1483 {
1484 if (fFlags & SLGP_SHORTPATH)
1485 GetShortPathNameW(buffer, buffer, _countof(buffer));
1486 // FIXME: Add support for SLGP_UNCPRIORITY
1487 }
1488 else
1489 {
1490 *buffer = 0;
1491 }
1492
1493 /* If we have a FindData structure, initialize it */
1494 if (pfd)
1495 {
1496 ZeroMemory(pfd, sizeof(*pfd));
1497
1498 /* Copy the file data if the target is a file path */
1499 if (*buffer)
1500 {
1501 pfd->dwFileAttributes = m_Header.dwFileAttributes;
1502 pfd->ftCreationTime = m_Header.ftCreationTime;
1503 pfd->ftLastAccessTime = m_Header.ftLastAccessTime;
1504 pfd->ftLastWriteTime = m_Header.ftLastWriteTime;
1505 pfd->nFileSizeHigh = 0;
1506 pfd->nFileSizeLow = m_Header.nFileSizeLow;
1507
1508 /*
1509 * Build temporarily a short path in pfd->cFileName (of size MAX_PATH),
1510 * then extract and store the short file name in pfd->cAlternateFileName.
1511 */
1512 GetShortPathNameW(buffer, pfd->cFileName, _countof(pfd->cFileName));
1513 lstrcpynW(pfd->cAlternateFileName,
1514 PathFindFileNameW(pfd->cFileName),
1515 _countof(pfd->cAlternateFileName));
1516
1517 /* Now extract and store the long file name in pfd->cFileName */
1518 lstrcpynW(pfd->cFileName,
1519 PathFindFileNameW(buffer),
1520 _countof(pfd->cFileName));
1521 }
1522 }
1523
1524 /* Finally check if we have a raw path the user actually wants to retrieve */
1525 if ((fFlags & SLGP_RAWPATH) && (m_Header.dwFlags & SLDF_HAS_EXP_SZ))
1526 {
1527 /* Search for a target environment block */
1528 LPEXP_SZ_LINK pInfo;
1529 pInfo = (LPEXP_SZ_LINK)SHFindDataBlock(m_pDBList, EXP_SZ_LINK_SIG);
1530 if (pInfo && (pInfo->cbSize == sizeof(*pInfo)))
1531 lstrcpynW(buffer, pInfo->szwTarget, cchMaxPath);
1532 }
1533
1534 /* For diagnostics purposes only... */
1535 // NOTE: SLGP_UNCPRIORITY is unsupported
1536 fFlags &= ~(SLGP_RAWPATH | SLGP_SHORTPATH);
1537 if (fFlags) FIXME("(%p): Unsupported flags %lu\n", this, fFlags);
1538
1539 /* Copy the data back to the user */
1540 if (*buffer)
1541 lstrcpynW(pszFile, buffer, cchMaxPath);
1542
1543 return (*buffer ? S_OK : S_FALSE);
1544 }
1545
1546 HRESULT STDMETHODCALLTYPE CShellLink::GetDescription(LPWSTR pszName, INT cchMaxName)
1547 {
1548 TRACE("(%p)->(%p len=%u)\n", this, pszName, cchMaxName);
1549
1550 *pszName = 0;
1551 if (m_sDescription)
1552 lstrcpynW(pszName, m_sDescription, cchMaxName);
1553
1554 return S_OK;
1555 }
1556
1557 HRESULT STDMETHODCALLTYPE CShellLink::SetDescription(LPCWSTR pszName)
1558 {
1559 TRACE("(%p)->(desc=%s)\n", this, debugstr_w(pszName));
1560
1561 HeapFree(GetProcessHeap(), 0, m_sDescription);
1562 if (pszName)
1563 {
1564 m_sDescription = (LPWSTR)HeapAlloc(GetProcessHeap(), 0,
1565 (wcslen(pszName) + 1) * sizeof(WCHAR));
1566 if (!m_sDescription)
1567 return E_OUTOFMEMORY;
1568
1569 wcscpy(m_sDescription, pszName);
1570 }
1571 else
1572 m_sDescription = NULL;
1573
1574 m_bDirty = TRUE;
1575
1576 return S_OK;
1577 }
1578
1579 HRESULT STDMETHODCALLTYPE CShellLink::GetWorkingDirectory(LPWSTR pszDir, INT cchMaxPath)
1580 {
1581 TRACE("(%p)->(%p len %u)\n", this, pszDir, cchMaxPath);
1582
1583 if (cchMaxPath)
1584 *pszDir = 0;
1585
1586 if (m_sWorkDir)
1587 lstrcpynW(pszDir, m_sWorkDir, cchMaxPath);
1588
1589 return S_OK;
1590 }
1591
1592 HRESULT STDMETHODCALLTYPE CShellLink::SetWorkingDirectory(LPCWSTR pszDir)
1593 {
1594 TRACE("(%p)->(dir=%s)\n", this, debugstr_w(pszDir));
1595
1596 HeapFree(GetProcessHeap(), 0, m_sWorkDir);
1597 if (pszDir)
1598 {
1599 m_sWorkDir = (LPWSTR)HeapAlloc(GetProcessHeap(), 0,
1600 (wcslen(pszDir) + 1) * sizeof(WCHAR));
1601 if (!m_sWorkDir)
1602 return E_OUTOFMEMORY;
1603 wcscpy(m_sWorkDir, pszDir);
1604 }
1605 else
1606 m_sWorkDir = NULL;
1607
1608 m_bDirty = TRUE;
1609
1610 return S_OK;
1611 }
1612
1613 HRESULT STDMETHODCALLTYPE CShellLink::GetArguments(LPWSTR pszArgs, INT cchMaxPath)
1614 {
1615 TRACE("(%p)->(%p len=%u)\n", this, pszArgs, cchMaxPath);
1616
1617 if (cchMaxPath)
1618 *pszArgs = 0;
1619
1620 if (m_sArgs)
1621 lstrcpynW(pszArgs, m_sArgs, cchMaxPath);
1622
1623 return S_OK;
1624 }
1625
1626 HRESULT STDMETHODCALLTYPE CShellLink::SetArguments(LPCWSTR pszArgs)
1627 {
1628 TRACE("(%p)->(args=%s)\n", this, debugstr_w(pszArgs));
1629
1630 HeapFree(GetProcessHeap(), 0, m_sArgs);
1631 if (pszArgs)
1632 {
1633 m_sArgs = (LPWSTR)HeapAlloc(GetProcessHeap(), 0,
1634 (wcslen(pszArgs) + 1) * sizeof(WCHAR));
1635 if (!m_sArgs)
1636 return E_OUTOFMEMORY;
1637
1638 wcscpy(m_sArgs, pszArgs);
1639 }
1640 else
1641 m_sArgs = NULL;
1642
1643 m_bDirty = TRUE;
1644
1645 return S_OK;
1646 }
1647
1648 HRESULT STDMETHODCALLTYPE CShellLink::GetIconLocation(LPWSTR pszIconPath, INT cchIconPath, INT *piIcon)
1649 {
1650 TRACE("(%p)->(%p len=%u iicon=%p)\n", this, pszIconPath, cchIconPath, piIcon);
1651
1652 if (cchIconPath)
1653 *pszIconPath = 0;
1654
1655 *piIcon = 0;
1656
1657 /* Update the original icon path location */
1658 if (m_Header.dwFlags & SLDF_HAS_EXP_ICON_SZ)
1659 {
1660 WCHAR szPath[MAX_PATH];
1661
1662 /* Search for an icon environment block */
1663 LPEXP_SZ_LINK pInfo;
1664 pInfo = (LPEXP_SZ_LINK)SHFindDataBlock(m_pDBList, EXP_SZ_ICON_SIG);
1665 if (pInfo && (pInfo->cbSize == sizeof(*pInfo)))
1666 {
1667 m_Header.dwFlags &= ~SLDF_HAS_ICONLOCATION;
1668 HeapFree(GetProcessHeap(), 0, m_sIcoPath);
1669 m_sIcoPath = NULL;
1670
1671 SHExpandEnvironmentStringsW(pInfo->szwTarget, szPath, _countof(szPath));
1672
1673 m_sIcoPath = (LPWSTR)HeapAlloc(GetProcessHeap(), 0,
1674 (wcslen(szPath) + 1) * sizeof(WCHAR));
1675 if (!m_sIcoPath)
1676 return E_OUTOFMEMORY;
1677
1678 wcscpy(m_sIcoPath, szPath);
1679 m_Header.dwFlags |= SLDF_HAS_ICONLOCATION;
1680
1681 m_bDirty = TRUE;
1682 }
1683 }
1684
1685 *piIcon = m_Header.nIconIndex;
1686
1687 if (m_sIcoPath)
1688 lstrcpynW(pszIconPath, m_sIcoPath, cchIconPath);
1689
1690 return S_OK;
1691 }
1692
1693 static HRESULT SHELL_PidlGetIconLocationW(IShellFolder* psf, LPCITEMIDLIST pidl,
1694 UINT uFlags, PWSTR pszIconFile, UINT cchMax, int *piIndex, UINT *pwFlags)
1695 {
1696 LPCITEMIDLIST pidlLast;
1697
1698 HRESULT hr = SHBindToParent(pidl, IID_PPV_ARG(IShellFolder, &psf), &pidlLast);
1699 if (SUCCEEDED(hr))
1700 {
1701 CComPtr<IExtractIconW> pei;
1702
1703 hr = psf->GetUIObjectOf(0, 1, &pidlLast, IID_NULL_PPV_ARG(IExtractIconW, &pei));
1704 if (SUCCEEDED(hr))
1705 hr = pei->GetIconLocation(uFlags, pszIconFile, cchMax, piIndex, pwFlags);
1706
1707 psf->Release();
1708 }
1709
1710 return hr;
1711 }
1712
1713 HRESULT STDMETHODCALLTYPE CShellLink::GetIconLocation(UINT uFlags, PWSTR pszIconFile, UINT cchMax, int *piIndex, UINT *pwFlags)
1714 {
1715 /*
1716 * It is possible for a shell link to point to another shell link,
1717 * and in particular there is the possibility to point to itself.
1718 * Now, suppose we ask such a link to retrieve its associated icon.
1719 * This function would be called, and due to COM would be called again
1720 * recursively. To solve this issue, we forbid calling GetIconLocation()
1721 * with GIL_FORSHORTCUT set in uFlags, as done by Windows (shown by tests).
1722 */
1723 if (uFlags & GIL_FORSHORTCUT)
1724 return E_INVALIDARG;
1725
1726 /*
1727 * Now, we set GIL_FORSHORTCUT so that: i) we allow the icon extractor
1728 * of the target to give us a suited icon, and ii) we protect ourselves
1729 * against recursive call.
1730 */
1731 uFlags |= GIL_FORSHORTCUT;
1732
1733 if (m_pPidl || m_sPath)
1734 {
1735 CComPtr<IShellFolder> pdsk;
1736
1737 HRESULT hr = SHGetDesktopFolder(&pdsk);
1738 if (SUCCEEDED(hr))
1739 {
1740 /* first look for an icon using the PIDL (if present) */
1741 if (m_pPidl)
1742 hr = SHELL_PidlGetIconLocationW(pdsk, m_pPidl, uFlags, pszIconFile, cchMax, piIndex, pwFlags);
1743 else
1744 hr = E_FAIL;
1745
1746 #if 0 // FIXME: Analyse further whether this is needed...
1747 /* if we couldn't find an icon yet, look for it using the file system path */
1748 if (FAILED(hr) && m_sPath)
1749 {
1750 LPITEMIDLIST pidl;
1751
1752 /* LPITEMIDLIST pidl = ILCreateFromPathW(sPath); */
1753 hr = pdsk->ParseDisplayName(0, NULL, m_sPath, NULL, &pidl, NULL);
1754 if (SUCCEEDED(hr))
1755 {
1756 hr = SHELL_PidlGetIconLocationW(pdsk, pidl, uFlags, pszIconFile, cchMax, piIndex, pwFlags);
1757 SHFree(pidl);
1758 }
1759 }
1760 #endif
1761 }
1762 return hr;
1763 }
1764
1765 return S_OK;
1766 }
1767
1768 HRESULT STDMETHODCALLTYPE CShellLink::Extract(PCWSTR pszFile, UINT nIconIndex, HICON *phiconLarge, HICON *phiconSmall, UINT nIconSize)
1769 {
1770 UNIMPLEMENTED;
1771 return E_FAIL;
1772 }
1773
1774 #if 0
1775 /* Extends the functionality of PathUnExpandEnvStringsW */
1776 BOOL PathFullyUnExpandEnvStringsW(
1777 _In_ LPCWSTR pszPath,
1778 _Out_ LPWSTR pszBuf,
1779 _In_ UINT cchBuf)
1780 {
1781 BOOL Ret = FALSE; // Set to TRUE as soon as PathUnExpandEnvStrings starts unexpanding.
1782 BOOL res;
1783 LPCWSTR p;
1784
1785 // *pszBuf = L'\0';
1786 while (*pszPath && cchBuf > 0)
1787 {
1788 /* Attempt unexpanding the path */
1789 res = PathUnExpandEnvStringsW(pszPath, pszBuf, cchBuf);
1790 if (!res)
1791 {
1792 /* The unexpansion failed. Try to find a path delimiter. */
1793 p = wcspbrk(pszPath, L" /\\:*?\"<>|%");
1794 if (!p) /* None found, we will copy the remaining path */
1795 p = pszPath + wcslen(pszPath);
1796 else /* Found one, we will copy the delimiter and skip it */
1797 ++p;
1798 /* If we overflow, we cannot unexpand more, so return FALSE */
1799 if (p - pszPath >= cchBuf)
1800 return FALSE; // *pszBuf = L'\0';
1801
1802 /* Copy the untouched portion of path up to the delimiter, included */
1803 wcsncpy(pszBuf, pszPath, p - pszPath);
1804 pszBuf[p - pszPath] = L'\0'; // NULL-terminate
1805
1806 /* Advance the pointers and decrease the remaining buffer size */
1807 cchBuf -= (p - pszPath);
1808 pszBuf += (p - pszPath);
1809 pszPath += (p - pszPath);
1810 }
1811 else
1812 {
1813 /*
1814 * The unexpansion succeeded. Skip the unexpanded part by trying
1815 * to find where the original path and the unexpanded string
1816 * become different.
1817 * NOTE: An alternative(?) would be to stop also at the last
1818 * path delimiter encountered in the loop (i.e. would be the
1819 * first path delimiter in the strings).
1820 */
1821 LPWSTR q;
1822
1823 /*
1824 * The algorithm starts at the end of the strings and loops back
1825 * while the characters are equal, until it finds a discrepancy.
1826 */
1827 p = pszPath + wcslen(pszPath);
1828 q = pszBuf + wcslen(pszBuf); // This wcslen should be < cchBuf
1829 while ((*p == *q) && (p > pszPath) && (q > pszBuf))
1830 {
1831 --p; --q;
1832 }
1833 /* Skip discrepancy */
1834 ++p; ++q;
1835
1836 /* Advance the pointers and decrease the remaining buffer size */
1837 cchBuf -= (q - pszBuf);
1838 pszBuf = q;
1839 pszPath = p;
1840
1841 Ret = TRUE;
1842 }
1843 }
1844
1845 return Ret;
1846 }
1847 #endif
1848
1849 HRESULT STDMETHODCALLTYPE CShellLink::SetIconLocation(LPCWSTR pszIconPath, INT iIcon)
1850 {
1851 HRESULT hr = E_FAIL;
1852 WCHAR szUnExpIconPath[MAX_PATH];
1853
1854 TRACE("(%p)->(path=%s iicon=%u)\n", this, debugstr_w(pszIconPath), iIcon);
1855
1856 if (pszIconPath)
1857 {
1858 /* Try to fully unexpand the icon path */
1859
1860 /*
1861 * Check whether the user-given file path contains unexpanded
1862 * environment variables. If so, create a target environment block.
1863 * Note that in this block we will store the user-given path.
1864 * It will contain the unexpanded environment variables, but
1865 * it can also contain already expanded path that the user does
1866 * not want to see them unexpanded (e.g. so that they always
1867 * refer to the same place even if the would-be corresponding
1868 * environment variable could change).
1869 */
1870 // FIXME: http://stackoverflow.com/questions/2976489/ishelllinkseticonlocation-translates-my-icon-path-into-program-files-which-i
1871 // if (PathFullyUnExpandEnvStringsW(pszIconPath, szUnExpIconPath, _countof(szUnExpIconPath)))
1872 SHExpandEnvironmentStringsW(pszIconPath, szUnExpIconPath, _countof(szUnExpIconPath));
1873 if (wcscmp(pszIconPath, szUnExpIconPath) != 0)
1874 {
1875 /* Unexpansion succeeded, so we need an icon environment block */
1876 EXP_SZ_LINK buffer;
1877 LPEXP_SZ_LINK pInfo;
1878
1879 pInfo = (LPEXP_SZ_LINK)SHFindDataBlock(m_pDBList, EXP_SZ_ICON_SIG);
1880 if (pInfo)
1881 {
1882 /* Make sure that the size of the structure is valid */
1883 if (pInfo->cbSize != sizeof(*pInfo))
1884 {
1885 ERR("Ooops. This structure is not as expected...\n");
1886
1887 /* Invalid structure, remove it altogether */
1888 m_Header.dwFlags &= ~SLDF_HAS_EXP_ICON_SZ;
1889 RemoveDataBlock(EXP_SZ_ICON_SIG);
1890
1891 /* Reset the pointer and go use the static buffer */
1892 pInfo = NULL;
1893 }
1894 }
1895 if (!pInfo)
1896 {
1897 /* Use the static buffer */
1898 pInfo = &buffer;
1899 buffer.cbSize = sizeof(buffer);
1900 buffer.dwSignature = EXP_SZ_ICON_SIG;
1901 }
1902
1903 lstrcpynW(pInfo->szwTarget, szUnExpIconPath, _countof(pInfo->szwTarget));
1904 WideCharToMultiByte(CP_ACP, 0, szUnExpIconPath, -1,
1905 pInfo->szTarget, _countof(pInfo->szTarget), NULL, NULL);
1906
1907 hr = S_OK;
1908 if (pInfo == &buffer)
1909 hr = AddDataBlock(pInfo);
1910 if (hr == S_OK)
1911 m_Header.dwFlags |= SLDF_HAS_EXP_ICON_SZ;
1912 }
1913 else
1914 {
1915 /* Unexpansion failed, so we need to remove any icon environment block */
1916 m_Header.dwFlags &= ~SLDF_HAS_EXP_ICON_SZ;
1917 RemoveDataBlock(EXP_SZ_ICON_SIG);
1918 }
1919 }
1920
1921 /* Store the original icon path location (this one may contain unexpanded environment strings) */
1922 if (pszIconPath)
1923 {
1924 m_Header.dwFlags &= ~SLDF_HAS_ICONLOCATION;
1925 HeapFree(GetProcessHeap(), 0, m_sIcoPath);
1926 m_sIcoPath = NULL;
1927
1928 m_sIcoPath = (LPWSTR)HeapAlloc(GetProcessHeap(), 0,
1929 (wcslen(pszIconPath) + 1) * sizeof(WCHAR));
1930 if (!m_sIcoPath)
1931 return E_OUTOFMEMORY;
1932
1933 wcscpy(m_sIcoPath, pszIconPath);
1934 m_Header.dwFlags |= SLDF_HAS_ICONLOCATION;
1935 }
1936
1937 hr = S_OK;
1938
1939 m_Header.nIconIndex = iIcon;
1940 m_bDirty = TRUE;
1941
1942 return hr;
1943 }
1944
1945 HRESULT STDMETHODCALLTYPE CShellLink::SetRelativePath(LPCWSTR pszPathRel, DWORD dwReserved)
1946 {
1947 TRACE("(%p)->(path=%s %x)\n", this, debugstr_w(pszPathRel), dwReserved);
1948
1949 HeapFree(GetProcessHeap(), 0, m_sPathRel);
1950 if (pszPathRel)
1951 {
1952 m_sPathRel = (LPWSTR)HeapAlloc(GetProcessHeap(), 0,
1953 (wcslen(pszPathRel) + 1) * sizeof(WCHAR));
1954 if (!m_sPathRel)
1955 return E_OUTOFMEMORY;
1956 wcscpy(m_sPathRel, pszPathRel);
1957 }
1958 else
1959 m_sPathRel = NULL;
1960
1961 m_bDirty = TRUE;
1962
1963 return ShellLink_UpdatePath(m_sPathRel, m_sPath, m_sWorkDir, &m_sPath);
1964 }
1965
1966 static LPWSTR GetAdvertisedArg(LPCWSTR str)
1967 {
1968 if (!str)
1969 return NULL;
1970
1971 LPCWSTR p = wcschr(str, L':');
1972 if (!p)
1973 return NULL;
1974
1975 DWORD len = p - str;
1976 LPWSTR ret = (LPWSTR)HeapAlloc(GetProcessHeap(), 0, sizeof(WCHAR) * (len + 1));
1977 if (!ret)
1978 return ret;
1979
1980 memcpy(ret, str, sizeof(WCHAR)*len);
1981 ret[len] = 0;
1982 return ret;
1983 }
1984
1985 HRESULT CShellLink::WriteAdvertiseInfo(LPCWSTR string, DWORD dwSig)
1986 {
1987 EXP_DARWIN_LINK buffer;
1988 LPEXP_DARWIN_LINK pInfo;
1989
1990 if ( (dwSig != EXP_DARWIN_ID_SIG)
1991 #if (NTDDI_VERSION < NTDDI_LONGHORN)
1992 && (dwSig != EXP_LOGO3_ID_SIG)
1993 #endif
1994 )
1995 {
1996 return E_INVALIDARG;
1997 }
1998
1999 if (!string)
2000 return S_FALSE;
2001
2002 pInfo = (LPEXP_DARWIN_LINK)SHFindDataBlock(m_pDBList, dwSig);
2003 if (pInfo)
2004 {
2005 /* Make sure that the size of the structure is valid */
2006 if (pInfo->dbh.cbSize != sizeof(*pInfo))
2007 {
2008 ERR("Ooops. This structure is not as expected...\n");
2009
2010 /* Invalid structure, remove it altogether */
2011 if (dwSig == EXP_DARWIN_ID_SIG)
2012 m_Header.dwFlags &= ~SLDF_HAS_DARWINID;
2013 #if (NTDDI_VERSION < NTDDI_LONGHORN)
2014 else if (dwSig == EXP_LOGO3_ID_SIG)
2015 m_Header.dwFlags &= ~SLDF_HAS_LOGO3ID;
2016 #endif
2017 RemoveDataBlock(dwSig);
2018
2019 /* Reset the pointer and go use the static buffer */
2020 pInfo = NULL;
2021 }
2022 }
2023 if (!pInfo)
2024 {
2025 /* Use the static buffer */
2026 pInfo = &buffer;
2027 buffer.dbh.cbSize = sizeof(buffer);
2028 buffer.dbh.dwSignature = dwSig;
2029 }
2030
2031 lstrcpynW(pInfo->szwDarwinID, string, _countof(pInfo->szwDarwinID));
2032 WideCharToMultiByte(CP_ACP, 0, string, -1,
2033 pInfo->szDarwinID, _countof(pInfo->szDarwinID), NULL, NULL);
2034
2035 HRESULT hr = S_OK;
2036 if (pInfo == &buffer)
2037 hr = AddDataBlock(pInfo);
2038 if (hr == S_OK)
2039 {
2040 if (dwSig == EXP_DARWIN_ID_SIG)
2041 m_Header.dwFlags |= SLDF_HAS_DARWINID;
2042 #if (NTDDI_VERSION < NTDDI_LONGHORN)
2043 else if (dwSig == EXP_LOGO3_ID_SIG)
2044 m_Header.dwFlags |= SLDF_HAS_LOGO3ID;
2045 #endif
2046 }
2047
2048 return hr;
2049 }
2050
2051 HRESULT CShellLink::SetAdvertiseInfo(LPCWSTR str)
2052 {
2053 HRESULT hr;
2054 LPCWSTR szComponent = NULL, szProduct = NULL, p;
2055 INT len;
2056 GUID guid;
2057 WCHAR szGuid[38+1];
2058
2059 /**/sProduct = sComponent = NULL;/**/
2060
2061 while (str[0])
2062 {
2063 /* each segment must start with two colons */
2064 if (str[0] != ':' || str[1] != ':')
2065 return E_FAIL;
2066
2067 /* the last segment is just two colons */
2068 if (!str[2])
2069 break;
2070 str += 2;
2071
2072 /* there must be a colon straight after a guid */
2073 p = wcschr(str, L':');
2074 if (!p)
2075 return E_FAIL;
2076 len = p - str;
2077 if (len != 38)
2078 return E_FAIL;
2079
2080 /* get the guid, and check if it's validly formatted */
2081 memcpy(szGuid, str, sizeof(WCHAR)*len);
2082 szGuid[len] = 0;
2083
2084 hr = CLSIDFromString(szGuid, &guid);
2085 if (hr != S_OK)
2086 return hr;
2087 str = p + 1;
2088
2089 /* match it up to a guid that we care about */
2090 if (IsEqualGUID(guid, SHELL32_AdvtShortcutComponent) && !szComponent)
2091 szComponent = str; /* Darwin */
2092 else if (IsEqualGUID(guid, SHELL32_AdvtShortcutProduct) && !szProduct)
2093 szProduct = str; /* Logo3 */
2094 else
2095 return E_FAIL;
2096
2097 /* skip to the next field */
2098 str = wcschr(str, L':');
2099 if (!str)
2100 return E_FAIL;
2101 }
2102
2103 /* we have to have a component for an advertised shortcut */
2104 if (!szComponent)
2105 return E_FAIL;
2106
2107 szComponent = GetAdvertisedArg(szComponent);
2108 szProduct = GetAdvertisedArg(szProduct);
2109
2110 hr = WriteAdvertiseInfo(szComponent, EXP_DARWIN_ID_SIG);
2111 // if (FAILED(hr))
2112 // return hr;
2113 #if (NTDDI_VERSION < NTDDI_LONGHORN)
2114 hr = WriteAdvertiseInfo(szProduct, EXP_LOGO3_ID_SIG);
2115 // if (FAILED(hr))
2116 // return hr;
2117 #endif
2118
2119 HeapFree(GetProcessHeap(), 0, (PVOID)szComponent);
2120 HeapFree(GetProcessHeap(), 0, (PVOID)szProduct);
2121
2122 if (TRACE_ON(shell))
2123 {
2124 GetAdvertiseInfo(&sComponent, EXP_DARWIN_ID_SIG);
2125 TRACE("Component = %s\n", debugstr_w(sComponent));
2126 #if (NTDDI_VERSION < NTDDI_LONGHORN)
2127 GetAdvertiseInfo(&sProduct, EXP_LOGO3_ID_SIG);
2128 TRACE("Product = %s\n", debugstr_w(sProduct));
2129 #endif
2130 }
2131
2132 return S_OK;
2133 }
2134
2135 /*
2136 * Since the real PathResolve (from Wine) is unimplemented at the moment,
2137 * we use this local implementation, until a better one is written (using
2138 * code parts of the SHELL_xxx helpers in Wine's shellpath.c).
2139 */
2140 static BOOL HACKISH_PathResolve(
2141 IN OUT PWSTR pszPath,
2142 IN PZPCWSTR dirs OPTIONAL,
2143 IN UINT fFlags)
2144 {
2145 // FIXME: This is unimplemented!!!
2146 #if 0
2147 return PathResolve(pszPath, dirs, fFlags);
2148 #else
2149 BOOL Success = FALSE;
2150 USHORT i;
2151 LPWSTR fname = NULL;
2152 WCHAR szPath[MAX_PATH];
2153
2154 /* First, search for a valid existing path */
2155
2156 // NOTE: See also: SHELL_FindExecutable()
2157
2158 /*
2159 * List of extensions searched for, by PathResolve with the flag
2160 * PRF_TRYPROGRAMEXTENSIONS == PRF_EXECUTABLE | PRF_VERIFYEXISTS set,
2161 * according to MSDN: https://msdn.microsoft.com/en-us/library/windows/desktop/bb776478(v=vs.85).aspx
2162 */
2163 static PCWSTR Extensions[] = {L".pif", L".com", L".bat", L".cmd", L".lnk", L".exe", NULL};
2164 #define LNK_EXT_INDEX 4 // ".lnk" has index 4 in the array above
2165
2166 /*
2167 * Start at the beginning of the list if PRF_EXECUTABLE is set, otherwise
2168 * just use the last element 'NULL' (no extension checking).
2169 */
2170 i = ((fFlags & PRF_EXECUTABLE) ? 0 : _countof(Extensions) - 1);
2171 for (; i < _countof(Extensions); ++i)
2172 {
2173 /* Ignore shell links ".lnk" if needed */
2174 if ((fFlags & PRF_DONTFINDLNK) && (i == LNK_EXT_INDEX))
2175 continue;
2176
2177 Success = (SearchPathW(NULL, pszPath, Extensions[i],
2178 _countof(szPath), szPath, NULL) != 0);
2179 if (!Success)
2180 {
2181 ERR("SearchPathW(pszPath = '%S') failed\n", pszPath);
2182 }
2183 else
2184 {
2185 ERR("SearchPathW(pszPath = '%S', szPath = '%S') succeeded\n", pszPath, szPath);
2186 break;
2187 }
2188 }
2189
2190 if (!Success)
2191 {
2192 ERR("SearchPathW(pszPath = '%S') failed\n", pszPath);
2193
2194 /* We failed, try with PathFindOnPath, as explained by MSDN */
2195 // Success = PathFindOnPathW(pszPath, dirs);
2196 StringCchCopyW(szPath, _countof(szPath), pszPath);
2197 Success = PathFindOnPathW(szPath, dirs);
2198 if (!Success)
2199 {
2200 ERR("PathFindOnPathW(pszPath = '%S') failed\n", pszPath);
2201
2202 /* We failed again, fall back to building a possible non-existing path */
2203 if (!GetFullPathNameW(pszPath, _countof(szPath), szPath, &fname))
2204 {
2205 ERR("GetFullPathNameW(pszPath = '%S') failed\n", pszPath);
2206 return FALSE;
2207 }
2208
2209 Success = PathFileExistsW(szPath);
2210 if (!Success)
2211 ERR("PathFileExistsW(szPath = '%S') failed\n", szPath);
2212
2213 /******************************************************/
2214 /* Question: Why this line is needed only for files?? */
2215 if (fname && (_wcsicmp(pszPath, fname) == 0))
2216 *szPath = L'\0';
2217 /******************************************************/
2218 }
2219 else
2220 {
2221 ERR("PathFindOnPathW(pszPath = '%S' ==> '%S') succeeded\n", pszPath, szPath);
2222 }
2223 }
2224
2225 /* Copy back the results to the caller */
2226 StringCchCopyW(pszPath, MAX_PATH, szPath);
2227
2228 /*
2229 * Since the called functions always checked whether the file path existed,
2230 * we do not need to redo a final check: we can use instead the cached
2231 * result in 'Success'.
2232 */
2233 return ((fFlags & PRF_VERIFYEXISTS) ? Success : TRUE);
2234 #endif
2235 }
2236
2237 HRESULT CShellLink::SetTargetFromPIDLOrPath(LPCITEMIDLIST pidl, LPCWSTR pszFile)
2238 {
2239 HRESULT hr = S_OK;
2240 LPITEMIDLIST pidlNew = NULL;
2241 WCHAR szPath[MAX_PATH];
2242
2243 /*
2244 * Not both 'pidl' and 'pszFile' should be set.
2245 * But either one or both can be NULL.
2246 */
2247 if (pidl && pszFile)
2248 return E_FAIL;
2249
2250 if (pidl)
2251 {
2252 /* Clone the PIDL */
2253 pidlNew = ILClone(pidl);
2254 if (!pidlNew)
2255 return E_FAIL;
2256 }
2257 else if (pszFile)
2258 {
2259 /* Build a PIDL for this path target */
2260 hr = SHILCreateFromPathW(pszFile, &pidlNew, NULL);
2261 if (FAILED(hr))
2262 {
2263 /* This failed, try to resolve the path, then create a simple PIDL */
2264
2265 StringCchCopyW(szPath, _countof(szPath), pszFile);
2266 // FIXME: Because PathResolve is unimplemented, we use our hackish implementation!
2267 HACKISH_PathResolve(szPath, NULL, PRF_TRYPROGRAMEXTENSIONS);
2268
2269 pidlNew = SHSimpleIDListFromPathW(szPath);
2270 /******************************************************/
2271 /* Question: Why this line is needed only for files?? */
2272 hr = (*szPath ? S_OK : E_INVALIDARG); // S_FALSE
2273 /******************************************************/
2274 }
2275 }
2276 // else if (!pidl && !pszFile) { pidlNew = NULL; hr = S_OK; }
2277
2278 ILFree(m_pPidl);
2279 m_pPidl = pidlNew;
2280
2281 if (!pszFile)
2282 {
2283 if (SHGetPathFromIDListW(pidlNew, szPath))
2284 pszFile = szPath;
2285 }
2286
2287 // TODO: Fully update link info, tracker, file attribs...
2288
2289 // if (pszFile)
2290 if (!pszFile)
2291 {
2292 *szPath = L'\0';
2293 pszFile = szPath;
2294 }
2295
2296 /* Update the cached path (for link info) */
2297 ShellLink_GetVolumeInfo(pszFile, &volume);
2298 m_sPath = (LPWSTR)HeapAlloc(GetProcessHeap(), 0,
2299 (wcslen(pszFile) + 1) * sizeof(WCHAR));
2300 if (!m_sPath)
2301 return E_OUTOFMEMORY;
2302 wcscpy(m_sPath, pszFile);
2303
2304 m_bDirty = TRUE;
2305 return hr;
2306 }
2307
2308 HRESULT STDMETHODCALLTYPE CShellLink::SetPath(LPCWSTR pszFile)
2309 {
2310 LPWSTR unquoted = NULL;
2311 HRESULT hr = S_OK;
2312
2313 TRACE("(%p)->(path=%s)\n", this, debugstr_w(pszFile));
2314
2315 if (!pszFile)
2316 return E_INVALIDARG;
2317
2318 /*
2319 * Allow upgrading Logo3 shortcuts (m_Header.dwFlags & SLDF_HAS_LOGO3ID),
2320 * but forbid upgrading Darwin ones.
2321 */
2322 if (m_Header.dwFlags & SLDF_HAS_DARWINID)
2323 return S_FALSE;
2324
2325 /* quotes at the ends of the string are stripped */
2326 SIZE_T len = wcslen(pszFile);
2327 if (pszFile[0] == L'"' && pszFile[len-1] == L'"')
2328 {
2329 unquoted = strdupW(pszFile);
2330 PathUnquoteSpacesW(unquoted);
2331 pszFile = unquoted;
2332 }
2333
2334 /* any other quote marks are invalid */
2335 if (wcschr(pszFile, L'"'))
2336 {
2337 hr = S_FALSE;
2338 goto end;
2339 }
2340
2341 /* Clear the cached path */
2342 HeapFree(GetProcessHeap(), 0, m_sPath);
2343 m_sPath = NULL;
2344
2345 /* Check for an advertised target (Logo3 or Darwin) */
2346 if (SetAdvertiseInfo(pszFile) != S_OK)
2347 {
2348 /* This is not an advertised target, but a regular path */
2349 WCHAR szPath[MAX_PATH];
2350
2351 /*
2352 * Check whether the user-given file path contains unexpanded
2353 * environment variables. If so, create a target environment block.
2354 * Note that in this block we will store the user-given path.
2355 * It will contain the unexpanded environment variables, but
2356 * it can also contain already expanded path that the user does
2357 * not want to see them unexpanded (e.g. so that they always
2358 * refer to the same place even if the would-be corresponding
2359 * environment variable could change).
2360 */
2361 if (*pszFile)
2362 SHExpandEnvironmentStringsW(pszFile, szPath, _countof(szPath));
2363 else
2364 *szPath = L'\0';
2365
2366 if (*pszFile && (wcscmp(pszFile, szPath) != 0))
2367 {
2368 /*
2369 * The user-given file path contains unexpanded environment
2370 * variables, so we need a target environment block.
2371 */
2372 EXP_SZ_LINK buffer;
2373 LPEXP_SZ_LINK pInfo;
2374
2375 pInfo = (LPEXP_SZ_LINK)SHFindDataBlock(m_pDBList, EXP_SZ_LINK_SIG);
2376 if (pInfo)
2377 {
2378 /* Make sure that the size of the structure is valid */
2379 if (pInfo->cbSize != sizeof(*pInfo))
2380 {
2381 ERR("Ooops. This structure is not as expected...\n");
2382
2383 /* Invalid structure, remove it altogether */
2384 m_Header.dwFlags &= ~SLDF_HAS_EXP_SZ;
2385 RemoveDataBlock(EXP_SZ_LINK_SIG);
2386
2387 /* Reset the pointer and go use the static buffer */
2388 pInfo = NULL;
2389 }
2390 }
2391 if (!pInfo)
2392 {
2393 /* Use the static buffer */
2394 pInfo = &buffer;
2395 buffer.cbSize = sizeof(buffer);
2396 buffer.dwSignature = EXP_SZ_LINK_SIG;
2397 }
2398
2399 lstrcpynW(pInfo->szwTarget, pszFile, _countof(pInfo->szwTarget));
2400 WideCharToMultiByte(CP_ACP, 0, pszFile, -1,
2401 pInfo->szTarget, _countof(pInfo->szTarget), NULL, NULL);
2402
2403 hr = S_OK;
2404 if (pInfo == &buffer)
2405 hr = AddDataBlock(pInfo);
2406 if (hr == S_OK)
2407 m_Header.dwFlags |= SLDF_HAS_EXP_SZ;
2408
2409 /* Now, make pszFile point to the expanded buffer */
2410 pszFile = szPath;
2411 }
2412 else
2413 {
2414 /*
2415 * The user-given file path does not contain unexpanded environment
2416 * variables, so we need to remove any target environment block.
2417 */
2418 m_Header.dwFlags &= ~SLDF_HAS_EXP_SZ;
2419 RemoveDataBlock(EXP_SZ_LINK_SIG);
2420
2421 /* pszFile points to the user path */
2422 }
2423
2424 /* Set the target */
2425 hr = SetTargetFromPIDLOrPath(NULL, pszFile);
2426 }
2427
2428 m_bDirty = TRUE;
2429
2430 end:
2431 HeapFree(GetProcessHeap(), 0, unquoted);
2432 return hr;
2433 }
2434
2435 HRESULT STDMETHODCALLTYPE CShellLink::AddDataBlock(void* pDataBlock)
2436 {
2437 if (SHAddDataBlock(&m_pDBList, (DATABLOCK_HEADER*)pDataBlock))
2438 {
2439 m_bDirty = TRUE;
2440 return S_OK;
2441 }
2442 return S_FALSE;
2443 }
2444
2445 HRESULT STDMETHODCALLTYPE CShellLink::CopyDataBlock(DWORD dwSig, void** ppDataBlock)
2446 {
2447 DATABLOCK_HEADER* pBlock;
2448 PVOID pDataBlock;
2449
2450 TRACE("%p %08x %p\n", this, dwSig, ppDataBlock);
2451
2452 *ppDataBlock = NULL;
2453
2454 pBlock = SHFindDataBlock(m_pDBList, dwSig);
2455 if (!pBlock)
2456 {
2457 ERR("unknown datablock %08x (not found)\n", dwSig);
2458 return E_FAIL;
2459 }
2460
2461 pDataBlock = LocalAlloc(LMEM_ZEROINIT, pBlock->cbSize);
2462 if (!pDataBlock)
2463 return E_OUTOFMEMORY;
2464
2465 CopyMemory(pDataBlock, pBlock, pBlock->cbSize);
2466
2467 *ppDataBlock = pDataBlock;
2468 return S_OK;
2469 }
2470
2471 HRESULT STDMETHODCALLTYPE CShellLink::RemoveDataBlock(DWORD dwSig)
2472 {
2473 if (SHRemoveDataBlock(&m_pDBList, dwSig))
2474 {
2475 m_bDirty = TRUE;
2476 return S_OK;
2477 }
2478 return S_FALSE;
2479 }
2480
2481 HRESULT STDMETHODCALLTYPE CShellLink::GetFlags(DWORD *pdwFlags)
2482 {
2483 TRACE("%p %p\n", this, pdwFlags);
2484 *pdwFlags = m_Header.dwFlags;
2485 return S_OK;
2486 }
2487
2488 HRESULT STDMETHODCALLTYPE CShellLink::SetFlags(DWORD dwFlags)
2489 {
2490 #if 0 // FIXME!
2491 m_Header.dwFlags = dwFlags;
2492 m_bDirty = TRUE;
2493 return S_OK;
2494 #else
2495 FIXME("\n");
2496 return E_NOTIMPL;
2497 #endif
2498 }
2499
2500 /**************************************************************************
2501 * CShellLink implementation of IShellExtInit::Initialize()
2502 *
2503 * Loads the shelllink from the dataobject the shell is pointing to.
2504 */
2505 HRESULT STDMETHODCALLTYPE CShellLink::Initialize(LPCITEMIDLIST pidlFolder, IDataObject *pdtobj, HKEY hkeyProgID)
2506 {
2507 TRACE("%p %p %p %p\n", this, pidlFolder, pdtobj, hkeyProgID);
2508
2509 if (!pdtobj)
2510 return E_FAIL;
2511
2512 FORMATETC format;
2513 format.cfFormat = CF_HDROP;
2514 format.ptd = NULL;
2515 format.dwAspect = DVASPECT_CONTENT;
2516 format.lindex = -1;
2517 format.tymed = TYMED_HGLOBAL;
2518
2519 STGMEDIUM stgm;
2520 HRESULT hr = pdtobj->GetData(&format, &stgm);
2521 if (FAILED(hr))
2522 return hr;
2523
2524 UINT count = DragQueryFileW((HDROP)stgm.hGlobal, -1, NULL, 0);
2525 if (count == 1)
2526 {
2527 count = DragQueryFileW((HDROP)stgm.hGlobal, 0, NULL, 0);
2528 count++;
2529 LPWSTR path = (LPWSTR)HeapAlloc(GetProcessHeap(), 0, count * sizeof(WCHAR));
2530 if (path)
2531 {
2532 count = DragQueryFileW((HDROP)stgm.hGlobal, 0, path, count);
2533 hr = Load(path, 0);
2534 HeapFree(GetProcessHeap(), 0, path);
2535 }
2536 }
2537 ReleaseStgMedium(&stgm);
2538
2539 return S_OK;
2540 }
2541
2542 HRESULT STDMETHODCALLTYPE CShellLink::QueryContextMenu(HMENU hMenu, UINT indexMenu, UINT idCmdFirst, UINT idCmdLast, UINT uFlags)
2543 {
2544 int id = 1;
2545
2546 TRACE("%p %p %u %u %u %u\n", this,
2547 hMenu, indexMenu, idCmdFirst, idCmdLast, uFlags);
2548
2549 if (!hMenu)
2550 return E_INVALIDARG;
2551
2552 WCHAR wszOpen[20];
2553 if (!LoadStringW(shell32_hInstance, IDS_OPEN_VERB, wszOpen, _countof(wszOpen)))
2554 *wszOpen = L'\0';
2555
2556 MENUITEMINFOW mii;
2557 ZeroMemory(&mii, sizeof(mii));
2558 mii.cbSize = sizeof(mii);
2559 mii.fMask = MIIM_TYPE | MIIM_ID | MIIM_STATE;
2560 mii.dwTypeData = wszOpen;
2561 mii.cch = wcslen(mii.dwTypeData);
2562 mii.wID = idCmdFirst + id++;
2563 mii.fState = MFS_DEFAULT | MFS_ENABLED;
2564 mii.fType = MFT_STRING;
2565 if (!InsertMenuItemW(hMenu, indexMenu, TRUE, &mii))
2566 return E_FAIL;
2567 m_iIdOpen = 1;
2568
2569 return MAKE_HRESULT(SEVERITY_SUCCESS, 0, id);
2570 }
2571
2572 HRESULT STDMETHODCALLTYPE CShellLink::InvokeCommand(LPCMINVOKECOMMANDINFO lpici)
2573 {
2574 LPWSTR args = NULL;
2575 LPWSTR path = NULL;
2576
2577 TRACE("%p %p\n", this, lpici);
2578
2579 if (lpici->cbSize < sizeof(CMINVOKECOMMANDINFO))
2580 return E_INVALIDARG;
2581
2582 // NOTE: We could use lpici->hwnd (certainly in case lpici->fMask doesn't contain CMIC_MASK_FLAG_NO_UI)
2583 // as the parent window handle... ?
2584 /* FIXME: get using interface set from IObjectWithSite?? */
2585 // NOTE: We might need an extended version of Resolve that provides us with paths...
2586 HRESULT hr = Resolve(lpici->hwnd, 0);
2587 if (FAILED(hr))
2588 {
2589 TRACE("failed to resolve component with error 0x%08x", hr);
2590 return hr;
2591 }
2592
2593 path = strdupW(m_sPath);
2594
2595 if ( lpici->cbSize == sizeof(CMINVOKECOMMANDINFOEX) &&
2596 (lpici->fMask & CMIC_MASK_UNICODE) )
2597 {
2598 LPCMINVOKECOMMANDINFOEX iciex = (LPCMINVOKECOMMANDINFOEX)lpici;
2599 SIZE_T len = 2;
2600
2601 if (m_sArgs)
2602 len += wcslen(m_sArgs);
2603 if (iciex->lpParametersW)
2604 len += wcslen(iciex->lpParametersW);
2605
2606 args = (LPWSTR)HeapAlloc(GetProcessHeap(), 0, len * sizeof(WCHAR));
2607 *args = 0;
2608 if (m_sArgs)
2609 wcscat(args, m_sArgs);
2610 if (iciex->lpParametersW)
2611 {
2612 wcscat(args, L" ");
2613 wcscat(args, iciex->lpParametersW);
2614 }
2615 }
2616 else if (m_sArgs != NULL)
2617 {
2618 args = strdupW(m_sArgs);
2619 }
2620
2621 SHELLEXECUTEINFOW sei;
2622 ZeroMemory(&sei, sizeof(sei));
2623 sei.cbSize = sizeof(sei);
2624 sei.fMask = SEE_MASK_HASLINKNAME | SEE_MASK_UNICODE |
2625 (lpici->fMask & (SEE_MASK_NOASYNC | SEE_MASK_ASYNCOK | SEE_MASK_FLAG_NO_UI));
2626 sei.lpFile = path;
2627 sei.lpClass = m_sLinkPath;
2628 sei.nShow = m_Header.nShowCommand;
2629 sei.lpDirectory = m_sWorkDir;
2630 sei.lpParameters = args;
2631 sei.lpVerb = L"open";
2632
2633 // HACK for ShellExecuteExW
2634 if (m_sPath && wcsstr(m_sPath, L".cpl"))
2635 sei.lpVerb = L"cplopen";
2636
2637 if (ShellExecuteExW(&sei))
2638 hr = S_OK;
2639 else
2640 hr = E_FAIL;
2641
2642 HeapFree(GetProcessHeap(), 0, args);
2643 HeapFree(GetProcessHeap(), 0, path);
2644
2645 return hr;
2646 }
2647
2648 HRESULT STDMETHODCALLTYPE CShellLink::GetCommandString(UINT_PTR idCmd, UINT uType, UINT* pwReserved, LPSTR pszName, UINT cchMax)
2649 {
2650 FIXME("%p %lu %u %p %p %u\n", this, idCmd, uType, pwReserved, pszName, cchMax);
2651 return E_NOTIMPL;
2652 }
2653
2654 INT_PTR CALLBACK ExtendedShortcutProc(HWND hwndDlg, UINT uMsg,
2655 WPARAM wParam, LPARAM lParam)
2656 {
2657 switch(uMsg)
2658 {
2659 case WM_INITDIALOG:
2660 if (lParam)
2661 {
2662 HWND hDlgCtrl = GetDlgItem(hwndDlg, 14000);
2663 SendMessage(hDlgCtrl, BM_SETCHECK, BST_CHECKED, 0);
2664 }
2665 return TRUE;
2666 case WM_COMMAND:
2667 {
2668 HWND hDlgCtrl = GetDlgItem(hwndDlg, 14000);
2669 if (LOWORD(wParam) == IDOK)
2670 {
2671 if (SendMessage(hDlgCtrl, BM_GETCHECK, 0, 0) == BST_CHECKED)
2672 EndDialog(hwndDlg, 1);
2673 else
2674 EndDialog(hwndDlg, 0);
2675 }
2676 else if (LOWORD(wParam) == IDCANCEL)
2677 {
2678 EndDialog(hwndDlg, -1);
2679 }
2680 else if (LOWORD(wParam) == 14000)
2681 {
2682 if (SendMessage(hDlgCtrl, BM_GETCHECK, 0, 0) == BST_CHECKED)
2683 SendMessage(hDlgCtrl, BM_SETCHECK, BST_UNCHECKED, 0);
2684 else
2685 SendMessage(hDlgCtrl, BM_SETCHECK, BST_CHECKED, 0);
2686 }
2687 }
2688 }
2689 return FALSE;
2690 }
2691
2692 EXTERN_C HRESULT
2693 WINAPI
2694 SHOpenFolderAndSelectItems(LPITEMIDLIST pidlFolder,
2695 UINT cidl,
2696 PCUITEMID_CHILD_ARRAY apidl,
2697 DWORD dwFlags);
2698
2699 /**************************************************************************
2700 * SH_GetTargetTypeByPath
2701 *
2702 * Function to get target type by passing full path to it
2703 */
2704 LPWSTR SH_GetTargetTypeByPath(LPCWSTR lpcwFullPath)
2705 {
2706 LPCWSTR pwszExt;
2707 static WCHAR wszBuf[MAX_PATH];
2708
2709 /* Get file information */
2710 SHFILEINFOW fi;
2711 if (!SHGetFileInfoW(lpcwFullPath, 0, &fi, sizeof(fi), SHGFI_TYPENAME | SHGFI_USEFILEATTRIBUTES))
2712 {
2713 ERR("SHGetFileInfoW failed for %ls (%lu)\n", lpcwFullPath, GetLastError());
2714 fi.szTypeName[0] = L'\0';
2715 fi.hIcon = NULL;
2716 }
2717
2718 pwszExt = PathFindExtensionW(lpcwFullPath);
2719 if (pwszExt[0])
2720 {
2721 if (!fi.szTypeName[0])
2722 {
2723 /* The file type is unknown, so default to string "FileExtension File" */
2724 size_t cchRemaining = 0;
2725 LPWSTR pwszEnd = NULL;
2726
2727 StringCchPrintfExW(wszBuf, _countof(wszBuf), &pwszEnd, &cchRemaining, 0, L"%s ", pwszExt + 1);
2728 }
2729 else
2730 {
2731 /* Update file type */
2732 StringCbPrintfW(wszBuf, sizeof(wszBuf), L"%s (%s)", fi.szTypeName, pwszExt);
2733 }
2734 }
2735
2736 return wszBuf;
2737 }
2738
2739 /**************************************************************************
2740 * SH_ShellLinkDlgProc
2741 *
2742 * dialog proc of the shortcut property dialog
2743 */
2744
2745 INT_PTR CALLBACK CShellLink::SH_ShellLinkDlgProc(HWND hwndDlg, UINT uMsg, WPARAM wParam, LPARAM lParam)
2746 {
2747 CShellLink *pThis = reinterpret_cast<CShellLink *>(GetWindowLongPtr(hwndDlg, DWLP_USER));
2748
2749 switch(uMsg)
2750 {
2751 case WM_INITDIALOG:
2752 {
2753 LPPROPSHEETPAGEW ppsp = (LPPROPSHEETPAGEW)lParam;
2754 if (ppsp == NULL)
2755 break;
2756
2757 TRACE("ShellLink_DlgProc (WM_INITDIALOG hwnd %p lParam %p ppsplParam %x)\n", hwndDlg, lParam, ppsp->lParam);
2758
2759 pThis = reinterpret_cast<CShellLink *>(ppsp->lParam);
2760 SetWindowLongPtr(hwndDlg, DWLP_USER, (LONG_PTR)pThis);
2761
2762 TRACE("m_sArgs: %S sComponent: %S m_sDescription: %S m_sIcoPath: %S m_sPath: %S m_sPathRel: %S sProduct: %S m_sWorkDir: %S\n", pThis->m_sArgs, pThis->sComponent, pThis->m_sDescription,
2763 pThis->m_sIcoPath, pThis->m_sPath, pThis->m_sPathRel, pThis->sProduct, pThis->m_sWorkDir);
2764
2765 /* Get file information */
2766 // FIXME! FIXME! Shouldn't we use pThis->m_sIcoPath, pThis->m_Header.nIconIndex instead???
2767 SHFILEINFOW fi;
2768 if (!SHGetFileInfoW(pThis->m_sLinkPath, 0, &fi, sizeof(fi), SHGFI_TYPENAME | SHGFI_ICON))
2769 {
2770 ERR("SHGetFileInfoW failed for %ls (%lu)\n", pThis->m_sLinkPath, GetLastError());
2771 fi.szTypeName[0] = L'\0';
2772 fi.hIcon = NULL;
2773 }
2774
2775 if (fi.hIcon) // TODO: destroy icon
2776 SendDlgItemMessageW(hwndDlg, 14000, STM_SETICON, (WPARAM)fi.hIcon, 0);
2777 else
2778 ERR("ExtractIconW failed %ls %u\n", pThis->m_sIcoPath, pThis->m_Header.nIconIndex);
2779
2780 /* Target type */
2781 if (pThis->m_sPath)
2782 SetDlgItemTextW(hwndDlg, 14005, SH_GetTargetTypeByPath(pThis->m_sPath));
2783
2784 /* Target location */
2785 if (pThis->m_sPath)
2786 {
2787 WCHAR target[MAX_PATH];
2788 StringCchCopyW(target, _countof(target), pThis->m_sPath);
2789 PathRemoveFileSpecW(target);
2790 SetDlgItemTextW(hwndDlg, 14007, PathFindFileNameW(target));
2791 }
2792
2793 /* Target path */
2794 if (pThis->m_sPath)
2795 {
2796 WCHAR newpath[2*MAX_PATH] = L"\0";
2797 if (wcschr(pThis->m_sPath, ' '))
2798 StringCchPrintfExW(newpath, _countof(newpath), NULL, NULL, 0, L"\"%ls\"", pThis->m_sPath);
2799 else
2800 StringCchCopyExW(newpath, _countof(newpath), pThis->m_sPath, NULL, NULL, 0);
2801
2802 if (pThis->m_sArgs && pThis->m_sArgs[0])
2803 {
2804 StringCchCatW(newpath, _countof(newpath), L" ");
2805 StringCchCatW(newpath, _countof(newpath), pThis->m_sArgs);
2806 }
2807 SetDlgItemTextW(hwndDlg, 14009, newpath);
2808 }
2809
2810 /* Working dir */
2811 if (pThis->m_sWorkDir)
2812 SetDlgItemTextW(hwndDlg, 14011, pThis->m_sWorkDir);
2813
2814 /* Description */
2815 if (pThis->m_sDescription)
2816 SetDlgItemTextW(hwndDlg, 14019, pThis->m_sDescription);
2817
2818 return TRUE;
2819 }
2820
2821 case WM_NOTIFY:
2822 {
2823 LPPSHNOTIFY lppsn = (LPPSHNOTIFY)lParam;
2824 if (lppsn->hdr.code == PSN_APPLY)
2825 {
2826 WCHAR wszBuf[MAX_PATH];
2827 /* set working directory */
2828 GetDlgItemTextW(hwndDlg, 14011, wszBuf, _countof(wszBuf));
2829 pThis->SetWorkingDirectory(wszBuf);
2830 /* set link destination */
2831 GetDlgItemTextW(hwndDlg, 14009, wszBuf, _countof(wszBuf));
2832 LPWSTR lpszArgs = NULL;
2833 LPWSTR unquoted = strdupW(wszBuf);
2834 StrTrimW(unquoted, L" ");
2835 if (!PathFileExistsW(unquoted))
2836 {
2837 lpszArgs = PathGetArgsW(unquoted);
2838 PathRemoveArgsW(unquoted);
2839 StrTrimW(lpszArgs, L" ");
2840 }
2841 if (unquoted[0] == '"' && unquoted[wcslen(unquoted)-1] == '"')
2842 PathUnquoteSpacesW(unquoted);
2843
2844
2845 WCHAR *pwszExt = PathFindExtensionW(unquoted);
2846 if (!wcsicmp(pwszExt, L".lnk"))
2847 {
2848 // FIXME load localized error msg
2849 MessageBoxW(hwndDlg, L"You cannot create a link to a shortcut", L"Error", MB_ICONERROR);
2850 SetWindowLongPtr(hwndDlg, DWL_MSGRESULT, PSNRET_INVALID_NOCHANGEPAGE);
2851 return TRUE;
2852 }
2853
2854 if (!PathFileExistsW(unquoted))
2855 {
2856 // FIXME load localized error msg
2857 MessageBoxW(hwndDlg, L"The specified file name in the target box is invalid", L"Error", MB_ICONERROR);
2858 SetWindowLongPtr(hwndDlg, DWL_MSGRESULT, PSNRET_INVALID_NOCHANGEPAGE);
2859 return TRUE;
2860 }
2861
2862 pThis->SetPath(unquoted);
2863 if (lpszArgs)
2864 pThis->SetArguments(lpszArgs);
2865 else
2866 pThis->SetArguments(L"\0");
2867
2868 HeapFree(GetProcessHeap(), 0, unquoted);
2869
2870 TRACE("This %p m_sLinkPath %S\n", pThis, pThis->m_sLinkPath);
2871 pThis->Save(pThis->m_sLinkPath, TRUE);
2872 SetWindowLongPtr(hwndDlg, DWL_MSGRESULT, PSNRET_NOERROR);
2873 return TRUE;
2874 }
2875 break;
2876 }
2877
2878 case WM_COMMAND:
2879 switch(LOWORD(wParam))
2880 {
2881 case 14020:
2882 SHOpenFolderAndSelectItems(pThis->m_pPidl, 0, NULL, 0);
2883 ///
2884 /// FIXME
2885 /// open target directory
2886 ///
2887 return TRUE;
2888
2889 case 14021:
2890 {
2891 WCHAR wszPath[MAX_PATH] = L"";
2892
2893 if (pThis->m_sIcoPath)
2894 wcscpy(wszPath, pThis->m_sIcoPath);
2895 INT IconIndex = pThis->m_Header.nIconIndex;
2896 if (PickIconDlg(hwndDlg, wszPath, _countof(wszPath), &IconIndex))
2897 {
2898 pThis->SetIconLocation(wszPath, IconIndex);
2899 ///
2900 /// FIXME redraw icon
2901 ///
2902 }
2903 return TRUE;
2904 }
2905
2906 case 14022:
2907 {
2908 INT_PTR result = DialogBoxParamW(shell32_hInstance, MAKEINTRESOURCEW(IDD_SHORTCUT_EXTENDED_PROPERTIES), hwndDlg, ExtendedShortcutProc, (LPARAM)pThis->m_bRunAs);
2909 if (result == 1 || result == 0)
2910 {
2911 if (pThis->m_bRunAs != result)
2912 {
2913 PropSheet_Changed(GetParent(hwndDlg), hwndDlg);
2914 }
2915
2916 pThis->m_bRunAs = result;
2917 }
2918 return TRUE;
2919 }
2920 }
2921 if (HIWORD(wParam) == EN_CHANGE)
2922 PropSheet_Changed(GetParent(hwndDlg), hwndDlg);
2923 break;
2924
2925 default:
2926 break;
2927 }
2928 return FALSE;
2929 }
2930
2931 /**************************************************************************
2932 * ShellLink_IShellPropSheetExt interface
2933 */
2934
2935 HRESULT STDMETHODCALLTYPE CShellLink::AddPages(LPFNADDPROPSHEETPAGE pfnAddPage, LPARAM lParam)
2936 {
2937 HPROPSHEETPAGE hPage = SH_CreatePropertySheetPage(IDD_SHORTCUT_PROPERTIES, SH_ShellLinkDlgProc, (LPARAM)this, NULL);
2938 if (hPage == NULL)
2939 {
2940 ERR("failed to create property sheet page\n");
2941 return E_FAIL;
2942 }
2943
2944 if (!pfnAddPage(hPage, lParam))
2945 return E_FAIL;
2946
2947 return S_OK;
2948 }
2949
2950 HRESULT STDMETHODCALLTYPE CShellLink::ReplacePage(UINT uPageID, LPFNADDPROPSHEETPAGE pfnReplacePage, LPARAM lParam)
2951 {
2952 TRACE("(%p) (uPageID %u, pfnReplacePage %p lParam %p\n", this, uPageID, pfnReplacePage, lParam);
2953 return E_NOTIMPL;
2954 }
2955
2956 HRESULT STDMETHODCALLTYPE CShellLink::SetSite(IUnknown *punk)
2957 {
2958 TRACE("%p %p\n", this, punk);
2959
2960 m_site = punk;
2961
2962 return S_OK;
2963 }
2964
2965 HRESULT STDMETHODCALLTYPE CShellLink::GetSite(REFIID iid, void ** ppvSite)
2966 {
2967 TRACE("%p %s %p\n", this, debugstr_guid(&iid), ppvSite);
2968
2969 if (m_site == NULL)
2970 return E_FAIL;
2971
2972 return m_site->QueryInterface(iid, ppvSite);
2973 }
2974
2975 HRESULT STDMETHODCALLTYPE CShellLink::DragEnter(IDataObject *pDataObject,
2976 DWORD dwKeyState, POINTL pt, DWORD *pdwEffect)
2977 {
2978 TRACE("(%p)->(DataObject=%p)\n", this, pDataObject);
2979 LPCITEMIDLIST pidlLast;
2980 CComPtr<IShellFolder> psf;
2981
2982 HRESULT hr = SHBindToParent(m_pPidl, IID_PPV_ARG(IShellFolder, &psf), &pidlLast);
2983
2984 if (SUCCEEDED(hr))
2985 {
2986 hr = psf->GetUIObjectOf(0, 1, &pidlLast, IID_NULL_PPV_ARG(IDropTarget, &m_DropTarget));
2987
2988 if (SUCCEEDED(hr))
2989 hr = m_DropTarget->DragEnter(pDataObject, dwKeyState, pt, pdwEffect);
2990 else
2991 *pdwEffect = DROPEFFECT_NONE;
2992 }
2993 else
2994 *pdwEffect = DROPEFFECT_NONE;
2995
2996 return S_OK;
2997 }
2998
2999 HRESULT STDMETHODCALLTYPE CShellLink::DragOver(DWORD dwKeyState, POINTL pt,
3000 DWORD *pdwEffect)
3001 {
3002 TRACE("(%p)\n", this);
3003 HRESULT hr = S_OK;
3004 if (m_DropTarget)
3005 hr = m_DropTarget->DragOver(dwKeyState, pt, pdwEffect);
3006 return hr;
3007 }
3008
3009 HRESULT STDMETHODCALLTYPE CShellLink::DragLeave()
3010 {
3011 TRACE("(%p)\n", this);
3012 HRESULT hr = S_OK;
3013 if (m_DropTarget)
3014 {
3015 hr = m_DropTarget->DragLeave();
3016 m_DropTarget.Release();
3017 }
3018
3019 return hr;
3020 }
3021
3022 HRESULT STDMETHODCALLTYPE CShellLink::Drop(IDataObject *pDataObject,
3023 DWORD dwKeyState, POINTL pt, DWORD *pdwEffect)
3024 {
3025 TRACE("(%p)\n", this);
3026 HRESULT hr = S_OK;
3027 if (m_DropTarget)
3028 hr = m_DropTarget->Drop(pDataObject, dwKeyState, pt, pdwEffect);
3029
3030 return hr;
3031 }
3032
3033 /**************************************************************************
3034 * IShellLink_ConstructFromFile
3035 */
3036 HRESULT WINAPI IShellLink_ConstructFromPath(WCHAR *path, REFIID riid, LPVOID *ppv)
3037 {
3038 CComPtr<IPersistFile> ppf;
3039 HRESULT hr = CShellLink::_CreatorClass::CreateInstance(NULL, IID_PPV_ARG(IPersistFile, &ppf));
3040 if (FAILED(hr))
3041 return hr;
3042
3043 hr = ppf->Load(path, 0);
3044 if (FAILED(hr))
3045 return hr;
3046
3047 return ppf->QueryInterface(riid, ppv);
3048 }
3049
3050 HRESULT WINAPI IShellLink_ConstructFromFile(IShellFolder * psf, LPCITEMIDLIST pidl, REFIID riid, LPVOID *ppv)
3051 {
3052 WCHAR path[MAX_PATH];
3053 if (!ILGetDisplayNameExW(psf, pidl, path, 0))
3054 return E_FAIL;
3055
3056 return IShellLink_ConstructFromPath(path, riid, ppv);
3057 }
A free Windows-compatible Operating System