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

Last change on this file since 5120 was 4125, checked in by sandervl, 25 years ago

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