Update the address of the Free Software Foundation.
[wine] / dlls / shell32 / debughlp.c
1 /*
2  * Helper functions for debugging
3  *
4  * Copyright 1998, 2002 Juergen Schmied
5  *
6  * This library is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU Lesser General Public
8  * License as published by the Free Software Foundation; either
9  * version 2.1 of the License, or (at your option) any later version.
10  *
11  * This library is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
14  * Lesser General Public License for more details.
15  *
16  * You should have received a copy of the GNU Lesser General Public
17  * License along with this library; if not, write to the Free Software
18  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
19  */
20
21 #include <ctype.h>
22 #include <stdlib.h>
23 #include <string.h>
24 #include <stdio.h>
25 #include "windef.h"
26 #include "wingdi.h"
27 #include "pidl.h"
28 #include "shlguid.h"
29 #include "shldisp.h"
30 #include "wine/debug.h"
31 #include "debughlp.h"
32 #include "docobj.h"
33 #include "shell32_main.h"
34
35
36 WINE_DEFAULT_DEBUG_CHANNEL(pidl);
37
38 static
39 LPITEMIDLIST _dbg_ILGetNext(LPCITEMIDLIST pidl)
40 {
41         WORD len;
42
43         if(pidl)
44         {
45           len =  pidl->mkid.cb;
46           if (len)
47           {
48             return (LPITEMIDLIST) (((LPBYTE)pidl)+len);
49           }
50         }
51         return NULL;
52 }
53
54 static
55 BOOL _dbg_ILIsDesktop(LPCITEMIDLIST pidl)
56 {
57         return ( !pidl || (pidl && pidl->mkid.cb == 0x00) );
58 }
59
60 static
61 LPPIDLDATA _dbg_ILGetDataPointer(LPCITEMIDLIST pidl)
62 {
63         if(pidl && pidl->mkid.cb != 0x00)
64           return (LPPIDLDATA) &(pidl->mkid.abID);
65         return NULL;
66 }
67
68 static
69 LPSTR _dbg_ILGetTextPointer(LPCITEMIDLIST pidl)
70 {
71         LPPIDLDATA pdata =_dbg_ILGetDataPointer(pidl);
72
73         if (pdata)
74         {
75           switch (pdata->type)
76           {
77             case PT_GUID:
78             case PT_SHELLEXT:
79             case PT_YAGUID:
80               return NULL;
81
82             case PT_DRIVE:
83             case PT_DRIVE1:
84             case PT_DRIVE2:
85             case PT_DRIVE3:
86               return (LPSTR)&(pdata->u.drive.szDriveName);
87
88             case PT_FOLDER:
89             case PT_FOLDER1:
90             case PT_VALUE:
91             case PT_IESPECIAL1:
92             case PT_IESPECIAL2:
93               return (LPSTR)&(pdata->u.file.szNames);
94
95             case PT_WORKGRP:
96             case PT_COMP:
97             case PT_NETWORK:
98             case PT_NETPROVIDER:
99             case PT_SHARE:
100               return (LPSTR)&(pdata->u.network.szNames);
101           }
102         }
103         return NULL;
104 }
105
106 static
107 LPSTR _dbg_ILGetSTextPointer(LPCITEMIDLIST pidl)
108 {
109         LPPIDLDATA pdata =_dbg_ILGetDataPointer(pidl);
110
111         if (pdata)
112         {
113           switch (pdata->type)
114           {
115             case PT_FOLDER:
116             case PT_VALUE:
117             case PT_IESPECIAL1:
118             case PT_IESPECIAL2:
119               return (LPSTR)(pdata->u.file.szNames + strlen (pdata->u.file.szNames) + 1);
120
121             case PT_WORKGRP:
122               return (LPSTR)(pdata->u.network.szNames + strlen (pdata->u.network.szNames) + 1);
123           }
124         }
125         return NULL;
126 }
127
128 static
129 IID* _dbg_ILGetGUIDPointer(LPCITEMIDLIST pidl)
130 {
131         LPPIDLDATA pdata =_ILGetDataPointer(pidl);
132
133         if (pdata)
134         {
135           switch (pdata->type)
136           {
137             case PT_SHELLEXT:
138             case PT_GUID:
139             case PT_YAGUID:
140               return &(pdata->u.guid.guid);
141           }
142         }
143         return NULL;
144 }
145
146 static
147 void _dbg_ILSimpleGetText (LPCITEMIDLIST pidl, LPSTR szOut, UINT uOutSize)
148 {
149         LPSTR           szSrc;
150         GUID const *    riid;
151
152         if (!pidl) return;
153
154         if (szOut)
155           *szOut = 0;
156
157         if (_dbg_ILIsDesktop(pidl))
158         {
159          /* desktop */
160           if (szOut) lstrcpynA(szOut, "Desktop", uOutSize);
161         }
162         else if (( szSrc = _dbg_ILGetTextPointer(pidl) ))
163         {
164           /* filesystem */
165           if (szOut) lstrcpynA(szOut, szSrc, uOutSize);
166         }
167         else if (( riid = _dbg_ILGetGUIDPointer(pidl) ))
168         {
169           if (szOut)
170             sprintf( szOut, "{%08lx-%04x-%04x-%02x%02x-%02x%02x%02x%02x%02x%02x}",
171                  riid->Data1, riid->Data2, riid->Data3,
172                  riid->Data4[0], riid->Data4[1], riid->Data4[2], riid->Data4[3],
173                  riid->Data4[4], riid->Data4[5], riid->Data4[6], riid->Data4[7] );
174         }
175 }
176
177
178
179
180 void pdump (LPCITEMIDLIST pidl)
181 {
182         LPCITEMIDLIST pidltemp = pidl;
183
184         if (!TRACE_ON(pidl)) return;
185
186         if (! pidltemp)
187         {
188           MESSAGE ("-------- pidl=NULL (Desktop)\n");
189         }
190         else
191         {
192           MESSAGE ("-------- pidl=%p\n", pidl);
193           if (pidltemp->mkid.cb)
194           {
195             do
196             {
197               DWORD dwAttrib = 0;
198               LPPIDLDATA pData   = _dbg_ILGetDataPointer(pidltemp);
199               DWORD type = pData ? pData->type : 0;
200               LPSTR szLongName   = _dbg_ILGetTextPointer(pidltemp);
201               LPSTR szShortName  = _dbg_ILGetSTextPointer(pidltemp);
202               char szName[MAX_PATH];
203
204               _dbg_ILSimpleGetText(pidltemp, szName, MAX_PATH);
205               if ( pData && (PT_FOLDER == type || PT_VALUE == type) )
206                 dwAttrib = pData->u.file.uFileAttribs;
207
208               MESSAGE ("[%p] size=%04u type=%lx attr=0x%08lx name=%s (%s,%s)\n",
209                        pidltemp, pidltemp->mkid.cb, type, dwAttrib,
210                        debugstr_a(szName), debugstr_a(szLongName), debugstr_a(szShortName));
211
212               pidltemp = _dbg_ILGetNext(pidltemp);
213
214             } while (pidltemp && pidltemp->mkid.cb);
215           }
216           else
217           {
218             MESSAGE ("empty pidl (Desktop)\n");
219           }
220           pcheck(pidl);
221         }
222 }
223
224 static void dump_pidl_hex( LPCITEMIDLIST pidl )
225 {
226     const unsigned char *p = (const unsigned char *)pidl;
227     const int max_bytes = 0x80;
228 #define max_line 0x10
229     char szHex[max_line*3+1], szAscii[max_line+1];
230     int i, n;
231
232     n = pidl->mkid.cb;
233     if( n>max_bytes )
234         n = max_bytes;
235     for( i=0; i<n; i++ )
236     {
237         sprintf( &szHex[ (i%max_line)*3 ], "%02X ", p[i] );
238         szAscii[ (i%max_line) ] = isprint( p[i] ) ? p[i] : '.';
239
240         /* print out at the end of each line and when we're finished */
241         if( i!=(n-1) && (i%max_line) != (max_line-1) )
242             continue;
243         szAscii[ (i%max_line)+1 ] = 0;
244         ERR("%-*s   %s\n", max_line*3, szHex, szAscii );
245     }
246 }
247
248 BOOL pcheck( LPCITEMIDLIST pidl )
249 {
250     DWORD type;
251     LPCITEMIDLIST pidltemp = pidl;
252
253     while( pidltemp && pidltemp->mkid.cb )
254     {
255         type = _dbg_ILGetDataPointer(pidltemp)->type;
256         switch( type )
257         {
258         case PT_CPLAPPLET:
259         case PT_GUID:
260         case PT_SHELLEXT:
261         case PT_DRIVE:
262         case PT_DRIVE1:
263         case PT_DRIVE2:
264         case PT_DRIVE3:
265         case PT_FOLDER:
266         case PT_VALUE:
267         case PT_VALUEW:
268         case PT_FOLDER1:
269         case PT_WORKGRP:
270         case PT_COMP:
271         case PT_NETPROVIDER:
272         case PT_NETWORK:
273         case PT_IESPECIAL1:
274         case PT_YAGUID:
275         case PT_IESPECIAL2:
276         case PT_SHARE:
277             break;
278         default:
279             ERR("unknown IDLIST %p [%p] size=%u type=%lx\n",
280                 pidl, pidltemp, pidltemp->mkid.cb,type );
281             dump_pidl_hex( pidltemp );
282             return FALSE;
283         }
284         pidltemp = _dbg_ILGetNext(pidltemp);
285     }
286     return TRUE;
287 }
288
289 static const struct {
290         REFIID riid;
291         const char *name;
292 } InterfaceDesc[] = {
293         {&IID_IUnknown,                 "IID_IUnknown"},
294         {&IID_IClassFactory,            "IID_IClassFactory"},
295         {&IID_IShellView,               "IID_IShellView"},
296         {&IID_IOleCommandTarget,        "IID_IOleCommandTarget"},
297         {&IID_IDropTarget,              "IID_IDropTarget"},
298         {&IID_IDropSource,              "IID_IDropSource"},
299         {&IID_IViewObject,              "IID_IViewObject"},
300         {&IID_IContextMenu,             "IID_IContextMenu"},
301         {&IID_IShellExtInit,            "IID_IShellExtInit"},
302         {&IID_IShellFolder,             "IID_IShellFolder"},
303         {&IID_IShellFolder2,            "IID_IShellFolder2"},
304         {&IID_IPersist,                 "IID_IPersist"},
305         {&IID_IPersistFolder,           "IID_IPersistFolder"},
306         {&IID_IPersistFolder2,          "IID_IPersistFolder2"},
307         {&IID_IPersistFolder3,          "IID_IPersistFolder3"},
308         {&IID_IExtractIconA,            "IID_IExtractIconA"},
309         {&IID_IExtractIconW,            "IID_IExtractIconW"},
310         {&IID_IDataObject,              "IID_IDataObject"},
311         {&IID_IAutoComplete,            "IID_IAutoComplete"},
312         {&IID_IAutoComplete2,           "IID_IAutoComplete2"},
313         {&IID_IShellLinkA,              "IID_IShellLinkA"},
314         {&IID_IShellLinkW,              "IID_IShellLinkW"},
315         {NULL,NULL}};
316
317 const char * shdebugstr_guid( const struct _GUID *id )
318 {
319         int i;
320         const char* name = NULL;
321         char clsidbuf[100];
322
323         if (!id) return "(null)";
324
325             for (i=0;InterfaceDesc[i].riid && !name;i++) {
326                 if (IsEqualIID(InterfaceDesc[i].riid, id)) name = InterfaceDesc[i].name;
327             }
328             if (!name) {
329                 if (HCR_GetClassNameA(id, clsidbuf, 100))
330                     name = clsidbuf;
331             }
332
333             return wine_dbg_sprintf( "\n\t{%08lx-%04x-%04x-%02x%02x-%02x%02x%02x%02x%02x%02x} (%s)",
334                  id->Data1, id->Data2, id->Data3,
335                  id->Data4[0], id->Data4[1], id->Data4[2], id->Data4[3],
336                  id->Data4[4], id->Data4[5], id->Data4[6], id->Data4[7], name ? name : "unknown" );
337 }