include/psdk/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 import "objectarray.idl";
  35 /* FIXME: import "structuredquery.idl"; */
  36
  37 cpp_quote("/* FIXME: #include <sherrors.h> */")
  38
  39
  40 /*****************************************************************************
  41  * IPersistFolder interface
  42  */
  43 [
  44     object,
  45     uuid(000214ea-0000-0000-c000-000000000046),
  46     pointer_default(unique)
  47 ]
  48 interface IPersistFolder : IPersist
  49 {
  50     typedef IPersistFolder *LPPERSISTFOLDER;
  51
  52     HRESULT Initialize( [in] LPCITEMIDLIST pidl );
  53 }
  54
  55
  56 /*****************************************************************************
  57  * IPersistFolder2 interface
  58  */
  59 [
  60     object,
  61     uuid(1ac3d9f0-175c-11d1-95be-00609797ea4f),
  62     pointer_default(unique)
  63 ]
  64 interface IPersistFolder2 : IPersistFolder
  65 {
  66     typedef IPersistFolder2 *LPPERSISTFOLDER2;
  67
  68     HRESULT GetCurFolder( [out] LPITEMIDLIST *ppidl );
  69 }
  70
  71
  72 /*****************************************************************************
  73  * IPersistIDList interface
  74  */
  75 [
  76     object,
  77     uuid(1079acfc-29bd-11d3-8e0d-00c04f6837d5),
  78     pointer_default(unique)
  79 ]
  80 interface IPersistIDList : IPersist
  81 {
  82     HRESULT SetIDList( [in] LPCITEMIDLIST pidl );
  83     HRESULT GetIDList( [out] LPITEMIDLIST *ppidl );
  84 }
  85
  86
  87 /*****************************************************************************
  88  * IEnumIDList interface
  89  */
  90 [
  91     object,
  92     uuid(000214f2-0000-0000-c000-000000000046),
  93     pointer_default(unique)
  94 ]
  95 interface IEnumIDList : IUnknown
  96 {
  97     typedef IEnumIDList *LPENUMIDLIST;
  98
  99     HRESULT Next(
 100         [in] ULONG celt,
 101         [out, size_is(celt), length_is(*pceltFetched)] LPITEMIDLIST *rgelt,
 102         [out] ULONG *pceltFetched);
 103
 104     HRESULT Skip( [in] ULONG celt );
 105     HRESULT Reset();
 106     HRESULT Clone( [out] IEnumIDList **ppenum );
 107 }
 108
 109 /*****************************************************************************
 110  * IShellPropSheetExt interface
 111  */
 112 cpp_quote("#if 0")
 113     typedef LPARAM LPFNSVADDPROPSHEETPAGE;
 114 cpp_quote("#else")
 115 cpp_quote("#include <prsht.h>")
 116 cpp_quote("typedef LPFNADDPROPSHEETPAGE LPFNSVADDPROPSHEETPAGE;")
 117 cpp_quote("#endif")
 118
 119 [
 120     object,
 121     uuid(000214E9-0000-0000-C000-000000000046),
 122     pointer_default(unique),
 123     local
 124 ]
 125 interface IShellPropSheetExt : IUnknown
 126 {
 127     enum tagSHELLPROPSHEETEXTPAGEID {
 128         EXPPS_FILETYPES = 0x1
 129     };
 130
 131     typedef UINT EXPPS;
 132
 133     HRESULT AddPages(
 134         [in] LPFNSVADDPROPSHEETPAGE pfnAddPage,
 135         [in] LPARAM lParam);
 136     HRESULT ReplacePage(
 137         [in] EXPPS uPageID,
 138         [in] LPFNSVADDPROPSHEETPAGE pfnReplaceWith,
 139         [in] LPARAM lParam);
 140 }
 141 typedef IShellPropSheetExt *LPSHELLPROPSHEETEXT;
 142
 143 /*****************************************************************************
 144  * IShellFolder interface
 145  */
 146 [
 147     object,
 148     uuid(000214e6-0000-0000-c000-000000000046),
 149     pointer_default(unique)
 150 ]
 151 interface IShellFolder : IUnknown
 152 {
 153     typedef IShellFolder * LPSHELLFOLDER;
 154
 155     typedef enum tagSHGDN
 156     {
 157         SHGDN_NORMAL = 0,
 158         SHGDN_INFOLDER = 1,
 159         SHGDN_FOREDITING = 0x1000,
 160         SHGDN_INCLUDE_NONFILESYS = 0x2000,
 161         SHGDN_FORADDRESSBAR = 0x4000,
 162         SHGDN_FORPARSING = 0x8000
 163     } SHGNO;
 164
 165     typedef DWORD SHGDNF;
 166
 167     enum tagSHCONTF
 168     {
 169         SHCONTF_FOLDERS = 32,
 170         SHCONTF_NONFOLDERS = 64,
 171         SHCONTF_INCLUDEHIDDEN = 128,
 172         SHCONTF_INIT_ON_FIRST_NEXT = 256,
 173         SHCONTF_NETPRINTERSRCH = 512,
 174         SHCONTF_SHAREABLE = 1024,
 175         SHCONTF_STORAGE = 2048
 176     };
 177
 178     typedef DWORD SHCONTF;
 179
 180     cpp_quote("#define SFGAO_CANCOPY           DROPEFFECT_COPY")
 181     cpp_quote("#define SFGAO_CANMOVE           DROPEFFECT_MOVE")
 182     cpp_quote("#define SFGAO_CANLINK           DROPEFFECT_LINK")
 183     cpp_quote("#define SFGAO_STORAGE           0x00000008L")
 184     cpp_quote("#define SFGAO_CANRENAME         0x00000010L")
 185     cpp_quote("#define SFGAO_CANDELETE         0x00000020L")
 186     cpp_quote("#define SFGAO_HASPROPSHEET      0x00000040L")
 187     cpp_quote("#define SFGAO_DROPTARGET        0x00000100L")
 188     cpp_quote("#define SFGAO_CAPABILITYMASK    0x00000177L")
 189     cpp_quote("#define SFGAO_ENCRYPTED         0x00002000L")
 190     cpp_quote("#define SFGAO_ISSLOW            0x00004000L")
 191     cpp_quote("#define SFGAO_GHOSTED           0x00008000L")
 192     cpp_quote("#define SFGAO_LINK              0x00010000L")
 193     cpp_quote("#define SFGAO_SHARE             0x00020000L")
 194     cpp_quote("#define SFGAO_READONLY          0x00040000L")
 195     cpp_quote("#define SFGAO_HIDDEN            0x00080000L")
 196     cpp_quote("#define SFGAO_DISPLAYATTRMASK   0x000FC000L")
 197     cpp_quote("#define SFGAO_FILESYSANCESTOR   0x10000000L")
 198     cpp_quote("#define SFGAO_FOLDER            0x20000000L")
 199     cpp_quote("#define SFGAO_FILESYSTEM        0x40000000L")
 200     cpp_quote("#define SFGAO_HASSUBFOLDER      0x80000000L")
 201     cpp_quote("#define SFGAO_CONTENTSMASK      0x80000000L")
 202     cpp_quote("#define SFGAO_VALIDATE          0x01000000L")
 203     cpp_quote("#define SFGAO_REMOVABLE         0x02000000L")
 204     cpp_quote("#define SFGAO_COMPRESSED        0x04000000L")
 205     cpp_quote("#define SFGAO_BROWSABLE         0x08000000L")
 206     cpp_quote("#define SFGAO_NONENUMERATED     0x00100000L")
 207     cpp_quote("#define SFGAO_NEWCONTENT        0x00200000L")
 208     cpp_quote("#define SFGAO_STREAM            0x00400000L")
 209     cpp_quote("#define SFGAO_STORAGEANCESTOR   0x00800000L")
 210
 211     typedef ULONG SFGAOF;
 212
 213     HRESULT ParseDisplayName(
 214         [in] HWND hwndOwner,
 215         [in] LPBC pbcReserved,
 216         [in, string] LPOLESTR lpszDisplayName,
 217         [out] ULONG *pchEaten,
 218         [out] LPITEMIDLIST *ppidl,
 219         [in, out, unique] ULONG *pdwAttributes);
 220
 221     HRESULT EnumObjects(
 222         [in] HWND hwndOwner,
 223         [in] SHCONTF grfFlags,
 224         [out] IEnumIDList **ppenumIDList);
 225
 226     HRESULT BindToObject(
 227         [in] LPCITEMIDLIST pidl,
 228         [in] LPBC pbcReserved,
 229         [in] REFIID riid,
 230         [out, iid_is(riid)] void **ppvOut);
 231
 232     HRESULT BindToStorage(
 233         [in] LPCITEMIDLIST pidl,
 234         [in] LPBC pbcReserved,
 235         [in] REFIID riid,
 236         [out, iid_is(riid)] void **ppvObj);
 237
 238     HRESULT CompareIDs(
 239         [in] LPARAM lParam,
 240         [in] LPCITEMIDLIST pidl1,
 241         [in] LPCITEMIDLIST pidl2);
 242
 243     HRESULT CreateViewObject(
 244         [in] HWND hwndOwner,
 245         [in] REFIID riid,
 246         [out, iid_is(riid)] void **ppvOut);
 247
 248     HRESULT GetAttributesOf(
 249         [in] UINT cidl,
 250         [in, size_is(cidl)] LPCITEMIDLIST *apidl,
 251         [in, out] SFGAOF *rgfInOut);
 252
 253     HRESULT GetUIObjectOf(
 254         [in] HWND hwndOwner,
 255         [in] UINT cidl,
 256         [in, size_is(cidl)] LPCITEMIDLIST *apidl,
 257         [in] REFIID riid,
 258         [in, out, unique] UINT *prgfInOut,
 259         [out, iid_is(riid)] void **ppvOut);
 260
 261     HRESULT GetDisplayNameOf(
 262         [in] LPCITEMIDLIST pidl,
 263         [in] SHGDNF uFlags,
 264         [out] STRRET *lpName);
 265
 266     HRESULT SetNameOf(
 267         [in] HWND hwnd,
 268         [in] LPCITEMIDLIST pidl,
 269         [in, string] LPCOLESTR lpszName,
 270         [in] SHGDNF uFlags,
 271         [out] LPITEMIDLIST *ppidlOut);
 272 }
 273
 274
 275 /*****************************************************************************
 276  * IEnumExtraSearch interface
 277  */
 278 [
 279     object,
 280     uuid(0e700be1-9db6-11d1-a1ce-00c04fd75d13),
 281     pointer_default(unique)
 282 ]
 283 interface IEnumExtraSearch : IUnknown
 284 {
 285     typedef IEnumExtraSearch *LPENUMEXTRASEARCH;
 286
 287     typedef struct
 288     {
 289         GUID guidSearch;
 290         WCHAR wszFriendlyName[80];
 291         /*
 292          *WCHAR wszMenuText[80];
 293          *WCHAR wszHelpText[MAX_PATH];
 294          */
 295         WCHAR wszUrl[2084];
 296         /*
 297          *WCHAR wszIcon[MAX_PATH+10];
 298          *WCHAR wszGreyIcon[MAX_PATH+10];
 299          *WCHAR wszClrIcon[MAX_PATH+10];
 300          */
 301     } EXTRASEARCH, *LPEXTRASEARCH;
 302
 303     HRESULT Next(
 304         [in] ULONG celt,
 305         [out, size_is(celt), length_is(*pceltFetched)] EXTRASEARCH *rgelt,
 306         [out] ULONG *pceltFetched);
 307
 308     HRESULT Skip( [in] ULONG celt );
 309     HRESULT Reset();
 310     HRESULT Clone( [out] IEnumExtraSearch **ppenum );
 311 }
 312
 313
 314 /*****************************************************************************
 315  * IShellFolder2 interface
 316  */
 317 [
 318     object,
 319     uuid(93f2f68c-1d1b-11d3-a30e-00c04f79abd1),
 320     pointer_default(unique)
 321 ]
 322 interface IShellFolder2 : IShellFolder
 323 {
 324     typedef struct
 325     {
 326         GUID    fmtid;
 327         DWORD   pid;
 328     } SHCOLUMNID, *LPSHCOLUMNID;
 329     typedef const SHCOLUMNID *LPCSHCOLUMNID;
 330
 331     HRESULT GetDefaultSearchGUID( [out] GUID *lpguid );
 332     HRESULT EnumSearches( [out] IEnumExtraSearch **ppenum );
 333     HRESULT GetDefaultColumn( [in] DWORD dwReserved, [out] ULONG *pSort, [out] ULONG *pDisplay );
 334     HRESULT GetDefaultColumnState( [in] UINT iColumn, [out] SHCOLSTATEF *pcsFlags );
 335     HRESULT GetDetailsEx( [in] LPCITEMIDLIST pidl, [in] const SHCOLUMNID *pscid, [out] VARIANT *pv);
 336     HRESULT GetDetailsOf( [in] LPCITEMIDLIST pidl, [in] UINT iColumn, [out] SHELLDETAILS *psd);
 337     HRESULT MapColumnToSCID( [in] UINT iColumn, [in] SHCOLUMNID *pscid );
 338 }
 339
 340 /*****************************************************************************
 341  * IShellItem interface
 342  */
 343 [
 344     object,
 345     uuid(43826d1e-e718-42ee-bc55-a1e261c37bfe),
 346     pointer_default(unique)
 347 ]
 348 interface IShellItem : IUnknown
 349 {
 350     typedef [v1_enum] enum {
 351         SIGDN_NORMALDISPLAY                = 0,
 352         SIGDN_PARENTRELATIVEPARSING        = 0x80018001,
 353         SIGDN_DESKTOPABSOLUTEPARSING       = 0x80028000,
 354         SIGDN_PARENTRELATIVEEDITING        = 0x80031001,
 355         SIGDN_DESKTOPABSOLUTEEDITING       = 0x8004c000,
 356         SIGDN_FILESYSPATH                  = 0x80058000,
 357         SIGDN_URL                          = 0x80068000,
 358         SIGDN_PARENTRELATIVEFORADDRESSBAR  = 0x8007c001,
 359         SIGDN_PARENTRELATIVE               = 0x80080001
 360     } SIGDN; /* & 0xFFFF => SHGDN */
 361
 362     [v1_enum] enum _SICHINTF
 363     {
 364         SICHINT_DISPLAY                       = 0x00000000,
 365         SICHINT_CANONICAL                     = 0x10000000,
 366         SICHINT_TEST_FILESYSPATH_IF_NOT_EQUAL = 0x20000000,
 367         SICHINT_ALLFIELDS                     = 0x80000000
 368     };
 369     typedef DWORD SICHINTF;
 370
 371     HRESULT BindToHandler(
 372         [in] IBindCtx *pbc,
 373         [in] REFGUID rbhid,
 374         [in] REFIID riid,
 375         [out, iid_is(riid)] void **ppvOut);
 376
 377     HRESULT GetParent( [out] IShellItem **ppsi );
 378
 379     HRESULT GetDisplayName(
 380         [in] SIGDN sigdnName,
 381         [out] LPWSTR *ppszName);
 382
 383     HRESULT GetAttributes(
 384         [in] SFGAOF sfgaoMask,
 385         [out] SFGAOF *psfgaoAttribs);
 386
 387     HRESULT Compare(
 388         [in] IShellItem *psi,
 389         [in] SICHINTF hint,
 390         [out] int *piOrder);
 391 }
 392
 393 /*****************************************************************************
 394  * IShellItem2 interface
 395  */
 396 [
 397     object,
 398     uuid(7E9FB0D3-919F-4307-AB2E-9B1860310C93),
 399     pointer_default(unique)
 400 ]
 401 interface IShellItem2 : IShellItem
 402 {
 403     HRESULT GetPropertyStore(
 404         [in] GETPROPERTYSTOREFLAGS flags,
 405         [in] REFIID riid,
 406         [out, iid_is(riid)] void **ppv);
 407
 408     HRESULT GetPropertyStoreWithCreateObject(
 409         [in] GETPROPERTYSTOREFLAGS flags,
 410         [in] IUnknown *punkCreateObject,
 411         [in] REFIID riid,
 412         [out, iid_is(riid)] void **ppv);
 413
 414     HRESULT GetPropertyStoreForKeys(
 415         [in, size_is(cKeys)] const PROPERTYKEY *rgKeys,
 416         [in] UINT cKeys,
 417         [in] GETPROPERTYSTOREFLAGS flags,
 418         [in] REFIID riid,
 419         [out, iid_is(riid)] void **ppv);
 420
 421     HRESULT GetPropertyDescriptionList(
 422         [in] REFPROPERTYKEY keyType,
 423         [in] REFIID riid,
 424         [out, iid_is(riid)] void **ppv);
 425
 426     HRESULT Update(
 427         [in, unique] IBindCtx *pbc);
 428
 429     HRESULT GetProperty(
 430         [in] REFPROPERTYKEY key,
 431         [out] PROPVARIANT *ppropvar);
 432
 433     HRESULT GetCLSID(
 434         [in] REFPROPERTYKEY key,
 435         [out] CLSID *pclsid);
 436
 437     HRESULT GetFileTime (
 438         [in] REFPROPERTYKEY key,
 439         [out] FILETIME *pft);
 440
 441     HRESULT GetInt32(
 442         [in] REFPROPERTYKEY key,
 443         [out] int *pi);
 444
 445     HRESULT GetString(
 446         [in] REFPROPERTYKEY key,
 447         [out, string] LPWSTR *ppsz);
 448
 449     HRESULT GetUInt32(
 450         [in] REFPROPERTYKEY key,
 451         [out] ULONG *pui);
 452
 453     HRESULT GetUInt64(
 454         [in] REFPROPERTYKEY key,
 455         [out] ULONGLONG *pull);
 456
 457     HRESULT GetBool(
 458         [in] REFPROPERTYKEY key,
 459         [out] BOOL *pf);
 460 }
 461
 462 typedef enum tagNWMF {
 463     NWMF_UNLOADING        = 0x0001,
 464     NWMF_USERINITED       = 0x0002,
 465     NWMF_FIRST            = 0x0004,
 466     NWMF_OVERRIDEKEY      = 0x0008,
 467     NWMF_SHOWHELP         = 0x0010,
 468     NWMF_HTMLDIALOG       = 0x0020,
 469     NWMF_FROMDIALOGCHILD  = 0x0040,
 470     NWMF_USERREQUESTED    = 0x0080,
 471     NWMF_USERALLOWED      = 0x0100
 472 } NWMF;
 473
 474 [
 475     uuid(d2bc4c84-3f72-4a52-a604-7bcbf3982cbb),
 476     object,
 477     pointer_default(unique)
 478 ]
 479 interface INewWindowManager : IUnknown
 480 {
 481     HRESULT EvaluateNewWindow(
 482         [in, string] LPCWSTR pszUrl,
 483         [in, string] LPCWSTR pszName,
 484         [in, string] LPCWSTR pszUrlContext,
 485         [in, string] LPCWSTR pszFeatures,
 486         [in]         BOOL fReplace,
 487         [in]         DWORD dwFlags,
 488         [in]         DWORD dwUserActionTime);
 489 }
 490
 491 cpp_quote("#define SID_SNewWindowManager IID_INewWindowManager")
 492
 493 /*****************************************************************************
 494  * IEnumShellItems interface
 495  */
 496 [
 497  object,
 498  uuid(70629033-E363-4A28-A567-0DB78006E6D7),
 499  pointer_default(unique)
 500 ]
 501 interface IEnumShellItems : IUnknown
 502 {
 503     [local] HRESULT Next(
 504         [in] ULONG celt,
 505         [out, size_is(celt), length_is(*pceltFetched)] IShellItem **rgelt,
 506         [out] ULONG *pceltFetched);
 507
 508     [call_as(Next)] HRESULT RemoteNext(
 509         [in] ULONG celt,
 510         [out, size_is(celt), length_is(*pceltFetched)] IShellItem **rgelt,
 511         [out] ULONG *pceltFetched);
 512
 513     HRESULT Skip(
 514         [in] ULONG celt);
 515
 516     HRESULT Reset();
 517
 518     HRESULT Clone(
 519         [out] IEnumShellItems **ppenum);
 520 }
 521
 522 /*****************************************************************************
 523  * IShellItemArray interface
 524  */
 525 [
 526  object,
 527  uuid(B63EA76D-1F85-456F-A19C-48159EFA858B),
 528  pointer_default(unique)
 529 ]
 530 interface IShellItemArray : IUnknown
 531 {
 532     typedef [v1_enum] enum SIATTRIBFLAGS {
 533         SIATTRIBFLAGS_AND            = 0x0001,
 534         SIATTRIBFLAGS_OR             = 0x0002,
 535         SIATTRIBFLAGS_APPCOMPAT      = 0x0003,
 536         SIATTRIBFLAGS_MASK           = 0x0003,
 537         SIATTRIBFLAGS_ALLITEMS       = 0x4000
 538     } SIATTRIBFLAGS;
 539     cpp_quote("DEFINE_ENUM_FLAG_OPERATORS(SIATTRIBFLAGS)")
 540
 541     HRESULT BindToHandler(
 542         [in, unique] IBindCtx *pbc,
 543         [in] REFGUID bhid,
 544         [in] REFIID riid,
 545         [out, iid_is(riid)] void **ppvOut);
 546
 547     HRESULT GetPropertyStore(
 548         [in] GETPROPERTYSTOREFLAGS flags,
 549         [in] REFIID riid,
 550         [out, iid_is(riid)] void **ppv);
 551
 552     HRESULT GetPropertyDescriptionList(
 553         [in] REFPROPERTYKEY keyType,
 554         [in] REFIID riid,
 555         [out, iid_is(riid)] void **ppv);
 556
 557     HRESULT GetAttributes(
 558         [in] SIATTRIBFLAGS AttribFlags,
 559         [in] SFGAOF sfgaoMask,
 560         [out] SFGAOF *psfgaoAttribs);
 561
 562     HRESULT GetCount(
 563         [out] DWORD *pdwNumItems);
 564
 565     HRESULT GetItemAt(
 566         [in] DWORD dwIndex,
 567         [out] IShellItem **ppsi);
 568
 569     HRESULT EnumItems(
 570         [out] IEnumShellItems **ppenumShellItems);
 571
 572 }
 573
 574 typedef [v1_enum] enum DATAOBJ_GET_ITEM_FLAGS
 575 {
 576     DOGIF_DEFAULT       = 0x0,
 577     DOGIF_TRAVERSE_LINK = 0x1,
 578     DOGIF_NO_HDROP      = 0x2,
 579     DOGIF_NO_URL        = 0x4,
 580     DOGIF_ONLY_IF_ONE   = 0x8
 581 } DATAOBJ_GET_ITEM_FLAGS;
 582 cpp_quote("DEFINE_ENUM_FLAG_OPERATORS(DATAOBJ_GET_ITEM_FLAGS)")
 583
 584 cpp_quote("HRESULT WINAPI SHGetNameFromIDList(PCIDLIST_ABSOLUTE pidl, SIGDN sigdnName, PWSTR *ppszName);")
 585 cpp_quote("HRESULT WINAPI SHCreateItemFromParsingName(PCWSTR pszPath, IBindCtx *pbc, REFIID riid, void **ppv);")
 586 cpp_quote("HRESULT WINAPI SHCreateItemFromIDList(PCIDLIST_ABSOLUTE pidl, REFIID riid, void **ppv);")
 587 cpp_quote("HRESULT WINAPI SHGetItemFromDataObject(IDataObject *pdtobj, DATAOBJ_GET_ITEM_FLAGS dwFlags, REFIID riid, void **ppv);")
 588 cpp_quote("HRESULT WINAPI SHGetIDListFromObject(IUnknown *punk, PIDLIST_ABSOLUTE *ppidl);")
 589 cpp_quote("HRESULT WINAPI SHGetItemFromObject(IUnknown *punk, REFIID riid, void **ppv);")
 590 cpp_quote("HRESULT WINAPI SHCreateShellItemArray(PCIDLIST_ABSOLUTE pidlParent, IShellFolder* psf, UINT cidl, PCUITEMID_CHILD_ARRAY ppidl, IShellItemArray **ppsiItemArray);")
 591 cpp_quote("HRESULT WINAPI SHCreateShellItemArrayFromShellItem(IShellItem *psi, REFIID riid, void **ppv);")
 592 cpp_quote("HRESULT WINAPI SHCreateShellItemArrayFromDataObject(IDataObject *pdo, REFIID riid, void **ppv);")
 593
 594 /*****************************************************************************
 595  * IShellItemFilter interface
 596  */
 597 [
 598  object,
 599  uuid(2659B475-EEB8-48B7-8F07-B378810F48CF),
 600  pointer_default(unique)
 601 ]
 602 interface IShellItemFilter : IUnknown
 603 {
 604     HRESULT IncludeItem(
 605         [in] IShellItem *psi);
 606
 607     HRESULT GetEnumFlagsForItem(
 608         [in] IShellItem *psi,
 609         [out] SHCONTF *pgrfFlags);
 610 }
 611
 612 /*****************************************************************************
 613  * FOLDERSETTINGS
 614  */
 615 typedef char *LPVIEWSETTINGS;
 616
 617 typedef enum
 618 {
 619     FWF_AUTOARRANGE         = 0x00000001,
 620     FWF_ABBREVIATEDNAMES    = 0x00000002,
 621     FWF_SNAPTOGRID          = 0x00000004,
 622     FWF_OWNERDATA           = 0x00000008,
 623     FWF_BESTFITWINDOW       = 0x00000010,
 624     FWF_DESKTOP             = 0x00000020,
 625     FWF_SINGLESEL           = 0x00000040,
 626     FWF_NOSUBFOLDERS        = 0x00000080,
 627     FWF_TRANSPARENT         = 0x00000100,
 628     FWF_NOCLIENTEDGE        = 0x00000200,
 629     FWF_NOSCROLL            = 0x00000400,
 630     FWF_ALIGNLEFT           = 0x00000800,
 631     FWF_NOICONS             = 0x00001000,
 632     FWF_SHOWSELALWAYS       = 0x00002000,
 633     FWF_NOVISIBLE           = 0x00004000,
 634     FWF_SINGLECLICKACTIVATE = 0x00008000,
 635     FWF_NOWEBVIEW           = 0x00010000,
 636     FWF_HIDEFILENAMES       = 0x00020000,
 637     FWF_CHECKSELECT         = 0x00040000,
 638     FWF_NOENUMREFRESH       = 0x00080000,
 639     FWF_NOGROUPING          = 0x00100000,
 640     FWF_FULLROWSELECT       = 0x00200000,
 641     FWF_NOFILTERS           = 0x00400000,
 642     FWF_NOCOLUMNHEADER      = 0x00800000,
 643     FWF_NOHEADERINALLVIEWS  = 0x01000000,
 644     FWF_EXTENDEDTILES       = 0x02000000,
 645     FWF_TRICHECKSELECT      = 0x04000000,
 646     FWF_AUTOCHECKSELECT     = 0x08000000,
 647     FWF_NOBROWSERVIEWSTATE  = 0x10000000,
 648     FWF_SUBSETGROUPS        = 0x20000000,
 649     FWF_USESEARCHFOLDER     = 0x40000000,
 650     FWF_ALLOWRTLREADING     = 0x80000000
 651 } FOLDERFLAGS;
 652
 653 typedef enum
 654 {
 655     FVM_AUTO       =-1,
 656     FVM_ICON       = 1,
 657     FVM_FIRST      = FVM_ICON,
 658     FVM_SMALLICON  = 2,
 659     FVM_LIST       = 3,
 660     FVM_DETAILS    = 4,
 661     FVM_THUMBNAIL  = 5,
 662     FVM_TILE       = 6,
 663     FVM_THUMBSTRIP = 7,
 664     FVM_CONTENT    = 8,
 665     FVM_LAST       = FVM_CONTENT
 666 } FOLDERVIEWMODE;
 667
 668 typedef struct
 669 {
 670     UINT ViewMode;
 671     UINT fFlags;
 672 } FOLDERSETTINGS, *PFOLDERSETTINGS, *LPFOLDERSETTINGS;
 673 typedef const FOLDERSETTINGS *LPCFOLDERSETTINGS;
 674
 675 /*****************************************************************************
 676  * IShellIcon interface
 677  */
 678 [
 679     uuid(000214e5-0000-0000-c000-000000000046),
 680     object,
 681     pointer_default(unique)
 682 ]
 683 interface IShellIcon : IUnknown
 684 {
 685     HRESULT GetIconOf(
 686         [in] PCUITEMID_CHILD pidl,
 687         [in] UINT flags,
 688         [out] int *pIconIndex);
 689 }
 690
 691 /*****************************************************************************
 692  * IShellView interface
 693  */
 694 interface IShellBrowser;  /* forward declaration */
 695 [
 696     object,
 697     uuid(000214e3-0000-0000-c000-000000000046),
 698     pointer_default(unique)
 699 ]
 700 interface IShellView : IOleWindow
 701 {
 702     typedef IShellView *LPSHELLVIEW;
 703
 704     cpp_quote("#define SVSI_DESELECT       0x00000000")
 705     cpp_quote("#define SVSI_SELECT         0x00000001")
 706     cpp_quote("#define SVSI_EDIT           0x00000003")
 707     cpp_quote("#define SVSI_DESELECTOTHERS 0x00000004")
 708     cpp_quote("#define SVSI_ENSUREVISIBLE  0x00000008")
 709     cpp_quote("#define SVSI_FOCUSED        0x00000010")
 710     cpp_quote("#define SVSI_TRANSLATEPT    0x00000020")
 711     cpp_quote("#define SVSI_SELECTIONMARK  0x00000040")
 712     cpp_quote("#define SVSI_POSITIONITEM   0x00000080")
 713     cpp_quote("#define SVSI_CHECK          0x00000100")
 714     cpp_quote("#define SVSI_NOSTATECHANGE  0x80000000")
 715
 716     typedef UINT SVSIF;
 717
 718     typedef enum
 719     {
 720         SVGIO_BACKGROUND     = 0x00000000,
 721         SVGIO_SELECTION      = 0x00000001,
 722         SVGIO_ALLVIEW        = 0x00000002,
 723         SVGIO_CHECKED        = 0x00000003,
 724         SVGIO_TYPE_MASK      = 0x0000000f,
 725         SVGIO_FLAG_VIEWORDER = 0x80000000,
 726     } SVGIO;
 727
 728     typedef enum
 729     {
 730         SVUIA_DEACTIVATE       = 0,
 731         SVUIA_ACTIVATE_NOFOCUS = 1,
 732         SVUIA_ACTIVATE_FOCUS   = 2,
 733         SVUIA_INPLACEACTIVATE  = 3
 734     } SVUIA_STATUS;
 735
 736     HRESULT TranslateAccelerator( [in] MSG *pmsg );
 737     HRESULT EnableModeless( [in] BOOL fEnable );
 738     HRESULT UIActivate( [in] UINT uState );
 739     HRESULT Refresh();
 740     HRESULT CreateViewWindow(
 741         [in] IShellView *psvPrevious,
 742         [in] LPCFOLDERSETTINGS lpfs,
 743         [in] IShellBrowser *psb,
 744         [out] RECT *prcView,
 745         [out] HWND *phWnd);
 746
 747     HRESULT DestroyViewWindow();
 748     HRESULT GetCurrentInfo( [out] LPFOLDERSETTINGS lpfs );
 749
 750     [local] HRESULT AddPropertySheetPages(
 751         [in] DWORD dwReserved,
 752         [in] LPFNSVADDPROPSHEETPAGE pfn,
 753         [in] LPARAM lparam);
 754
 755     HRESULT SaveViewState();
 756     HRESULT SelectItem(
 757         [in] LPCITEMIDLIST pidlItem,
 758         [in] SVSIF uFlags);
 759     HRESULT GetItemObject(
 760         [in] UINT uItem,
 761         [in] REFIID riid,
 762         [out, iid_is(riid)] void **ppv);
 763 }
 764
 765 [
 766     object,
 767     uuid(88e39e80-3578-11cf-ae69-08002b2e1262),
 768     pointer_default(unique)
 769 ]
 770 interface IShellView2 : IShellView
 771 {
 772     typedef GUID SHELLVIEWID;
 773 cpp_quote("#include <pshpack8.h>")
 774     typedef struct _SV2CVW2_PARAMS
 775     {
 776         DWORD cbSize;
 777         IShellView *psvPrev;
 778         LPCFOLDERSETTINGS pfs;
 779         IShellBrowser *psbOwner;
 780         RECT *prcView;
 781         SHELLVIEWID const *pvid;
 782         HWND hwndView;
 783     } SV2CVW2_PARAMS, *LPSV2CVW2_PARAMS;
 784 cpp_quote("#include <poppack.h>")
 785
 786     HRESULT GetView(
 787         [in, out] SHELLVIEWID *view_guid,
 788         [in] ULONG view_type
 789     );
 790     HRESULT CreateViewWindow2(
 791         [in] LPSV2CVW2_PARAMS view_params
 792     );
 793     HRESULT HandleRename(
 794         [in] LPCITEMIDLIST new_pidl
 795     );
 796     HRESULT SelectAndPositionItem(
 797         [in] LPCITEMIDLIST item,
 798         [in] UINT flags,
 799         [in] POINT *point
 800     );
 801 }
 802
 803 /*****************************************************************************
 804  * IFolderView interface
 805  */
 806 [
 807     uuid(cde725b0-ccc9-4519-917e-325d72fab4ce),
 808     object,
 809     pointer_default(unique)
 810 ]
 811 interface IFolderView : IUnknown
 812 {
 813     HRESULT GetCurrentViewMode( [out] UINT *mode );
 814     HRESULT SetCurrentViewMode( [in] UINT mode );
 815     HRESULT GetFolder( [in] REFIID riid, [out, iid_is(riid)] void **ppv );
 816     HRESULT Item(
 817         [in] int index,
 818         [out] PITEMID_CHILD *ppidl
 819     );
 820     HRESULT ItemCount(
 821         [in] UINT flags,
 822         [out] int *items
 823     );
 824     HRESULT Items(
 825         [in] UINT flags,
 826         [in] REFIID riid,
 827         [out, iid_is(riid)] void **ppv
 828     );
 829     HRESULT GetSelectionMarkedItem( [out] int *item );
 830     HRESULT GetFocusedItem( [out] int *item );
 831     HRESULT GetItemPosition(
 832         [in] PCUITEMID_CHILD pidl,
 833         [out] POINT* ppt
 834     );
 835     HRESULT GetSpacing( [in, out, unique] POINT* pt );
 836     HRESULT GetDefaultSpacing( [out] POINT* pt );
 837     HRESULT GetAutoArrange();
 838     HRESULT SelectItem(
 839         [in] int item,
 840         [in] DWORD flags
 841     );
 842     HRESULT SelectAndPositionItems(
 843         [in] UINT cidl,
 844         [in, size_is(cidl)] PCUITEMID_CHILD_ARRAY apidl,
 845         [in, unique, size_is(cidl)] POINT* apt,
 846         [in] DWORD flags
 847     );
 848 }
 849
 850 /*****************************************************************************
 851  * IShellBrowser interface
 852  */
 853 [
 854     object,
 855     uuid(000214e2-0000-0000-c000-000000000046),
 856     pointer_default(unique)
 857 ]
 858 interface IShellBrowser : IOleWindow
 859 {
 860     typedef IShellBrowser *LPSHELLBROWSER;
 861
 862 cpp_quote("#define SBSP_DEFBROWSER            0x00000000")
 863 cpp_quote("#define SBSP_SAMEBROWSER           0x00000001")
 864 cpp_quote("#define SBSP_NEWBROWSER            0x00000002")
 865 cpp_quote("#define SBSP_DEFMODE               0x00000000")
 866 cpp_quote("#define SBSP_OPENMODE              0x00000010")
 867 cpp_quote("#define SBSP_EXPLOREMODE           0x00000020")
 868 cpp_quote("#define SBSP_HELPMODE              0x00000040")
 869 cpp_quote("#define SBSP_NOTRANSFERHIST        0x00000080")
 870 cpp_quote("#define SBSP_ABSOLUTE              0x00000000")
 871 cpp_quote("#define SBSP_RELATIVE              0x00001000")
 872 cpp_quote("#define SBSP_PARENT                0x00002000")
 873 cpp_quote("#define SBSP_NAVIGATEBACK          0x00004000")
 874 cpp_quote("#define SBSP_NAVIGATEFORWARD       0x00008000")
 875 cpp_quote("#define SBSP_ALLOW_AUTONAVIGATE    0x00010000")
 876 cpp_quote("#define SBSP_KEEPSAMETEMPLATE      0x00020000")
 877 cpp_quote("#define SBSP_KEEPWORDWHEELTEXT     0x00040000")
 878 cpp_quote("#define SBSP_ACTIVATE_NOFOCUS      0x00080000")
 879 cpp_quote("#define SBSP_CREATENOHISTORY       0x00100000")
 880 cpp_quote("#define SBSP_PLAYNOSOUND           0x00200000")
 881 cpp_quote("#define SBSP_CALLERUNTURUSTED      0x00800000")
 882 cpp_quote("#define SBSP_TRUSTFIRSTDOWNLOAD    0x01000000")
 883 cpp_quote("#define SBSP_UNTRUSTEDFORDOWNLOAD  0x02000000")
 884 cpp_quote("#define SBSP_NOAUTOSELECT          0x04000000")
 885 cpp_quote("#define SBSP_WRITENOHISTORY        0x08000000")
 886 cpp_quote("#define SBSP_TRUSTEDFORACTIVEX     0x10000000")
 887 cpp_quote("#define SBSP_FEEDNAVIGATION        0x20000000")
 888 cpp_quote("#define SBSP_REDIRECT              0x40000000")
 889 cpp_quote("#define SBSP_INITIATEDBYHLINKFRAME 0x80000000")
 890
 891 cpp_quote("#define FCW_STATUS      0x0001")
 892 cpp_quote("#define FCW_TOOLBAR     0x0002")
 893 cpp_quote("#define FCW_TREE        0x0003")
 894 cpp_quote("#define FCW_INTERNETBAR 0x0006")
 895 cpp_quote("#define FCW_PROGRESS    0x0008")
 896
 897 cpp_quote("#define FCT_MERGE       0x0001")
 898 cpp_quote("#define FCT_CONFIGABLE  0x0002")
 899 cpp_quote("#define FCT_ADDTOEND    0x0004")
 900
 901 cpp_quote("#if 0")
 902     typedef LPARAM LPTBBUTTONSB;
 903 cpp_quote("#else")
 904 cpp_quote("#include <commctrl.h>")
 905 cpp_quote("typedef LPTBBUTTON LPTBBUTTONSB;")
 906 cpp_quote("#endif")
 907
 908     HRESULT InsertMenusSB(
 909         [in] HMENU hmenuShared,
 910         [in, out] LPOLEMENUGROUPWIDTHS lpMenuWidths);
 911
 912     HRESULT SetMenuSB(
 913         [in] HMENU hmenuShared,
 914         [in] HOLEMENU holemenuReserved,
 915         [in] HWND hwndActiveObject);
 916
 917     HRESULT RemoveMenusSB( [in] HMENU hmenuShared );
 918     HRESULT SetStatusTextSB( [in, unique] LPCOLESTR pszStatusText );
 919     HRESULT EnableModelessSB( [in] BOOL fEnable );
 920     HRESULT TranslateAcceleratorSB( [in] MSG *pmsg, [in] WORD wID );
 921
 922     HRESULT BrowseObject(
 923         [in] LPCITEMIDLIST pidl,
 924         [in] UINT wFlags);
 925
 926     HRESULT GetViewStateStream(
 927         [in] DWORD grfMode,
 928         [out] IStream **ppStrm);
 929
 930     HRESULT GetControlWindow(
 931         [in] UINT id,
 932         [out] HWND *phwnd);
 933
 934     [local] HRESULT SendControlMsg(
 935         [in] UINT id,
 936         [in] UINT uMsg,
 937         [in] WPARAM wParam,
 938         [in] LPARAM lParam,
 939         [in] LRESULT *pret);
 940
 941     HRESULT QueryActiveShellView( [out] IShellView **ppshv );
 942     HRESULT OnViewWindowActive( [in] IShellView *pshv );
 943
 944     [local]
 945     HRESULT SetToolbarItems(
 946         [in] LPTBBUTTONSB lpButtons,
 947         [in] UINT nButtons,
 948         [in] UINT uFlags);
 949 }
 950
 951
 952 /*****************************************************************************
 953  * IShellLinkA interface
 954  */
 955 [
 956     object,
 957     uuid(000214ee-0000-0000-c000-000000000046),
 958     pointer_default(unique)
 959 ]
 960 interface IShellLinkA : IUnknown
 961 {
 962     typedef enum
 963     {
 964         SLR_NO_UI               = 0x0001,
 965         SLR_ANY_MATCH           = 0x0002,
 966         SLR_UPDATE              = 0x0004,
 967         SLR_NOUPDATE            = 0x0008,
 968         SLR_NOSEARCH            = 0x0010,
 969         SLR_NOTRACK             = 0x0020,
 970         SLR_NOLINKINFO          = 0x0040,
 971         SLR_INVOKE_MSI          = 0x0080,
 972         SLR_NO_UI_WITH_MSG_PUMP = 0x0101,
 973     } SLR_FLAGS;
 974
 975     typedef enum
 976     {
 977         SLGP_SHORTPATH   = 0x0001,
 978         SLGP_UNCPRIORITY = 0x0002,
 979         SLGP_RAWPATH     = 0x0004,
 980     } SLGP_FLAGS;
 981
 982     HRESULT GetPath(
 983         [out, size_is(cch)] LPSTR pszFile,
 984         [in] int cch,
 985         [in, out, unique] WIN32_FIND_DATAA *pfd,
 986         [in] DWORD fFlags);
 987
 988     HRESULT GetIDList( [out] LPITEMIDLIST * ppidl );
 989
 990     HRESULT SetIDList( [in] LPCITEMIDLIST pidl );
 991
 992     HRESULT GetDescription(
 993         [out, size_is(cch)] LPSTR pszName,
 994         [in] int cch);
 995
 996     HRESULT SetDescription( [in] LPCSTR pszName );
 997
 998     HRESULT GetWorkingDirectory(
 999         [out, size_is(cch)] LPSTR pszDir,
1000         [in] int cch);
1001
1002     HRESULT SetWorkingDirectory( [in] LPCSTR pszDir );
1003
1004     HRESULT GetArguments(
1005         [out, size_is(cch)] LPSTR pszArgs,
1006         [in] int cch);
1007
1008     HRESULT SetArguments( [in] LPCSTR pszArgs );
1009
1010     HRESULT GetHotkey( [out] WORD *pwHotkey );
1011
1012     HRESULT SetHotkey( [in] WORD wHotkey );
1013
1014     HRESULT GetShowCmd( [out] int *piShowCmd );
1015
1016     HRESULT SetShowCmd( [in] int iShowCmd );
1017
1018     HRESULT GetIconLocation(
1019         [out, size_is(cch)] LPSTR pszIconPath,
1020         [in] int cch,
1021         [out] int *piIcon);
1022
1023     HRESULT SetIconLocation(
1024         [in] LPCSTR pszIconPath,
1025         [in] int iIcon);
1026
1027     HRESULT SetRelativePath(
1028         [in] LPCSTR pszPathRel,
1029         [in] DWORD dwReserved);
1030
1031     HRESULT Resolve(
1032         [in] HWND hwnd,
1033         [in] DWORD fFlags);
1034
1035     HRESULT SetPath( [in] LPCSTR pszFile );
1036 }
1037
1038
1039 /*****************************************************************************
1040  * IShellLinkW interface
1041  */
1042 [
1043     object,
1044     uuid(000214f9-0000-0000-c000-000000000046),
1045     pointer_default(unique)
1046 ]
1047 interface IShellLinkW : IUnknown
1048 {
1049     HRESULT GetPath(
1050         [out, size_is(cch)] LPWSTR pszFile,
1051         [in] int cch,
1052         [in, out] WIN32_FIND_DATAW *pfd,
1053         [in] DWORD fFlags);
1054
1055     HRESULT GetIDList( [out] LPITEMIDLIST * ppidl );
1056
1057     HRESULT SetIDList( [in] LPCITEMIDLIST pidl );
1058
1059     HRESULT GetDescription(
1060         [out, size_is(cch)] LPWSTR pszName,
1061         [in] int cch);
1062
1063     HRESULT SetDescription( [in] LPCWSTR pszName );
1064
1065     HRESULT GetWorkingDirectory(
1066         [out, size_is(cch)] LPWSTR pszDir,
1067         [in] int cch);
1068
1069     HRESULT SetWorkingDirectory( [in] LPCWSTR pszDir );
1070
1071     HRESULT GetArguments(
1072         [out, size_is(cch)] LPWSTR pszArgs,
1073         [in] int cch);
1074
1075     HRESULT SetArguments( [in] LPCWSTR pszArgs );
1076
1077     HRESULT GetHotkey( [out] WORD *pwHotkey );
1078
1079     HRESULT SetHotkey( [in] WORD wHotkey );
1080
1081     HRESULT GetShowCmd( [out] int *piShowCmd );
1082
1083     HRESULT SetShowCmd( [in] int iShowCmd );
1084
1085     HRESULT GetIconLocation(
1086         [out, size_is(cch)] LPWSTR pszIconPath,
1087         [in] int cch,
1088         [out] int *piIcon);
1089
1090     HRESULT SetIconLocation(
1091         [in] LPCWSTR pszIconPath,
1092         [in] int iIcon);
1093
1094     HRESULT SetRelativePath(
1095         [in] LPCWSTR pszPathRel,
1096         [in] DWORD dwReserved);
1097
1098     HRESULT Resolve(
1099         [in] HWND hwnd,
1100         [in] DWORD fFlags);
1101
1102     HRESULT SetPath( [in] LPCWSTR pszFile );
1103 }
1104
1105 cpp_quote("#define IShellLink WINELIB_NAME_AW(IShellLink)")
1106
1107
1108 /*****************************************************************************
1109  * IShellExtInit interface
1110  */
1111 [
1112     object,
1113     uuid(000214e8-0000-0000-c000-000000000046),
1114     pointer_default(unique),
1115     local
1116 ]
1117 interface IShellExtInit : IUnknown
1118 {
1119     typedef IShellExtInit *LPSHELLEXTINIT;
1120
1121     HRESULT Initialize(
1122         [in] LPCITEMIDLIST pidlFolder,
1123         [in] IDataObject *pdtobj,
1124         [in] HKEY hkeyProgID);
1125 }
1126
1127
1128 /*******************************************************************************/
1129 /* Note: the following interfaces are not in shobjidl.idl under Windows, they  */
1130 /* are declared directly in shlobj.h. It hopefully won't break anything to put */
1131 /* them here anyway.                                                           */
1132 /*******************************************************************************/
1133
1134 #ifndef MAX_PATH
1135 #define MAX_PATH 260
1136 #endif
1137
1138
1139 /*****************************************************************************
1140  * IPersistFolder3 interface
1141  */
1142 [
1143     object,
1144     uuid(cef04fdf-fe72-11d2-87a5-00c04f6837cf),
1145     pointer_default(unique)
1146 ]
1147 interface IPersistFolder3 : IPersistFolder2
1148 {
1149     typedef struct
1150     {
1151         LPITEMIDLIST    pidlTargetFolder;
1152         WCHAR           szTargetParsingName[MAX_PATH];
1153         WCHAR           szNetworkProvider[MAX_PATH];
1154         DWORD           dwAttributes;
1155         int             csidl;
1156     } PERSIST_FOLDER_TARGET_INFO;
1157
1158     HRESULT InitializeEx(
1159         [in] IBindCtx *pbc,
1160         [in] LPCITEMIDLIST pidlRoot,
1161         [in] const PERSIST_FOLDER_TARGET_INFO *ppfti);
1162
1163     HRESULT GetFolderTargetInfo( [out] PERSIST_FOLDER_TARGET_INFO *ppfti );
1164 }
1165
1166
1167 /*****************************************************************************
1168  * IExtractIconA interface
1169  */
1170 [
1171     object,
1172     uuid(000214eb-0000-0000-c000-000000000046),
1173     pointer_default(unique),
1174     local
1175 ]
1176 interface IExtractIconA : IUnknown
1177 {
1178 cpp_quote("#define GIL_OPENICON     0x0001")
1179 cpp_quote("#define GIL_FORSHELL     0x0002")
1180 cpp_quote("#define GIL_ASYNC        0x0020")
1181 cpp_quote("#define GIL_DEFAULTICON  0x0040")
1182 cpp_quote("#define GIL_FORSHORTCUT  0x0080")
1183
1184 cpp_quote("#define GIL_SIMULATEDOC  0x0001")
1185 cpp_quote("#define GIL_PERINSTANCE  0x0002")
1186 cpp_quote("#define GIL_PERCLASS     0x0004")
1187 cpp_quote("#define GIL_NOTFILENAME  0x0008")
1188 cpp_quote("#define GIL_DONTCACHE    0x0010")
1189
1190     typedef IExtractIconA *LPEXTRACTICONA;
1191
1192     HRESULT GetIconLocation(
1193         [in] UINT uFlags,
1194         [out, size_is(cchMax)] LPSTR szIconFile,
1195         [in] UINT cchMax,
1196         [out] INT *piIndex,
1197         [out] UINT *pwFlags);
1198
1199     HRESULT Extract(
1200         [in] LPCSTR pszFile,
1201         [in] UINT nIconIndex,
1202         [out] HICON *phiconLarge,
1203         [out] HICON *phiconSmall,
1204         [in] UINT nIconSize );
1205 }
1206
1207
1208 /*****************************************************************************
1209  * IExtractIconW interface
1210  */
1211 [
1212     object,
1213     uuid(000214fa-0000-0000-c000-000000000046),
1214     pointer_default(unique),
1215     local
1216 ]
1217 interface IExtractIconW : IUnknown
1218 {
1219     typedef IExtractIconW *LPEXTRACTICONW;
1220
1221     HRESULT GetIconLocation(
1222         [in] UINT uFlags,
1223         [out, size_is(cchMax)] LPWSTR szIconFile,
1224         [in] UINT cchMax,
1225         [out] INT *piIndex,
1226         [out] UINT *pwFlags);
1227
1228     HRESULT Extract(
1229         [in] LPCWSTR pszFile,
1230         [in] UINT nIconIndex,
1231         [out] HICON *phiconLarge,
1232         [out] HICON *phiconSmall,
1233         [in] UINT nIconSize );
1234 }
1235
1236 cpp_quote("#define LPEXTRACTICON WINELIB_NAME_AW(LPEXTRACTICON)")
1237 cpp_quote("#define IExtractIcon WINELIB_NAME_AW(IExtractIcon)")
1238
1239
1240 /*****************************************************************************
1241  * ICommDlgBrowser interface
1242  */
1243 [
1244     object,
1245     uuid(000214f1-0000-0000-c000-000000000046),
1246     pointer_default(unique)
1247 ]
1248 interface ICommDlgBrowser : IUnknown
1249 {
1250 cpp_quote("#define CDBOSC_SETFOCUS     0x00000000")
1251 cpp_quote("#define CDBOSC_KILLFOCUS    0x00000001")
1252 cpp_quote("#define CDBOSC_SELCHANGE    0x00000002")
1253 cpp_quote("#define CDBOSC_RENAME       0x00000003")
1254 cpp_quote("#define CDBOSC_STATECHANGE  0x00000004")
1255
1256     typedef ICommDlgBrowser *LPCOMMDLGBROWSER;
1257
1258     HRESULT OnDefaultCommand( [in] IShellView *shv );
1259     HRESULT OnStateChange( [in] IShellView *shv, [in] ULONG uChange );
1260     HRESULT IncludeObject( [in] IShellView *shv, [in] LPCITEMIDLIST pidl );
1261 }
1262
1263
1264 /*****************************************************************************
1265  * ICommDlgBrowser2 interface
1266  */
1267 [
1268  object,
1269  uuid(10339516-2894-11D2-9039-00C04F8EEB3E),
1270  pointer_default(unique)
1271 ]
1272 interface ICommDlgBrowser2 : ICommDlgBrowser
1273 {
1274
1275     HRESULT Notify(
1276         [in] IShellView *ppshv,
1277         [in] DWORD dwNotifyType);
1278
1279     HRESULT GetDefaultMenuText(
1280         [in] IShellView *ppshv,
1281         [out, string, size_is(cchMax)] LPWSTR pszText,
1282         [in] int cchMax);
1283
1284     HRESULT GetViewFlags(
1285         [out] DWORD *pdwFlags);
1286 }
1287
1288
1289 /*****************************************************************************
1290  * ICommDlgBrowser3 interface
1291  */
1292 [
1293  object,
1294  uuid(C8AD25A1-3294-41EE-8165-71174BD01C57),
1295  pointer_default(unique)
1296 ]
1297 interface ICommDlgBrowser3 : ICommDlgBrowser2
1298 {
1299
1300     HRESULT OnColumnClicked(
1301         [in] IShellView *ppshv,
1302         [in] int iColumn);
1303
1304     HRESULT GetCurrentFilter(
1305         [out, string, size_is(cchFileSpec)] LPWSTR pszFileSpec,
1306         [in] int cchFileSpec);
1307
1308     HRESULT OnPreviewCreated(
1309         [in] IShellView *ppshv);
1310 }
1311
1312 /*****************************************************************************
1313  * IDockingWindow interface
1314  */
1315 [
1316     object,
1317     uuid(012dd920-7b26-11d0-8ca9-00a0c92dbfe8)
1318 ]
1319 interface IDockingWindow : IOleWindow
1320 {
1321     HRESULT ShowDW(
1322         [in] BOOL fShow);
1323
1324     HRESULT CloseDW(
1325         [in] DWORD dwReserved);
1326
1327     HRESULT ResizeBorderDW(
1328         [in] LPCRECT prcBorder,
1329         [in] IUnknown *punkToolbarSite,
1330         [in] BOOL fReserved);
1331 };
1332
1333
1334 /*****************************************************************************
1335  * IDockingWindowFrame interface
1336  */
1337 [
1338     object,
1339     uuid(47d2657a-7b27-11d0-8ca9-00a0c92dbfe8),
1340     pointer_default(unique),
1341     local
1342 ]
1343 interface IDockingWindowFrame : IOleWindow
1344 {
1345 cpp_quote("#define DWFRF_NORMAL           0x0000")
1346 cpp_quote("#define DWFRF_DELETECONFIGDATA 0x0001")
1347 cpp_quote("#define DWFAF_HIDDEN           0x0001")
1348
1349     HRESULT AddToolbar(
1350         [in] IUnknown *punkSrc,
1351         [in] LPCWSTR pwszItem,
1352         [in] DWORD dwAddFlags);
1353
1354     HRESULT RemoveToolbar(
1355         [in] IUnknown *punkSrc,
1356         [in] DWORD dwRemoveFlags);
1357
1358     HRESULT FindToolbar(
1359         [in] LPCWSTR pwszItem,
1360         [in] REFIID riid,
1361         [out] LPVOID *ppvObj);
1362 }
1363
1364
1365 /*****************************************************************************
1366  * IDragSourceHelper interface
1367  */
1368 [
1369     object,
1370     uuid(de5bf786-477a-11d2-839d-00c04fd918d0),
1371     pointer_default(unique),
1372     local
1373 ]
1374 interface IDragSourceHelper : IUnknown
1375 {
1376     typedef struct
1377     {
1378         SIZE     sizeDragImage;
1379         POINT    ptOffset;
1380         HBITMAP  hbmpDragImage;
1381         COLORREF crColorKey;
1382     } SHDRAGIMAGE, *LPSHDRAGIMAGE;
1383
1384   HRESULT InitializeFromBitmap(
1385       [in] LPSHDRAGIMAGE pshdi,
1386       [in] IDataObject *pDataObject);
1387
1388   HRESULT InitializeFromWindow(
1389       [in] HWND hwnd,
1390       [in] POINT *ppt,
1391       [in] IDataObject *pDataObject);
1392 }
1393
1394
1395 /*****************************************************************************
1396  * IDropTargetHelper interface
1397  */
1398 [
1399     object,
1400     uuid(4657278b-411b-11d2-839a-00c04fd918d0),
1401     pointer_default(unique),
1402     local
1403 ]
1404 interface IDropTargetHelper : IUnknown
1405 {
1406     HRESULT DragEnter(
1407         [in] HWND hwndTarget,
1408         [in] IDataObject *pDataObject,
1409         [in] POINT *ppt,
1410         [in] DWORD dwEffect);
1411
1412     HRESULT DragLeave();
1413
1414     HRESULT DragOver(
1415         [in] POINT *ppt,
1416         [in] DWORD dwEffect);
1417
1418     HRESULT Drop(
1419         [in] IDataObject *pDataObject,
1420         [in] POINT *ppt,
1421         [in] DWORD dwEffect);
1422
1423     HRESULT Show( [in] BOOL fShow );
1424 }
1425
1426
1427 /*****************************************************************************
1428  * IContextMenu interface
1429  */
1430 [
1431     object,
1432     uuid(000214e4-0000-0000-c000-000000000046),
1433     pointer_default(unique),
1434     local
1435 ]
1436 interface IContextMenu : IUnknown
1437 {
1438 cpp_quote("#define CMF_NORMAL        0x00000000")
1439 cpp_quote("#define CMF_DEFAULTONLY   0x00000001")
1440 cpp_quote("#define CMF_VERBSONLY     0x00000002")
1441 cpp_quote("#define CMF_EXPLORE       0x00000004")
1442 cpp_quote("#define CMF_NOVERBS       0x00000008")
1443 cpp_quote("#define CMF_CANRENAME     0x00000010")
1444 cpp_quote("#define CMF_NODEFAULT     0x00000020")
1445 cpp_quote("#define CMF_INCLUDESTATIC 0x00000040")
1446 cpp_quote("#define CMF_EXTENDEDVERBS 0x00000100")
1447 cpp_quote("#define CMF_RESERVED      0xffff0000")
1448
1449 cpp_quote("#define GCS_VERBA         0x00000000")
1450 cpp_quote("#define GCS_HELPTEXTA     0x00000001")
1451 cpp_quote("#define GCS_VALIDATEA     0x00000002")
1452 cpp_quote("#define GCS_VERBW         0x00000004")
1453 cpp_quote("#define GCS_HELPTEXTW     0x00000005")
1454 cpp_quote("#define GCS_VALIDATEW     0x00000006")
1455 cpp_quote("#define GCS_UNICODE       0x00000004")
1456 cpp_quote("#define GCS_VERB          WINELIB_NAME_AW(GCS_VERB)")
1457 cpp_quote("#define GCS_HELPTEXT      WINELIB_NAME_AW(GCS_HELPTEXT)")
1458 cpp_quote("#define GCS_VALIDATE      WINELIB_NAME_AW(GCS_VALIDATE)")
1459
1460 cpp_quote("#define CMDSTR_NEWFOLDERA   \"NewFolder\"")
1461 cpp_quote("#define CMDSTR_VIEWLISTA    \"ViewList\"")
1462 cpp_quote("#define CMDSTR_VIEWDETAILSA \"ViewDetails\"")
1463 cpp_quote("#if defined(__GNUC__)")
1464 cpp_quote("# define CMDSTR_NEWFOLDERW (const WCHAR []){ 'N','e','w','F','o','l','d','e','r',0 }")
1465 cpp_quote("# define CMDSTR_VIEWLISTW (const WCHAR []){ 'V','i','e','w','L','i','s','t',0 }")
1466 cpp_quote("# define CMDSTR_VIEWDETAILSW (const WCHAR []){ 'V','i','e','w','D','e','t','a','i','l','s',0 }")
1467 cpp_quote("#elif defined(_MSC_VER)")
1468 cpp_quote("# define CMDSTR_NEWFOLDERW   L\"NewFolder\"")
1469 cpp_quote("# define CMDSTR_VIEWLISTW    L\"ViewList\"")
1470 cpp_quote("# define CMDSTR_VIEWDETAILSW L\"ViewDetails\"")
1471 cpp_quote("#else")
1472 cpp_quote("static const WCHAR CMDSTR_NEWFOLDERW[] = {'N','e','w','F','o','l','d','e','r',0};")
1473 cpp_quote("static const WCHAR CMDSTR_VIEWLISTW [] = {'V','i','e','w','L','i','s','t',0};")
1474 cpp_quote("static const WCHAR CMDSTR_VIEWDETAILSW[] = {'V','i','e','w','D','e','t','a','i','l','s',0};")
1475 cpp_quote("#endif")
1476 cpp_quote("#define CMDSTR_NEWFOLDER    WINELIB_NAME_AW(CMDSTR_NEWFOLDER)")
1477 cpp_quote("#define CMDSTR_VIEWLIST     WINELIB_NAME_AW(CMDSTR_VIEWLIST)")
1478 cpp_quote("#define CMDSTR_VIEWDETAILS  WINELIB_NAME_AW(CMDSTR_VIEWDETAILS)")
1479
1480 cpp_quote("#define CMIC_MASK_HOTKEY         SEE_MASK_HOTKEY")
1481 cpp_quote("#define CMIC_MASK_ICON           SEE_MASK_ICON")
1482 cpp_quote("#define CMIC_MASK_FLAG_NO_UI     SEE_MASK_FLAG_NO_UI")
1483 cpp_quote("#define CMIC_MASK_UNICODE        SEE_MASK_UNICODE")
1484 cpp_quote("#define CMIC_MASK_NO_CONSOLE     SEE_MASK_NO_CONSOLE")
1485 cpp_quote("#define CMIC_MASK_HASLINKNAME    SEE_MASK_HASLINKNAME")
1486 cpp_quote("#define CMIC_MASK_FLAG_SEP_VDM   SEE_MASK_FLAG_SEPVDM")
1487 cpp_quote("#define CMIC_MASK_HASTITLE       SEE_MASK_HASTITLE")
1488 cpp_quote("#define CMIC_MASK_ASYNCOK        SEE_MASK_ASYNCOK")
1489 cpp_quote("#define CMIC_MASK_NOASYNC        SEE_MASK_NOASYNC")
1490 cpp_quote("#define CMIC_MASK_SHIFT_DOWN     0x10000000")
1491 cpp_quote("#define CMIC_MASK_PTINVOKE       0x20000000")
1492 cpp_quote("#define CMIC_MASK_CONTROL_DOWN   0x40000000")
1493 cpp_quote("#define CMIC_MASK_FLAG_LOG_USAGE SEE_MASK_FLAG_LOG_USAGE")
1494 cpp_quote("#define CMIC_MASK_NOZONECHECKS   SEE_MASK_NOZONECHECKS")
1495
1496     typedef IContextMenu *LPCONTEXTMENU;
1497
1498     typedef struct tagCMINVOKECOMMANDINFO
1499     {
1500         DWORD cbSize;
1501         DWORD fMask;
1502         HWND hwnd;
1503         LPCSTR lpVerb;
1504         LPCSTR lpParameters;
1505         LPCSTR lpDirectory;
1506         INT nShow;
1507         DWORD dwHotKey;
1508         HANDLE hIcon;
1509     } CMINVOKECOMMANDINFO, *LPCMINVOKECOMMANDINFO;
1510
1511     typedef struct tagCMInvokeCommandInfoEx
1512     {
1513         DWORD cbSize;
1514         DWORD fMask;
1515         HWND hwnd;
1516         LPCSTR lpVerb;
1517         LPCSTR lpParameters;
1518         LPCSTR lpDirectory;
1519         INT nShow;
1520         DWORD dwHotKey;
1521         HANDLE hIcon;
1522         LPCSTR lpTitle;
1523         LPCWSTR lpVerbW;
1524         LPCWSTR lpParametersW;
1525         LPCWSTR lpDirectoryW;
1526         LPCWSTR lpTitleW;
1527         POINT ptInvoke;
1528     } CMINVOKECOMMANDINFOEX, *LPCMINVOKECOMMANDINFOEX;
1529
1530     HRESULT QueryContextMenu(
1531         [in] HMENU hmenu,
1532         [in] UINT indexMenu,
1533         [in] UINT idCmdFirst,
1534         [in] UINT idCmdLast,
1535         [in] UINT uFlags);
1536
1537     HRESULT InvokeCommand( [in] LPCMINVOKECOMMANDINFO lpici );
1538
1539     HRESULT GetCommandString(
1540         [in] UINT_PTR idCmd,
1541         [in] UINT uType,
1542         [out] UINT *pwReserved,
1543         [out, size_is(cchMax)] LPSTR pszName,
1544         [in] UINT cchMax);
1545 }
1546
1547
1548 /*****************************************************************************
1549  * IContextMenu2 interface
1550  */
1551 [
1552     object,
1553     uuid(000214f4-0000-0000-c000-000000000046),
1554     pointer_default(unique),
1555     local
1556 ]
1557 interface IContextMenu2 : IContextMenu
1558 {
1559     typedef IContextMenu2 *LPCONTEXTMENU2;
1560
1561     HRESULT HandleMenuMsg(
1562         [in] UINT uMsg,
1563         [in] WPARAM wParam,
1564         [in] LPARAM lParam);
1565 }
1566
1567
1568 /*****************************************************************************
1569  * IContextMenu3 interface
1570  */
1571 [
1572     object,
1573     uuid(bcfce0a0-ec17-11d0-8d10-00a0c90f2719),
1574     pointer_default(unique),
1575     local
1576 ]
1577 interface IContextMenu3 : IContextMenu2
1578 {
1579     typedef IContextMenu3 *LPCONTEXTMENU3;
1580
1581     HRESULT HandleMenuMsg2(
1582         [in] UINT uMsg,
1583         [in] WPARAM wParam,
1584         [in] LPARAM lParam,
1585         [out] LRESULT *plResult);
1586 }
1587
1588 /*****************************************************************************
1589  * IContextMenuCB interface
1590  */
1591
1592 [
1593     object,
1594     uuid(3409e930-5a39-11d1-83fa-00a0c90dc849),
1595     pointer_default(unique),
1596     local
1597 ]
1598 interface IContextMenuCB : IUnknown
1599 {
1600     HRESULT CallBack(
1601         [in] IShellFolder *psf,
1602         [in] HWND hwndOwner,
1603         [in] IDataObject *pdtobj,
1604         [in] UINT uMsg,
1605         [in] WPARAM wParam,
1606         [in] LPARAM lParam);
1607 }
1608
1609 /*****************************************************************************
1610  * IShellExecuteHookA interface
1611  */
1612 [
1613     object,
1614     uuid(000214f5-0000-0000-c000-000000000046),
1615     pointer_default(unique),
1616     local
1617 ]
1618 interface IShellExecuteHookA : IUnknown
1619 {
1620     cpp_quote("struct _SHELLEXECUTEINFOA;")
1621     HRESULT Execute(
1622         [in, out] struct _SHELLEXECUTEINFOA* pei);
1623 }
1624
1625
1626 /*****************************************************************************
1627  * IShellExecuteHookW interface
1628  */
1629 [
1630     object,
1631     uuid(000214fb-0000-0000-c000-000000000046),
1632     pointer_default(unique),
1633     local
1634 ]
1635 interface IShellExecuteHookW : IUnknown
1636 {
1637     cpp_quote("struct _SHELLEXECUTEINFOW;")
1638     HRESULT Execute(
1639                 [in, out] struct _SHELLEXECUTEINFOW* pei);
1640 }
1641
1642 /*****************************************************************************
1643  * IShellLinkDataList interface
1644  */
1645 [
1646     object,
1647     uuid(45e2b4ae-b1c3-11d0-b92f-00a0c90312e1),
1648     pointer_default(unique)
1649 ]
1650 interface IShellLinkDataList : IUnknown
1651 {
1652     [local] HRESULT AddDataBlock(
1653                 [in] void *pDataBlock);
1654     [local] HRESULT CopyDataBlock(
1655                 [in] DWORD dwSig,
1656                 [out] void **ppDataBlock);
1657     HRESULT RemoveDataBlock(
1658                 [in] DWORD dwSig);
1659     HRESULT GetFlags(
1660                 [out] DWORD *pdwFlags);
1661     HRESULT SetFlags(
1662                 [in] DWORD dwFlags);
1663 }
1664
1665
1666 /*****************************************************************************
1667  * IResolveShellLink interface
1668  */
1669 [
1670     object,
1671     uuid(5cd52983-9449-11d2-963a-00c04f79adf0),
1672     pointer_default(unique)
1673 ]
1674 interface IResolveShellLink : IUnknown
1675 {
1676     HRESULT ResolveShellLink(
1677                 [in] IUnknown *punk,
1678                 [in] HWND hwnd,
1679                 [in] DWORD fFlags);
1680 }
1681
1682
1683 /*****************************************************************************
1684  * IURLSearchHook interface
1685  */
1686 [
1687     object,
1688     uuid(ac60f6a0-0fd9-11d0-99cb-00c04fd64497),
1689     pointer_default(unique),
1690     local
1691 ]
1692 interface IURLSearchHook : IUnknown
1693 {
1694     HRESULT Translate(
1695                 [in, out] LPWSTR lpwszSearchURL,
1696                 [in] DWORD cchBufferSize);
1697 }
1698
1699
1700 /*****************************************************************************
1701  * ISearchContext interface
1702  */
1703 [
1704     object,
1705     uuid(09f656a2-41af-480c-88f7-16cc0d164615),
1706     pointer_default(unique),
1707     local
1708 ]
1709 interface ISearchContext : IUnknown
1710 {
1711     HRESULT GetSearchUrl(
1712                 [in] BSTR *pbstrSearchUrl);
1713     HRESULT GetSearchText(
1714                 [in] BSTR *pbstrSearchText);
1715     HRESULT GetSearchStyle(
1716                 [in] BSTR *pdwSearchStyle);
1717 }
1718
1719
1720 /*****************************************************************************
1721  * IURLSearchHook2 interface
1722  */
1723 [
1724     object,
1725     uuid(5ee44da4-6d32-46e3-86bc-07540dedd0e0),
1726     pointer_default(unique),
1727     local
1728 ]
1729 interface IURLSearchHook2 : IURLSearchHook
1730 {
1731     HRESULT TranslateWithSearchContext(
1732                 [in, out] LPWSTR lpwszSearchURL,
1733                 [in] DWORD cchBufferSize,
1734                 [in] ISearchContext *pSearchContext);
1735 }
1736
1737
1738 cpp_quote("#define INewShortcutHook WINELIB_NAME_AW(INewShortcutHook)")
1739
1740 /*****************************************************************************
1741  * INewShortcutHookA interface
1742  */
1743 [
1744     object,
1745     uuid(000214e1-0000-0000-c000-000000000046),
1746     pointer_default(unique),
1747     local
1748 ]
1749 interface INewShortcutHookA : IUnknown
1750 {
1751     HRESULT SetReferent(
1752                 [in] LPCSTR pcszReferent,
1753                 [in] HWND hwnd);
1754     HRESULT GetReferent(
1755                 [out] LPSTR pcszReferent,
1756                 [in] int cchReferent);
1757     HRESULT SetFolder(
1758                 [in] LPCSTR pcszReferent);
1759     HRESULT GetFolder(
1760                 [out] LPSTR pcszReferent,
1761                 [in] int cchFolder);
1762     HRESULT GetName(
1763                 [out] LPSTR pszName,
1764                 [in] int cchName);
1765     HRESULT GetExtension(
1766                 [out] LPSTR pszExtension,
1767                 [in] int cchExtension);
1768 }
1769
1770
1771 /*****************************************************************************
1772  * INewShortcutHookW interface
1773  */
1774 [
1775     object,
1776     uuid(000214f7-0000-0000-c000-000000000046),
1777     pointer_default(unique),
1778     local
1779 ]
1780 interface INewShortcutHookW : IUnknown
1781 {
1782     HRESULT SetReferent(
1783                 [in] LPCWSTR pcszReferent,
1784                 [in] HWND hwnd);
1785     HRESULT GetReferent(
1786                 [out] LPWSTR pcszReferent,
1787                 [in] int cchReferent);
1788     HRESULT SetFolder(
1789                 [in] LPCWSTR pcszReferent);
1790     HRESULT GetFolder(
1791                 [out] LPWSTR pcszReferent,
1792                 [in] int cchFolder);
1793     HRESULT GetName(
1794                 [out] LPWSTR pszName,
1795                 [in] int cchName);
1796     HRESULT GetExtension(
1797                 [out] LPWSTR pszExtension,
1798                 [in] int cchExtension);
1799 }
1800
1801 /*****************************************************************************
1802  * IRunnableTask interface
1803  */
1804 [
1805     object,
1806     uuid(85788d00-6807-11d0-b810-00c04fd706ec),
1807     pointer_default(unique),
1808     local
1809 ]
1810 interface IRunnableTask : IUnknown
1811 {
1812     HRESULT Run();
1813     HRESULT Kill([in] BOOL fWait);
1814     HRESULT Suspend();
1815     HRESULT Resume();
1816     ULONG IsRunning();
1817 }
1818
1819 /*****************************************************************************
1820  * IShellChangeNotify interface
1821  */
1822 [
1823     object,
1824     uuid(d82be2b1-5764-11d0-a96e-00c04fd705a2),
1825     pointer_default(unique),
1826     local
1827 ]
1828 interface IShellChangeNotify : IUnknown
1829 {
1830     HRESULT OnChange(
1831                 [in] LONG lEvent,
1832                 [in] LPCITEMIDLIST pidl1,
1833                 [in] LPCITEMIDLIST pidl2);
1834 }
1835
1836 /*****************************************************************************
1837  * IFileSystemBindData interface
1838  */
1839 [
1840     object,
1841     uuid(01e18d10-4d8b-11d2-855d-006008059367),
1842     pointer_default(unique),
1843     local
1844 ]
1845 interface IFileSystemBindData : IUnknown
1846 {
1847     HRESULT SetFindData(
1848                 [in] const WIN32_FIND_DATAW *pfd);
1849     HRESULT GetFindData(
1850                 [out] WIN32_FIND_DATAW *pfd);
1851 }
1852
1853 /*****************************************************************************
1854  *    ITaskbarList interface
1855  */
1856 [
1857     object,
1858     uuid(56FDF342-FD6D-11d0-958A-006097C9A090),
1859     pointer_default(unique)
1860 ]
1861 interface ITaskbarList : IUnknown
1862 {
1863     HRESULT HrInit();
1864
1865     HRESULT AddTab(
1866         [in] HWND hwnd);
1867
1868     HRESULT DeleteTab(
1869         [in] HWND hwnd);
1870
1871     HRESULT ActivateTab(
1872         [in] HWND hwnd);
1873
1874     HRESULT SetActiveAlt(
1875         [in] HWND hwnd);
1876 }
1877
1878 /*****************************************************************************
1879  * IDefaultExtractIconInit interface
1880  */
1881
1882 [
1883     object,
1884     uuid(800AB0B8-F5FA-4e72-8FF3-B1A243B87BD9), /* FIXME: wrong value! */
1885     pointer_default(unique),
1886         local
1887 ]
1888 interface IDefaultExtractIconInit : IUnknown
1889 {
1890     HRESULT SetDefaultIcon(
1891                        [in] LPCWSTR pszFile,
1892                        [in] int iIcon);
1893     HRESULT SetFlags(
1894                        [in] UINT uFlags);
1895     HRESULT SetKey(
1896                        [in] HKEY hkey);
1897     HRESULT SetNormalIcon(
1898                        [in] LPCWSTR pszFile,
1899                        [in] int iIcon);
1900     HRESULT SetOpenIcon(
1901                        [in] LPCWSTR pszFile,
1902                        [in] int iIcon);
1903     HRESULT SetShortcutIcon(
1904                        [in] LPCWSTR pszFile,
1905                        [in] int iIcon);
1906 }
1907
1908 /*****************************************************************************
1909  * IDeskBand interface
1910  */
1911 cpp_quote("#define DBIM_MINSIZE    0x0001")
1912 cpp_quote("#define DBIM_MAXSIZE    0x0002")
1913 cpp_quote("#define DBIM_INTEGRAL   0x0004")
1914 cpp_quote("#define DBIM_ACTUAL     0x0008")
1915 cpp_quote("#define DBIM_TITLE      0x0010")
1916 cpp_quote("#define DBIM_MODEFLAGS  0x0020")
1917 cpp_quote("#define DBIM_BKCOLOR    0x0040")
1918
1919 cpp_quote("#include <pshpack8.h>")
1920
1921 typedef struct tagDESKBANDINFO
1922 {
1923     DWORD       dwMask;
1924     POINTL      ptMinSize;
1925     POINTL      ptMaxSize;
1926     POINTL      ptIntegral;
1927     POINTL      ptActual;
1928     WCHAR       wszTitle[256];
1929     DWORD       dwModeFlags;
1930     COLORREF    crBkgnd;
1931 } DESKBANDINFO;
1932
1933 cpp_quote("#include <poppack.h>")
1934
1935 cpp_quote("#define DBIMF_NORMAL            0x0000")
1936 cpp_quote("#define DBIMF_FIXED             0x0001")
1937 cpp_quote("#define DBIMF_FIXEDBMP          0x0004   // a fixed background bitmap (if supported)")
1938 cpp_quote("#define DBIMF_VARIABLEHEIGHT    0x0008")
1939 cpp_quote("#define DBIMF_UNDELETEABLE      0x0010")
1940 cpp_quote("#define DBIMF_DEBOSSED          0x0020")
1941 cpp_quote("#define DBIMF_BKCOLOR           0x0040")
1942 cpp_quote("#define DBIMF_USECHEVRON        0x0080")
1943 cpp_quote("#define DBIMF_BREAK             0x0100")
1944 cpp_quote("#define DBIMF_ADDTOFRONT        0x0200")
1945 cpp_quote("#define DBIMF_TOPALIGN          0x0400")
1946 cpp_quote("#if (NTDDI_VERSION >= NTDDI_LONGHORN)")
1947 cpp_quote("#define DBIMF_NOGRIPPER         0x0800")
1948 cpp_quote("#define DBIMF_ALWAYSGRIPPER     0x1000")
1949 cpp_quote("#define DBIMF_NOMARGINS         0x2000")
1950 cpp_quote("#endif  // NTDDI_LONGHORN")
1951
1952 cpp_quote("#define DBIF_VIEWMODE_NORMAL         0x0000")
1953 cpp_quote("#define DBIF_VIEWMODE_VERTICAL       0x0001")
1954 cpp_quote("#define DBIF_VIEWMODE_FLOATING       0x0002")
1955 cpp_quote("#define DBIF_VIEWMODE_TRANSPARENT    0x0004")
1956
1957 enum tagDESKBANDCID {
1958     DBID_BANDINFOCHANGED    = 0,
1959     DBID_SHOWONLY           = 1,
1960     DBID_MAXIMIZEBAND       = 2,
1961     DBID_PUSHCHEVRON        = 3,
1962     DBID_DELAYINIT          = 4,
1963     DBID_FINISHINIT         = 5,
1964     DBID_SETWINDOWTHEME     = 6,
1965     DBID_PERMITAUTOHIDE     = 7,
1966 };
1967
1968 cpp_quote("#define DBPC_SELECTFIRST    (DWORD)-1")
1969 cpp_quote("#define DBPC_SELECTLAST     (DWORD)-2")
1970
1971 cpp_quote("#define CGID_DeskBand IID_IDeskBand")
1972
1973 [
1974     uuid(EB0FE172-1A3A-11D0-89B3-00A0C90A90AC),
1975     object,
1976 ]
1977 interface IDeskBand : IDockingWindow
1978 {
1979     HRESULT GetBandInfo(
1980         [in] DWORD dwBandID,
1981         [in] DWORD dwViewMode,
1982         [in, out] DESKBANDINFO* pdbi);
1983 }
1984
1985 cpp_quote("#if (_WIN32_IE >= _WIN32_IE_IE60)")
1986
1987 [
1988     uuid(EB0FE173-1A3A-11D0-89B3-00A0C90A90AC),
1989     object,
1990     pointer_default(unique),
1991     local
1992 ]
1993 interface IDeskBar : IOleWindow
1994 {
1995     HRESULT SetClient([in] IUnknown* punkClient);
1996
1997     HRESULT GetClient([out] IUnknown** ppunkClient);
1998
1999     HRESULT OnPosRectChangeDB([in] RECT *prc);
2000 }
2001
2002
2003 /*****************************************************************************
2004  * IMenuPopup interface
2005  */
2006 [
2007     uuid(D1E7AFEB-6A2E-11d0-8C78-00C04FD918B4),
2008     object,
2009     pointer_default(unique),
2010     local
2011 ]
2012 interface IMenuPopup : IDeskBar
2013 {
2014     enum tagMENUPOPUPSELECT
2015     {
2016         MPOS_EXECUTE = 0,
2017         MPOS_FULLCANCEL,
2018         MPOS_CANCELLEVEL,
2019         MPOS_SELECTLEFT,
2020         MPOS_SELECTRIGHT,
2021         MPOS_CHILDTRACKING
2022     };
2023
2024     enum tagMENUPOPUPPOPUPFLAGS
2025     {
2026         MPPF_SETFOCUS      = 0x00000001,
2027         MPPF_INITIALSELECT = 0x00000002,
2028         MPPF_NOANIMATE     = 0x00000004,
2029         MPPF_KEYBOARD      = 0x00000010,
2030         MPPF_REPOSITION    = 0x00000020,
2031         MPPF_FORCEZORDER   = 0x00000040,
2032         MPPF_FINALSELECT   = 0x00000080,
2033         MPPF_TOP           = 0x20000000,
2034         MPPF_LEFT          = 0x40000000,
2035         MPPF_RIGHT         = 0x60000000,
2036         MPPF_BOTTOM        = 0x80000000,
2037         MPPF_POS_MASK      = 0xE0000000,
2038         MPPF_ALIGN_LEFT    = 0x02000000,
2039         MPPF_ALIGN_RIGHT   = 0x04000000
2040     };
2041     typedef int MP_POPUPFLAGS;
2042
2043     HRESULT Popup(
2044         [in] POINTL *ppt,
2045         [in] RECTL *prcExclude,
2046         [in] MP_POPUPFLAGS dwFlags);
2047
2048     HRESULT OnSelect([in] DWORD dwSelectType);
2049
2050     HRESULT SetSubMenu(
2051         [in] IMenuPopup* pmp,
2052         [in] BOOL fSet);
2053 }
2054
2055 cpp_quote("#endif /* _WIN32_IE_IE60 */")
2056
2057 cpp_quote("#if (_WIN32_IE >= _WIN32_IE_IE40)")
2058
2059 /*****************************************************************************
2060  * IBandSite interface
2061  */
2062 cpp_quote("#include <pshpack8.h>")
2063
2064 typedef struct tagBANDSITEINFO
2065 {
2066     DWORD dwMask;
2067     DWORD dwState;
2068     DWORD dwStyle;
2069 } BANDSITEINFO;
2070
2071 cpp_quote("#include <poppack.h>")
2072
2073
2074 enum tagBANDSITECID {
2075     BSID_BANDADDED,
2076     BSID_BANDREMOVED,
2077 };
2078
2079 cpp_quote("#define BSIM_STATE        0x00000001")
2080 cpp_quote("#define BSIM_STYLE        0x00000002")
2081
2082 cpp_quote("#define BSSF_VISIBLE      0x00000001")
2083 cpp_quote("#define BSSF_NOTITLE      0x00000002")
2084 cpp_quote("#define BSSF_UNDELETEABLE 0x00001000")
2085
2086 cpp_quote("#define BSIS_AUTOGRIPPER       0x00000000")
2087 cpp_quote("#define BSIS_NOGRIPPER         0x00000001")
2088 cpp_quote("#define BSIS_ALWAYSGRIPPER     0x00000002")
2089 cpp_quote("#define BSIS_LEFTALIGN         0x00000004")
2090 cpp_quote("#define BSIS_SINGLECLICK       0x00000008")
2091 cpp_quote("#define BSIS_NOCONTEXTMENU     0x00000010")
2092 cpp_quote("#define BSIS_NODROPTARGET      0x00000020")
2093 cpp_quote("#define BSIS_NOCAPTION         0x00000040")
2094 cpp_quote("#define BSIS_PREFERNOLINEBREAK 0x00000080")
2095 cpp_quote("#define BSIS_LOCKED            0x00000100")
2096 cpp_quote("#if (_WIN32_IE >= _WIN32_IE_IE70)")
2097 cpp_quote("#define BSIS_PRESERVEORDERDURINGLAYOUT 0x00000200")
2098 cpp_quote("#endif  /* _WIN32_IE_IE70 */")
2099
2100 cpp_quote("#define SID_SBandSite IID_IBandSite")
2101 cpp_quote("#define CGID_BandSite IID_IBandSite")
2102
2103 [
2104     object,
2105     uuid(4CF504B0-DE96-11D0-8B3F-00A0C911E8E5)
2106 ]
2107 interface IBandSite : IUnknown
2108 {
2109     HRESULT AddBand([in] IUnknown* punk);
2110
2111     HRESULT EnumBands(
2112         [in] UINT uBand,
2113         [out] DWORD* pdwBandID);
2114
2115     HRESULT QueryBand(
2116         [in] DWORD dwBandID,
2117         [out] IDeskBand** ppstb,
2118         [out] DWORD* pdwState,
2119         [out, string, size_is(cchName)] LPWSTR pszName,
2120         [in] int cchName);
2121
2122     HRESULT SetBandState(
2123         [in] DWORD dwBandID,
2124         [in] DWORD dwMask,
2125         [in] DWORD dwState);
2126
2127     HRESULT RemoveBand([in] DWORD dwBandID);
2128
2129     HRESULT GetBandObject(
2130         [in] DWORD dwBandID,
2131         [in] REFIID riid,
2132         [out, iid_is(riid)] void **ppv);
2133
2134     HRESULT SetBandSiteInfo([in] const BANDSITEINFO *pbsinfo);
2135
2136     HRESULT GetBandSiteInfo([in, out] BANDSITEINFO *pbsinfo);
2137 }
2138
2139 cpp_quote("#endif /* _WIN32_IE_IE40 */")
2140
2141 /*****************************************************************************
2142  * IMenuBand interface
2143  */
2144 [
2145     uuid(568804CD-CBD7-11d0-9816-00C04FD91972),
2146     object,
2147     pointer_default(unique),
2148     local
2149 ]
2150 interface IMenuBand : IUnknown
2151 {
2152     enum tagMENUBANDHANDLERCID {
2153         MBHANDCID_PIDLSELECT = 0,
2154     };
2155
2156     HRESULT IsMenuMessage([in] MSG* pmsg);
2157
2158     HRESULT TranslateMenuMessage(
2159         [in, out] MSG* pmsg,
2160         [out] LRESULT* plRet);
2161 }
2162
2163 /*****************************************************************************
2164  * IProfferService interface
2165  */
2166 [
2167     uuid(cb728b20-f786-11ce-92ad-00aa00a74cd0),
2168     object,
2169     pointer_default(unique),
2170     local
2171 ]
2172 interface IProfferService : IUnknown
2173 {
2174     HRESULT ProfferService(
2175         [in] REFGUID service,
2176         [in] IServiceProvider *pService,
2177         [out] DWORD *pCookie);
2178
2179     HRESULT RevokeService([in] DWORD cookie);
2180 }
2181
2182 /*****************************************************************************
2183  * IShellMenuCallback interface
2184  */
2185 cpp_quote("#include <pshpack8.h>")
2186
2187 typedef struct tagSMDATA
2188 {
2189         DWORD                   dwMask;
2190         DWORD                   dwFlags;
2191         HMENU                   hmenu;
2192         HWND                    hwnd;
2193         UINT                    uId;
2194         UINT                    uIdParent;
2195         UINT                    uIdAncestor;
2196         IUnknown                *punk;
2197         LPITEMIDLIST    pidlFolder;
2198         LPITEMIDLIST    pidlItem;
2199         IShellFolder    *psf;
2200         void                    *pvUserData;
2201 } SMDATA, *LPSMDATA;
2202
2203 cpp_quote("#define SMDM_SHELLFOLDER             0x00000001")
2204 cpp_quote("#define SMDM_HMENU                   0x00000002")
2205 cpp_quote("#define SMDM_TOOLBAR                 0x00000004")
2206
2207 typedef struct tagSMINFO
2208 {
2209         DWORD                   dwMask;
2210         DWORD                   dwType;
2211         DWORD                   dwFlags;
2212         int                             iIcon;
2213 } SMINFO, *PSMINFO;
2214
2215 typedef struct tagSHCSCHANGENOTIFYSTRUCT
2216 {
2217         LONG                    lEvent;
2218         LPCITEMIDLIST   pidl1;
2219         LPCITEMIDLIST   pidl2;
2220 } SMCSHCHANGENOTIFYSTRUCT, *PSMCSHCHANGENOTIFYSTRUCT;
2221
2222 cpp_quote("#include <poppack.h>")
2223
2224 enum
2225 {
2226         SMIM_TYPE                       = 0x00000001,
2227         SMIM_FLAGS                      = 0x00000002,
2228         SMIM_ICON                       = 0x00000004
2229 };
2230
2231 enum
2232 {
2233         SMIT_SEPARATOR      = 0x00000001,
2234         SMIT_STRING         = 0x00000002
2235 };
2236
2237 enum
2238 {
2239         SMIF_ICON                       = 0x00000001,
2240         SMIF_ACCELERATOR        = 0x00000002,
2241         SMIF_DROPTARGET         = 0x00000004,
2242         SMIF_SUBMENU            = 0x00000008,
2243         SMIF_CHECKED            = 0x00000020,
2244         SMIF_DROPCASCADE        = 0x00000040,
2245         SMIF_HIDDEN                     = 0x00000080,
2246         SMIF_DISABLED           = 0x00000100,
2247         SMIF_TRACKPOPUP         = 0x00000200,
2248         SMIF_DEMOTED            = 0x00000400,
2249         SMIF_ALTSTATE           = 0x00000800,
2250         SMIF_DRAGNDROP          = 0x00001000,
2251         SMIF_NEW                        = 0x00002000,
2252 };
2253
2254
2255 cpp_quote("#define SMC_INITMENU                         0x00000001")
2256 cpp_quote("#define SMC_CREATE                           0x00000002")
2257 cpp_quote("#define SMC_EXITMENU                         0x00000003")
2258 cpp_quote("#define SMC_GETINFO                          0x00000005")
2259 cpp_quote("#define SMC_GETSFINFO                        0x00000006")
2260 cpp_quote("#define SMC_GETOBJECT                        0x00000007")
2261 cpp_quote("#define SMC_GETSFOBJECT                      0x00000008")
2262 cpp_quote("#define SMC_SFEXEC                           0x00000009")
2263 cpp_quote("#define SMC_SFSELECTITEM                     0x0000000A")
2264 cpp_quote("#define SMC_REFRESH                          0x00000010")
2265 cpp_quote("#define SMC_DEMOTE                           0x00000011")
2266 cpp_quote("#define SMC_PROMOTE                          0x00000012")
2267 cpp_quote("#define SMC_DEFAULTICON                      0x00000016")
2268 cpp_quote("#define SMC_NEWITEM                          0x00000017")
2269 cpp_quote("#define SMC_CHEVRONEXPAND            0x00000019")
2270 cpp_quote("#define SMC_DISPLAYCHEVRONTIP        0x0000002A")
2271 cpp_quote("#define SMC_SETSFOBJECT                      0x0000002D")
2272 cpp_quote("#define SMC_SHCHANGENOTIFY           0x0000002E")
2273 cpp_quote("#define SMC_CHEVRONGETTIP            0x0000002F")
2274 cpp_quote("#define SMC_SFDDRESTRICTED           0x00000030")
2275
2276 [
2277     uuid(4CA300A1-9B8D-11d1-8B22-00C04FD918D0),
2278     object,
2279     pointer_default(unique),
2280     local
2281 ]
2282 interface IShellMenuCallback : IUnknown
2283 {
2284         HRESULT CallbackSM(
2285                 [in, out] LPSMDATA psmd,
2286         [in] UINT uMsg,
2287         [in] WPARAM wParam,
2288         [in] LPARAM lParam);
2289 }
2290
2291
2292 /*****************************************************************************
2293  * IShellMenu interface
2294  */
2295
2296 cpp_quote("#define SMINIT_DEFAULT               0x00000000")
2297 cpp_quote("#define SMINIT_RESTRICT_DRAGDROP     0x00000002")
2298 cpp_quote("#define SMINIT_TOPLEVEL              0x00000004")
2299 cpp_quote("#define SMINIT_CACHED                0x00000010")
2300 cpp_quote("#define SMINIT_VERTICAL              0x10000000")
2301 cpp_quote("#define SMINIT_HORIZONTAL            0x20000000")
2302 cpp_quote("")
2303 cpp_quote("#define ANCESTORDEFAULT              (UINT)-1")
2304 cpp_quote("")
2305 cpp_quote("#define SMSET_TOP                    0x10000000")
2306 cpp_quote("#define SMSET_BOTTOM                 0x20000000")
2307 cpp_quote("#define SMSET_DONTOWN                0x00000001")
2308 cpp_quote("")
2309 cpp_quote("#define SMINV_REFRESH                0x00000001")
2310 cpp_quote("#define SMINV_ID                     0x00000008")
2311
2312 [
2313     uuid(EE1F7637-E138-11d1-8379-00C04FD918D0),
2314     object,
2315     pointer_default(unique),
2316     local
2317 ]
2318 interface IShellMenu : IUnknown
2319 {
2320         HRESULT Initialize(
2321                 [in] IShellMenuCallback *psmc,
2322         [in] UINT uId,
2323         [in] UINT uIdAncestor,
2324         [in] DWORD dwFlags);
2325
2326         HRESULT GetMenuInfo(
2327                 [out] IShellMenuCallback **ppsmc,
2328                 [out] UINT *puId,
2329                 [out] UINT *puIdAncestor,
2330                 [out] DWORD *pdwFlags);
2331
2332         HRESULT SetShellFolder(
2333         [in] IShellFolder *psf,
2334                 [in] LPCITEMIDLIST pidlFolder,
2335         [in] HKEY hKey,
2336         [in] DWORD dwFlags);
2337
2338         HRESULT GetShellFolder(
2339                 [out] DWORD *pdwFlags,
2340                 [out] LPITEMIDLIST *ppidl,
2341                 [in] REFIID riid,
2342                 [out] void **ppv);
2343
2344         HRESULT SetMenu(
2345                 [in] HMENU hmenu,
2346                 [in] HWND hwnd,
2347         [in] DWORD dwFlags);
2348
2349         HRESULT GetMenu(
2350                 [out] HMENU *phmenu,
2351                 [out] HWND *phwnd,
2352                 [out] DWORD *pdwFlags);
2353
2354         HRESULT InvalidateItem(
2355                 [in] LPSMDATA psmd,
2356         [in] DWORD dwFlags);
2357
2358         HRESULT GetState(
2359                 [out] LPSMDATA psmd);
2360
2361         HRESULT SetMenuToolbar(
2362                 [in] IUnknown *punk,
2363         [in] DWORD dwFlags);
2364 }
2365
2366
2367 typedef struct _WINDOWDATA
2368 {
2369     DWORD     dwWindowID;
2370     UINT      uiCP;
2371     LPITEMIDLIST  pidl;
2372     [string]  LPWSTR lpszUrl;
2373     [string]  LPWSTR lpszUrlLocation;
2374     [string]  LPWSTR lpszTitle;
2375 } WINDOWDATA;
2376
2377 typedef WINDOWDATA *LPWINDOWDATA;
2378 typedef const WINDOWDATA *LPCWINDOWDATA;
2379
2380
2381 /*****************************************************************************
2382  * ITravelEntry interface
2383  */
2384 [
2385     uuid(F46EDB3B-BC2F-11d0-9412-00AA00A3EBD3),
2386     object,
2387     pointer_default(unique),
2388     local
2389 ]
2390 interface ITravelEntry : IUnknown
2391 {
2392     HRESULT Invoke(
2393                 [in] IUnknown *punk);
2394
2395     HRESULT Update(
2396                 [in] IUnknown *punk,
2397                 BOOL fIsLocalAnchor);
2398
2399     HRESULT GetPidl(
2400                 [in] LPITEMIDLIST *ppidl);
2401 };
2402
2403
2404 /*****************************************************************************
2405  * ITravelLogClient interface
2406  */
2407 [
2408     uuid(241c033e-e659-43da-aa4d-4086dbc4758d),
2409     object,
2410     pointer_default(unique),
2411     local
2412 ]
2413 interface ITravelLogClient : IUnknown
2414 {
2415     HRESULT FindWindowByIndex(
2416         [in] DWORD dwID,
2417         [out] IUnknown **ppunk);
2418
2419     HRESULT GetWindowData(
2420         [out] LPWINDOWDATA pWinData);
2421
2422     HRESULT LoadHistoryPosition(
2423         [in] LPWSTR pszUrlLocation,
2424         [in] DWORD dwPosition);
2425 };
2426
2427
2428 /*****************************************************************************
2429  * ITravelLog interface
2430  */
2431 [
2432     uuid(66A9CB08-4802-11d2-A561-00A0C92DBFE8),
2433     object,
2434     pointer_default(unique),
2435     local
2436 ]
2437 interface ITravelLog : IUnknown
2438 {
2439     enum tagTLENUMF
2440     {
2441         TLEF_RELATIVE_INCLUDE_CURRENT   = 0x00000001,
2442         TLEF_RELATIVE_BACK              = 0x00000010,
2443         TLEF_RELATIVE_FORE              = 0x00000020,
2444         TLEF_INCLUDE_UNINVOKEABLE       = 0x00000040,
2445         TLEF_ABSOLUTE                   = 0x00000031,
2446     };
2447     typedef DWORD TLENUMF;
2448
2449         HRESULT AddEntry(
2450                 [in] IUnknown *punk,
2451                 BOOL fIsLocalAnchor);
2452
2453         HRESULT UpdateEntry(
2454                 [in] IUnknown *punk,
2455                 BOOL fIsLocalAnchor);
2456
2457         HRESULT UpdateExternal(
2458                 [in] IUnknown *punk,
2459                 [in] IUnknown *punkHLBrowseContext);
2460
2461         HRESULT Travel(
2462                 [in] IUnknown *punk,
2463                 int iOffset);
2464
2465         HRESULT GetTravelEntry(
2466                 [in] IUnknown *punk,
2467                 int iOffset,
2468                 [out] ITravelEntry **ppte);
2469
2470         HRESULT FindTravelEntry(
2471                 [in] IUnknown *punk,
2472                 [in] LPCITEMIDLIST pidl,
2473                 [out] ITravelEntry **ppte);
2474
2475         HRESULT GetToolTipText(
2476                 [in] IUnknown *punk,
2477                 int iOffset,
2478                 int idsTemplate,
2479                 [out] LPWSTR pwzText,
2480                 DWORD cchText);
2481
2482         HRESULT InsertMenuEntries(
2483                 [in] IUnknown *punk,
2484                 [in, out] HMENU hmenu,
2485                 int nPos,
2486                 int idFirst,
2487                 int idLast,
2488                 DWORD dwFlags);
2489
2490         HRESULT Clone(
2491                 [out] ITravelLog **pptl);
2492
2493         DWORD CountEntries(
2494                 [in] IUnknown *punk);
2495
2496         HRESULT Revert();
2497 };
2498
2499 /*****************************************************************************
2500  * IShellService interface
2501  */
2502 [
2503     object,
2504     uuid(5836FB00-8187-11CF-A12B-00AA004AE837),
2505     pointer_default(unique),
2506     local
2507 ]
2508 interface IShellService : IUnknown
2509 {
2510         HRESULT SetOwner(
2511                 [in] IUnknown *owner);
2512 };
2513
2514 /*****************************************************************************
2515  * IShellBrowser interface
2516  */
2517 [
2518     object,
2519     uuid(02BA3B52-0547-11D1-B833-00C04FC9B31F),
2520     pointer_default(unique),
2521     local
2522 ]
2523 interface IBrowserService : IUnknown
2524 {
2525     typedef enum tagBNSTATE
2526     {
2527                 BNS_NORMAL      = 0,
2528                 BNS_BEGIN_NAVIGATE      = 1,
2529                 BNS_NAVIGATE    = 2
2530     } BNSTATE;
2531
2532     cpp_quote("#include <pshpack8.h>")
2533     typedef struct basebrowserdataxp
2534     {
2535                 HWND                            _hwnd;
2536                 ITravelLog                      *_ptl;
2537                 IUnknown                        *_phlf;
2538                 IUnknown                        *_pautoWB2;
2539                 IUnknown                        *_pautoEDS;
2540                 IShellService           *_pautoSS;
2541                 int                                     _eSecureLockIcon;
2542                 DWORD                           _fCreatingViewWindow;
2543                 UINT                            _uActivateState;
2544                 LPITEMIDLIST            _pidlViewState;
2545                 IOleCommandTarget       *_pctView;
2546                 LPITEMIDLIST            _pidlCur;
2547                 IShellView                      *_psv;
2548                 IShellFolder            *_psf;
2549                 HWND                            _hwndView;
2550                 LPWSTR                          _pszTitleCur;
2551                 LPITEMIDLIST            _pidlPending;
2552                 IShellView                      *_psvPending;
2553                 IShellFolder            *_psfPending;
2554                 HWND                            _hwndViewPending;
2555                 LPWSTR                          _pszTitlePending;
2556                 BOOL                            _fIsViewMSHTML;
2557                 BOOL                            _fPrivacyImpacted;
2558                 CLSID                           _clsidView;
2559                 CLSID                           _clsidViewPending;
2560                 HWND                            _hwndFrame;
2561     } BASEBROWSERDATAXP;
2562         typedef struct basebrowserdataxp *LPBASEBROWSERDATAXP;
2563
2564         typedef struct basebrowserdatalh
2565         {
2566                 HWND                            _hwnd;
2567                 ITravelLog                      *_ptl;
2568                 IUnknown                        *_phlf;
2569                 IUnknown                        *_pautoWB2;
2570                 IUnknown                        *_pautoEDS;
2571                 IShellService           *_pautoSS;
2572                 int                                     _eSecureLockIcon;
2573                 DWORD                           _fCreatingViewWindow;
2574                 UINT                            _uActivateState;
2575                 LPITEMIDLIST            _pidlViewState;
2576                 IOleCommandTarget       *_pctView;
2577                 LPITEMIDLIST            _pidlCur;
2578                 IShellView                      *_psv;
2579                 IShellFolder            *_psf;
2580                 HWND                            _hwndView;
2581                 LPWSTR                          _pszTitleCur;
2582                 LPITEMIDLIST            _pidlPending;
2583                 IShellView                      *_psvPending;
2584                 IShellFolder            *_psfPending;
2585                 HWND                            _hwndViewPending;
2586                 LPWSTR                          _pszTitlePending;
2587                 BOOL                            _fIsViewMSHTML;
2588                 BOOL                            _fPrivacyImpacted;
2589                 CLSID                           _clsidView;
2590                 CLSID                           _clsidViewPending;
2591                 HWND                            _hwndFrame;
2592                 LONG                            _lPhishingFilterStatus;
2593         } BASEBROWSERDATALH;
2594     cpp_quote("#include <poppack.h>")
2595         typedef struct basebrowserdatalh *LPBASEBROWSERDATALH;
2596
2597         typedef BASEBROWSERDATAXP BASEBROWSERDATA;
2598
2599         typedef const BASEBROWSERDATA *LPCBASEBROWSERDATA;
2600
2601         typedef BASEBROWSERDATA *LPBASEBROWSERDATA;
2602
2603 cpp_quote("#if 0")
2604 typedef HANDLE HMONITOR;
2605 cpp_quote("#endif /* 0 */")
2606
2607         typedef struct SToolbarItem
2608         {
2609                 IDockingWindow          *ptbar;
2610                 BORDERWIDTHS            rcBorderTool;
2611                 LPWSTR                          pwszItem;
2612                 BOOL                            fShow;
2613                 HMONITOR                        hMon;
2614         } TOOLBARITEM;
2615
2616         typedef struct SToolbarItem *LPTOOLBARITEM;
2617
2618         HRESULT GetParentSite(
2619                 [out] IOleInPlaceSite **ppipsite);
2620
2621         HRESULT SetTitle(
2622                 [in] IShellView *psv,
2623                 [in] LPCWSTR pszName);
2624
2625         HRESULT GetTitle(
2626                 [in] IShellView *psv,
2627                 [out] LPWSTR pszName,
2628                 DWORD cchName);
2629
2630         HRESULT GetOleObject(
2631                 [out] IOleObject **ppobjv);
2632
2633         HRESULT GetTravelLog(
2634                 [out] ITravelLog **pptl);
2635
2636         HRESULT ShowControlWindow(
2637                 UINT id,
2638                 BOOL fShow);
2639
2640         HRESULT IsControlWindowShown(
2641                 UINT id,
2642                 [out] BOOL *pfShown);
2643
2644         HRESULT IEGetDisplayName(
2645                 [in] LPCITEMIDLIST pidl,
2646                 [out] LPWSTR pwszName,
2647                 UINT uFlags);
2648
2649         HRESULT IEParseDisplayName(
2650                 UINT uiCP,
2651                 [in] LPCWSTR pwszPath,
2652                 [out] LPCITEMIDLIST *ppidlOut);
2653
2654         HRESULT DisplayParseError(
2655                 HRESULT hres,
2656                 [in] LPCWSTR pwszPath);
2657
2658         HRESULT NavigateToPidl(
2659                 [in] LPCITEMIDLIST pidl,
2660                 DWORD grfHLNF);
2661
2662         HRESULT SetNavigateState(
2663                 BNSTATE bnstate);
2664
2665         HRESULT GetNavigateState(
2666                 [out] BNSTATE *pbnstate);
2667
2668         HRESULT NotifyRedirect(
2669                 [in] IShellView *psv,
2670                 [in] LPCITEMIDLIST pidl,
2671                 [out] BOOL *pfDidBrowse);
2672
2673         HRESULT UpdateWindowList();
2674
2675         HRESULT UpdateBackForwardState();
2676
2677         HRESULT SetFlags(
2678                 DWORD dwFlags,
2679                 DWORD dwFlagMask);
2680
2681         HRESULT GetFlags(
2682                 [out] DWORD *pdwFlags);
2683
2684         HRESULT CanNavigateNow();
2685
2686         HRESULT GetPidl(
2687                 [out] LPCITEMIDLIST *ppidl);
2688
2689         HRESULT SetReferrer(
2690                 [in] LPCITEMIDLIST pidl);
2691
2692         DWORD GetBrowserIndex();
2693
2694         HRESULT GetBrowserByIndex(
2695                 DWORD dwID,
2696                 [out] IUnknown **ppunk);
2697
2698         HRESULT GetHistoryObject(
2699                 [out] IOleObject **ppole,
2700                 [out] IStream **pstm,
2701                 [out] IBindCtx **ppbc);
2702
2703         HRESULT SetHistoryObject(
2704                 [in] IOleObject *pole,
2705                 BOOL fIsLocalAnchor);
2706
2707         HRESULT CacheOLEServer(
2708                 [in] IOleObject *pole);
2709
2710         HRESULT GetSetCodePage(
2711                 [in] VARIANT *pvarIn,
2712                 [out] VARIANT *pvarOut);
2713
2714         HRESULT OnHttpEquiv(
2715                 [in] IShellView *psv,
2716                 BOOL fDone,
2717                 [in] VARIANT *pvarargIn,
2718                 [out] VARIANT *pvarargOut);
2719
2720         HRESULT GetPalette(
2721                 [out] HPALETTE *hpal);
2722
2723         HRESULT RegisterWindow(
2724                 BOOL fForceRegister,
2725                 int swc);
2726 }
2727
2728
2729 /*****************************************************************************
2730  * IShellBrowser2 interface
2731  */
2732 [
2733     uuid(68BD21CC-438B-11D2-A560-00A0C92DBFE8),
2734     object,
2735     pointer_default(unique),
2736     local
2737 ]
2738 interface IBrowserService2 : IBrowserService
2739 {
2740         typedef struct tagFolderSetData
2741         {
2742                 FOLDERSETTINGS          _fs;
2743                 SHELLVIEWID                     _vidRestore;
2744                 DWORD                           _dwViewPriority;
2745         } FOLDERSETDATA;
2746
2747         typedef struct tagFolderSetData *LPFOLDERSETDATA;
2748
2749         LRESULT WndProcBS(
2750                 [in] HWND hwnd,
2751                 UINT uMsg,
2752                 WPARAM wParam,
2753                 LPARAM lParam);
2754
2755         HRESULT SetAsDefFolderSettings();
2756
2757         HRESULT GetViewRect(
2758                 [out] RECT *prc);
2759
2760         HRESULT OnSize(
2761                 WPARAM wParam);
2762
2763         HRESULT OnCreate(
2764                 [in] struct tagCREATESTRUCTW *pcs);
2765
2766         LRESULT OnCommand(
2767                 WPARAM wParam,
2768                 LPARAM lParam);
2769
2770         HRESULT OnDestroy();
2771
2772         LRESULT OnNotify(
2773                 [in] struct tagNMHDR *pnm);
2774
2775         HRESULT OnSetFocus();
2776
2777         HRESULT OnFrameWindowActivateBS(
2778                 BOOL fActive);
2779
2780         HRESULT ReleaseShellView();
2781
2782         HRESULT ActivatePendingView();
2783
2784         HRESULT CreateViewWindow(
2785                 [in] IShellView *psvNew,
2786                 [in] IShellView *psvOld,
2787                 [in] LPRECT prcView,
2788                 [out] HWND *phwnd);
2789
2790         HRESULT CreateBrowserPropSheetExt(
2791                 [in] REFIID riid,
2792                 [out] void **ppv);
2793
2794         HRESULT GetViewWindow(
2795                 [out] HWND *phwndView);
2796
2797         HRESULT GetBaseBrowserData(
2798                 [out] LPCBASEBROWSERDATA *pbbd);
2799
2800         LPBASEBROWSERDATA PutBaseBrowserData();
2801
2802         HRESULT InitializeTravelLog(
2803                 [in] ITravelLog *ptl,
2804                 DWORD dw);
2805
2806         HRESULT SetTopBrowser();
2807
2808         HRESULT Offline(
2809                 int iCmd);
2810
2811         HRESULT AllowViewResize(
2812                 BOOL f);
2813
2814         HRESULT SetActivateState(
2815                 UINT u);
2816
2817         HRESULT UpdateSecureLockIcon(
2818                 int eSecureLock);
2819
2820         HRESULT InitializeDownloadManager();
2821
2822         HRESULT InitializeTransitionSite();
2823
2824         HRESULT _Initialize(
2825                 [in] HWND hwnd,
2826                 [in] IUnknown *pauto);
2827
2828         HRESULT _CancelPendingNavigationAsync();
2829
2830         HRESULT _CancelPendingView();
2831
2832         HRESULT _MaySaveChanges();
2833
2834         HRESULT _PauseOrResumeView(
2835                 BOOL fPaused);
2836
2837         HRESULT _DisableModeless();
2838
2839         HRESULT _NavigateToPidl(
2840                 [in] LPCITEMIDLIST pidl,
2841                 DWORD grfHLNF,
2842                 DWORD dwFlags);
2843
2844         HRESULT _TryShell2Rename(
2845                 [in] IShellView *psv,
2846                 [in] LPCITEMIDLIST pidlNew);
2847
2848         HRESULT _SwitchActivationNow();
2849
2850         HRESULT _ExecChildren(
2851                 [in] IUnknown *punkBar,
2852                 BOOL fBroadcast,
2853                 [in] const GUID *pguidCmdGroup,
2854                 DWORD nCmdID,
2855                 DWORD nCmdexecopt,
2856                 [in] VARIANTARG *pvarargIn,
2857                 [in, out] VARIANTARG *pvarargOut);
2858
2859         HRESULT _SendChildren(
2860                 [in] HWND hwndBar,
2861                 BOOL fBroadcast,
2862                 UINT uMsg,
2863                 WPARAM wParam,
2864                 LPARAM lParam);
2865
2866         HRESULT GetFolderSetData(
2867                 [out] struct tagFolderSetData *pfsd);
2868
2869         HRESULT _OnFocusChange(
2870                 UINT itb);
2871
2872         HRESULT v_ShowHideChildWindows(
2873                 BOOL fChildOnly);
2874
2875         UINT _get_itbLastFocus();
2876
2877         HRESULT _put_itbLastFocus(
2878                 UINT itbLastFocus);
2879
2880         HRESULT _UIActivateView(
2881                 UINT uState);
2882
2883         HRESULT _GetViewBorderRect(
2884                 [out] RECT *prc);
2885
2886         HRESULT _UpdateViewRectSize();
2887
2888         HRESULT _ResizeNextBorder(
2889                 UINT itb);
2890
2891         HRESULT _ResizeView();
2892
2893         HRESULT _GetEffectiveClientArea(
2894                 [out] LPRECT lprectBorder,
2895                 [in] HMONITOR hmon);
2896
2897         IStream *v_GetViewStream(
2898                 [in] LPCITEMIDLIST pidl,
2899                 DWORD grfMode,
2900                 [in] LPCWSTR pwszName);
2901
2902         LRESULT ForwardViewMsg(
2903                 UINT uMsg,
2904                 WPARAM wParam,
2905                 LPARAM lParam);
2906
2907         HRESULT SetAcceleratorMenu(
2908                 [in] HACCEL hacc);
2909
2910         int _GetToolbarCount();
2911
2912         LPTOOLBARITEM _GetToolbarItem(
2913                 int itb);
2914
2915         HRESULT _SaveToolbars(
2916                 [in] IStream *pstm);
2917
2918         HRESULT _LoadToolbars(
2919                 [in] IStream *pstm);
2920
2921         HRESULT _CloseAndReleaseToolbars(
2922                 BOOL fClose);
2923
2924         HRESULT v_MayGetNextToolbarFocus(
2925                 [in] LPMSG lpMsg,
2926                 UINT itbNext,
2927                 int citb,
2928                 [out] LPTOOLBARITEM *pptbi,
2929                 [out] HWND *phwnd);
2930
2931         HRESULT _ResizeNextBorderHelper(
2932                 UINT itb,
2933                 BOOL bUseHmonitor);
2934
2935         UINT _FindTBar(
2936                 [in] IUnknown *punkSrc);
2937
2938         HRESULT _SetFocus(
2939                 [in] LPTOOLBARITEM ptbi,
2940                 [in] HWND hwnd,
2941                 [in] LPMSG lpMsg);
2942
2943         HRESULT v_MayTranslateAccelerator(
2944                 [in] MSG *pmsg);
2945
2946         HRESULT _GetBorderDWHelper(
2947                 [in] IUnknown *punkSrc,
2948                 [out] LPRECT lprectBorder,
2949                 BOOL bUseHmonitor);
2950
2951         HRESULT v_CheckZoneCrossing(
2952                 [in] LPCITEMIDLIST pidl);
2953 }
2954
2955
2956 /*****************************************************************************
2957  * IShellBrowser3 interface
2958  */
2959 [
2960     uuid(27D7CE21-762D-48F3-86F3-40E2FD3749C4),
2961     object,
2962     pointer_default(unique),
2963     local
2964 ]
2965 interface IBrowserService3 : IBrowserService2
2966 {
2967         HRESULT _PositionViewWindow(
2968                 [in] HWND hwnd,
2969                 [in] LPRECT prc);
2970
2971         HRESULT IEParseDisplayNameEx(
2972                 UINT uiCP,
2973                 [in] LPCWSTR pwszPath,
2974                 DWORD dwFlags,
2975                 [out] LPITEMIDLIST *ppidlOut);
2976 }
2977
2978
2979 /*****************************************************************************
2980  * IShellBrowser4 interface
2981  */
2982 [
2983     uuid(639f1bff-e135-4096-abd8-e0f504d649a4),
2984     object,
2985     pointer_default(unique),
2986     local
2987 ]
2988 interface IBrowserService4 : IBrowserService3
2989 {
2990         HRESULT ActivateView(
2991                 BOOL fPendingView);
2992
2993         HRESULT SaveViewState();
2994
2995         HRESULT _ResizeAllBorders();
2996 }
2997
2998 cpp_quote("#if (_WIN32_IE >= _WIN32_IE_IE60)")
2999
3000 /*****************************************************************************
3001  * ITrackShellMenu interface
3002  */
3003 [
3004     uuid(8278F932-2A3E-11d2-838F-00C04FD918D0),
3005     object,
3006     pointer_default(unique),
3007     local
3008 ]
3009 interface ITrackShellMenu : IShellMenu
3010 {
3011         HRESULT SetObscured(
3012                 [in] HWND hwndTB,
3013                 [in] IUnknown *punkBand,
3014                 DWORD dwSMSetFlags);
3015
3016         HRESULT Popup(
3017                 [in] HWND hwnd,
3018                 [in] POINTL *ppt,
3019                 [in] RECTL *prcExclude,
3020                 MP_POPUPFLAGS dwFlags);
3021 };
3022
3023 cpp_quote("#endif /* _WIN32_IE_IE60 */")
3024
3025 cpp_quote("#ifdef MIDL_PASS")
3026 typedef IUnknown* HIMAGELIST;
3027 cpp_quote("#endif")
3028
3029 typedef [v1_enum] enum THUMBBUTTONFLAGS {
3030     THBF_ENABLED         = 0x0000,
3031     THBF_DISABLED        = 0x0001,
3032     THBF_DISMISSONCLICK  = 0x0002,
3033     THBF_NOBACKGROUND    = 0x0004,
3034     THBF_HIDDEN          = 0x0008,
3035     THBF_NONINTERACTIVE  = 0x0010
3036 } THUMBBUTTONFLAGS;
3037
3038 cpp_quote("DEFINE_ENUM_FLAG_OPERATORS(THUMBBUTTONFLAGS)")
3039
3040 typedef [v1_enum] enum THUMBBUTTONMASK {
3041     THB_BITMAP   = 0x0001,
3042     THB_ICON     = 0x0002,
3043     THB_TOOLTIP  = 0x0004,
3044     THB_FLAGS    = 0x0008
3045 } THUMBBUTTONMASK;
3046
3047 cpp_quote("DEFINE_ENUM_FLAG_OPERATORS(THUMBBUTTONMASK)")
3048
3049 cpp_quote("#include <pshpack8.h>")
3050 typedef struct THUMBBUTTON {
3051     THUMBBUTTONMASK dwMask;
3052     UINT iId;
3053     UINT iBitmap;
3054     HICON hIcon;
3055     WCHAR szTip[260];
3056     THUMBBUTTONFLAGS dwFlags;
3057 } THUMBBUTTON, *LPTHUMBBUTTON;
3058 cpp_quote("#include <poppack.h>")
3059
3060 /*****************************************************************************
3061  *    ITaskbarList2 interface
3062  */
3063 [
3064     object,
3065     uuid(602D4995-B13A-429B-A66E-1935E44F4317),
3066     pointer_default(unique)
3067 ]
3068 interface ITaskbarList2 : ITaskbarList
3069 {
3070     HRESULT MarkFullscreenWindow(
3071         [in] HWND hwnd,
3072         [in] BOOL fullscreen);
3073 }
3074
3075 [
3076     uuid(ea1afb91-9e28-4b86-90e9-9e9f8a5eefaf),
3077     object
3078 ]
3079 interface ITaskbarList3 : ITaskbarList2
3080 {
3081     typedef [v1_enum] enum TBPFLAG {
3082         TBPF_NOPROGRESS     = 0x0000,
3083         TBPF_INDETERMINATE  = 0x0001,
3084         TBPF_NORMAL         = 0x0002,
3085         TBPF_ERROR          = 0x0004,
3086         TBPF_PAUSED         = 0x0008
3087     } TBPFLAG;
3088
3089     cpp_quote("DEFINE_ENUM_FLAG_OPERATORS(TBPFLAG)")
3090
3091     HRESULT SetProgressValue(
3092             [in] HWND hwnd,
3093             [in] ULONGLONG ullCompleted,
3094             [in] ULONGLONG ullTotal);
3095
3096     HRESULT SetProgressState(
3097             [in] HWND hwnd,
3098             [in] TBPFLAG tbpFlags);
3099
3100     HRESULT RegisterTab(
3101             [in] HWND hwndTab,
3102             [in] HWND hwndMDI);
3103
3104     HRESULT UnregisterTab([in] HWND hwndTab);
3105
3106     HRESULT SetTabOrder(
3107             [in] HWND hwndTab,
3108             [in] HWND hwndInsertBefore);
3109
3110     HRESULT SetTabActive(
3111             [in] HWND hwndTab,
3112             [in] HWND hwndMDI,
3113             [in] DWORD dwReserved);
3114
3115     HRESULT ThumbBarAddButtons(
3116             [in] HWND hwnd,
3117             [in] UINT cButtons,
3118             [in, size_is(cButtons)] LPTHUMBBUTTON pButton);
3119
3120     HRESULT ThumbBarUpdateButtons(
3121             [in] HWND hwnd,
3122             [in] UINT cButtons,
3123             [in, size_is(cButtons)] LPTHUMBBUTTON pButton);
3124
3125     HRESULT ThumbBarSetImageList(
3126             [in] HWND hwnd,
3127             [in] HIMAGELIST himl);
3128
3129     HRESULT SetOverlayIcon(
3130             [in] HWND hwnd,
3131             [in] HICON hIcon,
3132             [in, unique, string] LPCWSTR pszDescription);
3133
3134     HRESULT SetThumbnailTooltip(
3135             [in] HWND hwnd,
3136             [in, unique, string] LPCWSTR pszTip);
3137
3138     HRESULT SetThumbnailClip(
3139             [in] HWND hwnd,
3140             [in] RECT *prcClip);
3141 }
3142
3143 [
3144     uuid(c43dc798-95d1-4bea-9030-bb99e2983a1a),
3145     object
3146 ]
3147 interface ITaskbarList4 : ITaskbarList3
3148 {
3149     typedef [v1_enum] enum STPFLAG {
3150         STPF_NONE                       = 0x0000,
3151         STPF_USEAPPTHUMBNAILALWAYS      = 0x0001,
3152         STPF_USEAPPTHUMBNAILWHENACTIVE  = 0x0002,
3153         STPF_USEAPPPEEKALWAYS           = 0x0004,
3154         STPF_USEAPPPEEKWHENACTIVE       = 0x0008
3155     } STPFLAG;
3156
3157     cpp_quote("DEFINE_ENUM_FLAG_OPERATORS(STPFLAG)")
3158
3159     HRESULT SetTabProperties(
3160             [in] HWND hwndTab,
3161             [in] STPFLAG stpFlags);
3162 }
3163
3164 /*****************************************************************************
3165  *    IAutoCompleteDropDown interface
3166  */
3167 [
3168     object,
3169     uuid(3CD141F4-3C6A-11d2-BCAA-00C04FD929DB),
3170     pointer_default(unique)
3171 ]
3172 interface IAutoCompleteDropDown : IUnknown
3173 {
3174 cpp_quote("#define ACDD_VISIBLE   0x0001")
3175
3176     HRESULT GetDropDownStatus(
3177         [out] DWORD *pdwFlags,
3178         [out, string] LPWSTR *ppwszString);
3179
3180     HRESULT ResetEnumerator();
3181 }
3182
3183 /*****************************************************************************
3184  * IExplorerBrowserEvents interface
3185  */
3186 [
3187  object,
3188  uuid(361BBDC7-E6EE-4E13-BE58-58E2240C810F)
3189 ]
3190 interface IExplorerBrowserEvents : IUnknown
3191 {
3192     HRESULT OnNavigationPending(
3193         [in] PCIDLIST_ABSOLUTE pidlFolder);
3194
3195     HRESULT OnViewCreated(
3196         [in] IShellView *psv);
3197
3198     HRESULT OnNavigationComplete(
3199         [in] PCIDLIST_ABSOLUTE pidlFolder);
3200
3201     HRESULT OnNavigationFailed(
3202         [in] PCIDLIST_ABSOLUTE pidlFolder);
3203 }
3204
3205 typedef GUID EXPLORERPANE;
3206 typedef EXPLORERPANE *REFEXPLORERPANE;
3207
3208 cpp_quote("#define SID_ExplorerPaneVisibility IID_IExplorerPaneVisibility")
3209
3210 /*****************************************************************************
3211  * IExplorerPaneVisibility interface
3212  */
3213 [
3214  object,
3215  uuid(E07010EC-BC17-44C0-97B0-46C7C95B9EDC)
3216 ]
3217 interface IExplorerPaneVisibility : IUnknown
3218 {
3219     typedef enum tagEXPLORERPANESTATE {
3220         EPS_DONTCARE     = 0x0,
3221         EPS_DEFAULT_ON   = 0x1,
3222         EPS_DEFAULT_OFF  = 0x2,
3223         EPS_STATE_MASK   = 0xffff,
3224         EPS_INITIALSTATE = 0x10000,
3225         EPS_FORCE        = 0x20000
3226     } EXPLORERPANESTATE;
3227
3228     HRESULT GetPaneState(
3229         [in] REFEXPLORERPANE ep,
3230         [out] EXPLORERPANESTATE *peps);
3231 }
3232
3233 typedef [v1_enum] enum tagEXPLORER_BROWSER_FILL_FLAGS {
3234     EBF_NONE                     = 0,
3235     EBF_SELECTFROMDATAOBJECT     = 0x100,
3236     EBF_NODROPTARGET             = 0x200
3237 } EXPLORER_BROWSER_FILL_FLAGS;
3238
3239 typedef [v1_enum] enum tagEXPLORER_BROWSER_OPTIONS {
3240     EBO_NONE               = 0x00,
3241     EBO_NAVIGATEONCE       = 0x01,
3242     EBO_SHOWFRAMES         = 0x02,
3243     EBO_ALWAYSNAVIGATE     = 0x04,
3244     EBO_NOTRAVELLOG        = 0x08,
3245     EBO_NOWRAPPERWINDOW    = 0x10,
3246     EBO_HTMLSHAREPOINTVIEW = 0x20
3247 } EXPLORER_BROWSER_OPTIONS;
3248
3249 cpp_quote("#define SID_SExplorerBrowserFrame IID_ICommDlgBrowser")
3250
3251 /*****************************************************************************
3252  * IExplorerBrowser interface
3253  */
3254 [
3255  object,
3256  uuid(DFD3B6B5-C10C-4BE9-85F6-A66969F402F6),
3257  pointer_default(unique)
3258 ]
3259 interface IExplorerBrowser : IUnknown
3260 {
3261
3262     [local] HRESULT Initialize(
3263         [in] HWND hwndParent,
3264         [in] const RECT *prc,
3265         [in, unique] const FOLDERSETTINGS *pfs);
3266
3267     HRESULT Destroy();
3268
3269     [local] HRESULT SetRect(
3270         [in,out,unique] HDWP *phdwp,
3271         [in] RECT rcBrowser);
3272
3273     HRESULT SetPropertyBag(
3274         [in, string] LPCWSTR pszPropertyBag);
3275
3276     HRESULT SetEmptyText(
3277         [in, string] LPCWSTR pszEmptyText);
3278
3279     HRESULT SetFolderSettings(
3280         [in] const FOLDERSETTINGS *pfs);
3281
3282     HRESULT Advise(
3283         [in] IExplorerBrowserEvents *psbe,
3284         [out] DWORD *pdwCookie);
3285
3286     HRESULT Unadvise(
3287         [in] DWORD dwCookie);
3288
3289     HRESULT SetOptions(
3290         [in] EXPLORER_BROWSER_OPTIONS dwFlag);
3291
3292     HRESULT GetOptions(
3293         [out] EXPLORER_BROWSER_OPTIONS *pdwFlag);
3294
3295     HRESULT BrowseToIDList(
3296         [in] PCUIDLIST_RELATIVE pidl,
3297         [in] UINT uFlags);
3298
3299     HRESULT BrowseToObject(
3300         [in] IUnknown *punk,
3301         [in] UINT uFlags);
3302
3303     HRESULT FillFromObject(
3304         [in] IUnknown *punk,
3305         [in] EXPLORER_BROWSER_FILL_FLAGS dwFlags);
3306
3307     HRESULT RemoveAll();
3308
3309     HRESULT GetCurrentView(
3310         [in] REFIID riid,
3311         [out, iid_is(riid)] void **ppv);
3312 }
3313
3314 /*****************************************************************************
3315  * INameSpaceTreeControl interface
3316  */
3317 [
3318  object,
3319  uuid(028212A3-B627-47E9-8856-C14265554E4F)
3320 ]
3321 interface INameSpaceTreeControl : IUnknown
3322 {
3323     [v1_enum] enum _NSTCSTYLE {
3324         NSTCS_HASEXPANDOS                 = 0x00000001,
3325         NSTCS_HASLINES                    = 0x00000002,
3326         NSTCS_SINGLECLICKEXPAND           = 0x00000004,
3327         NSTCS_FULLROWSELECT               = 0x00000008,
3328         NSTCS_SPRINGEXPAND                = 0x00000010,
3329         NSTCS_HORIZONTALSCROLL            = 0x00000020,
3330         NSTCS_ROOTHASEXPANDO              = 0x00000040,
3331         NSTCS_SHOWSELECTIONALWAYS         = 0x00000080,
3332         NSTCS_NOINFOTIP                   = 0x00000200,
3333         NSTCS_EVENHEIGHT                  = 0x00000400,
3334         NSTCS_NOREPLACEOPEN               = 0x00000800,
3335         NSTCS_DISABLEDRAGDROP             = 0x00001000,
3336         NSTCS_NOORDERSTREAM               = 0x00002000,
3337         NSTCS_RICHTOOLTIP                 = 0x00004000,
3338         NSTCS_BORDER                      = 0x00008000,
3339         NSTCS_NOEDITLABELS                = 0x00010000,
3340         NSTCS_TABSTOP                     = 0x00020000,
3341         NSTCS_FAVORITESMODE               = 0x00080000,
3342         NSTCS_AUTOHSCROLL                 = 0x00100000,
3343         NSTCS_FADEINOUTEXPANDOS           = 0x00200000,
3344         NSTCS_EMPTYTEXT                   = 0x00400000,
3345         NSTCS_CHECKBOXES                  = 0x00800000,
3346         NSTCS_PARTIALCHECKBOXES           = 0x01000000,
3347         NSTCS_EXCLUSIONCHECKBOXES         = 0x02000000,
3348         NSTCS_DIMMEDCHECKBOXES            = 0x04000000,
3349         NSTCS_NOINDENTCHECKS              = 0x08000000,
3350         NSTCS_ALLOWJUNCTIONS              = 0x10000000,
3351         NSTCS_SHOWTABSBUTTON              = 0x20000000,
3352         NSTCS_SHOWDELETEBUTTON            = 0x40000000,
3353         NSTCS_SHOWREFRESHBUTTON      = (int)0x80000000
3354     };
3355     typedef DWORD NSTCSTYLE;
3356
3357     [v1_enum] enum _NSTCROOTSTYLE {
3358         NSTCRS_VISIBLE                    = 0x0000,
3359         NSTCRS_HIDDEN                     = 0x0001,
3360         NSTCRS_EXPANDED                   = 0x0002
3361     };
3362     typedef DWORD NSTCROOTSTYLE;
3363
3364     [v1_enum] enum _NSTCITEMSTATE {
3365         NSTCIS_NONE                       = 0x0000,
3366         NSTCIS_SELECTED                   = 0x0001,
3367         NSTCIS_EXPANDED                   = 0x0002,
3368         NSTCIS_BOLD                       = 0x0004,
3369         NSTCIS_DISABLED                   = 0x0008,
3370         NSTCIS_SELECTEDNOEXPAND           = 0x0010
3371     };
3372     typedef DWORD NSTCITEMSTATE;
3373
3374     typedef [v1_enum] enum NSTCGNI {
3375         NSTCGNI_NEXT                      = 0,
3376         NSTCGNI_NEXTVISIBLE               = 1,
3377         NSTCGNI_PREV                      = 2,
3378         NSTCGNI_PREVVISIBLE               = 3,
3379         NSTCGNI_PARENT                    = 4,
3380         NSTCGNI_CHILD                     = 5,
3381         NSTCGNI_FIRSTVISIBLE              = 6,
3382         NSTCGNI_LASTVISIBLE               = 7
3383     } NSTCGNI;
3384
3385     HRESULT Initialize(
3386         [in] HWND hwndParent,
3387         [in, unique] RECT *prc,
3388         [in] NSTCSTYLE nstcsFlags);
3389
3390     HRESULT TreeAdvise(
3391         [in] IUnknown *punk,
3392         [out] DWORD *pdwCookie);
3393
3394     HRESULT TreeUnadvise(
3395         [in] DWORD dwCookie);
3396
3397     HRESULT AppendRoot(
3398         [in] IShellItem *psiRoot,
3399         [in] SHCONTF grfEnumFlags,
3400         [in] NSTCROOTSTYLE grfRootStyle,
3401         [in, unique] IShellItemFilter *pif);
3402
3403     HRESULT InsertRoot(
3404         [in] int iIndex,
3405         [in] IShellItem *psiRoot,
3406         [in] SHCONTF grfEnumFlags,
3407         [in] NSTCROOTSTYLE grfRootStyle,
3408         [in, unique] IShellItemFilter *pif);
3409
3410     HRESULT RemoveRoot(
3411         [in] IShellItem *psiRoot);
3412
3413     HRESULT RemoveAllRoots();
3414
3415     HRESULT GetRootItems(
3416         [out] IShellItemArray **ppsiaRootItems);
3417
3418     HRESULT SetItemState(
3419         [in] IShellItem *psi,
3420         [in] NSTCITEMSTATE nstcisMask,
3421         [in] NSTCITEMSTATE nstcisFlags);
3422
3423     HRESULT GetItemState(
3424         [in] IShellItem *psi,
3425         [in] NSTCITEMSTATE nstcismask,
3426         [out] NSTCITEMSTATE *pnstcisFlags);
3427
3428     HRESULT GetSelectedItems(
3429         [out] IShellItemArray **psiaItems);
3430
3431     HRESULT GetItemCustomState(
3432         [in] IShellItem *psi,
3433         [out] int *piStateNumber);
3434
3435     HRESULT SetItemCustomState(
3436         [in] IShellItem *psi,
3437         [in] int iStateNumber);
3438
3439     HRESULT EnsureItemVisible(
3440         [in] IShellItem *psi);
3441
3442     HRESULT SetTheme(
3443         [in, string] LPCWSTR pszTheme);
3444
3445     HRESULT GetNextItem(
3446         [in, unique] IShellItem *psi,
3447         [in] NSTCGNI nstcgi,
3448         [out] IShellItem **ppsiNext);
3449
3450     HRESULT HitTest(
3451         [in] POINT *ppt,
3452         [out] IShellItem **ppsiOut);
3453
3454     HRESULT GetItemRect(
3455         [in] IShellItem *psi,
3456         [out] RECT *prect);
3457
3458     HRESULT CollapseAll();
3459 }
3460
3461 /*****************************************************************************
3462  * INameSpaceTreeControl2 interface
3463  */
3464 [
3465  object,
3466  uuid(7CC7AED8-290E-49BC-8945-C1401CC9306C)
3467 ]
3468 interface INameSpaceTreeControl2 : INameSpaceTreeControl
3469 {
3470     typedef [v1_enum] enum NSTCSTYLE2 {
3471         NSTCS2_DEFAULT                     = 0x00,
3472         NSTCS2_INTERRUPTNOTIFICATIONS      = 0x01,
3473         NSTCS2_SHOWNULLSPACEMENU           = 0x02,
3474         NSTCS2_DISPLAYPADDING              = 0x04,
3475         NSTCS2_DISPLAYPINNEDONLY           = 0x08,
3476         NTSCS2_NOSINGLETONAUTOEXPAND       = 0x10,  /* The apparent typo here is   */
3477         NTSCS2_NEVERINSERTNONENUMERATED    = 0x20   /* present also in the Win SDK */
3478     } NSTCSTYLE2;
3479     cpp_quote("DEFINE_ENUM_FLAG_OPERATORS(NSTCSTYLE2)")
3480
3481     HRESULT SetControlStyle(
3482         [in] NSTCSTYLE nstcsMask,
3483         [in] NSTCSTYLE nstcsStyle);
3484
3485     HRESULT GetControlStyle(
3486         [in] NSTCSTYLE nstcsMask,
3487         [out] NSTCSTYLE *pnstcsStyle);
3488
3489     HRESULT SetControlStyle2(
3490         [in] NSTCSTYLE2 nstcsMask,
3491         [in] NSTCSTYLE2 nstcsStyle);
3492
3493     HRESULT GetControlStyle2(
3494         [in] NSTCSTYLE2 nstcsMask,
3495         [out] NSTCSTYLE2 *pnstcsStyle);
3496 }
3497
3498 /*****************************************************************************
3499  * INameSpaceTreeControlEvents interface
3500  */
3501
3502 [
3503  object,
3504  uuid(93D77985-B3D8-4484-8318-672CDDA002CE),
3505  local
3506 ]
3507 interface INameSpaceTreeControlEvents : IUnknown
3508 {
3509     [v1_enum] enum _NSTCEHITTEST {
3510         NSTCEHT_NOWHERE                    = 0x0001,
3511         NSTCEHT_ONITEMICON                 = 0x0002,
3512         NSTCEHT_ONITEMLABEL                = 0x0004,
3513         NSTCEHT_ONITEMIDENT                = 0x0008,
3514         NSTCEHT_ONITEMBUTTON               = 0x0010,
3515         NSTCEHT_ONITEMRIGHT                = 0x0020,
3516         NSTCEHT_ONITEMSTATEICON            = 0x0040,
3517         NSTCEHT_ONITEM                     = 0x0046,
3518         NSTCEHT_ONITEMTABBUTTON            = 0x1000
3519     };
3520     typedef DWORD NSTCEHITTEST;
3521
3522     [v1_enum] enum _NSTCECLICKTYPE {
3523         NSTCECT_LBUTTON                    = 0x1,
3524         NSTCECT_MBUTTON                    = 0x2,
3525         NSTCECT_RBUTTON                    = 0x3,
3526         NSTCECT_BUTTON                     = 0x3,
3527         NSTCECT_DBLCLICK                   = 0x4
3528     };
3529     typedef DWORD NSTCECLICKTYPE;
3530
3531     HRESULT OnItemClick(
3532         [in] IShellItem *psi,
3533         [in] NSTCEHITTEST nstceHitTest,
3534         [in] NSTCECLICKTYPE nstceClickType);
3535
3536     HRESULT OnPropertyItemCommit(
3537         [in] IShellItem *psi);
3538
3539     HRESULT OnItemStateChanging(
3540         [in] IShellItem *psi,
3541         [in] NSTCITEMSTATE nstcisMask,
3542         [in] NSTCITEMSTATE nstcisState);
3543
3544     HRESULT OnItemStateChanged(
3545         [in] IShellItem *psi,
3546         [in] NSTCITEMSTATE nstcisMask,
3547         [in] NSTCITEMSTATE nstcisState);
3548
3549     HRESULT OnSelectionChanged(
3550         [in] IShellItemArray *psiaSelection);
3551
3552     HRESULT OnKeyboardInput(
3553         [in] UINT uMsg,
3554         [in] WPARAM wParam,
3555         [in] LPARAM lParam);
3556
3557     HRESULT OnBeforeExpand(
3558         [in] IShellItem *psi);
3559
3560     HRESULT OnAfterExpand(
3561         [in] IShellItem *psi);
3562
3563     HRESULT OnBeginLabelEdit(
3564         [in] IShellItem *psi);
3565
3566     HRESULT OnEndLabelEdit(
3567         [in] IShellItem *psi);
3568
3569     HRESULT OnGetToolTip(
3570         [in] IShellItem *psi,
3571         [out, string, size_is(cchTip)] LPWSTR pszTip,
3572         [in] int cchTip);
3573
3574     HRESULT OnBeforeItemDelete(
3575         [in] IShellItem *psi);
3576
3577     HRESULT OnItemAdded(
3578         [in] IShellItem *psi,
3579         [in] BOOL fIsRoot);
3580
3581     HRESULT OnItemDeleted(
3582         [in] IShellItem *psi,
3583         [in] BOOL fIsRoot);
3584
3585     HRESULT OnBeforeContextMenu(
3586         [in, unique] IShellItem *psi,
3587         [in] REFIID riid,
3588         [out, iid_is(riid)] void **ppv);
3589
3590     HRESULT OnAfterContextMenu(
3591         [in] IShellItem *psi,
3592         [in] IContextMenu *pcmIn,
3593         [in] REFIID riid,
3594         [out, iid_is(riid)] void **ppv);
3595
3596     HRESULT OnBeforeStateImageChange(
3597         [in] IShellItem *psi);
3598
3599     HRESULT OnGetDefaultIconIndex(
3600         [in] IShellItem *psi,
3601         [out] int *piDefaultIcon,
3602         [out] int *piOpenIcon);
3603 }
3604
3605 /*****************************************************************************
3606  * INameSpaceTreeControlCustomDraw interface
3607  */
3608 [
3609  object,
3610  uuid(2D3BA758-33EE-42D5-BB7B-5F3431D86C78),
3611  local
3612 ]
3613
3614 interface INameSpaceTreeControlCustomDraw : IUnknown
3615 {
3616     typedef struct NSTCCUSTOMDRAW
3617     {
3618         IShellItem *psi;
3619         UINT uItemState;
3620         NSTCITEMSTATE nstcis;
3621         LPCWSTR pszText;
3622         int iImage;
3623         HIMAGELIST himl;
3624         int iLevel;
3625         int iIndent;
3626     } NSTCCUSTOMDRAW;
3627
3628     HRESULT PrePaint(
3629         [in] HDC hdc,
3630         [in] RECT *prc,
3631         [out] LRESULT *plres);
3632
3633     HRESULT PostPaint(
3634         [in] HDC hdc,
3635         [in] RECT *prc);
3636
3637     HRESULT ItemPrePaint(
3638         [in] HDC hdc,
3639         [in] RECT *prc,
3640         [in, out] COLORREF *pclrText,
3641         [in, out] COLORREF *pclrTextBk,
3642         [out] LRESULT *plres);
3643
3644     HRESULT ItemPostPaint(
3645         [in] HDC hdc,
3646         [in] RECT *prc,
3647         [in] NSTCCUSTOMDRAW *pnstccdItem);
3648 }
3649
3650 /*****************************************************************************
3651  * INameSpaceTreeControlDropHandler interface
3652  */
3653 [
3654  object,
3655  uuid(F9C665D6-C2F2-4C19-BF33-8322D7352F51),
3656  local
3657 ]
3658 interface INameSpaceTreeControlDropHandler : IUnknown
3659 {
3660     HRESULT OnDragEnter(
3661         [in, unique] IShellItem *psiOver,
3662         [in] IShellItemArray *psiaData,
3663         [in] BOOL fOutsideSource,
3664         [in] DWORD grfKeyState,
3665         [in, out] DWORD *pdwEffect);
3666
3667     HRESULT OnDragOver(
3668         [in, unique] IShellItem *psiOver,
3669         [in] IShellItemArray *psiaData,
3670         [in] DWORD grfKeyState,
3671         [in, out] DWORD *pdwEffect);
3672
3673     HRESULT OnDragPosition(
3674         [in, unique] IShellItem *psiOver,
3675         [in] IShellItemArray *psiaData,
3676         [in] int iNewPosition,
3677         [in] int iOldPosition);
3678
3679     HRESULT OnDrop(
3680         [in, unique] IShellItem *psiOver,
3681         [in] IShellItemArray *psiaData,
3682         [in] int iPosition,
3683         [in] DWORD grfKeyState,
3684         [in, out] DWORD *pdwEffect);
3685
3686     HRESULT OnDropPosition(
3687         [in, unique] IShellItem *psiOver,
3688         [in] IShellItemArray *psiaData,
3689         [in] int iNewPosition,
3690         [in] int iOldPosition);
3691
3692     HRESULT OnDragLeave(
3693         [in, unique] IShellItem *psiOver);
3694 }
3695 cpp_quote("#define NSTCDHPOS_ONTOP -1")
3696
3697 interface IFileDialog;
3698
3699 typedef [v1_enum] enum FDE_OVERWRITE_RESPONSE
3700 {
3701     FDEOR_DEFAULT  = 0,
3702     FDEOR_ACCCEP   = 1,
3703     FDEOR_REFUSE   = 2
3704 } FDE_OVERWRITE_RESPONSE;
3705
3706 typedef [v1_enum] enum FDE_SHAREVIOLATION_RESPONSE
3707 {
3708     FDESVR_DEFAULT = 0,
3709     FDESVR_ACCEPT  = 1,
3710     FDESVR_REFUSE  = 2
3711 } FDE_SHAREVIOLATION_RESPONSE;
3712
3713 /*****************************************************************************
3714  * IFileDialogEvents interface
3715  */
3716 [
3717  object,
3718  uuid(973510DB-7D7F-452B-8975-74A85828D354),
3719  pointer_default(unique)
3720 ]
3721 interface IFileDialogEvents : IUnknown
3722 {
3723     HRESULT OnFileOk(
3724         [in] IFileDialog *pfd);
3725
3726     HRESULT OnFolderChanging(
3727         [in] IFileDialog *pfd,
3728         [in] IShellItem *psiFolder);
3729
3730     HRESULT OnFolderChange(
3731         [in] IFileDialog *pfd);
3732
3733     HRESULT OnSelectionChange(
3734         [in] IFileDialog *pfd);
3735
3736     HRESULT OnShareViolation(
3737         [in] IFileDialog *pfd,
3738         [in] IShellItem *psi,
3739         [out] FDE_SHAREVIOLATION_RESPONSE *pResponse);
3740
3741     HRESULT OnTypeChange(
3742         [in] IFileDialog *pfd);
3743
3744     HRESULT OnOverwrite(
3745         [in] IFileDialog *pfd,
3746         [in] IShellItem *psi,
3747         [out] FDE_OVERWRITE_RESPONSE *pResponse);
3748 }
3749
3750 /*****************************************************************************
3751  * IModalWindow interface
3752  */
3753 [
3754  object,
3755  uuid(B4DB1657-70D7-485E-8E3E-6FCB5A5C1802),
3756  pointer_default(unique)
3757 ]
3758 interface IModalWindow : IUnknown
3759 {
3760     [local]
3761     HRESULT Show(
3762         [in, unique, annotation("__in_opt")] HWND hwndOwner);
3763
3764     [call_as(Show)]
3765     HRESULT RemoteShow(
3766         [in, unique] HWND hwndOwner);
3767 }
3768
3769 typedef [v1_enum] enum FDAP
3770 {
3771     FDAP_BOTTOM    = 0,
3772     FDAP_TOP       = 1
3773 } FDAP;
3774
3775 /*****************************************************************************
3776  * IFileDialog interface
3777  */
3778 [
3779  object,
3780  uuid(42F85136-DB7E-439C-85F1-E4075D135FC8),
3781  pointer_default(unique)
3782 ]
3783 interface IFileDialog : IModalWindow
3784 {
3785     [v1_enum] enum _FILEOPENDIALOGOPTIONS
3786     {
3787         FOS_OVERWRITEPROMPT     = 0x00000002,
3788         FOS_STRICTFILETYPES     = 0x00000004,
3789         FOS_NOCHANGEDIR         = 0x00000008,
3790         FOS_PICKFOLDERS         = 0x00000020,
3791         FOS_FORCEFILESYSTEM     = 0x00000040,
3792         FOS_ALLNONSTORAGEITEMS  = 0x00000080,
3793         FOS_NOVALIDATE          = 0x00000100,
3794         FOS_ALLOWMULTISELECT    = 0x00000200,
3795         FOS_PATHMUSTEXIST       = 0x00000800,
3796         FOS_FILEMUSTEXIST       = 0x00001000,
3797         FOS_CREATEPROMPT        = 0x00002000,
3798         FOS_SHAREAWARE          = 0x00004000,
3799         FOS_NOREADONLYRETURN    = 0x00008000,
3800         FOS_NOTESTFILECREATE    = 0x00010000,
3801         FOS_HIDEMRUPLACES       = 0x00020000,
3802         FOS_HIDEPINNEDPLACES    = 0x00040000,
3803         FOS_NODEREFERENCELINKS  = 0x00100000,
3804         FOS_DONTADDTORECENT     = 0x02000000,
3805         FOS_FORCESHOWHIDDEN     = 0x10000000,
3806         FOS_DEFAULTNOMINIMODE   = 0x20000000,
3807         FOS_FORCEPREVIEWPANEON  = 0x40000000
3808     };
3809     typedef DWORD FILEOPENDIALOGOPTIONS;
3810
3811     HRESULT SetFileTypes(
3812         [in] UINT cFileTypes,
3813         [in, size_is(cFileTypes)] const COMDLG_FILTERSPEC *rgFilterSpec);
3814
3815     HRESULT SetFileTypeIndex(
3816         [in] UINT iFileType);
3817
3818     HRESULT GetFileTypeIndex(
3819         [out] UINT *piFileType);
3820
3821     HRESULT Advise(
3822         [in] IFileDialogEvents *pfde,
3823         [out] DWORD *pdwCookie);
3824
3825     HRESULT Unadvise(
3826         [in] DWORD dwCookie);
3827
3828     HRESULT SetOptions(
3829         [in] FILEOPENDIALOGOPTIONS fos);
3830
3831     HRESULT GetOptions(
3832         [in] FILEOPENDIALOGOPTIONS *pfos);
3833
3834     HRESULT SetDefaultFolder(
3835         [in] IShellItem *psi);
3836
3837     HRESULT SetFolder(
3838         [in] IShellItem *psi);
3839
3840     HRESULT GetFolder(
3841         [out] IShellItem **ppsi);
3842
3843     HRESULT GetCurrentSelection(
3844         [out] IShellItem **ppsi);
3845
3846     HRESULT SetFileName(
3847         [in, string] LPCWSTR pszName);
3848
3849     HRESULT GetFileName(
3850         [out, string] LPWSTR *pszName);
3851
3852     HRESULT SetTitle(
3853         [in, string] LPCWSTR pszTitle);
3854
3855     HRESULT SetOkButtonLabel(
3856         [in, string] LPCWSTR pszText);
3857
3858     HRESULT SetFileNameLabel(
3859         [in, string] LPCWSTR pszLabel);
3860
3861     HRESULT GetResult(
3862         [out] IShellItem **ppsi);
3863
3864     HRESULT AddPlace(
3865         [in] IShellItem *psi,
3866         [in] FDAP fdap);
3867
3868     HRESULT SetDefaultExtension(
3869         [in, string] LPCWSTR pszDefaultExtension);
3870
3871     HRESULT Close(
3872         [in] HRESULT hr);
3873
3874     HRESULT SetClientGuid(
3875         [in] REFGUID guid);
3876
3877     HRESULT ClearClientData();
3878
3879     HRESULT SetFilter(
3880         [in] IShellItemFilter *pFilter);
3881 }
3882
3883 /*****************************************************************************
3884  * IFileDialog2 interface
3885  */
3886 [
3887  object,
3888  uuid(61744FC7-85B5-4791-A9B0-272276309B13),
3889  pointer_default(unique)
3890 ]
3891 interface IFileDialog2 : IFileDialog
3892 {
3893     HRESULT SetCancelButtonLabel(
3894         [in] LPCWSTR pszLabel);
3895
3896     HRESULT SetNavigationRoot(
3897         [in] IShellItem *psi);
3898 }
3899
3900 /*****************************************************************************
3901  * IFileOperationProgressSink interface
3902  */
3903 [
3904  object,
3905  uuid(04B0F1A7-9490-44BC-96E1-4296A31252E2),
3906  pointer_default(unique)
3907 ]
3908 interface IFileOperationProgressSink : IUnknown
3909 {
3910     HRESULT StartOperations();
3911
3912     HRESULT FinishOperations(
3913         [in] HRESULT hrResult);
3914
3915     HRESULT PreRenameItem(
3916         [in] DWORD dwFlags,
3917         [in] IShellItem *psiItem,
3918         [in, unique, string] LPCWSTR pszNewName);
3919
3920     HRESULT PostRenameItem(
3921         [in] DWORD dwFlags,
3922         [in] IShellItem *psiItem,
3923         [in, string] LPCWSTR pszNewName,
3924         [in] HRESULT hrRename,
3925         [in] IShellItem *psiNewlyCreated);
3926
3927     HRESULT PreMoveItem(
3928         [in] DWORD dwFlags,
3929         [in] IShellItem *psiItem,
3930         [in] IShellItem *psiDestinationFolder,
3931         [in, unique, string] LPCWSTR pszNewName);
3932
3933     HRESULT PostMoveItem(
3934         [in] DWORD dwFlags,
3935         [in] IShellItem *psiItem,
3936         [in] IShellItem *psiDestinationFolder,
3937         [in, unique, string] LPCWSTR pszNewName,
3938         [in] HRESULT hrMove,
3939         [in] IShellItem *psiNewlyCreated);
3940
3941     HRESULT PreCopyItem(
3942         [in] DWORD dwFlags,
3943         [in] IShellItem *psiItem,
3944         [in] IShellItem *psiDestinationFolder,
3945         [in, unique, string] LPCWSTR pszNewName);
3946
3947     HRESULT PostCopyItem(
3948         [in] DWORD dwFlags,
3949         [in] IShellItem *psiItem,
3950         [in] IShellItem *psiDestinationFolder,
3951         [in, unique, string] LPCWSTR pszNewName,
3952         [in] HRESULT hrCopy,
3953         [in] IShellItem *psiNewlyCreated);
3954
3955     HRESULT PreDeleteItem(
3956         [in] DWORD dwFlags,
3957         [in] IShellItem *psiItem);
3958
3959     HRESULT PostDeleteItem(
3960         [in] DWORD dwFlags,
3961         [in] IShellItem *psiItem,
3962         [in] HRESULT hrDelete,
3963         [in] IShellItem *psiNewlyCreated);
3964
3965     HRESULT PreNewItem(
3966         [in] DWORD dwFlags,
3967         [in] IShellItem *psiDestinationFolder,
3968         [in, unique, string] LPCWSTR pszNewName);
3969
3970     HRESULT PostNewItem(
3971         [in] DWORD dwFlags,
3972         [in] IShellItem *psiDestinationFolder,
3973         [in, unique, string] LPCWSTR pszNewName,
3974         [in, unique, string] LPCWSTR pszTemplateName,
3975         [in] DWORD dwFileAttributes,
3976         [in] HRESULT hrNew,
3977         [in] IShellItem *psiNewItem);
3978
3979     HRESULT UpdateProgress(
3980         [in] UINT iWorkTotal,
3981         [in] UINT iWorkSoFar);
3982
3983     HRESULT ResetTimer();
3984
3985     HRESULT PauseTimer();
3986
3987     HRESULT ResumeTimer();
3988 }
3989
3990 /*****************************************************************************
3991  * IFileSaveDialog interface
3992  */
3993 [
3994  object,
3995  uuid(84BCCD23-5FDE-4CDB-AEA4-AF64B83D78AB),
3996  pointer_default(unique)
3997 ]
3998 interface IFileSaveDialog : IFileDialog
3999 {
4000     HRESULT SetSaveAsItem(
4001         [in] IShellItem *psi);
4002
4003     HRESULT SetProperties(
4004         [in] IPropertyStore *pStore);
4005
4006     HRESULT SetCollectedProperties(
4007         [in] IPropertyDescriptionList *pList,
4008         [in] BOOL fAppendDefault);
4009
4010     HRESULT GetProperties(
4011         [in] IPropertyStore **ppStore);
4012
4013     HRESULT ApplyProperties(
4014         [in] IShellItem *psi,
4015         [in] IPropertyStore *pStore,
4016         [in, unique] HWND hwnd,
4017         [in, unique] IFileOperationProgressSink *pSink);
4018 }
4019
4020
4021 /*****************************************************************************
4022  * IFileOpenDialog interface
4023  */
4024 [
4025  object,
4026  uuid(D57C7288-D4AD-4768-BE02-9D969532D960),
4027  pointer_default(unique)
4028 ]
4029 interface IFileOpenDialog : IFileDialog
4030 {
4031     HRESULT GetResults(
4032         [out] IShellItemArray **ppenum);
4033
4034     HRESULT GetSelectedItems(
4035         [out] IShellItemArray **ppsai);
4036 }
4037
4038 typedef [v1_enum] enum CDCONTROLSTATEF
4039 {
4040     CDCS_INACTIVE       = 0x0,
4041     CDCS_ENABLED        = 0x1,
4042     CDCS_VISIBLE        = 0x2,
4043     CDCS_ENABLEDVISIBLE = 0x3
4044 } CDCONTROLSTATEF;
4045 cpp_quote("DEFINE_ENUM_FLAG_OPERATORS(CDCONTROLSTATEF)")
4046 /*****************************************************************************
4047  * IFileDialogCustomize interface
4048  */
4049 [
4050  object,
4051  uuid(E6FDD21A-163F-4975-9C8C-A69F1BA37034),
4052  pointer_default(unique)
4053 ]
4054 interface IFileDialogCustomize : IUnknown
4055 {
4056     HRESULT EnableOpenDropDown(
4057         [in] DWORD dwIDCtl);
4058
4059     HRESULT AddMenu(
4060         [in] DWORD dwIDCtl,
4061         [in, string] LPCWSTR pszLabel);
4062
4063     HRESULT AddPushButton(
4064         [in] DWORD dwIDCtl,
4065         [in, string] LPCWSTR pszLabel);
4066
4067     HRESULT AddComboBox(
4068         [in] DWORD dwIDCtl);
4069
4070     HRESULT AddRadioButtonList(
4071         [in] DWORD dwIDCtl);
4072
4073     HRESULT AddCheckButton(
4074         [in] DWORD dwIDCtl,
4075         [in, string] LPCWSTR pszLabel,
4076         [in] BOOL bChecked);
4077
4078     HRESULT AddEditBox(
4079         [in] DWORD dwIDCtl,
4080         [in, string] LPCWSTR pszText);
4081
4082     HRESULT AddSeparator(
4083         [in] DWORD dwIDCtl);
4084
4085     HRESULT AddText(
4086         [in] DWORD dwIDCtl,
4087         [in, string] LPCWSTR pszText);
4088
4089     HRESULT SetControlLabel(
4090         [in] DWORD dwIDCtl,
4091         [in, string] LPCWSTR pszLabel);
4092
4093     HRESULT GetControlState(
4094         [in] DWORD dwIDCtl,
4095         [out] CDCONTROLSTATEF *pdwState);
4096
4097     HRESULT SetControlState(
4098         [in] DWORD dwIDCtl,
4099         [in] CDCONTROLSTATEF dwState);
4100
4101     HRESULT GetEditBoxText(
4102         [in] DWORD dwIDCtl,
4103         [out, string] WCHAR **ppszText);
4104
4105     HRESULT SetEditBoxText(
4106         [in] DWORD dwIDCtl,
4107         [in, string] LPCWSTR pszText);
4108
4109     HRESULT GetCheckButtonState(
4110         [in] DWORD dwIDCtl,
4111         [out] BOOL *pbChecked);
4112
4113     HRESULT SetCheckButtonState(
4114         [in] DWORD dwIDCtl,
4115         [in] BOOL bChecked);
4116
4117     HRESULT AddControlItem(
4118         [in] DWORD dwIDCtl,
4119         [in] DWORD dwIDItem,
4120         [in] LPCWSTR pszLabel);
4121
4122     HRESULT RemoveControlItem(
4123         [in] DWORD dwIDCtl,
4124         [in] DWORD dwIDItem);
4125
4126     HRESULT RemoveAllControlItems(
4127         [in] DWORD dwIDCtl);
4128
4129     HRESULT GetControlItemState(
4130         [in] DWORD dwIDCtl,
4131         [in] DWORD dwIDItem,
4132         [out] CDCONTROLSTATEF *pdwState);
4133
4134     HRESULT SetControlItemState(
4135         [in] DWORD dwIDCtl,
4136         [in] DWORD dwIDItem,
4137         [in] CDCONTROLSTATEF dwState);
4138
4139     HRESULT GetSelectedControlItem(
4140         [in] DWORD dwIDCtl,
4141         [out] DWORD *pdwIDItem);
4142
4143     HRESULT SetSelectedControlItem(
4144         [in] DWORD dwIDCtl,
4145         [in] DWORD dwIDItem);
4146
4147     HRESULT StartVisualGroup(
4148         [in] DWORD dwIDCtl,
4149         [in, string] LPCWSTR pszLabel);
4150
4151     HRESULT EndVisualGroup();
4152
4153     HRESULT MakeProminent(
4154         [in] DWORD dwIDCtl);
4155
4156     HRESULT SetControlItemText(
4157         [in] DWORD dwIDCtl,
4158         [in] DWORD dwIDItem,
4159         [in, string] LPCWSTR pszLabel);
4160 }
4161
4162 /*****************************************************************************
4163  * IFileDialogControlEvents interface
4164  */
4165 [
4166  object,
4167  uuid(36116642-D713-4B97-9B83-7484A9D00433),
4168  pointer_default(unique)
4169 ]
4170 interface IFileDialogControlEvents : IUnknown
4171 {
4172     HRESULT OnItemSelected(
4173         [in] IFileDialogCustomize *pfdc,
4174         [in] DWORD dwIDCtl,
4175         [in] DWORD dwIDItem);
4176
4177     HRESULT OnButtonClicked(
4178         [in] IFileDialogCustomize *pfdc,
4179         [in] DWORD dwIDCtl);
4180
4181     HRESULT OnCheckButtonToggled(
4182         [in] IFileDialogCustomize *pfdc,
4183         [in] BOOL dwIDCtl,
4184         [in] BOOL bChecked);
4185
4186     HRESULT OnControlActivating(
4187         [in] IFileDialogCustomize *pfdc,
4188         [in] DWORD dwIDCtl);
4189 }
4190
4191 typedef [v1_enum] enum tagKF_CATEGORY
4192 {
4193     KF_CATEGORY_VIRTUAL = 0x00000001,
4194     KF_CATEGORY_FIXED   = 0x00000002,
4195     KF_CATEGORY_COMMON  = 0x00000003,
4196     KF_CATEGORY_PERUSER = 0x00000004
4197 } KF_CATEGORY;
4198
4199 typedef [v1_enum] enum tagKF_REDIRECTION_CAPABILITIES
4200 {
4201     KF_REDIRECTION_CAPABILITIES_ALLOW_ALL               = 0x000000ff,
4202     KF_REDIRECTION_CAPABILITIES_REDIRECTABLE            = 0x00000001,
4203     KF_REDIRECTION_CAPABILITIES_DENY_ALL                = 0x000fff00,
4204     KF_REDIRECTION_CAPABILITIES_DENY_POLICY_REDIRECTED  = 0x00000100,
4205     KF_REDIRECTION_CAPABILITIES_DENY_POLICY             = 0x00000200,
4206     KF_REDIRECTION_CAPABILITIES_DENY_PERMISSIONS        = 0x00000400
4207 } KF_REDIRECTION_CAPABILITIES;
4208
4209 typedef [v1_enum] enum tagKF_DEFINITION_FLAGS
4210 {
4211     KFDF_LOCAL_REDIRECT_ONLY    = 0x00000002,
4212     KFDF_ROAMABLE               = 0x00000004,
4213     KFDF_PRECREATE              = 0x00000008,
4214     KFDF_STREAM                 = 0x00000010,
4215     KFDF_PUBLISHEXPANDEDPATH    = 0x00000020
4216 } KF_DEFINITION_FLAGS;
4217
4218 typedef struct tagKNOWNFOLDER_DEFINITION
4219 {
4220     KF_CATEGORY         category;
4221     LPWSTR              pszName;
4222     LPWSTR              pszDescription;
4223     KNOWNFOLDERID       fidParent;
4224     LPWSTR              pszRelativePath;
4225     LPWSTR              pszParsingName;
4226     LPWSTR              pszTooltip;
4227     LPWSTR              pszLocalizedName;
4228     LPWSTR              pszIcon;
4229     LPWSTR              pszSecurity;
4230     DWORD               dwAttributes;
4231     KF_DEFINITION_FLAGS kfdFlags;
4232     FOLDERTYPEID        ftidType;
4233 } KNOWNFOLDER_DEFINITION;
4234
4235 [
4236  object,
4237  uuid(3aa7af7e-9b36-420C-a8e3-f77d4674a488),
4238  pointer_default(ref)
4239 ]
4240 interface IKnownFolder : IUnknown
4241 {
4242     HRESULT GetId(
4243         [out] KNOWNFOLDERID *pkfid);
4244
4245     HRESULT GetCategory(
4246         [out] KF_CATEGORY *pCategory);
4247
4248     HRESULT GetShellItem(
4249         [in] DWORD dwFlags,
4250         [in] REFIID riid,
4251         [out, iid_is(riid)] void **ppv);
4252
4253     HRESULT GetPath(
4254         [in] DWORD dwFlags,
4255         [out, string] LPWSTR *ppszPath);
4256
4257     HRESULT SetPath(
4258         [in] DWORD dwFlags,
4259         [in, string] LPCWSTR pszPath);
4260
4261     HRESULT GetIDList(
4262         [in] DWORD dwFlags,
4263         [out] PIDLIST_ABSOLUTE *ppidl);
4264
4265     HRESULT GetFolderType(
4266         [out] FOLDERTYPEID *pftid);
4267
4268     HRESULT GetRedirectionCapabilities(
4269         [out] KF_REDIRECTION_CAPABILITIES *pCapabilities);
4270
4271     HRESULT GetFolderDefinition(
4272         [out] KNOWNFOLDER_DEFINITION *pKFD);
4273 }
4274
4275 typedef [v1_enum] enum tagKF_REDIRECT_FLAGS
4276 {
4277     KF_REDIRECT_USER_EXCLUSIVE      = 0x00000001,
4278     KF_REDIRECT_COPY_SOURCE_DACL    = 0x00000002,
4279     KF_REDIRECT_OWNER_USER          = 0x00000004,
4280     KF_REDIRECT_SET_OWNER_EXPLICIT  = 0x00000008,
4281     KF_REDIRECT_CHECK_ONLY          = 0x00000010,
4282     KF_REDIRECT_WITH_UI             = 0x00000020,
4283     KF_REDIRECT_UNPIN               = 0x00000040,
4284     KF_REDIRECT_PIN                 = 0x00000080,
4285     KF_REDIRECT_COPY_CONTENTS       = 0x00000200,
4286     KF_REDIRECT_DEL_SOURCE_CONTENTS = 0x00000400,
4287     KF_REDIRECT_EXCLUDE_ALL_KNOWN_SUBFOLDERS = 0x00000800
4288 } KF_REDIRECT_FLAGS;
4289
4290 [
4291     object,
4292     uuid(8BE2D872-86AA-4d47-B776-32CCA40C7018),
4293     pointer_default(ref)
4294 ]
4295 interface IKnownFolderManager : IUnknown
4296 {
4297     typedef [v1_enum] enum tagFFFP_MODE
4298     {
4299         FFFP_EXACTMATCH,
4300         FFFP_NEARESTPARENTMATCH
4301     } FFFP_MODE;
4302
4303     HRESULT FolderIdFromCsidl(
4304         [in] int nCsidl,
4305         [out] KNOWNFOLDERID *pfid);
4306
4307     HRESULT FolderIdToCsidl(
4308         [in] REFKNOWNFOLDERID rfid,
4309         [out] int *pnCsidl);
4310
4311     HRESULT GetFolderIds(
4312         [out, size_is(, *pCount)] KNOWNFOLDERID **ppKFId,
4313         [in, out] UINT *pCount);
4314
4315     HRESULT GetFolder(
4316         [in] REFKNOWNFOLDERID rfid,
4317         [out] IKnownFolder **ppkf);
4318
4319     HRESULT GetFolderByName(
4320         [in, string] LPCWSTR pszCanonicalName,
4321         [out] IKnownFolder **ppkf);
4322
4323     HRESULT RegisterFolder(
4324         [in] REFKNOWNFOLDERID rfid,
4325         [in] KNOWNFOLDER_DEFINITION const *pKFD);
4326
4327     HRESULT UnregisterFolder(
4328         [in] REFKNOWNFOLDERID rfid);
4329
4330     HRESULT FindFolderFromPath(
4331         [in, string] LPCWSTR pszPath,
4332         [in] FFFP_MODE mode,
4333         [out] IKnownFolder **ppkf);
4334
4335     HRESULT FindFolderFromIDList(
4336         [in] PCIDLIST_ABSOLUTE pidl,
4337         [out] IKnownFolder **ppkf);
4338
4339     HRESULT Redirect(
4340         [in] REFKNOWNFOLDERID rfid,
4341         [in, unique] HWND hwnd,
4342         [in] KF_REDIRECT_FLAGS flags,
4343         [in, unique, string] LPCWSTR pszTargetPath,
4344         [in] UINT cFolders,
4345         [in, size_is(cFolders), unique] KNOWNFOLDERID const *pExclusion,
4346         [out, string] LPWSTR *ppszError);
4347 }
4348
4349 /* function for releasing structure returned from IKnownFolder::GetFolderDefinition */
4350 cpp_quote("static inline void FreeKnownFolderDefinitionFields(KNOWNFOLDER_DEFINITION *pKFD)")
4351 cpp_quote("{")
4352 cpp_quote("    CoTaskMemFree(pKFD->pszName);")
4353 cpp_quote("    CoTaskMemFree(pKFD->pszDescription);")
4354 cpp_quote("    CoTaskMemFree(pKFD->pszRelativePath);")
4355 cpp_quote("    CoTaskMemFree(pKFD->pszParsingName);")
4356 cpp_quote("    CoTaskMemFree(pKFD->pszTooltip);")
4357 cpp_quote("    CoTaskMemFree(pKFD->pszLocalizedName);")
4358 cpp_quote("    CoTaskMemFree(pKFD->pszIcon);")
4359 cpp_quote("    CoTaskMemFree(pKFD->pszSecurity);")
4360 cpp_quote("}")
4361
4362 typedef [v1_enum] enum ASSOCIATIONLEVEL {
4363     AL_MACHINE,
4364     AL_EFFECTIVE,
4365     AL_USER
4366 } ASSOCIATIONLEVEL;
4367
4368 typedef [v1_enum] enum ASSOCIATIONTYPE {
4369     AT_FILEEXTENSION,
4370     AT_URLPROTOCOL,
4371     AT_STARTMENUCLIENT,
4372     AT_MIMETYPE
4373 } ASSOCIATIONTYPE;
4374
4375 [
4376     object,
4377     uuid(4e530b0a-e611-4c77-a3ac-9031d022281b),
4378     pointer_default(unique)
4379 ]
4380 interface IApplicationAssociationRegistration : IUnknown
4381 {
4382     HRESULT QueryCurrentDefault(
4383         [in, string] LPCWSTR pszQuery,
4384         [in] ASSOCIATIONTYPE atQueryType,
4385         [in] ASSOCIATIONLEVEL alQueryLevel,
4386         [out, string] LPWSTR *ppszAssociation);
4387
4388     HRESULT QueryAppIsDefault(
4389         [in, string] LPCWSTR pszQuery,
4390         [in] ASSOCIATIONTYPE atQueryType,
4391         [in] ASSOCIATIONLEVEL alQueryLevel,
4392         [in, string] LPCWSTR pszAppRegistryName,
4393         [out] BOOL *pfDefault);
4394
4395     HRESULT QueryAppIsDefaultAll(
4396         [in] ASSOCIATIONLEVEL alQueryLevel,
4397         [in, string] LPCWSTR pszAppRegistryName,
4398         [out] BOOL* pfDefault);
4399
4400     HRESULT SetAppAsDefault(
4401         [in, string] LPCWSTR pszAppRegistryName,
4402         [in, string] LPCWSTR pszSet,
4403         [in] ASSOCIATIONTYPE atSetType);
4404
4405     HRESULT SetAppAsDefaultAll(
4406         [in, string] LPCWSTR pszAppRegistryName);
4407
4408     HRESULT ClearUserAssociations();
4409 }
4410
4411 [
4412     uuid(6332debf-87b5-4670-90c0-5e57b408a49e),
4413     object,
4414     pointer_default(unique)
4415 ]
4416 interface ICustomDestinationList : IUnknown
4417 {
4418     typedef [v1_enum] enum KNOWNDESTCATEGORY {
4419         KDC_FREQUENT = 1,
4420         KDC_RECENT
4421     } KNOWNDESTCATEGORY;
4422
4423     HRESULT SetAppID([in, string] LPCWSTR pszAppID);
4424
4425     HRESULT BeginList(
4426             [out] UINT *pcMinSlots,
4427             [in] REFIID riid,
4428             [out, iid_is(riid)] void **ppv);
4429
4430     HRESULT AppendCategory(
4431             [in, string] LPCWSTR pszCategory,
4432             [in] IObjectArray *poa);
4433
4434     HRESULT AppendKnownCategory([in] KNOWNDESTCATEGORY category);
4435     HRESULT AddUserTasks([in] IObjectArray *poa);
4436     HRESULT CommitList();
4437
4438     HRESULT GetRemovedDestinations(
4439             [in] REFIID riid,
4440             [out, iid_is(riid)] void **ppv);
4441
4442     HRESULT DeleteList([in, unique, string] LPCWSTR pszAppID);
4443     HRESULT AbortList();
4444 }
4445
4446 /*****************************************************************************
4447  * ShellObjects typelibrary
4448  */
4449 [
4450  uuid(50A7E9B1-70EF-11D1-B75A-00A0C90564FE),
4451  lcid(0x0000),
4452  version(1.0)
4453 ]
4454 library ShellObjects
4455 {
4456     [
4457         uuid(71F96385-DDD6-48D3-A0C1-AE06E8B055FB)
4458     ]
4459     coclass ExplorerBrowser
4460     {
4461         interface IExplorerBrowser;
4462     }
4463
4464     [
4465         uuid(DC1C5A9C-E88A-4DDE-A5A1-60F82A20AEF7)
4466     ]
4467     coclass FileOpenDialog
4468     {
4469         interface IFileOpenDialog;
4470     }
4471
4472     [
4473         uuid(C0B4E2F3-BA21-4773-8DBA-335EC946EB8B)
4474     ]
4475     coclass FileSaveDialog
4476     {
4477         interface IFileSaveDialog;
4478     }
4479
4480     [
4481         uuid(AE054212-3535-4430-83ED-D501AA6680E6)
4482     ]
4483     coclass NamespaceTreeControl
4484     {
4485         interface INameSpaceTreeControl2;
4486     }
4487
4488     [
4489         uuid(4df0c730-df9d-4ae3-9153-aa6b82e9795a)
4490     ]
4491     coclass KnownFolderManager
4492     {
4493         interface IKnownFolderManager;
4494     }
4495
4496     [
4497         uuid(591209c7-767b-42b2-9fba-44ee4615f2c7)
4498     ]
4499     coclass ApplicationAssociationRegistration
4500     {
4501         interface IApplicationAssociationRegistration;
4502     }
4503
4504     [
4505          uuid(00021401-0000-0000-c000-000000000046)
4506     ]
4507     coclass ShellLink
4508     {
4509         interface IShellLinkW;
4510     }
4511
4512     [
4513         uuid(56fdf344-fd6d-11d0-958a-006097c9a090)
4514     ]
4515     coclass TaskbarList
4516     {
4517         interface ITaskbarList4;
4518     }
4519
4520     [
4521         uuid(77f10cf0-3db5-4966-b520-b7c54fd35ed6)
4522     ]
4523     coclass DestinationList {
4524         interface ICustomDestinationList;
4525     }
4526 }