source: trunk/src/shell32/pidl.c@ 7359

Last change on this file since 7359 was 7359, checked in by phaller, 24 years ago

.
File size: 46.4 KB
Line 
1/*
2 * pidl Handling
3 *
4 * Copyright 1998 Juergen Schmied
5 *
6 * NOTES
7 * a pidl == NULL means desktop and is legal
8 *
9 */
10
11
12/****************************************************************************
13 * includes
14 ****************************************************************************/
15
16#include <odin.h>
17#include <os2sel.h>
18#include <odinwrap.h>
19
20ODINDEBUGCHANNEL(SHELL32-PIDL)
21
22
23#include <ctype.h>
24#include <stdlib.h>
25#include <string.h>
26#include "winbase.h"
27#include "debugtools.h"
28#include "shlguid.h"
29#include "winerror.h"
30#include "winnls.h"
31#include "wine/undocshell.h"
32#include "shell32_main.h"
33#include "shellapi.h"
34#include "shlwapi.h"
35
36#include "pidl.h"
37
38DEFAULT_DEBUG_CHANNEL(pidl);
39
40#ifndef __WIN32OS2__
41DECLARE_DEBUG_CHANNEL(shell);
42#endif
43
44
45#define ODIN_ILGETNEXT(pidl) \
46 (pidl ? ( pidl->mkid.cb ? (LPITEMIDLIST) (((LPBYTE)pidl)+pidl->mkid.cb) : NULL) : NULL)
47
48#if defined( __WIN32OS2__) && defined(DEBUG)
49void pdump (LPCITEMIDLIST pidl)
50{
51 BOOL bIsShellDebug;
52
53 LPITEMIDLIST pidltemp = pidl;
54 if (!TRACE_ON(pidl))
55 return;
56
57 /* silence the sub-functions */
58 bIsShellDebug = TRACE_ON(shell);
59 __SET_DEBUGGING(__DBCL_TRACE, __wine_dbch_shell, FALSE);
60 __SET_DEBUGGING(__DBCL_TRACE, __wine_dbch_pidl, FALSE);
61
62 if (! pidltemp)
63 {
64 MESSAGE ("PIDL: -------- pidl=NULL (Desktop)\n");
65 }
66 else
67 {
68 MESSAGE ("PIDL: -------- pidl=%p\n", pidl);
69 if (pidltemp->mkid.cb)
70 {
71 do
72 {
73 DWORD dwAttrib = 0;
74 LPPIDLDATA pData = _ILGetDataPointer(pidltemp);
75 DWORD type = pData->type;
76 LPSTR szLongName = _ILGetTextPointer(pidltemp);
77 LPSTR szShortName = _ILGetSTextPointer(pidltemp);
78 char szName[MAX_PATH];
79
80 _ILSimpleGetText(pidltemp, szName, MAX_PATH);
81 if( PT_FOLDER == type)
82 dwAttrib = pData->u.folder.uFileAttribs;
83 else if( PT_VALUE == type)
84 dwAttrib = pData->u.file.uFileAttribs;
85
86 MESSAGE ("PIDL: -- pidl=%p size=%u type=%lx attr=0x%08lx name=%s (%s,%s)\n",
87 pidltemp, pidltemp->mkid.cb,type,dwAttrib,szName,debugstr_a(szLongName), debugstr_a(szShortName));
88
89 pidltemp = ODIN_ILGETNEXT(pidltemp);
90
91 } while (pidltemp->mkid.cb);
92 }
93 else
94 {
95 MESSAGE ("PIDL: empty pidl (Desktop)\n");
96 }
97 pcheck(pidl);
98 }
99
100 __SET_DEBUGGING(__DBCL_TRACE, __wine_dbch_shell, bIsShellDebug);
101 __SET_DEBUGGING(__DBCL_TRACE, __wine_dbch_pidl, TRUE);
102
103}
104#endif
105#define BYTES_PRINTED 32
106BOOL pcheck (LPCITEMIDLIST pidl)
107{ DWORD type, ret=TRUE;
108 BOOL bIsPidlDebug;
109
110 LPITEMIDLIST pidltemp = pidl;
111
112 bIsPidlDebug = TRACE_ON(shell);
113 __SET_DEBUGGING(__DBCL_TRACE, __wine_dbch_pidl, FALSE);
114
115 if (pidltemp && pidltemp->mkid.cb)
116 { do
117 { type = _ILGetDataPointer(pidltemp)->type;
118 switch (type)
119 { case PT_DESKTOP:
120 case PT_MYCOMP:
121 case PT_SPECIAL:
122 case PT_DRIVE:
123 case PT_DRIVE1:
124 case PT_DRIVE2:
125 case PT_DRIVE3:
126 case PT_FOLDER:
127 case PT_VALUE:
128 case PT_FOLDER1:
129 case PT_WORKGRP:
130 case PT_COMP:
131 case PT_NETWORK:
132 case PT_IESPECIAL1:
133 case PT_IESPECIAL2:
134 case PT_SHARE:
135 break;
136 default:
137 {
138 char szTemp[BYTES_PRINTED*4 + 1];
139 int i;
140 unsigned char c;
141
142 memset(szTemp, ' ', BYTES_PRINTED*4 + 1);
143 for ( i = 0; (i<pidltemp->mkid.cb) && (i<BYTES_PRINTED); i++)
144 {
145 c = ((unsigned char *)pidltemp)[i];
146
147 szTemp[i*3+0] = ((c>>4)>9)? (c>>4)+55 : (c>>4)+48;
148 szTemp[i*3+1] = ((0x0F&c)>9)? (0x0F&c)+55 : (0x0F&c)+48;
149 szTemp[i*3+2] = ' ';
150 szTemp[i+BYTES_PRINTED*3] = (c>=0x20 && c <=0x80) ? c : '.';
151 }
152 szTemp[BYTES_PRINTED*4] = 0x00;
153 ERR("unknown IDLIST type size=%u type=%lx\n%s\n",pidltemp->mkid.cb,type, szTemp);
154 ret = FALSE;
155 }
156 }
157 pidltemp = ODIN_ILGETNEXT(pidltemp);
158 } while (pidltemp->mkid.cb);
159 }
160 __SET_DEBUGGING(__DBCL_TRACE, __wine_dbch_pidl, bIsPidlDebug);
161 return ret;
162}
163
164/*************************************************************************
165 * ILGetDisplayName [SHELL32.15]
166 */
167
168ODINFUNCTION2(BOOL, ILGetDisplayName,
169 LPCITEMIDLIST, pidl,
170 LPSTR, path)
171{
172 TRACE_(shell)("pidl=%p %p semi-stub\n",pidl,path);
173 return SHGetPathFromIDListA(pidl, path);
174}
175/*************************************************************************
176 * ILFindLastID [SHELL32.16]
177 *
178 * NOTES
179 * observed: pidl=Desktop return=pidl
180 */
181ODINFUNCTION1(LPITEMIDLIST, ILFindLastID,
182 LPITEMIDLIST, pidl)
183{ LPITEMIDLIST pidlLast = pidl;
184
185 TRACE("(pidl=%p)\n",pidl);
186
187 while (pidl->mkid.cb)
188 {
189 pidlLast = pidl;
190 pidl = ODIN_ILGETNEXT(pidl);
191 }
192 return pidlLast;
193}
194/*************************************************************************
195 * ILRemoveLastID [SHELL32.17]
196 *
197 * NOTES
198 * when pidl=Desktop return=FALSE
199 */
200ODINFUNCTION1(BOOL, ILRemoveLastID,
201 LPCITEMIDLIST, pidl)
202{
203 TRACE_(shell)("pidl=%p\n",pidl);
204
205 if (!pidl || !pidl->mkid.cb)
206 return 0;
207 ILFindLastID(pidl)->mkid.cb = 0;
208 return 1;
209}
210
211/*************************************************************************
212 * ILClone [SHELL32.18]
213 *
214 * NOTES
215 * dupicate an idlist
216 */
217ODINFUNCTION1(LPITEMIDLIST, ILClone,
218 LPCITEMIDLIST, pidl)
219{ DWORD len;
220 LPITEMIDLIST newpidl;
221
222 if (!pidl)
223 return NULL;
224
225 len = ILGetSize(pidl);
226 newpidl = (LPITEMIDLIST)SHAlloc(len);
227 if (newpidl)
228 memcpy(newpidl,pidl,len);
229
230 TRACE("pidl=%p newpidl=%p\n",pidl, newpidl);
231 pdump(pidl);
232
233 return newpidl;
234}
235/*************************************************************************
236 * ILCloneFirst [SHELL32.19]
237 *
238 * NOTES
239 * duplicates the first idlist of a complex pidl
240 */
241ODINFUNCTION1(LPITEMIDLIST, ILCloneFirst,
242 LPCITEMIDLIST, pidl)
243{ DWORD len;
244 LPITEMIDLIST pidlNew = NULL;
245
246 TRACE("pidl=%p \n",pidl);
247 pdump(pidl);
248
249 if (pidl)
250 {
251 len = pidl->mkid.cb;
252 pidlNew = (LPITEMIDLIST) SHAlloc (len+2);
253 if (pidlNew)
254 {
255 memcpy(pidlNew,pidl,len+2); /* 2 -> mind a desktop pidl */
256
257 if (len)
258 ODIN_ILGETNEXT(pidlNew)->mkid.cb = 0x00;
259 }
260 }
261 TRACE("-- newpidl=%p\n",pidlNew);
262
263 return pidlNew;
264}
265
266/*************************************************************************
267 * ILLoadFromStream
268 *
269 * NOTES
270 * the first two bytes are the len, the pidl is following then
271 */
272ODINFUNCTION2(HRESULT, ILLoadFromStream,
273 IStream *, pStream,
274 LPITEMIDLIST *, ppPidl)
275{ WORD wLen = 0;
276 DWORD dwBytesRead;
277 HRESULT ret = E_FAIL;
278
279
280 TRACE_(shell)("%p %p\n", pStream , ppPidl);
281
282 if (*ppPidl)
283 { SHFree(*ppPidl);
284 *ppPidl = NULL;
285 }
286
287 IStream_AddRef (pStream);
288
289 if (SUCCEEDED(IStream_Read(pStream, (LPVOID)&wLen, 2, &dwBytesRead)))
290 { *ppPidl = SHAlloc (wLen);
291 if (SUCCEEDED(IStream_Read(pStream, *ppPidl , wLen, &dwBytesRead)))
292 { ret = S_OK;
293 }
294 else
295 { SHFree(*ppPidl);
296 *ppPidl = NULL;
297 }
298 }
299
300 /* we are not yet fully compatible */
301 if (!pcheck(*ppPidl))
302 { SHFree(*ppPidl);
303 *ppPidl = NULL;
304 }
305
306
307 IStream_Release (pStream);
308
309 return ret;
310}
311
312/*************************************************************************
313 * ILSaveToStream
314 *
315 * NOTES
316 * the first two bytes are the len, the pidl is following then
317 */
318ODINFUNCTION2(HRESULT, ILSaveToStream,
319 IStream *, pStream,
320 LPCITEMIDLIST, pPidl)
321{
322 LPITEMIDLIST pidl;
323 WORD wLen = 0;
324 HRESULT ret = E_FAIL;
325
326 TRACE_(shell)("%p %p\n", pStream, pPidl);
327
328 IStream_AddRef (pStream);
329
330 pidl = pPidl;
331 while (pidl->mkid.cb)
332 {
333 wLen += sizeof(WORD) + pidl->mkid.cb;
334 pidl = ODIN_ILGETNEXT(pidl);
335 }
336
337 if (SUCCEEDED(IStream_Write(pStream, (LPVOID)&wLen, 2, NULL)))
338 {
339 if (SUCCEEDED(IStream_Write(pStream, pPidl, wLen, NULL)))
340 { ret = S_OK;
341 }
342 }
343
344
345 IStream_Release (pStream);
346
347 return ret;
348}
349
350/*************************************************************************
351 * SHILCreateFromPath [SHELL32.28]
352 *
353 * NOTES
354 * wraper for IShellFolder::ParseDisplayName()
355 */
356ODINFUNCTION3(HRESULT, SHILCreateFromPathA,
357 LPCSTR, path,
358 LPITEMIDLIST *, ppidl,
359 DWORD *, attributes)
360{ LPSHELLFOLDER sf;
361 WCHAR lpszDisplayName[MAX_PATH];
362 DWORD pchEaten;
363 HRESULT ret = E_FAIL;
364
365 TRACE_(shell)("%s %p 0x%08lx\n",path,ppidl,attributes?*attributes:0);
366
367 if (!MultiByteToWideChar( CP_ACP, 0, path, -1, lpszDisplayName, MAX_PATH ))
368 lpszDisplayName[MAX_PATH-1] = 0;
369
370 if (SUCCEEDED (SHGetDesktopFolder(&sf)))
371 {
372 ret = IShellFolder_ParseDisplayName(sf,0, NULL,lpszDisplayName,&pchEaten,ppidl,attributes);
373 IShellFolder_Release(sf);
374 }
375 return ret;
376}
377
378
379ODINFUNCTION3(HRESULT, SHILCreateFromPathW,
380 LPCWSTR, path,
381 LPITEMIDLIST *, ppidl,
382 DWORD *, attributes)
383{ LPSHELLFOLDER sf;
384 DWORD pchEaten;
385 HRESULT ret = E_FAIL;
386
387 TRACE_(shell)("%s %p 0x%08lx\n",debugstr_w(path),ppidl,attributes?*attributes:0);
388
389 if (SUCCEEDED (SHGetDesktopFolder(&sf)))
390 {
391 ret = IShellFolder_ParseDisplayName(sf,0, NULL, (LPWSTR) path, &pchEaten, ppidl, attributes);
392 IShellFolder_Release(sf);
393 }
394 return ret;
395}
396HRESULT WINAPI SHILCreateFromPathAW (LPCVOID path, LPITEMIDLIST * ppidl, DWORD * attributes)
397{
398 if ( SHELL_OsIsUnicode())
399 return SHILCreateFromPathW (path, ppidl, attributes);
400 return SHILCreateFromPathA (path, ppidl, attributes);
401}
402
403/*************************************************************************
404 * SHCloneSpecialIDList [SHELL32.89]
405 *
406 * PARAMETERS
407 * hwndOwner [in]
408 * nFolder [in] CSIDL_xxxxx ??
409 *
410 * RETURNS
411 * pidl ??
412 * NOTES
413 * exported by ordinal
414 */
415ODINFUNCTION3(LPITEMIDLIST, SHCloneSpecialIDList,
416 HWND, hwndOwner,
417 DWORD, nFolder,
418 DWORD, x3)
419{ LPITEMIDLIST ppidl;
420 WARN_(shell)("(hwnd=0x%x,csidl=0x%lx,0x%lx):semi-stub.\n",
421 hwndOwner,nFolder,x3);
422
423 SHGetSpecialFolderLocation(hwndOwner, nFolder, &ppidl);
424
425 return ppidl;
426}
427
428/*************************************************************************
429 * ILGlobalClone [SHELL32.97]
430 *
431 */
432ODINFUNCTION1(LPITEMIDLIST, ILGlobalClone,
433 LPCITEMIDLIST, pidl)
434{ DWORD len;
435 LPITEMIDLIST newpidl;
436
437 if (!pidl)
438 return NULL;
439
440 len = ILGetSize(pidl);
441 newpidl = (LPITEMIDLIST)pCOMCTL32_Alloc(len);
442 if (newpidl)
443 memcpy(newpidl,pidl,len);
444
445 TRACE("pidl=%p newpidl=%p\n",pidl, newpidl);
446 pdump(pidl);
447
448 return newpidl;
449}
450
451/*************************************************************************
452 * ILIsEqual [SHELL32.21]
453 *
454 */
455ODINFUNCTION2(BOOL, ILIsEqual,
456 LPCITEMIDLIST, pidl1,
457 LPCITEMIDLIST, pidl2)
458{
459// char szData1[MAX_PATH];
460// char szData2[MAX_PATH];
461
462// LPITEMIDLIST pidltemp1 = pidl1;
463// LPITEMIDLIST pidltemp2 = pidl2;
464
465 TRACE("pidl1=%p pidl2=%p\n",pidl1, pidl2);
466
467 /* explorer reads from registry directly (StreamMRU),
468 so we can only check here */
469// if ((!pcheck (pidl1)) || (!pcheck (pidl2))) return FALSE;
470
471// pdump (pidl1);
472// pdump (pidl2);
473
474 if ( (!pidl1) || (!pidl2) ) return FALSE;
475
476 while (pidl1->mkid.cb && pidl2->mkid.cb)
477 {
478 // compare lengths first
479 if (pidl1->mkid.cb != pidl2->mkid.cb)
480 return FALSE;
481
482// _ILSimpleGetText(pidltemp1, szData1, MAX_PATH);
483// _ILSimpleGetText(pidltemp2, szData2, MAX_PATH);
484//
485// if (strcasecmp ( szData1, szData2 )!=0 )
486 if (_ILSimpleCompareText(pidl1, pidl2) != 0)
487 return FALSE;
488
489 pidl1 = ODIN_ILGETNEXT(pidl1);
490 pidl2 = ODIN_ILGETNEXT(pidl2);
491 }
492
493 if (!pidl1->mkid.cb && !pidl2->mkid.cb)
494 {
495 return TRUE;
496 }
497
498 return FALSE;
499}
500/*************************************************************************
501 * ILIsParent [SHELL32.23]
502 *
503 * parent=a/b child=a/b/c -> true, c is in folder a/b
504 * child=a/b/c/d -> false if bImmediate is true, d is not in folder a/b
505 * child=a/b/c/d -> true if bImmediate is false, d is in a subfolder of a/b
506 */
507ODINFUNCTION3(BOOL, ILIsParent,
508 LPCITEMIDLIST, pidlParent,
509 LPCITEMIDLIST, pidlChild,
510 BOOL, bImmediate)
511{
512 char szData1[MAX_PATH];
513 char szData2[MAX_PATH];
514
515 LPITEMIDLIST pParent = pidlParent;
516 LPITEMIDLIST pChild = pidlChild;
517
518 TRACE("%p %p %x\n", pidlParent, pidlChild, bImmediate);
519
520 while (pParent->mkid.cb && pChild->mkid.cb)
521 {
522// _ILSimpleGetText(pParent, szData1, MAX_PATH);
523// _ILSimpleGetText(pChild, szData2, MAX_PATH);
524//
525// if (strcasecmp ( szData1, szData2 )!=0 )
526 if ( _ILSimpleCompareText(pParent, pChild) != 0)
527 return FALSE;
528
529 pParent = ODIN_ILGETNEXT(pParent);
530 pChild = ODIN_ILGETNEXT(pChild);
531 }
532
533 if ( pParent->mkid.cb || ! pChild->mkid.cb) /* child shorter or has equal length to parent */
534 return FALSE;
535
536 if ( ODIN_ILGETNEXT(pChild)->mkid.cb && bImmediate) /* not immediate descent */
537 return FALSE;
538
539 return TRUE;
540}
541
542/*************************************************************************
543 * ILFindChild [SHELL32.24]
544 *
545 * NOTES
546 * Compares elements from pidl1 and pidl2.
547 *
548 * pidl1 is desktop pidl2
549 * pidl1 shorter pidl2 pointer to first different element of pidl2
550 * if there was at least one equal element
551 * pidl2 shorter pidl1 0
552 * pidl2 equal pidl1 pointer to last 0x00-element of pidl2
553 */
554ODINFUNCTION2(LPITEMIDLIST, ILFindChild,
555 LPCITEMIDLIST, pidl1,
556 LPCITEMIDLIST, pidl2)
557{
558 char szData1[MAX_PATH];
559 char szData2[MAX_PATH];
560
561 LPITEMIDLIST pidltemp1 = pidl1;
562 LPITEMIDLIST pidltemp2 = pidl2;
563 LPITEMIDLIST ret=NULL;
564
565 TRACE("pidl1=%p pidl2=%p\n",pidl1, pidl2);
566
567 /* explorer reads from registry directly (StreamMRU),
568 so we can only check here */
569 if ((!pcheck (pidl1)) || (!pcheck (pidl2)))
570 return FALSE;
571
572 pdump (pidl1);
573 pdump (pidl2);
574
575 if ( _ILIsDesktop(pidl1) )
576 {
577 ret = pidl2;
578 }
579 else
580 {
581 while (pidltemp1->mkid.cb && pidltemp2->mkid.cb)
582 {
583// _ILSimpleGetText(pidltemp1, szData1, MAX_PATH);
584// _ILSimpleGetText(pidltemp2, szData2, MAX_PATH);
585//
586// if (strcasecmp(szData1,szData2))
587 if ( _ILSimpleCompareText( pidltemp1, pidltemp2 ) )
588 break;
589
590 pidltemp1 = ODIN_ILGETNEXT(pidltemp1);
591 pidltemp2 = ODIN_ILGETNEXT(pidltemp2);
592 ret = pidltemp2;
593 }
594
595 if (pidltemp1->mkid.cb)
596 {
597 ret = NULL; /* elements of pidl1 left*/
598 }
599 }
600 TRACE_(shell)("--- %p\n", ret);
601 return ret; /* pidl 1 is shorter */
602}
603
604/*************************************************************************
605 * ILCombine [SHELL32.25]
606 *
607 * NOTES
608 * Concatenates two complex idlists.
609 * The pidl is the first one, pidlsub the next one
610 * Does not destroy the passed in idlists!
611 */
612ODINFUNCTION2(LPITEMIDLIST, ILCombine,
613 LPCITEMIDLIST, pidl1,
614 LPCITEMIDLIST, pidl2)
615{
616 DWORD len1,len2;
617 LPITEMIDLIST pidlNew;
618
619
620 if(!pidl1 && !pidl2) return NULL;
621
622 pdump (pidl1);
623 pdump (pidl2);
624
625 if(!pidl1)
626 {
627 pidlNew = ILClone(pidl2);
628 return pidlNew;
629 }
630
631 if(!pidl2)
632 {
633 pidlNew = ILClone(pidl1);
634 return pidlNew;
635 }
636
637 len1 = ILGetSize(pidl1)-2;
638 len2 = ILGetSize(pidl2);
639 pidlNew = SHAlloc(len1+len2);
640
641 if (pidlNew)
642 {
643 memcpy(pidlNew,pidl1,len1);
644 memcpy(((BYTE *)pidlNew)+len1,pidl2,len2);
645 }
646
647 /* TRACE(pidl,"--new pidl=%p\n",pidlNew);*/
648 return pidlNew;
649}
650/*************************************************************************
651 * SHGetRealIDL [SHELL32.98]
652 *
653 * NOTES
654 */
655ODINFUNCTION3(LPITEMIDLIST, SHGetRealIDL,
656 LPSHELLFOLDER, lpsf,
657 LPITEMIDLIST, pidl,
658 DWORD, z)
659{
660 dprintf(("not yet implemented"));
661
662 FIXME("sf=%p pidl=%p 0x%04lx\n",lpsf,pidl,z);
663
664 pdump (pidl);
665 return 0;
666}
667
668/*************************************************************************
669 * SHLogILFromFSIL [SHELL32.95]
670 *
671 * NOTES
672 * pild = CSIDL_DESKTOP ret = 0
673 * pild = CSIDL_DRIVES ret = 0
674 */
675ODINFUNCTION1(LPITEMIDLIST, SHLogILFromFSIL,
676 LPITEMIDLIST, pidl)
677{
678 dprintf(("not yet implemented"));
679
680 FIXME("(pidl=%p)\n",pidl);
681
682 pdump(pidl);
683
684 return 0;
685}
686
687/*************************************************************************
688 * ILGetSize [SHELL32.152]
689 * gets the byte size of an idlist including zero terminator (pidl)
690 *
691 * PARAMETERS
692 * pidl ITEMIDLIST
693 *
694 * RETURNS
695 * size of pidl
696 *
697 * NOTES
698 * exported by ordinal
699 */
700ODINFUNCTION1(DWORD, ILGetSize,
701 LPITEMIDLIST, pidl)
702{
703 LPSHITEMID si = &(pidl->mkid);
704 DWORD len=0;
705
706 // @@@PH this cannot be correct: pidl==NULL would crash!
707 if (pidl)
708 {
709 while (si->cb)
710 {
711 len += si->cb;
712 si = (LPSHITEMID)(((LPBYTE)si)+si->cb);
713 }
714 len += 2;
715 }
716 TRACE("pidl=%p size=%lu\n",pidl, len);
717 return len;
718}
719
720/*************************************************************************
721 * ODIN_ILGETNEXT [SHELL32.153]
722 * gets the next simple pidl of a complex pidl
723 *
724 * observed return values:
725 * null -> null
726 * desktop -> null
727 * simple pidl -> pointer to 0x0000 element
728 *
729 */
730ODINFUNCTION1(LPITEMIDLIST, ILGetNext,
731 LPITEMIDLIST, pidl)
732{
733#ifdef __WIN32OS2__
734 return ODIN_ILGETNEXT(pidl);
735#else
736 WORD len;
737
738 if(pidl)
739 {
740 len = pidl->mkid.cb;
741 if (len)
742 return (LPITEMIDLIST) (((LPBYTE)pidl)+len);
743 }
744 return NULL;
745#endif
746}
747/*************************************************************************
748 * ILAppend [SHELL32.154]
749 *
750 * NOTES
751 * Adds the single item to the idlist indicated by pidl.
752 * if bEnd is 0, adds the item to the front of the list,
753 * otherwise adds the item to the end. (???)
754 * Destroys the passed in idlist! (???)
755 */
756ODINFUNCTION3(LPITEMIDLIST, ILAppend,
757 LPITEMIDLIST, pidl,
758 LPCITEMIDLIST, item,
759 BOOL, bEnd)
760{
761 LPITEMIDLIST idlRet;
762
763 WARN("(pidl=%p,pidl=%p,%08u)semi-stub\n",pidl,item,bEnd);
764
765 pdump (pidl);
766 pdump (item);
767
768 if (_ILIsDesktop(pidl))
769 {
770 idlRet = ILClone(item);
771 if (pidl)
772 SHFree (pidl);
773 return idlRet;
774 }
775
776 if (bEnd)
777 {
778 idlRet=ILCombine(pidl,item);
779 }
780 else
781 {
782 idlRet=ILCombine(item,pidl);
783 }
784
785 SHFree(pidl);
786 return idlRet;
787}
788/*************************************************************************
789 * ILFree [SHELL32.155]
790 *
791 * NOTES
792 * free_check_ptr - frees memory (if not NULL)
793 * allocated by SHMalloc allocator
794 * exported by ordinal
795 */
796ODINFUNCTION1(DWORD, ILFree,
797 LPITEMIDLIST, pidl)
798{
799 if(!pidl)
800 return FALSE;
801 SHFree(pidl);
802 return TRUE;
803}
804/*************************************************************************
805 * ILGlobalFree [SHELL32.156]
806 *
807 */
808ODINPROCEDURE1(ILGlobalFree,
809 LPCITEMIDLIST, pidl)
810{
811 TRACE("%p\n",pidl);
812
813 if(!pidl) return;
814 pCOMCTL32_Free(pidl);
815}
816/*************************************************************************
817 * ILCreateFromPath [SHELL32.157]
818 *
819 */
820ODINFUNCTION1(LPITEMIDLIST, ILCreateFromPathA,
821 LPCSTR, path)
822{
823 LPITEMIDLIST pidlnew;
824 DWORD attributes = 0;
825
826 TRACE_(shell)("%s\n",path);
827
828 if (SUCCEEDED (SHILCreateFromPathA (path, &pidlnew, &attributes)))
829 return pidlnew;
830 return FALSE;
831}
832
833
834ODINFUNCTION1(LPITEMIDLIST, ILCreateFromPathW,
835 LPCWSTR, path)
836{
837 LPITEMIDLIST pidlnew;
838 DWORD attributes = 0;
839
840 TRACE_(shell)("%s\n",debugstr_w(path));
841
842 if (SUCCEEDED (SHILCreateFromPathW (path, &pidlnew, &attributes)))
843 return pidlnew;
844 return FALSE;
845}
846LPITEMIDLIST WINAPI ILCreateFromPathAW (LPCVOID path)
847{
848 if ( SHELL_OsIsUnicode())
849 return ILCreateFromPathW (path);
850 return ILCreateFromPathA (path);
851}
852/*************************************************************************
853 * SHSimpleIDListFromPath [SHELL32.162]
854 */
855ODINFUNCTION1(LPITEMIDLIST, SHSimpleIDListFromPathA,
856 LPCSTR, lpszPath)
857{
858 LPITEMIDLIST pidl=NULL;
859 HANDLE hFile;
860 WIN32_FIND_DATAA stffile;
861
862 TRACE("path=%s\n", lpszPath);
863
864 if (!lpszPath) return NULL;
865
866 hFile = FindFirstFileA(lpszPath, &stffile);
867
868 if ( hFile != INVALID_HANDLE_VALUE )
869 {
870 if (stffile.dwFileAttributes & FILE_ATTRIBUTE_DIRECTORY)
871 {
872 pidl = _ILCreateFolder (&stffile);
873 }
874 else
875 {
876 pidl = _ILCreateValue (&stffile);
877 }
878 FindClose (hFile);
879 }
880 return pidl;
881}
882
883
884ODINFUNCTION1(LPITEMIDLIST, SHSimpleIDListFromPathW,
885 LPCWSTR, lpszPath)
886{
887 char lpszTemp[MAX_PATH];
888 TRACE("path=%s\n",debugstr_w(lpszPath));
889
890 if (!WideCharToMultiByte( CP_ACP, 0, lpszPath, -1, lpszTemp, sizeof(lpszTemp), NULL, NULL ))
891 lpszTemp[sizeof(lpszTemp)-1] = 0;
892
893 return SHSimpleIDListFromPathA (lpszTemp);
894}
895
896LPITEMIDLIST WINAPI SHSimpleIDListFromPathAW (LPCVOID lpszPath)
897{
898 if ( SHELL_OsIsUnicode())
899 return SHSimpleIDListFromPathW (lpszPath);
900 return SHSimpleIDListFromPathA (lpszPath);
901}
902
903/*************************************************************************
904 * SHGetSpecialFolderLocation [SHELL32.223]
905 *
906 * gets the folder locations from the registry and creates a pidl
907 * creates missing reg keys and directorys
908 *
909 * PARAMS
910 * hwndOwner [I]
911 * nFolder [I] CSIDL_xxxxx
912 * ppidl [O] PIDL of a special folder
913 *
914 */
915ODINFUNCTION3(HRESULT, SHGetSpecialFolderLocation,
916 HWND, hwndOwner,
917 INT, nFolder,
918 LPITEMIDLIST *, ppidl)
919{
920 CHAR szPath[MAX_PATH];
921 HRESULT hr = E_INVALIDARG;
922
923 TRACE_(shell)("(%04x,0x%x,%p)\n", hwndOwner,nFolder,ppidl);
924
925 if (ppidl)
926 {
927 *ppidl = NULL;
928 switch (nFolder)
929 {
930 case CSIDL_DESKTOP:
931 *ppidl = _ILCreateDesktop();
932 break;
933
934 case CSIDL_DRIVES:
935 *ppidl = _ILCreateMyComputer();
936 break;
937
938 case CSIDL_NETWORK:
939 *ppidl = _ILCreateNetwork ();
940 break;
941
942 case CSIDL_CONTROLS:
943 *ppidl = _ILCreateControl ();
944 break;
945
946 case CSIDL_PRINTERS:
947 *ppidl = _ILCreatePrinter ();
948 break;
949
950 case CSIDL_BITBUCKET:
951 *ppidl = _ILCreateBitBucket ();
952 break;
953
954 default:
955 if (SHGetSpecialFolderPathA(hwndOwner, szPath, nFolder, TRUE))
956 {
957 DWORD attributes=0;
958 TRACE_(shell)("Value=%s\n",szPath);
959 hr = SHILCreateFromPathA(szPath, ppidl, &attributes);
960 }
961 }
962 if(*ppidl) hr = NOERROR;
963 }
964
965 TRACE_(shell)("-- (new pidl %p)\n",*ppidl);
966 return hr;
967}
968
969/*************************************************************************
970 * SHGetFolderLocation [SHELL32]
971 *
972 * NOTES
973 * the pidl can be a simple one. since we cant get the path out of the pidl
974 * we have to take all data from the pidl
975 */
976ODINFUNCTION5(HRESULT, SHGetFolderLocation,
977 HWND, hwnd,
978 int, csidl,
979 HANDLE, hToken,
980 DWORD, dwFlags,
981 LPITEMIDLIST *, ppidl)
982{
983 FIXME("0x%04x 0x%08x 0x%08x 0x%08lx %p\n",
984 hwnd, csidl, hToken, dwFlags, ppidl);
985 return SHGetSpecialFolderLocation(hwnd, csidl, ppidl);
986}
987
988/*************************************************************************
989 * SHGetDataFromIDListA [SHELL32.247]
990 *
991 * NOTES
992 * the pidl can be a simple one. since we cant get the path out of the pidl
993 * we have to take all data from the pidl
994 */
995ODINFUNCTION5(HRESULT, SHGetDataFromIDListA,
996 LPSHELLFOLDER, psf,
997 LPCITEMIDLIST, pidl,
998 int, nFormat,
999 LPVOID, dest,
1000 int, len)
1001{
1002 TRACE_(shell)("sf=%p pidl=%p 0x%04x %p 0x%04x stub\n",psf,pidl,nFormat,dest,len);
1003
1004 pdump(pidl);
1005 if (!psf || !dest ) return E_INVALIDARG;
1006
1007 switch (nFormat)
1008 {
1009 case SHGDFIL_FINDDATA:
1010 {
1011 WIN32_FIND_DATAA * pfd = dest;
1012
1013 if ( len < sizeof (WIN32_FIND_DATAA)) return E_INVALIDARG;
1014
1015 ZeroMemory(pfd, sizeof (WIN32_FIND_DATAA));
1016 _ILGetFileDateTime( pidl, &(pfd->ftLastWriteTime));
1017 pfd->dwFileAttributes = _ILGetFileAttributes(pidl, NULL, 0);
1018 pfd->nFileSizeLow = _ILGetFileSize ( pidl, NULL, 0);
1019 lstrcpynA(pfd->cFileName,_ILGetTextPointer(pidl), MAX_PATH);
1020 lstrcpynA(pfd->cAlternateFileName,_ILGetSTextPointer(pidl), 14);
1021 }
1022 return NOERROR;
1023
1024 case SHGDFIL_NETRESOURCE:
1025 case SHGDFIL_DESCRIPTIONID:
1026 FIXME_(shell)("SHGDFIL %i stub\n", nFormat);
1027 break;
1028
1029 default:
1030 ERR_(shell)("Unknown SHGDFIL %i, please report\n", nFormat);
1031 }
1032
1033 return E_INVALIDARG;
1034}
1035/*************************************************************************
1036 * SHGetDataFromIDListW [SHELL32.247]
1037 *
1038 */
1039ODINFUNCTION5(HRESULT, SHGetDataFromIDListW,
1040 LPSHELLFOLDER, psf,
1041 LPCITEMIDLIST, pidl,
1042 int, nFormat,
1043 LPVOID, dest,
1044 int, len)
1045{
1046 TRACE_(shell)("sf=%p pidl=%p 0x%04x %p 0x%04x stub\n",psf,pidl,nFormat,dest,len);
1047
1048 pdump(pidl);
1049
1050 if (! psf || !dest ) return E_INVALIDARG;
1051
1052 switch (nFormat)
1053 {
1054 case SHGDFIL_FINDDATA:
1055 {
1056 WIN32_FIND_DATAW * pfd = dest;
1057
1058 if ( len < sizeof (WIN32_FIND_DATAW)) return E_INVALIDARG;
1059
1060 ZeroMemory(pfd, sizeof (WIN32_FIND_DATAA));
1061 _ILGetFileDateTime( pidl, &(pfd->ftLastWriteTime));
1062 pfd->dwFileAttributes = _ILGetFileAttributes(pidl, NULL, 0);
1063 pfd->nFileSizeLow = _ILGetFileSize ( pidl, NULL, 0);
1064 if (!MultiByteToWideChar( CP_ACP, 0, _ILGetTextPointer(pidl), -1,
1065 pfd->cFileName, MAX_PATH ))
1066 pfd->cFileName[MAX_PATH-1] = 0;
1067 if (!MultiByteToWideChar( CP_ACP, 0, _ILGetSTextPointer(pidl), -1,
1068 pfd->cAlternateFileName, 14 ))
1069 pfd->cFileName[13] = 0;
1070 }
1071 return NOERROR;
1072 case SHGDFIL_NETRESOURCE:
1073 case SHGDFIL_DESCRIPTIONID:
1074 FIXME_(shell)("SHGDFIL %i stub\n", nFormat);
1075 break;
1076
1077 default:
1078 ERR_(shell)("Unknown SHGDFIL %i, please report\n", nFormat);
1079 }
1080
1081 return E_INVALIDARG;
1082}
1083
1084/*************************************************************************
1085 * SHGetPathFromIDListA [SHELL32.261][NT 4.0: SHELL32.220]
1086 *
1087 * PARAMETERS
1088 * pidl, [IN] pidl
1089 * pszPath [OUT] path
1090 *
1091 * RETURNS
1092 * path from a passed PIDL.
1093 *
1094 * NOTES
1095 * NULL returns FALSE
1096 * desktop pidl gives path to desktopdirectory back
1097 * special pidls returning FALSE
1098 *
1099 * FIXME
1100 * fnGetDisplayNameOf can return different types of OLEString
1101 */
1102ODINFUNCTION2(BOOL, SHGetPathFromIDListA,
1103 LPCITEMIDLIST, pidl,
1104 LPSTR, pszPath)
1105{ STRRET str;
1106 LPSHELLFOLDER shellfolder;
1107
1108 TRACE_(shell)("(pidl=%p,%p)\n",pidl,pszPath);
1109
1110 if (!pidl) return FALSE;
1111
1112 pdump(pidl);
1113
1114 if(_ILIsDesktop(pidl))
1115 {
1116 SHGetSpecialFolderPathA(0, pszPath, CSIDL_DESKTOPDIRECTORY, FALSE);
1117 }
1118 else if (_ILIsSpecialFolder(ILFindLastID(pidl)))
1119 {
1120 /* we are somewhere in a special folder */
1121 return FALSE;
1122 }
1123 else
1124 {
1125 if (SHGetDesktopFolder(&shellfolder)==S_OK)
1126 {
1127 IShellFolder_GetDisplayNameOf(shellfolder,pidl,SHGDN_FORPARSING,&str);
1128 StrRetToStrNA (pszPath, MAX_PATH, &str, pidl);
1129 IShellFolder_Release(shellfolder);
1130 }
1131 }
1132 TRACE_(shell)("-- (%s)\n",pszPath);
1133
1134 return TRUE;
1135}
1136/*************************************************************************
1137 * SHGetPathFromIDListW [SHELL32.262]
1138 */
1139ODINFUNCTION2(BOOL, SHGetPathFromIDListW,
1140 LPCITEMIDLIST, pidl,
1141 LPWSTR, pszPath)
1142{ char sTemp[MAX_PATH];
1143
1144 TRACE_(shell)("(pidl=%p)\n", pidl);
1145
1146 SHGetPathFromIDListA (pidl, sTemp);
1147 MultiByteToWideChar( CP_ACP, 0, sTemp, -1, pszPath, MAX_PATH );
1148
1149 TRACE_(shell)("-- (%s)\n",debugstr_w(pszPath));
1150
1151 return TRUE;
1152}
1153
1154/*************************************************************************
1155 * SHBindToParent [shell version 5.0]
1156 */
1157ODINFUNCTION4(HRESULT, SHBindToParent,
1158 LPCITEMIDLIST, pidl,
1159 REFIID, riid,
1160 LPVOID *,ppv,
1161 LPCITEMIDLIST *,ppidlLast)
1162{
1163 IShellFolder * psf;
1164 LPITEMIDLIST pidlChild, pidlParent;
1165 HRESULT hr=E_FAIL;
1166
1167 TRACE_(shell)("pidl=%p\n", pidl);
1168 pdump(pidl);
1169
1170 *ppv = NULL;
1171 if (ppidlLast) *ppidlLast = NULL;
1172
1173 if (_ILIsPidlSimple(pidl))
1174 {
1175 /* we are on desktop level */
1176 if (ppidlLast)
1177 *ppidlLast = ILClone(pidl);
1178 hr = SHGetDesktopFolder((IShellFolder**)ppv);
1179 }
1180 else
1181 {
1182 pidlChild = ILClone(ILFindLastID(pidl));
1183 pidlParent = ILClone(pidl);
1184 ILRemoveLastID(pidlParent);
1185
1186 hr = SHGetDesktopFolder(&psf);
1187
1188 if (SUCCEEDED(hr))
1189 hr = IShellFolder_BindToObject(psf, pidlParent, NULL, riid, ppv);
1190
1191 if (SUCCEEDED(hr) && ppidlLast)
1192 *ppidlLast = pidlChild;
1193 else
1194 ILFree (pidlChild);
1195
1196 SHFree (pidlParent);
1197 if (psf) IShellFolder_Release(psf);
1198 }
1199
1200
1201 TRACE_(shell)("-- psf=%p pidl=%p ret=0x%08lx\n", *ppv, (ppidlLast)?*ppidlLast:NULL, hr);
1202 return hr;
1203}
1204
1205/*************************************************************************
1206 * SHGetPathFromIDListAW [SHELL32.221][NT 4.0: SHELL32.219]
1207 */
1208ODINFUNCTION2(BOOL, SHGetPathFromIDListAW,
1209 LPCITEMIDLIST, pidl,
1210 LPVOID, pszPath)
1211{
1212 TRACE_(shell)("(pidl=%p,%p)\n",pidl,pszPath);
1213
1214 if (SHELL_OsIsUnicode())
1215 return SHGetPathFromIDListW(pidl,pszPath);
1216 return SHGetPathFromIDListA(pidl,pszPath);
1217}
1218
1219/**************************************************************************
1220 *
1221 * internal functions
1222 *
1223 * ### 1. section creating pidls ###
1224 *
1225 *************************************************************************
1226 * _ILCreateDesktop()
1227 * _ILCreateIExplore()
1228 * _ILCreateMyComputer()
1229 * _ILCreateDrive()
1230 * _ILCreateFolder()
1231 * _ILCreateValue()
1232 */
1233LPITEMIDLIST _ILCreateDesktop()
1234{ TRACE("()\n");
1235 return _ILCreate(PT_DESKTOP, NULL, 0);
1236}
1237
1238LPITEMIDLIST _ILCreateMyComputer()
1239{ TRACE("()\n");
1240 return _ILCreate(PT_MYCOMP, &CLSID_MyComputer, sizeof(GUID));
1241}
1242
1243LPITEMIDLIST _ILCreateIExplore()
1244{ TRACE("()\n");
1245 return _ILCreate(PT_MYCOMP, &CLSID_Internet, sizeof(GUID));
1246}
1247
1248LPITEMIDLIST _ILCreateControl()
1249{ TRACE("()\n");
1250 return _ILCreate(PT_SPECIAL, &CLSID_ControlPanel, sizeof(GUID));
1251}
1252
1253LPITEMIDLIST _ILCreatePrinter()
1254{ TRACE("()\n");
1255 return _ILCreate(PT_SPECIAL, &CLSID_Printers, sizeof(GUID));
1256}
1257
1258LPITEMIDLIST _ILCreateNetwork()
1259{ TRACE("()\n");
1260 return _ILCreate(PT_MYCOMP, &CLSID_NetworkPlaces, sizeof(GUID));
1261}
1262
1263LPITEMIDLIST _ILCreateBitBucket()
1264{ TRACE("()\n");
1265 return _ILCreate(PT_MYCOMP, &CLSID_RecycleBin, sizeof(GUID));
1266}
1267
1268LPITEMIDLIST _ILCreateDrive( LPCSTR lpszNew)
1269{ char sTemp[4];
1270 lstrcpynA (sTemp,lpszNew,4);
1271 sTemp[2]='\\';
1272 sTemp[3]=0x00;
1273 TRACE("(%s)\n",sTemp);
1274 return _ILCreate(PT_DRIVE,(LPVOID)&sTemp[0],4);
1275}
1276
1277LPITEMIDLIST _ILCreateFolder( WIN32_FIND_DATAA * stffile )
1278{
1279 char buff[MAX_PATH + 14 +1]; /* see WIN32_FIND_DATA */
1280 char * pbuff = buff;
1281 ULONG len, len1;
1282 LPITEMIDLIST pidl;
1283
1284 TRACE("(%s, %s)\n",stffile->cAlternateFileName, stffile->cFileName);
1285
1286 /* prepare buffer with both names */
1287 len = strlen (stffile->cFileName) + 1;
1288 memcpy (pbuff, stffile->cFileName, len);
1289 pbuff += len;
1290
1291 if (stffile->cAlternateFileName)
1292 {
1293 len1 = strlen (stffile->cAlternateFileName)+1;
1294 memcpy (pbuff, stffile->cAlternateFileName, len1);
1295 }
1296 else
1297 {
1298 len1 = 1;
1299 *pbuff = 0x00;
1300 }
1301
1302 pidl = _ILCreate(PT_FOLDER, (LPVOID)buff, len + len1);
1303
1304 /* set attributes */
1305 if (pidl)
1306 {
1307 LPPIDLDATA pData;
1308 pData = _ILGetDataPointer(pidl);
1309 FileTimeToDosDateTime(&(stffile->ftLastWriteTime),&pData->u.folder.uFileDate,&pData->u.folder.uFileTime);
1310 pData->u.folder.dwFileSize = stffile->nFileSizeLow;
1311 pData->u.folder.uFileAttribs=stffile->dwFileAttributes;
1312 }
1313
1314 return pidl;
1315}
1316
1317LPITEMIDLIST _ILCreateValue(WIN32_FIND_DATAA * stffile)
1318{
1319 char buff[MAX_PATH + 14 +1]; /* see WIN32_FIND_DATA */
1320 char * pbuff = buff;
1321 ULONG len, len1;
1322 LPITEMIDLIST pidl;
1323
1324 TRACE("(%s, %s)\n",stffile->cAlternateFileName, stffile->cFileName);
1325
1326 /* prepare buffer with both names */
1327 len = strlen (stffile->cFileName) + 1;
1328 memcpy (pbuff, stffile->cFileName, len);
1329 pbuff += len;
1330
1331 if (stffile->cAlternateFileName)
1332 {
1333 len1 = strlen (stffile->cAlternateFileName)+1;
1334 memcpy (pbuff, stffile->cAlternateFileName, len1);
1335 }
1336 else
1337 {
1338 len1 = 1;
1339 *pbuff = 0x00;
1340 }
1341
1342 pidl = _ILCreate(PT_VALUE, (LPVOID)buff, len + len1);
1343
1344 /* set attributes */
1345 if (pidl)
1346 {
1347 LPPIDLDATA pData;
1348 pData = _ILGetDataPointer(pidl);
1349 FileTimeToDosDateTime(&(stffile->ftLastWriteTime),&pData->u.folder.uFileDate,&pData->u.folder.uFileTime);
1350 pData->u.folder.dwFileSize = stffile->nFileSizeLow;
1351 pData->u.folder.uFileAttribs=stffile->dwFileAttributes;
1352 }
1353
1354 return pidl;
1355}
1356
1357LPITEMIDLIST _ILCreateSpecial(LPCSTR szGUID)
1358{
1359 IID iid;
1360 WCHAR buffer[40];
1361
1362 if (!MultiByteToWideChar( CP_ACP, 0, szGUID, -1, buffer, sizeof(buffer)/sizeof(WCHAR) ))
1363 return NULL;
1364 CLSIDFromString( buffer, &iid );
1365 return _ILCreate(PT_MYCOMP, &iid, sizeof(IID));
1366}
1367
1368/**************************************************************************
1369 * _ILCreate()
1370 * Creates a new PIDL
1371 * type = PT_DESKTOP | PT_DRIVE | PT_FOLDER | PT_VALUE
1372 * pIn = data
1373 * uInSize = size of data (raw)
1374 */
1375
1376LPITEMIDLIST _ILCreate(PIDLTYPE type, LPCVOID pIn, UINT uInSize)
1377{
1378 LPITEMIDLIST pidlOut = NULL, pidlTemp = NULL;
1379 LPPIDLDATA pData;
1380 UINT uSize = 0;
1381 LPSTR pszDest;
1382
1383 TRACE("(0x%02x %p %i)\n",type,pIn,uInSize);
1384
1385 switch (type)
1386 {
1387 case PT_DESKTOP:
1388 uSize = 0;
1389 break;
1390 case PT_SPECIAL:
1391 case PT_MYCOMP:
1392 uSize = 2 + 2 + sizeof(GUID);
1393 break;
1394 case PT_DRIVE:
1395 uSize = 2 + 23;
1396 break;
1397 case PT_FOLDER:
1398 case PT_VALUE:
1399 uSize = 2 + 12 + uInSize;
1400 break;
1401 default:
1402 FIXME("can't create type: 0x%08x\n",type);
1403 return NULL;
1404 }
1405
1406 if(!(pidlOut = SHAlloc(uSize + 2))) return NULL;
1407 ZeroMemory(pidlOut, uSize + 2);
1408 pidlOut->mkid.cb = uSize;
1409
1410 switch (type)
1411 {
1412 case PT_DESKTOP:
1413 TRACE("- create Desktop\n");
1414 break;
1415
1416 case PT_SPECIAL:
1417 case PT_MYCOMP:
1418 pData =_ILGetDataPointer(pidlOut);
1419 pData->type = type;
1420 memcpy(&(pData->u.mycomp.guid), pIn, uInSize);
1421 TRACE("- create GUID-pidl\n");
1422 break;
1423
1424 case PT_DRIVE:
1425 pData =_ILGetDataPointer(pidlOut);
1426 pData->type = type;
1427 pszDest = _ILGetTextPointer(pidlOut);
1428 memcpy(pszDest, pIn, uInSize);
1429 TRACE("- create Drive: %s\n",debugstr_a(pszDest));
1430 break;
1431
1432 case PT_FOLDER:
1433 case PT_VALUE:
1434 pData =_ILGetDataPointer(pidlOut);
1435 pData->type = type;
1436 pszDest = _ILGetTextPointer(pidlOut);
1437 memcpy(pszDest, pIn, uInSize);
1438 TRACE("- create Value: %s\n",debugstr_a(pszDest));
1439 break;
1440 }
1441
1442 pidlTemp = ODIN_ILGETNEXT(pidlOut);
1443 if (pidlTemp)
1444 pidlTemp->mkid.cb = 0x00;
1445
1446 TRACE("-- (pidl=%p, size=%u)\n", pidlOut, uSize);
1447 return pidlOut;
1448}
1449
1450/**************************************************************************
1451 * _ILGetDrive()
1452 *
1453 * Gets the text for the drive eg. 'c:\'
1454 *
1455 * RETURNS
1456 * strlen (lpszText)
1457 */
1458DWORD _ILGetDrive(LPCITEMIDLIST pidl,LPSTR pOut, UINT uSize)
1459{ TRACE("(%p,%p,%u)\n",pidl,pOut,uSize);
1460
1461 if(_ILIsMyComputer(pidl))
1462 pidl = ODIN_ILGETNEXT(pidl);
1463
1464 if (pidl && _ILIsDrive(pidl))
1465 return _ILSimpleGetText(pidl, pOut, uSize);
1466
1467 return 0;
1468}
1469
1470/**************************************************************************
1471 *
1472 * ### 2. section testing pidls ###
1473 *
1474 **************************************************************************
1475 * _ILIsDesktop()
1476 * _ILIsMyComputer()
1477 * _ILIsSpecialFolder()
1478 * _ILIsDrive()
1479 * _ILIsFolder()
1480 * _ILIsValue()
1481 * _ILIsPidlSimple()
1482 */
1483BOOL _ILIsDesktop(LPCITEMIDLIST pidl)
1484{ TRACE("(%p)\n",pidl);
1485 return ( !pidl || (pidl && pidl->mkid.cb == 0x00) );
1486}
1487
1488BOOL _ILIsMyComputer(LPCITEMIDLIST pidl)
1489{
1490 REFIID iid = _ILGetGUIDPointer(pidl);
1491
1492 TRACE("(%p)\n",pidl);
1493
1494 if (iid)
1495 return IsEqualIID(iid, &CLSID_MyComputer);
1496 return FALSE;
1497}
1498
1499BOOL _ILIsSpecialFolder (LPCITEMIDLIST pidl)
1500{
1501 LPPIDLDATA lpPData = _ILGetDataPointer(pidl);
1502 TRACE("(%p)\n",pidl);
1503 return (pidl && ( (lpPData && (PT_MYCOMP== lpPData->type || PT_SPECIAL== lpPData->type)) ||
1504 (pidl && pidl->mkid.cb == 0x00)
1505 ));
1506}
1507
1508BOOL _ILIsDrive(LPCITEMIDLIST pidl)
1509{ LPPIDLDATA lpPData = _ILGetDataPointer(pidl);
1510 TRACE("(%p)\n",pidl);
1511 return (pidl && lpPData && (PT_DRIVE == lpPData->type ||
1512 PT_DRIVE1 == lpPData->type ||
1513 PT_DRIVE2 == lpPData->type ||
1514 PT_DRIVE3 == lpPData->type));
1515}
1516
1517BOOL _ILIsFolder(LPCITEMIDLIST pidl)
1518{ LPPIDLDATA lpPData = _ILGetDataPointer(pidl);
1519 TRACE("(%p)\n",pidl);
1520 return (pidl && lpPData && (PT_FOLDER == lpPData->type || PT_FOLDER1 == lpPData->type));
1521}
1522
1523BOOL _ILIsValue(LPCITEMIDLIST pidl)
1524{ LPPIDLDATA lpPData = _ILGetDataPointer(pidl);
1525 TRACE("(%p)\n",pidl);
1526 return (pidl && lpPData && PT_VALUE == lpPData->type);
1527}
1528
1529/**************************************************************************
1530 * _ILIsPidlSimple
1531 */
1532BOOL _ILIsPidlSimple ( LPCITEMIDLIST pidl)
1533{
1534 BOOL ret = TRUE;
1535
1536 if(! _ILIsDesktop(pidl)) /* pidl=NULL or mkid.cb=0 */
1537 {
1538 WORD len = pidl->mkid.cb;
1539 LPCITEMIDLIST pidlnext = (LPCITEMIDLIST) (((LPBYTE)pidl) + len );
1540 if (pidlnext->mkid.cb)
1541 ret = FALSE;
1542 }
1543
1544 TRACE("%s\n", ret ? "Yes" : "No");
1545 return ret;
1546}
1547
1548/**************************************************************************
1549 *
1550 * ### 3. section getting values from pidls ###
1551 */
1552
1553 /**************************************************************************
1554 * _ILSimpleGetText
1555 *
1556 * gets the text for the first item in the pidl (eg. simple pidl)
1557 *
1558 * returns the length of the string
1559 */
1560DWORD _ILSimpleGetText (LPCITEMIDLIST pidl, LPSTR szOut, UINT uOutSize)
1561{
1562 DWORD dwReturn=0;
1563 LPSTR szSrc;
1564 GUID const * riid;
1565 char szTemp[MAX_PATH];
1566
1567 TRACE("(%p %p %x)\n",pidl,szOut,uOutSize);
1568
1569 if (!pidl) return 0;
1570
1571 if (szOut)
1572 *szOut = 0;
1573
1574 if (_ILIsDesktop(pidl))
1575 {
1576 /* desktop */
1577 if (HCR_GetClassName(&CLSID_ShellDesktop, szTemp, MAX_PATH))
1578 {
1579 if (szOut)
1580 lstrcpynA(szOut, szTemp, uOutSize);
1581
1582 dwReturn = strlen (szTemp);
1583 }
1584 }
1585 else if (( szSrc = _ILGetTextPointer(pidl) ))
1586 {
1587 /* filesystem */
1588 if (szOut)
1589 lstrcpynA(szOut, szSrc, uOutSize);
1590
1591 dwReturn = strlen(szSrc);
1592 }
1593 else if (( riid = _ILGetGUIDPointer(pidl) ))
1594 {
1595 /* special folder */
1596 if ( HCR_GetClassName(riid, szTemp, MAX_PATH) )
1597 {
1598 if (szOut)
1599 lstrcpynA(szOut, szTemp, uOutSize);
1600
1601 dwReturn = strlen (szTemp);
1602 }
1603 }
1604 else
1605 {
1606 ERR("-- no text\n");
1607 }
1608
1609 TRACE("-- (%p=%s 0x%08lx)\n",szOut,(char*)szOut,dwReturn);
1610 return dwReturn;
1611}
1612
1613
1614 /**************************************************************************
1615 * _ILSimpleCompareText
1616 *
1617 * gets the text for the first item in the pidl (eg. simple pidl)
1618 * and compares it with the text for the second pidl
1619 *
1620 * returns the length of the string
1621 */
1622int _ILSimpleCompareText (LPCITEMIDLIST pidl1, LPCITEMIDLIST pidl2)
1623{
1624 LPSTR lpText1;
1625 LPSTR lpText2;
1626
1627 char szTemp1[MAX_PATH];
1628 char szTemp2[MAX_PATH];
1629 GUID const * riid;
1630
1631
1632 if (!pidl1 && !pidl2)
1633 return 0;
1634
1635 if (!pidl1 && pidl2)
1636 return -1;
1637
1638 if (pidl1 && !pidl2)
1639 return 1;
1640
1641
1642 // -------------
1643 // examine pidl1
1644 // -------------
1645 if (_ILIsDesktop(pidl1))
1646 {
1647 HCR_GetClassName(&CLSID_ShellDesktop, szTemp1, MAX_PATH);
1648 lpText1 = szTemp1;
1649 }
1650 else
1651 if ( lpText1 = _ILGetTextPointer(pidl1) )
1652 {
1653 // OK, nice to have a valid pointer :)
1654 }
1655 else
1656 if ( riid = _ILGetGUIDPointer(pidl1) )
1657 {
1658 /* special folder */
1659 HCR_GetClassName(riid, szTemp1, MAX_PATH);
1660 lpText1 = szTemp1;
1661 }
1662 else
1663 lpText1 = "undetermined";
1664
1665 // -------------
1666 // examine pidl2
1667 // -------------
1668 if (_ILIsDesktop(pidl2))
1669 {
1670 HCR_GetClassName(&CLSID_ShellDesktop, szTemp2, MAX_PATH);
1671 lpText2 = szTemp2;
1672 }
1673 else
1674 if ( lpText2 = _ILGetTextPointer(pidl2) )
1675 {
1676 // OK, nice to have a valid pointer :)
1677 }
1678 else
1679 if ( riid = _ILGetGUIDPointer(pidl2) )
1680 {
1681 /* special folder */
1682 HCR_GetClassName(riid, szTemp2, MAX_PATH);
1683 lpText2 = szTemp2;
1684 }
1685 else
1686 lpText2 = "undetermined";
1687
1688
1689 // now finally compare the texts
1690 return strcasecmp(lpText1, lpText2);
1691}
1692
1693
1694/**************************************************************************
1695 *
1696 * ### 4. getting pointers to parts of pidls ###
1697 *
1698 **************************************************************************
1699 * _ILGetDataPointer()
1700 */
1701LPPIDLDATA _ILGetDataPointer(LPITEMIDLIST pidl)
1702{
1703 if(pidl && pidl->mkid.cb != 0x00)
1704 return (LPPIDLDATA) &(pidl->mkid.abID);
1705 return NULL;
1706}
1707
1708/**************************************************************************
1709 * _ILGetTextPointer()
1710 * gets a pointer to the long filename string stored in the pidl
1711 */
1712LPSTR _ILGetTextPointer(LPCITEMIDLIST pidl)
1713{/* TRACE(pidl,"(pidl%p)\n", pidl);*/
1714
1715 LPPIDLDATA pdata =_ILGetDataPointer(pidl);
1716
1717 if (pdata)
1718 {
1719 switch (pdata->type)
1720 {
1721 case PT_MYCOMP:
1722 case PT_SPECIAL:
1723 return NULL;
1724
1725 case PT_DRIVE:
1726 case PT_DRIVE1:
1727 case PT_DRIVE2:
1728 case PT_DRIVE3:
1729 return (LPSTR)&(pdata->u.drive.szDriveName);
1730
1731 case PT_FOLDER:
1732 case PT_FOLDER1:
1733 case PT_VALUE:
1734 case PT_IESPECIAL1:
1735 case PT_IESPECIAL2:
1736 return (LPSTR)&(pdata->u.file.szNames);
1737
1738 case PT_WORKGRP:
1739 case PT_COMP:
1740 case PT_NETWORK:
1741 case PT_SHARE:
1742 return (LPSTR)&(pdata->u.network.szNames);
1743 }
1744 }
1745 return NULL;
1746}
1747
1748/**************************************************************************
1749 * _ILGetSTextPointer()
1750 * gets a pointer to the short filename string stored in the pidl
1751 */
1752LPSTR _ILGetSTextPointer(LPCITEMIDLIST pidl)
1753{/* TRACE(pidl,"(pidl%p)\n", pidl);*/
1754
1755 LPPIDLDATA pdata =_ILGetDataPointer(pidl);
1756
1757 if (pdata)
1758 {
1759 switch (pdata->type)
1760 {
1761 case PT_FOLDER:
1762 case PT_VALUE:
1763 case PT_IESPECIAL1:
1764 case PT_IESPECIAL2:
1765 return (LPSTR)(pdata->u.file.szNames + strlen (pdata->u.file.szNames) + 1);
1766
1767 case PT_WORKGRP:
1768 return (LPSTR)(pdata->u.network.szNames + strlen (pdata->u.network.szNames) + 1);
1769 }
1770 }
1771 return NULL;
1772}
1773
1774/**************************************************************************
1775 * _ILGetGUIDPointer()
1776 *
1777 * returns reference to guid stored in some pidls
1778 */
1779REFIID _ILGetGUIDPointer(LPCITEMIDLIST pidl)
1780{
1781 LPPIDLDATA pdata =_ILGetDataPointer(pidl);
1782
1783 if (pdata)
1784 {
1785 switch (pdata->type)
1786 {
1787 case PT_SPECIAL:
1788 case PT_MYCOMP:
1789 return (REFIID) &(pdata->u.mycomp.guid);
1790 }
1791 }
1792 return NULL;
1793}
1794
1795/*************************************************************************
1796 * _ILGetFileDateTime
1797 *
1798 * Given the ItemIdList, get the FileTime
1799 *
1800 * PARAMS
1801 * pidl [I] The ItemIDList
1802 * pFt [I] the resulted FILETIME of the file
1803 *
1804 * RETURNS
1805 * True if Successful
1806 *
1807 * NOTES
1808 *
1809 */
1810BOOL _ILGetFileDateTime(LPCITEMIDLIST pidl, FILETIME *pFt)
1811{
1812 LPPIDLDATA pdata =_ILGetDataPointer(pidl);
1813
1814 if(! pdata) return FALSE;
1815
1816 switch (pdata->type)
1817 {
1818 case PT_FOLDER:
1819 DosDateTimeToFileTime(pdata->u.folder.uFileDate, pdata->u.folder.uFileTime, pFt);
1820 break;
1821 case PT_VALUE:
1822 DosDateTimeToFileTime(pdata->u.file.uFileDate, pdata->u.file.uFileTime, pFt);
1823 break;
1824 default:
1825 return FALSE;
1826 }
1827 return TRUE;
1828}
1829
1830BOOL _ILGetFileDate (LPCITEMIDLIST pidl, LPSTR pOut, UINT uOutSize)
1831{
1832 FILETIME ft,lft;
1833 SYSTEMTIME time;
1834
1835 if (! _ILGetFileDateTime( pidl, &ft )) return FALSE;
1836
1837 FileTimeToLocalFileTime(&ft, &lft);
1838 FileTimeToSystemTime (&lft, &time);
1839 return GetDateFormatA(LOCALE_USER_DEFAULT,DATE_SHORTDATE,&time, NULL, pOut, uOutSize);
1840}
1841
1842/*************************************************************************
1843 * _ILGetFileSize
1844 *
1845 * Given the ItemIdList, get the FileSize
1846 *
1847 * PARAMS
1848 * pidl [I] The ItemIDList
1849 * pOut [I] The buffer to save the result
1850 * uOutsize [I] The size of the buffer
1851 *
1852 * RETURNS
1853 * The FileSize
1854 *
1855 * NOTES
1856 * pOut can be null when no string is needed
1857 *
1858 */
1859DWORD _ILGetFileSize (LPCITEMIDLIST pidl, LPSTR pOut, UINT uOutSize)
1860{
1861 LPPIDLDATA pdata =_ILGetDataPointer(pidl);
1862 DWORD dwSize;
1863
1864 if(! pdata) return 0;
1865
1866 switch (pdata->type)
1867 {
1868 case PT_VALUE:
1869 dwSize = pdata->u.file.dwFileSize;
1870 if (pOut) StrFormatByteSizeA(dwSize, pOut, uOutSize);
1871 return dwSize;
1872 }
1873 if (pOut) *pOut = 0x00;
1874 return 0;
1875}
1876
1877BOOL _ILGetExtension (LPCITEMIDLIST pidl, LPSTR pOut, UINT uOutSize)
1878{
1879 char szTemp[MAX_PATH];
1880 const char * pPoint;
1881 LPITEMIDLIST pidlTemp=pidl;
1882
1883 TRACE("pidl=%p\n",pidl);
1884
1885 if (!pidl) return FALSE;
1886
1887 pidlTemp = ILFindLastID(pidl);
1888
1889 if (!_ILIsValue(pidlTemp)) return FALSE;
1890 if (!_ILSimpleGetText(pidlTemp, szTemp, MAX_PATH)) return FALSE;
1891
1892 pPoint = PathFindExtensionA(szTemp);
1893
1894 if (! *pPoint) return FALSE;
1895
1896 pPoint++;
1897 lstrcpynA(pOut, pPoint, uOutSize);
1898 TRACE("%s\n",pOut);
1899
1900 return TRUE;
1901}
1902
1903/*************************************************************************
1904 * _ILGetFileType
1905 *
1906 * Given the ItemIdList, get the file type description
1907 *
1908 * PARAMS
1909 * pidl [I] The ItemIDList (simple)
1910 * pOut [I] The buffer to save the result
1911 * uOutsize [I] The size of the buffer
1912 *
1913 * RETURNS
1914 * nothing
1915 *
1916 * NOTES
1917 * This function copies as much as possible into the buffer.
1918 */
1919void _ILGetFileType(LPCITEMIDLIST pidl, LPSTR pOut, UINT uOutSize)
1920{
1921 if(_ILIsValue(pidl))
1922 {
1923 char sTemp[64];
1924 if(uOutSize > 0)
1925 {
1926 pOut[0] = 0;
1927 }
1928 if (_ILGetExtension (pidl, sTemp, 64))
1929 {
1930 if (!( HCR_MapTypeToValue(sTemp, sTemp, 64, TRUE)
1931 && HCR_MapTypeToValue(sTemp, pOut, uOutSize, FALSE )))
1932 {
1933 lstrcpynA (pOut, sTemp, uOutSize - 6);
1934 strcat (pOut, "-file");
1935 }
1936 }
1937 }
1938 else
1939 {
1940 lstrcpynA(pOut, "Folder", uOutSize);
1941 }
1942}
1943
1944/*************************************************************************
1945 * _ILGetFileAttributes
1946 *
1947 * Given the ItemIdList, get the Attrib string format
1948 *
1949 * PARAMS
1950 * pidl [I] The ItemIDList
1951 * pOut [I] The buffer to save the result
1952 * uOutsize [I] The size of the Buffer
1953 *
1954 * RETURNS
1955 * Attributes
1956 *
1957 * FIXME
1958 * return value 0 in case of error is a valid return value
1959 *
1960 */
1961DWORD _ILGetFileAttributes(LPCITEMIDLIST pidl, LPSTR pOut, UINT uOutSize)
1962{
1963 LPPIDLDATA pData =_ILGetDataPointer(pidl);
1964 WORD wAttrib = 0;
1965 int i;
1966
1967 if(! pData) return 0;
1968
1969 switch(pData->type)
1970 {
1971 case PT_FOLDER:
1972 wAttrib = pData->u.folder.uFileAttribs;
1973 break;
1974 case PT_VALUE:
1975 wAttrib = pData->u.file.uFileAttribs;
1976 break;
1977 }
1978
1979 if(uOutSize >= 6)
1980 {
1981 i=0;
1982 if(wAttrib & FILE_ATTRIBUTE_READONLY)
1983 {
1984 pOut[i++] = 'R';
1985 }
1986 if(wAttrib & FILE_ATTRIBUTE_HIDDEN)
1987 {
1988 pOut[i++] = 'H';
1989 }
1990 if(wAttrib & FILE_ATTRIBUTE_SYSTEM)
1991 {
1992 pOut[i++] = 'S';
1993 }
1994 if(wAttrib & FILE_ATTRIBUTE_ARCHIVE)
1995 {
1996 pOut[i++] = 'A';
1997 }
1998 if(wAttrib & FILE_ATTRIBUTE_COMPRESSED)
1999 {
2000 pOut[i++] = 'C';
2001 }
2002 pOut[i] = 0x00;
2003 }
2004 return wAttrib;
2005}
2006
2007/*************************************************************************
2008* ILFreeaPidl
2009*
2010* free a aPidl struct
2011*/
2012void _ILFreeaPidl(LPITEMIDLIST * apidl, UINT cidl)
2013{
2014 int i;
2015
2016 if(apidl)
2017 {
2018 for(i = 0; i < cidl; i++) SHFree(apidl[i]);
2019 SHFree(apidl);
2020 }
2021}
2022
2023/*************************************************************************
2024* ILCopyaPidl
2025*
2026* copys a aPidl struct
2027*/
2028LPITEMIDLIST * _ILCopyaPidl(LPITEMIDLIST * apidlsrc, UINT cidl)
2029{
2030 int i;
2031 LPITEMIDLIST * apidldest = (LPITEMIDLIST*)SHAlloc(cidl * sizeof(LPITEMIDLIST));
2032 if(!apidlsrc) return NULL;
2033
2034 for(i = 0; i < cidl; i++)
2035 apidldest[i] = ILClone(apidlsrc[i]);
2036
2037 return apidldest;
2038}
2039
2040/*************************************************************************
2041* _ILCopyCidaToaPidl
2042*
2043* creates aPidl from CIDA
2044*/
2045LPITEMIDLIST * _ILCopyCidaToaPidl(LPITEMIDLIST* pidl, LPCIDA cida)
2046{
2047 int i;
2048 LPITEMIDLIST * dst = (LPITEMIDLIST*)SHAlloc(cida->cidl * sizeof(LPITEMIDLIST));
2049
2050 if(!dst) return NULL;
2051
2052 if (pidl)
2053 *pidl = ILClone((LPITEMIDLIST)(&((LPBYTE)cida)[cida->aoffset[0]]));
2054
2055 for(i = 0; i < cida->cidl; i++)
2056 dst[i] = ILClone((LPITEMIDLIST)(&((LPBYTE)cida)[cida->aoffset[i + 1]]));
2057
2058 return dst;
2059}
Note: See TracBrowser for help on using the repository browser.