Corrected 2 wrong definitions.
[wine] / include / shlobj.h
1 #ifndef _WINE_SHLOBJ_H
2 #define _WINE_SHLOBJ_H
3
4 #include "shell.h"
5 #include "ole.h"
6 #include "ole2.h"
7 #include "compobj.h"
8 #include "storage.h"
9 #include "commctrl.h"
10 #include "interfaces.h"
11
12 #define STDMETHOD(xfn) HRESULT (CALLBACK *fn##xfn)
13 #define STDMETHOD_(type,xfn) type (CALLBACK *fn##xfn)
14 #define PURE
15 #define FAR
16 #define THIS_ THIS,
17
18 #define __T(x)      x
19 #define _T(x)       __T(x)
20 #define TEXT        _T
21
22 /****************************************************************************
23 *  DllGetClassObject
24 */
25 DWORD WINAPI SHELL32_DllGetClassObject(LPCLSID,REFIID,LPVOID*);
26
27
28 typedef LPVOID  LPBC; /* *IBindCtx really */
29
30 /* foreward declaration of the objects*/
31 typedef struct tagCONTEXTMENU   *LPCONTEXTMENU, IContextMenu;
32 typedef struct tagSHELLEXTINIT  *LPSHELLEXTINIT,IShellExtInit;
33 typedef struct tagENUMIDLIST    *LPENUMIDLIST,  IEnumIDList;
34 typedef struct tagSHELLFOLDER   *LPSHELLFOLDER, IShellFolder;
35 typedef struct tagSHELLVIEW     *LPSHELLVIEW,   IShellView;
36 typedef struct tagSHELLBROWSER  *LPSHELLBROWSER,IShellBrowser;
37 typedef struct tagDATAOBJECT    *LPDATAOBJECT,  IDataObject;
38 typedef struct tagSHELLICON     *LPSHELLICON,   IShellIcon;
39 typedef struct tagDOCKINGWINDOWFRAME    *LPDOCKINGWINDOWFRAME,  IDockingWindowFrame;
40 typedef struct tagSERVICEPROVIDER       *LPSERVICEPROVIDER,     IServiceProvider;
41 typedef struct tagCOMMDLGBROWSER        *LPCOMMDLGBROWSER,      ICommDlgBrowser;
42 typedef struct tagENUMFORMATETC *LPENUMFORMATETC,       IEnumFORMATETC;
43  
44 typedef struct IAdviseSink              IAdviseSink,    *LPIADVISESINK;
45 typedef struct IEnumSTATDATA            IEnumSTATDATA,  *LPENUMSTATDATA;
46 /****************************************************************************
47 *  SHELL ID
48 */
49 /* strange Objects */
50 DEFINE_SHLGUID(IID_IEnumUnknown,        0x00000100L, 0, 0);
51 DEFINE_SHLGUID(IID_IEnumString,         0x00000101L, 0, 0);
52 DEFINE_SHLGUID(IID_IEnumMoniker,        0x00000102L, 0, 0);
53 DEFINE_SHLGUID(IID_IEnumFORMATETC,      0x00000103L, 0, 0);
54 DEFINE_SHLGUID(IID_IEnumOLEVERB,        0x00000104L, 0, 0);
55 DEFINE_SHLGUID(IID_IEnumSTATDATA,       0x00000105L, 0, 0);
56
57 DEFINE_SHLGUID(IID_IPersistStream,      0x00000109L, 0, 0);
58 DEFINE_SHLGUID(IID_IPersistStorage,     0x0000010AL, 0, 0);
59 DEFINE_SHLGUID(IID_IPersistFile,        0x0000010BL, 0, 0);
60 DEFINE_SHLGUID(IID_IPersist,            0x0000010CL, 0, 0);
61 DEFINE_SHLGUID(IID_IViewObject,         0x0000010DL, 0, 0);
62 DEFINE_SHLGUID(IID_IDataObject,         0x0000010EL, 0, 0);
63
64 DEFINE_SHLGUID(IID_IDropSource,         0x00000121L, 0, 0);
65 DEFINE_SHLGUID(IID_IDropTarget,         0x00000122L, 0, 0);
66
67 DEFINE_GUID (IID_IServiceProvider,      0x6D5140C1L, 0x7436, 0x11CE, 0x80, 0x34, 0x00, 0xAA, 0x00, 0x60, 0x09, 0xFA);
68 DEFINE_GUID (IID_IDockingWindow,        0x012dd920L, 0x7B26, 0x11D0, 0x8C, 0xA9, 0x00, 0xA0, 0xC9, 0x2D, 0xBF, 0xE8);
69 DEFINE_GUID (IID_IDockingWindowSite,    0x2A342FC2L, 0x7B26, 0x11D0, 0x8C, 0xA9, 0x00, 0xA0, 0xC9, 0x2D, 0xBF, 0xE8);
70 DEFINE_GUID (IID_IDockingWindowFrame,   0x47D2657AL, 0x7B27, 0x11D0, 0x8C, 0xA9, 0x00, 0xA0, 0xC9, 0x2D, 0xBF, 0xE8);
71
72 DEFINE_SHLGUID(CLSID_ShellDesktop,      0x00021400L, 0, 0);
73 DEFINE_SHLGUID(CLSID_ShellLink,         0x00021401L, 0, 0);
74 /* shell32 formatids */
75 DEFINE_SHLGUID(FMTID_Intshcut,          0x000214A0L, 0, 0);
76 DEFINE_SHLGUID(FMTID_InternetSite,      0x000214A1L, 0, 0);
77 /* command group ids */
78 DEFINE_SHLGUID(CGID_Explorer,           0x000214D0L, 0, 0);
79 DEFINE_SHLGUID(CGID_ShellDocView,       0x000214D1L, 0, 0);
80
81  /* shell32interface ids */
82 DEFINE_SHLGUID(IID_INewShortcutHookA,   0x000214E1L, 0, 0);
83 DEFINE_SHLGUID(IID_IShellBrowser,       0x000214E2L, 0, 0);
84 #define SID_SShellBrowser IID_IShellBrowser
85 DEFINE_SHLGUID(IID_IShellView,          0x000214E3L, 0, 0);
86 DEFINE_SHLGUID(IID_IContextMenu,        0x000214E4L, 0, 0);
87 DEFINE_SHLGUID(IID_IShellIcon,          0x000214E5L, 0, 0);
88 DEFINE_SHLGUID(IID_IShellFolder,        0x000214E6L, 0, 0);
89 DEFINE_SHLGUID(IID_IShellExtInit,       0x000214E8L, 0, 0);
90 DEFINE_SHLGUID(IID_IShellPropSheetExt,  0x000214E9L, 0, 0);
91 DEFINE_SHLGUID(IID_IExtractIcon,        0x000214EBL, 0, 0);
92 DEFINE_SHLGUID(IID_IShellLink,          0x000214EEL, 0, 0);
93 DEFINE_SHLGUID(IID_IShellCopyHook,      0x000214EFL, 0, 0);
94 DEFINE_SHLGUID(IID_IFileViewer,         0x000214F0L, 0, 0);
95 DEFINE_SHLGUID(IID_ICommDlgBrowser,     0x000214F1L, 0, 0);
96 DEFINE_SHLGUID(IID_IEnumIDList,         0x000214F2L, 0, 0);
97 DEFINE_SHLGUID(IID_IFileViewerSite,     0x000214F3L, 0, 0);
98 DEFINE_SHLGUID(IID_IContextMenu2,       0x000214F4L, 0, 0);
99 DEFINE_SHLGUID(IID_IShellExecuteHookA,  0x000214F5L, 0, 0);
100 DEFINE_SHLGUID(IID_IPropSheetPage,      0x000214F6L, 0, 0);
101 DEFINE_SHLGUID(IID_INewShortcutHookW,   0x000214F7L, 0, 0);
102 DEFINE_SHLGUID(IID_IFileViewerW,        0x000214F8L, 0, 0);
103 DEFINE_SHLGUID(IID_IShellLinkW,         0x000214F9L, 0, 0);
104 DEFINE_SHLGUID(IID_IExtractIconW,       0x000214FAL, 0, 0);
105 DEFINE_SHLGUID(IID_IShellExecuteHookW,  0x000214FBL, 0, 0);
106 DEFINE_SHLGUID(IID_IShellCopyHookW,     0x000214FCL, 0, 0);
107
108 /****************************************************************************
109 *  STRRET
110 */
111 #define STRRET_WSTR     0x0000
112 #define STRRET_OFFSETA  0x0001
113 #define STRRET_CSTRA    0x0002
114 #define STRRET_ASTR     0X0003
115 #define STRRET_OFFSETW  0X0004
116 #define STRRET_CSTRW    0X0005
117
118
119 typedef struct _STRRET
120 { UINT32 uType;         /* STRRET_xxx */
121   union
122   { LPWSTR      pOleStr;        /* OLESTR that will be freed */
123     LPSTR       pStr;
124     UINT32      uOffset;        /* OffsetINT32o SHITEMID (ANSI) */
125     char        cStr[MAX_PATH]; /* Buffer to fill in */
126     WCHAR       cStrW[MAX_PATH];
127   }u;
128 } STRRET,*LPSTRRET;
129
130 /*****************************************************************************
131  * IContextMenu interface
132  */
133 #define THIS LPCONTEXTMENU this
134
135 /* default menu items*/
136 #define IDM_EXPLORE  0
137 #define IDM_OPEN     1
138 #define IDM_RENAME   2
139 #define IDM_LAST     IDM_RENAME
140
141 /* QueryContextMenu uFlags */
142 #define CMF_NORMAL              0x00000000
143 #define CMF_DEFAULTONLY         0x00000001
144 #define CMF_VERBSONLY           0x00000002
145 #define CMF_EXPLORE             0x00000004
146 #define CMF_NOVERBS             0x00000008
147 #define CMF_CANRENAME           0x00000010
148 #define CMF_NODEFAULT           0x00000020
149 #define CMF_INCLUDESTATIC       0x00000040
150 #define CMF_RESERVED            0xffff0000      // View specific
151
152 /* GetCommandString uFlags */
153 #define GCS_VERBA        0x00000000     // canonical verb
154 #define GCS_HELPTEXTA    0x00000001     // help text (for status bar)
155 #define GCS_VALIDATEA    0x00000002     // validate command exists
156 #define GCS_VERBW        0x00000004     // canonical verb (unicode)
157 #define GCS_HELPTEXTW    0x00000005     // help text (unicode version)
158 #define GCS_VALIDATEW    0x00000006     // validate command exists (unicode)
159 #define GCS_UNICODE      0x00000004     // for bit testing - Unicode string
160
161 #define GCS_VERB        GCS_VERBA
162 #define GCS_HELPTEXT    GCS_HELPTEXTA
163 #define GCS_VALIDATE    GCS_VALIDATEA
164
165 #define CMDSTR_NEWFOLDERA   "NewFolder"
166 #define CMDSTR_VIEWLISTA    "ViewList"
167 #define CMDSTR_VIEWDETAILSA "ViewDetails"
168 #define CMDSTR_NEWFOLDERW   L"NewFolder"
169 #define CMDSTR_VIEWLISTW    L"ViewList"
170 #define CMDSTR_VIEWDETAILSW L"ViewDetails"
171
172 #define CMDSTR_NEWFOLDER    CMDSTR_NEWFOLDERA
173 #define CMDSTR_VIEWLIST     CMDSTR_VIEWLISTA
174 #define CMDSTR_VIEWDETAILS  CMDSTR_VIEWDETAILSA
175
176 #define CMIC_MASK_HOTKEY        SEE_MASK_HOTKEY
177 #define CMIC_MASK_ICON          SEE_MASK_ICON
178 #define CMIC_MASK_FLAG_NO_UI    SEE_MASK_FLAG_NO_UI
179 #define CMIC_MASK_UNICODE       SEE_MASK_UNICODE
180 #define CMIC_MASK_NO_CONSOLE    SEE_MASK_NO_CONSOLE
181 #define CMIC_MASK_HASLINKNAME   SEE_MASK_HASLINKNAME
182 #define CMIC_MASK_FLAG_SEP_VDM  SEE_MASK_FLAG_SEPVDM
183 #define CMIC_MASK_HASTITLE      SEE_MASK_HASTITLE
184 #define CMIC_MASK_ASYNCOK       SEE_MASK_ASYNCOK
185
186 #define CMIC_MASK_PTINVOKE      0x20000000
187
188 /*NOTE: When SEE_MASK_HMONITOR is set, hIcon is treated as hMonitor */
189 typedef struct tagCMINVOKECOMMANDINFO 
190 {   DWORD cbSize;        // sizeof(CMINVOKECOMMANDINFO)
191     DWORD fMask;         // any combination of CMIC_MASK_*
192     HWND32 hwnd;         // might be NULL (indicating no owner window)
193     LPCSTR lpVerb;       // either a string or MAKEINTRESOURCE(idOffset)
194     LPCSTR lpParameters; // might be NULL (indicating no parameter)
195     LPCSTR lpDirectory;  // might be NULL (indicating no specific directory)
196    INT32 nShow;           // one of SW_ values for ShowWindow() API
197
198     DWORD dwHotKey;
199     HANDLE32 hIcon;
200 } CMINVOKECOMMANDINFO32,  *LPCMINVOKECOMMANDINFO32;
201
202 typedef struct tagCMInvokeCommandInfoEx 
203 {   DWORD cbSize;        // must be sizeof(CMINVOKECOMMANDINFOEX)
204     DWORD fMask;         // any combination of CMIC_MASK_*
205     HWND32 hwnd;         // might be NULL (indicating no owner window)
206     LPCSTR lpVerb;       // either a string or MAKEINTRESOURCE(idOffset)
207     LPCSTR lpParameters; // might be NULL (indicating no parameter)
208     LPCSTR lpDirectory;  // might be NULL (indicating no specific directory)
209         INT32 nShow;           // one of SW_ values for ShowWindow() API
210
211     DWORD dwHotKey;
212     
213     HANDLE32 hIcon;
214     LPCSTR lpTitle;        // For CreateProcess-StartupInfo.lpTitle
215     LPCWSTR lpVerbW;       // Unicode verb (for those who can use it)
216     LPCWSTR lpParametersW; // Unicode parameters (for those who can use it)
217     LPCWSTR lpDirectoryW;  // Unicode directory (for those who can use it)
218     LPCWSTR lpTitleW;      // Unicode title (for those who can use it)
219     POINT32 ptInvoke;      // Point where it's invoked
220
221 } CMINVOKECOMMANDINFOEX32,  *LPCMINVOKECOMMANDINFOEX32;
222
223
224 typedef struct IContextMenu_VTable
225 {   // *** IUnknown methods ***
226     STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID * ppvObj) PURE;
227     STDMETHOD_(ULONG,AddRef) (THIS)  PURE;
228     STDMETHOD_(ULONG,Release) (THIS) PURE;
229
230     STDMETHOD(QueryContextMenu)(THIS_ HMENU32 hmenu,UINT32 indexMenu,UINT32 idCmdFirst, UINT32 idCmdLast,UINT32 uFlags) PURE;
231     STDMETHOD(InvokeCommand)(THIS_ LPCMINVOKECOMMANDINFO32 lpici) PURE;
232     STDMETHOD(GetCommandString)(THIS_ UINT32 idCmd,UINT32 uType,UINT32 * pwReserved,LPSTR pszName,UINT32 cchMax) PURE;
233
234     /* undocumented not only in ContextMenu2 */
235     STDMETHOD(HandleMenuMsg)(THIS_  UINT32 uMsg,WPARAM32 wParam,LPARAM lParam) PURE;
236
237     /* possibly another nasty entry from ContextMenu3 ?*/    
238     void * guard;
239 } IContextMenu_VTable,*LPCONTEXTMENU_VTABLE;
240
241 struct tagCONTEXTMENU
242 { LPCONTEXTMENU_VTABLE  lpvtbl;
243   DWORD                 ref;
244   LPSHELLFOLDER pSFParent;
245   LPITEMIDLIST  *aPidls;
246   BOOL32                bAllValues;
247 };
248
249 #undef THIS
250 /*****************************************************************************
251  * structures for shell clipboard formats
252  */
253 typedef enum tagDVASPECT
254 {       DVASPECT_CONTENT        = 1,
255         DVASPECT_THUMBNAIL      = 2,
256         DVASPECT_ICON   = 4,
257         DVASPECT_DOCPRINT       = 8
258 } DVASPECT;
259
260 typedef enum tagTYMED
261 {       TYMED_HGLOBAL   = 1,
262         TYMED_FILE      = 2,
263         TYMED_ISTREAM   = 4,
264         TYMED_ISTORAGE  = 8,
265         TYMED_GDI       = 16,
266         TYMED_MFPICT    = 32,
267         TYMED_ENHMF     = 64,
268         TYMED_NULL      = 0
269 } TYMED;
270   
271 typedef struct
272 {       DWORD tdSize;
273         WORD tdDriverNameOffset;
274         WORD tdDeviceNameOffset;
275         WORD tdPortNameOffset;
276         WORD tdExtDevmodeOffset;
277         BYTE tdData[ 1 ];
278 } DVTARGETDEVICE32;
279
280 typedef WORD CLIPFORMAT32, *LPCLIPFORMAT32;
281
282 /* dataobject as answer to a request */
283 typedef struct 
284 {       DWORD tymed;
285         union 
286         { HBITMAP32 hBitmap;
287           /*HMETAFILEPICT32 hMetaFilePict;*/
288           /*HENHMETAFILE32 hEnhMetaFile;*/
289           HGLOBAL32 hGlobal;
290           LPOLESTR32 lpszFileName;
291           IStream32 *pstm;
292           IStorage32 *pstg;
293         } u;
294         IUnknown *pUnkForRelease;
295 } STGMEDIUM32;   
296
297 /* wished data format */
298 typedef struct 
299 {       CLIPFORMAT32 cfFormat;
300         DVTARGETDEVICE32 *ptd;
301         DWORD dwAspect;
302         LONG lindex;
303         DWORD tymed;
304 } FORMATETC32, *LPFORMATETC32;
305
306 /* shell specific clipboard formats */
307
308 /* DATAOBJECT_InitShellIDList*/
309 #define CFSTR_SHELLIDLIST       TEXT("Shell IDList Array")      /* CF_IDLIST */
310
311 extern UINT32 cfShellIDList;
312
313 typedef struct
314 {       UINT32 cidl;
315         UINT32 aoffset[1];
316 } CIDA, *LPCIDA;
317
318 #define CFSTR_SHELLIDLISTOFFSET TEXT("Shell Object Offsets")    /* CF_OBJECTPOSITIONS */
319 #define CFSTR_NETRESOURCES      TEXT("Net Resource")            /* CF_NETRESOURCE */
320
321 /* DATAOBJECT_InitFileGroupDesc */
322 #define CFSTR_FILEDESCRIPTORA   TEXT("FileGroupDescriptor")     /* CF_FILEGROUPDESCRIPTORA */
323 extern UINT32 cfFileGroupDesc;
324
325 #define CFSTR_FILEDESCRIPTORW   TEXT("FileGroupDescriptorW")    /* CF_FILEGROUPDESCRIPTORW */
326
327 /* DATAOBJECT_InitFileContents*/
328 #define CFSTR_FILECONTENTS      TEXT("FileContents")            /* CF_FILECONTENTS */
329 extern UINT32 cfFileContents;
330
331 #define CFSTR_FILENAMEA         TEXT("FileName")                /* CF_FILENAMEA */
332 #define CFSTR_FILENAMEW         TEXT("FileNameW")               /* CF_FILENAMEW */
333 #define CFSTR_PRINTERGROUP      TEXT("PrinterFriendlyName")     /* CF_PRINTERS */
334 #define CFSTR_FILENAMEMAPA      TEXT("FileNameMap")             /* CF_FILENAMEMAPA */
335 #define CFSTR_FILENAMEMAPW      TEXT("FileNameMapW")            /* CF_FILENAMEMAPW */
336 #define CFSTR_SHELLURL          TEXT("UniformResourceLocator")
337 #define CFSTR_PREFERREDDROPEFFECT TEXT("Preferred DropEffect")
338 #define CFSTR_PERFORMEDDROPEFFECT TEXT("Performed DropEffect")
339 #define CFSTR_PASTESUCCEEDED    TEXT("Paste Succeeded")
340 #define CFSTR_INDRAGLOOP        TEXT("InShellDragLoop")
341
342 /**************************************************************************
343  *  IDLList "Item ID List List"
344  *
345  *  NOTES
346  *   interal data holder for IDataObject
347  */
348 typedef struct tagLPIDLLIST     *LPIDLLIST,     IDLList;
349
350 #define THIS LPIDLLIST this
351
352 typedef enum
353 {       State_UnInit=1,
354         State_Init=2,
355         State_OutOfMem=3
356 } IDLListState;
357  
358 typedef struct IDLList_VTable
359 {       STDMETHOD_(UINT32, GetState)(THIS);
360         STDMETHOD_(LPITEMIDLIST, GetElement)(THIS_ UINT32 nIndex);
361         STDMETHOD_(UINT32, GetCount)(THIS);
362         STDMETHOD_(BOOL32, StoreItem)(THIS_ LPITEMIDLIST pidl);
363         STDMETHOD_(BOOL32, AddItems)(THIS_ LPITEMIDLIST *apidl, UINT32 cidl);
364         STDMETHOD_(BOOL32, InitList)(THIS);
365         STDMETHOD_(void, CleanList)(THIS);
366 } IDLList_VTable,*LPIDLLIST_VTABLE;
367
368 struct tagLPIDLLIST
369 {       LPIDLLIST_VTABLE        lpvtbl;
370         HDPA    dpa;
371         UINT32  uStep;
372 };
373
374 extern LPIDLLIST IDLList_Constructor (UINT32 uStep);
375 extern void IDLList_Destructor(LPIDLLIST this);
376 #undef THIS
377 /*****************************************************************************
378  * IEnumFORMATETC interface
379  */
380 #define THIS LPENUMFORMATETC this
381
382 typedef struct IEnumFORMATETC_VTable 
383 {    /* IUnknown methods */
384         STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID * ppvObj) PURE;
385         STDMETHOD_(ULONG,AddRef) (THIS) PURE;
386         STDMETHOD_(ULONG,Release) (THIS) PURE;
387
388         /* IEnumFORMATETC methods */
389         STDMETHOD (Next)(THIS_ ULONG celt, FORMATETC32 *rgelt, ULONG *pceltFethed) PURE;
390         STDMETHOD (Skip)(THIS_ ULONG celt) PURE;
391         STDMETHOD (Reset)(THIS) PURE;
392         STDMETHOD (Clone)(THIS_ IEnumFORMATETC ** ppenum) PURE;
393 } IEnumFORMATETC_VTable,*LPENUMFORMATETC_VTABLE;
394
395 struct tagENUMFORMATETC
396 {       LPENUMFORMATETC_VTABLE  lpvtbl;
397         DWORD                    ref;
398         UINT32  posFmt;
399         UINT32  countFmt;
400         LPFORMATETC32 pFmt;
401 };
402
403 #undef THIS
404
405 /*****************************************************************************
406  * IDataObject interface
407  */
408 #define THIS LPDATAOBJECT this
409
410 typedef struct IDataObject_VTable 
411 {       /*** IUnknown methods ***/
412         STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID * ppvObj) PURE;
413         STDMETHOD_(ULONG,AddRef) (THIS) PURE;
414         STDMETHOD_(ULONG,Release) (THIS) PURE;
415
416         STDMETHOD (GetData )(THIS_ LPFORMATETC32 pformatetcIn, STGMEDIUM32 *pmedium) PURE;
417         STDMETHOD (GetDataHere)(THIS_ LPFORMATETC32 pformatetc, STGMEDIUM32 *pmedium) PURE;
418         STDMETHOD (QueryGetData)(THIS_ LPFORMATETC32 pformatetc) PURE;
419         STDMETHOD (GetCanonicalFormatEtc)(THIS_ LPFORMATETC32 pformatectIn, LPFORMATETC32 pformatetcOut) PURE;
420         STDMETHOD (SetData)(THIS_ LPFORMATETC32 pformatetc, STGMEDIUM32 *pmedium, BOOL32 fRelease) PURE;
421         STDMETHOD (EnumFormatEtc)(THIS_ DWORD dwDirection, IEnumFORMATETC **ppenumFormatEtc) PURE;
422         STDMETHOD (DAdvise )(THIS_ LPFORMATETC32 *pformatetc, DWORD advf, IAdviseSink *pAdvSink, DWORD *pdwConnection) PURE;
423         STDMETHOD (DUnadvise)(THIS_ DWORD dwConnection) PURE;
424         STDMETHOD (EnumDAdvise)(THIS_ IEnumSTATDATA **ppenumAdvise) PURE;
425 } IDataObject_VTable,*LPDATAOBJECT_VTABLE;
426
427 struct tagDATAOBJECT
428 {       LPDATAOBJECT_VTABLE     lpvtbl;
429         DWORD   ref;
430         LPSHELLFOLDER   psf;
431         LPIDLLIST  lpill;       /* the data of the dataobject */
432         LPITEMIDLIST  pidl;     
433 };
434
435 #undef THIS
436
437
438 /*****************************************************************************
439  * IShellExtInit interface
440  */
441 #define THIS LPSHELLEXTINIT this
442
443 typedef struct IShellExtInit_VTable 
444 {   // *** IUnknown methods ***
445     STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID * ppvObj) PURE;
446     STDMETHOD_(ULONG,AddRef) (THIS)  PURE;
447     STDMETHOD_(ULONG,Release) (THIS) PURE;
448
449     // *** IShellExtInit methods ***
450     STDMETHOD(Initialize)(THIS_ LPCITEMIDLIST pidlFolder, LPDATAOBJECT lpdobj, HKEY hkeyProgID) PURE;
451 } IShellExtInit_VTable,*LPSHELLEXTINIT_VTABLE;
452
453 struct tagSHELLEXTINIT
454 { LPSHELLEXTINIT_VTABLE lpvtbl;
455   DWORD                  ref;
456 };
457
458 #undef THIS
459
460 /*****************************************************************************
461  * IEnumIDList interface
462  */
463 #define THIS LPENUMIDLIST this
464
465 typedef struct tagENUMLIST
466 { struct tagENUMLIST    *pNext;
467   LPITEMIDLIST pidl;
468 } ENUMLIST, *LPENUMLIST;
469
470 typedef struct IEnumIDList_VTable 
471 {    /* *** IUnknown methods *** */
472     STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID * ppvObj) PURE;
473     STDMETHOD_(ULONG,AddRef) (THIS)  PURE;
474     STDMETHOD_(ULONG,Release) (THIS) PURE;
475
476     /* *** IEnumIDList methods *** */
477     STDMETHOD(Next)  (THIS_ ULONG celt,
478                       LPITEMIDLIST *rgelt,
479                       ULONG *pceltFetched) PURE;
480     STDMETHOD(Skip)  (THIS_ ULONG celt) PURE;
481     STDMETHOD(Reset) (THIS) PURE;
482     STDMETHOD(Clone) (THIS_ IEnumIDList **ppenum) PURE;
483                 /* *** private methods *** */
484     STDMETHOD_(BOOL32,CreateEnumList)(THIS_ LPCSTR, DWORD) PURE;
485     STDMETHOD_(BOOL32,AddToEnumList)(THIS_ LPITEMIDLIST) PURE;
486     STDMETHOD_(BOOL32,DeleteList)(THIS) PURE;
487
488                 
489 } IEnumIDList_VTable,*LPENUMIDLIST_VTABLE;
490
491 struct tagENUMIDLIST
492 { LPENUMIDLIST_VTABLE   lpvtbl;
493   DWORD          ref;
494   LPENUMLIST mpFirst;
495   LPENUMLIST mpLast;
496   LPENUMLIST mpCurrent;
497 };
498
499 #undef THIS
500 //--------------------------------------------------------------------------
501 //
502 // FOLDERSETTINGS
503 //
504 //  FOLDERSETTINGS is a data structure that explorer passes from one folder
505 // view to another, when the user is browsing. It calls ISV::GetCurrentInfo
506 // member to get the current settings and pass it to ISV::CreateViewWindow
507 // to allow the next folder view "inherit" it. These settings assumes a
508 // particular UI (which the shell's folder view has), and shell extensions
509 // may or may not use those settings.
510 //
511 //--------------------------------------------------------------------------
512
513 typedef LPBYTE LPVIEWSETTINGS;
514
515 // NB Bitfields.
516 // FWF_DESKTOP implies FWF_TRANSPARENT/NOCLIENTEDGE/NOSCROLL
517 typedef enum
518 { FWF_AUTOARRANGE =       0x0001,
519   FWF_ABBREVIATEDNAMES =  0x0002,
520   FWF_SNAPTOGRID =        0x0004,
521   FWF_OWNERDATA =         0x0008,
522   FWF_BESTFITWINDOW =     0x0010,
523   FWF_DESKTOP =           0x0020,
524   FWF_SINGLESEL =         0x0040,
525   FWF_NOSUBFOLDERS =      0x0080,
526   FWF_TRANSPARENT  =      0x0100,
527   FWF_NOCLIENTEDGE =      0x0200,
528   FWF_NOSCROLL     =      0x0400,
529   FWF_ALIGNLEFT    =      0x0800,
530   FWF_SINGLECLICKACTIVATE=0x8000  // TEMPORARY -- NO UI FOR THIS
531 } FOLDERFLAGS;
532
533 typedef enum
534 { FVM_ICON =              1,
535   FVM_SMALLICON =         2,
536   FVM_LIST =              3,
537   FVM_DETAILS =           4,
538 } FOLDERVIEWMODE;
539
540 typedef struct
541 { UINT32 ViewMode;       // View mode (FOLDERVIEWMODE values)
542   UINT32 fFlags;         // View options (FOLDERFLAGS bits)
543 } FOLDERSETTINGS, *LPFOLDERSETTINGS;
544
545 typedef const FOLDERSETTINGS * LPCFOLDERSETTINGS;
546
547 /* FIXME; the next two lines are propersheet related, move to prsht.h when created */
548 struct _PSP;
549 typedef struct _PSP FAR* HPROPSHEETPAGE;
550
551 typedef BOOL32 (CALLBACK FAR * LPFNADDPROPSHEETPAGE)(HPROPSHEETPAGE, LPARAM);
552 typedef BOOL32 (CALLBACK FAR * LPFNADDPROPSHEETPAGES)(LPVOID, LPFNADDPROPSHEETPAGE,LPARAM);
553
554 /************************************************************************
555  * IShellFolder interface
556  */
557
558 #define THIS LPSHELLFOLDER this
559
560 /* IShellFolder::GetDisplayNameOf/SetNameOf uFlags */
561 typedef enum
562 { SHGDN_NORMAL            = 0,        /* default (display purpose) */
563   SHGDN_INFOLDER          = 1,        /* displayed under a folder (relative)*/
564   SHGDN_FORPARSING        = 0x8000    /* for ParseDisplayName or path */
565 } SHGNO;
566
567 /* IShellFolder::EnumObjects */
568 typedef enum tagSHCONTF
569 { SHCONTF_FOLDERS         = 32,       /* for shell browser */
570   SHCONTF_NONFOLDERS      = 64,       /* for default view */
571   SHCONTF_INCLUDEHIDDEN   = 128       /* for hidden/system objects */
572 } SHCONTF;
573
574 /* from oleidl.h */
575 #define DROPEFFECT_NONE         0
576 #define DROPEFFECT_COPY         1
577 #define DROPEFFECT_MOVE         2
578 #define DROPEFFECT_LINK         4
579 #define DROPEFFECT_SCROLL       0x80000000
580
581 /* IShellFolder::GetAttributesOf flags */
582 #define SFGAO_CANCOPY           DROPEFFECT_COPY /* Objects can be copied */
583 #define SFGAO_CANMOVE           DROPEFFECT_MOVE /* Objects can be moved */
584 #define SFGAO_CANLINK           DROPEFFECT_LINK /* Objects can be linked */
585 #define SFGAO_CANRENAME         0x00000010L     /* Objects can be renamed */
586 #define SFGAO_CANDELETE         0x00000020L     /* Objects can be deleted */
587 #define SFGAO_HASPROPSHEET      0x00000040L     /* Objects have property sheets */
588 #define SFGAO_DROPTARGET        0x00000100L     /* Objects are drop target */
589 #define SFGAO_CAPABILITYMASK    0x00000177L
590 #define SFGAO_LINK              0x00010000L     /* Shortcut (link) */
591 #define SFGAO_SHARE             0x00020000L     /* shared */
592 #define SFGAO_READONLY          0x00040000L     /* read-only */
593 #define SFGAO_GHOSTED           0x00080000L     /* ghosted icon */
594 #define SFGAO_DISPLAYATTRMASK   0x000F0000L
595 #define SFGAO_FILESYSANCESTOR   0x10000000L     /* It contains file system folder */
596 #define SFGAO_FOLDER            0x20000000L     /* It's a folder. */
597 #define SFGAO_FILESYSTEM        0x40000000L     /* is a file system thing (file/folder/root) */
598 #define SFGAO_HASSUBFOLDER      0x80000000L     /* Expandable in the map pane */
599 #define SFGAO_CONTENTSMASK      0x80000000L
600 #define SFGAO_VALIDATE          0x01000000L     /* invalidate cached information */
601 #define SFGAO_REMOVABLE        0x02000000L      /* is this removeable media? */
602
603 typedef struct IShellFolder_VTable {
604     /* *** IUnknown methods *** */
605     STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID * ppvObj) PURE;
606     STDMETHOD_(ULONG,AddRef) (THIS)  PURE;
607     STDMETHOD_(ULONG,Release) (THIS) PURE;
608
609     /* *** IShellFolder methods *** */
610     STDMETHOD(ParseDisplayName) (THIS_ HWND32 hwndOwner,LPBC pbcReserved, LPOLESTR32 lpszDisplayName,ULONG * pchEaten, LPITEMIDLIST * ppidl, ULONG *pdwAttributes) PURE;
611     STDMETHOD(EnumObjects)( THIS_ HWND32 hwndOwner, DWORD grfFlags, LPENUMIDLIST * ppenumIDList) PURE;
612     STDMETHOD(BindToObject)(THIS_ LPCITEMIDLIST pidl, LPBC pbcReserved,REFIID riid, LPVOID * ppvOut) PURE;
613     STDMETHOD(BindToStorage)(THIS_ LPCITEMIDLIST pidl, LPBC pbcReserved,REFIID riid, LPVOID * ppvObj) PURE;
614     STDMETHOD(CompareIDs)(THIS_ LPARAM lParam, LPCITEMIDLIST pidl1, LPCITEMIDLIST pidl2) PURE;
615     STDMETHOD(CreateViewObject)(THIS_ HWND32 hwndOwner, REFIID riid, LPVOID * ppvOut) PURE;
616     STDMETHOD(GetAttributesOf)(THIS_ UINT32 cidl, LPCITEMIDLIST * apidl,ULONG * rgfInOut) PURE;
617     STDMETHOD(GetUIObjectOf)(THIS_ HWND32 hwndOwner, UINT32 cidl, LPCITEMIDLIST * apidl,REFIID riid, UINT32 * prgfInOut, LPVOID * ppvOut) PURE;
618     STDMETHOD(GetDisplayNameOf)(THIS_ LPCITEMIDLIST pidl, DWORD uFlags, LPSTRRET lpName) PURE;
619     STDMETHOD(SetNameOf)(THIS_ HWND32 hwndOwner, LPCITEMIDLIST pidl,LPCOLESTR32 lpszName, DWORD uFlags,LPITEMIDLIST * ppidlOut) PURE;
620
621         /* utility functions */
622    STDMETHOD_(BOOL32,GetFolderPath)(THIS_ LPSTR, DWORD);
623    
624 } *LPSHELLFOLDER_VTABLE,IShellFolder_VTable;
625
626 struct tagSHELLFOLDER {
627         LPSHELLFOLDER_VTABLE    lpvtbl;
628         DWORD                   ref;
629         LPSTR                   mlpszFolder;
630         LPITEMIDLIST    mpidl;
631         LPITEMIDLIST    mpidlNSRoot;
632         LPSHELLFOLDER   mpSFParent;
633 };
634
635 extern LPSHELLFOLDER pdesktopfolder;
636
637 /************************
638 * Shellfolder API
639 */
640 DWORD WINAPI SHGetDesktopFolder(LPSHELLFOLDER *);
641 #undef THIS
642
643 /************************************************************************
644 * IShellBrowser interface
645 */
646 #define THIS LPSHELLBROWSER this
647 /* targets for GetWindow/SendControlMsg */
648 #define FCW_STATUS              0x0001
649 #define FCW_TOOLBAR             0x0002
650 #define FCW_TREE                0x0003
651 #define FCW_INTERNETBAR         0x0006
652 #define FCW_PROGRESS            0x0008
653
654 /* wFlags for BrowseObject*/
655 #define SBSP_DEFBROWSER         0x0000
656 #define SBSP_SAMEBROWSER        0x0001
657 #define SBSP_NEWBROWSER         0x0002
658
659 #define SBSP_DEFMODE            0x0000
660 #define SBSP_OPENMODE           0x0010
661 #define SBSP_EXPLOREMODE        0x0020
662
663 #define SBSP_ABSOLUTE           0x0000
664 #define SBSP_RELATIVE           0x1000
665 #define SBSP_PARENT             0x2000
666 #define SBSP_NAVIGATEBACK       0x4000
667 #define SBSP_NAVIGATEFORWARD    0x8000
668
669 #define SBSP_ALLOW_AUTONAVIGATE         0x10000
670
671 #define SBSP_INITIATEDBYHLINKFRAME      0x80000000
672 #define SBSP_REDIRECT                   0x40000000
673 #define SBSP_WRITENOHISTORY             0x08000000
674
675 /* uFlage for SetToolbarItems */
676 #define FCT_MERGE       0x0001
677 #define FCT_CONFIGABLE  0x0002
678 #define FCT_ADDTOEND    0x0004
679  
680 typedef struct IShellBrowser_VTable 
681 {    // *** IUnknown methods ***
682     STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID * ppvObj) PURE;
683     STDMETHOD_(ULONG,AddRef) (THIS)  PURE;
684     STDMETHOD_(ULONG,Release) (THIS) PURE;
685
686     // *** IOleWindow methods ***
687     STDMETHOD(GetWindow) (THIS_ HWND32 * lphwnd) PURE;
688     STDMETHOD(ContextSensitiveHelp) (THIS_ BOOL32 fEnterMode) PURE;
689
690     // *** IShellBrowser methods *** (same as IOleInPlaceFrame)
691     STDMETHOD(InsertMenusSB) (THIS_ HMENU32 hmenuShared, LPOLEMENUGROUPWIDTHS32 lpMenuWidths) PURE;
692     STDMETHOD(SetMenuSB) (THIS_ HMENU32 hmenuShared, HOLEMENU32 holemenuReserved, HWND32 hwndActiveObject) PURE;
693     STDMETHOD(RemoveMenusSB) (THIS_ HMENU32 hmenuShared) PURE;
694     STDMETHOD(SetStatusTextSB) (THIS_ LPCOLESTR32 lpszStatusText) PURE;
695     STDMETHOD(EnableModelessSB) (THIS_ BOOL32 fEnable) PURE;
696     STDMETHOD(TranslateAcceleratorSB) (THIS_ LPMSG32 lpmsg, WORD wID) PURE;
697
698     // *** IShellBrowser methods ***
699     STDMETHOD(BrowseObject)(THIS_ LPCITEMIDLIST pidl, UINT32 wFlags) PURE;
700     STDMETHOD(GetViewStateStream)(THIS_ DWORD grfMode, LPSTREAM32  *ppStrm) PURE;
701     STDMETHOD(GetControlWindow)(THIS_ UINT32 id, HWND32 * lphwnd) PURE;
702     STDMETHOD(SendControlMsg)(THIS_ UINT32 id, UINT32 uMsg, WPARAM32 wParam, LPARAM lParam, LRESULT * pret) PURE;
703     STDMETHOD(QueryActiveShellView)(THIS_ IShellView ** ppshv) PURE;
704     STDMETHOD(OnViewWindowActive)(THIS_ IShellView * ppshv) PURE;
705     STDMETHOD(SetToolbarItems)(THIS_ LPTBBUTTON lpButtons, UINT32 nButtons, UINT32 uFlags) PURE;
706 } *LPSHELLBROWSER_VTABLE,IShellBrowser_VTable;;
707
708 struct tagSHELLBROWSER 
709 { LPSHELLBROWSER_VTABLE lpvtbl;
710   DWORD ref;
711 };
712
713 #undef THIS
714
715 /************************************************************************
716 * IShellView interface
717 */
718 #define THIS LPSHELLVIEW this
719
720 /* shellview select item flags*/
721 #define SVSI_DESELECT   0x0000
722 #define SVSI_SELECT     0x0001
723 #define SVSI_EDIT       0x0003  // includes select
724 #define SVSI_DESELECTOTHERS 0x0004
725 #define SVSI_ENSUREVISIBLE  0x0008
726 #define SVSI_FOCUSED        0x0010
727
728 /* shellview get item object flags */
729 #define SVGIO_BACKGROUND    0x00000000
730 #define SVGIO_SELECTION     0x00000001
731 #define SVGIO_ALLVIEW       0x00000002
732
733 /* The explorer dispatches WM_COMMAND messages based on the range of
734  command/menuitem IDs. All the IDs of menuitems that the view (right
735  pane) inserts must be in FCIDM_SHVIEWFIRST/LAST (otherwise, the explorer
736  won't dispatch them). The view should not deal with any menuitems
737  in FCIDM_BROWSERFIRST/LAST (otherwise, it won't work with the future
738  version of the shell).
739
740   FCIDM_SHVIEWFIRST/LAST      for the right pane (IShellView)
741   FCIDM_BROWSERFIRST/LAST     for the explorer frame (IShellBrowser)
742   FCIDM_GLOBAL/LAST           for the explorer's submenu IDs
743 */
744 #define FCIDM_SHVIEWFIRST           0x0000
745 #define FCIDM_SHVIEWLAST            0x7fff
746 #define FCIDM_BROWSERFIRST          0xa000
747 #define FCIDM_BROWSERLAST           0xbf00
748 #define FCIDM_GLOBALFIRST           0x8000
749 #define FCIDM_GLOBALLAST            0x9fff
750
751 /*
752 * Global submenu IDs and separator IDs
753 */
754 #define FCIDM_MENU_FILE             (FCIDM_GLOBALFIRST+0x0000)
755 #define FCIDM_MENU_EDIT             (FCIDM_GLOBALFIRST+0x0040)
756 #define FCIDM_MENU_VIEW             (FCIDM_GLOBALFIRST+0x0080)
757 #define FCIDM_MENU_VIEW_SEP_OPTIONS (FCIDM_GLOBALFIRST+0x0081)
758 #define FCIDM_MENU_TOOLS            (FCIDM_GLOBALFIRST+0x00c0)
759 #define FCIDM_MENU_TOOLS_SEP_GOTO   (FCIDM_GLOBALFIRST+0x00c1)
760 #define FCIDM_MENU_HELP             (FCIDM_GLOBALFIRST+0x0100)
761 #define FCIDM_MENU_FIND             (FCIDM_GLOBALFIRST+0x0140)
762 #define FCIDM_MENU_EXPLORE          (FCIDM_GLOBALFIRST+0x0150)
763 #define FCIDM_MENU_FAVORITES        (FCIDM_GLOBALFIRST+0x0170)
764
765 /* control IDs known to the view */
766 #define FCIDM_TOOLBAR      (FCIDM_BROWSERFIRST + 0)
767 #define FCIDM_STATUS       (FCIDM_BROWSERFIRST + 1)
768
769 /* uState values for IShellView::UIActivate */
770 typedef enum 
771 { SVUIA_DEACTIVATE       = 0,
772   SVUIA_ACTIVATE_NOFOCUS = 1,
773   SVUIA_ACTIVATE_FOCUS   = 2,
774   SVUIA_INPLACEACTIVATE  = 3          // new flag for IShellView2
775 } SVUIA_STATUS;
776
777
778
779 typedef struct IShellView_VTable
780 {   // *** IUnknown methods ***
781     STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID * ppvObj) PURE;
782     STDMETHOD_(ULONG,AddRef) (THIS)  PURE;
783     STDMETHOD_(ULONG,Release) (THIS) PURE;
784
785     // *** IOleWindow methods ***
786     STDMETHOD(GetWindow) (THIS_ HWND32 * lphwnd) PURE;
787     STDMETHOD(ContextSensitiveHelp) (THIS_ BOOL32 fEnterMode) PURE;
788
789     // *** IShellView methods ***
790     STDMETHOD(TranslateAccelerator) (THIS_ LPMSG32 lpmsg) PURE;
791     STDMETHOD(EnableModeless) (THIS_ BOOL32 fEnable) PURE;
792     STDMETHOD(UIActivate) (THIS_ UINT32 uState) PURE;
793     STDMETHOD(Refresh) (THIS) PURE;
794     STDMETHOD(CreateViewWindow)(THIS_ IShellView *lpPrevView,LPCFOLDERSETTINGS lpfs, IShellBrowser * psb,RECT32 * prcView, HWND32  *phWnd) PURE;
795     STDMETHOD(DestroyViewWindow)(THIS) PURE;
796     STDMETHOD(GetCurrentInfo)(THIS_ LPFOLDERSETTINGS lpfs) PURE;
797     STDMETHOD(AddPropertySheetPages)(THIS_ DWORD dwReserved,LPFNADDPROPSHEETPAGE lpfn, LPARAM lparam) PURE;
798     STDMETHOD(SaveViewState)(THIS) PURE;
799     STDMETHOD(SelectItem)(THIS_ LPCITEMIDLIST pidlItem, UINT32 uFlags) PURE;
800     STDMETHOD(GetItemObject)(THIS_ UINT32 uItem, REFIID riid,LPVOID *ppv) PURE;
801 } IShellView_VTable,*LPSHELLVIEW_VTABLE;
802
803 struct tagSHELLVIEW 
804 { LPSHELLVIEW_VTABLE lpvtbl;
805   DWORD         ref;
806   LPITEMIDLIST  mpidl;
807   LPSHELLFOLDER pSFParent;
808   LPSHELLBROWSER        pShellBrowser;
809   LPCOMMDLGBROWSER      pCommDlgBrowser;
810   HWND32        hWnd;
811   HWND32        hWndList;
812   HWND32        hWndParent;
813   FOLDERSETTINGS        FolderSettings;
814   HMENU32       hMenu;
815   UINT32        uState;
816   UINT32        uSelected;
817   LPITEMIDLIST  *aSelectedItems;
818 };
819
820 typedef GUID SHELLVIEWID;
821 #define SV_CLASS_NAME   ("SHELLDLL_DefView")
822
823 #undef THIS
824 /****************************************************************************
825  * ICommDlgBrowser interface
826  */
827 #define THIS LPCOMMDLGBROWSER this
828
829 /* for OnStateChange*/
830 #define CDBOSC_SETFOCUS     0x00000000
831 #define CDBOSC_KILLFOCUS    0x00000001
832 #define CDBOSC_SELCHANGE    0x00000002
833 #define CDBOSC_RENAME       0x00000003
834
835 typedef struct ICommDlgBrowser_VTable
836 {   /* IUnknown methods */
837     STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID * ppvObj) PURE;
838     STDMETHOD_(ULONG,AddRef) (THIS)  PURE;
839     STDMETHOD_(ULONG,Release) (THIS) PURE;
840
841     /* ICommDlgBrowser methods */
842     STDMETHOD(OnDefaultCommand) (THIS_  LPSHELLVIEW ppshv) PURE;
843     STDMETHOD(OnStateChange) (THIS_ LPSHELLVIEW ppshv, ULONG uChange) PURE;
844     STDMETHOD(IncludeObject) (THIS_ LPSHELLVIEW ppshv, LPCITEMIDLIST pidl) PURE;
845 } ICommDlgBrowser_VTable,*LPCOMMDLGBROWSER_VTABLE;
846
847 struct tagCOMMDLGBROWSER
848 { LPCOMMDLGBROWSER_VTABLE lpvtbl;
849   DWORD                      ref;
850 };
851 #undef THIS
852 /****************************************************************************
853  * IShellLink interface
854  */
855
856 #define THIS LPSHELLLINK this
857 /* IShellLink::Resolve fFlags */
858 typedef enum {
859     SLR_NO_UI           = 0x0001,
860     SLR_ANY_MATCH       = 0x0002,
861     SLR_UPDATE          = 0x0004
862 } SLR_FLAGS;
863
864 /* IShellLink::GetPath fFlags */
865 typedef enum {
866     SLGP_SHORTPATH      = 0x0001,
867     SLGP_UNCPRIORITY    = 0x0002
868 } SLGP_FLAGS;
869
870
871
872 typedef struct IShellLink IShellLink,*LPSHELLLINK;
873 typedef struct IShellLink_VTable
874 {
875     /* *** IUnknown methods *** */
876     STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID * ppvObj) PURE;
877     STDMETHOD_(ULONG,AddRef) (THIS)  PURE;
878     STDMETHOD_(ULONG,Release) (THIS) PURE;
879
880     STDMETHOD(GetPath)(THIS_ LPSTR pszFile,INT32 cchMaxPath, WIN32_FIND_DATA32A *pfd, DWORD fFlags) PURE;
881
882     STDMETHOD(GetIDList)(THIS_ LPITEMIDLIST * ppidl) PURE;
883     STDMETHOD(SetIDList)(THIS_ LPCITEMIDLIST pidl) PURE;
884
885     STDMETHOD(GetDescription)(THIS_ LPSTR pszName,INT32 cchMaxName) PURE;
886     STDMETHOD(SetDescription)(THIS_ LPCSTR pszName) PURE;
887
888     STDMETHOD(GetWorkingDirectory)(THIS_ LPSTR pszDir,INT32 cchMaxPath) PURE;
889     STDMETHOD(SetWorkingDirectory)(THIS_ LPCSTR pszDir) PURE;
890
891     STDMETHOD(GetArguments)(THIS_ LPSTR pszArgs,INT32 cchMaxPath) PURE;
892     STDMETHOD(SetArguments)(THIS_ LPCSTR pszArgs) PURE;
893
894     STDMETHOD(GetHotkey)(THIS_ WORD *pwHotkey) PURE;
895     STDMETHOD(SetHotkey)(THIS_ WORD wHotkey) PURE;
896
897     STDMETHOD(GetShowCmd)(THIS_ INT32 *piShowCmd) PURE;
898     STDMETHOD(SetShowCmd)(THIS_ INT32 iShowCmd) PURE;
899
900     STDMETHOD(GetIconLocation)(THIS_ LPSTR pszIconPath,INT32 cchIconPath,INT32 *piIcon) PURE;
901     STDMETHOD(SetIconLocation)(THIS_ LPCSTR pszIconPath,INT32 iIcon) PURE;
902
903     STDMETHOD(SetRelativePath)(THIS_ LPCSTR pszPathRel, DWORD dwReserved) PURE;
904
905     STDMETHOD(Resolve)(THIS_ HWND32 hwnd, DWORD fFlags) PURE;
906
907     STDMETHOD(SetPath)(THIS_ LPCSTR pszFile) PURE;
908 } IShellLink_VTable,*LPSHELLLINK_VTABLE;
909
910 struct IShellLink {
911         LPSHELLLINK_VTABLE      lpvtbl;
912         DWORD                   ref;
913 };
914
915 #undef THIS
916
917 /****************************************************************************
918  * IExtractIconinterface
919  *
920  * FIXME
921  *  Is the ExtractIconA interface
922  */
923 #define THIS LPEXTRACTICON this
924
925 /* GetIconLocation() input flags*/
926 #define GIL_OPENICON     0x0001      // allows containers to specify an "open" look
927 #define GIL_FORSHELL     0x0002      // icon is to be displayed in a ShellFolder
928 #define GIL_ASYNC        0x0020      // this is an async extract, return E_ASYNC
929
930 /* GetIconLocation() return flags */
931 #define GIL_SIMULATEDOC  0x0001      // simulate this document icon for this
932 #define GIL_PERINSTANCE  0x0002      // icons from this class are per instance (each file has its own)
933 #define GIL_PERCLASS     0x0004      // icons from this class per class (shared for all files of this type)
934 #define GIL_NOTFILENAME  0x0008      // location is not a filename, must call ::ExtractIcon
935 #define GIL_DONTCACHE    0x0010      // this icon should not be cached
936
937 typedef struct IExtractIcon IExtractIcon,*LPEXTRACTICON;
938 typedef struct IExtractIcon_VTable
939 { /*** IUnknown methods ***/
940   STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID * ppvObj) PURE;
941   STDMETHOD_(ULONG,AddRef) (THIS)  PURE;
942   STDMETHOD_(ULONG,Release) (THIS) PURE;
943
944   /*** IExtractIcon methods ***/
945   STDMETHOD(GetIconLocation)(THIS_ UINT32 uFlags, LPSTR szIconFile, UINT32 cchMax,INT32 * piIndex, UINT32 * pwFlags) PURE;
946   STDMETHOD(Extract)(THIS_ LPCSTR pszFile, UINT32 nIconIndex, HICON32 *phiconLarge, HICON32 *phiconSmall, UINT32 nIconSize) PURE;
947 }IExtractIcon_VTable,*LPEXTRACTICON_VTABLE;
948
949 struct IExtractIcon 
950 { LPEXTRACTICON_VTABLE lpvtbl;
951   DWORD ref;
952   LPITEMIDLIST pidl;
953 };
954
955 #undef THIS
956 /****************************************************************************
957  * IShellIcon interface
958  */
959
960 #define THIS LPSHELLICON this
961
962 typedef struct IShellIcon_VTable
963 { /*** IUnknown methods ***/
964   STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID * ppvObj) PURE;
965   STDMETHOD_(ULONG,AddRef) (THIS)  PURE;
966   STDMETHOD_(ULONG,Release) (THIS) PURE;
967
968   /*** IShellIcon methods ***/
969   STDMETHOD(GetIconOf)(THIS_ LPCITEMIDLIST pidl, UINT32 flags, LPINT32 lpIconIndex) PURE;
970 } IShellIcon_VTable,*LPSHELLICON_VTABLE;
971
972 struct tagSHELLICON
973 { LPSHELLICON_VTABLE lpvtbl;
974   DWORD ref;
975 };
976 #undef THIS
977 /****************************************************************************
978  * IDockingWindowFrame interface
979  */
980 #define THIS LPDOCKINGWINDOWFRAME this
981
982 #define DWFRF_NORMAL            0x0000  /* femove toolbar flags*/
983 #define DWFRF_DELETECONFIGDATA  0x0001
984 #define DWFAF_HIDDEN            0x0001   /* add tolbar*/
985
986 typedef struct IDockingWindowFrame_VTable
987 {   STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID * ppvObj) PURE;
988     STDMETHOD_(ULONG,AddRef) (THIS)  PURE;
989     STDMETHOD_(ULONG,Release) (THIS) PURE;
990
991     /*** IOleWindow methods ***/
992     STDMETHOD(GetWindow) (THIS_ HWND32 * lphwnd) PURE;
993     STDMETHOD(ContextSensitiveHelp) (THIS_ BOOL32 fEnterMode) PURE;
994
995     /*** IDockingWindowFrame methods ***/
996     STDMETHOD(AddToolbar) (THIS_ IUnknown* punkSrc, LPCWSTR pwszItem, DWORD dwAddFlags) PURE;
997     STDMETHOD(RemoveToolbar) (THIS_ IUnknown* punkSrc, DWORD dwRemoveFlags) PURE;
998     STDMETHOD(FindToolbar) (THIS_ LPCWSTR pwszItem, REFIID riid, LPVOID* ppvObj) PURE;
999 } IDockingWindowFrame_VTable, *LPDOCKINGWINDOWFRAME_VTABLE;
1000
1001 struct tagDOCKINGWINDOWFRAME
1002 { LPDOCKINGWINDOWFRAME_VTABLE lpvtbl;
1003   DWORD ref;
1004 };
1005
1006 #undef THIS
1007 /****************************************************************************
1008  * IServiceProvider interface
1009  */
1010 #define THIS LPSERVICEPROVIDER this
1011
1012 typedef struct IServiceProvider_VTable
1013 {       /*** IUnknown methods ***/
1014         STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID * ppvObj) PURE;
1015         STDMETHOD_(ULONG,AddRef) (THIS)  PURE;
1016         STDMETHOD_(ULONG,Release) (THIS) PURE;
1017
1018         STDMETHOD(QueryService)(THIS_ REFGUID guidService, REFIID riid, void **ppvObject);
1019 } IServiceProvider_VTable, *LPSERVICEPROVIDER_VTABLE;
1020
1021 struct tagSERVICEPROVIDER
1022 {       LPSERVICEPROVIDER_VTABLE lpvtbl;
1023         DWORD ref;
1024 };           
1025 /****************************************************************************
1026  * Class constructors
1027  */
1028 #ifdef __WINE__
1029 extern LPDATAOBJECT     IDataObject_Constructor();
1030 extern LPENUMFORMATETC  IEnumFORMATETC_Constructor(UINT32, const FORMATETC32 []);
1031
1032 extern LPCLASSFACTORY   IClassFactory_Constructor();
1033 extern LPCONTEXTMENU    IContextMenu_Constructor(LPSHELLFOLDER, LPCITEMIDLIST *, UINT32);
1034 extern LPSHELLFOLDER    IShellFolder_Constructor(LPSHELLFOLDER,LPITEMIDLIST);
1035 extern LPSHELLVIEW      IShellView_Constructor(LPSHELLFOLDER, LPCITEMIDLIST);
1036 extern LPSHELLLINK      IShellLink_Constructor();
1037 extern LPENUMIDLIST     IEnumIDList_Constructor(LPCSTR,DWORD);
1038 extern LPEXTRACTICON    IExtractIcon_Constructor(LPITEMIDLIST);
1039 #endif
1040 /****************************************************************************
1041  * Shell Execute API
1042  */
1043 #define SE_ERR_FNF              2       // file not found
1044 #define SE_ERR_PNF              3       // path not found
1045 #define SE_ERR_ACCESSDENIED     5       // access denied
1046 #define SE_ERR_OOM              8       // out of memory
1047 #define SE_ERR_DLLNOTFOUND      32
1048 #define SE_ERR_SHARE                    26
1049 #define SE_ERR_ASSOCINCOMPLETE          27
1050 #define SE_ERR_DDETIMEOUT               28
1051 #define SE_ERR_DDEFAIL                  29
1052 #define SE_ERR_DDEBUSY                  30
1053 #define SE_ERR_NOASSOC                  31
1054
1055 #define SEE_MASK_CLASSNAME        0x00000001
1056 #define SEE_MASK_CLASSKEY         0x00000003
1057 #define SEE_MASK_IDLIST           0x00000004
1058 #define SEE_MASK_INVOKEIDLIST     0x0000000c
1059 #define SEE_MASK_ICON             0x00000010
1060 #define SEE_MASK_HOTKEY           0x00000020
1061 #define SEE_MASK_NOCLOSEPROCESS   0x00000040
1062 #define SEE_MASK_CONNECTNETDRV    0x00000080
1063 #define SEE_MASK_FLAG_DDEWAIT     0x00000100
1064 #define SEE_MASK_DOENVSUBST       0x00000200
1065 #define SEE_MASK_FLAG_NO_UI       0x00000400
1066 #define SEE_MASK_UNICODE          0x00004000
1067 #define SEE_MASK_NO_CONSOLE       0x00008000
1068 #define SEE_MASK_ASYNCOK          0x00100000
1069 #define SEE_MASK_HMONITOR         0x00200000
1070
1071 typedef struct _SHELLEXECUTEINFOA
1072 {       DWORD cbSize;
1073         ULONG fMask;
1074         HWND32 hwnd;
1075         LPCSTR   lpVerb;
1076         LPCSTR   lpFile;
1077         LPCSTR   lpParameters;
1078         LPCSTR   lpDirectory;
1079        INT32 nShow;
1080         HINSTANCE32 hInstApp;
1081         /* Optional fields */
1082         LPVOID lpIDList;
1083         LPCSTR   lpClass;
1084         HKEY hkeyClass;
1085         DWORD dwHotKey;
1086         union 
1087         { HANDLE32 hIcon;
1088           HANDLE32 hMonitor;
1089         } u;
1090         HANDLE32 hProcess;
1091 } SHELLEXECUTEINFO32A, *LPSHELLEXECUTEINFO32A;
1092
1093 typedef struct _SHELLEXECUTEINFOW
1094 {       DWORD cbSize;
1095         ULONG fMask;
1096         HWND32 hwnd;
1097         LPCWSTR  lpVerb;
1098         LPCWSTR  lpFile;
1099         LPCWSTR  lpParameters;
1100         LPCWSTR  lpDirectory;
1101        INT32 nShow;
1102         HINSTANCE32 hInstApp;
1103         /* Optional fields*/
1104         LPVOID lpIDList;
1105         LPCWSTR  lpClass;
1106         HKEY hkeyClass;
1107         DWORD dwHotKey;
1108         union
1109         { HANDLE32 hIcon;
1110           HANDLE32 hMonitor;
1111         } u;
1112         HANDLE32 hProcess;
1113 } SHELLEXECUTEINFO32W, *LPSHELLEXECUTEINFO32W;
1114
1115 #define SHELLEXECUTEINFO   WINELIB_NAME_AW(SHELLEXECUTEINFO)
1116 #define LPSHELLEXECUTEINFO WINELIB_NAME_AW(LPSHELLEXECUTEINFO)
1117
1118 BOOL32 WINAPI ShellExecuteEx32A(LPSHELLEXECUTEINFO32A lpExecInfo);
1119 BOOL32 WINAPI ShellExecuteEx32W(LPSHELLEXECUTEINFO32W lpExecInfo);
1120 #define ShellExecuteEx  WINELIB_NAME_AW(ShellExecuteEx)
1121
1122 void WINAPI WinExecError32A(HWND32 hwnd,INT32 error, LPCSTR lpstrFileName, LPCSTR lpstrTitle);
1123 void WINAPI WinExecError32W(HWND32 hwnd,INT32 error, LPCWSTR lpstrFileName, LPCWSTR lpstrTitle);
1124 #define WinExecError  WINELIB_NAME_AW(WinExecError)
1125
1126
1127
1128 /****************************************************************************
1129  * SHBrowseForFolder API
1130  */
1131 typedef INT32 (CALLBACK* BFFCALLBACK)(HWND32 hwnd, UINT32 uMsg, LPARAM lParam, LPARAM lpData);
1132
1133 typedef struct tagBROWSEINFO32A {
1134     HWND32        hwndOwner;
1135     LPCITEMIDLIST pidlRoot;
1136     LPSTR         pszDisplayName;
1137     LPCSTR        lpszTitle;
1138     UINT32        ulFlags;
1139     BFFCALLBACK   lpfn;
1140     LPARAM        lParam;
1141         INT32         iImage;
1142 } BROWSEINFO32A, *PBROWSEINFO32A, *LPBROWSEINFO32A;
1143
1144 typedef struct tagBROWSEINFO32W {
1145     HWND32        hwndOwner;
1146     LPCITEMIDLIST pidlRoot;
1147     LPWSTR        pszDisplayName;
1148     LPCWSTR       lpszTitle;
1149     UINT32        ulFlags;
1150     BFFCALLBACK   lpfn;
1151     LPARAM        lParam;
1152         INT32         iImage;
1153 } BROWSEINFO32W, *PBROWSEINFO32W, *LPBROWSEINFO32W; 
1154
1155 #define BROWSEINFO   WINELIB_NAME_AW(BROWSEINFO)
1156 #define PBROWSEINFO  WINELIB_NAME_AW(PBROWSEINFO)
1157 #define LPBROWSEINFO WINELIB_NAME_AW(LPBROWSEINFO)
1158
1159 // Browsing for directory.
1160 #define BIF_RETURNONLYFSDIRS   0x0001
1161 #define BIF_DONTGOBELOWDOMAIN  0x0002
1162 #define BIF_STATUSTEXT         0x0004
1163 #define BIF_RETURNFSANCESTORS  0x0008
1164 #define BIF_EDITBOX            0x0010
1165 #define BIF_VALIDATE           0x0020
1166  
1167 #define BIF_BROWSEFORCOMPUTER  0x1000
1168 #define BIF_BROWSEFORPRINTER   0x2000
1169 #define BIF_BROWSEINCLUDEFILES 0x4000
1170
1171 // message from browser
1172 #define BFFM_INITIALIZED        1
1173 #define BFFM_SELCHANGED         2
1174 #define BFFM_VALIDATEFAILEDA    3   // lParam:szPath ret:1(cont),0(EndDialog)
1175 #define BFFM_VALIDATEFAILEDW    4   // lParam:wzPath ret:1(cont),0(EndDialog)
1176
1177 // messages to browser
1178 #define BFFM_SETSTATUSTEXTA     (WM_USER+100)
1179 #define BFFM_ENABLEOK           (WM_USER+101)
1180 #define BFFM_SETSELECTIONA      (WM_USER+102)
1181 #define BFFM_SETSELECTIONW      (WM_USER+103)
1182 #define BFFM_SETSTATUSTEXTW     (WM_USER+104)
1183
1184 /*
1185 #ifdef UNICODE
1186 #define SHBrowseForFolder   SHBrowseForFolderW
1187 #define BFFM_SETSTATUSTEXT  BFFM_SETSTATUSTEXTW
1188 #define BFFM_SETSELECTION   BFFM_SETSELECTIONW
1189
1190 #define BFFM_VALIDATEFAILED BFFM_VALIDATEFAILEDW
1191 #else
1192 #define SHBrowseForFolder   SHBrowseForFolderA
1193 #define BFFM_SETSTATUSTEXT  BFFM_SETSTATUSTEXTA
1194 #define BFFM_SETSELECTION   BFFM_SETSELECTIONA
1195
1196 #define BFFM_VALIDATEFAILED BFFM_VALIDATEFAILEDA 
1197 #endif 
1198 */
1199
1200 LPITEMIDLIST WINAPI SHBrowseForFolder32A(LPBROWSEINFO32A lpbi);
1201 /*LPITEMIDLIST WINAPI SHBrowseForFolder32W(LPBROWSEINFO32W lpbi);*/
1202 #define  SHBrowseForFolder WINELIB_NAME_AW(SHBrowseForFolder)
1203
1204 /****************************************************************************
1205 * shlview structures
1206 */
1207
1208 /*
1209 * IShellFolderViewCallback Callback
1210 *  This "callback" is called by the shells default IShellView implementation (that
1211 *  we got using SHCreateShellViewEx()), to notify us of the various things that
1212 *  are happening to the shellview (and ask for things too).
1213 *
1214 *  You don't have to support anything here - anything you don't want to 
1215 *  handle, the shell will do itself if you just return E_NOTIMPL. This parameters
1216 *  that the shell passes to this function are entirely undocumented.
1217 *
1218 *  HOWEVER, as the cabview sample as originally written used this callback, the
1219 *  writers implemented the callback mechanism on top of their own IShellView.
1220 *  Look there for some clues on what to do here.
1221 */
1222
1223 typedef HRESULT(CALLBACK *SHELLVIEWPROC)(DWORD dwUserParam,LPSHELLFOLDER psf,
1224                          HWND32 hwnd,UINT32 uMsg,UINT32 wParam,LPARAM lParam);
1225
1226 /* NF valid values for the "viewmode" item of the SHELLTEMPLATE*/
1227 #define NF_INHERITVIEW    0x0000
1228 #define NF_LOCALVIEW        0x0001
1229
1230 typedef struct _SHELLVIEWDATA   // idl
1231 { DWORD           dwSize;
1232   LPSHELLFOLDER   pShellFolder;
1233   DWORD           dwUserParam;
1234   LPCITEMIDLIST   pidl;
1235   DWORD           v3;        // always 0
1236   SHELLVIEWPROC   pCallBack;
1237   DWORD           viewmode;  // NF_* enum
1238 } SHELLVIEWDATA, * LPSHELLVIEWDATA;
1239
1240 /*
1241  The shell keeps track of some per-user state to handle display
1242  options that is of majorinterest to ISVs.
1243  The key one requested right now is "DoubleClickInWebView".
1244 */
1245 typedef struct 
1246 {   BOOL32 fShowAllObjects : 1;
1247     BOOL32 fShowExtensions : 1;
1248     BOOL32 fNoConfirmRecycle : 1;
1249     BOOL32 fShowSysFiles : 1;
1250     BOOL32 fShowCompColor : 1;
1251     BOOL32 fDoubleClickInWebView : 1;
1252     BOOL32 fDesktopHTML : 1;
1253     BOOL32 fWin95Classic : 1;
1254     BOOL32 fDontPrettyPath : 1;
1255     BOOL32 fShowAttribCol : 1;
1256     BOOL32 fMapNetDrvBtn : 1;
1257     BOOL32 fShowInfoTip : 1;
1258     BOOL32 fHideIcons : 1;
1259     UINT32 fRestFlags : 3;
1260 } SHELLFLAGSTATE, * LPSHELLFLAGSTATE;
1261
1262
1263 #undef PURE
1264 #undef FAR
1265 #undef THIS
1266 #undef THIS_
1267 #undef STDMETHOD
1268 #undef STDMETHOD_
1269 #endif /*_WINE_SHLOBJ_H*/