git.oblomov.eu Git - wine/blob - include/shobjidl.idl

   1 /*
   2  * COM interfaces for shell objects
   3  *
   4  * Copyright (C) 1999 Juergen Schmied
   5  * Copyright (C) 2003 Alexandre Julliard
   6  *
   7  * This library is free software; you can redistribute it and/or
   8  * modify it under the terms of the GNU Lesser General Public
   9  * License as published by the Free Software Foundation; either
  10  * version 2.1 of the License, or (at your option) any later version.
  11  *
  12  * This library is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15  * Lesser General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU Lesser General Public
  18  * License along with this library; if not, write to the Free Software
  19  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
  20  */
  21
  22 import "objidl.idl";
  23 import "oleidl.idl";
  24 import "oaidl.idl";
  25 import "docobj.idl";
  26 import "shtypes.idl";
  27 import "servprov.idl";
  28 import "comcat.idl";
  29 import "propidl.idl";
  30 /* FIXME: import "prsht.idl";*/
  31 import "msxml.idl";
  32 import "wtypes.idl";
  33 import "propsys.idl";
  34 /* FIXME: import "structuredquery.idl"; */
  35
  36 cpp_quote("/* FIXME: #include <sherrors.h> */")
  37
  38
  39 /*****************************************************************************
  40  * IPersistFolder interface
  41  */
  42 [
  43     object,
  44     uuid(000214ea-0000-0000-c000-000000000046),
  45     pointer_default(unique)
  46 ]
  47 interface IPersistFolder : IPersist
  48 {
  49     typedef IPersistFolder *LPPERSISTFOLDER;
  50
  51     HRESULT Initialize( [in] LPCITEMIDLIST pidl );
  52 }
  53
  54
  55 /*****************************************************************************
  56  * IPersistFolder2 interface
  57  */
  58 [
  59     object,
  60     uuid(1ac3d9f0-175c-11d1-95be-00609797ea4f),
  61     pointer_default(unique)
  62 ]
  63 interface IPersistFolder2 : IPersistFolder
  64 {
  65     typedef IPersistFolder2 *LPPERSISTFOLDER2;
  66
  67     HRESULT GetCurFolder( [out] LPITEMIDLIST *ppidl );
  68 }
  69
  70
  71 /*****************************************************************************
  72  * IPersistIDList interface
  73  */
  74 [
  75     object,
  76     uuid(1079acfc-29bd-11d3-8e0d-00c04f6837d5),
  77     pointer_default(unique)
  78 ]
  79 interface IPersistIDList : IPersist
  80 {
  81     HRESULT SetIDList( [in] LPCITEMIDLIST pidl );
  82     HRESULT GetIDList( [out] LPITEMIDLIST *ppidl );
  83 }
  84
  85
  86 /*****************************************************************************
  87  * IEnumIDList interface
  88  */
  89 [
  90     object,
  91     uuid(000214f2-0000-0000-c000-000000000046),
  92     pointer_default(unique)
  93 ]
  94 interface IEnumIDList : IUnknown
  95 {
  96     typedef IEnumIDList *LPENUMIDLIST;
  97
  98     HRESULT Next(
  99         [in] ULONG celt,
 100         [out, size_is(celt), length_is(*pceltFetched)] LPITEMIDLIST *rgelt,
 101         [out] ULONG *pceltFetched);
 102
 103     HRESULT Skip( [in] ULONG celt );
 104     HRESULT Reset();
 105     HRESULT Clone( [out] IEnumIDList **ppenum );
 106 }
 107
 108 /*****************************************************************************
 109  * IShellPropSheetExt interface
 110  */
 111 cpp_quote("#if 0")
 112     typedef LPARAM LPFNSVADDPROPSHEETPAGE;
 113 cpp_quote("#else")
 114 cpp_quote("#include <prsht.h>")
 115 cpp_quote("typedef LPFNADDPROPSHEETPAGE LPFNSVADDPROPSHEETPAGE;")
 116 cpp_quote("#endif")
 117
 118 [
 119     object,
 120     uuid(000214E9-0000-0000-C000-000000000046),
 121     pointer_default(unique),
 122     local
 123 ]
 124 interface IShellPropSheetExt : IUnknown
 125 {
 126     enum tagSHELLPROPSHEETEXTPAGEID {
 127         EXPPS_FILETYPES = 0x1
 128     };
 129
 130     typedef UINT EXPPS;
 131
 132     HRESULT AddPages(
 133         [in] LPFNSVADDPROPSHEETPAGE pfnAddPage,
 134         [in] LPARAM lParam);
 135     HRESULT ReplacePage(
 136         [in] EXPPS uPageID,
 137         [in] LPFNSVADDPROPSHEETPAGE pfnReplaceWith,
 138         [in] LPARAM lParam);
 139 }
 140 typedef IShellPropSheetExt *LPSHELLPROPSHEETEXT;
 141
 142 /*****************************************************************************
 143  * IShellFolder interface
 144  */
 145 [
 146     object,
 147     uuid(000214e6-0000-0000-c000-000000000046),
 148     pointer_default(unique)
 149 ]
 150 interface IShellFolder : IUnknown
 151 {
 152     typedef IShellFolder * LPSHELLFOLDER;
 153
 154     typedef enum tagSHGDN
 155     {
 156         SHGDN_NORMAL = 0,
 157         SHGDN_INFOLDER = 1,
 158         SHGDN_FOREDITING = 0x1000,
 159         SHGDN_INCLUDE_NONFILESYS = 0x2000,
 160         SHGDN_FORADDRESSBAR = 0x4000,
 161         SHGDN_FORPARSING = 0x8000
 162     } SHGNO;
 163
 164     typedef DWORD SHGDNF;
 165
 166     enum tagSHCONTF
 167     {
 168         SHCONTF_FOLDERS = 32,
 169         SHCONTF_NONFOLDERS = 64,
 170         SHCONTF_INCLUDEHIDDEN = 128,
 171         SHCONTF_INIT_ON_FIRST_NEXT = 256,
 172         SHCONTF_NETPRINTERSRCH = 512,
 173         SHCONTF_SHAREABLE = 1024,
 174         SHCONTF_STORAGE = 2048
 175     };
 176
 177     typedef DWORD SHCONTF;
 178
 179     cpp_quote("#define SFGAO_CANCOPY           DROPEFFECT_COPY")
 180     cpp_quote("#define SFGAO_CANMOVE           DROPEFFECT_MOVE")
 181     cpp_quote("#define SFGAO_CANLINK           DROPEFFECT_LINK")
 182     cpp_quote("#define SFGAO_STORAGE           0x00000008L")
 183     cpp_quote("#define SFGAO_CANRENAME         0x00000010L")
 184     cpp_quote("#define SFGAO_CANDELETE         0x00000020L")
 185     cpp_quote("#define SFGAO_HASPROPSHEET      0x00000040L")
 186     cpp_quote("#define SFGAO_DROPTARGET        0x00000100L")
 187     cpp_quote("#define SFGAO_CAPABILITYMASK    0x00000177L")
 188     cpp_quote("#define SFGAO_ENCRYPTED         0x00002000L")
 189     cpp_quote("#define SFGAO_ISSLOW            0x00004000L")
 190     cpp_quote("#define SFGAO_GHOSTED           0x00008000L")
 191     cpp_quote("#define SFGAO_LINK              0x00010000L")
 192     cpp_quote("#define SFGAO_SHARE             0x00020000L")
 193     cpp_quote("#define SFGAO_READONLY          0x00040000L")
 194     cpp_quote("#define SFGAO_HIDDEN            0x00080000L")
 195     cpp_quote("#define SFGAO_DISPLAYATTRMASK   0x000FC000L")
 196     cpp_quote("#define SFGAO_FILESYSANCESTOR   0x10000000L")
 197     cpp_quote("#define SFGAO_FOLDER            0x20000000L")
 198     cpp_quote("#define SFGAO_FILESYSTEM        0x40000000L")
 199     cpp_quote("#define SFGAO_HASSUBFOLDER      0x80000000L")
 200     cpp_quote("#define SFGAO_CONTENTSMASK      0x80000000L")
 201     cpp_quote("#define SFGAO_VALIDATE          0x01000000L")
 202     cpp_quote("#define SFGAO_REMOVABLE         0x02000000L")
 203     cpp_quote("#define SFGAO_COMPRESSED        0x04000000L")
 204     cpp_quote("#define SFGAO_BROWSABLE         0x08000000L")
 205     cpp_quote("#define SFGAO_NONENUMERATED     0x00100000L")
 206     cpp_quote("#define SFGAO_NEWCONTENT        0x00200000L")
 207     cpp_quote("#define SFGAO_STREAM            0x00400000L")
 208     cpp_quote("#define SFGAO_STORAGEANCESTOR   0x00800000L")
 209
 210     typedef ULONG SFGAOF;
 211
 212     HRESULT ParseDisplayName(
 213         [in] HWND hwndOwner,
 214         [in] LPBC pbcReserved,
 215         [in, string] LPOLESTR lpszDisplayName,
 216         [out] ULONG *pchEaten,
 217         [out] LPITEMIDLIST *ppidl,
 218         [in, out, unique] ULONG *pdwAttributes);
 219
 220     HRESULT EnumObjects(
 221         [in] HWND hwndOwner,
 222         [in] SHCONTF grfFlags,
 223         [out] IEnumIDList **ppenumIDList);
 224
 225     HRESULT BindToObject(
 226         [in] LPCITEMIDLIST pidl,
 227         [in] LPBC pbcReserved,
 228         [in] REFIID riid,
 229         [out, iid_is(riid)] void **ppvOut);
 230
 231     HRESULT BindToStorage(
 232         [in] LPCITEMIDLIST pidl,
 233         [in] LPBC pbcReserved,
 234         [in] REFIID riid,
 235         [out, iid_is(riid)] void **ppvObj);
 236
 237     HRESULT CompareIDs(
 238         [in] LPARAM lParam,
 239         [in] LPCITEMIDLIST pidl1,
 240         [in] LPCITEMIDLIST pidl2);
 241
 242     HRESULT CreateViewObject(
 243         [in] HWND hwndOwner,
 244         [in] REFIID riid,
 245         [out, iid_is(riid)] void **ppvOut);
 246
 247     HRESULT GetAttributesOf(
 248         [in] UINT cidl,
 249         [in, size_is(cidl)] LPCITEMIDLIST *apidl,
 250         [in, out] SFGAOF *rgfInOut);
 251
 252     HRESULT GetUIObjectOf(
 253         [in] HWND hwndOwner,
 254         [in] UINT cidl,
 255         [in, size_is(cidl)] LPCITEMIDLIST *apidl,
 256         [in] REFIID riid,
 257         [in, out, unique] UINT *prgfInOut,
 258         [out, iid_is(riid)] void **ppvOut);
 259
 260     HRESULT GetDisplayNameOf(
 261         [in] LPCITEMIDLIST pidl,
 262         [in] SHGDNF uFlags,
 263         [out] STRRET *lpName);
 264
 265     HRESULT SetNameOf(
 266         [in] HWND hwnd,
 267         [in] LPCITEMIDLIST pidl,
 268         [in, string] LPCOLESTR lpszName,
 269         [in] SHGDNF uFlags,
 270         [out] LPITEMIDLIST *ppidlOut);
 271 }
 272
 273
 274 /*****************************************************************************
 275  * IEnumExtraSearch interface
 276  */
 277 [
 278     object,
 279     uuid(0e700be1-9db6-11d1-a1ce-00c04fd75d13),
 280     pointer_default(unique)
 281 ]
 282 interface IEnumExtraSearch : IUnknown
 283 {
 284     typedef IEnumExtraSearch *LPENUMEXTRASEARCH;
 285
 286     typedef struct
 287     {
 288         GUID guidSearch;
 289         WCHAR wszFriendlyName[80];
 290         /*
 291          *WCHAR wszMenuText[80];
 292          *WCHAR wszHelpText[MAX_PATH];
 293          */
 294         WCHAR wszUrl[2084];
 295         /*
 296          *WCHAR wszIcon[MAX_PATH+10];
 297          *WCHAR wszGreyIcon[MAX_PATH+10];
 298          *WCHAR wszClrIcon[MAX_PATH+10];
 299          */
 300     } EXTRASEARCH, *LPEXTRASEARCH;
 301
 302     HRESULT Next(
 303         [in] ULONG celt,
 304         [out, size_is(celt), length_is(*pceltFetched)] EXTRASEARCH *rgelt,
 305         [out] ULONG *pceltFetched);
 306
 307     HRESULT Skip( [in] ULONG celt );
 308     HRESULT Reset();
 309     HRESULT Clone( [out] IEnumExtraSearch **ppenum );
 310 }
 311
 312
 313 /*****************************************************************************
 314  * IShellFolder2 interface
 315  */
 316 [
 317     object,
 318     uuid(93f2f68c-1d1b-11d3-a30e-00c04f79abd1),
 319     pointer_default(unique)
 320 ]
 321 interface IShellFolder2 : IShellFolder
 322 {
 323     typedef struct
 324     {
 325         GUID    fmtid;
 326         DWORD   pid;
 327     } SHCOLUMNID, *LPSHCOLUMNID;
 328     typedef const SHCOLUMNID *LPCSHCOLUMNID;
 329
 330     HRESULT GetDefaultSearchGUID( [out] GUID *lpguid );
 331     HRESULT EnumSearches( [out] IEnumExtraSearch **ppenum );
 332     HRESULT GetDefaultColumn( [in] DWORD dwReserved, [out] ULONG *pSort, [out] ULONG *pDisplay );
 333     HRESULT GetDefaultColumnState( [in] UINT iColumn, [out] SHCOLSTATEF *pcsFlags );
 334     HRESULT GetDetailsEx( [in] LPCITEMIDLIST pidl, [in] const SHCOLUMNID *pscid, [out] VARIANT *pv);
 335     HRESULT GetDetailsOf( [in] LPCITEMIDLIST pidl, [in] UINT iColumn, [out] SHELLDETAILS *psd);
 336     HRESULT MapColumnToSCID( [in] UINT iColumn, [in] SHCOLUMNID *pscid );
 337 }
 338
 339 /*****************************************************************************
 340  * IShellItem interface
 341  */
 342 [
 343     object,
 344     uuid(43826d1e-e718-42ee-bc55-a1e261c37bfe),
 345     pointer_default(unique)
 346 ]
 347 interface IShellItem : IUnknown
 348 {
 349     typedef [v1_enum] enum {
 350         SIGDN_NORMALDISPLAY                = 0,
 351         SIGDN_PARENTRELATIVEPARSING        = 0x80018001,
 352         SIGDN_DESKTOPABSOLUTEPARSING       = 0x80028000,
 353         SIGDN_PARENTRELATIVEEDITING        = 0x80031001,
 354         SIGDN_DESKTOPABSOLUTEEDITING       = 0x8004c000,
 355         SIGDN_FILESYSPATH                  = 0x80058000,
 356         SIGDN_URL                          = 0x80068000,
 357         SIGDN_PARENTRELATIVEFORADDRESSBAR  = 0x8007c001,
 358         SIGDN_PARENTRELATIVE               = 0x80080001
 359     } SIGDN; /* & 0xFFFF => SHGDN */
 360
 361     [v1_enum] enum _SICHINTF
 362     {
 363         SICHINT_DISPLAY                       = 0x00000000,
 364         SICHINT_CANONICAL                     = 0x10000000,
 365         SICHINT_TEST_FILESYSPATH_IF_NOT_EQUAL = 0x20000000,
 366         SICHINT_ALLFIELDS                     = 0x80000000
 367     };
 368     typedef DWORD SICHINTF;
 369
 370     HRESULT BindToHandler(
 371         [in] IBindCtx *pbc,
 372         [in] REFGUID rbhid,
 373         [in] REFIID riid,
 374         [out, iid_is(riid)] void **ppvOut);
 375
 376     HRESULT GetParent( [out] IShellItem **ppsi );
 377
 378     HRESULT GetDisplayName(
 379         [in] SIGDN sigdnName,
 380         [out] LPWSTR *ppszName);
 381
 382     HRESULT GetAttributes(
 383         [in] SFGAOF sfgaoMask,
 384         [out] SFGAOF *psfgaoAttribs);
 385
 386     HRESULT Compare(
 387         [in] IShellItem *psi,
 388         [in] SICHINTF hint,
 389         [out] int *piOrder);
 390 }
 391
 392 typedef enum tagNWMF {
 393     NWMF_UNLOADING        = 0x0001,
 394     NWMF_USERINITED       = 0x0002,
 395     NWMF_FIRST            = 0x0004,
 396     NWMF_OVERRIDEKEY      = 0x0008,
 397     NWMF_SHOWHELP         = 0x0010,
 398     NWMF_HTMLDIALOG       = 0x0020,
 399     NWMF_FROMDIALOGCHILD  = 0x0040,
 400     NWMF_USERREQUESTED    = 0x0080,
 401     NWMF_USERALLOWED      = 0x0100
 402 } NWMF;
 403
 404 [
 405     uuid(d2bc4c84-3f72-4a52-a604-7bcbf3982cbb),
 406     object,
 407     pointer_default(unique)
 408 ]
 409 interface INewWindowManager : IUnknown
 410 {
 411     HRESULT EvaluateNewWindow(
 412         [in, string] LPCWSTR pszUrl,
 413         [in, string] LPCWSTR pszName,
 414         [in, string] LPCWSTR pszUrlContext,
 415         [in, string] LPCWSTR pszFeatures,
 416         [in]         BOOL fReplace,
 417         [in]         DWORD dwFlags,
 418         [in]         DWORD dwUserActionTime);
 419 }
 420
 421 cpp_quote("#define SID_SNewWindowManager IID_INewWindowManager")
 422
 423 /*****************************************************************************
 424  * IEnumShellItems interface
 425  */
 426 [
 427  object,
 428  uuid(70629033-E363-4A28-A567-0DB78006E6D7),
 429  pointer_default(unique)
 430 ]
 431 interface IEnumShellItems : IUnknown
 432 {
 433     [local] HRESULT Next(
 434         [in] ULONG celt,
 435         [out, size_is(celt), length_is(*pceltFetched)] IShellItem **rgelt,
 436         [out] ULONG *pceltFetched);
 437
 438     [call_as(Next)] HRESULT RemoteNext(
 439         [in] ULONG celt,
 440         [out, size_is(celt), length_is(*pceltFetched)] IShellItem **rgelt,
 441         [out] ULONG *pceltFetched);
 442
 443     HRESULT Skip(
 444         [in] ULONG celt);
 445
 446     HRESULT Reset();
 447
 448     HRESULT Clone(
 449         [out] IEnumShellItems **ppenum);
 450 }
 451
 452 /*****************************************************************************
 453  * IShellItemArray interface
 454  */
 455 [
 456  object,
 457  uuid(B63EA76D-1F85-456F-A19C-48159EFA858B),
 458  pointer_default(unique)
 459 ]
 460 interface IShellItemArray : IUnknown
 461 {
 462     typedef [v1_enum] enum SIATTRIBFLAGS {
 463         SIATTRIBFLAGS_AND            = 0x0001,
 464         SIATTRIBFLAGS_OR             = 0x0002,
 465         SIATTRIBFLAGS_APPCOMPAT      = 0x0003,
 466         SIATTRIBFLAGS_MASK           = 0x0003,
 467         SIATTRIBFLAGS_ALLITEMS       = 0x4000
 468     } SIATTRIBFLAGS;
 469     cpp_quote("DEFINE_ENUM_FLAG_OPERATORS(SIATTRIBFLAGS)")
 470
 471     HRESULT BindToHandler(
 472         [in, unique] IBindCtx *pbc,
 473         [in] REFGUID bhid,
 474         [in] REFIID riid,
 475         [out, iid_is(riid)] void **ppvOut);
 476
 477     HRESULT GetPropertyStore(
 478         [in] GETPROPERTYSTOREFLAGS flags,
 479         [in] REFIID riid,
 480         [out, iid_is(riid)] void **ppv);
 481
 482     HRESULT GetPropertyDescriptionList(
 483         [in] REFPROPERTYKEY keyType,
 484         [in] REFIID riid,
 485         [out, iid_is(riid)] void **ppv);
 486
 487     HRESULT GetAttributes(
 488         [in] SIATTRIBFLAGS AttribFlags,
 489         [in] SFGAOF sfgaoMask,
 490         [out] SFGAOF *psfgaoAttribs);
 491
 492     HRESULT GetCount(
 493         [out] DWORD *pdwNumItems);
 494
 495     HRESULT GetItemAt(
 496         [in] DWORD dwIndex,
 497         [out] IShellItem **ppsi);
 498
 499     HRESULT EnumItems(
 500         [out] IEnumShellItems **ppenumShellItems);
 501
 502 }
 503
 504 typedef [v1_enum] enum DATAOBJ_GET_ITEM_FLAGS
 505 {
 506     DOGIF_DEFAULT       = 0x0,
 507     DOGIF_TRAVERSE_LINK = 0x1,
 508     DOGIF_NO_HDROP      = 0x2,
 509     DOGIF_NO_URL        = 0x4,
 510     DOGIF_ONLY_IF_ONE   = 0x8
 511 } DATAOBJ_GET_ITEM_FLAGS;
 512 cpp_quote("DEFINE_ENUM_FLAG_OPERATORS(DATAOBJ_GET_ITEM_FLAGS)")
 513
 514 cpp_quote("HRESULT WINAPI SHGetNameFromIDList(PCIDLIST_ABSOLUTE pidl, SIGDN sigdnName, PWSTR *ppszName);")
 515 cpp_quote("HRESULT WINAPI SHCreateItemFromParsingName(PCWSTR pszPath, IBindCtx *pbc, REFIID riid, void **ppv);")
 516 cpp_quote("HRESULT WINAPI SHCreateItemFromIDList(PCIDLIST_ABSOLUTE pidl, REFIID riid, void **ppv);")
 517 cpp_quote("HRESULT WINAPI SHGetItemFromDataObject(IDataObject *pdtobj, DATAOBJ_GET_ITEM_FLAGS dwFlags, REFIID riid, void **ppv);")
 518 cpp_quote("HRESULT WINAPI SHGetIDListFromObject(IUnknown *punk, PIDLIST_ABSOLUTE *ppidl);")
 519 cpp_quote("HRESULT WINAPI SHGetItemFromObject(IUnknown *punk, REFIID riid, void **ppv);")
 520 cpp_quote("HRESULT WINAPI SHCreateShellItemArray(PCIDLIST_ABSOLUTE pidlParent, IShellFolder* psf, UINT cidl, PCUITEMID_CHILD_ARRAY ppidl, IShellItemArray **ppsiItemArray);")
 521 cpp_quote("HRESULT WINAPI SHCreateShellItemArrayFromShellItem(IShellItem *psi, REFIID riid, void **ppv);")
 522 cpp_quote("HRESULT WINAPI SHCreateShellItemArrayFromDataObject(IDataObject *pdo, REFIID riid, void **ppv);")
 523
 524 /*****************************************************************************
 525  * IShellItemFilter interface
 526  */
 527 [
 528  object,
 529  uuid(2659B475-EEB8-48B7-8F07-B378810F48CF),
 530  pointer_default(unique)
 531 ]
 532 interface IShellItemFilter : IUnknown
 533 {
 534     HRESULT IncludeItem(
 535         [in] IShellItem *psi);
 536
 537     HRESULT GetEnumFlagsForItem(
 538         [in] IShellItem *psi,
 539         [out] SHCONTF *pgrfFlags);
 540 }
 541
 542 /*****************************************************************************
 543  * FOLDERSETTINGS
 544  */
 545 typedef char *LPVIEWSETTINGS;
 546
 547 typedef enum
 548 {
 549     FWF_AUTOARRANGE         = 0x00000001,
 550     FWF_ABBREVIATEDNAMES    = 0x00000002,
 551     FWF_SNAPTOGRID          = 0x00000004,
 552     FWF_OWNERDATA           = 0x00000008,
 553     FWF_BESTFITWINDOW       = 0x00000010,
 554     FWF_DESKTOP             = 0x00000020,
 555     FWF_SINGLESEL           = 0x00000040,
 556     FWF_NOSUBFOLDERS        = 0x00000080,
 557     FWF_TRANSPARENT         = 0x00000100,
 558     FWF_NOCLIENTEDGE        = 0x00000200,
 559     FWF_NOSCROLL            = 0x00000400,
 560     FWF_ALIGNLEFT           = 0x00000800,
 561     FWF_NOICONS             = 0x00001000,
 562     FWF_SHOWSELALWAYS       = 0x00002000,
 563     FWF_NOVISIBLE           = 0x00004000,
 564     FWF_SINGLECLICKACTIVATE = 0x00008000,
 565     FWF_NOWEBVIEW           = 0x00010000,
 566     FWF_HIDEFILENAMES       = 0x00020000,
 567     FWF_CHECKSELECT         = 0x00040000,
 568     FWF_NOENUMREFRESH       = 0x00080000,
 569     FWF_NOGROUPING          = 0x00100000,
 570     FWF_FULLROWSELECT       = 0x00200000,
 571     FWF_NOFILTERS           = 0x00400000,
 572     FWF_NOCOLUMNHEADER      = 0x00800000,
 573     FWF_NOHEADERINALLVIEWS  = 0x01000000,
 574     FWF_EXTENDEDTILES       = 0x02000000,
 575     FWF_TRICHECKSELECT      = 0x04000000,
 576     FWF_AUTOCHECKSELECT     = 0x08000000,
 577     FWF_NOBROWSERVIEWSTATE  = 0x10000000,
 578     FWF_SUBSETGROUPS        = 0x20000000,
 579     FWF_USESEARCHFOLDER     = 0x40000000,
 580     FWF_ALLOWRTLREADING     = 0x80000000
 581 } FOLDERFLAGS;
 582
 583 typedef enum
 584 {
 585     FVM_AUTO       =-1,
 586     FVM_ICON       = 1,
 587     FVM_FIRST      = FVM_ICON,
 588     FVM_SMALLICON  = 2,
 589     FVM_LIST       = 3,
 590     FVM_DETAILS    = 4,
 591     FVM_THUMBNAIL  = 5,
 592     FVM_TILE       = 6,
 593     FVM_THUMBSTRIP = 7,
 594     FVM_CONTENT    = 8,
 595     FVM_LAST       = FVM_CONTENT
 596 } FOLDERVIEWMODE;
 597
 598 typedef struct
 599 {
 600     UINT ViewMode;
 601     UINT fFlags;
 602 } FOLDERSETTINGS, *PFOLDERSETTINGS, *LPFOLDERSETTINGS;
 603 typedef const FOLDERSETTINGS *LPCFOLDERSETTINGS;
 604
 605 /*****************************************************************************
 606  * IShellIcon interface
 607  */
 608 [
 609     uuid(000214e5-0000-0000-c000-000000000046),
 610     object,
 611     pointer_default(unique)
 612 ]
 613 interface IShellIcon : IUnknown
 614 {
 615     HRESULT GetIconOf(
 616         [in] PCUITEMID_CHILD pidl,
 617         [in] UINT flags,
 618         [out] int *pIconIndex);
 619 }
 620
 621 /*****************************************************************************
 622  * IShellView interface
 623  */
 624 interface IShellBrowser;  /* forward declaration */
 625 [
 626     object,
 627     uuid(000214e3-0000-0000-c000-000000000046),
 628     pointer_default(unique)
 629 ]
 630 interface IShellView : IOleWindow
 631 {
 632     typedef IShellView *LPSHELLVIEW;
 633
 634     cpp_quote("#define SVSI_DESELECT       0x00000000")
 635     cpp_quote("#define SVSI_SELECT         0x00000001")
 636     cpp_quote("#define SVSI_EDIT           0x00000003")
 637     cpp_quote("#define SVSI_DESELECTOTHERS 0x00000004")
 638     cpp_quote("#define SVSI_ENSUREVISIBLE  0x00000008")
 639     cpp_quote("#define SVSI_FOCUSED        0x00000010")
 640     cpp_quote("#define SVSI_TRANSLATEPT    0x00000020")
 641     cpp_quote("#define SVSI_SELECTIONMARK  0x00000040")
 642     cpp_quote("#define SVSI_POSITIONITEM   0x00000080")
 643     cpp_quote("#define SVSI_CHECK          0x00000100")
 644     cpp_quote("#define SVSI_NOSTATECHANGE  0x80000000")
 645
 646     typedef UINT SVSIF;
 647
 648     typedef enum
 649     {
 650         SVGIO_BACKGROUND     = 0x00000000,
 651         SVGIO_SELECTION      = 0x00000001,
 652         SVGIO_ALLVIEW        = 0x00000002,
 653         SVGIO_CHECKED        = 0x00000003,
 654         SVGIO_TYPE_MASK      = 0x0000000f,
 655         SVGIO_FLAG_VIEWORDER = 0x80000000,
 656     } SVGIO;
 657
 658     typedef enum
 659     {
 660         SVUIA_DEACTIVATE       = 0,
 661         SVUIA_ACTIVATE_NOFOCUS = 1,
 662         SVUIA_ACTIVATE_FOCUS   = 2,
 663         SVUIA_INPLACEACTIVATE  = 3
 664     } SVUIA_STATUS;
 665
 666     HRESULT TranslateAccelerator( [in] MSG *pmsg );
 667     HRESULT EnableModeless( [in] BOOL fEnable );
 668     HRESULT UIActivate( [in] UINT uState );
 669     HRESULT Refresh();
 670     HRESULT CreateViewWindow(
 671         [in] IShellView *psvPrevious,
 672         [in] LPCFOLDERSETTINGS lpfs,
 673         [in] IShellBrowser *psb,
 674         [out] RECT *prcView,
 675         [out] HWND *phWnd);
 676
 677     HRESULT DestroyViewWindow();
 678     HRESULT GetCurrentInfo( [out] LPFOLDERSETTINGS lpfs );
 679
 680     [local] HRESULT AddPropertySheetPages(
 681         [in] DWORD dwReserved,
 682         [in] LPFNSVADDPROPSHEETPAGE pfn,
 683         [in] LPARAM lparam);
 684
 685     HRESULT SaveViewState();
 686     HRESULT SelectItem(
 687         [in] LPCITEMIDLIST pidlItem,
 688         [in] SVSIF uFlags);
 689     HRESULT GetItemObject(
 690         [in] UINT uItem,
 691         [in] REFIID riid,
 692         [out, iid_is(riid)] void **ppv);
 693 }
 694
 695 [
 696     object,
 697     uuid(88e39e80-3578-11cf-ae69-08002b2e1262),
 698     pointer_default(unique)
 699 ]
 700 interface IShellView2 : IShellView
 701 {
 702     typedef GUID SHELLVIEWID;
 703 cpp_quote("#include <pshpack8.h>")
 704     typedef struct _SV2CVW2_PARAMS
 705     {
 706         DWORD cbSize;
 707         IShellView *psvPrev;
 708         LPCFOLDERSETTINGS pfs;
 709         IShellBrowser *psbOwner;
 710         RECT *prcView;
 711         SHELLVIEWID const *pvid;
 712         HWND hwndView;
 713     } SV2CVW2_PARAMS, *LPSV2CVW2_PARAMS;
 714 cpp_quote("#include <poppack.h>")
 715
 716     HRESULT GetView(
 717         [in, out] SHELLVIEWID *view_guid,
 718         [in] ULONG view_type
 719     );
 720     HRESULT CreateViewWindow2(
 721         [in] LPSV2CVW2_PARAMS view_params
 722     );
 723     HRESULT HandleRename(
 724         [in] LPCITEMIDLIST new_pidl
 725     );
 726     HRESULT SelectAndPositionItem(
 727         [in] LPCITEMIDLIST item,
 728         [in] UINT flags,
 729         [in] POINT *point
 730     );
 731 }
 732
 733 /*****************************************************************************
 734  * IFolderView interface
 735  */
 736 [
 737     uuid(cde725b0-ccc9-4519-917e-325d72fab4ce),
 738     object,
 739     pointer_default(unique)
 740 ]
 741 interface IFolderView : IUnknown
 742 {
 743     HRESULT GetCurrentViewMode( [out] UINT *mode );
 744     HRESULT SetCurrentViewMode( [in] UINT mode );
 745     HRESULT GetFolder( [in] REFIID riid, [out, iid_is(riid)] void **ppv );
 746     HRESULT Item(
 747         [in] int index,
 748         [out] PITEMID_CHILD *ppidl
 749     );
 750     HRESULT ItemCount(
 751         [in] UINT flags,
 752         [out] int *items
 753     );
 754     HRESULT Items(
 755         [in] UINT flags,
 756         [in] REFIID riid,
 757         [out, iid_is(riid)] void **ppv
 758     );
 759     HRESULT GetSelectionMarkedItem( [out] int *item );
 760     HRESULT GetFocusedItem( [out] int *item );
 761     HRESULT GetItemPosition(
 762         [in] PCUITEMID_CHILD pidl,
 763         [out] POINT* ppt
 764     );
 765     HRESULT GetSpacing( [in, out, unique] POINT* pt );
 766     HRESULT GetDefaultSpacing( [out] POINT* pt );
 767     HRESULT GetAutoArrange();
 768     HRESULT SelectItem(
 769         [in] int item,
 770         [in] DWORD flags
 771     );
 772     HRESULT SelectAndPositionItems(
 773         [in] UINT cidl,
 774         [in, size_is(cidl)] PCUITEMID_CHILD_ARRAY apidl,
 775         [in, unique, size_is(cidl)] POINT* apt,
 776         [in] DWORD flags
 777     );
 778 }
 779
 780 /*****************************************************************************
 781  * IShellBrowser interface
 782  */
 783 [
 784     object,
 785     uuid(000214e2-0000-0000-c000-000000000046),
 786     pointer_default(unique)
 787 ]
 788 interface IShellBrowser : IOleWindow
 789 {
 790     typedef IShellBrowser *LPSHELLBROWSER;
 791
 792 cpp_quote("#define SBSP_DEFBROWSER            0x00000000")
 793 cpp_quote("#define SBSP_SAMEBROWSER           0x00000001")
 794 cpp_quote("#define SBSP_NEWBROWSER            0x00000002")
 795 cpp_quote("#define SBSP_DEFMODE               0x00000000")
 796 cpp_quote("#define SBSP_OPENMODE              0x00000010")
 797 cpp_quote("#define SBSP_EXPLOREMODE           0x00000020")
 798 cpp_quote("#define SBSP_HELPMODE              0x00000040")
 799 cpp_quote("#define SBSP_NOTRANSFERHIST        0x00000080")
 800 cpp_quote("#define SBSP_ABSOLUTE              0x00000000")
 801 cpp_quote("#define SBSP_RELATIVE              0x00001000")
 802 cpp_quote("#define SBSP_PARENT                0x00002000")
 803 cpp_quote("#define SBSP_NAVIGATEBACK          0x00004000")
 804 cpp_quote("#define SBSP_NAVIGATEFORWARD       0x00008000")
 805 cpp_quote("#define SBSP_ALLOW_AUTONAVIGATE    0x00010000")
 806 cpp_quote("#define SBSP_KEEPSAMETEMPLATE      0x00020000")
 807 cpp_quote("#define SBSP_KEEPWORDWHEELTEXT     0x00040000")
 808 cpp_quote("#define SBSP_ACTIVATE_NOFOCUS      0x00080000")
 809 cpp_quote("#define SBSP_CREATENOHISTORY       0x00100000")
 810 cpp_quote("#define SBSP_PLAYNOSOUND           0x00200000")
 811 cpp_quote("#define SBSP_CALLERUNTURUSTED      0x00800000")
 812 cpp_quote("#define SBSP_TRUSTFIRSTDOWNLOAD    0x01000000")
 813 cpp_quote("#define SBSP_UNTRUSTEDFORDOWNLOAD  0x02000000")
 814 cpp_quote("#define SBSP_NOAUTOSELECT          0x04000000")
 815 cpp_quote("#define SBSP_WRITENOHISTORY        0x08000000")
 816 cpp_quote("#define SBSP_TRUSTEDFORACTIVEX     0x10000000")
 817 cpp_quote("#define SBSP_FEEDNAVIGATION        0x20000000")
 818 cpp_quote("#define SBSP_REDIRECT              0x40000000")
 819 cpp_quote("#define SBSP_INITIATEDBYHLINKFRAME 0x80000000")
 820
 821 cpp_quote("#define FCW_STATUS      0x0001")
 822 cpp_quote("#define FCW_TOOLBAR     0x0002")
 823 cpp_quote("#define FCW_TREE        0x0003")
 824 cpp_quote("#define FCW_INTERNETBAR 0x0006")
 825 cpp_quote("#define FCW_PROGRESS    0x0008")
 826
 827 cpp_quote("#define FCT_MERGE       0x0001")
 828 cpp_quote("#define FCT_CONFIGABLE  0x0002")
 829 cpp_quote("#define FCT_ADDTOEND    0x0004")
 830
 831 cpp_quote("#if 0")
 832     typedef LPARAM LPTBBUTTONSB;
 833 cpp_quote("#else")
 834 cpp_quote("#include <commctrl.h>")
 835 cpp_quote("typedef LPTBBUTTON LPTBBUTTONSB;")
 836 cpp_quote("#endif")
 837
 838     HRESULT InsertMenusSB(
 839         [in] HMENU hmenuShared,
 840         [in, out] LPOLEMENUGROUPWIDTHS lpMenuWidths);
 841
 842     HRESULT SetMenuSB(
 843         [in] HMENU hmenuShared,
 844         [in] HOLEMENU holemenuReserved,
 845         [in] HWND hwndActiveObject);
 846
 847     HRESULT RemoveMenusSB( [in] HMENU hmenuShared );
 848     HRESULT SetStatusTextSB( [in, unique] LPCOLESTR pszStatusText );
 849     HRESULT EnableModelessSB( [in] BOOL fEnable );
 850     HRESULT TranslateAcceleratorSB( [in] MSG *pmsg, [in] WORD wID );
 851
 852     HRESULT BrowseObject(
 853         [in] LPCITEMIDLIST pidl,
 854         [in] UINT wFlags);
 855
 856     HRESULT GetViewStateStream(
 857         [in] DWORD grfMode,
 858         [out] IStream **ppStrm);
 859
 860     HRESULT GetControlWindow(
 861         [in] UINT id,
 862         [out] HWND *phwnd);
 863
 864     [local] HRESULT SendControlMsg(
 865         [in] UINT id,
 866         [in] UINT uMsg,
 867         [in] WPARAM wParam,
 868         [in] LPARAM lParam,
 869         [in] LRESULT *pret);
 870
 871     HRESULT QueryActiveShellView( [out] IShellView **ppshv );
 872     HRESULT OnViewWindowActive( [in] IShellView *pshv );
 873
 874     [local]
 875     HRESULT SetToolbarItems(
 876         [in] LPTBBUTTONSB lpButtons,
 877         [in] UINT nButtons,
 878         [in] UINT uFlags);
 879 }
 880
 881
 882 /*****************************************************************************
 883  * IShellLinkA interface
 884  */
 885 [
 886     object,
 887     uuid(000214ee-0000-0000-c000-000000000046),
 888     pointer_default(unique)
 889 ]
 890 interface IShellLinkA : IUnknown
 891 {
 892     typedef enum
 893     {
 894         SLR_NO_UI               = 0x0001,
 895         SLR_ANY_MATCH           = 0x0002,
 896         SLR_UPDATE              = 0x0004,
 897         SLR_NOUPDATE            = 0x0008,
 898         SLR_NOSEARCH            = 0x0010,
 899         SLR_NOTRACK             = 0x0020,
 900         SLR_NOLINKINFO          = 0x0040,
 901         SLR_INVOKE_MSI          = 0x0080,
 902         SLR_NO_UI_WITH_MSG_PUMP = 0x0101,
 903     } SLR_FLAGS;
 904
 905     typedef enum
 906     {
 907         SLGP_SHORTPATH   = 0x0001,
 908         SLGP_UNCPRIORITY = 0x0002,
 909         SLGP_RAWPATH     = 0x0004,
 910     } SLGP_FLAGS;
 911
 912     HRESULT GetPath(
 913         [out, size_is(cch)] LPSTR pszFile,
 914         [in] int cch,
 915         [in, out, unique] WIN32_FIND_DATAA *pfd,
 916         [in] DWORD fFlags);
 917
 918     HRESULT GetIDList( [out] LPITEMIDLIST * ppidl );
 919
 920     HRESULT SetIDList( [in] LPCITEMIDLIST pidl );
 921
 922     HRESULT GetDescription(
 923         [out, size_is(cch)] LPSTR pszName,
 924         [in] int cch);
 925
 926     HRESULT SetDescription( [in] LPCSTR pszName );
 927
 928     HRESULT GetWorkingDirectory(
 929         [out, size_is(cch)] LPSTR pszDir,
 930         [in] int cch);
 931
 932     HRESULT SetWorkingDirectory( [in] LPCSTR pszDir );
 933
 934     HRESULT GetArguments(
 935         [out, size_is(cch)] LPSTR pszArgs,
 936         [in] int cch);
 937
 938     HRESULT SetArguments( [in] LPCSTR pszArgs );
 939
 940     HRESULT GetHotkey( [out] WORD *pwHotkey );
 941
 942     HRESULT SetHotkey( [in] WORD wHotkey );
 943
 944     HRESULT GetShowCmd( [out] int *piShowCmd );
 945
 946     HRESULT SetShowCmd( [in] int iShowCmd );
 947
 948     HRESULT GetIconLocation(
 949         [out, size_is(cch)] LPSTR pszIconPath,
 950         [in] int cch,
 951         [out] int *piIcon);
 952
 953     HRESULT SetIconLocation(
 954         [in] LPCSTR pszIconPath,
 955         [in] int iIcon);
 956
 957     HRESULT SetRelativePath(
 958         [in] LPCSTR pszPathRel,
 959         [in] DWORD dwReserved);
 960
 961     HRESULT Resolve(
 962         [in] HWND hwnd,
 963         [in] DWORD fFlags);
 964
 965     HRESULT SetPath( [in] LPCSTR pszFile );
 966 }
 967
 968
 969 /*****************************************************************************
 970  * IShellLinkW interface
 971  */
 972 [
 973     object,
 974     uuid(000214f9-0000-0000-c000-000000000046),
 975     pointer_default(unique)
 976 ]
 977 interface IShellLinkW : IUnknown
 978 {
 979     HRESULT GetPath(
 980         [out, size_is(cch)] LPWSTR pszFile,
 981         [in] int cch,
 982         [in, out] WIN32_FIND_DATAW *pfd,
 983         [in] DWORD fFlags);
 984
 985     HRESULT GetIDList( [out] LPITEMIDLIST * ppidl );
 986
 987     HRESULT SetIDList( [in] LPCITEMIDLIST pidl );
 988
 989     HRESULT GetDescription(
 990         [out, size_is(cch)] LPWSTR pszName,
 991         [in] int cch);
 992
 993     HRESULT SetDescription( [in] LPCWSTR pszName );
 994
 995     HRESULT GetWorkingDirectory(
 996         [out, size_is(cch)] LPWSTR pszDir,
 997         [in] int cch);
 998
 999     HRESULT SetWorkingDirectory( [in] LPCWSTR pszDir );
1000
1001     HRESULT GetArguments(
1002         [out, size_is(cch)] LPWSTR pszArgs,
1003         [in] int cch);
1004
1005     HRESULT SetArguments( [in] LPCWSTR pszArgs );
1006
1007     HRESULT GetHotkey( [out] WORD *pwHotkey );
1008
1009     HRESULT SetHotkey( [in] WORD wHotkey );
1010
1011     HRESULT GetShowCmd( [out] int *piShowCmd );
1012
1013     HRESULT SetShowCmd( [in] int iShowCmd );
1014
1015     HRESULT GetIconLocation(
1016         [out, size_is(cch)] LPWSTR pszIconPath,
1017         [in] int cch,
1018         [out] int *piIcon);
1019
1020     HRESULT SetIconLocation(
1021         [in] LPCWSTR pszIconPath,
1022         [in] int iIcon);
1023
1024     HRESULT SetRelativePath(
1025         [in] LPCWSTR pszPathRel,
1026         [in] DWORD dwReserved);
1027
1028     HRESULT Resolve(
1029         [in] HWND hwnd,
1030         [in] DWORD fFlags);
1031
1032     HRESULT SetPath( [in] LPCWSTR pszFile );
1033 }
1034
1035 cpp_quote("#define IShellLink WINELIB_NAME_AW(IShellLink)")
1036
1037
1038 /*****************************************************************************
1039  * IShellExtInit interface
1040  */
1041 [
1042     object,
1043     uuid(000214e8-0000-0000-c000-000000000046),
1044     pointer_default(unique),
1045     local
1046 ]
1047 interface IShellExtInit : IUnknown
1048 {
1049     typedef IShellExtInit *LPSHELLEXTINIT;
1050
1051     HRESULT Initialize(
1052         [in] LPCITEMIDLIST pidlFolder,
1053         [in] IDataObject *pdtobj,
1054         [in] HKEY hkeyProgID);
1055 }
1056
1057
1058 /*******************************************************************************/
1059 /* Note: the following interfaces are not in shobjidl.idl under Windows, they  */
1060 /* are declared directly in shlobj.h. It hopefully won't break anything to put */
1061 /* them here anyway.                                                           */
1062 /*******************************************************************************/
1063
1064 #ifndef MAX_PATH
1065 #define MAX_PATH 260
1066 #endif
1067
1068
1069 /*****************************************************************************
1070  * IPersistFolder3 interface
1071  */
1072 [
1073     object,
1074     uuid(cef04fdf-fe72-11d2-87a5-00c04f6837cf),
1075     pointer_default(unique)
1076 ]
1077 interface IPersistFolder3 : IPersistFolder2
1078 {
1079     typedef struct
1080     {
1081         LPITEMIDLIST    pidlTargetFolder;
1082         WCHAR           szTargetParsingName[MAX_PATH];
1083         WCHAR           szNetworkProvider[MAX_PATH];
1084         DWORD           dwAttributes;
1085         int             csidl;
1086     } PERSIST_FOLDER_TARGET_INFO;
1087
1088     HRESULT InitializeEx(
1089         [in] IBindCtx *pbc,
1090         [in] LPCITEMIDLIST pidlRoot,
1091         [in] const PERSIST_FOLDER_TARGET_INFO *ppfti);
1092
1093     HRESULT GetFolderTargetInfo( [out] PERSIST_FOLDER_TARGET_INFO *ppfti );
1094 }
1095
1096
1097 /*****************************************************************************
1098  * IExtractIconA interface
1099  */
1100 [
1101     object,
1102     uuid(000214eb-0000-0000-c000-000000000046),
1103     pointer_default(unique),
1104     local
1105 ]
1106 interface IExtractIconA : IUnknown
1107 {
1108 cpp_quote("#define GIL_OPENICON     0x0001")
1109 cpp_quote("#define GIL_FORSHELL     0x0002")
1110 cpp_quote("#define GIL_ASYNC        0x0020")
1111 cpp_quote("#define GIL_DEFAULTICON  0x0040")
1112 cpp_quote("#define GIL_FORSHORTCUT  0x0080")
1113
1114 cpp_quote("#define GIL_SIMULATEDOC  0x0001")
1115 cpp_quote("#define GIL_PERINSTANCE  0x0002")
1116 cpp_quote("#define GIL_PERCLASS     0x0004")
1117 cpp_quote("#define GIL_NOTFILENAME  0x0008")
1118 cpp_quote("#define GIL_DONTCACHE    0x0010")
1119
1120     typedef IExtractIconA *LPEXTRACTICONA;
1121
1122     HRESULT GetIconLocation(
1123         [in] UINT uFlags,
1124         [out, size_is(cchMax)] LPSTR szIconFile,
1125         [in] UINT cchMax,
1126         [out] INT *piIndex,
1127         [out] UINT *pwFlags);
1128
1129     HRESULT Extract(
1130         [in] LPCSTR pszFile,
1131         [in] UINT nIconIndex,
1132         [out] HICON *phiconLarge,
1133         [out] HICON *phiconSmall,
1134         [in] UINT nIconSize );
1135 }
1136
1137
1138 /*****************************************************************************
1139  * IExtractIconW interface
1140  */
1141 [
1142     object,
1143     uuid(000214fa-0000-0000-c000-000000000046),
1144     pointer_default(unique),
1145     local
1146 ]
1147 interface IExtractIconW : IUnknown
1148 {
1149     typedef IExtractIconW *LPEXTRACTICONW;
1150
1151     HRESULT GetIconLocation(
1152         [in] UINT uFlags,
1153         [out, size_is(cchMax)] LPWSTR szIconFile,
1154         [in] UINT cchMax,
1155         [out] INT *piIndex,
1156         [out] UINT *pwFlags);
1157
1158     HRESULT Extract(
1159         [in] LPCWSTR pszFile,
1160         [in] UINT nIconIndex,
1161         [out] HICON *phiconLarge,
1162         [out] HICON *phiconSmall,
1163         [in] UINT nIconSize );
1164 }
1165
1166 cpp_quote("#define LPEXTRACTICON WINELIB_NAME_AW(LPEXTRACTICON)")
1167 cpp_quote("#define IExtractIcon WINELIB_NAME_AW(IExtractIcon)")
1168
1169
1170 /*****************************************************************************
1171  * ICommDlgBrowser interface
1172  */
1173 [
1174     object,
1175     uuid(000214f1-0000-0000-c000-000000000046),
1176     pointer_default(unique)
1177 ]
1178 interface ICommDlgBrowser : IUnknown
1179 {
1180 cpp_quote("#define CDBOSC_SETFOCUS     0x00000000")
1181 cpp_quote("#define CDBOSC_KILLFOCUS    0x00000001")
1182 cpp_quote("#define CDBOSC_SELCHANGE    0x00000002")
1183 cpp_quote("#define CDBOSC_RENAME       0x00000003")
1184 cpp_quote("#define CDBOSC_STATECHANGE  0x00000004")
1185
1186     typedef ICommDlgBrowser *LPCOMMDLGBROWSER;
1187
1188     HRESULT OnDefaultCommand( [in] IShellView *shv );
1189     HRESULT OnStateChange( [in] IShellView *shv, [in] ULONG uChange );
1190     HRESULT IncludeObject( [in] IShellView *shv, [in] LPCITEMIDLIST pidl );
1191 }
1192
1193
1194 /*****************************************************************************
1195  * ICommDlgBrowser2 interface
1196  */
1197 [
1198  object,
1199  uuid(10339516-2894-11D2-9039-00C04F8EEB3E),
1200  pointer_default(unique)
1201 ]
1202 interface ICommDlgBrowser2 : ICommDlgBrowser
1203 {
1204
1205     HRESULT Notify(
1206         [in] IShellView *ppshv,
1207         [in] DWORD dwNotifyType);
1208
1209     HRESULT GetDefaultMenuText(
1210         [in] IShellView *ppshv,
1211         [out, string, size_is(cchMax)] LPWSTR pszText,
1212         [in] int cchMax);
1213
1214     HRESULT GetViewFlags(
1215         [out] DWORD *pdwFlags);
1216 }
1217
1218
1219 /*****************************************************************************
1220  * ICommDlgBrowser3 interface
1221  */
1222 [
1223  object,
1224  uuid(C8AD25A1-3294-41EE-8165-71174BD01C57),
1225  pointer_default(unique)
1226 ]
1227 interface ICommDlgBrowser3 : ICommDlgBrowser2
1228 {
1229
1230     HRESULT OnColumnClicked(
1231         [in] IShellView *ppshv,
1232         [in] int iColumn);
1233
1234     HRESULT GetCurrentFilter(
1235         [out, string, size_is(cchFileSpec)] LPWSTR pszFileSpec,
1236         [in] int cchFileSpec);
1237
1238     HRESULT OnPreviewCreated(
1239         [in] IShellView *ppshv);
1240 }
1241
1242
1243 /*****************************************************************************
1244  * IDockingWindowFrame interface
1245  */
1246 [
1247     object,
1248     uuid(47d2657a-7b27-11d0-8ca9-00a0c92dbfe8),
1249     pointer_default(unique),
1250     local
1251 ]
1252 interface IDockingWindowFrame : IOleWindow
1253 {
1254 cpp_quote("#define DWFRF_NORMAL           0x0000")
1255 cpp_quote("#define DWFRF_DELETECONFIGDATA 0x0001")
1256 cpp_quote("#define DWFAF_HIDDEN           0x0001")
1257
1258     HRESULT AddToolbar(
1259         [in] IUnknown *punkSrc,
1260         [in] LPCWSTR pwszItem,
1261         [in] DWORD dwAddFlags);
1262
1263     HRESULT RemoveToolbar(
1264         [in] IUnknown *punkSrc,
1265         [in] DWORD dwRemoveFlags);
1266
1267     HRESULT FindToolbar(
1268         [in] LPCWSTR pwszItem,
1269         [in] REFIID riid,
1270         [out] LPVOID *ppvObj);
1271 }
1272
1273
1274 /*****************************************************************************
1275  * IDragSourceHelper interface
1276  */
1277 [
1278     object,
1279     uuid(de5bf786-477a-11d2-839d-00c04fd918d0),
1280     pointer_default(unique),
1281     local
1282 ]
1283 interface IDragSourceHelper : IUnknown
1284 {
1285     typedef struct
1286     {
1287         SIZE     sizeDragImage;
1288         POINT    ptOffset;
1289         HBITMAP  hbmpDragImage;
1290         COLORREF crColorKey;
1291     } SHDRAGIMAGE, *LPSHDRAGIMAGE;
1292
1293   HRESULT InitializeFromBitmap(
1294       [in] LPSHDRAGIMAGE pshdi,
1295       [in] IDataObject *pDataObject);
1296
1297   HRESULT InitializeFromWindow(
1298       [in] HWND hwnd,
1299       [in] POINT *ppt,
1300       [in] IDataObject *pDataObject);
1301 }
1302
1303
1304 /*****************************************************************************
1305  * IDropTargetHelper interface
1306  */
1307 [
1308     object,
1309     uuid(4657278b-411b-11d2-839a-00c04fd918d0),
1310     pointer_default(unique),
1311     local
1312 ]
1313 interface IDropTargetHelper : IUnknown
1314 {
1315     HRESULT DragEnter(
1316         [in] HWND hwndTarget,
1317         [in] IDataObject *pDataObject,
1318         [in] POINT *ppt,
1319         [in] DWORD dwEffect);
1320
1321     HRESULT DragLeave();
1322
1323     HRESULT DragOver(
1324         [in] POINT *ppt,
1325         [in] DWORD dwEffect);
1326
1327     HRESULT Drop(
1328         [in] IDataObject *pDataObject,
1329         [in] POINT *ppt,
1330         [in] DWORD dwEffect);
1331
1332     HRESULT Show( [in] BOOL fShow );
1333 }
1334
1335
1336 /*****************************************************************************
1337  * IContextMenu interface
1338  */
1339 [
1340     object,
1341     uuid(000214e4-0000-0000-c000-000000000046),
1342     pointer_default(unique),
1343     local
1344 ]
1345 interface IContextMenu : IUnknown
1346 {
1347 cpp_quote("#define CMF_NORMAL        0x00000000")
1348 cpp_quote("#define CMF_DEFAULTONLY   0x00000001")
1349 cpp_quote("#define CMF_VERBSONLY     0x00000002")
1350 cpp_quote("#define CMF_EXPLORE       0x00000004")
1351 cpp_quote("#define CMF_NOVERBS       0x00000008")
1352 cpp_quote("#define CMF_CANRENAME     0x00000010")
1353 cpp_quote("#define CMF_NODEFAULT     0x00000020")
1354 cpp_quote("#define CMF_INCLUDESTATIC 0x00000040")
1355 cpp_quote("#define CMF_EXTENDEDVERBS 0x00000100")
1356 cpp_quote("#define CMF_RESERVED      0xffff0000")
1357
1358 cpp_quote("#define GCS_VERBA         0x00000000")
1359 cpp_quote("#define GCS_HELPTEXTA     0x00000001")
1360 cpp_quote("#define GCS_VALIDATEA     0x00000002")
1361 cpp_quote("#define GCS_VERBW         0x00000004")
1362 cpp_quote("#define GCS_HELPTEXTW     0x00000005")
1363 cpp_quote("#define GCS_VALIDATEW     0x00000006")
1364 cpp_quote("#define GCS_UNICODE       0x00000004")
1365 cpp_quote("#define GCS_VERB          WINELIB_NAME_AW(GCS_VERB)")
1366 cpp_quote("#define GCS_HELPTEXT      WINELIB_NAME_AW(GCS_HELPTEXT)")
1367 cpp_quote("#define GCS_VALIDATE      WINELIB_NAME_AW(GCS_VALIDATE)")
1368
1369 cpp_quote("#define CMDSTR_NEWFOLDERA   \"NewFolder\"")
1370 cpp_quote("#define CMDSTR_VIEWLISTA    \"ViewList\"")
1371 cpp_quote("#define CMDSTR_VIEWDETAILSA \"ViewDetails\"")
1372 cpp_quote("#if defined(__GNUC__)")
1373 cpp_quote("# define CMDSTR_NEWFOLDERW (const WCHAR []){ 'N','e','w','F','o','l','d','e','r',0 }")
1374 cpp_quote("# define CMDSTR_VIEWLISTW (const WCHAR []){ 'V','i','e','w','L','i','s','t',0 }")
1375 cpp_quote("# define CMDSTR_VIEWDETAILSW (const WCHAR []){ 'V','i','e','w','D','e','t','a','i','l','s',0 }")
1376 cpp_quote("#elif defined(_MSC_VER)")
1377 cpp_quote("# define CMDSTR_NEWFOLDERW   L\"NewFolder\"")
1378 cpp_quote("# define CMDSTR_VIEWLISTW    L\"ViewList\"")
1379 cpp_quote("# define CMDSTR_VIEWDETAILSW L\"ViewDetails\"")
1380 cpp_quote("#else")
1381 cpp_quote("static const WCHAR CMDSTR_NEWFOLDERW[] = {'N','e','w','F','o','l','d','e','r',0};")
1382 cpp_quote("static const WCHAR CMDSTR_VIEWLISTW [] = {'V','i','e','w','L','i','s','t',0};")
1383 cpp_quote("static const WCHAR CMDSTR_VIEWDETAILSW[] = {'V','i','e','w','D','e','t','a','i','l','s',0};")
1384 cpp_quote("#endif")
1385 cpp_quote("#define CMDSTR_NEWFOLDER    WINELIB_NAME_AW(CMDSTR_NEWFOLDER)")
1386 cpp_quote("#define CMDSTR_VIEWLIST     WINELIB_NAME_AW(CMDSTR_VIEWLIST)")
1387 cpp_quote("#define CMDSTR_VIEWDETAILS  WINELIB_NAME_AW(CMDSTR_VIEWDETAILS)")
1388
1389 cpp_quote("#define CMIC_MASK_HOTKEY         SEE_MASK_HOTKEY")
1390 cpp_quote("#define CMIC_MASK_ICON           SEE_MASK_ICON")
1391 cpp_quote("#define CMIC_MASK_FLAG_NO_UI     SEE_MASK_FLAG_NO_UI")
1392 cpp_quote("#define CMIC_MASK_UNICODE        SEE_MASK_UNICODE")
1393 cpp_quote("#define CMIC_MASK_NO_CONSOLE     SEE_MASK_NO_CONSOLE")
1394 cpp_quote("#define CMIC_MASK_HASLINKNAME    SEE_MASK_HASLINKNAME")
1395 cpp_quote("#define CMIC_MASK_FLAG_SEP_VDM   SEE_MASK_FLAG_SEPVDM")
1396 cpp_quote("#define CMIC_MASK_HASTITLE       SEE_MASK_HASTITLE")
1397 cpp_quote("#define CMIC_MASK_ASYNCOK        SEE_MASK_ASYNCOK")
1398 cpp_quote("#define CMIC_MASK_NOASYNC        SEE_MASK_NOASYNC")
1399 cpp_quote("#define CMIC_MASK_SHIFT_DOWN     0x10000000")
1400 cpp_quote("#define CMIC_MASK_PTINVOKE       0x20000000")
1401 cpp_quote("#define CMIC_MASK_CONTROL_DOWN   0x40000000")
1402 cpp_quote("#define CMIC_MASK_FLAG_LOG_USAGE SEE_MASK_FLAG_LOG_USAGE")
1403 cpp_quote("#define CMIC_MASK_NOZONECHECKS   SEE_MASK_NOZONECHECKS")
1404
1405     typedef IContextMenu *LPCONTEXTMENU;
1406
1407     typedef struct tagCMINVOKECOMMANDINFO
1408     {
1409         DWORD cbSize;
1410         DWORD fMask;
1411         HWND hwnd;
1412         LPCSTR lpVerb;
1413         LPCSTR lpParameters;
1414         LPCSTR lpDirectory;
1415         INT nShow;
1416         DWORD dwHotKey;
1417         HANDLE hIcon;
1418     } CMINVOKECOMMANDINFO, *LPCMINVOKECOMMANDINFO;
1419
1420     typedef struct tagCMInvokeCommandInfoEx
1421     {
1422         DWORD cbSize;
1423         DWORD fMask;
1424         HWND hwnd;
1425         LPCSTR lpVerb;
1426         LPCSTR lpParameters;
1427         LPCSTR lpDirectory;
1428         INT nShow;
1429         DWORD dwHotKey;
1430         HANDLE hIcon;
1431         LPCSTR lpTitle;
1432         LPCWSTR lpVerbW;
1433         LPCWSTR lpParametersW;
1434         LPCWSTR lpDirectoryW;
1435         LPCWSTR lpTitleW;
1436         POINT ptInvoke;
1437     } CMINVOKECOMMANDINFOEX, *LPCMINVOKECOMMANDINFOEX;
1438
1439     HRESULT QueryContextMenu(
1440         [in] HMENU hmenu,
1441         [in] UINT indexMenu,
1442         [in] UINT idCmdFirst,
1443         [in] UINT idCmdLast,
1444         [in] UINT uFlags);
1445
1446     HRESULT InvokeCommand( [in] LPCMINVOKECOMMANDINFO lpici );
1447
1448     HRESULT GetCommandString(
1449         [in] UINT_PTR idCmd,
1450         [in] UINT uType,
1451         [out] UINT *pwReserved,
1452         [out, size_is(cchMax)] LPSTR pszName,
1453         [in] UINT cchMax);
1454 }
1455
1456
1457 /*****************************************************************************
1458  * IContextMenu2 interface
1459  */
1460 [
1461     object,
1462     uuid(000214f4-0000-0000-c000-000000000046),
1463     pointer_default(unique),
1464     local
1465 ]
1466 interface IContextMenu2 : IContextMenu
1467 {
1468     typedef IContextMenu2 *LPCONTEXTMENU2;
1469
1470     HRESULT HandleMenuMsg(
1471         [in] UINT uMsg,
1472         [in] WPARAM wParam,
1473         [in] LPARAM lParam);
1474 }
1475
1476
1477 /*****************************************************************************
1478  * IContextMenu3 interface
1479  */
1480 [
1481     object,
1482     uuid(bcfce0a0-ec17-11d0-8d10-00a0c90f2719),
1483     pointer_default(unique),
1484     local
1485 ]
1486 interface IContextMenu3 : IContextMenu2
1487 {
1488     typedef IContextMenu3 *LPCONTEXTMENU3;
1489
1490     HRESULT HandleMenuMsg2(
1491         [in] UINT uMsg,
1492         [in] WPARAM wParam,
1493         [in] LPARAM lParam,
1494         [out] LRESULT *plResult);
1495 }
1496
1497
1498 /*****************************************************************************
1499  * IShellExecuteHookA interface
1500  */
1501 [
1502     object,
1503     uuid(000214f5-0000-0000-c000-000000000046),
1504     pointer_default(unique),
1505     local
1506 ]
1507 interface IShellExecuteHookA : IUnknown
1508 {
1509     cpp_quote("struct _SHELLEXECUTEINFOA;")
1510     HRESULT Execute(
1511         [in, out] struct _SHELLEXECUTEINFOA* pei);
1512 }
1513
1514
1515 /*****************************************************************************
1516  * IShellExecuteHookW interface
1517  */
1518 [
1519     object,
1520     uuid(000214fb-0000-0000-c000-000000000046),
1521     pointer_default(unique),
1522     local
1523 ]
1524 interface IShellExecuteHookW : IUnknown
1525 {
1526     cpp_quote("struct _SHELLEXECUTEINFOW;")
1527     HRESULT Execute(
1528                 [in, out] struct _SHELLEXECUTEINFOW* pei);
1529 }
1530
1531 /*****************************************************************************
1532  * IShellLinkDataList interface
1533  */
1534 [
1535     object,
1536     uuid(45e2b4ae-b1c3-11d0-b92f-00a0c90312e1),
1537     pointer_default(unique)
1538 ]
1539 interface IShellLinkDataList : IUnknown
1540 {
1541     [local] HRESULT AddDataBlock(
1542                 [in] void *pDataBlock);
1543     [local] HRESULT CopyDataBlock(
1544                 [in] DWORD dwSig,
1545                 [out] void **ppDataBlock);
1546     HRESULT RemoveDataBlock(
1547                 [in] DWORD dwSig);
1548     HRESULT GetFlags(
1549                 [out] DWORD *pdwFlags);
1550     HRESULT SetFlags(
1551                 [in] DWORD dwFlags);
1552 }
1553
1554
1555 /*****************************************************************************
1556  * IResolveShellLink interface
1557  */
1558 [
1559     object,
1560     uuid(5cd52983-9449-11d2-963a-00c04f79adf0),
1561     pointer_default(unique)
1562 ]
1563 interface IResolveShellLink : IUnknown
1564 {
1565     HRESULT ResolveShellLink(
1566                 [in] IUnknown *punk,
1567                 [in] HWND hwnd,
1568                 [in] DWORD fFlags);
1569 }
1570
1571
1572 /*****************************************************************************
1573  * IURLSearchHook interface
1574  */
1575 [
1576     object,
1577     uuid(ac60f6a0-0fd9-11d0-99cb-00c04fd64497),
1578     pointer_default(unique),
1579     local
1580 ]
1581 interface IURLSearchHook : IUnknown
1582 {
1583     HRESULT Translate(
1584                 [in, out] LPWSTR lpwszSearchURL,
1585                 [in] DWORD cchBufferSize);
1586 }
1587
1588
1589 /*****************************************************************************
1590  * ISearchContext interface
1591  */
1592 [
1593     object,
1594     uuid(09f656a2-41af-480c-88f7-16cc0d164615),
1595     pointer_default(unique),
1596     local
1597 ]
1598 interface ISearchContext : IUnknown
1599 {
1600     HRESULT GetSearchUrl(
1601                 [in] BSTR *pbstrSearchUrl);
1602     HRESULT GetSearchText(
1603                 [in] BSTR *pbstrSearchText);
1604     HRESULT GetSearchStyle(
1605                 [in] BSTR *pdwSearchStyle);
1606 }
1607
1608
1609 /*****************************************************************************
1610  * IURLSearchHook2 interface
1611  */
1612 [
1613     object,
1614     uuid(5ee44da4-6d32-46e3-86bc-07540dedd0e0),
1615     pointer_default(unique),
1616     local
1617 ]
1618 interface IURLSearchHook2 : IURLSearchHook
1619 {
1620     HRESULT TranslateWithSearchContext(
1621                 [in, out] LPWSTR lpwszSearchURL,
1622                 [in] DWORD cchBufferSize,
1623                 [in] ISearchContext *pSearchContext);
1624 }
1625
1626
1627 cpp_quote("#define INewShortcutHook WINELIB_NAME_AW(INewShortcutHook)")
1628
1629 /*****************************************************************************
1630  * INewShortcutHookA interface
1631  */
1632 [
1633     object,
1634     uuid(000214e1-0000-0000-c000-000000000046),
1635     pointer_default(unique),
1636     local
1637 ]
1638 interface INewShortcutHookA : IUnknown
1639 {
1640     HRESULT SetReferent(
1641                 [in] LPCSTR pcszReferent,
1642                 [in] HWND hwnd);
1643     HRESULT GetReferent(
1644                 [out] LPSTR pcszReferent,
1645                 [in] int cchReferent);
1646     HRESULT SetFolder(
1647                 [in] LPCSTR pcszReferent);
1648     HRESULT GetFolder(
1649                 [out] LPSTR pcszReferent,
1650                 [in] int cchFolder);
1651     HRESULT GetName(
1652                 [out] LPSTR pszName,
1653                 [in] int cchName);
1654     HRESULT GetExtension(
1655                 [out] LPSTR pszExtension,
1656                 [in] int cchExtension);
1657 }
1658
1659
1660 /*****************************************************************************
1661  * INewShortcutHookW interface
1662  */
1663 [
1664     object,
1665     uuid(000214f7-0000-0000-c000-000000000046),
1666     pointer_default(unique),
1667     local
1668 ]
1669 interface INewShortcutHookW : IUnknown
1670 {
1671     HRESULT SetReferent(
1672                 [in] LPCWSTR pcszReferent,
1673                 [in] HWND hwnd);
1674     HRESULT GetReferent(
1675                 [out] LPWSTR pcszReferent,
1676                 [in] int cchReferent);
1677     HRESULT SetFolder(
1678                 [in] LPCWSTR pcszReferent);
1679     HRESULT GetFolder(
1680                 [out] LPWSTR pcszReferent,
1681                 [in] int cchFolder);
1682     HRESULT GetName(
1683                 [out] LPWSTR pszName,
1684                 [in] int cchName);
1685     HRESULT GetExtension(
1686                 [out] LPWSTR pszExtension,
1687                 [in] int cchExtension);
1688 }
1689
1690 /*****************************************************************************
1691  * IRunnableTask interface
1692  */
1693 [
1694     object,
1695     uuid(85788d00-6807-11d0-b810-00c04fd706ec),
1696     pointer_default(unique),
1697     local
1698 ]
1699 interface IRunnableTask : IUnknown
1700 {
1701     HRESULT Run();
1702     HRESULT Kill([in] BOOL fWait);
1703     HRESULT Suspend();
1704     HRESULT Resume();
1705     ULONG IsRunning();
1706 }
1707
1708 /*****************************************************************************
1709  * IShellChangeNotify interface
1710  */
1711 [
1712     object,
1713     uuid(d82be2b1-5764-11d0-a96e-00c04fd705a2),
1714     pointer_default(unique),
1715     local
1716 ]
1717 interface IShellChangeNotify : IUnknown
1718 {
1719     HRESULT OnChange(
1720                 [in] LONG lEvent,
1721                 [in] LPCITEMIDLIST pidl1,
1722                 [in] LPCITEMIDLIST pidl2);
1723 }
1724
1725 /*****************************************************************************
1726  * IFileSystemBindData interface
1727  */
1728 [
1729     object,
1730     uuid(01e18d10-4d8b-11d2-855d-006008059367),
1731     pointer_default(unique),
1732     local
1733 ]
1734 interface IFileSystemBindData : IUnknown
1735 {
1736     HRESULT SetFindData(
1737                 [in] const WIN32_FIND_DATAW *pfd);
1738     HRESULT GetFindData(
1739                 [out] WIN32_FIND_DATAW *pfd);
1740 }
1741
1742 /*****************************************************************************
1743  *    ITaskbarList interface
1744  */
1745 [
1746     object,
1747     uuid(56FDF342-FD6D-11d0-958A-006097C9A090),
1748     pointer_default(unique)
1749 ]
1750 interface ITaskbarList : IUnknown
1751 {
1752     HRESULT HrInit();
1753
1754     HRESULT AddTab(
1755         [in] HWND hwnd);
1756
1757     HRESULT DeleteTab(
1758         [in] HWND hwnd);
1759
1760     HRESULT ActivateTab(
1761         [in] HWND hwnd);
1762
1763     HRESULT SetActiveAlt(
1764         [in] HWND hwnd);
1765 }
1766
1767 cpp_quote("EXTERN_C const CLSID CLSID_TaskbarList;")
1768
1769 /*****************************************************************************
1770  *    IAutoCompleteDropDown interface
1771  */
1772 [
1773     object,
1774     uuid(3CD141F4-3C6A-11d2-BCAA-00C04FD929DB),
1775     pointer_default(unique)
1776 ]
1777 interface IAutoCompleteDropDown : IUnknown
1778 {
1779 cpp_quote("#define ACDD_VISIBLE   0x0001")
1780
1781     HRESULT GetDropDownStatus(
1782         [out] DWORD *pdwFlags,
1783         [out, string] LPWSTR *ppwszString);
1784
1785     HRESULT ResetEnumerator();
1786 }
1787
1788 [
1789     object,
1790     uuid(cb728b20-f786-11ce-92ad-00aa00a74cd0),
1791     pointer_default(unique)
1792 ]
1793 interface IProfferService : IUnknown
1794 {
1795     HRESULT ProfferService(
1796         [in] REFGUID service,
1797         [in] IServiceProvider *pService,
1798         [out] DWORD *pCookie);
1799
1800     HRESULT RevokeService([in] DWORD cookie);
1801 }
1802
1803 /*****************************************************************************
1804  * IExplorerBrowserEvents interface
1805  */
1806 [
1807  object,
1808  uuid(361BBDC7-E6EE-4E13-BE58-58E2240C810F)
1809 ]
1810 interface IExplorerBrowserEvents : IUnknown
1811 {
1812     HRESULT OnNavigationPending(
1813         [in] PCIDLIST_ABSOLUTE pidlFolder);
1814
1815     HRESULT OnViewCreated(
1816         [in] IShellView *psv);
1817
1818     HRESULT OnNavigationComplete(
1819         [in] PCIDLIST_ABSOLUTE pidlFolder);
1820
1821     HRESULT OnNavigationFailed(
1822         [in] PCIDLIST_ABSOLUTE pidlFolder);
1823 }
1824
1825 typedef GUID EXPLORERPANE;
1826 typedef EXPLORERPANE *REFEXPLORERPANE;
1827
1828 cpp_quote("#define SID_ExplorerPaneVisibility IID_IExplorerPaneVisibility")
1829
1830 /*****************************************************************************
1831  * IExplorerPaneVisibility interface
1832  */
1833 [
1834  object,
1835  uuid(E07010EC-BC17-44C0-97B0-46C7C95B9EDC)
1836 ]
1837 interface IExplorerPaneVisibility : IUnknown
1838 {
1839     typedef enum tagEXPLORERPANESTATE {
1840         EPS_DONTCARE     = 0x0,
1841         EPS_DEFAULT_ON   = 0x1,
1842         EPS_DEFAULT_OFF  = 0x2,
1843         EPS_STATE_MASK   = 0xffff,
1844         EPS_INITIALSTATE = 0x10000,
1845         EPS_FORCE        = 0x20000
1846     } EXPLORERPANESTATE;
1847
1848     HRESULT GetPaneState(
1849         [in] REFEXPLORERPANE ep,
1850         [out] EXPLORERPANESTATE *peps);
1851 }
1852
1853 typedef [v1_enum] enum tagEXPLORER_BROWSER_FILL_FLAGS {
1854     EBF_NONE                     = 0,
1855     EBF_SELECTFROMDATAOBJECT     = 0x100,
1856     EBF_NODROPTARGET             = 0x200
1857 } EXPLORER_BROWSER_FILL_FLAGS;
1858
1859 typedef [v1_enum] enum tagEXPLORER_BROWSER_OPTIONS {
1860     EBO_NONE               = 0x00,
1861     EBO_NAVIGATEONCE       = 0x01,
1862     EBO_SHOWFRAMES         = 0x02,
1863     EBO_ALWAYSNAVIGATE     = 0x04,
1864     EBO_NOTRAVELLOG        = 0x08,
1865     EBO_NOWRAPPERWINDOW    = 0x10,
1866     EBO_HTMLSHAREPOINTVIEW = 0x20
1867 } EXPLORER_BROWSER_OPTIONS;
1868
1869 cpp_quote("#define SID_SExplorerBrowserFrame IID_ICommDlgBrowser")
1870
1871 /*****************************************************************************
1872  * IExplorerBrowser interface
1873  */
1874 [
1875  object,
1876  uuid(DFD3B6B5-C10C-4BE9-85F6-A66969F402F6),
1877  pointer_default(unique)
1878 ]
1879 interface IExplorerBrowser : IUnknown
1880 {
1881
1882     [local] HRESULT Initialize(
1883         [in] HWND hwndParent,
1884         [in] const RECT *prc,
1885         [in, unique] const FOLDERSETTINGS *pfs);
1886
1887     HRESULT Destroy();
1888
1889     [local] HRESULT SetRect(
1890         [in,out,unique] HDWP *phdwp,
1891         [in] RECT rcBrowser);
1892
1893     HRESULT SetPropertyBag(
1894         [in, string] LPCWSTR pszPropertyBag);
1895
1896     HRESULT SetEmptyText(
1897         [in, string] LPCWSTR pszEmptyText);
1898
1899     HRESULT SetFolderSettings(
1900         [in] const FOLDERSETTINGS *pfs);
1901
1902     HRESULT Advise(
1903         [in] IExplorerBrowserEvents *psbe,
1904         [out] DWORD *pdwCookie);
1905
1906     HRESULT Unadvise(
1907         [in] DWORD dwCookie);
1908
1909     HRESULT SetOptions(
1910         [in] EXPLORER_BROWSER_OPTIONS dwFlag);
1911
1912     HRESULT GetOptions(
1913         [out] EXPLORER_BROWSER_OPTIONS *pdwFlag);
1914
1915     HRESULT BrowseToIDList(
1916         [in] PCUIDLIST_RELATIVE pidl,
1917         [in] UINT uFlags);
1918
1919     HRESULT BrowseToObject(
1920         [in] IUnknown *punk,
1921         [in] UINT uFlags);
1922
1923     HRESULT FillFromObject(
1924         [in] IUnknown *punk,
1925         [in] EXPLORER_BROWSER_FILL_FLAGS dwFlags);
1926
1927     HRESULT RemoveAll();
1928
1929     HRESULT GetCurrentView(
1930         [in] REFIID riid,
1931         [out, iid_is(riid)] void **ppv);
1932 }
1933
1934 /*****************************************************************************
1935  * INameSpaceTreeControl interface
1936  */
1937 [
1938  object,
1939  uuid(028212A3-B627-47E9-8856-C14265554E4F)
1940 ]
1941 interface INameSpaceTreeControl : IUnknown
1942 {
1943     [v1_enum] enum _NSTCSTYLE {
1944         NSTCS_HASEXPANDOS                 = 0x00000001,
1945         NSTCS_HASLINES                    = 0x00000002,
1946         NSTCS_SINGLECLICKEXPAND           = 0x00000004,
1947         NSTCS_FULLROWSELECT               = 0x00000008,
1948         NSTCS_SPRINGEXPAND                = 0x00000010,
1949         NSTCS_HORIZONTALSCROLL            = 0x00000020,
1950         NSTCS_ROOTHASEXPANDO              = 0x00000040,
1951         NSTCS_SHOWSELECTIONALWAYS         = 0x00000080,
1952         NSTCS_NOINFOTIP                   = 0x00000200,
1953         NSTCS_EVENHEIGHT                  = 0x00000400,
1954         NSTCS_NOREPLACEOPEN               = 0x00000800,
1955         NSTCS_DISABLEDRAGDROP             = 0x00001000,
1956         NSTCS_NOORDERSTREAM               = 0x00002000,
1957         NSTCS_RICHTOOLTIP                 = 0x00004000,
1958         NSTCS_BORDER                      = 0x00008000,
1959         NSTCS_NOEDITLABELS                = 0x00010000,
1960         NSTCS_TABSTOP                     = 0x00020000,
1961         NSTCS_FAVORITESMODE               = 0x00080000,
1962         NSTCS_AUTOHSCROLL                 = 0x00100000,
1963         NSTCS_FADEINOUTEXPANDOS           = 0x00200000,
1964         NSTCS_EMPTYTEXT                   = 0x00400000,
1965         NSTCS_CHECKBOXES                  = 0x00800000,
1966         NSTCS_PARTIALCHECKBOXES           = 0x01000000,
1967         NSTCS_EXCLUSIONCHECKBOXES         = 0x02000000,
1968         NSTCS_DIMMEDCHECKBOXES            = 0x04000000,
1969         NSTCS_NOINDENTCHECKS              = 0x08000000,
1970         NSTCS_ALLOWJUNCTIONS              = 0x10000000,
1971         NSTCS_SHOWTABSBUTTON              = 0x20000000,
1972         NSTCS_SHOWDELETEBUTTON            = 0x40000000,
1973         NSTCS_SHOWREFRESHBUTTON      = (int)0x80000000
1974     };
1975     typedef DWORD NSTCSTYLE;
1976
1977     [v1_enum] enum _NSTCROOTSTYLE {
1978         NSTCRS_VISIBLE                    = 0x0000,
1979         NSTCRS_HIDDEN                     = 0x0001,
1980         NSTCRS_EXPANDED                   = 0x0002
1981     };
1982     typedef DWORD NSTCROOTSTYLE;
1983
1984     [v1_enum] enum _NSTCITEMSTATE {
1985         NSTCIS_NONE                       = 0x0000,
1986         NSTCIS_SELECTED                   = 0x0001,
1987         NSTCIS_EXPANDED                   = 0x0002,
1988         NSTCIS_BOLD                       = 0x0004,
1989         NSTCIS_DISABLED                   = 0x0008,
1990         NSTCIS_SELECTEDNOEXPAND           = 0x0010
1991     };
1992     typedef DWORD NSTCITEMSTATE;
1993
1994     typedef [v1_enum] enum NSTCGNI {
1995         NSTCGNI_NEXT                      = 0,
1996         NSTCGNI_NEXTVISIBLE               = 1,
1997         NSTCGNI_PREV                      = 2,
1998         NSTCGNI_PREVVISIBLE               = 3,
1999         NSTCGNI_PARENT                    = 4,
2000         NSTCGNI_CHILD                     = 5,
2001         NSTCGNI_FIRSTVISIBLE              = 6,
2002         NSTCGNI_LASTVISIBLE               = 7
2003     } NSTCGNI;
2004
2005     HRESULT Initialize(
2006         [in] HWND hwndParent,
2007         [in, unique] RECT *prc,
2008         [in] NSTCSTYLE nstcsFlags);
2009
2010     HRESULT TreeAdvise(
2011         [in] IUnknown *punk,
2012         [out] DWORD *pdwCookie);
2013
2014     HRESULT TreeUnadvise(
2015         [in] DWORD dwCookie);
2016
2017     HRESULT AppendRoot(
2018         [in] IShellItem *psiRoot,
2019         [in] SHCONTF grfEnumFlags,
2020         [in] NSTCROOTSTYLE grfRootStyle,
2021         [in, unique] IShellItemFilter *pif);
2022
2023     HRESULT InsertRoot(
2024         [in] int iIndex,
2025         [in] IShellItem *psiRoot,
2026         [in] SHCONTF grfEnumFlags,
2027         [in] NSTCROOTSTYLE grfRootStyle,
2028         [in, unique] IShellItemFilter *pif);
2029
2030     HRESULT RemoveRoot(
2031         [in] IShellItem *psiRoot);
2032
2033     HRESULT RemoveAllRoots();
2034
2035     HRESULT GetRootItems(
2036         [out] IShellItemArray **ppsiaRootItems);
2037
2038     HRESULT SetItemState(
2039         [in] IShellItem *psi,
2040         [in] NSTCITEMSTATE nstcisMask,
2041         [in] NSTCITEMSTATE nstcisFlags);
2042
2043     HRESULT GetItemState(
2044         [in] IShellItem *psi,
2045         [in] NSTCITEMSTATE nstcismask,
2046         [out] NSTCITEMSTATE *pnstcisFlags);
2047
2048     HRESULT GetSelectedItems(
2049         [out] IShellItemArray **psiaItems);
2050
2051     HRESULT GetItemCustomState(
2052         [in] IShellItem *psi,
2053         [out] int *piStateNumber);
2054
2055     HRESULT SetItemCustomState(
2056         [in] IShellItem *psi,
2057         [in] int iStateNumber);
2058
2059     HRESULT EnsureItemVisible(
2060         [in] IShellItem *psi);
2061
2062     HRESULT SetTheme(
2063         [in, string] LPCWSTR pszTheme);
2064
2065     HRESULT GetNextItem(
2066         [in, unique] IShellItem *psi,
2067         [in] NSTCGNI nstcgi,
2068         [out] IShellItem **ppsiNext);
2069
2070     HRESULT HitTest(
2071         [in] POINT *ppt,
2072         [out] IShellItem **ppsiOut);
2073
2074     HRESULT GetItemRect(
2075         [in] IShellItem *psi,
2076         [out] RECT *prect);
2077
2078     HRESULT CollapseAll();
2079 }
2080
2081 /*****************************************************************************
2082  * INameSpaceTreeControl2 interface
2083  */
2084 [
2085  object,
2086  uuid(7CC7AED8-290E-49BC-8945-C1401CC9306C)
2087 ]
2088 interface INameSpaceTreeControl2 : INameSpaceTreeControl
2089 {
2090     typedef [v1_enum] enum NSTCSTYLE2 {
2091         NSTCS2_DEFAULT                     = 0x00,
2092         NSTCS2_INTERRUPTNOTIFICATIONS      = 0x01,
2093         NSTCS2_SHOWNULLSPACEMENU           = 0x02,
2094         NSTCS2_DISPLAYPADDING              = 0x04,
2095         NSTCS2_DISPLAYPINNEDONLY           = 0x08,
2096         NTSCS2_NOSINGLETONAUTOEXPAND       = 0x10,  /* The apparent typo here is   */
2097         NTSCS2_NEVERINSERTNONENUMERATED    = 0x20   /* present also in the Win SDK */
2098     } NSTCSTYLE2;
2099     cpp_quote("DEFINE_ENUM_FLAG_OPERATORS(NSTCSTYLE2)")
2100
2101     HRESULT SetControlStyle(
2102         [in] NSTCSTYLE nstcsMask,
2103         [in] NSTCSTYLE nstcsStyle);
2104
2105     HRESULT GetControlStyle(
2106         [in] NSTCSTYLE nstcsMask,
2107         [out] NSTCSTYLE *pnstcsStyle);
2108
2109     HRESULT SetControlStyle2(
2110         [in] NSTCSTYLE2 nstcsMask,
2111         [in] NSTCSTYLE2 nstcsStyle);
2112
2113     HRESULT GetControlStyle2(
2114         [in] NSTCSTYLE2 nstcsMask,
2115         [out] NSTCSTYLE2 *pnstcsStyle);
2116 }
2117
2118 /*****************************************************************************
2119  * INameSpaceTreeControlEvents interface
2120  */
2121
2122 [
2123  object,
2124  uuid(93D77985-B3D8-4484-8318-672CDDA002CE),
2125  local
2126 ]
2127 interface INameSpaceTreeControlEvents : IUnknown
2128 {
2129     [v1_enum] enum _NSTCEHITTEST {
2130         NSTCEHT_NOWHERE                    = 0x0001,
2131         NSTCEHT_ONITEMICON                 = 0x0002,
2132         NSTCEHT_ONITEMLABEL                = 0x0004,
2133         NSTCEHT_ONITEMIDENT                = 0x0008,
2134         NSTCEHT_ONITEMBUTTON               = 0x0010,
2135         NSTCEHT_ONITEMRIGHT                = 0x0020,
2136         NSTCEHT_ONITEMSTATEICON            = 0x0040,
2137         NSTCEHT_ONITEM                     = 0x0046,
2138         NSTCEHT_ONITEMTABBUTTON            = 0x1000
2139     };
2140     typedef DWORD NSTCEHITTEST;
2141
2142     [v1_enum] enum _NSTCECLICKTYPE {
2143         NSTCECT_LBUTTON                    = 0x1,
2144         NSTCECT_MBUTTON                    = 0x2,
2145         NSTCECT_RBUTTON                    = 0x3,
2146         NSTCECT_BUTTON                     = 0x3,
2147         NSTCECT_DBLCLICK                   = 0x4
2148     };
2149     typedef DWORD NSTCECLICKTYPE;
2150
2151     HRESULT OnItemClick(
2152         [in] IShellItem *psi,
2153         [in] NSTCEHITTEST nstceHitTest,
2154         [in] NSTCECLICKTYPE nstceClickType);
2155
2156     HRESULT OnPropertyItemCommit(
2157         [in] IShellItem *psi);
2158
2159     HRESULT OnItemStateChanging(
2160         [in] IShellItem *psi,
2161         [in] NSTCITEMSTATE nstcisMask,
2162         [in] NSTCITEMSTATE nstcisState);
2163
2164     HRESULT OnItemStateChanged(
2165         [in] IShellItem *psi,
2166         [in] NSTCITEMSTATE nstcisMask,
2167         [in] NSTCITEMSTATE nstcisState);
2168
2169     HRESULT OnSelectionChanged(
2170         [in] IShellItemArray *psiaSelection);
2171
2172     HRESULT OnKeyboardInput(
2173         [in] UINT uMsg,
2174         [in] WPARAM wParam,
2175         [in] LPARAM lParam);
2176
2177     HRESULT OnBeforeExpand(
2178         [in] IShellItem *psi);
2179
2180     HRESULT OnAfterExpand(
2181         [in] IShellItem *psi);
2182
2183     HRESULT OnBeginLabelEdit(
2184         [in] IShellItem *psi);
2185
2186     HRESULT OnEndLabelEdit(
2187         [in] IShellItem *psi);
2188
2189     HRESULT OnGetToolTip(
2190         [in] IShellItem *psi,
2191         [out, string, size_is(cchTip)] LPWSTR pszTip,
2192         [in] int cchTip);
2193
2194     HRESULT OnBeforeItemDelete(
2195         [in] IShellItem *psi);
2196
2197     HRESULT OnItemAdded(
2198         [in] IShellItem *psi,
2199         [in] BOOL fIsRoot);
2200
2201     HRESULT OnItemDeleted(
2202         [in] IShellItem *psi,
2203         [in] BOOL fIsRoot);
2204
2205     HRESULT OnBeforeContextMenu(
2206         [in, unique] IShellItem *psi,
2207         [in] REFIID riid,
2208         [out, iid_is(riid)] void **ppv);
2209
2210     HRESULT OnAfterContextMenu(
2211         [in] IShellItem *psi,
2212         [in] IContextMenu *pcmIn,
2213         [in] REFIID riid,
2214         [out, iid_is(riid)] void **ppv);
2215
2216     HRESULT OnBeforeStateImageChange(
2217         [in] IShellItem *psi);
2218
2219     HRESULT OnGetDefaultIconIndex(
2220         [in] IShellItem *psi,
2221         [out] int *piDefaultIcon,
2222         [out] int *piOpenIcon);
2223 }
2224
2225 cpp_quote("#ifdef MIDL_PASS")
2226 typedef IUnknown *HIMAGELIST;
2227 cpp_quote("#endif")
2228
2229 /*****************************************************************************
2230  * INameSpaceTreeControlCustomDraw interface
2231  */
2232 [
2233  object,
2234  uuid(2D3BA758-33EE-42D5-BB7B-5F3431D86C78),
2235  local
2236 ]
2237
2238 interface INameSpaceTreeControlCustomDraw : IUnknown
2239 {
2240     typedef struct NSTCCUSTOMDRAW
2241     {
2242         IShellItem *psi;
2243         UINT uItemState;
2244         NSTCITEMSTATE nstcis;
2245         LPCWSTR pszText;
2246         int iImage;
2247         HIMAGELIST himl;
2248         int iLevel;
2249         int iIndent;
2250     } NSTCCUSTOMDRAW;
2251
2252     HRESULT PrePaint(
2253         [in] HDC hdc,
2254         [in] RECT *prc,
2255         [out] LRESULT *plres);
2256
2257     HRESULT PostPaint(
2258         [in] HDC hdc,
2259         [in] RECT *prc);
2260
2261     HRESULT ItemPrePaint(
2262         [in] HDC hdc,
2263         [in] RECT *prc,
2264         [in, out] COLORREF *pclrText,
2265         [in, out] COLORREF *pclrTextBk,
2266         [out] LRESULT *plres);
2267
2268     HRESULT ItemPostPaint(
2269         [in] HDC hdc,
2270         [in] RECT *prc,
2271         [in] NSTCCUSTOMDRAW *pnstccdItem);
2272 }
2273
2274 /*****************************************************************************
2275  * INameSpaceTreeControlDropHandler interface
2276  */
2277 [
2278  object,
2279  uuid(F9C665D6-C2F2-4C19-BF33-8322D7352F51),
2280  local
2281 ]
2282 interface INameSpaceTreeControlDropHandler : IUnknown
2283 {
2284     HRESULT OnDragEnter(
2285         [in, unique] IShellItem *psiOver,
2286         [in] IShellItemArray *psiaData,
2287         [in] BOOL fOutsideSource,
2288         [in] DWORD grfKeyState,
2289         [in, out] DWORD *pdwEffect);
2290
2291     HRESULT OnDragOver(
2292         [in, unique] IShellItem *psiOver,
2293         [in] IShellItemArray *psiaData,
2294         [in] DWORD grfKeyState,
2295         [in, out] DWORD *pdwEffect);
2296
2297     HRESULT OnDragPosition(
2298         [in, unique] IShellItem *psiOver,
2299         [in] IShellItemArray *psiaData,
2300         [in] int iNewPosition,
2301         [in] int iOldPosition);
2302
2303     HRESULT OnDrop(
2304         [in, unique] IShellItem *psiOver,
2305         [in] IShellItemArray *psiaData,
2306         [in] int iPosition,
2307         [in] DWORD grfKeyState,
2308         [in, out] DWORD *pdwEffect);
2309
2310     HRESULT OnDropPosition(
2311         [in, unique] IShellItem *psiOver,
2312         [in] IShellItemArray *psiaData,
2313         [in] int iNewPosition,
2314         [in] int iOldPosition);
2315
2316     HRESULT OnDragLeave(
2317         [in, unique] IShellItem *psiOver);
2318 }
2319 cpp_quote("#define NSTCDHPOS_ONTOP -1")
2320
2321 interface IFileDialog;
2322
2323 typedef [v1_enum] enum FDE_OVERWRITE_RESPONSE
2324 {
2325     FDEOR_DEFAULT  = 0,
2326     FDEOR_ACCCEP   = 1,
2327     FDEOR_REFUSE   = 2
2328 } FDE_OVERWRITE_RESPONSE;
2329
2330 typedef [v1_enum] enum FDE_SHAREVIOLATION_RESPONSE
2331 {
2332     FDESVR_DEFAULT = 0,
2333     FDESVR_ACCEPT  = 1,
2334     FDESVR_REFUSE  = 2
2335 } FDE_SHAREVIOLATION_RESPONSE;
2336
2337 /*****************************************************************************
2338  * IFileDialogEvents interface
2339  */
2340 [
2341  object,
2342  uuid(973510DB-7D7F-452B-8975-74A85828D354),
2343  pointer_default(unique)
2344 ]
2345 interface IFileDialogEvents : IUnknown
2346 {
2347     HRESULT OnFileOk(
2348         [in] IFileDialog *pfd);
2349
2350     HRESULT OnFolderChanging(
2351         [in] IFileDialog *pfd,
2352         [in] IShellItem *psiFolder);
2353
2354     HRESULT OnFolderChange(
2355         [in] IFileDialog *pfd);
2356
2357     HRESULT OnSelectionChange(
2358         [in] IFileDialog *pfd);
2359
2360     HRESULT OnShareViolation(
2361         [in] IFileDialog *pfd,
2362         [in] IShellItem *psi,
2363         [out] FDE_SHAREVIOLATION_RESPONSE *pResponse);
2364
2365     HRESULT OnTypeChange(
2366         [in] IFileDialog *pfd);
2367
2368     HRESULT OnOverwrite(
2369         [in] IFileDialog *pfd,
2370         [in] IShellItem *psi,
2371         [out] FDE_OVERWRITE_RESPONSE *pResponse);
2372 }
2373
2374 /*****************************************************************************
2375  * IModalWindow interface
2376  */
2377 [
2378  object,
2379  uuid(B4DB1657-70D7-485E-8E3E-6FCB5A5C1802),
2380  pointer_default(unique)
2381 ]
2382 interface IModalWindow : IUnknown
2383 {
2384     [local]
2385     HRESULT Show(
2386         [in, unique, annotation("__in_opt")] HWND hwndOwner);
2387
2388     [call_as(Show)]
2389     HRESULT RemoteShow(
2390         [in, unique] HWND hwndOwner);
2391 }
2392
2393 typedef [v1_enum] enum FDAP
2394 {
2395     FDAP_BOTTOM    = 0,
2396     FDAP_TOP       = 1
2397 } FDAP;
2398
2399 /*****************************************************************************
2400  * IFileDialog interface
2401  */
2402 [
2403  object,
2404  uuid(42F85136-DB7E-439C-85F1-E4075D135FC8),
2405  pointer_default(unique)
2406 ]
2407 interface IFileDialog : IModalWindow
2408 {
2409     [v1_enum] enum _FILEOPENDIALOGOPTIONS
2410     {
2411         FOS_OVERWRITEPROMPT     = 0x00000002,
2412         FOS_STRICTFILETYPES     = 0x00000004,
2413         FOS_NOCHANGEDIR         = 0x00000008,
2414         FOS_PICKFOLDERS         = 0x00000020,
2415         FOS_FORCEFILESYSTEM     = 0x00000040,
2416         FOS_ALLNONSTORAGEITEMS  = 0x00000080,
2417         FOS_NOVALIDATE          = 0x00000100,
2418         FOS_ALLOWMULTISELECT    = 0x00000200,
2419         FOS_PATHMUSTEXIST       = 0x00000800,
2420         FOS_FILEMUSTEXIST       = 0x00001000,
2421         FOS_CREATEPROMPT        = 0x00002000,
2422         FOS_SHAREAWARE          = 0x00004000,
2423         FOS_NOREADONLYRETURN    = 0x00008000,
2424         FOS_NOTESTFILECREATE    = 0x00010000,
2425         FOS_HIDEMRUPLACES       = 0x00020000,
2426         FOS_HIDEPINNEDPLACES    = 0x00040000,
2427         FOS_NODEREFERENCELINKS  = 0x00100000,
2428         FOS_DONTADDTORECENT     = 0x02000000,
2429         FOS_FORCESHOWHIDDEN     = 0x10000000,
2430         FOS_DEFAULTNOMINIMODE   = 0x20000000,
2431         FOS_FORCEPREVIEWPANEON  = 0x40000000
2432     };
2433     typedef DWORD FILEOPENDIALOGOPTIONS;
2434
2435     HRESULT SetFileTypes(
2436         [in] UINT cFileTypes,
2437         [in, size_is(cFileTypes)] const COMDLG_FILTERSPEC *rgFilterSpec);
2438
2439     HRESULT SetFileTypeIndex(
2440         [in] UINT iFileType);
2441
2442     HRESULT GetFileTypeIndex(
2443         [out] UINT *piFileType);
2444
2445     HRESULT Advise(
2446         [in] IFileDialogEvents *pfde,
2447         [out] DWORD *pdwCookie);
2448
2449     HRESULT Unadvise(
2450         [in] DWORD dwCookie);
2451
2452     HRESULT SetOptions(
2453         [in] FILEOPENDIALOGOPTIONS fos);
2454
2455     HRESULT GetOptions(
2456         [in] FILEOPENDIALOGOPTIONS *pfos);
2457
2458     HRESULT SetDefaultFolder(
2459         [in] IShellItem *psi);
2460
2461     HRESULT SetFolder(
2462         [in] IShellItem *psi);
2463
2464     HRESULT GetFolder(
2465         [out] IShellItem **ppsi);
2466
2467     HRESULT GetCurrentSelection(
2468         [out] IShellItem **ppsi);
2469
2470     HRESULT SetFileName(
2471         [in, string] LPCWSTR pszName);
2472
2473     HRESULT GetFileName(
2474         [out, string] LPWSTR *pszName);
2475
2476     HRESULT SetTitle(
2477         [in, string] LPCWSTR pszTitle);
2478
2479     HRESULT SetOkButtonLabel(
2480         [in, string] LPCWSTR pszText);
2481
2482     HRESULT SetFileNameLabel(
2483         [in, string] LPCWSTR pszLabel);
2484
2485     HRESULT GetResult(
2486         [out] IShellItem **ppsi);
2487
2488     HRESULT AddPlace(
2489         [in] IShellItem *psi,
2490         [in] FDAP fdap);
2491
2492     HRESULT SetDefaultExtension(
2493         [in, string] LPCWSTR pszDefaultExtension);
2494
2495     HRESULT Close(
2496         [in] HRESULT hr);
2497
2498     HRESULT SetClientGuid(
2499         [in] REFGUID guid);
2500
2501     HRESULT ClearClientData();
2502
2503     HRESULT SetFilter(
2504         [in] IShellItemFilter *pFilter);
2505 }
2506
2507 /*****************************************************************************
2508  * IFileDialog2 interface
2509  */
2510 [
2511  object,
2512  uuid(61744FC7-85B5-4791-A9B0-272276309B13),
2513  pointer_default(unique)
2514 ]
2515 interface IFileDialog2 : IFileDialog
2516 {
2517     HRESULT SetCancelButtonLabel(
2518         [in] LPCWSTR pszLabel);
2519
2520     HRESULT SetNavigationRoot(
2521         [in] IShellItem *psi);
2522 }
2523
2524 /*****************************************************************************
2525  * IFileOperationProgressSink interface
2526  */
2527 [
2528  object,
2529  uuid(04B0F1A7-9490-44BC-96E1-4296A31252E2),
2530  pointer_default(unique)
2531 ]
2532 interface IFileOperationProgressSink : IUnknown
2533 {
2534     HRESULT StartOperations();
2535
2536     HRESULT FinishOperations(
2537         [in] HRESULT hrResult);
2538
2539     HRESULT PreRenameItem(
2540         [in] DWORD dwFlags,
2541         [in] IShellItem *psiItem,
2542         [in, unique, string] LPCWSTR pszNewName);
2543
2544     HRESULT PostRenameItem(
2545         [in] DWORD dwFlags,
2546         [in] IShellItem *psiItem,
2547         [in, string] LPCWSTR pszNewName,
2548         [in] HRESULT hrRename,
2549         [in] IShellItem *psiNewlyCreated);
2550
2551     HRESULT PreMoveItem(
2552         [in] DWORD dwFlags,
2553         [in] IShellItem *psiItem,
2554         [in] IShellItem *psiDestinationFolder,
2555         [in, unique, string] LPCWSTR pszNewName);
2556
2557     HRESULT PostMoveItem(
2558         [in] DWORD dwFlags,
2559         [in] IShellItem *psiItem,
2560         [in] IShellItem *psiDestinationFolder,
2561         [in, unique, string] LPCWSTR pszNewName,
2562         [in] HRESULT hrMove,
2563         [in] IShellItem *psiNewlyCreated);
2564
2565     HRESULT PreCopyItem(
2566         [in] DWORD dwFlags,
2567         [in] IShellItem *psiItem,
2568         [in] IShellItem *psiDestinationFolder,
2569         [in, unique, string] LPCWSTR pszNewName);
2570
2571     HRESULT PostCopyItem(
2572         [in] DWORD dwFlags,
2573         [in] IShellItem *psiItem,
2574         [in] IShellItem *psiDestinationFolder,
2575         [in, unique, string] LPCWSTR pszNewName,
2576         [in] HRESULT hrCopy,
2577         [in] IShellItem *psiNewlyCreated);
2578
2579     HRESULT PreDeleteItem(
2580         [in] DWORD dwFlags,
2581         [in] IShellItem *psiItem);
2582
2583     HRESULT PostDeleteItem(
2584         [in] DWORD dwFlags,
2585         [in] IShellItem *psiItem,
2586         [in] HRESULT hrDelete,
2587         [in] IShellItem *psiNewlyCreated);
2588
2589     HRESULT PreNewItem(
2590         [in] DWORD dwFlags,
2591         [in] IShellItem *psiDestinationFolder,
2592         [in, unique, string] LPCWSTR pszNewName);
2593
2594     HRESULT PostNewItem(
2595         [in] DWORD dwFlags,
2596         [in] IShellItem *psiDestinationFolder,
2597         [in, unique, string] LPCWSTR pszNewName,
2598         [in, unique, string] LPCWSTR pszTemplateName,
2599         [in] DWORD dwFileAttributes,
2600         [in] HRESULT hrNew,
2601         [in] IShellItem *psiNewItem);
2602
2603     HRESULT UpdateProgress(
2604         [in] UINT iWorkTotal,
2605         [in] UINT iWorkSoFar);
2606
2607     HRESULT ResetTimer();
2608
2609     HRESULT PauseTimer();
2610
2611     HRESULT ResumeTimer();
2612 }
2613
2614 /*****************************************************************************
2615  * IFileSaveDialog interface
2616  */
2617 [
2618  object,
2619  uuid(84BCCD23-5FDE-4CDB-AEA4-AF64B83D78AB),
2620  pointer_default(unique)
2621 ]
2622 interface IFileSaveDialog : IFileDialog
2623 {
2624     HRESULT SetSaveAsItem(
2625         [in] IShellItem *psi);
2626
2627     HRESULT SetProperties(
2628         [in] IPropertyStore *pStore);
2629
2630     HRESULT SetCollectedProperties(
2631         [in] IPropertyDescriptionList *pList,
2632         [in] BOOL fAppendDefault);
2633
2634     HRESULT GetProperties(
2635         [in] IPropertyStore **ppStore);
2636
2637     HRESULT ApplyProperties(
2638         [in] IShellItem *psi,
2639         [in] IPropertyStore *pStore,
2640         [in, unique] HWND hwnd,
2641         [in, unique] IFileOperationProgressSink *pSink);
2642 }
2643
2644
2645 /*****************************************************************************
2646  * IFileOpenDialog interface
2647  */
2648 [
2649  object,
2650  uuid(D57C7288-D4AD-4768-BE02-9D969532D960),
2651  pointer_default(unique)
2652 ]
2653 interface IFileOpenDialog : IFileDialog
2654 {
2655     HRESULT GetResults(
2656         [out] IShellItemArray **ppenum);
2657
2658     HRESULT GetSelectedItems(
2659         [out] IShellItemArray **ppsai);
2660 }
2661
2662 typedef [v1_enum] enum CDCONTROLSTATEF
2663 {
2664     CDCS_INACTIVE       = 0x0,
2665     CDCS_ENABLED        = 0x1,
2666     CDCS_VISIBLE        = 0x2,
2667     CDCS_ENABLEDVISIBLE = 0x3
2668 } CDCONTROLSTATEF;
2669 cpp_quote("DEFINE_ENUM_FLAG_OPERATORS(CDCONTROLSTATEF)")
2670 /*****************************************************************************
2671  * IFileDialogCustomize interface
2672  */
2673 [
2674  object,
2675  uuid(E6FDD21A-163F-4975-9C8C-A69F1BA37034),
2676  pointer_default(unique)
2677 ]
2678 interface IFileDialogCustomize : IUnknown
2679 {
2680     HRESULT EnableOpenDropDown(
2681         [in] DWORD dwIDCtl);
2682
2683     HRESULT AddMenu(
2684         [in] DWORD dwIDCtl,
2685         [in, string] LPCWSTR pszLabel);
2686
2687     HRESULT AddPushButton(
2688         [in] DWORD dwIDCtl,
2689         [in, string] LPCWSTR pszLabel);
2690
2691     HRESULT AddComboBox(
2692         [in] DWORD dwIDCtl);
2693
2694     HRESULT AddRadioButtonList(
2695         [in] DWORD dwIDCtl);
2696
2697     HRESULT AddCheckButton(
2698         [in] DWORD dwIDCtl,
2699         [in, string] LPCWSTR pszLabel,
2700         [in] BOOL bChecked);
2701
2702     HRESULT AddEditBox(
2703         [in] DWORD dwIDCtl,
2704         [in, string] LPCWSTR pszText);
2705
2706     HRESULT AddSeparator(
2707         [in] DWORD dwIDCtl);
2708
2709     HRESULT AddText(
2710         [in] DWORD dwIDCtl,
2711         [in, string] LPCWSTR pszText);
2712
2713     HRESULT SetControlLabel(
2714         [in] DWORD dwIDCtl,
2715         [in, string] LPCWSTR pszLabel);
2716
2717     HRESULT GetControlState(
2718         [in] DWORD dwIDCtl,
2719         [out] CDCONTROLSTATEF *pdwState);
2720
2721     HRESULT SetControlState(
2722         [in] DWORD dwIDCtl,
2723         [in] CDCONTROLSTATEF dwState);
2724
2725     HRESULT GetEditBoxText(
2726         [in] DWORD dwIDCtl,
2727         [out, string] WCHAR **ppszText);
2728
2729     HRESULT SetEditBoxText(
2730         [in] DWORD dwIDCtl,
2731         [in, string] LPCWSTR pszText);
2732
2733     HRESULT GetCheckButtonState(
2734         [in] DWORD dwIDCtl,
2735         [out] BOOL *pbChecked);
2736
2737     HRESULT SetCheckButtonState(
2738         [in] DWORD dwIDCtl,
2739         [in] BOOL bChecked);
2740
2741     HRESULT AddControlItem(
2742         [in] DWORD dwIDCtl,
2743         [in] DWORD dwIDItem,
2744         [in] LPCWSTR pszLabel);
2745
2746     HRESULT RemoveControlItem(
2747         [in] DWORD dwIDCtl,
2748         [in] DWORD dwIDItem);
2749
2750     HRESULT RemoveAllControlItems(
2751         [in] DWORD dwIDCtl);
2752
2753     HRESULT GetControlItemState(
2754         [in] DWORD dwIDCtl,
2755         [in] DWORD dwIDItem,
2756         [out] CDCONTROLSTATEF *pdwState);
2757
2758     HRESULT SetControlItemState(
2759         [in] DWORD dwIDCtl,
2760         [in] DWORD dwIDItem,
2761         [in] CDCONTROLSTATEF dwState);
2762
2763     HRESULT GetSelectedControlItem(
2764         [in] DWORD dwIDCtl,
2765         [out] DWORD *pdwIDItem);
2766
2767     HRESULT SetSelectedControlItem(
2768         [in] DWORD dwIDCtl,
2769         [in] DWORD dwIDItem);
2770
2771     HRESULT StartVisualGroup(
2772         [in] DWORD dwIDCtl,
2773         [in, string] LPCWSTR pszLabel);
2774
2775     HRESULT EndVisualGroup();
2776
2777     HRESULT MakeProminent(
2778         [in] DWORD dwIDCtl);
2779
2780     HRESULT SetControlItemText(
2781         [in] DWORD dwIDCtl,
2782         [in] DWORD dwIDItem,
2783         [in, string] LPCWSTR pszLabel);
2784 }
2785
2786 /*****************************************************************************
2787  * IFileDialogControlEvents interface
2788  */
2789 [
2790  object,
2791  uuid(36116642-D713-4B97-9B83-7484A9D00433),
2792  pointer_default(unique)
2793 ]
2794 interface IFileDialogControlEvents : IUnknown
2795 {
2796     HRESULT OnItemSelected(
2797         [in] IFileDialogCustomize *pfdc,
2798         [in] DWORD dwIDCtl,
2799         [in] DWORD dwIDItem);
2800
2801     HRESULT OnButtonClicked(
2802         [in] IFileDialogCustomize *pfdc,
2803         [in] DWORD dwIDCtl);
2804
2805     HRESULT OnCheckButtonToggled(
2806         [in] IFileDialogCustomize *pfdc,
2807         [in] BOOL dwIDCtl,
2808         [in] BOOL bChecked);
2809
2810     HRESULT OnControlActivating(
2811         [in] IFileDialogCustomize *pfdc,
2812         [in] DWORD dwIDCtl);
2813 }
2814
2815 typedef [v1_enum] enum tagKF_CATEGORY
2816 {
2817     KF_CATEGORY_VIRTUAL = 0x00000001,
2818     KF_CATEGORY_FIXED   = 0x00000002,
2819     KF_CATEGORY_COMMON  = 0x00000003,
2820     KF_CATEGORY_PERUSER = 0x00000004
2821 } KF_CATEGORY;
2822
2823 typedef [v1_enum] enum tagKF_REDIRECTION_CAPABILITIES
2824 {
2825     KF_REDIRECTION_CAPABILITIES_ALLOW_ALL               = 0x000000ff,
2826     KF_REDIRECTION_CAPABILITIES_REDIRECTABLE            = 0x00000001,
2827     KF_REDIRECTION_CAPABILITIES_DENY_ALL                = 0x000fff00,
2828     KF_REDIRECTION_CAPABILITIES_DENY_POLICY_REDIRECTED  = 0x00000100,
2829     KF_REDIRECTION_CAPABILITIES_DENY_POLICY             = 0x00000200,
2830     KF_REDIRECTION_CAPABILITIES_DENY_PERMISSIONS        = 0x00000400
2831 } KF_REDIRECTION_CAPABILITIES;
2832
2833 typedef [v1_enum] enum tagKF_DEFINITION_FLAGS
2834 {
2835     KFDF_LOCAL_REDIRECT_ONLY    = 0x00000002,
2836     KFDF_ROAMABLE               = 0x00000004,
2837     KFDF_PRECREATE              = 0x00000008
2838 } KF_DEFINITION_FLAGS;
2839
2840 typedef struct tagKNOWNFOLDER_DEFINITION
2841 {
2842     KF_CATEGORY         category;
2843     LPWSTR              pszName;
2844     LPWSTR              pszDescription;
2845     KNOWNFOLDERID       fidParent;
2846     LPWSTR              pszRelativePath;
2847     LPWSTR              pszParsingName;
2848     LPWSTR              pszTooltip;
2849     LPWSTR              pszLocalizedName;
2850     LPWSTR              pszIcon;
2851     LPWSTR              pszSecurity;
2852     DWORD               dwAttributes;
2853     KF_DEFINITION_FLAGS kfdFlags;
2854     FOLDERTYPEID        ftidType;
2855 } KNOWNFOLDER_DEFINITION;
2856
2857 [
2858  object,
2859  uuid(3aa7af7e-9b36-420C-a8e3-f77d4674a488),
2860  pointer_default(ref)
2861 ]
2862 interface IKnownFolder : IUnknown
2863 {
2864     HRESULT GetId(
2865         [out] KNOWNFOLDERID *pkfid);
2866
2867     HRESULT GetCategory(
2868         [out] KF_CATEGORY *pCategory);
2869
2870     HRESULT GetShellItem(
2871         [in] DWORD dwFlags,
2872         [in] REFIID riid,
2873         [out, iid_is(riid)] void **ppv);
2874
2875     HRESULT GetPath(
2876         [in] DWORD dwFlags,
2877         [out, string] LPWSTR *ppszPath);
2878
2879     HRESULT SetPath(
2880         [in] DWORD dwFlags,
2881         [in, string] LPCWSTR pszPath);
2882
2883     HRESULT GetIDList(
2884         [in] DWORD dwFlags,
2885         [out] PIDLIST_ABSOLUTE *ppidl);
2886
2887     HRESULT GetFolderType(
2888         [out] FOLDERTYPEID *pftid);
2889
2890     HRESULT GetRedirectionCapabilities(
2891         [out] KF_REDIRECTION_CAPABILITIES *pCapabilities);
2892
2893     HRESULT GetFolderDefinition(
2894         [out] KNOWNFOLDER_DEFINITION *pKFD);
2895 }
2896
2897 typedef [v1_enum] enum tagKF_REDIRECT_FLAGS
2898 {
2899     KF_REDIRECT_USER_EXCLUSIVE      = 0x00000001,
2900     KF_REDIRECT_COPY_SOURCE_DACL    = 0x00000002,
2901     KF_REDIRECT_OWNER_USER          = 0x00000004,
2902     KF_REDIRECT_SET_OWNER_EXPLICIT  = 0x00000008,
2903     KF_REDIRECT_CHECK_ONLY          = 0x00000010,
2904     KF_REDIRECT_WITH_UI             = 0x00000020,
2905     KF_REDIRECT_UNPIN               = 0x00000040,
2906     KF_REDIRECT_PIN                 = 0x00000080,
2907     KF_REDIRECT_COPY_CONTENTS       = 0x00000200,
2908     KF_REDIRECT_DEL_SOURCE_CONTENTS = 0x00000400,
2909     KF_REDIRECT_EXCLUDE_ALL_KNOWN_SUBFOLDERS = 0x00000800
2910 } KF_REDIRECT_FLAGS;
2911
2912 [
2913     object,
2914     uuid(8BE2D872-86AA-4d47-B776-32CCA40C7018),
2915     pointer_default(ref)
2916 ]
2917 interface IKnownFolderManager : IUnknown
2918 {
2919     typedef [v1_enum] enum tagFFFP_MODE
2920     {
2921         FFFP_EXACTMATCH,
2922         FFFP_NEARESTPARENTMATCH
2923     } FFFP_MODE;
2924
2925     HRESULT FolderIdFromCsidl(
2926         [in] int nCsidl,
2927         [out] KNOWNFOLDERID *pfid);
2928
2929     HRESULT FolderIdToCsidl(
2930         [in] REFKNOWNFOLDERID rfid,
2931         [out] int *pnCsidl);
2932
2933     HRESULT GetFolderIds(
2934         [out, size_is(, *pCount)] KNOWNFOLDERID **ppKFId,
2935         [in, out] UINT *pCount);
2936
2937     HRESULT GetFolder(
2938         [in] REFKNOWNFOLDERID rfid,
2939         [out] IKnownFolder **ppkf);
2940
2941     HRESULT GetFolderByName(
2942         [in, string] LPCWSTR pszCanonicalName,
2943         [out] IKnownFolder **ppkf);
2944
2945     HRESULT RegisterFolder(
2946         [in] REFKNOWNFOLDERID rfid,
2947         [in] KNOWNFOLDER_DEFINITION const *pKFD);
2948
2949     HRESULT UnregisterFolder(
2950         [in] REFKNOWNFOLDERID rfid);
2951
2952     HRESULT FindFolderFromPath(
2953         [in, string] LPCWSTR pszPath,
2954         [in] FFFP_MODE mode,
2955         [out] IKnownFolder **ppkf);
2956
2957     HRESULT FindFolderFromIDList(
2958         [in] PCIDLIST_ABSOLUTE pidl,
2959         [out] IKnownFolder **ppkf);
2960
2961     HRESULT Redirect(
2962         [in] REFKNOWNFOLDERID rfid,
2963         [in, unique] HWND hwnd,
2964         [in] KF_REDIRECT_FLAGS flags,
2965         [in, unique, string] LPCWSTR pszTargetPath,
2966         [in] UINT cFolders,
2967         [in, size_is(cFolders), unique] KNOWNFOLDERID const *pExclusion,
2968         [out, string] LPWSTR *ppszError);
2969 }
2970
2971 /*****************************************************************************
2972  * ShellObjects typelibrary
2973  */
2974 [
2975  uuid(50A7E9B1-70EF-11D1-B75A-00A0C90564FE),
2976  lcid(0x0000),
2977  version(1.0)
2978 ]
2979 library ShellObjects
2980 {
2981     [
2982         uuid(71F96385-DDD6-48D3-A0C1-AE06E8B055FB)
2983     ]
2984     coclass ExplorerBrowser
2985     {
2986         interface IExplorerBrowser;
2987     }
2988
2989     [
2990         uuid(DC1C5A9C-E88A-4DDE-A5A1-60F82A20AEF7)
2991     ]
2992     coclass FileOpenDialog
2993     {
2994         interface IFileOpenDialog;
2995     }
2996
2997     [
2998         uuid(C0B4E2F3-BA21-4773-8DBA-335EC946EB8B)
2999     ]
3000     coclass FileSaveDialog
3001     {
3002         interface IFileSaveDialog;
3003     }
3004
3005     [
3006         uuid(AE054212-3535-4430-83ED-D501AA6680E6)
3007     ]
3008     coclass NamespaceTreeControl
3009     {
3010         interface INameSpaceTreeControl2;
3011     }
3012
3013     [
3014         uuid(4df0c730-df9d-4ae3-9153-aa6b82e9795a)
3015     ]
3016     coclass KnownFolderManager
3017     {
3018         interface IKnownFolderManager;
3019     }
3020 }