include/shlobj.h

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