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