4 * Copyright 1998 Juergen Schmied
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, write to the Free Software
18 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
21 * a pidl == NULL means desktop and is legal
26 #include "wine/port.h"
36 #include "undocshell.h"
37 #include "shell32_main.h"
43 #include "wine/debug.h"
45 WINE_DEFAULT_DEBUG_CHANNEL(pidl);
46 WINE_DECLARE_DEBUG_CHANNEL(shell);
48 /* from comctl32.dll */
49 extern LPVOID WINAPI Alloc(INT);
50 extern BOOL WINAPI Free(LPVOID);
52 /*************************************************************************
53 * ILGetDisplayName [SHELL32.15]
55 BOOL WINAPI ILGetDisplayName(LPCITEMIDLIST pidl,LPSTR path)
57 TRACE_(shell)("pidl=%p %p semi-stub\n",pidl,path);
58 return SHGetPathFromIDListA(pidl, path);
60 /*************************************************************************
61 * ILFindLastID [SHELL32.16]
64 * observed: pidl=Desktop return=pidl
66 LPITEMIDLIST WINAPI ILFindLastID(LPITEMIDLIST pidl)
67 { LPITEMIDLIST pidlLast = pidl;
69 TRACE("(pidl=%p)\n",pidl);
74 pidl = ILGetNext(pidl);
78 /*************************************************************************
79 * ILRemoveLastID [SHELL32.17]
82 * when pidl=Desktop return=FALSE
84 BOOL WINAPI ILRemoveLastID(LPCITEMIDLIST pidl)
86 TRACE_(shell)("pidl=%p\n",pidl);
88 if (!pidl || !pidl->mkid.cb)
90 ILFindLastID(pidl)->mkid.cb = 0;
94 /*************************************************************************
95 * ILClone [SHELL32.18]
100 LPITEMIDLIST WINAPI ILClone (LPCITEMIDLIST pidl)
102 LPITEMIDLIST newpidl;
107 len = ILGetSize(pidl);
108 newpidl = (LPITEMIDLIST)SHAlloc(len);
110 memcpy(newpidl,pidl,len);
112 TRACE("pidl=%p newpidl=%p\n",pidl, newpidl);
117 /*************************************************************************
118 * ILCloneFirst [SHELL32.19]
121 * duplicates the first idlist of a complex pidl
123 LPITEMIDLIST WINAPI ILCloneFirst(LPCITEMIDLIST pidl)
125 LPITEMIDLIST pidlNew = NULL;
127 TRACE("pidl=%p \n",pidl);
133 pidlNew = (LPITEMIDLIST) SHAlloc (len+2);
136 memcpy(pidlNew,pidl,len+2); /* 2 -> mind a desktop pidl */
139 ILGetNext(pidlNew)->mkid.cb = 0x00;
142 TRACE("-- newpidl=%p\n",pidlNew);
147 /*************************************************************************
148 * ILLoadFromStream (SHELL32.26)
151 * the first two bytes are the len, the pidl is following then
153 HRESULT WINAPI ILLoadFromStream (IStream * pStream, LPITEMIDLIST * ppPidl)
156 HRESULT ret = E_FAIL;
159 TRACE_(shell)("%p %p\n", pStream , ppPidl);
166 IStream_AddRef (pStream);
168 if (SUCCEEDED(IStream_Read(pStream, (LPVOID)&wLen, 2, &dwBytesRead)))
169 { *ppPidl = SHAlloc (wLen);
170 if (SUCCEEDED(IStream_Read(pStream, *ppPidl , wLen, &dwBytesRead)))
179 /* we are not yet fully compatible */
180 if (!pcheck(*ppPidl))
186 IStream_Release (pStream);
191 /*************************************************************************
192 * ILSaveToStream (SHELL32.27)
195 * the first two bytes are the len, the pidl is following then
197 HRESULT WINAPI ILSaveToStream (IStream * pStream, LPCITEMIDLIST pPidl)
201 HRESULT ret = E_FAIL;
203 TRACE_(shell)("%p %p\n", pStream, pPidl);
205 IStream_AddRef (pStream);
208 while (pidl->mkid.cb)
210 wLen += sizeof(WORD) + pidl->mkid.cb;
211 pidl = ILGetNext(pidl);
214 if (SUCCEEDED(IStream_Write(pStream, (LPVOID)&wLen, 2, NULL)))
216 if (SUCCEEDED(IStream_Write(pStream, pPidl, wLen, NULL)))
222 IStream_Release (pStream);
227 /*************************************************************************
228 * SHILCreateFromPath [SHELL32.28]
231 * wraper for IShellFolder::ParseDisplayName()
233 HRESULT WINAPI SHILCreateFromPathA (LPCSTR path, LPITEMIDLIST * ppidl, DWORD * attributes)
235 WCHAR lpszDisplayName[MAX_PATH];
237 HRESULT ret = E_FAIL;
239 TRACE_(shell)("%s %p 0x%08lx\n",path,ppidl,attributes?*attributes:0);
241 if (!MultiByteToWideChar( CP_ACP, 0, path, -1, lpszDisplayName, MAX_PATH ))
242 lpszDisplayName[MAX_PATH-1] = 0;
244 if (SUCCEEDED (SHGetDesktopFolder(&sf)))
246 ret = IShellFolder_ParseDisplayName(sf,0, NULL,lpszDisplayName,&pchEaten,ppidl,attributes);
247 IShellFolder_Release(sf);
251 HRESULT WINAPI SHILCreateFromPathW (LPCWSTR path, LPITEMIDLIST * ppidl, DWORD * attributes)
254 HRESULT ret = E_FAIL;
256 TRACE_(shell)("%s %p 0x%08lx\n",debugstr_w(path),ppidl,attributes?*attributes:0);
258 if (SUCCEEDED (SHGetDesktopFolder(&sf)))
260 ret = IShellFolder_ParseDisplayName(sf,0, NULL, (LPWSTR) path, &pchEaten, ppidl, attributes);
261 IShellFolder_Release(sf);
265 HRESULT WINAPI SHILCreateFromPathAW (LPCVOID path, LPITEMIDLIST * ppidl, DWORD * attributes)
267 if ( SHELL_OsIsUnicode())
268 return SHILCreateFromPathW (path, ppidl, attributes);
269 return SHILCreateFromPathA (path, ppidl, attributes);
272 /*************************************************************************
273 * SHCloneSpecialIDList [SHELL32.89]
277 * nFolder [in] CSIDL_xxxxx ??
282 * exported by ordinal
284 LPITEMIDLIST WINAPI SHCloneSpecialIDList(HWND hwndOwner,DWORD nFolder,DWORD x3)
285 { LPITEMIDLIST ppidl;
286 WARN_(shell)("(hwnd=0x%x,csidl=0x%lx,0x%lx):semi-stub.\n",
287 hwndOwner,nFolder,x3);
289 SHGetSpecialFolderLocation(hwndOwner, nFolder, &ppidl);
294 /*************************************************************************
295 * ILGlobalClone [SHELL32.20]
298 LPITEMIDLIST WINAPI ILGlobalClone(LPCITEMIDLIST pidl)
300 LPITEMIDLIST newpidl;
305 len = ILGetSize(pidl);
306 newpidl = (LPITEMIDLIST)Alloc(len);
308 memcpy(newpidl,pidl,len);
310 TRACE("pidl=%p newpidl=%p\n",pidl, newpidl);
316 /*************************************************************************
317 * ILIsEqual [SHELL32.21]
320 BOOL WINAPI ILIsEqual(LPCITEMIDLIST pidl1, LPCITEMIDLIST pidl2)
322 char szData1[MAX_PATH];
323 char szData2[MAX_PATH];
325 LPITEMIDLIST pidltemp1 = pidl1;
326 LPITEMIDLIST pidltemp2 = pidl2;
328 TRACE("pidl1=%p pidl2=%p\n",pidl1, pidl2);
330 /* explorer reads from registry directly (StreamMRU),
331 so we can only check here */
332 if ((!pcheck (pidl1)) || (!pcheck (pidl2))) return FALSE;
337 if ( (!pidl1) || (!pidl2) ) return FALSE;
339 while (pidltemp1->mkid.cb && pidltemp2->mkid.cb)
341 _ILSimpleGetText(pidltemp1, szData1, MAX_PATH);
342 _ILSimpleGetText(pidltemp2, szData2, MAX_PATH);
344 if (strcasecmp ( szData1, szData2 )!=0 )
347 pidltemp1 = ILGetNext(pidltemp1);
348 pidltemp2 = ILGetNext(pidltemp2);
351 if (!pidltemp1->mkid.cb && !pidltemp2->mkid.cb)
358 /*************************************************************************
359 * ILIsParent [SHELL32.23]
361 * parent=a/b child=a/b/c -> true, c is in folder a/b
362 * child=a/b/c/d -> false if bImmediate is true, d is not in folder a/b
363 * child=a/b/c/d -> true if bImmediate is false, d is in a subfolder of a/b
365 BOOL WINAPI ILIsParent( LPCITEMIDLIST pidlParent, LPCITEMIDLIST pidlChild, BOOL bImmediate)
367 char szData1[MAX_PATH];
368 char szData2[MAX_PATH];
370 LPITEMIDLIST pParent = pidlParent;
371 LPITEMIDLIST pChild = pidlChild;
373 TRACE("%p %p %x\n", pidlParent, pidlChild, bImmediate);
375 while (pParent->mkid.cb && pChild->mkid.cb)
377 _ILSimpleGetText(pParent, szData1, MAX_PATH);
378 _ILSimpleGetText(pChild, szData2, MAX_PATH);
380 if (strcasecmp ( szData1, szData2 )!=0 )
383 pParent = ILGetNext(pParent);
384 pChild = ILGetNext(pChild);
387 if ( pParent->mkid.cb || ! pChild->mkid.cb) /* child shorter or has equal length to parent */
390 if ( ILGetNext(pChild)->mkid.cb && bImmediate) /* not immediate descent */
396 /*************************************************************************
397 * ILFindChild [SHELL32.24]
400 * Compares elements from pidl1 and pidl2.
402 * pidl1 is desktop pidl2
403 * pidl1 shorter pidl2 pointer to first different element of pidl2
404 * if there was at least one equal element
405 * pidl2 shorter pidl1 0
406 * pidl2 equal pidl1 pointer to last 0x00-element of pidl2
408 LPITEMIDLIST WINAPI ILFindChild(LPCITEMIDLIST pidl1,LPCITEMIDLIST pidl2)
410 char szData1[MAX_PATH];
411 char szData2[MAX_PATH];
413 LPITEMIDLIST pidltemp1 = pidl1;
414 LPITEMIDLIST pidltemp2 = pidl2;
415 LPITEMIDLIST ret=NULL;
417 TRACE("pidl1=%p pidl2=%p\n",pidl1, pidl2);
419 /* explorer reads from registry directly (StreamMRU),
420 so we can only check here */
421 if ((!pcheck (pidl1)) || (!pcheck (pidl2)))
427 if ( _ILIsDesktop(pidl1) )
433 while (pidltemp1->mkid.cb && pidltemp2->mkid.cb)
435 _ILSimpleGetText(pidltemp1, szData1, MAX_PATH);
436 _ILSimpleGetText(pidltemp2, szData2, MAX_PATH);
438 if (strcasecmp(szData1,szData2))
441 pidltemp1 = ILGetNext(pidltemp1);
442 pidltemp2 = ILGetNext(pidltemp2);
446 if (pidltemp1->mkid.cb)
448 ret = NULL; /* elements of pidl1 left*/
451 TRACE_(shell)("--- %p\n", ret);
452 return ret; /* pidl 1 is shorter */
455 /*************************************************************************
456 * ILCombine [SHELL32.25]
459 * Concatenates two complex idlists.
460 * The pidl is the first one, pidlsub the next one
461 * Does not destroy the passed in idlists!
463 LPITEMIDLIST WINAPI ILCombine(LPCITEMIDLIST pidl1,LPCITEMIDLIST pidl2)
466 LPITEMIDLIST pidlNew;
468 TRACE("pidl=%p pidl=%p\n",pidl1,pidl2);
470 if(!pidl1 && !pidl2) return NULL;
477 pidlNew = ILClone(pidl2);
483 pidlNew = ILClone(pidl1);
487 len1 = ILGetSize(pidl1)-2;
488 len2 = ILGetSize(pidl2);
489 pidlNew = SHAlloc(len1+len2);
493 memcpy(pidlNew,pidl1,len1);
494 memcpy(((BYTE *)pidlNew)+len1,pidl2,len2);
497 /* TRACE(pidl,"--new pidl=%p\n",pidlNew);*/
500 /*************************************************************************
501 * SHGetRealIDL [SHELL32.98]
505 LPITEMIDLIST WINAPI SHGetRealIDL(LPSHELLFOLDER lpsf, LPITEMIDLIST pidl, DWORD z)
507 FIXME("sf=%p pidl=%p 0x%04lx\n",lpsf,pidl,z);
513 /*************************************************************************
514 * SHLogILFromFSIL [SHELL32.95]
517 * pild = CSIDL_DESKTOP ret = 0
518 * pild = CSIDL_DRIVES ret = 0
520 LPITEMIDLIST WINAPI SHLogILFromFSIL(LPITEMIDLIST pidl)
522 FIXME("(pidl=%p)\n",pidl);
529 /*************************************************************************
530 * ILGetSize [SHELL32.152]
531 * gets the byte size of an idlist including zero terminator (pidl)
540 * exported by ordinal
542 DWORD WINAPI ILGetSize(LPITEMIDLIST pidl)
544 LPSHITEMID si = &(pidl->mkid);
550 si = (LPSHITEMID)(((LPBYTE)si)+si->cb);
554 TRACE("pidl=%p size=%lu\n",pidl, len);
558 /*************************************************************************
559 * ILGetNext [SHELL32.153]
560 * gets the next simple pidl of a complex pidl
562 * observed return values:
565 * simple pidl -> pointer to 0x0000 element
568 LPITEMIDLIST WINAPI ILGetNext(LPITEMIDLIST pidl)
579 pidl = (LPITEMIDLIST) (((LPBYTE)pidl)+len);
580 TRACE("-- %p\n", pidl);
586 /*************************************************************************
587 * ILAppend [SHELL32.154]
590 * Adds the single item to the idlist indicated by pidl.
591 * if bEnd is 0, adds the item to the front of the list,
592 * otherwise adds the item to the end. (???)
593 * Destroys the passed in idlist! (???)
595 LPITEMIDLIST WINAPI ILAppend(LPITEMIDLIST pidl,LPCITEMIDLIST item,BOOL bEnd)
599 WARN("(pidl=%p,pidl=%p,%08u)semi-stub\n",pidl,item,bEnd);
604 if (_ILIsDesktop(pidl))
606 idlRet = ILClone(item);
614 idlRet=ILCombine(pidl,item);
618 idlRet=ILCombine(item,pidl);
624 /*************************************************************************
625 * ILFree [SHELL32.155]
628 * free_check_ptr - frees memory (if not NULL)
629 * allocated by SHMalloc allocator
630 * exported by ordinal
632 DWORD WINAPI ILFree(LPITEMIDLIST pidl)
634 TRACE("(pidl=0x%08lx)\n",(DWORD)pidl);
636 if(!pidl) return FALSE;
640 /*************************************************************************
641 * ILGlobalFree [SHELL32.156]
644 void WINAPI ILGlobalFree( LPCITEMIDLIST pidl)
651 /*************************************************************************
652 * ILCreateFromPath [SHELL32.157]
655 LPITEMIDLIST WINAPI ILCreateFromPathA (LPCSTR path)
657 LPITEMIDLIST pidlnew;
658 DWORD attributes = 0;
660 TRACE_(shell)("%s\n",path);
662 if (SUCCEEDED (SHILCreateFromPathA (path, &pidlnew, &attributes)))
666 LPITEMIDLIST WINAPI ILCreateFromPathW (LPCWSTR path)
668 LPITEMIDLIST pidlnew;
669 DWORD attributes = 0;
671 TRACE_(shell)("%s\n",debugstr_w(path));
673 if (SUCCEEDED (SHILCreateFromPathW (path, &pidlnew, &attributes)))
677 LPITEMIDLIST WINAPI ILCreateFromPathAW (LPCVOID path)
679 if ( SHELL_OsIsUnicode())
680 return ILCreateFromPathW (path);
681 return ILCreateFromPathA (path);
683 /*************************************************************************
684 * SHSimpleIDListFromPath [SHELL32.162]
686 LPITEMIDLIST WINAPI SHSimpleIDListFromPathA (LPCSTR lpszPath)
688 LPITEMIDLIST pidl=NULL;
690 WIN32_FIND_DATAA stffile;
692 TRACE("path=%s\n", lpszPath);
694 if (!lpszPath) return NULL;
696 hFile = FindFirstFileA(lpszPath, &stffile);
698 if ( hFile != INVALID_HANDLE_VALUE )
700 if (stffile.dwFileAttributes & FILE_ATTRIBUTE_DIRECTORY)
702 pidl = _ILCreateFolder (&stffile);
706 pidl = _ILCreateValue (&stffile);
712 LPITEMIDLIST WINAPI SHSimpleIDListFromPathW (LPCWSTR lpszPath)
714 char lpszTemp[MAX_PATH];
715 TRACE("path=%s\n",debugstr_w(lpszPath));
717 if (!WideCharToMultiByte( CP_ACP, 0, lpszPath, -1, lpszTemp, sizeof(lpszTemp), NULL, NULL ))
718 lpszTemp[sizeof(lpszTemp)-1] = 0;
720 return SHSimpleIDListFromPathA (lpszTemp);
723 LPITEMIDLIST WINAPI SHSimpleIDListFromPathAW (LPCVOID lpszPath)
725 if ( SHELL_OsIsUnicode())
726 return SHSimpleIDListFromPathW (lpszPath);
727 return SHSimpleIDListFromPathA (lpszPath);
730 /*************************************************************************
731 * SHGetSpecialFolderLocation [SHELL32.@]
733 * gets the folder locations from the registry and creates a pidl
734 * creates missing reg keys and directories
738 * nFolder [I] CSIDL_xxxxx
739 * ppidl [O] PIDL of a special folder
742 HRESULT WINAPI SHGetSpecialFolderLocation(
745 LPITEMIDLIST * ppidl)
747 CHAR szPath[MAX_PATH];
748 HRESULT hr = E_INVALIDARG;
750 TRACE_(shell)("(%04x,0x%x,%p)\n", hwndOwner,nFolder,ppidl);
758 *ppidl = _ILCreateDesktop();
762 *ppidl = _ILCreateMyComputer();
766 *ppidl = _ILCreateNetwork ();
770 *ppidl = _ILCreateControl ();
774 *ppidl = _ILCreatePrinter ();
777 case CSIDL_BITBUCKET:
778 *ppidl = _ILCreateBitBucket ();
782 if (SHGetSpecialFolderPathA(hwndOwner, szPath, nFolder, TRUE))
785 TRACE_(shell)("Value=%s\n",szPath);
786 hr = SHILCreateFromPathA(szPath, ppidl, &attributes);
789 if(*ppidl) hr = NOERROR;
792 TRACE_(shell)("-- (new pidl %p)\n",*ppidl);
796 /*************************************************************************
797 * SHGetFolderLocation [SHELL32.@]
800 * the pidl can be a simple one. since we cant get the path out of the pidl
801 * we have to take all data from the pidl
803 HRESULT WINAPI SHGetFolderLocation(
810 FIXME("0x%04x 0x%08x 0x%08x 0x%08lx %p\n",
811 hwnd, csidl, hToken, dwFlags, ppidl);
812 return SHGetSpecialFolderLocation(hwnd, csidl, ppidl);
815 /*************************************************************************
816 * SHGetDataFromIDListA [SHELL32.247]
819 * the pidl can be a simple one. since we cant get the path out of the pidl
820 * we have to take all data from the pidl
822 HRESULT WINAPI SHGetDataFromIDListA(LPSHELLFOLDER psf, LPCITEMIDLIST pidl, int nFormat, LPVOID dest, int len)
824 TRACE_(shell)("sf=%p pidl=%p 0x%04x %p 0x%04x stub\n",psf,pidl,nFormat,dest,len);
827 if (!psf || !dest ) return E_INVALIDARG;
831 case SHGDFIL_FINDDATA:
833 WIN32_FIND_DATAA * pfd = dest;
835 if ( len < sizeof (WIN32_FIND_DATAA)) return E_INVALIDARG;
837 ZeroMemory(pfd, sizeof (WIN32_FIND_DATAA));
838 _ILGetFileDateTime( pidl, &(pfd->ftLastWriteTime));
839 pfd->dwFileAttributes = _ILGetFileAttributes(pidl, NULL, 0);
840 pfd->nFileSizeLow = _ILGetFileSize ( pidl, NULL, 0);
841 lstrcpynA(pfd->cFileName,_ILGetTextPointer(pidl), MAX_PATH);
842 lstrcpynA(pfd->cAlternateFileName,_ILGetSTextPointer(pidl), 14);
846 case SHGDFIL_NETRESOURCE:
847 case SHGDFIL_DESCRIPTIONID:
848 FIXME_(shell)("SHGDFIL %i stub\n", nFormat);
852 ERR_(shell)("Unknown SHGDFIL %i, please report\n", nFormat);
857 /*************************************************************************
858 * SHGetDataFromIDListW [SHELL32.248]
861 HRESULT WINAPI SHGetDataFromIDListW(LPSHELLFOLDER psf, LPCITEMIDLIST pidl, int nFormat, LPVOID dest, int len)
863 TRACE_(shell)("sf=%p pidl=%p 0x%04x %p 0x%04x stub\n",psf,pidl,nFormat,dest,len);
867 if (! psf || !dest ) return E_INVALIDARG;
871 case SHGDFIL_FINDDATA:
873 WIN32_FIND_DATAW * pfd = dest;
875 if ( len < sizeof (WIN32_FIND_DATAW)) return E_INVALIDARG;
877 ZeroMemory(pfd, sizeof (WIN32_FIND_DATAA));
878 _ILGetFileDateTime( pidl, &(pfd->ftLastWriteTime));
879 pfd->dwFileAttributes = _ILGetFileAttributes(pidl, NULL, 0);
880 pfd->nFileSizeLow = _ILGetFileSize ( pidl, NULL, 0);
881 if (!MultiByteToWideChar( CP_ACP, 0, _ILGetTextPointer(pidl), -1,
882 pfd->cFileName, MAX_PATH ))
883 pfd->cFileName[MAX_PATH-1] = 0;
884 if (!MultiByteToWideChar( CP_ACP, 0, _ILGetSTextPointer(pidl), -1,
885 pfd->cAlternateFileName, 14 ))
886 pfd->cFileName[13] = 0;
889 case SHGDFIL_NETRESOURCE:
890 case SHGDFIL_DESCRIPTIONID:
891 FIXME_(shell)("SHGDFIL %i stub\n", nFormat);
895 ERR_(shell)("Unknown SHGDFIL %i, please report\n", nFormat);
901 /*************************************************************************
902 * SHGetPathFromIDListA [SHELL32.@][NT 4.0: SHELL32.220]
909 * path from a passed PIDL.
913 * desktop pidl gives path to desktopdirectory back
914 * special pidls returning FALSE
917 * fnGetDisplayNameOf can return different types of OLEString
919 BOOL WINAPI SHGetPathFromIDListA (LPCITEMIDLIST pidl, LPSTR pszPath)
923 LPSHELLFOLDER shellfolder;
925 TRACE_(shell)("(pidl=%p,%p)\n",pidl,pszPath);
928 if (!pidl) return FALSE;
930 hr = SHGetDesktopFolder(&shellfolder);
931 if (SUCCEEDED (hr)) {
932 hr = IShellFolder_GetDisplayNameOf(shellfolder,pidl,SHGDN_FORPARSING,&str);
934 StrRetToStrNA (pszPath, MAX_PATH, &str, pidl);
936 IShellFolder_Release(shellfolder);
939 TRACE_(shell)("-- %s, 0x%08lx\n",pszPath, hr);
940 return SUCCEEDED(hr);
942 /*************************************************************************
943 * SHGetPathFromIDListW [SHELL32.@]
945 BOOL WINAPI SHGetPathFromIDListW (LPCITEMIDLIST pidl,LPWSTR pszPath)
946 { char sTemp[MAX_PATH];
948 TRACE_(shell)("(pidl=%p)\n", pidl);
950 SHGetPathFromIDListA (pidl, sTemp);
951 MultiByteToWideChar( CP_ACP, 0, sTemp, -1, pszPath, MAX_PATH );
953 TRACE_(shell)("-- (%s)\n",debugstr_w(pszPath));
958 /*************************************************************************
959 * SHBindToParent [shell version 5.0]
961 HRESULT WINAPI SHBindToParent(LPCITEMIDLIST pidl, REFIID riid, LPVOID *ppv, LPCITEMIDLIST *ppidlLast)
964 LPITEMIDLIST pidlChild, pidlParent;
967 TRACE_(shell)("pidl=%p\n", pidl);
971 if (ppidlLast) *ppidlLast = NULL;
973 if (_ILIsPidlSimple(pidl))
975 /* we are on desktop level */
977 *ppidlLast = ILClone(pidl);
978 hr = SHGetDesktopFolder((IShellFolder**)ppv);
982 pidlChild = ILClone(ILFindLastID(pidl));
983 pidlParent = ILClone(pidl);
984 ILRemoveLastID(pidlParent);
986 hr = SHGetDesktopFolder(&psf);
989 hr = IShellFolder_BindToObject(psf, pidlParent, NULL, riid, ppv);
991 if (SUCCEEDED(hr) && ppidlLast)
992 *ppidlLast = pidlChild;
997 if (psf) IShellFolder_Release(psf);
1001 TRACE_(shell)("-- psf=%p pidl=%p ret=0x%08lx\n", *ppv, (ppidlLast)?*ppidlLast:NULL, hr);
1005 /*************************************************************************
1006 * SHGetPathFromIDList [SHELL32.@][NT 4.0: SHELL32.219]
1008 BOOL WINAPI SHGetPathFromIDListAW(LPCITEMIDLIST pidl,LPVOID pszPath)
1010 TRACE_(shell)("(pidl=%p,%p)\n",pidl,pszPath);
1012 if (SHELL_OsIsUnicode())
1013 return SHGetPathFromIDListW(pidl,pszPath);
1014 return SHGetPathFromIDListA(pidl,pszPath);
1017 /**************************************************************************
1019 * internal functions
1021 * ### 1. section creating pidls ###
1023 *************************************************************************
1024 * _ILCreateDesktop()
1025 * _ILCreateIExplore()
1026 * _ILCreateMyComputer()
1031 LPITEMIDLIST _ILCreateDesktop()
1033 return _ILCreate(PT_DESKTOP, NULL, 0);
1036 LPITEMIDLIST _ILCreateMyComputer()
1038 return _ILCreate(PT_MYCOMP, &CLSID_MyComputer, sizeof(GUID));
1041 LPITEMIDLIST _ILCreateIExplore()
1043 return _ILCreate(PT_MYCOMP, &CLSID_Internet, sizeof(GUID));
1046 LPITEMIDLIST _ILCreateControl()
1048 return _ILCreate(PT_SPECIAL, &CLSID_ControlPanel, sizeof(GUID));
1051 LPITEMIDLIST _ILCreatePrinter()
1053 return _ILCreate(PT_SPECIAL, &CLSID_Printers, sizeof(GUID));
1056 LPITEMIDLIST _ILCreateNetwork()
1058 return _ILCreate(PT_MYCOMP, &CLSID_NetworkPlaces, sizeof(GUID));
1061 LPITEMIDLIST _ILCreateBitBucket()
1063 return _ILCreate(PT_MYCOMP, &CLSID_RecycleBin, sizeof(GUID));
1066 LPITEMIDLIST _ILCreateDrive( LPCSTR lpszNew)
1068 lstrcpynA (sTemp,lpszNew,4);
1071 TRACE("(%s)\n",sTemp);
1072 return _ILCreate(PT_DRIVE,(LPVOID)&sTemp[0],4);
1075 LPITEMIDLIST _ILCreateFolder( WIN32_FIND_DATAA * stffile )
1077 char buff[MAX_PATH + 14 +1]; /* see WIN32_FIND_DATA */
1078 char * pbuff = buff;
1082 TRACE("(%s, %s)\n",stffile->cAlternateFileName, stffile->cFileName);
1084 /* prepare buffer with both names */
1085 len = strlen (stffile->cFileName) + 1;
1086 memcpy (pbuff, stffile->cFileName, len);
1089 if (stffile->cAlternateFileName)
1091 len1 = strlen (stffile->cAlternateFileName)+1;
1092 memcpy (pbuff, stffile->cAlternateFileName, len1);
1100 pidl = _ILCreate(PT_FOLDER, (LPVOID)buff, len + len1);
1102 /* set attributes */
1106 pData = _ILGetDataPointer(pidl);
1107 FileTimeToDosDateTime(&(stffile->ftLastWriteTime),&pData->u.folder.uFileDate,&pData->u.folder.uFileTime);
1108 pData->u.folder.dwFileSize = stffile->nFileSizeLow;
1109 pData->u.folder.uFileAttribs=stffile->dwFileAttributes;
1115 LPITEMIDLIST _ILCreateValue(WIN32_FIND_DATAA * stffile)
1117 char buff[MAX_PATH + 14 +1]; /* see WIN32_FIND_DATA */
1118 char * pbuff = buff;
1122 TRACE("(%s, %s)\n",stffile->cAlternateFileName, stffile->cFileName);
1124 /* prepare buffer with both names */
1125 len = strlen (stffile->cFileName) + 1;
1126 memcpy (pbuff, stffile->cFileName, len);
1129 if (stffile->cAlternateFileName)
1131 len1 = strlen (stffile->cAlternateFileName)+1;
1132 memcpy (pbuff, stffile->cAlternateFileName, len1);
1140 pidl = _ILCreate(PT_VALUE, (LPVOID)buff, len + len1);
1142 /* set attributes */
1146 pData = _ILGetDataPointer(pidl);
1147 FileTimeToDosDateTime(&(stffile->ftLastWriteTime),&pData->u.folder.uFileDate,&pData->u.folder.uFileTime);
1148 pData->u.folder.dwFileSize = stffile->nFileSizeLow;
1149 pData->u.folder.uFileAttribs=stffile->dwFileAttributes;
1155 LPITEMIDLIST _ILCreateSpecial(LPCSTR szGUID)
1160 if (!MultiByteToWideChar( CP_ACP, 0, szGUID, -1, buffer, sizeof(buffer)/sizeof(WCHAR) ))
1163 if (! SUCCEEDED (CLSIDFromString( buffer, &iid ))) {
1164 ERR("%s is not a GUID\n", szGUID);
1167 return _ILCreate(PT_MYCOMP, &iid, sizeof(IID));
1170 /**************************************************************************
1172 * Creates a new PIDL
1173 * type = PT_DESKTOP | PT_DRIVE | PT_FOLDER | PT_VALUE
1175 * uInSize = size of data (raw)
1178 LPITEMIDLIST _ILCreate(PIDLTYPE type, LPCVOID pIn, UINT uInSize)
1180 LPITEMIDLIST pidlOut = NULL, pidlTemp = NULL;
1185 TRACE("(0x%02x %p %i)\n",type,pIn,uInSize);
1194 uSize = 2 + 2 + sizeof(GUID);
1201 uSize = 2 + 12 + uInSize;
1204 FIXME("can't create type: 0x%08x\n",type);
1208 if(!(pidlOut = SHAlloc(uSize + 2))) return NULL;
1209 ZeroMemory(pidlOut, uSize + 2);
1210 pidlOut->mkid.cb = uSize;
1215 TRACE("- create Desktop\n");
1220 pData =_ILGetDataPointer(pidlOut);
1222 memcpy(&(pData->u.mycomp.guid), pIn, uInSize);
1223 TRACE("-- create GUID-pidl %s\n", debugstr_guid(&(pData->u.mycomp.guid)));
1227 pData =_ILGetDataPointer(pidlOut);
1229 pszDest = _ILGetTextPointer(pidlOut);
1230 memcpy(pszDest, pIn, uInSize);
1231 TRACE("-- create Drive: %s\n",debugstr_a(pszDest));
1236 pData =_ILGetDataPointer(pidlOut);
1238 pszDest = _ILGetTextPointer(pidlOut);
1239 memcpy(pszDest, pIn, uInSize);
1240 TRACE("-- create Value: %s\n",debugstr_a(pszDest));
1244 pidlTemp = ILGetNext(pidlOut);
1246 pidlTemp->mkid.cb = 0x00;
1248 TRACE("-- (pidl=%p, size=%u)\n", pidlOut, uSize);
1252 /**************************************************************************
1255 * Gets the text for the drive eg. 'c:\'
1260 DWORD _ILGetDrive(LPCITEMIDLIST pidl,LPSTR pOut, UINT uSize)
1261 { TRACE("(%p,%p,%u)\n",pidl,pOut,uSize);
1263 if(_ILIsMyComputer(pidl))
1264 pidl = ILGetNext(pidl);
1266 if (pidl && _ILIsDrive(pidl))
1267 return _ILSimpleGetText(pidl, pOut, uSize);
1272 /**************************************************************************
1274 * ### 2. section testing pidls ###
1276 **************************************************************************
1279 * _ILIsSpecialFolder()
1285 BOOL _ILIsDesktop(LPCITEMIDLIST pidl)
1286 { TRACE("(%p)\n",pidl);
1287 return pidl && pidl->mkid.cb ? 0 : 1;
1290 BOOL _ILIsMyComputer(LPCITEMIDLIST pidl)
1292 REFIID iid = _ILGetGUIDPointer(pidl);
1294 TRACE("(%p)\n",pidl);
1297 return IsEqualIID(iid, &CLSID_MyComputer);
1301 BOOL _ILIsSpecialFolder (LPCITEMIDLIST pidl)
1303 LPPIDLDATA lpPData = _ILGetDataPointer(pidl);
1304 TRACE("(%p)\n",pidl);
1305 return (pidl && ( (lpPData && (PT_MYCOMP== lpPData->type || PT_SPECIAL== lpPData->type)) ||
1306 (pidl && pidl->mkid.cb == 0x00)
1310 BOOL _ILIsDrive(LPCITEMIDLIST pidl)
1311 { LPPIDLDATA lpPData = _ILGetDataPointer(pidl);
1312 TRACE("(%p)\n",pidl);
1313 return (pidl && lpPData && (PT_DRIVE == lpPData->type ||
1314 PT_DRIVE1 == lpPData->type ||
1315 PT_DRIVE2 == lpPData->type ||
1316 PT_DRIVE3 == lpPData->type));
1319 BOOL _ILIsFolder(LPCITEMIDLIST pidl)
1320 { LPPIDLDATA lpPData = _ILGetDataPointer(pidl);
1321 TRACE("(%p)\n",pidl);
1322 return (pidl && lpPData && (PT_FOLDER == lpPData->type || PT_FOLDER1 == lpPData->type));
1325 BOOL _ILIsValue(LPCITEMIDLIST pidl)
1326 { LPPIDLDATA lpPData = _ILGetDataPointer(pidl);
1327 TRACE("(%p)\n",pidl);
1328 return (pidl && lpPData && PT_VALUE == lpPData->type);
1331 /**************************************************************************
1334 BOOL _ILIsPidlSimple ( LPCITEMIDLIST pidl)
1338 if(! _ILIsDesktop(pidl)) /* pidl=NULL or mkid.cb=0 */
1340 WORD len = pidl->mkid.cb;
1341 LPCITEMIDLIST pidlnext = (LPCITEMIDLIST) (((LPBYTE)pidl) + len );
1342 if (pidlnext->mkid.cb)
1346 TRACE("%s\n", ret ? "Yes" : "No");
1350 /**************************************************************************
1352 * ### 3. section getting values from pidls ###
1355 /**************************************************************************
1358 * gets the text for the first item in the pidl (eg. simple pidl)
1360 * returns the length of the string
1362 DWORD _ILSimpleGetText (LPCITEMIDLIST pidl, LPSTR szOut, UINT uOutSize)
1367 char szTemp[MAX_PATH];
1369 TRACE("(%p %p %x)\n",pidl,szOut,uOutSize);
1371 if (!pidl) return 0;
1376 if (_ILIsDesktop(pidl))
1379 if (HCR_GetClassName(&CLSID_ShellDesktop, szTemp, MAX_PATH))
1382 lstrcpynA(szOut, szTemp, uOutSize);
1384 dwReturn = strlen (szTemp);
1387 else if (( szSrc = _ILGetTextPointer(pidl) ))
1391 lstrcpynA(szOut, szSrc, uOutSize);
1393 dwReturn = strlen(szSrc);
1395 else if (( riid = _ILGetGUIDPointer(pidl) ))
1397 /* special folder */
1398 if ( HCR_GetClassName(riid, szTemp, MAX_PATH) )
1401 lstrcpynA(szOut, szTemp, uOutSize);
1403 dwReturn = strlen (szTemp);
1408 ERR("-- no text\n");
1411 TRACE("-- (%p=%s 0x%08lx)\n",szOut,debugstr_a(szOut),dwReturn);
1415 /**************************************************************************
1417 * ### 4. getting pointers to parts of pidls ###
1419 **************************************************************************
1420 * _ILGetDataPointer()
1422 LPPIDLDATA _ILGetDataPointer(LPITEMIDLIST pidl)
1424 if(pidl && pidl->mkid.cb != 0x00)
1425 return (LPPIDLDATA) &(pidl->mkid.abID);
1429 /**************************************************************************
1430 * _ILGetTextPointer()
1431 * gets a pointer to the long filename string stored in the pidl
1433 LPSTR _ILGetTextPointer(LPCITEMIDLIST pidl)
1434 {/* TRACE(pidl,"(pidl%p)\n", pidl);*/
1436 LPPIDLDATA pdata =_ILGetDataPointer(pidl);
1440 switch (pdata->type)
1450 return (LPSTR)&(pdata->u.drive.szDriveName);
1457 return (LPSTR)&(pdata->u.file.szNames);
1463 return (LPSTR)&(pdata->u.network.szNames);
1469 /**************************************************************************
1470 * _ILGetSTextPointer()
1471 * gets a pointer to the short filename string stored in the pidl
1473 LPSTR _ILGetSTextPointer(LPCITEMIDLIST pidl)
1474 {/* TRACE(pidl,"(pidl%p)\n", pidl);*/
1476 LPPIDLDATA pdata =_ILGetDataPointer(pidl);
1480 switch (pdata->type)
1486 return (LPSTR)(pdata->u.file.szNames + strlen (pdata->u.file.szNames) + 1);
1489 return (LPSTR)(pdata->u.network.szNames + strlen (pdata->u.network.szNames) + 1);
1495 /**************************************************************************
1496 * _ILGetGUIDPointer()
1498 * returns reference to guid stored in some pidls
1500 REFIID _ILGetGUIDPointer(LPCITEMIDLIST pidl)
1502 LPPIDLDATA pdata =_ILGetDataPointer(pidl);
1504 TRACE("%p\n", pidl);
1508 TRACE("pdata->type 0x%04x\n", pdata->type);
1509 switch (pdata->type)
1513 return (REFIID) &(pdata->u.mycomp.guid);
1516 TRACE("Unknown pidl type 0x%04x\n", pdata->type);
1523 /*************************************************************************
1524 * _ILGetFileDateTime
1526 * Given the ItemIdList, get the FileTime
1529 * pidl [I] The ItemIDList
1530 * pFt [I] the resulted FILETIME of the file
1533 * True if Successful
1538 BOOL _ILGetFileDateTime(LPCITEMIDLIST pidl, FILETIME *pFt)
1540 LPPIDLDATA pdata =_ILGetDataPointer(pidl);
1542 if(! pdata) return FALSE;
1544 switch (pdata->type)
1547 DosDateTimeToFileTime(pdata->u.folder.uFileDate, pdata->u.folder.uFileTime, pFt);
1550 DosDateTimeToFileTime(pdata->u.file.uFileDate, pdata->u.file.uFileTime, pFt);
1558 BOOL _ILGetFileDate (LPCITEMIDLIST pidl, LPSTR pOut, UINT uOutSize)
1564 if (_ILGetFileDateTime( pidl, &ft )) {
1565 FileTimeToLocalFileTime(&ft, &lft);
1566 FileTimeToSystemTime (&lft, &time);
1567 ret = GetDateFormatA(LOCALE_USER_DEFAULT,DATE_SHORTDATE,&time, NULL, pOut, uOutSize);
1576 /*************************************************************************
1579 * Given the ItemIdList, get the FileSize
1582 * pidl [I] The ItemIDList
1583 * pOut [I] The buffer to save the result
1584 * uOutsize [I] The size of the buffer
1590 * pOut can be null when no string is needed
1593 DWORD _ILGetFileSize (LPCITEMIDLIST pidl, LPSTR pOut, UINT uOutSize)
1595 LPPIDLDATA pdata =_ILGetDataPointer(pidl);
1598 if(! pdata) return 0;
1600 switch (pdata->type)
1603 dwSize = pdata->u.file.dwFileSize;
1604 if (pOut) StrFormatByteSizeA(dwSize, pOut, uOutSize);
1607 if (pOut) *pOut = 0x00;
1611 BOOL _ILGetExtension (LPCITEMIDLIST pidl, LPSTR pOut, UINT uOutSize)
1613 char szTemp[MAX_PATH];
1614 const char * pPoint;
1615 LPITEMIDLIST pidlTemp=pidl;
1617 TRACE("pidl=%p\n",pidl);
1619 if (!pidl) return FALSE;
1621 pidlTemp = ILFindLastID(pidl);
1623 if (!_ILIsValue(pidlTemp)) return FALSE;
1624 if (!_ILSimpleGetText(pidlTemp, szTemp, MAX_PATH)) return FALSE;
1626 pPoint = PathFindExtensionA(szTemp);
1628 if (! *pPoint) return FALSE;
1631 lstrcpynA(pOut, pPoint, uOutSize);
1637 /*************************************************************************
1640 * Given the ItemIdList, get the file type description
1643 * pidl [I] The ItemIDList (simple)
1644 * pOut [I] The buffer to save the result
1645 * uOutsize [I] The size of the buffer
1651 * This function copies as much as possible into the buffer.
1653 void _ILGetFileType(LPCITEMIDLIST pidl, LPSTR pOut, UINT uOutSize)
1655 if(_ILIsValue(pidl))
1662 if (_ILGetExtension (pidl, sTemp, 64))
1664 if (!( HCR_MapTypeToValue(sTemp, sTemp, 64, TRUE)
1665 && HCR_MapTypeToValue(sTemp, pOut, uOutSize, FALSE )))
1667 lstrcpynA (pOut, sTemp, uOutSize - 6);
1668 strcat (pOut, "-file");
1674 lstrcpynA(pOut, "Folder", uOutSize);
1678 /*************************************************************************
1679 * _ILGetFileAttributes
1681 * Given the ItemIdList, get the Attrib string format
1684 * pidl [I] The ItemIDList
1685 * pOut [I] The buffer to save the result
1686 * uOutsize [I] The size of the Buffer
1692 * return value 0 in case of error is a valid return value
1695 DWORD _ILGetFileAttributes(LPCITEMIDLIST pidl, LPSTR pOut, UINT uOutSize)
1697 LPPIDLDATA pData =_ILGetDataPointer(pidl);
1701 if(! pData) return 0;
1706 wAttrib = pData->u.folder.uFileAttribs;
1709 wAttrib = pData->u.file.uFileAttribs;
1716 if(wAttrib & FILE_ATTRIBUTE_READONLY)
1720 if(wAttrib & FILE_ATTRIBUTE_HIDDEN)
1724 if(wAttrib & FILE_ATTRIBUTE_SYSTEM)
1728 if(wAttrib & FILE_ATTRIBUTE_ARCHIVE)
1732 if(wAttrib & FILE_ATTRIBUTE_COMPRESSED)
1741 /*************************************************************************
1744 * free a aPidl struct
1746 void _ILFreeaPidl(LPITEMIDLIST * apidl, UINT cidl)
1752 for(i = 0; i < cidl; i++) SHFree(apidl[i]);
1757 /*************************************************************************
1760 * copies an aPidl struct
1762 LPITEMIDLIST * _ILCopyaPidl(LPITEMIDLIST * apidlsrc, UINT cidl)
1765 LPITEMIDLIST * apidldest = (LPITEMIDLIST*)SHAlloc(cidl * sizeof(LPITEMIDLIST));
1766 if(!apidlsrc) return NULL;
1768 for(i = 0; i < cidl; i++)
1769 apidldest[i] = ILClone(apidlsrc[i]);
1774 /*************************************************************************
1775 * _ILCopyCidaToaPidl
1777 * creates aPidl from CIDA
1779 LPITEMIDLIST * _ILCopyCidaToaPidl(LPITEMIDLIST* pidl, LPIDA cida)
1782 LPITEMIDLIST * dst = (LPITEMIDLIST*)SHAlloc(cida->cidl * sizeof(LPITEMIDLIST));
1784 if(!dst) return NULL;
1787 *pidl = ILClone((LPITEMIDLIST)(&((LPBYTE)cida)[cida->aoffset[0]]));
1789 for(i = 0; i < cida->cidl; i++)
1790 dst[i] = ILClone((LPITEMIDLIST)(&((LPBYTE)cida)[cida->aoffset[i + 1]]));