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