include/shobjidl.idl

   1 /*
   2  * COM interfaces for shell objects
   3  *
   4  * Copyright (C) 1999 Juergen Schmied
   5  * Copyright (C) 2003 Alexandre Julliard
   6  *
   7  * This library is free software; you can redistribute it and/or
   8  * modify it under the terms of the GNU Lesser General Public
   9  * License as published by the Free Software Foundation; either
  10  * version 2.1 of the License, or (at your option) any later version.
  11  *
  12  * This library is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15  * Lesser General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU Lesser General Public
  18  * License along with this library; if not, write to the Free Software
  19  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
  20  */
  21
  22 import "objidl.idl";
  23 import "oleidl.idl";
  24 import "oaidl.idl";
  25 import "docobj.idl";
  26 import "shtypes.idl";
  27 import "servprov.idl";
  28 import "comcat.idl";
  29 import "propidl.idl";
  30 /* FIXME: import "prsht.idl";*/
  31 import "msxml.idl";
  32 import "wtypes.idl";
  33 import "propsys.idl";
  34 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_CHECKING_FOR_CHILDREN = 0x00000010,
 170         SHCONTF_FOLDERS               = 0x00000020,
 171         SHCONTF_NONFOLDERS            = 0x00000040,
 172         SHCONTF_INCLUDEHIDDEN         = 0x00000080,
 173         SHCONTF_INIT_ON_FIRST_NEXT    = 0x00000100,
 174         SHCONTF_NETPRINTERSRCH        = 0x00000200,
 175         SHCONTF_SHAREABLE             = 0x00000400,
 176         SHCONTF_STORAGE               = 0x00000800,
 177         SHCONTF_NAVIGATION_ENUM       = 0x00001000,
 178         SHCONTF_FASTITEMS             = 0x00002000,
 179         SHCONTF_FLATLIST              = 0x00004000,
 180         SHCONTF_ENABLE_ASYNC          = 0x00008000,
 181         SHCONTF_INCLUDESUPERHIDDEN    = 0x00010000
 182     };
 183
 184     typedef DWORD SHCONTF;
 185
 186     cpp_quote("#define SFGAO_CANCOPY           DROPEFFECT_COPY")
 187     cpp_quote("#define SFGAO_CANMOVE           DROPEFFECT_MOVE")
 188     cpp_quote("#define SFGAO_CANLINK           DROPEFFECT_LINK")
 189     cpp_quote("#define SFGAO_STORAGE           0x00000008L")
 190     cpp_quote("#define SFGAO_CANRENAME         0x00000010L")
 191     cpp_quote("#define SFGAO_CANDELETE         0x00000020L")
 192     cpp_quote("#define SFGAO_HASPROPSHEET      0x00000040L")
 193     cpp_quote("#define SFGAO_DROPTARGET        0x00000100L")
 194     cpp_quote("#define SFGAO_CAPABILITYMASK    0x00000177L")
 195     cpp_quote("#define SFGAO_SYSTEM            0x00001000L")
 196     cpp_quote("#define SFGAO_ENCRYPTED         0x00002000L")
 197     cpp_quote("#define SFGAO_ISSLOW            0x00004000L")
 198     cpp_quote("#define SFGAO_GHOSTED           0x00008000L")
 199     cpp_quote("#define SFGAO_LINK              0x00010000L")
 200     cpp_quote("#define SFGAO_SHARE             0x00020000L")
 201     cpp_quote("#define SFGAO_READONLY          0x00040000L")
 202     cpp_quote("#define SFGAO_HIDDEN            0x00080000L")
 203     cpp_quote("#define SFGAO_DISPLAYATTRMASK   0x000FC000L")
 204     cpp_quote("#define SFGAO_FILESYSANCESTOR   0x10000000L")
 205     cpp_quote("#define SFGAO_FOLDER            0x20000000L")
 206     cpp_quote("#define SFGAO_FILESYSTEM        0x40000000L")
 207     cpp_quote("#define SFGAO_HASSUBFOLDER      0x80000000L")
 208     cpp_quote("#define SFGAO_CONTENTSMASK      0x80000000L")
 209     cpp_quote("#define SFGAO_VALIDATE          0x01000000L")
 210     cpp_quote("#define SFGAO_REMOVABLE         0x02000000L")
 211     cpp_quote("#define SFGAO_COMPRESSED        0x04000000L")
 212     cpp_quote("#define SFGAO_BROWSABLE         0x08000000L")
 213     cpp_quote("#define SFGAO_NONENUMERATED     0x00100000L")
 214     cpp_quote("#define SFGAO_NEWCONTENT        0x00200000L")
 215     cpp_quote("#define SFGAO_CANMONIKER        0x00400000L")
 216     cpp_quote("#define SFGAO_HASSTORAGE        0x00400000L")
 217     cpp_quote("#define SFGAO_STREAM            0x00400000L")
 218     cpp_quote("#define SFGAO_STORAGEANCESTOR   0x00800000L")
 219     cpp_quote("#define SFGAO_STORAGEGAPMASK    0x70C50008L")
 220     cpp_quote("#define SFGAO_PKEYSFGAOMASK     0x81044000L")
 221
 222     typedef ULONG SFGAOF;
 223
 224     HRESULT ParseDisplayName(
 225         [in] HWND hwndOwner,
 226         [in] LPBC pbcReserved,
 227         [in, string] LPOLESTR lpszDisplayName,
 228         [out] ULONG *pchEaten,
 229         [out] LPITEMIDLIST *ppidl,
 230         [in, out, unique] ULONG *pdwAttributes);
 231
 232     HRESULT EnumObjects(
 233         [in] HWND hwndOwner,
 234         [in] SHCONTF grfFlags,
 235         [out] IEnumIDList **ppenumIDList);
 236
 237     HRESULT BindToObject(
 238         [in] LPCITEMIDLIST pidl,
 239         [in] LPBC pbcReserved,
 240         [in] REFIID riid,
 241         [out, iid_is(riid)] void **ppvOut);
 242
 243     HRESULT BindToStorage(
 244         [in] LPCITEMIDLIST pidl,
 245         [in] LPBC pbcReserved,
 246         [in] REFIID riid,
 247         [out, iid_is(riid)] void **ppvObj);
 248
 249     HRESULT CompareIDs(
 250         [in] LPARAM lParam,
 251         [in] LPCITEMIDLIST pidl1,
 252         [in] LPCITEMIDLIST pidl2);
 253
 254     HRESULT CreateViewObject(
 255         [in] HWND hwndOwner,
 256         [in] REFIID riid,
 257         [out, iid_is(riid)] void **ppvOut);
 258
 259     HRESULT GetAttributesOf(
 260         [in] UINT cidl,
 261         [in, size_is(cidl)] LPCITEMIDLIST *apidl,
 262         [in, out] SFGAOF *rgfInOut);
 263
 264     HRESULT GetUIObjectOf(
 265         [in] HWND hwndOwner,
 266         [in] UINT cidl,
 267         [in, size_is(cidl)] LPCITEMIDLIST *apidl,
 268         [in] REFIID riid,
 269         [in, out, unique] UINT *prgfInOut,
 270         [out, iid_is(riid)] void **ppvOut);
 271
 272     HRESULT GetDisplayNameOf(
 273         [in] LPCITEMIDLIST pidl,
 274         [in] SHGDNF uFlags,
 275         [out] STRRET *lpName);
 276
 277     HRESULT SetNameOf(
 278         [in] HWND hwnd,
 279         [in] LPCITEMIDLIST pidl,
 280         [in, string] LPCOLESTR lpszName,
 281         [in] SHGDNF uFlags,
 282         [out] LPITEMIDLIST *ppidlOut);
 283 }
 284
 285
 286 /*****************************************************************************
 287  * IEnumExtraSearch interface
 288  */
 289 [
 290     object,
 291     uuid(0e700be1-9db6-11d1-a1ce-00c04fd75d13),
 292     pointer_default(unique)
 293 ]
 294 interface IEnumExtraSearch : IUnknown
 295 {
 296     typedef IEnumExtraSearch *LPENUMEXTRASEARCH;
 297
 298     typedef struct
 299     {
 300         GUID guidSearch;
 301         WCHAR wszFriendlyName[80];
 302         /*
 303          *WCHAR wszMenuText[80];
 304          *WCHAR wszHelpText[MAX_PATH];
 305          */
 306         WCHAR wszUrl[2084];
 307         /*
 308          *WCHAR wszIcon[MAX_PATH+10];
 309          *WCHAR wszGreyIcon[MAX_PATH+10];
 310          *WCHAR wszClrIcon[MAX_PATH+10];
 311          */
 312     } EXTRASEARCH, *LPEXTRASEARCH;
 313
 314     HRESULT Next(
 315         [in] ULONG celt,
 316         [out, size_is(celt), length_is(*pceltFetched)] EXTRASEARCH *rgelt,
 317         [out] ULONG *pceltFetched);
 318
 319     HRESULT Skip( [in] ULONG celt );
 320     HRESULT Reset();
 321     HRESULT Clone( [out] IEnumExtraSearch **ppenum );
 322 }
 323
 324
 325 /*****************************************************************************
 326  * IShellFolder2 interface
 327  */
 328 [
 329     object,
 330     uuid(93f2f68c-1d1b-11d3-a30e-00c04f79abd1),
 331     pointer_default(unique)
 332 ]
 333 interface IShellFolder2 : IShellFolder
 334 {
 335     typedef struct
 336     {
 337         GUID    fmtid;
 338         DWORD   pid;
 339     } SHCOLUMNID, *LPSHCOLUMNID;
 340     typedef const SHCOLUMNID *LPCSHCOLUMNID;
 341
 342     HRESULT GetDefaultSearchGUID( [out] GUID *lpguid );
 343     HRESULT EnumSearches( [out] IEnumExtraSearch **ppenum );
 344     HRESULT GetDefaultColumn( [in] DWORD dwReserved, [out] ULONG *pSort, [out] ULONG *pDisplay );
 345     HRESULT GetDefaultColumnState( [in] UINT iColumn, [out] SHCOLSTATEF *pcsFlags );
 346     HRESULT GetDetailsEx( [in] LPCITEMIDLIST pidl, [in] const SHCOLUMNID *pscid, [out] VARIANT *pv);
 347     HRESULT GetDetailsOf( [in] LPCITEMIDLIST pidl, [in] UINT iColumn, [out] SHELLDETAILS *psd);
 348     HRESULT MapColumnToSCID( [in] UINT iColumn, [in] SHCOLUMNID *pscid );
 349 }
 350
 351 /*****************************************************************************
 352  * IShellItem interface
 353  */
 354 [
 355     object,
 356     uuid(43826d1e-e718-42ee-bc55-a1e261c37bfe),
 357     pointer_default(unique)
 358 ]
 359 interface IShellItem : IUnknown
 360 {
 361     typedef [v1_enum] enum {
 362         SIGDN_NORMALDISPLAY                = 0,
 363         SIGDN_PARENTRELATIVEPARSING        = 0x80018001,
 364         SIGDN_DESKTOPABSOLUTEPARSING       = 0x80028000,
 365         SIGDN_PARENTRELATIVEEDITING        = 0x80031001,
 366         SIGDN_DESKTOPABSOLUTEEDITING       = 0x8004c000,
 367         SIGDN_FILESYSPATH                  = 0x80058000,
 368         SIGDN_URL                          = 0x80068000,
 369         SIGDN_PARENTRELATIVEFORADDRESSBAR  = 0x8007c001,
 370         SIGDN_PARENTRELATIVE               = 0x80080001,
 371         SIGDN_PARENTRELATIVEFORUI          = 0x80094001,
 372     } SIGDN; /* & 0xFFFF => SHGDN */
 373
 374     [v1_enum] enum _SICHINTF
 375     {
 376         SICHINT_DISPLAY                       = 0x00000000,
 377         SICHINT_CANONICAL                     = 0x10000000,
 378         SICHINT_TEST_FILESYSPATH_IF_NOT_EQUAL = 0x20000000,
 379         SICHINT_ALLFIELDS                     = 0x80000000
 380     };
 381     typedef DWORD SICHINTF;
 382
 383     HRESULT BindToHandler(
 384         [in] IBindCtx *pbc,
 385         [in] REFGUID rbhid,
 386         [in] REFIID riid,
 387         [out, iid_is(riid)] void **ppvOut);
 388
 389     HRESULT GetParent( [out] IShellItem **ppsi );
 390
 391     HRESULT GetDisplayName(
 392         [in] SIGDN sigdnName,
 393         [out] LPWSTR *ppszName);
 394
 395     HRESULT GetAttributes(
 396         [in] SFGAOF sfgaoMask,
 397         [out] SFGAOF *psfgaoAttribs);
 398
 399     HRESULT Compare(
 400         [in] IShellItem *psi,
 401         [in] SICHINTF hint,
 402         [out] int *piOrder);
 403 }
 404
 405 /*****************************************************************************
 406  * IShellItem2 interface
 407  */
 408 [
 409     object,
 410     uuid(7E9FB0D3-919F-4307-AB2E-9B1860310C93),
 411     pointer_default(unique)
 412 ]
 413 interface IShellItem2 : IShellItem
 414 {
 415     HRESULT GetPropertyStore(
 416         [in] GETPROPERTYSTOREFLAGS flags,
 417         [in] REFIID riid,
 418         [out, iid_is(riid)] void **ppv);
 419
 420     HRESULT GetPropertyStoreWithCreateObject(
 421         [in] GETPROPERTYSTOREFLAGS flags,
 422         [in] IUnknown *punkCreateObject,
 423         [in] REFIID riid,
 424         [out, iid_is(riid)] void **ppv);
 425
 426     HRESULT GetPropertyStoreForKeys(
 427         [in, size_is(cKeys)] const PROPERTYKEY *rgKeys,
 428         [in] UINT cKeys,
 429         [in] GETPROPERTYSTOREFLAGS flags,
 430         [in] REFIID riid,
 431         [out, iid_is(riid)] void **ppv);
 432
 433     HRESULT GetPropertyDescriptionList(
 434         [in] REFPROPERTYKEY keyType,
 435         [in] REFIID riid,
 436         [out, iid_is(riid)] void **ppv);
 437
 438     HRESULT Update(
 439         [in, unique] IBindCtx *pbc);
 440
 441     HRESULT GetProperty(
 442         [in] REFPROPERTYKEY key,
 443         [out] PROPVARIANT *ppropvar);
 444
 445     HRESULT GetCLSID(
 446         [in] REFPROPERTYKEY key,
 447         [out] CLSID *pclsid);
 448
 449     HRESULT GetFileTime (
 450         [in] REFPROPERTYKEY key,
 451         [out] FILETIME *pft);
 452
 453     HRESULT GetInt32(
 454         [in] REFPROPERTYKEY key,
 455         [out] int *pi);
 456
 457     HRESULT GetString(
 458         [in] REFPROPERTYKEY key,
 459         [out, string] LPWSTR *ppsz);
 460
 461     HRESULT GetUInt32(
 462         [in] REFPROPERTYKEY key,
 463         [out] ULONG *pui);
 464
 465     HRESULT GetUInt64(
 466         [in] REFPROPERTYKEY key,
 467         [out] ULONGLONG *pull);
 468
 469     HRESULT GetBool(
 470         [in] REFPROPERTYKEY key,
 471         [out] BOOL *pf);
 472 }
 473
 474 typedef [v1_enum] enum tagNWMF {
 475     NWMF_UNLOADING        = 0x00000001,
 476     NWMF_USERINITED       = 0x00000002,
 477     NWMF_FIRST            = 0x00000004,
 478     NWMF_OVERRIDEKEY      = 0x00000008,
 479     NWMF_SHOWHELP         = 0x00000010,
 480     NWMF_HTMLDIALOG       = 0x00000020,
 481     NWMF_FROMDIALOGCHILD  = 0x00000040,
 482     NWMF_USERREQUESTED    = 0x00000080,
 483     NWMF_USERALLOWED      = 0x00000100,
 484     NWMF_FORCEWINDOW      = 0x00010000,
 485     NWMF_FORCETAB         = 0x00020000,
 486     NWMF_SUGGESTWINDOW    = 0x00040000,
 487     NWMF_SUGGESTTAB       = 0x00080000,
 488     NWMF_INACTIVETAB      = 0x00100000,
 489 } NWMF;
 490
 491 [
 492     uuid(d2bc4c84-3f72-4a52-a604-7bcbf3982cbb),
 493     object,
 494     pointer_default(unique)
 495 ]
 496 interface INewWindowManager : IUnknown
 497 {
 498     HRESULT EvaluateNewWindow(
 499         [in, string] LPCWSTR pszUrl,
 500         [in, string] LPCWSTR pszName,
 501         [in, string] LPCWSTR pszUrlContext,
 502         [in, string] LPCWSTR pszFeatures,
 503         [in]         BOOL fReplace,
 504         [in]         DWORD dwFlags,
 505         [in]         DWORD dwUserActionTime);
 506 }
 507
 508 cpp_quote("#define SID_SNewWindowManager IID_INewWindowManager")
 509
 510 /*****************************************************************************
 511  * IEnumShellItems interface
 512  */
 513 [
 514  object,
 515  uuid(70629033-E363-4A28-A567-0DB78006E6D7),
 516  pointer_default(unique)
 517 ]
 518 interface IEnumShellItems : IUnknown
 519 {
 520     [local] HRESULT Next(
 521         [in] ULONG celt,
 522         [out, size_is(celt), length_is(*pceltFetched)] IShellItem **rgelt,
 523         [out] ULONG *pceltFetched);
 524
 525     [call_as(Next)] HRESULT RemoteNext(
 526         [in] ULONG celt,
 527         [out, size_is(celt), length_is(*pceltFetched)] IShellItem **rgelt,
 528         [out] ULONG *pceltFetched);
 529
 530     HRESULT Skip(
 531         [in] ULONG celt);
 532
 533     HRESULT Reset();
 534
 535     HRESULT Clone(
 536         [out] IEnumShellItems **ppenum);
 537 }
 538
 539 /*****************************************************************************
 540  * IShellItemArray interface
 541  */
 542 [
 543  object,
 544  uuid(B63EA76D-1F85-456F-A19C-48159EFA858B),
 545  pointer_default(unique)
 546 ]
 547 interface IShellItemArray : IUnknown
 548 {
 549     typedef [v1_enum] enum SIATTRIBFLAGS {
 550         SIATTRIBFLAGS_AND            = 0x0001,
 551         SIATTRIBFLAGS_OR             = 0x0002,
 552         SIATTRIBFLAGS_APPCOMPAT      = 0x0003,
 553         SIATTRIBFLAGS_MASK           = 0x0003,
 554         SIATTRIBFLAGS_ALLITEMS       = 0x4000
 555     } SIATTRIBFLAGS;
 556     cpp_quote("DEFINE_ENUM_FLAG_OPERATORS(SIATTRIBFLAGS)")
 557
 558     HRESULT BindToHandler(
 559         [in, unique] IBindCtx *pbc,
 560         [in] REFGUID bhid,
 561         [in] REFIID riid,
 562         [out, iid_is(riid)] void **ppvOut);
 563
 564     HRESULT GetPropertyStore(
 565         [in] GETPROPERTYSTOREFLAGS flags,
 566         [in] REFIID riid,
 567         [out, iid_is(riid)] void **ppv);
 568
 569     HRESULT GetPropertyDescriptionList(
 570         [in] REFPROPERTYKEY keyType,
 571         [in] REFIID riid,
 572         [out, iid_is(riid)] void **ppv);
 573
 574     HRESULT GetAttributes(
 575         [in] SIATTRIBFLAGS AttribFlags,
 576         [in] SFGAOF sfgaoMask,
 577         [out] SFGAOF *psfgaoAttribs);
 578
 579     HRESULT GetCount(
 580         [out] DWORD *pdwNumItems);
 581
 582     HRESULT GetItemAt(
 583         [in] DWORD dwIndex,
 584         [out] IShellItem **ppsi);
 585
 586     HRESULT EnumItems(
 587         [out] IEnumShellItems **ppenumShellItems);
 588
 589 }
 590
 591 typedef [v1_enum] enum DATAOBJ_GET_ITEM_FLAGS
 592 {
 593     DOGIF_DEFAULT       = 0x0,
 594     DOGIF_TRAVERSE_LINK = 0x1,
 595     DOGIF_NO_HDROP      = 0x2,
 596     DOGIF_NO_URL        = 0x4,
 597     DOGIF_ONLY_IF_ONE   = 0x8
 598 } DATAOBJ_GET_ITEM_FLAGS;
 599 cpp_quote("DEFINE_ENUM_FLAG_OPERATORS(DATAOBJ_GET_ITEM_FLAGS)")
 600
 601 cpp_quote("HRESULT WINAPI SHGetNameFromIDList(PCIDLIST_ABSOLUTE pidl, SIGDN sigdnName, PWSTR *ppszName);")
 602 cpp_quote("HRESULT WINAPI SHCreateItemFromParsingName(PCWSTR pszPath, IBindCtx *pbc, REFIID riid, void **ppv);")
 603 cpp_quote("HRESULT WINAPI SHCreateItemFromIDList(PCIDLIST_ABSOLUTE pidl, REFIID riid, void **ppv);")
 604 cpp_quote("HRESULT WINAPI SHCreateItemFromRelativeName(IShellItem *parent, PCWSTR name, IBindCtx *pbc, REFIID riid, void **ppv);")
 605 cpp_quote("HRESULT WINAPI SHGetItemFromDataObject(IDataObject *pdtobj, DATAOBJ_GET_ITEM_FLAGS dwFlags, REFIID riid, void **ppv);")
 606 cpp_quote("HRESULT WINAPI SHGetIDListFromObject(IUnknown *punk, PIDLIST_ABSOLUTE *ppidl);")
 607 cpp_quote("HRESULT WINAPI SHGetItemFromObject(IUnknown *punk, REFIID riid, void **ppv);")
 608 cpp_quote("HRESULT WINAPI SHCreateShellItemArray(PCIDLIST_ABSOLUTE pidlParent, IShellFolder* psf, UINT cidl, PCUITEMID_CHILD_ARRAY ppidl, IShellItemArray **ppsiItemArray);")
 609 cpp_quote("HRESULT WINAPI SHCreateShellItemArrayFromShellItem(IShellItem *psi, REFIID riid, void **ppv);")
 610 cpp_quote("HRESULT WINAPI SHCreateShellItemArrayFromIDLists(UINT cidl, PCIDLIST_ABSOLUTE_ARRAY pidl_array, IShellItemArray **psia);")
 611 cpp_quote("HRESULT WINAPI SHCreateItemInKnownFolder(REFKNOWNFOLDERID rfid, DWORD flags, PCWSTR filename, REFIID riid, void **ppv);")
 612 cpp_quote("HRESULT WINAPI SHCreateShellItemArrayFromDataObject(IDataObject *pdo, REFIID riid, void **ppv);")
 613
 614 /*****************************************************************************
 615  * IShellItemFilter interface
 616  */
 617 [
 618  object,
 619  uuid(2659B475-EEB8-48B7-8F07-B378810F48CF),
 620  pointer_default(unique)
 621 ]
 622 interface IShellItemFilter : IUnknown
 623 {
 624     HRESULT IncludeItem(
 625         [in] IShellItem *psi);
 626
 627     HRESULT GetEnumFlagsForItem(
 628         [in] IShellItem *psi,
 629         [out] SHCONTF *pgrfFlags);
 630 }
 631
 632 /*****************************************************************************
 633  * FOLDERSETTINGS
 634  */
 635 typedef char *LPVIEWSETTINGS;
 636
 637 typedef [v1_enum] enum FOLDERFLAGS
 638 {
 639     FWF_AUTOARRANGE         = 0x00000001,
 640     FWF_ABBREVIATEDNAMES    = 0x00000002,
 641     FWF_SNAPTOGRID          = 0x00000004,
 642     FWF_OWNERDATA           = 0x00000008,
 643     FWF_BESTFITWINDOW       = 0x00000010,
 644     FWF_DESKTOP             = 0x00000020,
 645     FWF_SINGLESEL           = 0x00000040,
 646     FWF_NOSUBFOLDERS        = 0x00000080,
 647     FWF_TRANSPARENT         = 0x00000100,
 648     FWF_NOCLIENTEDGE        = 0x00000200,
 649     FWF_NOSCROLL            = 0x00000400,
 650     FWF_ALIGNLEFT           = 0x00000800,
 651     FWF_NOICONS             = 0x00001000,
 652     FWF_SHOWSELALWAYS       = 0x00002000,
 653     FWF_NOVISIBLE           = 0x00004000,
 654     FWF_SINGLECLICKACTIVATE = 0x00008000,
 655     FWF_NOWEBVIEW           = 0x00010000,
 656     FWF_HIDEFILENAMES       = 0x00020000,
 657     FWF_CHECKSELECT         = 0x00040000,
 658     FWF_NOENUMREFRESH       = 0x00080000,
 659     FWF_NOGROUPING          = 0x00100000,
 660     FWF_FULLROWSELECT       = 0x00200000,
 661     FWF_NOFILTERS           = 0x00400000,
 662     FWF_NOCOLUMNHEADER      = 0x00800000,
 663     FWF_NOHEADERINALLVIEWS  = 0x01000000,
 664     FWF_EXTENDEDTILES       = 0x02000000,
 665     FWF_TRICHECKSELECT      = 0x04000000,
 666     FWF_AUTOCHECKSELECT     = 0x08000000,
 667     FWF_NOBROWSERVIEWSTATE  = 0x10000000,
 668     FWF_SUBSETGROUPS        = 0x20000000,
 669     FWF_USESEARCHFOLDER     = 0x40000000,
 670     FWF_ALLOWRTLREADING     = 0x80000000
 671 } FOLDERFLAGS;
 672
 673 typedef [v1_enum] enum FOLDERVIEWMODE
 674 {
 675     FVM_AUTO       =-1,
 676     FVM_ICON       = 1,
 677     FVM_FIRST      = FVM_ICON,
 678     FVM_SMALLICON  = 2,
 679     FVM_LIST       = 3,
 680     FVM_DETAILS    = 4,
 681     FVM_THUMBNAIL  = 5,
 682     FVM_TILE       = 6,
 683     FVM_THUMBSTRIP = 7,
 684     FVM_CONTENT    = 8,
 685     FVM_LAST       = FVM_CONTENT
 686 } FOLDERVIEWMODE;
 687
 688 typedef struct
 689 {
 690     UINT ViewMode;
 691     UINT fFlags;
 692 } FOLDERSETTINGS, *PFOLDERSETTINGS, *LPFOLDERSETTINGS;
 693 typedef const FOLDERSETTINGS *LPCFOLDERSETTINGS;
 694
 695 /*****************************************************************************
 696  * IShellIcon interface
 697  */
 698 [
 699     uuid(000214e5-0000-0000-c000-000000000046),
 700     object,
 701     pointer_default(unique)
 702 ]
 703 interface IShellIcon : IUnknown
 704 {
 705     HRESULT GetIconOf(
 706         [in] PCUITEMID_CHILD pidl,
 707         [in] UINT flags,
 708         [out] int *pIconIndex);
 709 }
 710
 711 /*****************************************************************************
 712  * IShellView interface
 713  */
 714 interface IShellBrowser;  /* forward declaration */
 715 [
 716     object,
 717     uuid(000214e3-0000-0000-c000-000000000046),
 718     pointer_default(unique)
 719 ]
 720 interface IShellView : IOleWindow
 721 {
 722     typedef IShellView *LPSHELLVIEW;
 723
 724     typedef [v1_enum] enum _SVSIF
 725     {
 726         SVSI_DESELECT       = 0x00000000,
 727         SVSI_SELECT         = 0x00000001,
 728         SVSI_EDIT           = 0x00000003,
 729         SVSI_DESELECTOTHERS = 0x00000004,
 730         SVSI_ENSUREVISIBLE  = 0x00000008,
 731         SVSI_FOCUSED        = 0x00000010,
 732         SVSI_TRANSLATEPT    = 0x00000020,
 733         SVSI_SELECTIONMARK  = 0x00000040,
 734         SVSI_POSITIONITEM   = 0x00000080,
 735         SVSI_CHECK          = 0x00000100,
 736         SVSI_CHECK2         = 0x00000200,
 737         SVSI_KEYBOARDSELECT = 0x00000401,
 738         SVSI_NOTAKEFOCUS    = 0x40000000,
 739     } _SVSIF;
 740
 741     cpp_quote("#define SVSI_NOSTATECHANGE  0x80000000")
 742
 743     typedef UINT SVSIF;
 744
 745     typedef [v1_enum] enum _SVGIO
 746     {
 747         SVGIO_BACKGROUND     = 0x00000000,
 748         SVGIO_SELECTION      = 0x00000001,
 749         SVGIO_ALLVIEW        = 0x00000002,
 750         SVGIO_CHECKED        = 0x00000003,
 751         SVGIO_TYPE_MASK      = 0x0000000f,
 752         SVGIO_FLAG_VIEWORDER = 0x80000000,
 753     } _SVGIO;
 754
 755     typedef INT SVGIO;
 756
 757     typedef [v1_enum] enum SVUIA_STATUS
 758     {
 759         SVUIA_DEACTIVATE       = 0,
 760         SVUIA_ACTIVATE_NOFOCUS = 1,
 761         SVUIA_ACTIVATE_FOCUS   = 2,
 762         SVUIA_INPLACEACTIVATE  = 3
 763     } SVUIA_STATUS;
 764
 765     HRESULT TranslateAccelerator( [in] MSG *pmsg );
 766     HRESULT EnableModeless( [in] BOOL fEnable );
 767     HRESULT UIActivate( [in] UINT uState );
 768     HRESULT Refresh();
 769     HRESULT CreateViewWindow(
 770         [in] IShellView *psvPrevious,
 771         [in] LPCFOLDERSETTINGS lpfs,
 772         [in] IShellBrowser *psb,
 773         [out] RECT *prcView,
 774         [out] HWND *phWnd);
 775
 776     HRESULT DestroyViewWindow();
 777     HRESULT GetCurrentInfo( [out] LPFOLDERSETTINGS lpfs );
 778
 779     [local] HRESULT AddPropertySheetPages(
 780         [in] DWORD dwReserved,
 781         [in] LPFNSVADDPROPSHEETPAGE pfn,
 782         [in] LPARAM lparam);
 783
 784     HRESULT SaveViewState();
 785     HRESULT SelectItem(
 786         [in] LPCITEMIDLIST pidlItem,
 787         [in] SVSIF uFlags);
 788     HRESULT GetItemObject(
 789         [in] UINT uItem,
 790         [in] REFIID riid,
 791         [out, iid_is(riid)] void **ppv);
 792 }
 793
 794 [
 795     object,
 796     uuid(88e39e80-3578-11cf-ae69-08002b2e1262),
 797     pointer_default(unique)
 798 ]
 799 interface IShellView2 : IShellView
 800 {
 801     typedef GUID SHELLVIEWID;
 802 cpp_quote("#include <pshpack8.h>")
 803     typedef struct _SV2CVW2_PARAMS
 804     {
 805         DWORD cbSize;
 806         IShellView *psvPrev;
 807         LPCFOLDERSETTINGS pfs;
 808         IShellBrowser *psbOwner;
 809         RECT *prcView;
 810         SHELLVIEWID const *pvid;
 811         HWND hwndView;
 812     } SV2CVW2_PARAMS, *LPSV2CVW2_PARAMS;
 813 cpp_quote("#include <poppack.h>")
 814
 815     HRESULT GetView(
 816         [in, out] SHELLVIEWID *view_guid,
 817         [in] ULONG view_type
 818     );
 819     HRESULT CreateViewWindow2(
 820         [in] LPSV2CVW2_PARAMS view_params
 821     );
 822     HRESULT HandleRename(
 823         [in] LPCITEMIDLIST new_pidl
 824     );
 825     HRESULT SelectAndPositionItem(
 826         [in] LPCITEMIDLIST item,
 827         [in] UINT flags,
 828         [in] POINT *point
 829     );
 830 }
 831
 832 [
 833     object,
 834     uuid(ec39fa88-f8af-41c5-8421-38bed28f4673),
 835     pointer_default(unique)
 836 ]
 837 interface IShellView3 : IShellView2
 838 {
 839     [v1_enum] enum _SV3CVW3_FLAGS
 840     {
 841         SV3CVW3_DEFAULT          = 0x00000000,
 842         SV3CVW3_NONINTERACTIVE   = 0x00000001,
 843         SV3CVW3_FORCEVIEWMODE    = 0x00000002,
 844         SV3CVW3_FORCEFOLDERFLAGS = 0x00000004
 845     };
 846
 847     typedef DWORD SV3CVW3_FLAGS;
 848
 849     HRESULT CreateViewWindow3(
 850         [in] IShellBrowser *owner,
 851         [in, unique] IShellView *prev_view,
 852         [in] SV3CVW3_FLAGS view_flags,
 853         [in] FOLDERFLAGS mask,
 854         [in] FOLDERFLAGS flags,
 855         [in] FOLDERVIEWMODE mode,
 856         [in, unique] const SHELLVIEWID *view_id,
 857         [in] const RECT *rect,
 858         [out] HWND *hwnd);
 859 }
 860
 861 /*****************************************************************************
 862  * IFolderView interface
 863  */
 864 [
 865     uuid(cde725b0-ccc9-4519-917e-325d72fab4ce),
 866     object,
 867     pointer_default(unique)
 868 ]
 869 interface IFolderView : IUnknown
 870 {
 871     HRESULT GetCurrentViewMode( [out] UINT *mode );
 872     HRESULT SetCurrentViewMode( [in] UINT mode );
 873     HRESULT GetFolder( [in] REFIID riid, [out, iid_is(riid)] void **ppv );
 874     HRESULT Item(
 875         [in] int index,
 876         [out] PITEMID_CHILD *ppidl
 877     );
 878     HRESULT ItemCount(
 879         [in] UINT flags,
 880         [out] int *items
 881     );
 882     HRESULT Items(
 883         [in] UINT flags,
 884         [in] REFIID riid,
 885         [out, iid_is(riid)] void **ppv
 886     );
 887     HRESULT GetSelectionMarkedItem( [out] int *item );
 888     HRESULT GetFocusedItem( [out] int *item );
 889     HRESULT GetItemPosition(
 890         [in] PCUITEMID_CHILD pidl,
 891         [out] POINT* ppt
 892     );
 893     HRESULT GetSpacing( [in, out, unique] POINT* pt );
 894     HRESULT GetDefaultSpacing( [out] POINT* pt );
 895     HRESULT GetAutoArrange();
 896     HRESULT SelectItem(
 897         [in] int item,
 898         [in] DWORD flags
 899     );
 900     HRESULT SelectAndPositionItems(
 901         [in] UINT cidl,
 902         [in, size_is(cidl)] PCUITEMID_CHILD_ARRAY apidl,
 903         [in, unique, size_is(cidl)] POINT* apt,
 904         [in] DWORD flags
 905     );
 906 }
 907
 908 [v1_enum] enum tagSORTDIRECTION
 909 {
 910     SORT_DESCENDING = -1,
 911     SORT_ASCENDING = 1
 912 };
 913 typedef int SORTDIRECTION;
 914
 915 typedef struct SORTCOLUMN
 916 {
 917     PROPERTYKEY propkey;
 918     SORTDIRECTION direction;
 919 } SORTCOLUMN;
 920
 921 typedef [v1_enum] enum FVTEXTTYPE
 922 {
 923     FVST_EMPTYTEXT = 0
 924 } FVTEXTTYPE;
 925
 926 [
 927     uuid(1af3a467-214f-4298-908e-06b03e0b39f9),
 928     object,
 929     pointer_default(unique)
 930 ]
 931 interface IFolderView2 : IFolderView
 932 {
 933     HRESULT SetGroupBy(
 934         [in] REFPROPERTYKEY key,
 935         [in] BOOL ascending);
 936
 937     [local]
 938     HRESULT GetGroupBy(
 939         [out] PROPERTYKEY *pkey,
 940         [out] BOOL *ascending);
 941
 942     [call_as(GetGroupBy)]
 943     HRESULT RemoteGetGroupBy(
 944         [out] PROPERTYKEY *pkey,
 945         [out] BOOL *ascending);
 946
 947     HRESULT SetViewProperty(
 948         [in] PCUITEMID_CHILD pidl,
 949         [in] REFPROPERTYKEY propkey,
 950         [in] REFPROPVARIANT propvar);
 951
 952     HRESULT GetViewProperty(
 953         [in] PCUITEMID_CHILD pidl,
 954         [in] REFPROPERTYKEY propkey,
 955         [out] PROPVARIANT *propvar);
 956
 957     HRESULT SetTileViewProperties(
 958         [in] PCUITEMID_CHILD pidl,
 959         [in, string] LPCWSTR prop_list);
 960
 961     HRESULT SetExtendedTileViewProperties(
 962         [in] PCUITEMID_CHILD pidl,
 963         [in, string] LPCWSTR prop_list);
 964
 965     HRESULT SetText(
 966         [in] FVTEXTTYPE type,
 967         [in] LPCWSTR text);
 968
 969     HRESULT SetCurrentFolderFlags(
 970         [in] DWORD mask,
 971         [in] DWORD flags);
 972
 973     HRESULT GetCurrentFolderFlags([out] DWORD *flags);
 974
 975     HRESULT GetSortColumnCount([out] int *columns);
 976
 977     HRESULT SetSortColumns(
 978         [in, size_is(count)] const SORTCOLUMN *columns,
 979         [in] int count);
 980
 981     HRESULT GetSortColumns(
 982         [out, size_is(count)] SORTCOLUMN *columns,
 983         [in] int count);
 984
 985     HRESULT GetItem(
 986         [in] int ittem,
 987         [in] REFIID riid,
 988         [out, iid_is(riid)] void **ppv);
 989
 990     HRESULT GetVisibleItem(
 991         [in] int start,
 992         [in] BOOL previous,
 993         [out] int *item);
 994
 995     HRESULT GetSelectedItem(
 996         [in] int start,
 997         [out] int *item);
 998
 999     HRESULT GetSelection(
1000         [in] BOOL none_implies_folder,
1001         [out] IShellItemArray **array);
1002
1003     HRESULT GetSelectionState(
1004         [in] PCUITEMID_CHILD pidl,
1005         [out] DWORD *flags);
1006
1007     HRESULT InvokeVerbOnSelection([in, unique, string] LPCSTR verb);
1008
1009     HRESULT SetViewModeAndIconSize(
1010         [in] FOLDERVIEWMODE mode,
1011         [in] int size);
1012
1013     HRESULT GetViewModeAndIconSize(
1014         [out] FOLDERVIEWMODE *mode,
1015         [out] int *size);
1016
1017     HRESULT SetGroupSubsetCount([in] UINT visible_rows);
1018
1019     HRESULT GetGroupSubsetCount([out] UINT *visible_rows);
1020
1021     HRESULT SetRedraw([in] BOOL redraw);
1022
1023     HRESULT IsMoveInSameFolder();
1024
1025     HRESULT DoRename();
1026 }
1027
1028 /*****************************************************************************
1029  * IShellBrowser interface
1030  */
1031 [
1032     object,
1033     uuid(000214e2-0000-0000-c000-000000000046),
1034     pointer_default(unique)
1035 ]
1036 interface IShellBrowser : IOleWindow
1037 {
1038     typedef IShellBrowser *LPSHELLBROWSER;
1039
1040 cpp_quote("#define SBSP_DEFBROWSER            0x00000000")
1041 cpp_quote("#define SBSP_SAMEBROWSER           0x00000001")
1042 cpp_quote("#define SBSP_NEWBROWSER            0x00000002")
1043 cpp_quote("#define SBSP_DEFMODE               0x00000000")
1044 cpp_quote("#define SBSP_OPENMODE              0x00000010")
1045 cpp_quote("#define SBSP_EXPLOREMODE           0x00000020")
1046 cpp_quote("#define SBSP_HELPMODE              0x00000040")
1047 cpp_quote("#define SBSP_NOTRANSFERHIST        0x00000080")
1048 cpp_quote("#define SBSP_ABSOLUTE              0x00000000")
1049 cpp_quote("#define SBSP_RELATIVE              0x00001000")
1050 cpp_quote("#define SBSP_PARENT                0x00002000")
1051 cpp_quote("#define SBSP_NAVIGATEBACK          0x00004000")
1052 cpp_quote("#define SBSP_NAVIGATEFORWARD       0x00008000")
1053 cpp_quote("#define SBSP_ALLOW_AUTONAVIGATE    0x00010000")
1054 cpp_quote("#define SBSP_KEEPSAMETEMPLATE      0x00020000")
1055 cpp_quote("#define SBSP_KEEPWORDWHEELTEXT     0x00040000")
1056 cpp_quote("#define SBSP_ACTIVATE_NOFOCUS      0x00080000")
1057 cpp_quote("#define SBSP_CREATENOHISTORY       0x00100000")
1058 cpp_quote("#define SBSP_PLAYNOSOUND           0x00200000")
1059 cpp_quote("#define SBSP_CALLERUNTURUSTED      0x00800000")
1060 cpp_quote("#define SBSP_TRUSTFIRSTDOWNLOAD    0x01000000")
1061 cpp_quote("#define SBSP_UNTRUSTEDFORDOWNLOAD  0x02000000")
1062 cpp_quote("#define SBSP_NOAUTOSELECT          0x04000000")
1063 cpp_quote("#define SBSP_WRITENOHISTORY        0x08000000")
1064 cpp_quote("#define SBSP_TRUSTEDFORACTIVEX     0x10000000")
1065 cpp_quote("#define SBSP_FEEDNAVIGATION        0x20000000")
1066 cpp_quote("#define SBSP_REDIRECT              0x40000000")
1067 cpp_quote("#define SBSP_INITIATEDBYHLINKFRAME 0x80000000")
1068
1069 cpp_quote("#define FCW_STATUS      0x0001")
1070 cpp_quote("#define FCW_TOOLBAR     0x0002")
1071 cpp_quote("#define FCW_TREE        0x0003")
1072 cpp_quote("#define FCW_INTERNETBAR 0x0006")
1073 cpp_quote("#define FCW_PROGRESS    0x0008")
1074
1075 cpp_quote("#define FCT_MERGE       0x0001")
1076 cpp_quote("#define FCT_CONFIGABLE  0x0002")
1077 cpp_quote("#define FCT_ADDTOEND    0x0004")
1078
1079 cpp_quote("#if 0")
1080     typedef LPARAM LPTBBUTTONSB;
1081 cpp_quote("#else")
1082 cpp_quote("#include <commctrl.h>")
1083 cpp_quote("typedef LPTBBUTTON LPTBBUTTONSB;")
1084 cpp_quote("#endif")
1085
1086     HRESULT InsertMenusSB(
1087         [in] HMENU hmenuShared,
1088         [in, out] LPOLEMENUGROUPWIDTHS lpMenuWidths);
1089
1090     HRESULT SetMenuSB(
1091         [in] HMENU hmenuShared,
1092         [in] HOLEMENU holemenuReserved,
1093         [in] HWND hwndActiveObject);
1094
1095     HRESULT RemoveMenusSB( [in] HMENU hmenuShared );
1096     HRESULT SetStatusTextSB( [in, unique] LPCOLESTR pszStatusText );
1097     HRESULT EnableModelessSB( [in] BOOL fEnable );
1098     HRESULT TranslateAcceleratorSB( [in] MSG *pmsg, [in] WORD wID );
1099
1100     HRESULT BrowseObject(
1101         [in] LPCITEMIDLIST pidl,
1102         [in] UINT wFlags);
1103
1104     HRESULT GetViewStateStream(
1105         [in] DWORD grfMode,
1106         [out] IStream **ppStrm);
1107
1108     HRESULT GetControlWindow(
1109         [in] UINT id,
1110         [out] HWND *phwnd);
1111
1112     [local] HRESULT SendControlMsg(
1113         [in] UINT id,
1114         [in] UINT uMsg,
1115         [in] WPARAM wParam,
1116         [in] LPARAM lParam,
1117         [in] LRESULT *pret);
1118
1119     HRESULT QueryActiveShellView( [out] IShellView **ppshv );
1120     HRESULT OnViewWindowActive( [in] IShellView *pshv );
1121
1122     [local]
1123     HRESULT SetToolbarItems(
1124         [in] LPTBBUTTONSB lpButtons,
1125         [in] UINT nButtons,
1126         [in] UINT uFlags);
1127 }
1128
1129
1130 /*****************************************************************************
1131  * IShellLinkA interface
1132  */
1133 [
1134     object,
1135     uuid(000214ee-0000-0000-c000-000000000046),
1136     pointer_default(unique)
1137 ]
1138 interface IShellLinkA : IUnknown
1139 {
1140     typedef [v1_enum] enum SLR_FLAGS
1141     {
1142         SLR_NO_UI                     = 0x0001,
1143         SLR_ANY_MATCH                 = 0x0002,
1144         SLR_UPDATE                    = 0x0004,
1145         SLR_NOUPDATE                  = 0x0008,
1146         SLR_NOSEARCH                  = 0x0010,
1147         SLR_NOTRACK                   = 0x0020,
1148         SLR_NOLINKINFO                = 0x0040,
1149         SLR_INVOKE_MSI                = 0x0080,
1150         SLR_NO_UI_WITH_MSG_PUMP       = 0x0101,
1151         SLR_OFFER_DELETE_WITHOUT_FILE = 0x0200,
1152         SLR_KNOWNFOLDER               = 0x0400,
1153         SLR_MACHINE_IN_LOCAL_TARGET   = 0x0800,
1154         SLR_UPDATE_MACHINE_AND_SID    = 0x1000,
1155         SLR_NO_OBJECT_ID              = 0x2000
1156     } SLR_FLAGS;
1157
1158     typedef [v1_enum] enum SLGP_FLAGS
1159     {
1160         SLGP_SHORTPATH        = 0x0001,
1161         SLGP_UNCPRIORITY      = 0x0002,
1162         SLGP_RAWPATH          = 0x0004,
1163         SLGP_RELATIVEPRIORITY = 0x0008
1164     } SLGP_FLAGS;
1165
1166     HRESULT GetPath(
1167         [out, size_is(cch)] LPSTR pszFile,
1168         [in] int cch,
1169         [in, out, unique] WIN32_FIND_DATAA *pfd,
1170         [in] DWORD fFlags);
1171
1172     HRESULT GetIDList( [out] LPITEMIDLIST * ppidl );
1173
1174     HRESULT SetIDList( [in] LPCITEMIDLIST pidl );
1175
1176     HRESULT GetDescription(
1177         [out, size_is(cch)] LPSTR pszName,
1178         [in] int cch);
1179
1180     HRESULT SetDescription( [in] LPCSTR pszName );
1181
1182     HRESULT GetWorkingDirectory(
1183         [out, size_is(cch)] LPSTR pszDir,
1184         [in] int cch);
1185
1186     HRESULT SetWorkingDirectory( [in] LPCSTR pszDir );
1187
1188     HRESULT GetArguments(
1189         [out, size_is(cch)] LPSTR pszArgs,
1190         [in] int cch);
1191
1192     HRESULT SetArguments( [in] LPCSTR pszArgs );
1193
1194     HRESULT GetHotkey( [out] WORD *pwHotkey );
1195
1196     HRESULT SetHotkey( [in] WORD wHotkey );
1197
1198     HRESULT GetShowCmd( [out] int *piShowCmd );
1199
1200     HRESULT SetShowCmd( [in] int iShowCmd );
1201
1202     HRESULT GetIconLocation(
1203         [out, size_is(cch)] LPSTR pszIconPath,
1204         [in] int cch,
1205         [out] int *piIcon);
1206
1207     HRESULT SetIconLocation(
1208         [in] LPCSTR pszIconPath,
1209         [in] int iIcon);
1210
1211     HRESULT SetRelativePath(
1212         [in] LPCSTR pszPathRel,
1213         [in] DWORD dwReserved);
1214
1215     HRESULT Resolve(
1216         [in] HWND hwnd,
1217         [in] DWORD fFlags);
1218
1219     HRESULT SetPath( [in] LPCSTR pszFile );
1220 }
1221
1222
1223 /*****************************************************************************
1224  * IShellLinkW interface
1225  */
1226 [
1227     object,
1228     uuid(000214f9-0000-0000-c000-000000000046),
1229     pointer_default(unique)
1230 ]
1231 interface IShellLinkW : IUnknown
1232 {
1233     HRESULT GetPath(
1234         [out, size_is(cch)] LPWSTR pszFile,
1235         [in] int cch,
1236         [in, out] WIN32_FIND_DATAW *pfd,
1237         [in] DWORD fFlags);
1238
1239     HRESULT GetIDList( [out] LPITEMIDLIST * ppidl );
1240
1241     HRESULT SetIDList( [in] LPCITEMIDLIST pidl );
1242
1243     HRESULT GetDescription(
1244         [out, size_is(cch)] LPWSTR pszName,
1245         [in] int cch);
1246
1247     HRESULT SetDescription( [in] LPCWSTR pszName );
1248
1249     HRESULT GetWorkingDirectory(
1250         [out, size_is(cch)] LPWSTR pszDir,
1251         [in] int cch);
1252
1253     HRESULT SetWorkingDirectory( [in] LPCWSTR pszDir );
1254
1255     HRESULT GetArguments(
1256         [out, size_is(cch)] LPWSTR pszArgs,
1257         [in] int cch);
1258
1259     HRESULT SetArguments( [in] LPCWSTR pszArgs );
1260
1261     HRESULT GetHotkey( [out] WORD *pwHotkey );
1262
1263     HRESULT SetHotkey( [in] WORD wHotkey );
1264
1265     HRESULT GetShowCmd( [out] int *piShowCmd );
1266
1267     HRESULT SetShowCmd( [in] int iShowCmd );
1268
1269     HRESULT GetIconLocation(
1270         [out, size_is(cch)] LPWSTR pszIconPath,
1271         [in] int cch,
1272         [out] int *piIcon);
1273
1274     HRESULT SetIconLocation(
1275         [in] LPCWSTR pszIconPath,
1276         [in] int iIcon);
1277
1278     HRESULT SetRelativePath(
1279         [in] LPCWSTR pszPathRel,
1280         [in] DWORD dwReserved);
1281
1282     HRESULT Resolve(
1283         [in] HWND hwnd,
1284         [in] DWORD fFlags);
1285
1286     HRESULT SetPath( [in] LPCWSTR pszFile );
1287 }
1288
1289 cpp_quote("#define IShellLink WINELIB_NAME_AW(IShellLink)")
1290
1291
1292 /*****************************************************************************
1293  * IShellExtInit interface
1294  */
1295 [
1296     object,
1297     uuid(000214e8-0000-0000-c000-000000000046),
1298     pointer_default(unique),
1299     local
1300 ]
1301 interface IShellExtInit : IUnknown
1302 {
1303     typedef IShellExtInit *LPSHELLEXTINIT;
1304
1305     HRESULT Initialize(
1306         [in] LPCITEMIDLIST pidlFolder,
1307         [in] IDataObject *pdtobj,
1308         [in] HKEY hkeyProgID);
1309 }
1310
1311
1312 /*******************************************************************************/
1313 /* Note: the following interfaces are not in shobjidl.idl under Windows, they  */
1314 /* are declared directly in shlobj.h. It hopefully won't break anything to put */
1315 /* them here anyway.                                                           */
1316 /*******************************************************************************/
1317
1318 #ifndef MAX_PATH
1319 #define MAX_PATH 260
1320 #endif
1321
1322
1323 /*****************************************************************************
1324  * IPersistFolder3 interface
1325  */
1326 [
1327     object,
1328     uuid(cef04fdf-fe72-11d2-87a5-00c04f6837cf),
1329     pointer_default(unique)
1330 ]
1331 interface IPersistFolder3 : IPersistFolder2
1332 {
1333     typedef struct
1334     {
1335         LPITEMIDLIST    pidlTargetFolder;
1336         WCHAR           szTargetParsingName[MAX_PATH];
1337         WCHAR           szNetworkProvider[MAX_PATH];
1338         DWORD           dwAttributes;
1339         int             csidl;
1340     } PERSIST_FOLDER_TARGET_INFO;
1341
1342     HRESULT InitializeEx(
1343         [in] IBindCtx *pbc,
1344         [in] LPCITEMIDLIST pidlRoot,
1345         [in] const PERSIST_FOLDER_TARGET_INFO *ppfti);
1346
1347     HRESULT GetFolderTargetInfo( [out] PERSIST_FOLDER_TARGET_INFO *ppfti );
1348 }
1349
1350
1351 /*****************************************************************************
1352  * IExtractIconA interface
1353  */
1354 [
1355     object,
1356     uuid(000214eb-0000-0000-c000-000000000046),
1357     pointer_default(unique),
1358     local
1359 ]
1360 interface IExtractIconA : IUnknown
1361 {
1362 cpp_quote("#define GIL_OPENICON     0x0001")
1363 cpp_quote("#define GIL_FORSHELL     0x0002")
1364 cpp_quote("#define GIL_ASYNC        0x0020")
1365 cpp_quote("#define GIL_DEFAULTICON  0x0040")
1366 cpp_quote("#define GIL_FORSHORTCUT  0x0080")
1367
1368 cpp_quote("#define GIL_SIMULATEDOC  0x0001")
1369 cpp_quote("#define GIL_PERINSTANCE  0x0002")
1370 cpp_quote("#define GIL_PERCLASS     0x0004")
1371 cpp_quote("#define GIL_NOTFILENAME  0x0008")
1372 cpp_quote("#define GIL_DONTCACHE    0x0010")
1373
1374     typedef IExtractIconA *LPEXTRACTICONA;
1375
1376     HRESULT GetIconLocation(
1377         [in] UINT uFlags,
1378         [out, size_is(cchMax)] LPSTR szIconFile,
1379         [in] UINT cchMax,
1380         [out] INT *piIndex,
1381         [out] UINT *pwFlags);
1382
1383     HRESULT Extract(
1384         [in] LPCSTR pszFile,
1385         [in] UINT nIconIndex,
1386         [out] HICON *phiconLarge,
1387         [out] HICON *phiconSmall,
1388         [in] UINT nIconSize );
1389 }
1390
1391
1392 /*****************************************************************************
1393  * IExtractIconW interface
1394  */
1395 [
1396     object,
1397     uuid(000214fa-0000-0000-c000-000000000046),
1398     pointer_default(unique),
1399     local
1400 ]
1401 interface IExtractIconW : IUnknown
1402 {
1403     typedef IExtractIconW *LPEXTRACTICONW;
1404
1405     HRESULT GetIconLocation(
1406         [in] UINT uFlags,
1407         [out, size_is(cchMax)] LPWSTR szIconFile,
1408         [in] UINT cchMax,
1409         [out] INT *piIndex,
1410         [out] UINT *pwFlags);
1411
1412     HRESULT Extract(
1413         [in] LPCWSTR pszFile,
1414         [in] UINT nIconIndex,
1415         [out] HICON *phiconLarge,
1416         [out] HICON *phiconSmall,
1417         [in] UINT nIconSize );
1418 }
1419
1420 cpp_quote("#define LPEXTRACTICON WINELIB_NAME_AW(LPEXTRACTICON)")
1421 cpp_quote("#define IExtractIcon WINELIB_NAME_AW(IExtractIcon)")
1422
1423
1424 /*****************************************************************************
1425  * ICommDlgBrowser interface
1426  */
1427 [
1428     object,
1429     uuid(000214f1-0000-0000-c000-000000000046),
1430     pointer_default(unique)
1431 ]
1432 interface ICommDlgBrowser : IUnknown
1433 {
1434 cpp_quote("#define CDBOSC_SETFOCUS     0x00000000")
1435 cpp_quote("#define CDBOSC_KILLFOCUS    0x00000001")
1436 cpp_quote("#define CDBOSC_SELCHANGE    0x00000002")
1437 cpp_quote("#define CDBOSC_RENAME       0x00000003")
1438 cpp_quote("#define CDBOSC_STATECHANGE  0x00000004")
1439
1440     typedef ICommDlgBrowser *LPCOMMDLGBROWSER;
1441
1442     HRESULT OnDefaultCommand( [in] IShellView *shv );
1443     HRESULT OnStateChange( [in] IShellView *shv, [in] ULONG uChange );
1444     HRESULT IncludeObject( [in] IShellView *shv, [in] LPCITEMIDLIST pidl );
1445 }
1446
1447
1448 /*****************************************************************************
1449  * ICommDlgBrowser2 interface
1450  */
1451 [
1452  object,
1453  uuid(10339516-2894-11D2-9039-00C04F8EEB3E),
1454  pointer_default(unique)
1455 ]
1456 interface ICommDlgBrowser2 : ICommDlgBrowser
1457 {
1458
1459     HRESULT Notify(
1460         [in] IShellView *ppshv,
1461         [in] DWORD dwNotifyType);
1462
1463     HRESULT GetDefaultMenuText(
1464         [in] IShellView *ppshv,
1465         [out, string, size_is(cchMax)] LPWSTR pszText,
1466         [in] int cchMax);
1467
1468     HRESULT GetViewFlags(
1469         [out] DWORD *pdwFlags);
1470 }
1471
1472
1473 /*****************************************************************************
1474  * ICommDlgBrowser3 interface
1475  */
1476 [
1477  object,
1478  uuid(C8AD25A1-3294-41EE-8165-71174BD01C57),
1479  pointer_default(unique)
1480 ]
1481 interface ICommDlgBrowser3 : ICommDlgBrowser2
1482 {
1483
1484     HRESULT OnColumnClicked(
1485         [in] IShellView *ppshv,
1486         [in] int iColumn);
1487
1488     HRESULT GetCurrentFilter(
1489         [out, string, size_is(cchFileSpec)] LPWSTR pszFileSpec,
1490         [in] int cchFileSpec);
1491
1492     HRESULT OnPreViewCreated(
1493         [in] IShellView *ppshv);
1494 }
1495
1496 /*****************************************************************************
1497  * IDockingWindow interface
1498  */
1499 [
1500     object,
1501     uuid(012dd920-7b26-11d0-8ca9-00a0c92dbfe8)
1502 ]
1503 interface IDockingWindow : IOleWindow
1504 {
1505     HRESULT ShowDW(
1506         [in] BOOL fShow);
1507
1508     HRESULT CloseDW(
1509         [in] DWORD dwReserved);
1510
1511     HRESULT ResizeBorderDW(
1512         [in] LPCRECT prcBorder,
1513         [in] IUnknown *punkToolbarSite,
1514         [in] BOOL fReserved);
1515 }
1516
1517
1518 /*****************************************************************************
1519  * IDockingWindowFrame interface
1520  */
1521 [
1522     object,
1523     uuid(47d2657a-7b27-11d0-8ca9-00a0c92dbfe8),
1524     pointer_default(unique),
1525     local
1526 ]
1527 interface IDockingWindowFrame : IOleWindow
1528 {
1529 cpp_quote("#define DWFRF_NORMAL           0x0000")
1530 cpp_quote("#define DWFRF_DELETECONFIGDATA 0x0001")
1531 cpp_quote("#define DWFAF_HIDDEN           0x0001")
1532
1533     HRESULT AddToolbar(
1534         [in] IUnknown *punkSrc,
1535         [in] LPCWSTR pwszItem,
1536         [in] DWORD dwAddFlags);
1537
1538     HRESULT RemoveToolbar(
1539         [in] IUnknown *punkSrc,
1540         [in] DWORD dwRemoveFlags);
1541
1542     HRESULT FindToolbar(
1543         [in] LPCWSTR pwszItem,
1544         [in] REFIID riid,
1545         [out] LPVOID *ppvObj);
1546 }
1547
1548
1549 /*****************************************************************************
1550  * IDragSourceHelper interface
1551  */
1552 [
1553     object,
1554     uuid(de5bf786-477a-11d2-839d-00c04fd918d0),
1555     pointer_default(unique),
1556     local
1557 ]
1558 interface IDragSourceHelper : IUnknown
1559 {
1560     typedef struct
1561     {
1562         SIZE     sizeDragImage;
1563         POINT    ptOffset;
1564         HBITMAP  hbmpDragImage;
1565         COLORREF crColorKey;
1566     } SHDRAGIMAGE, *LPSHDRAGIMAGE;
1567
1568   HRESULT InitializeFromBitmap(
1569       [in] LPSHDRAGIMAGE pshdi,
1570       [in] IDataObject *pDataObject);
1571
1572   HRESULT InitializeFromWindow(
1573       [in] HWND hwnd,
1574       [in] POINT *ppt,
1575       [in] IDataObject *pDataObject);
1576 }
1577
1578
1579 /*****************************************************************************
1580  * IDropTargetHelper interface
1581  */
1582 [
1583     object,
1584     uuid(4657278b-411b-11d2-839a-00c04fd918d0),
1585     pointer_default(unique),
1586     local
1587 ]
1588 interface IDropTargetHelper : IUnknown
1589 {
1590     HRESULT DragEnter(
1591         [in] HWND hwndTarget,
1592         [in] IDataObject *pDataObject,
1593         [in] POINT *ppt,
1594         [in] DWORD dwEffect);
1595
1596     HRESULT DragLeave();
1597
1598     HRESULT DragOver(
1599         [in] POINT *ppt,
1600         [in] DWORD dwEffect);
1601
1602     HRESULT Drop(
1603         [in] IDataObject *pDataObject,
1604         [in] POINT *ppt,
1605         [in] DWORD dwEffect);
1606
1607     HRESULT Show( [in] BOOL fShow );
1608 }
1609
1610
1611 /*****************************************************************************
1612  * IContextMenu interface
1613  */
1614 [
1615     object,
1616     uuid(000214e4-0000-0000-c000-000000000046),
1617     pointer_default(unique),
1618     local
1619 ]
1620 interface IContextMenu : IUnknown
1621 {
1622 cpp_quote("#define CMF_NORMAL            0x00000000")
1623 cpp_quote("#define CMF_DEFAULTONLY       0x00000001")
1624 cpp_quote("#define CMF_VERBSONLY         0x00000002")
1625 cpp_quote("#define CMF_EXPLORE           0x00000004")
1626 cpp_quote("#define CMF_NOVERBS           0x00000008")
1627 cpp_quote("#define CMF_CANRENAME         0x00000010")
1628 cpp_quote("#define CMF_NODEFAULT         0x00000020")
1629 cpp_quote("#define CMF_INCLUDESTATIC     0x00000040")
1630 cpp_quote("#define CMF_ITEMMENU          0x00000080")
1631 cpp_quote("#define CMF_EXTENDEDVERBS     0x00000100")
1632 cpp_quote("#define CMF_DISABLEDVERBS     0x00000200")
1633 cpp_quote("#define CMF_ASYNCVERBSTATE    0x00000400")
1634 cpp_quote("#define CMF_OPTIMIZEFORINVOKE 0x00000800")
1635 cpp_quote("#define CMF_SYNCCASCADEMENU   0x00001000")
1636 cpp_quote("#define CMF_DONOTPICKDEFAULT  0x00002000")
1637 cpp_quote("#define CMF_RESERVED          0xffff0000")
1638
1639 cpp_quote("#define GCS_VERBA         0x00000000")
1640 cpp_quote("#define GCS_HELPTEXTA     0x00000001")
1641 cpp_quote("#define GCS_VALIDATEA     0x00000002")
1642 cpp_quote("#define GCS_VERBW         0x00000004")
1643 cpp_quote("#define GCS_HELPTEXTW     0x00000005")
1644 cpp_quote("#define GCS_VALIDATEW     0x00000006")
1645 cpp_quote("#define GCS_UNICODE       0x00000004")
1646 cpp_quote("#define GCS_VERB          WINELIB_NAME_AW(GCS_VERB)")
1647 cpp_quote("#define GCS_HELPTEXT      WINELIB_NAME_AW(GCS_HELPTEXT)")
1648 cpp_quote("#define GCS_VALIDATE      WINELIB_NAME_AW(GCS_VALIDATE)")
1649
1650 cpp_quote("#define CMDSTR_NEWFOLDERA   \"NewFolder\"")
1651 cpp_quote("#define CMDSTR_VIEWLISTA    \"ViewList\"")
1652 cpp_quote("#define CMDSTR_VIEWDETAILSA \"ViewDetails\"")
1653 cpp_quote("#if defined(__GNUC__)")
1654 cpp_quote("# define CMDSTR_NEWFOLDERW (const WCHAR []){ 'N','e','w','F','o','l','d','e','r',0 }")
1655 cpp_quote("# define CMDSTR_VIEWLISTW (const WCHAR []){ 'V','i','e','w','L','i','s','t',0 }")
1656 cpp_quote("# define CMDSTR_VIEWDETAILSW (const WCHAR []){ 'V','i','e','w','D','e','t','a','i','l','s',0 }")
1657 cpp_quote("#elif defined(_MSC_VER)")
1658 cpp_quote("# define CMDSTR_NEWFOLDERW   L\"NewFolder\"")
1659 cpp_quote("# define CMDSTR_VIEWLISTW    L\"ViewList\"")
1660 cpp_quote("# define CMDSTR_VIEWDETAILSW L\"ViewDetails\"")
1661 cpp_quote("#else")
1662 cpp_quote("static const WCHAR CMDSTR_NEWFOLDERW[] = {'N','e','w','F','o','l','d','e','r',0};")
1663 cpp_quote("static const WCHAR CMDSTR_VIEWLISTW [] = {'V','i','e','w','L','i','s','t',0};")
1664 cpp_quote("static const WCHAR CMDSTR_VIEWDETAILSW[] = {'V','i','e','w','D','e','t','a','i','l','s',0};")
1665 cpp_quote("#endif")
1666 cpp_quote("#define CMDSTR_NEWFOLDER    WINELIB_NAME_AW(CMDSTR_NEWFOLDER)")
1667 cpp_quote("#define CMDSTR_VIEWLIST     WINELIB_NAME_AW(CMDSTR_VIEWLIST)")
1668 cpp_quote("#define CMDSTR_VIEWDETAILS  WINELIB_NAME_AW(CMDSTR_VIEWDETAILS)")
1669
1670 cpp_quote("#define CMIC_MASK_HOTKEY         SEE_MASK_HOTKEY")
1671 cpp_quote("#define CMIC_MASK_ICON           SEE_MASK_ICON")
1672 cpp_quote("#define CMIC_MASK_FLAG_NO_UI     SEE_MASK_FLAG_NO_UI")
1673 cpp_quote("#define CMIC_MASK_UNICODE        SEE_MASK_UNICODE")
1674 cpp_quote("#define CMIC_MASK_NO_CONSOLE     SEE_MASK_NO_CONSOLE")
1675 cpp_quote("#define CMIC_MASK_HASLINKNAME    SEE_MASK_HASLINKNAME")
1676 cpp_quote("#define CMIC_MASK_FLAG_SEP_VDM   SEE_MASK_FLAG_SEPVDM")
1677 cpp_quote("#define CMIC_MASK_HASTITLE       SEE_MASK_HASTITLE")
1678 cpp_quote("#define CMIC_MASK_ASYNCOK        SEE_MASK_ASYNCOK")
1679 cpp_quote("#define CMIC_MASK_NOASYNC        SEE_MASK_NOASYNC")
1680 cpp_quote("#define CMIC_MASK_SHIFT_DOWN     0x10000000")
1681 cpp_quote("#define CMIC_MASK_PTINVOKE       0x20000000")
1682 cpp_quote("#define CMIC_MASK_CONTROL_DOWN   0x40000000")
1683 cpp_quote("#define CMIC_MASK_FLAG_LOG_USAGE SEE_MASK_FLAG_LOG_USAGE")
1684 cpp_quote("#define CMIC_MASK_NOZONECHECKS   SEE_MASK_NOZONECHECKS")
1685
1686     typedef IContextMenu *LPCONTEXTMENU;
1687
1688     typedef struct tagCMINVOKECOMMANDINFO
1689     {
1690         DWORD cbSize;
1691         DWORD fMask;
1692         HWND hwnd;
1693         LPCSTR lpVerb;
1694         LPCSTR lpParameters;
1695         LPCSTR lpDirectory;
1696         INT nShow;
1697         DWORD dwHotKey;
1698         HANDLE hIcon;
1699     } CMINVOKECOMMANDINFO, *LPCMINVOKECOMMANDINFO;
1700
1701     typedef struct tagCMInvokeCommandInfoEx
1702     {
1703         DWORD cbSize;
1704         DWORD fMask;
1705         HWND hwnd;
1706         LPCSTR lpVerb;
1707         LPCSTR lpParameters;
1708         LPCSTR lpDirectory;
1709         INT nShow;
1710         DWORD dwHotKey;
1711         HANDLE hIcon;
1712         LPCSTR lpTitle;
1713         LPCWSTR lpVerbW;
1714         LPCWSTR lpParametersW;
1715         LPCWSTR lpDirectoryW;
1716         LPCWSTR lpTitleW;
1717         POINT ptInvoke;
1718     } CMINVOKECOMMANDINFOEX, *LPCMINVOKECOMMANDINFOEX;
1719
1720     HRESULT QueryContextMenu(
1721         [in] HMENU hmenu,
1722         [in] UINT indexMenu,
1723         [in] UINT idCmdFirst,
1724         [in] UINT idCmdLast,
1725         [in] UINT uFlags);
1726
1727     HRESULT InvokeCommand( [in] LPCMINVOKECOMMANDINFO lpici );
1728
1729     HRESULT GetCommandString(
1730         [in] UINT_PTR idCmd,
1731         [in] UINT uType,
1732         [out] UINT *pwReserved,
1733         [out, size_is(cchMax)] LPSTR pszName,
1734         [in] UINT cchMax);
1735 }
1736
1737
1738 /*****************************************************************************
1739  * IContextMenu2 interface
1740  */
1741 [
1742     object,
1743     uuid(000214f4-0000-0000-c000-000000000046),
1744     pointer_default(unique),
1745     local
1746 ]
1747 interface IContextMenu2 : IContextMenu
1748 {
1749     typedef IContextMenu2 *LPCONTEXTMENU2;
1750
1751     HRESULT HandleMenuMsg(
1752         [in] UINT uMsg,
1753         [in] WPARAM wParam,
1754         [in] LPARAM lParam);
1755 }
1756
1757
1758 /*****************************************************************************
1759  * IContextMenu3 interface
1760  */
1761 [
1762     object,
1763     uuid(bcfce0a0-ec17-11d0-8d10-00a0c90f2719),
1764     pointer_default(unique),
1765     local
1766 ]
1767 interface IContextMenu3 : IContextMenu2
1768 {
1769     typedef IContextMenu3 *LPCONTEXTMENU3;
1770
1771     HRESULT HandleMenuMsg2(
1772         [in] UINT uMsg,
1773         [in] WPARAM wParam,
1774         [in] LPARAM lParam,
1775         [out] LRESULT *plResult);
1776 }
1777
1778
1779 [
1780     object,
1781     uuid(3409e930-5a39-11d1-83fa-00a0c90dc849),
1782     pointer_default(unique),
1783     local
1784 ]
1785 interface IContextMenuCB : IUnknown
1786 {
1787     HRESULT CallBack(
1788         [in] IShellFolder *psf,
1789         [in] HWND hwndOwner,
1790         [in] IDataObject *pdtobj,
1791         [in] UINT uMsg,
1792         [in] WPARAM wParam,
1793         [in] LPARAM lParam);
1794 }
1795
1796 /*****************************************************************************
1797  * IShellExecuteHookA interface
1798  */
1799 [
1800     object,
1801     uuid(000214f5-0000-0000-c000-000000000046),
1802     pointer_default(unique),
1803     local
1804 ]
1805 interface IShellExecuteHookA : IUnknown
1806 {
1807     cpp_quote("struct _SHELLEXECUTEINFOA;")
1808     HRESULT Execute(
1809         [in, out] struct _SHELLEXECUTEINFOA* pei);
1810 }
1811
1812
1813 /*****************************************************************************
1814  * IShellExecuteHookW interface
1815  */
1816 [
1817     object,
1818     uuid(000214fb-0000-0000-c000-000000000046),
1819     pointer_default(unique),
1820     local
1821 ]
1822 interface IShellExecuteHookW : IUnknown
1823 {
1824     cpp_quote("struct _SHELLEXECUTEINFOW;")
1825     HRESULT Execute(
1826                 [in, out] struct _SHELLEXECUTEINFOW* pei);
1827 }
1828
1829 /*****************************************************************************
1830  * IShellLinkDataList interface
1831  */
1832 [
1833     object,
1834     uuid(45e2b4ae-b1c3-11d0-b92f-00a0c90312e1),
1835     pointer_default(unique)
1836 ]
1837 interface IShellLinkDataList : IUnknown
1838 {
1839     [local] HRESULT AddDataBlock(
1840                 [in] void *pDataBlock);
1841     [local] HRESULT CopyDataBlock(
1842                 [in] DWORD dwSig,
1843                 [out] void **ppDataBlock);
1844     HRESULT RemoveDataBlock(
1845                 [in] DWORD dwSig);
1846     HRESULT GetFlags(
1847                 [out] DWORD *pdwFlags);
1848     HRESULT SetFlags(
1849                 [in] DWORD dwFlags);
1850 }
1851
1852
1853 /*****************************************************************************
1854  * IResolveShellLink interface
1855  */
1856 [
1857     object,
1858     uuid(5cd52983-9449-11d2-963a-00c04f79adf0),
1859     pointer_default(unique)
1860 ]
1861 interface IResolveShellLink : IUnknown
1862 {
1863     HRESULT ResolveShellLink(
1864                 [in] IUnknown *punk,
1865                 [in] HWND hwnd,
1866                 [in] DWORD fFlags);
1867 }
1868
1869
1870 /*****************************************************************************
1871  * IURLSearchHook interface
1872  */
1873 [
1874     object,
1875     uuid(ac60f6a0-0fd9-11d0-99cb-00c04fd64497),
1876     pointer_default(unique),
1877     local
1878 ]
1879 interface IURLSearchHook : IUnknown
1880 {
1881     HRESULT Translate(
1882                 [in, out] LPWSTR lpwszSearchURL,
1883                 [in] DWORD cchBufferSize);
1884 }
1885
1886
1887 /*****************************************************************************
1888  * ISearchContext interface
1889  */
1890 [
1891     object,
1892     uuid(09f656a2-41af-480c-88f7-16cc0d164615),
1893     pointer_default(unique),
1894     local
1895 ]
1896 interface ISearchContext : IUnknown
1897 {
1898     HRESULT GetSearchUrl(
1899                 [in] BSTR *pbstrSearchUrl);
1900     HRESULT GetSearchText(
1901                 [in] BSTR *pbstrSearchText);
1902     HRESULT GetSearchStyle(
1903                 [in] DWORD *pdwSearchStyle);
1904 }
1905
1906
1907 /*****************************************************************************
1908  * IURLSearchHook2 interface
1909  */
1910 [
1911     object,
1912     uuid(5ee44da4-6d32-46e3-86bc-07540dedd0e0),
1913     pointer_default(unique),
1914     local
1915 ]
1916 interface IURLSearchHook2 : IURLSearchHook
1917 {
1918     HRESULT TranslateWithSearchContext(
1919                 [in, out] LPWSTR lpwszSearchURL,
1920                 [in] DWORD cchBufferSize,
1921                 [in] ISearchContext *pSearchContext);
1922 }
1923
1924
1925 cpp_quote("#define INewShortcutHook WINELIB_NAME_AW(INewShortcutHook)")
1926
1927 /*****************************************************************************
1928  * INewShortcutHookA interface
1929  */
1930 [
1931     object,
1932     uuid(000214e1-0000-0000-c000-000000000046),
1933     pointer_default(unique),
1934     local
1935 ]
1936 interface INewShortcutHookA : IUnknown
1937 {
1938     HRESULT SetReferent(
1939                 [in] LPCSTR pcszReferent,
1940                 [in] HWND hwnd);
1941     HRESULT GetReferent(
1942                 [out] LPSTR pcszReferent,
1943                 [in] int cchReferent);
1944     HRESULT SetFolder(
1945                 [in] LPCSTR pcszReferent);
1946     HRESULT GetFolder(
1947                 [out] LPSTR pcszReferent,
1948                 [in] int cchFolder);
1949     HRESULT GetName(
1950                 [out] LPSTR pszName,
1951                 [in] int cchName);
1952     HRESULT GetExtension(
1953                 [out] LPSTR pszExtension,
1954                 [in] int cchExtension);
1955 }
1956
1957
1958 /*****************************************************************************
1959  * INewShortcutHookW interface
1960  */
1961 [
1962     object,
1963     uuid(000214f7-0000-0000-c000-000000000046),
1964     pointer_default(unique),
1965     local
1966 ]
1967 interface INewShortcutHookW : IUnknown
1968 {
1969     HRESULT SetReferent(
1970                 [in] LPCWSTR pcszReferent,
1971                 [in] HWND hwnd);
1972     HRESULT GetReferent(
1973                 [out] LPWSTR pcszReferent,
1974                 [in] int cchReferent);
1975     HRESULT SetFolder(
1976                 [in] LPCWSTR pcszReferent);
1977     HRESULT GetFolder(
1978                 [out] LPWSTR pcszReferent,
1979                 [in] int cchFolder);
1980     HRESULT GetName(
1981                 [out] LPWSTR pszName,
1982                 [in] int cchName);
1983     HRESULT GetExtension(
1984                 [out] LPWSTR pszExtension,
1985                 [in] int cchExtension);
1986 }
1987
1988 /*****************************************************************************
1989  * IRunnableTask interface
1990  */
1991 [
1992     object,
1993     uuid(85788d00-6807-11d0-b810-00c04fd706ec),
1994     pointer_default(unique),
1995     local
1996 ]
1997 interface IRunnableTask : IUnknown
1998 {
1999     HRESULT Run();
2000     HRESULT Kill([in] BOOL fWait);
2001     HRESULT Suspend();
2002     HRESULT Resume();
2003     ULONG IsRunning();
2004 }
2005
2006 /*****************************************************************************
2007  * IShellChangeNotify interface
2008  */
2009 [
2010     object,
2011     uuid(d82be2b1-5764-11d0-a96e-00c04fd705a2),
2012     pointer_default(unique),
2013     local
2014 ]
2015 interface IShellChangeNotify : IUnknown
2016 {
2017     HRESULT OnChange(
2018                 [in] LONG lEvent,
2019                 [in] LPCITEMIDLIST pidl1,
2020                 [in] LPCITEMIDLIST pidl2);
2021 }
2022
2023 /*****************************************************************************
2024  * IFileSystemBindData interface
2025  */
2026 [
2027     object,
2028     uuid(01e18d10-4d8b-11d2-855d-006008059367),
2029     pointer_default(unique),
2030     local
2031 ]
2032 interface IFileSystemBindData : IUnknown
2033 {
2034     HRESULT SetFindData(
2035                 [in] const WIN32_FIND_DATAW *pfd);
2036     HRESULT GetFindData(
2037                 [out] WIN32_FIND_DATAW *pfd);
2038 }
2039
2040 /*****************************************************************************
2041  *    ITaskbarList interface
2042  */
2043 [
2044     object,
2045     uuid(56FDF342-FD6D-11d0-958A-006097C9A090),
2046     pointer_default(unique)
2047 ]
2048 interface ITaskbarList : IUnknown
2049 {
2050     HRESULT HrInit();
2051
2052     HRESULT AddTab(
2053         [in] HWND hwnd);
2054
2055     HRESULT DeleteTab(
2056         [in] HWND hwnd);
2057
2058     HRESULT ActivateTab(
2059         [in] HWND hwnd);
2060
2061     HRESULT SetActiveAlt(
2062         [in] HWND hwnd);
2063 }
2064
2065 /*****************************************************************************
2066  *    ITaskbarList2 interface
2067  */
2068 [
2069     object,
2070     uuid(602D4995-B13A-429B-A66E-1935E44F4317),
2071     pointer_default(unique)
2072 ]
2073 interface ITaskbarList2 : ITaskbarList
2074 {
2075     HRESULT MarkFullscreenWindow(
2076         [in] HWND hwnd,
2077         [in] BOOL fullscreen);
2078 }
2079
2080 cpp_quote("#ifdef MIDL_PASS")
2081 typedef IUnknown* HIMAGELIST;
2082 cpp_quote("#endif")
2083
2084 typedef [v1_enum] enum THUMBBUTTONFLAGS {
2085     THBF_ENABLED         = 0x0000,
2086     THBF_DISABLED        = 0x0001,
2087     THBF_DISMISSONCLICK  = 0x0002,
2088     THBF_NOBACKGROUND    = 0x0004,
2089     THBF_HIDDEN          = 0x0008,
2090     THBF_NONINTERACTIVE  = 0x0010
2091 } THUMBBUTTONFLAGS;
2092
2093 cpp_quote("DEFINE_ENUM_FLAG_OPERATORS(THUMBBUTTONFLAGS)")
2094
2095 typedef [v1_enum] enum THUMBBUTTONMASK {
2096     THB_BITMAP   = 0x0001,
2097     THB_ICON     = 0x0002,
2098     THB_TOOLTIP  = 0x0004,
2099     THB_FLAGS    = 0x0008
2100 } THUMBBUTTONMASK;
2101
2102 cpp_quote("DEFINE_ENUM_FLAG_OPERATORS(THUMBBUTTONMASK)")
2103
2104 cpp_quote("#include <pshpack8.h>")
2105 typedef struct THUMBBUTTON {
2106     THUMBBUTTONMASK dwMask;
2107     UINT iId;
2108     UINT iBitmap;
2109     HICON hIcon;
2110     WCHAR szTip[260];
2111     THUMBBUTTONFLAGS dwFlags;
2112 } THUMBBUTTON, *LPTHUMBBUTTON;
2113 cpp_quote("#include <poppack.h>")
2114
2115 [
2116     uuid(ea1afb91-9e28-4b86-90e9-9e9f8a5eefaf),
2117     object
2118 ]
2119 interface ITaskbarList3 : ITaskbarList2
2120 {
2121     typedef [v1_enum] enum TBPFLAG {
2122         TBPF_NOPROGRESS     = 0x0000,
2123         TBPF_INDETERMINATE  = 0x0001,
2124         TBPF_NORMAL         = 0x0002,
2125         TBPF_ERROR          = 0x0004,
2126         TBPF_PAUSED         = 0x0008
2127     } TBPFLAG;
2128
2129     cpp_quote("DEFINE_ENUM_FLAG_OPERATORS(TBPFLAG)")
2130
2131     HRESULT SetProgressValue(
2132             [in] HWND hwnd,
2133             [in] ULONGLONG ullCompleted,
2134             [in] ULONGLONG ullTotal);
2135
2136     HRESULT SetProgressState(
2137             [in] HWND hwnd,
2138             [in] TBPFLAG tbpFlags);
2139
2140     HRESULT RegisterTab(
2141             [in] HWND hwndTab,
2142             [in] HWND hwndMDI);
2143
2144     HRESULT UnregisterTab([in] HWND hwndTab);
2145
2146     HRESULT SetTabOrder(
2147             [in] HWND hwndTab,
2148             [in] HWND hwndInsertBefore);
2149
2150     HRESULT SetTabActive(
2151             [in] HWND hwndTab,
2152             [in] HWND hwndMDI,
2153             [in] DWORD dwReserved);
2154
2155     HRESULT ThumbBarAddButtons(
2156             [in] HWND hwnd,
2157             [in] UINT cButtons,
2158             [in, size_is(cButtons)] LPTHUMBBUTTON pButton);
2159
2160     HRESULT ThumbBarUpdateButtons(
2161             [in] HWND hwnd,
2162             [in] UINT cButtons,
2163             [in, size_is(cButtons)] LPTHUMBBUTTON pButton);
2164
2165     HRESULT ThumbBarSetImageList(
2166             [in] HWND hwnd,
2167             [in] HIMAGELIST himl);
2168
2169     HRESULT SetOverlayIcon(
2170             [in] HWND hwnd,
2171             [in] HICON hIcon,
2172             [in, unique, string] LPCWSTR pszDescription);
2173
2174     HRESULT SetThumbnailTooltip(
2175             [in] HWND hwnd,
2176             [in, unique, string] LPCWSTR pszTip);
2177
2178     HRESULT SetThumbnailClip(
2179             [in] HWND hwnd,
2180             [in] RECT *prcClip);
2181 }
2182
2183 [
2184     uuid(c43dc798-95d1-4bea-9030-bb99e2983a1a),
2185     object
2186 ]
2187 interface ITaskbarList4 : ITaskbarList3
2188 {
2189     typedef [v1_enum] enum STPFLAG {
2190         STPF_NONE                       = 0x0000,
2191         STPF_USEAPPTHUMBNAILALWAYS      = 0x0001,
2192         STPF_USEAPPTHUMBNAILWHENACTIVE  = 0x0002,
2193         STPF_USEAPPPEEKALWAYS           = 0x0004,
2194         STPF_USEAPPPEEKWHENACTIVE       = 0x0008
2195     } STPFLAG;
2196
2197     cpp_quote("DEFINE_ENUM_FLAG_OPERATORS(STPFLAG)")
2198
2199     HRESULT SetTabProperties(
2200             [in] HWND hwndTab,
2201             [in] STPFLAG stpFlags);
2202 }
2203
2204 /*****************************************************************************
2205  *    IAutoCompleteDropDown interface
2206  */
2207 [
2208     object,
2209     uuid(3CD141F4-3C6A-11d2-BCAA-00C04FD929DB),
2210     pointer_default(unique)
2211 ]
2212 interface IAutoCompleteDropDown : IUnknown
2213 {
2214 cpp_quote("#define ACDD_VISIBLE   0x0001")
2215
2216     HRESULT GetDropDownStatus(
2217         [out] DWORD *pdwFlags,
2218         [out, string] LPWSTR *ppwszString);
2219
2220     HRESULT ResetEnumerator();
2221 }
2222
2223 [
2224     object,
2225     uuid(cb728b20-f786-11ce-92ad-00aa00a74cd0),
2226     pointer_default(unique)
2227 ]
2228 interface IProfferService : IUnknown
2229 {
2230     HRESULT ProfferService(
2231         [in] REFGUID service,
2232         [in] IServiceProvider *pService,
2233         [out] DWORD *pCookie);
2234
2235     HRESULT RevokeService([in] DWORD cookie);
2236 }
2237
2238 /*****************************************************************************
2239  * IExplorerBrowserEvents interface
2240  */
2241 [
2242  object,
2243  uuid(361BBDC7-E6EE-4E13-BE58-58E2240C810F)
2244 ]
2245 interface IExplorerBrowserEvents : IUnknown
2246 {
2247     HRESULT OnNavigationPending(
2248         [in] PCIDLIST_ABSOLUTE pidlFolder);
2249
2250     HRESULT OnViewCreated(
2251         [in] IShellView *psv);
2252
2253     HRESULT OnNavigationComplete(
2254         [in] PCIDLIST_ABSOLUTE pidlFolder);
2255
2256     HRESULT OnNavigationFailed(
2257         [in] PCIDLIST_ABSOLUTE pidlFolder);
2258 }
2259
2260 typedef GUID EXPLORERPANE;
2261 typedef EXPLORERPANE *REFEXPLORERPANE;
2262
2263 cpp_quote("#define SID_ExplorerPaneVisibility IID_IExplorerPaneVisibility")
2264
2265 /*****************************************************************************
2266  * IExplorerPaneVisibility interface
2267  */
2268 [
2269  object,
2270  uuid(E07010EC-BC17-44C0-97B0-46C7C95B9EDC)
2271 ]
2272 interface IExplorerPaneVisibility : IUnknown
2273 {
2274     [v1_enum] enum _EXPLORERPANESTATE {
2275         EPS_DONTCARE     = 0x0,
2276         EPS_DEFAULT_ON   = 0x1,
2277         EPS_DEFAULT_OFF  = 0x2,
2278         EPS_STATE_MASK   = 0xffff,
2279         EPS_INITIALSTATE = 0x10000,
2280         EPS_FORCE        = 0x20000
2281     };
2282     typedef DWORD EXPLORERPANESTATE;
2283
2284     HRESULT GetPaneState(
2285         [in] REFEXPLORERPANE ep,
2286         [out] EXPLORERPANESTATE *peps);
2287 }
2288
2289 typedef [v1_enum] enum tagEXPLORER_BROWSER_FILL_FLAGS {
2290     EBF_NONE                     = 0,
2291     EBF_SELECTFROMDATAOBJECT     = 0x100,
2292     EBF_NODROPTARGET             = 0x200
2293 } EXPLORER_BROWSER_FILL_FLAGS;
2294
2295 typedef [v1_enum] enum tagEXPLORER_BROWSER_OPTIONS {
2296     EBO_NONE               = 0x00,
2297     EBO_NAVIGATEONCE       = 0x01,
2298     EBO_SHOWFRAMES         = 0x02,
2299     EBO_ALWAYSNAVIGATE     = 0x04,
2300     EBO_NOTRAVELLOG        = 0x08,
2301     EBO_NOWRAPPERWINDOW    = 0x10,
2302     EBO_HTMLSHAREPOINTVIEW = 0x20,
2303     EBO_NOBORDER           = 0x40,
2304     EBO_NOPERSISTVIEWSTATE = 0x80,
2305 } EXPLORER_BROWSER_OPTIONS;
2306
2307 cpp_quote("#define SID_SExplorerBrowserFrame IID_ICommDlgBrowser")
2308
2309 /*****************************************************************************
2310  * IExplorerBrowser interface
2311  */
2312 [
2313  object,
2314  uuid(DFD3B6B5-C10C-4BE9-85F6-A66969F402F6),
2315  pointer_default(unique)
2316 ]
2317 interface IExplorerBrowser : IUnknown
2318 {
2319
2320     [local] HRESULT Initialize(
2321         [in] HWND hwndParent,
2322         [in] const RECT *prc,
2323         [in, unique] const FOLDERSETTINGS *pfs);
2324
2325     HRESULT Destroy();
2326
2327     [local] HRESULT SetRect(
2328         [in,out,unique] HDWP *phdwp,
2329         [in] RECT rcBrowser);
2330
2331     HRESULT SetPropertyBag(
2332         [in, string] LPCWSTR pszPropertyBag);
2333
2334     HRESULT SetEmptyText(
2335         [in, string] LPCWSTR pszEmptyText);
2336
2337     HRESULT SetFolderSettings(
2338         [in] const FOLDERSETTINGS *pfs);
2339
2340     HRESULT Advise(
2341         [in] IExplorerBrowserEvents *psbe,
2342         [out] DWORD *pdwCookie);
2343
2344     HRESULT Unadvise(
2345         [in] DWORD dwCookie);
2346
2347     HRESULT SetOptions(
2348         [in] EXPLORER_BROWSER_OPTIONS dwFlag);
2349
2350     HRESULT GetOptions(
2351         [out] EXPLORER_BROWSER_OPTIONS *pdwFlag);
2352
2353     HRESULT BrowseToIDList(
2354         [in] PCUIDLIST_RELATIVE pidl,
2355         [in] UINT uFlags);
2356
2357     HRESULT BrowseToObject(
2358         [in] IUnknown *punk,
2359         [in] UINT uFlags);
2360
2361     HRESULT FillFromObject(
2362         [in] IUnknown *punk,
2363         [in] EXPLORER_BROWSER_FILL_FLAGS dwFlags);
2364
2365     HRESULT RemoveAll();
2366
2367     HRESULT GetCurrentView(
2368         [in] REFIID riid,
2369         [out, iid_is(riid)] void **ppv);
2370 }
2371
2372 /*****************************************************************************
2373  * INameSpaceTreeControl interface
2374  */
2375 [
2376  object,
2377  uuid(028212A3-B627-47E9-8856-C14265554E4F)
2378 ]
2379 interface INameSpaceTreeControl : IUnknown
2380 {
2381     [v1_enum] enum _NSTCSTYLE {
2382         NSTCS_HASEXPANDOS                 = 0x00000001,
2383         NSTCS_HASLINES                    = 0x00000002,
2384         NSTCS_SINGLECLICKEXPAND           = 0x00000004,
2385         NSTCS_FULLROWSELECT               = 0x00000008,
2386         NSTCS_SPRINGEXPAND                = 0x00000010,
2387         NSTCS_HORIZONTALSCROLL            = 0x00000020,
2388         NSTCS_ROOTHASEXPANDO              = 0x00000040,
2389         NSTCS_SHOWSELECTIONALWAYS         = 0x00000080,
2390         NSTCS_NOINFOTIP                   = 0x00000200,
2391         NSTCS_EVENHEIGHT                  = 0x00000400,
2392         NSTCS_NOREPLACEOPEN               = 0x00000800,
2393         NSTCS_DISABLEDRAGDROP             = 0x00001000,
2394         NSTCS_NOORDERSTREAM               = 0x00002000,
2395         NSTCS_RICHTOOLTIP                 = 0x00004000,
2396         NSTCS_BORDER                      = 0x00008000,
2397         NSTCS_NOEDITLABELS                = 0x00010000,
2398         NSTCS_TABSTOP                     = 0x00020000,
2399         NSTCS_FAVORITESMODE               = 0x00080000,
2400         NSTCS_AUTOHSCROLL                 = 0x00100000,
2401         NSTCS_FADEINOUTEXPANDOS           = 0x00200000,
2402         NSTCS_EMPTYTEXT                   = 0x00400000,
2403         NSTCS_CHECKBOXES                  = 0x00800000,
2404         NSTCS_PARTIALCHECKBOXES           = 0x01000000,
2405         NSTCS_EXCLUSIONCHECKBOXES         = 0x02000000,
2406         NSTCS_DIMMEDCHECKBOXES            = 0x04000000,
2407         NSTCS_NOINDENTCHECKS              = 0x08000000,
2408         NSTCS_ALLOWJUNCTIONS              = 0x10000000,
2409         NSTCS_SHOWTABSBUTTON              = 0x20000000,
2410         NSTCS_SHOWDELETEBUTTON            = 0x40000000,
2411         NSTCS_SHOWREFRESHBUTTON      = (int)0x80000000
2412     };
2413     typedef DWORD NSTCSTYLE;
2414
2415     [v1_enum] enum _NSTCROOTSTYLE {
2416         NSTCRS_VISIBLE                    = 0x0000,
2417         NSTCRS_HIDDEN                     = 0x0001,
2418         NSTCRS_EXPANDED                   = 0x0002
2419     };
2420     typedef DWORD NSTCROOTSTYLE;
2421
2422     [v1_enum] enum _NSTCITEMSTATE {
2423         NSTCIS_NONE                       = 0x0000,
2424         NSTCIS_SELECTED                   = 0x0001,
2425         NSTCIS_EXPANDED                   = 0x0002,
2426         NSTCIS_BOLD                       = 0x0004,
2427         NSTCIS_DISABLED                   = 0x0008,
2428         NSTCIS_SELECTEDNOEXPAND           = 0x0010
2429     };
2430     typedef DWORD NSTCITEMSTATE;
2431
2432     typedef [v1_enum] enum NSTCGNI {
2433         NSTCGNI_NEXT                      = 0,
2434         NSTCGNI_NEXTVISIBLE               = 1,
2435         NSTCGNI_PREV                      = 2,
2436         NSTCGNI_PREVVISIBLE               = 3,
2437         NSTCGNI_PARENT                    = 4,
2438         NSTCGNI_CHILD                     = 5,
2439         NSTCGNI_FIRSTVISIBLE              = 6,
2440         NSTCGNI_LASTVISIBLE               = 7
2441     } NSTCGNI;
2442
2443     HRESULT Initialize(
2444         [in] HWND hwndParent,
2445         [in, unique] RECT *prc,
2446         [in] NSTCSTYLE nstcsFlags);
2447
2448     HRESULT TreeAdvise(
2449         [in] IUnknown *punk,
2450         [out] DWORD *pdwCookie);
2451
2452     HRESULT TreeUnadvise(
2453         [in] DWORD dwCookie);
2454
2455     HRESULT AppendRoot(
2456         [in] IShellItem *psiRoot,
2457         [in] SHCONTF grfEnumFlags,
2458         [in] NSTCROOTSTYLE grfRootStyle,
2459         [in, unique] IShellItemFilter *pif);
2460
2461     HRESULT InsertRoot(
2462         [in] int iIndex,
2463         [in] IShellItem *psiRoot,
2464         [in] SHCONTF grfEnumFlags,
2465         [in] NSTCROOTSTYLE grfRootStyle,
2466         [in, unique] IShellItemFilter *pif);
2467
2468     HRESULT RemoveRoot(
2469         [in] IShellItem *psiRoot);
2470
2471     HRESULT RemoveAllRoots();
2472
2473     HRESULT GetRootItems(
2474         [out] IShellItemArray **ppsiaRootItems);
2475
2476     HRESULT SetItemState(
2477         [in] IShellItem *psi,
2478         [in] NSTCITEMSTATE nstcisMask,
2479         [in] NSTCITEMSTATE nstcisFlags);
2480
2481     HRESULT GetItemState(
2482         [in] IShellItem *psi,
2483         [in] NSTCITEMSTATE nstcismask,
2484         [out] NSTCITEMSTATE *pnstcisFlags);
2485
2486     HRESULT GetSelectedItems(
2487         [out] IShellItemArray **psiaItems);
2488
2489     HRESULT GetItemCustomState(
2490         [in] IShellItem *psi,
2491         [out] int *piStateNumber);
2492
2493     HRESULT SetItemCustomState(
2494         [in] IShellItem *psi,
2495         [in] int iStateNumber);
2496
2497     HRESULT EnsureItemVisible(
2498         [in] IShellItem *psi);
2499
2500     HRESULT SetTheme(
2501         [in, string] LPCWSTR pszTheme);
2502
2503     HRESULT GetNextItem(
2504         [in, unique] IShellItem *psi,
2505         [in] NSTCGNI nstcgi,
2506         [out] IShellItem **ppsiNext);
2507
2508     HRESULT HitTest(
2509         [in] POINT *ppt,
2510         [out] IShellItem **ppsiOut);
2511
2512     HRESULT GetItemRect(
2513         [in] IShellItem *psi,
2514         [out] RECT *prect);
2515
2516     HRESULT CollapseAll();
2517 }
2518
2519 /*****************************************************************************
2520  * INameSpaceTreeControl2 interface
2521  */
2522 [
2523  object,
2524  uuid(7CC7AED8-290E-49BC-8945-C1401CC9306C)
2525 ]
2526 interface INameSpaceTreeControl2 : INameSpaceTreeControl
2527 {
2528     typedef [v1_enum] enum NSTCSTYLE2 {
2529         NSTCS2_DEFAULT                     = 0x00,
2530         NSTCS2_INTERRUPTNOTIFICATIONS      = 0x01,
2531         NSTCS2_SHOWNULLSPACEMENU           = 0x02,
2532         NSTCS2_DISPLAYPADDING              = 0x04,
2533         NSTCS2_DISPLAYPINNEDONLY           = 0x08,
2534         NTSCS2_NOSINGLETONAUTOEXPAND       = 0x10,  /* The apparent typo here is   */
2535         NTSCS2_NEVERINSERTNONENUMERATED    = 0x20   /* present also in the Win SDK */
2536     } NSTCSTYLE2;
2537     cpp_quote("DEFINE_ENUM_FLAG_OPERATORS(NSTCSTYLE2)")
2538
2539     HRESULT SetControlStyle(
2540         [in] NSTCSTYLE nstcsMask,
2541         [in] NSTCSTYLE nstcsStyle);
2542
2543     HRESULT GetControlStyle(
2544         [in] NSTCSTYLE nstcsMask,
2545         [out] NSTCSTYLE *pnstcsStyle);
2546
2547     HRESULT SetControlStyle2(
2548         [in] NSTCSTYLE2 nstcsMask,
2549         [in] NSTCSTYLE2 nstcsStyle);
2550
2551     HRESULT GetControlStyle2(
2552         [in] NSTCSTYLE2 nstcsMask,
2553         [out] NSTCSTYLE2 *pnstcsStyle);
2554 }
2555
2556 /*****************************************************************************
2557  * INameSpaceTreeControlEvents interface
2558  */
2559
2560 [
2561  object,
2562  uuid(93D77985-B3D8-4484-8318-672CDDA002CE),
2563  local
2564 ]
2565 interface INameSpaceTreeControlEvents : IUnknown
2566 {
2567     [v1_enum] enum _NSTCEHITTEST {
2568         NSTCEHT_NOWHERE                    = 0x0001,
2569         NSTCEHT_ONITEMICON                 = 0x0002,
2570         NSTCEHT_ONITEMLABEL                = 0x0004,
2571         NSTCEHT_ONITEMIDENT                = 0x0008,
2572         NSTCEHT_ONITEMBUTTON               = 0x0010,
2573         NSTCEHT_ONITEMRIGHT                = 0x0020,
2574         NSTCEHT_ONITEMSTATEICON            = 0x0040,
2575         NSTCEHT_ONITEM                     = 0x0046,
2576         NSTCEHT_ONITEMTABBUTTON            = 0x1000
2577     };
2578     typedef DWORD NSTCEHITTEST;
2579
2580     [v1_enum] enum _NSTCECLICKTYPE {
2581         NSTCECT_LBUTTON                    = 0x1,
2582         NSTCECT_MBUTTON                    = 0x2,
2583         NSTCECT_RBUTTON                    = 0x3,
2584         NSTCECT_BUTTON                     = 0x3,
2585         NSTCECT_DBLCLICK                   = 0x4
2586     };
2587     typedef DWORD NSTCECLICKTYPE;
2588
2589     HRESULT OnItemClick(
2590         [in] IShellItem *psi,
2591         [in] NSTCEHITTEST nstceHitTest,
2592         [in] NSTCECLICKTYPE nstceClickType);
2593
2594     HRESULT OnPropertyItemCommit(
2595         [in] IShellItem *psi);
2596
2597     HRESULT OnItemStateChanging(
2598         [in] IShellItem *psi,
2599         [in] NSTCITEMSTATE nstcisMask,
2600         [in] NSTCITEMSTATE nstcisState);
2601
2602     HRESULT OnItemStateChanged(
2603         [in] IShellItem *psi,
2604         [in] NSTCITEMSTATE nstcisMask,
2605         [in] NSTCITEMSTATE nstcisState);
2606
2607     HRESULT OnSelectionChanged(
2608         [in] IShellItemArray *psiaSelection);
2609
2610     HRESULT OnKeyboardInput(
2611         [in] UINT uMsg,
2612         [in] WPARAM wParam,
2613         [in] LPARAM lParam);
2614
2615     HRESULT OnBeforeExpand(
2616         [in] IShellItem *psi);
2617
2618     HRESULT OnAfterExpand(
2619         [in] IShellItem *psi);
2620
2621     HRESULT OnBeginLabelEdit(
2622         [in] IShellItem *psi);
2623
2624     HRESULT OnEndLabelEdit(
2625         [in] IShellItem *psi);
2626
2627     HRESULT OnGetToolTip(
2628         [in] IShellItem *psi,
2629         [out, string, size_is(cchTip)] LPWSTR pszTip,
2630         [in] int cchTip);
2631
2632     HRESULT OnBeforeItemDelete(
2633         [in] IShellItem *psi);
2634
2635     HRESULT OnItemAdded(
2636         [in] IShellItem *psi,
2637         [in] BOOL fIsRoot);
2638
2639     HRESULT OnItemDeleted(
2640         [in] IShellItem *psi,
2641         [in] BOOL fIsRoot);
2642
2643     HRESULT OnBeforeContextMenu(
2644         [in, unique] IShellItem *psi,
2645         [in] REFIID riid,
2646         [out, iid_is(riid)] void **ppv);
2647
2648     HRESULT OnAfterContextMenu(
2649         [in] IShellItem *psi,
2650         [in] IContextMenu *pcmIn,
2651         [in] REFIID riid,
2652         [out, iid_is(riid)] void **ppv);
2653
2654     HRESULT OnBeforeStateImageChange(
2655         [in] IShellItem *psi);
2656
2657     HRESULT OnGetDefaultIconIndex(
2658         [in] IShellItem *psi,
2659         [out] int *piDefaultIcon,
2660         [out] int *piOpenIcon);
2661 }
2662
2663 /*****************************************************************************
2664  * INameSpaceTreeControlCustomDraw interface
2665  */
2666 [
2667  object,
2668  uuid(2D3BA758-33EE-42D5-BB7B-5F3431D86C78),
2669  local
2670 ]
2671
2672 interface INameSpaceTreeControlCustomDraw : IUnknown
2673 {
2674     typedef struct NSTCCUSTOMDRAW
2675     {
2676         IShellItem *psi;
2677         UINT uItemState;
2678         NSTCITEMSTATE nstcis;
2679         LPCWSTR pszText;
2680         int iImage;
2681         HIMAGELIST himl;
2682         int iLevel;
2683         int iIndent;
2684     } NSTCCUSTOMDRAW;
2685
2686     HRESULT PrePaint(
2687         [in] HDC hdc,
2688         [in] RECT *prc,
2689         [out] LRESULT *plres);
2690
2691     HRESULT PostPaint(
2692         [in] HDC hdc,
2693         [in] RECT *prc);
2694
2695     HRESULT ItemPrePaint(
2696         [in] HDC hdc,
2697         [in] RECT *prc,
2698         [in] NSTCCUSTOMDRAW *pnstccdItem,
2699         [in, out] COLORREF *pclrText,
2700         [in, out] COLORREF *pclrTextBk,
2701         [out] LRESULT *plres);
2702
2703     HRESULT ItemPostPaint(
2704         [in] HDC hdc,
2705         [in] RECT *prc,
2706         [in] NSTCCUSTOMDRAW *pnstccdItem);
2707 }
2708
2709 /*****************************************************************************
2710  * INameSpaceTreeControlDropHandler interface
2711  */
2712 [
2713  object,
2714  uuid(F9C665D6-C2F2-4C19-BF33-8322D7352F51),
2715  local
2716 ]
2717 interface INameSpaceTreeControlDropHandler : IUnknown
2718 {
2719     HRESULT OnDragEnter(
2720         [in, unique] IShellItem *psiOver,
2721         [in] IShellItemArray *psiaData,
2722         [in] BOOL fOutsideSource,
2723         [in] DWORD grfKeyState,
2724         [in, out] DWORD *pdwEffect);
2725
2726     HRESULT OnDragOver(
2727         [in, unique] IShellItem *psiOver,
2728         [in] IShellItemArray *psiaData,
2729         [in] DWORD grfKeyState,
2730         [in, out] DWORD *pdwEffect);
2731
2732     HRESULT OnDragPosition(
2733         [in, unique] IShellItem *psiOver,
2734         [in] IShellItemArray *psiaData,
2735         [in] int iNewPosition,
2736         [in] int iOldPosition);
2737
2738     HRESULT OnDrop(
2739         [in, unique] IShellItem *psiOver,
2740         [in] IShellItemArray *psiaData,
2741         [in] int iPosition,
2742         [in] DWORD grfKeyState,
2743         [in, out] DWORD *pdwEffect);
2744
2745     HRESULT OnDropPosition(
2746         [in, unique] IShellItem *psiOver,
2747         [in] IShellItemArray *psiaData,
2748         [in] int iNewPosition,
2749         [in] int iOldPosition);
2750
2751     HRESULT OnDragLeave(
2752         [in, unique] IShellItem *psiOver);
2753 }
2754 cpp_quote("#define NSTCDHPOS_ONTOP -1")
2755
2756 interface IFileDialog;
2757
2758 typedef [v1_enum] enum FDE_OVERWRITE_RESPONSE
2759 {
2760     FDEOR_DEFAULT  = 0,
2761     FDEOR_ACCEPT   = 1,
2762     FDEOR_REFUSE   = 2
2763 } FDE_OVERWRITE_RESPONSE;
2764
2765 typedef [v1_enum] enum FDE_SHAREVIOLATION_RESPONSE
2766 {
2767     FDESVR_DEFAULT = 0,
2768     FDESVR_ACCEPT  = 1,
2769     FDESVR_REFUSE  = 2
2770 } FDE_SHAREVIOLATION_RESPONSE;
2771
2772 /*****************************************************************************
2773  * IFileDialogEvents interface
2774  */
2775 [
2776  object,
2777  uuid(973510DB-7D7F-452B-8975-74A85828D354),
2778  pointer_default(unique)
2779 ]
2780 interface IFileDialogEvents : IUnknown
2781 {
2782     HRESULT OnFileOk(
2783         [in] IFileDialog *pfd);
2784
2785     HRESULT OnFolderChanging(
2786         [in] IFileDialog *pfd,
2787         [in] IShellItem *psiFolder);
2788
2789     HRESULT OnFolderChange(
2790         [in] IFileDialog *pfd);
2791
2792     HRESULT OnSelectionChange(
2793         [in] IFileDialog *pfd);
2794
2795     HRESULT OnShareViolation(
2796         [in] IFileDialog *pfd,
2797         [in] IShellItem *psi,
2798         [out] FDE_SHAREVIOLATION_RESPONSE *pResponse);
2799
2800     HRESULT OnTypeChange(
2801         [in] IFileDialog *pfd);
2802
2803     HRESULT OnOverwrite(
2804         [in] IFileDialog *pfd,
2805         [in] IShellItem *psi,
2806         [out] FDE_OVERWRITE_RESPONSE *pResponse);
2807 }
2808
2809 /*****************************************************************************
2810  * IModalWindow interface
2811  */
2812 [
2813  object,
2814  uuid(B4DB1657-70D7-485E-8E3E-6FCB5A5C1802),
2815  pointer_default(unique)
2816 ]
2817 interface IModalWindow : IUnknown
2818 {
2819     [local]
2820     HRESULT Show(
2821         [in, unique, annotation("__in_opt")] HWND hwndOwner);
2822
2823     [call_as(Show)]
2824     HRESULT RemoteShow(
2825         [in, unique] HWND hwndOwner);
2826 }
2827
2828 typedef [v1_enum] enum FDAP
2829 {
2830     FDAP_BOTTOM    = 0,
2831     FDAP_TOP       = 1
2832 } FDAP;
2833
2834 /*****************************************************************************
2835  * IFileDialog interface
2836  */
2837 [
2838  object,
2839  uuid(42F85136-DB7E-439C-85F1-E4075D135FC8),
2840  pointer_default(unique)
2841 ]
2842 interface IFileDialog : IModalWindow
2843 {
2844     [v1_enum] enum _FILEOPENDIALOGOPTIONS
2845     {
2846         FOS_OVERWRITEPROMPT        = 0x00000002,
2847         FOS_STRICTFILETYPES        = 0x00000004,
2848         FOS_NOCHANGEDIR            = 0x00000008,
2849         FOS_PICKFOLDERS            = 0x00000020,
2850         FOS_FORCEFILESYSTEM        = 0x00000040,
2851         FOS_ALLNONSTORAGEITEMS     = 0x00000080,
2852         FOS_NOVALIDATE             = 0x00000100,
2853         FOS_ALLOWMULTISELECT       = 0x00000200,
2854         FOS_PATHMUSTEXIST          = 0x00000800,
2855         FOS_FILEMUSTEXIST          = 0x00001000,
2856         FOS_CREATEPROMPT           = 0x00002000,
2857         FOS_SHAREAWARE             = 0x00004000,
2858         FOS_NOREADONLYRETURN       = 0x00008000,
2859         FOS_NOTESTFILECREATE       = 0x00010000,
2860         FOS_HIDEMRUPLACES          = 0x00020000,
2861         FOS_HIDEPINNEDPLACES       = 0x00040000,
2862         FOS_NODEREFERENCELINKS     = 0x00100000,
2863         FOS_DONTADDTORECENT        = 0x02000000,
2864         FOS_FORCESHOWHIDDEN        = 0x10000000,
2865         FOS_DEFAULTNOMINIMODE      = 0x20000000,
2866         FOS_FORCEPREVIEWPANEON     = 0x40000000,
2867         FOS_SUPPORTSTREAMABLEITEMS = 0x80000000
2868     };
2869     typedef DWORD FILEOPENDIALOGOPTIONS;
2870
2871     HRESULT SetFileTypes(
2872         [in] UINT cFileTypes,
2873         [in, size_is(cFileTypes)] const COMDLG_FILTERSPEC *rgFilterSpec);
2874
2875     HRESULT SetFileTypeIndex(
2876         [in] UINT iFileType);
2877
2878     HRESULT GetFileTypeIndex(
2879         [out] UINT *piFileType);
2880
2881     HRESULT Advise(
2882         [in] IFileDialogEvents *pfde,
2883         [out] DWORD *pdwCookie);
2884
2885     HRESULT Unadvise(
2886         [in] DWORD dwCookie);
2887
2888     HRESULT SetOptions(
2889         [in] FILEOPENDIALOGOPTIONS fos);
2890
2891     HRESULT GetOptions(
2892         [out] FILEOPENDIALOGOPTIONS *pfos);
2893
2894     HRESULT SetDefaultFolder(
2895         [in] IShellItem *psi);
2896
2897     HRESULT SetFolder(
2898         [in] IShellItem *psi);
2899
2900     HRESULT GetFolder(
2901         [out] IShellItem **ppsi);
2902
2903     HRESULT GetCurrentSelection(
2904         [out] IShellItem **ppsi);
2905
2906     HRESULT SetFileName(
2907         [in, string] LPCWSTR pszName);
2908
2909     HRESULT GetFileName(
2910         [out, string] LPWSTR *pszName);
2911
2912     HRESULT SetTitle(
2913         [in, string] LPCWSTR pszTitle);
2914
2915     HRESULT SetOkButtonLabel(
2916         [in, string] LPCWSTR pszText);
2917
2918     HRESULT SetFileNameLabel(
2919         [in, string] LPCWSTR pszLabel);
2920
2921     HRESULT GetResult(
2922         [out] IShellItem **ppsi);
2923
2924     HRESULT AddPlace(
2925         [in] IShellItem *psi,
2926         [in] FDAP fdap);
2927
2928     HRESULT SetDefaultExtension(
2929         [in, string] LPCWSTR pszDefaultExtension);
2930
2931     HRESULT Close(
2932         [in] HRESULT hr);
2933
2934     HRESULT SetClientGuid(
2935         [in] REFGUID guid);
2936
2937     HRESULT ClearClientData();
2938
2939     HRESULT SetFilter(
2940         [in] IShellItemFilter *pFilter);
2941 }
2942
2943 /*****************************************************************************
2944  * IFileDialog2 interface
2945  */
2946 [
2947  object,
2948  uuid(61744FC7-85B5-4791-A9B0-272276309B13),
2949  pointer_default(unique)
2950 ]
2951 interface IFileDialog2 : IFileDialog
2952 {
2953     HRESULT SetCancelButtonLabel(
2954         [in] LPCWSTR pszLabel);
2955
2956     HRESULT SetNavigationRoot(
2957         [in] IShellItem *psi);
2958 }
2959
2960 /*****************************************************************************
2961  * IFileOperationProgressSink interface
2962  */
2963 [
2964  object,
2965  uuid(04B0F1A7-9490-44BC-96E1-4296A31252E2),
2966  pointer_default(unique)
2967 ]
2968 interface IFileOperationProgressSink : IUnknown
2969 {
2970     HRESULT StartOperations();
2971
2972     HRESULT FinishOperations(
2973         [in] HRESULT hrResult);
2974
2975     HRESULT PreRenameItem(
2976         [in] DWORD dwFlags,
2977         [in] IShellItem *psiItem,
2978         [in, unique, string] LPCWSTR pszNewName);
2979
2980     HRESULT PostRenameItem(
2981         [in] DWORD dwFlags,
2982         [in] IShellItem *psiItem,
2983         [in, string] LPCWSTR pszNewName,
2984         [in] HRESULT hrRename,
2985         [in] IShellItem *psiNewlyCreated);
2986
2987     HRESULT PreMoveItem(
2988         [in] DWORD dwFlags,
2989         [in] IShellItem *psiItem,
2990         [in] IShellItem *psiDestinationFolder,
2991         [in, unique, string] LPCWSTR pszNewName);
2992
2993     HRESULT PostMoveItem(
2994         [in] DWORD dwFlags,
2995         [in] IShellItem *psiItem,
2996         [in] IShellItem *psiDestinationFolder,
2997         [in, unique, string] LPCWSTR pszNewName,
2998         [in] HRESULT hrMove,
2999         [in] IShellItem *psiNewlyCreated);
3000
3001     HRESULT PreCopyItem(
3002         [in] DWORD dwFlags,
3003         [in] IShellItem *psiItem,
3004         [in] IShellItem *psiDestinationFolder,
3005         [in, unique, string] LPCWSTR pszNewName);
3006
3007     HRESULT PostCopyItem(
3008         [in] DWORD dwFlags,
3009         [in] IShellItem *psiItem,
3010         [in] IShellItem *psiDestinationFolder,
3011         [in, unique, string] LPCWSTR pszNewName,
3012         [in] HRESULT hrCopy,
3013         [in] IShellItem *psiNewlyCreated);
3014
3015     HRESULT PreDeleteItem(
3016         [in] DWORD dwFlags,
3017         [in] IShellItem *psiItem);
3018
3019     HRESULT PostDeleteItem(
3020         [in] DWORD dwFlags,
3021         [in] IShellItem *psiItem,
3022         [in] HRESULT hrDelete,
3023         [in] IShellItem *psiNewlyCreated);
3024
3025     HRESULT PreNewItem(
3026         [in] DWORD dwFlags,
3027         [in] IShellItem *psiDestinationFolder,
3028         [in, unique, string] LPCWSTR pszNewName);
3029
3030     HRESULT PostNewItem(
3031         [in] DWORD dwFlags,
3032         [in] IShellItem *psiDestinationFolder,
3033         [in, unique, string] LPCWSTR pszNewName,
3034         [in, unique, string] LPCWSTR pszTemplateName,
3035         [in] DWORD dwFileAttributes,
3036         [in] HRESULT hrNew,
3037         [in] IShellItem *psiNewItem);
3038
3039     HRESULT UpdateProgress(
3040         [in] UINT iWorkTotal,
3041         [in] UINT iWorkSoFar);
3042
3043     HRESULT ResetTimer();
3044
3045     HRESULT PauseTimer();
3046
3047     HRESULT ResumeTimer();
3048 }
3049
3050 /*****************************************************************************
3051  * IFileSaveDialog interface
3052  */
3053 [
3054  object,
3055  uuid(84BCCD23-5FDE-4CDB-AEA4-AF64B83D78AB),
3056  pointer_default(unique)
3057 ]
3058 interface IFileSaveDialog : IFileDialog
3059 {
3060     HRESULT SetSaveAsItem(
3061         [in] IShellItem *psi);
3062
3063     HRESULT SetProperties(
3064         [in] IPropertyStore *pStore);
3065
3066     HRESULT SetCollectedProperties(
3067         [in] IPropertyDescriptionList *pList,
3068         [in] BOOL fAppendDefault);
3069
3070     HRESULT GetProperties(
3071         [in] IPropertyStore **ppStore);
3072
3073     HRESULT ApplyProperties(
3074         [in] IShellItem *psi,
3075         [in] IPropertyStore *pStore,
3076         [in, unique] HWND hwnd,
3077         [in, unique] IFileOperationProgressSink *pSink);
3078 }
3079
3080
3081 /*****************************************************************************
3082  * IFileOpenDialog interface
3083  */
3084 [
3085  object,
3086  uuid(D57C7288-D4AD-4768-BE02-9D969532D960),
3087  pointer_default(unique)
3088 ]
3089 interface IFileOpenDialog : IFileDialog
3090 {
3091     HRESULT GetResults(
3092         [out] IShellItemArray **ppenum);
3093
3094     HRESULT GetSelectedItems(
3095         [out] IShellItemArray **ppsai);
3096 }
3097
3098 typedef [v1_enum] enum CDCONTROLSTATEF
3099 {
3100     CDCS_INACTIVE       = 0x0,
3101     CDCS_ENABLED        = 0x1,
3102     CDCS_VISIBLE        = 0x2,
3103     CDCS_ENABLEDVISIBLE = 0x3
3104 } CDCONTROLSTATEF;
3105 cpp_quote("DEFINE_ENUM_FLAG_OPERATORS(CDCONTROLSTATEF)")
3106 /*****************************************************************************
3107  * IFileDialogCustomize interface
3108  */
3109 [
3110  object,
3111  uuid(E6FDD21A-163F-4975-9C8C-A69F1BA37034),
3112  pointer_default(unique)
3113 ]
3114 interface IFileDialogCustomize : IUnknown
3115 {
3116     HRESULT EnableOpenDropDown(
3117         [in] DWORD dwIDCtl);
3118
3119     HRESULT AddMenu(
3120         [in] DWORD dwIDCtl,
3121         [in, string] LPCWSTR pszLabel);
3122
3123     HRESULT AddPushButton(
3124         [in] DWORD dwIDCtl,
3125         [in, string] LPCWSTR pszLabel);
3126
3127     HRESULT AddComboBox(
3128         [in] DWORD dwIDCtl);
3129
3130     HRESULT AddRadioButtonList(
3131         [in] DWORD dwIDCtl);
3132
3133     HRESULT AddCheckButton(
3134         [in] DWORD dwIDCtl,
3135         [in, string] LPCWSTR pszLabel,
3136         [in] BOOL bChecked);
3137
3138     HRESULT AddEditBox(
3139         [in] DWORD dwIDCtl,
3140         [in, string] LPCWSTR pszText);
3141
3142     HRESULT AddSeparator(
3143         [in] DWORD dwIDCtl);
3144
3145     HRESULT AddText(
3146         [in] DWORD dwIDCtl,
3147         [in, string] LPCWSTR pszText);
3148
3149     HRESULT SetControlLabel(
3150         [in] DWORD dwIDCtl,
3151         [in, string] LPCWSTR pszLabel);
3152
3153     HRESULT GetControlState(
3154         [in] DWORD dwIDCtl,
3155         [out] CDCONTROLSTATEF *pdwState);
3156
3157     HRESULT SetControlState(
3158         [in] DWORD dwIDCtl,
3159         [in] CDCONTROLSTATEF dwState);
3160
3161     HRESULT GetEditBoxText(
3162         [in] DWORD dwIDCtl,
3163         [out, string] WCHAR **ppszText);
3164
3165     HRESULT SetEditBoxText(
3166         [in] DWORD dwIDCtl,
3167         [in, string] LPCWSTR pszText);
3168
3169     HRESULT GetCheckButtonState(
3170         [in] DWORD dwIDCtl,
3171         [out] BOOL *pbChecked);
3172
3173     HRESULT SetCheckButtonState(
3174         [in] DWORD dwIDCtl,
3175         [in] BOOL bChecked);
3176
3177     HRESULT AddControlItem(
3178         [in] DWORD dwIDCtl,
3179         [in] DWORD dwIDItem,
3180         [in] LPCWSTR pszLabel);
3181
3182     HRESULT RemoveControlItem(
3183         [in] DWORD dwIDCtl,
3184         [in] DWORD dwIDItem);
3185
3186     HRESULT RemoveAllControlItems(
3187         [in] DWORD dwIDCtl);
3188
3189     HRESULT GetControlItemState(
3190         [in] DWORD dwIDCtl,
3191         [in] DWORD dwIDItem,
3192         [out] CDCONTROLSTATEF *pdwState);
3193
3194     HRESULT SetControlItemState(
3195         [in] DWORD dwIDCtl,
3196         [in] DWORD dwIDItem,
3197         [in] CDCONTROLSTATEF dwState);
3198
3199     HRESULT GetSelectedControlItem(
3200         [in] DWORD dwIDCtl,
3201         [out] DWORD *pdwIDItem);
3202
3203     HRESULT SetSelectedControlItem(
3204         [in] DWORD dwIDCtl,
3205         [in] DWORD dwIDItem);
3206
3207     HRESULT StartVisualGroup(
3208         [in] DWORD dwIDCtl,
3209         [in, string] LPCWSTR pszLabel);
3210
3211     HRESULT EndVisualGroup();
3212
3213     HRESULT MakeProminent(
3214         [in] DWORD dwIDCtl);
3215
3216     HRESULT SetControlItemText(
3217         [in] DWORD dwIDCtl,
3218         [in] DWORD dwIDItem,
3219         [in, string] LPCWSTR pszLabel);
3220 }
3221
3222 /*****************************************************************************
3223  * IFileDialogControlEvents interface
3224  */
3225 [
3226  object,
3227  uuid(36116642-D713-4B97-9B83-7484A9D00433),
3228  pointer_default(unique)
3229 ]
3230 interface IFileDialogControlEvents : IUnknown
3231 {
3232     HRESULT OnItemSelected(
3233         [in] IFileDialogCustomize *pfdc,
3234         [in] DWORD dwIDCtl,
3235         [in] DWORD dwIDItem);
3236
3237     HRESULT OnButtonClicked(
3238         [in] IFileDialogCustomize *pfdc,
3239         [in] DWORD dwIDCtl);
3240
3241     HRESULT OnCheckButtonToggled(
3242         [in] IFileDialogCustomize *pfdc,
3243         [in] DWORD dwIDCtl,
3244         [in] BOOL bChecked);
3245
3246     HRESULT OnControlActivating(
3247         [in] IFileDialogCustomize *pfdc,
3248         [in] DWORD dwIDCtl);
3249 }
3250
3251 typedef [v1_enum] enum tagKF_CATEGORY
3252 {
3253     KF_CATEGORY_VIRTUAL = 0x00000001,
3254     KF_CATEGORY_FIXED   = 0x00000002,
3255     KF_CATEGORY_COMMON  = 0x00000003,
3256     KF_CATEGORY_PERUSER = 0x00000004
3257 } KF_CATEGORY;
3258
3259 typedef [v1_enum] enum tagKF_REDIRECTION_CAPABILITIES
3260 {
3261     KF_REDIRECTION_CAPABILITIES_ALLOW_ALL               = 0x000000ff,
3262     KF_REDIRECTION_CAPABILITIES_REDIRECTABLE            = 0x00000001,
3263     KF_REDIRECTION_CAPABILITIES_DENY_ALL                = 0x000fff00,
3264     KF_REDIRECTION_CAPABILITIES_DENY_POLICY_REDIRECTED  = 0x00000100,
3265     KF_REDIRECTION_CAPABILITIES_DENY_POLICY             = 0x00000200,
3266     KF_REDIRECTION_CAPABILITIES_DENY_PERMISSIONS        = 0x00000400
3267 } KF_REDIRECTION_CAPABILITIES;
3268
3269 typedef [v1_enum] enum tagKF_DEFINITION_FLAGS
3270 {
3271     KFDF_LOCAL_REDIRECT_ONLY    = 0x00000002,
3272     KFDF_ROAMABLE               = 0x00000004,
3273     KFDF_PRECREATE              = 0x00000008,
3274     KFDF_STREAM                 = 0x00000010,
3275     KFDF_PUBLISHEXPANDEDPATH    = 0x00000020,
3276     KFDF_NO_REDIRECT_UI         = 0x00000040
3277 } KF_DEFINITION_FLAGS;
3278
3279 typedef struct tagKNOWNFOLDER_DEFINITION
3280 {
3281     KF_CATEGORY         category;
3282     LPWSTR              pszName;
3283     LPWSTR              pszDescription;
3284     KNOWNFOLDERID       fidParent;
3285     LPWSTR              pszRelativePath;
3286     LPWSTR              pszParsingName;
3287     LPWSTR              pszTooltip;
3288     LPWSTR              pszLocalizedName;
3289     LPWSTR              pszIcon;
3290     LPWSTR              pszSecurity;
3291     DWORD               dwAttributes;
3292     KF_DEFINITION_FLAGS kfdFlags;
3293     FOLDERTYPEID        ftidType;
3294 } KNOWNFOLDER_DEFINITION;
3295
3296 [
3297  object,
3298  uuid(3aa7af7e-9b36-420C-a8e3-f77d4674a488),
3299  pointer_default(ref)
3300 ]
3301 interface IKnownFolder : IUnknown
3302 {
3303     HRESULT GetId(
3304         [out] KNOWNFOLDERID *pkfid);
3305
3306     HRESULT GetCategory(
3307         [out] KF_CATEGORY *pCategory);
3308
3309     HRESULT GetShellItem(
3310         [in] DWORD dwFlags,
3311         [in] REFIID riid,
3312         [out, iid_is(riid)] void **ppv);
3313
3314     HRESULT GetPath(
3315         [in] DWORD dwFlags,
3316         [out, string] LPWSTR *ppszPath);
3317
3318     HRESULT SetPath(
3319         [in] DWORD dwFlags,
3320         [in, string] LPCWSTR pszPath);
3321
3322     HRESULT GetIDList(
3323         [in] DWORD dwFlags,
3324         [out] PIDLIST_ABSOLUTE *ppidl);
3325
3326     HRESULT GetFolderType(
3327         [out] FOLDERTYPEID *pftid);
3328
3329     HRESULT GetRedirectionCapabilities(
3330         [out] KF_REDIRECTION_CAPABILITIES *pCapabilities);
3331
3332     HRESULT GetFolderDefinition(
3333         [out] KNOWNFOLDER_DEFINITION *pKFD);
3334 }
3335
3336 typedef [v1_enum] enum tagKF_REDIRECT_FLAGS
3337 {
3338     KF_REDIRECT_USER_EXCLUSIVE      = 0x00000001,
3339     KF_REDIRECT_COPY_SOURCE_DACL    = 0x00000002,
3340     KF_REDIRECT_OWNER_USER          = 0x00000004,
3341     KF_REDIRECT_SET_OWNER_EXPLICIT  = 0x00000008,
3342     KF_REDIRECT_CHECK_ONLY          = 0x00000010,
3343     KF_REDIRECT_WITH_UI             = 0x00000020,
3344     KF_REDIRECT_UNPIN               = 0x00000040,
3345     KF_REDIRECT_PIN                 = 0x00000080,
3346     KF_REDIRECT_COPY_CONTENTS       = 0x00000200,
3347     KF_REDIRECT_DEL_SOURCE_CONTENTS = 0x00000400,
3348     KF_REDIRECT_EXCLUDE_ALL_KNOWN_SUBFOLDERS = 0x00000800
3349 } KF_REDIRECT_FLAGS;
3350
3351 [
3352     object,
3353     uuid(8BE2D872-86AA-4d47-B776-32CCA40C7018),
3354     pointer_default(ref)
3355 ]
3356 interface IKnownFolderManager : IUnknown
3357 {
3358     typedef [v1_enum] enum tagFFFP_MODE
3359     {
3360         FFFP_EXACTMATCH,
3361         FFFP_NEARESTPARENTMATCH
3362     } FFFP_MODE;
3363
3364     HRESULT FolderIdFromCsidl(
3365         [in] int nCsidl,
3366         [out] KNOWNFOLDERID *pfid);
3367
3368     HRESULT FolderIdToCsidl(
3369         [in] REFKNOWNFOLDERID rfid,
3370         [out] int *pnCsidl);
3371
3372     HRESULT GetFolderIds(
3373         [out, size_is(, *pCount)] KNOWNFOLDERID **ppKFId,
3374         [in, out] UINT *pCount);
3375
3376     HRESULT GetFolder(
3377         [in] REFKNOWNFOLDERID rfid,
3378         [out] IKnownFolder **ppkf);
3379
3380     HRESULT GetFolderByName(
3381         [in, string] LPCWSTR pszCanonicalName,
3382         [out] IKnownFolder **ppkf);
3383
3384     HRESULT RegisterFolder(
3385         [in] REFKNOWNFOLDERID rfid,
3386         [in] KNOWNFOLDER_DEFINITION const *pKFD);
3387
3388     HRESULT UnregisterFolder(
3389         [in] REFKNOWNFOLDERID rfid);
3390
3391     HRESULT FindFolderFromPath(
3392         [in, string] LPCWSTR pszPath,
3393         [in] FFFP_MODE mode,
3394         [out] IKnownFolder **ppkf);
3395
3396     HRESULT FindFolderFromIDList(
3397         [in] PCIDLIST_ABSOLUTE pidl,
3398         [out] IKnownFolder **ppkf);
3399
3400     HRESULT Redirect(
3401         [in] REFKNOWNFOLDERID rfid,
3402         [in, unique] HWND hwnd,
3403         [in] KF_REDIRECT_FLAGS flags,
3404         [in, unique, string] LPCWSTR pszTargetPath,
3405         [in] UINT cFolders,
3406         [in, size_is(cFolders), unique] KNOWNFOLDERID const *pExclusion,
3407         [out, string] LPWSTR *ppszError);
3408 }
3409
3410 /* function for releasing structure returned from IKnownFolder::GetFolderDefinition */
3411 cpp_quote("static inline void FreeKnownFolderDefinitionFields(KNOWNFOLDER_DEFINITION *pKFD)")
3412 cpp_quote("{")
3413 cpp_quote("    CoTaskMemFree(pKFD->pszName);")
3414 cpp_quote("    CoTaskMemFree(pKFD->pszDescription);")
3415 cpp_quote("    CoTaskMemFree(pKFD->pszRelativePath);")
3416 cpp_quote("    CoTaskMemFree(pKFD->pszParsingName);")
3417 cpp_quote("    CoTaskMemFree(pKFD->pszTooltip);")
3418 cpp_quote("    CoTaskMemFree(pKFD->pszLocalizedName);")
3419 cpp_quote("    CoTaskMemFree(pKFD->pszIcon);")
3420 cpp_quote("    CoTaskMemFree(pKFD->pszSecurity);")
3421 cpp_quote("}")
3422
3423 typedef [v1_enum] enum ASSOCIATIONLEVEL {
3424     AL_MACHINE,
3425     AL_EFFECTIVE,
3426     AL_USER
3427 } ASSOCIATIONLEVEL;
3428
3429 typedef [v1_enum] enum ASSOCIATIONTYPE {
3430     AT_FILEEXTENSION,
3431     AT_URLPROTOCOL,
3432     AT_STARTMENUCLIENT,
3433     AT_MIMETYPE
3434 } ASSOCIATIONTYPE;
3435
3436 [
3437     object,
3438     uuid(4e530b0a-e611-4c77-a3ac-9031d022281b),
3439     pointer_default(unique)
3440 ]
3441 interface IApplicationAssociationRegistration : IUnknown
3442 {
3443     HRESULT QueryCurrentDefault(
3444         [in, string] LPCWSTR pszQuery,
3445         [in] ASSOCIATIONTYPE atQueryType,
3446         [in] ASSOCIATIONLEVEL alQueryLevel,
3447         [out, string] LPWSTR *ppszAssociation);
3448
3449     HRESULT QueryAppIsDefault(
3450         [in, string] LPCWSTR pszQuery,
3451         [in] ASSOCIATIONTYPE atQueryType,
3452         [in] ASSOCIATIONLEVEL alQueryLevel,
3453         [in, string] LPCWSTR pszAppRegistryName,
3454         [out] BOOL *pfDefault);
3455
3456     HRESULT QueryAppIsDefaultAll(
3457         [in] ASSOCIATIONLEVEL alQueryLevel,
3458         [in, string] LPCWSTR pszAppRegistryName,
3459         [out] BOOL* pfDefault);
3460
3461     HRESULT SetAppAsDefault(
3462         [in, string] LPCWSTR pszAppRegistryName,
3463         [in, string] LPCWSTR pszSet,
3464         [in] ASSOCIATIONTYPE atSetType);
3465
3466     HRESULT SetAppAsDefaultAll(
3467         [in, string] LPCWSTR pszAppRegistryName);
3468
3469     HRESULT ClearUserAssociations();
3470 }
3471
3472 [
3473     object,
3474     uuid(12337d35-94c6-48a0-bce7-6a9c69d4d600),
3475     pointer_default(unique)
3476 ]
3477 interface IApplicationDestinations : IUnknown
3478 {
3479     HRESULT SetAppID(
3480         [in] LPCWSTR pszAppID);
3481
3482     HRESULT RemoveDestination(
3483         [in] IUnknown *punk);
3484
3485     HRESULT RemoveAllDestinations();
3486 }
3487
3488 [
3489     object,
3490     uuid(3c594f9f-9f30-47a1-979a-c9e83d3d0a06),
3491     pointer_default(unique)
3492 ]
3493 interface IApplicationDocumentLists : IUnknown
3494 {
3495     typedef [v1_enum] enum APPDOCLISTTYPE
3496     {
3497         ADLT_RECENT     = 0,
3498         ADLT_FREQUENT   = 1,
3499     } APPDOCLISTTYPE;
3500
3501     HRESULT SetAppID(
3502         [in] LPCWSTR pszAppID);
3503
3504     HRESULT GetList(
3505         [in] APPDOCLISTTYPE list_type,
3506         [in] UINT item_count,
3507         [in] REFIID riid,
3508         [out, iid_is(riid)] void **ppv);
3509 }
3510
3511 [
3512     uuid(6332debf-87b5-4670-90c0-5e57b408a49e),
3513     object,
3514     pointer_default(unique)
3515 ]
3516 interface ICustomDestinationList : IUnknown
3517 {
3518     typedef [v1_enum] enum KNOWNDESTCATEGORY {
3519         KDC_FREQUENT = 1,
3520         KDC_RECENT
3521     } KNOWNDESTCATEGORY;
3522
3523     HRESULT SetAppID([in, string] LPCWSTR pszAppID);
3524
3525     HRESULT BeginList(
3526             [out] UINT *pcMinSlots,
3527             [in] REFIID riid,
3528             [out, iid_is(riid)] void **ppv);
3529
3530     HRESULT AppendCategory(
3531             [in, string] LPCWSTR pszCategory,
3532             [in] IObjectArray *poa);
3533
3534     HRESULT AppendKnownCategory([in] KNOWNDESTCATEGORY category);
3535     HRESULT AddUserTasks([in] IObjectArray *poa);
3536     HRESULT CommitList();
3537
3538     HRESULT GetRemovedDestinations(
3539             [in] REFIID riid,
3540             [out, iid_is(riid)] void **ppv);
3541
3542     HRESULT DeleteList([in, unique, string] LPCWSTR pszAppID);
3543     HRESULT AbortList();
3544 }
3545
3546 [
3547     uuid(ddefe873-6997-4e68-be26-39b633adbe12),
3548     object,
3549     pointer_default(unique)
3550 ]
3551 interface IQueryCancelAutoPlay : IUnknown
3552 {
3553     HRESULT AllowAutoPlay([in, string] LPCWSTR path,
3554                           [in] DWORD content_type,
3555                           [in, string] LPCWSTR label,
3556                           [in] DWORD serial_number);
3557 }
3558
3559 [
3560     uuid(d594d0d8-8da7-457b-b3b4-ce5dbaac0b88),
3561     pointer_default(unique)
3562 ]
3563 interface ITransferAdviseSink : IUnknown
3564 {
3565     [v1_enum] enum _TRANSFER_ADVISE_STATE
3566     {
3567         TS_NONE          = 0,
3568         TS_PERFORMING    = 1,
3569         TS_PREPARING     = 2,
3570         TS_INDETERMINATE = 4
3571     };
3572     typedef DWORD TRANSFER_ADVISE_STATE;
3573
3574     HRESULT UpdateProgress([in] ULONGLONG size_current,
3575                            [in] ULONGLONG size_total,
3576                            [in] INT files_current,
3577                            [in] INT files_total,
3578                            [in] INT folders_current,
3579                            [in] INT folders_total);
3580     HRESULT UpdateTransferState([in] TRANSFER_ADVISE_STATE state);
3581     HRESULT ConfirmOverwrite([in] IShellItem *source,
3582                              [in] IShellItem *dest_parent,
3583                              [in, string] LPCWSTR name);
3584     HRESULT ConfirmEncryptionLoss([in] IShellItem *source);
3585     HRESULT FileFailure([in] IShellItem *item,
3586                         [in, unique, string] LPCWSTR itemname,
3587                         [in] HRESULT hr,
3588                         [in, out, unique, size_is(crename)] LPWSTR rename,
3589                         [in] ULONG crename);
3590     HRESULT SubStreamFailure([in] IShellItem *item,
3591                              [in, string] LPCWSTR stream,
3592                              [in] HRESULT hr);
3593     HRESULT PropertyFailure([in] IShellItem *item,
3594                             [in, unique] const PROPERTYKEY *key,
3595                             [in] HRESULT hr);
3596 }
3597
3598 [v1_enum] enum _TRANSFER_SOURCE_FLAGS
3599 {
3600     TSF_NORMAL                     = 0,
3601     TSF_FAIL_EXIST                 = 0,
3602     TSF_RENAME_EXIST               = 0x1,
3603     TSF_OVERWRITE_EXIST            = 0x2,
3604     TSF_ALLOW_DECRYPTION           = 0x4,
3605     TSF_NO_SECURITY                = 0x8,
3606     TSF_COPY_CREATION_TIME         = 0x10,
3607     TSF_COPY_WRITE_TIME            = 0x20,
3608     TSF_USE_FULL_ACCESS            = 0x40,
3609     TSF_DELETE_RECYCLE_IF_POSSIBLE = 0x80,
3610     TSF_COPY_HARD_LINK             = 0x100,
3611     TSF_COPY_LOCALIZED_NAME        = 0x200,
3612     TSF_MOVE_AS_COPY_DELETE        = 0x400,
3613     TSF_SUSPEND_SHELLEVENTS        = 0x800
3614 };
3615 typedef DWORD TRANSFER_SOURCE_FLAGS;
3616
3617 [
3618     uuid(00adb003-bde9-45c6-8e29-d09f9353e108),
3619     object,
3620     pointer_default(unique)
3621 ]
3622 interface ITransferSource : IUnknown
3623 {
3624     HRESULT Advise([in] ITransferAdviseSink *sink, [out] DWORD *cookie);
3625     HRESULT Unadvise([in] DWORD cookie);
3626     HRESULT SetProperties([in] IPropertyChangeArray *array);
3627     HRESULT OpenItem([in] IShellItem *item,
3628                      [in] TRANSFER_SOURCE_FLAGS flags,
3629                      [in] REFIID riid,
3630                      [out, iid_is(riid)] void **ppv);
3631     HRESULT MoveItem([in] IShellItem *item,
3632                      [in] IShellItem *parent_dest,
3633                      [in, string] LPCWSTR name_dest,
3634                      [in] TRANSFER_SOURCE_FLAGS flags,
3635                      [out] IShellItem **newitem);
3636     HRESULT RecycleItem([in] IShellItem *source,
3637                         [in] IShellItem *parent_dest,
3638                         [in] TRANSFER_SOURCE_FLAGS flags,
3639                         [out] IShellItem **new_dest);
3640     HRESULT RemoveItem([in] IShellItem *source, [in] TRANSFER_SOURCE_FLAGS flags);
3641     HRESULT RenameItem([in] IShellItem *source,
3642                        [in, string] LPCWSTR newname,
3643                        [in] TRANSFER_SOURCE_FLAGS flags,
3644                        [out] IShellItem **new_dest);
3645     HRESULT LinkItem([in] IShellItem *source,
3646                      [in] IShellItem *parent_dest,
3647                      [in, unique, string] LPCWSTR new_name,
3648                      [in] TRANSFER_SOURCE_FLAGS flags,
3649                      [out] IShellItem **new_dest);
3650     HRESULT ApplyPropertiesToItem([in] IShellItem *source, [out] IShellItem **newitem);
3651     HRESULT GetDefaultDestinationName([in] IShellItem *source,
3652                                       [in] IShellItem *parent_dest,
3653                                       [out, string] LPWSTR *dest_name);
3654     HRESULT EnterFolder([in] IShellItem *child_folder);
3655     HRESULT LeaveFolder([in] IShellItem *child_folder);
3656 }
3657
3658 [
3659     uuid(48addd32-3ca5-4124-abe3-b5a72531b207),
3660     object,
3661     pointer_default(unique)
3662 ]
3663 interface ITransferDestination : IUnknown
3664 {
3665     HRESULT Advise([in] ITransferAdviseSink *sink, [out] DWORD *cookie);
3666     HRESULT Unadvise([in] DWORD cookie);
3667     HRESULT CreateItem([in, string] LPCWSTR name,
3668                        [in] DWORD attr,
3669                        [in] ULONGLONG size,
3670                        [in] TRANSFER_SOURCE_FLAGS flags,
3671                        [in] REFIID riid,
3672                        [out, iid_is(riid)] void **ppv,
3673                        [in] REFIID resources,
3674                        [out, iid_is(riid)] void **presources);
3675 }
3676
3677 [
3678     uuid(92218cab-ecaa-4335-8133-807fd234c2ee),
3679     object,
3680     pointer_default(unique)
3681 ]
3682 interface IAssocHandlerInvoker : IUnknown
3683 {
3684     HRESULT SupportsSelection();
3685     HRESULT Invoke();
3686 }
3687
3688 [
3689     uuid(f04061ac-1659-4a3f-a954-775aa57fc083),
3690     object,
3691     pointer_default(unique)
3692 ]
3693 interface IAssocHandler : IUnknown
3694 {
3695     HRESULT GetName([out, string] LPWSTR *name);
3696     HRESULT GetUIName([out, string] LPWSTR *uiname);
3697     HRESULT GetIconLocation([out, string] LPWSTR *path,
3698                             [out] int *index);
3699     HRESULT IsRecommended();
3700     HRESULT MakeDefault([in, string] LPCWSTR description);
3701     HRESULT Invoke([in] IDataObject *object);
3702     HRESULT CreateInvoker([in] IDataObject *object,
3703                           [out] IAssocHandlerInvoker **invoker);
3704 }
3705
3706 [
3707     uuid(973810ae-9599-4b88-9e4d-6ee98c9552da),
3708     object,
3709     pointer_default(unique)
3710 ]
3711 interface IEnumAssocHandlers : IUnknown
3712 {
3713     HRESULT Next([in]  ULONG count,
3714                  [out, size_is(count), length_is(*fetched)] IAssocHandler **handlers,
3715                  [out] ULONG *fetched);
3716 }
3717
3718 typedef enum ASSOC_FILTER
3719 {
3720     ASSOC_FILTER_NONE = 0,
3721     ASSOC_FILTER_RECOMMENDED
3722 } ASSOC_FILTER;
3723 cpp_quote("HRESULT WINAPI SHAssocEnumHandlers(PCWSTR extra, ASSOC_FILTER filter, IEnumAssocHandlers **handlersenum);")
3724
3725 [
3726     uuid(1df0d7f1-b267-4d28-8b10-12e23202a5c4),
3727 ]
3728 interface IItemNameLimits : IUnknown
3729 {
3730     HRESULT GetValidCharacters(
3731         [out, string] LPWSTR *validchars,
3732         [out, string] LPWSTR *invalidchars);
3733
3734     HRESULT GetMaxLength(
3735         [in, string] LPCWSTR name,
3736         [out] int *max_length);
3737 }
3738
3739 typedef [v1_enum] enum ACTIVATEOPTIONS
3740 {
3741     AO_NONE             = 0x00000000,
3742     AO_DESIGNMODE       = 0x00000001,
3743     AO_NOERRORUI        = 0x00000002,
3744     AO_NOSPLASHSCREEN   = 0x00000004,
3745     AO_PRELAUNCH        = 0x02000000
3746 } ACTIVATEOPTIONS;
3747
3748 [
3749     uuid(2e941141-7f97-4756-ba1d-9decde894a3d),
3750     object,
3751     pointer_default(unique)
3752 ]
3753 interface IApplicationActivationManager : IUnknown
3754 {
3755     HRESULT ActivateApplication([in] LPCWSTR appusermodelid,
3756                                 [in, unique] LPCWSTR arguments,
3757                                 [in] ACTIVATEOPTIONS options,
3758                                 [out] DWORD *processid);
3759     HRESULT ActivateForFile([in] LPCWSTR appusermodelid,
3760                             [in] IShellItemArray *itemarray,
3761                             [in, unique] LPCWSTR verb,
3762                             [out] DWORD *processid);
3763     HRESULT ActivateForProtocol([in] LPCWSTR appusermodelid,
3764                                 [in] IShellItemArray *itemarray,
3765                                 [out] DWORD *processid);
3766 }
3767
3768 [
3769     object,
3770     uuid(fec87aaf-35f9-447a-adb7-20234491401a),
3771     pointer_default(unique)
3772 ]
3773 interface IPreviewHandlerFrame : IUnknown
3774 {
3775     typedef struct PREVIEWHANDLERFRAMEINFO
3776     {
3777         HACCEL haccel;
3778         UINT   cAccelEntries;
3779     } PREVIEWHANDLERFRAMEINFO;
3780
3781     HRESULT GetWindowContext([out] PREVIEWHANDLERFRAMEINFO *info);
3782     HRESULT TranslateAccelerator([in] MSG *msg);
3783 }
3784
3785 /*****************************************************************************
3786  * ShellObjects typelibrary
3787  */
3788 [
3789  uuid(50A7E9B1-70EF-11D1-B75A-00A0C90564FE),
3790  lcid(0x0000),
3791  version(1.0)
3792 ]
3793 library ShellObjects
3794 {
3795     [
3796         uuid(71F96385-DDD6-48D3-A0C1-AE06E8B055FB)
3797     ]
3798     coclass ExplorerBrowser
3799     {
3800         interface IExplorerBrowser;
3801     }
3802
3803     [
3804         uuid(DC1C5A9C-E88A-4DDE-A5A1-60F82A20AEF7)
3805     ]
3806     coclass FileOpenDialog
3807     {
3808         interface IFileOpenDialog;
3809     }
3810
3811     [
3812         uuid(C0B4E2F3-BA21-4773-8DBA-335EC946EB8B)
3813     ]
3814     coclass FileSaveDialog
3815     {
3816         interface IFileSaveDialog;
3817     }
3818
3819     [
3820         uuid(AE054212-3535-4430-83ED-D501AA6680E6)
3821     ]
3822     coclass NamespaceTreeControl
3823     {
3824         interface INameSpaceTreeControl2;
3825     }
3826
3827     [
3828         uuid(4df0c730-df9d-4ae3-9153-aa6b82e9795a)
3829     ]
3830     coclass KnownFolderManager
3831     {
3832         interface IKnownFolderManager;
3833     }
3834
3835     [
3836         uuid(591209c7-767b-42b2-9fba-44ee4615f2c7)
3837     ]
3838     coclass ApplicationAssociationRegistration
3839     {
3840         interface IApplicationAssociationRegistration;
3841     }
3842
3843     [
3844         uuid(86c14003-4d6b-4ef3-a7b4-0506663b2e68)
3845     ]
3846     coclass ApplicationDestinations
3847     {
3848         interface IApplicationDestinations;
3849     }
3850
3851     [
3852         uuid(86bec222-30f2-47e0-9f25-60d11cd75c28)
3853     ]
3854     coclass ApplicationDocumentLists
3855     {
3856         interface IApplicationDocumentLists;
3857     }
3858
3859     [
3860          uuid(00021401-0000-0000-c000-000000000046)
3861     ]
3862     coclass ShellLink
3863     {
3864         interface IShellLinkW;
3865     }
3866
3867     [
3868         uuid(56fdf344-fd6d-11d0-958a-006097c9a090)
3869     ]
3870     coclass TaskbarList
3871     {
3872         interface ITaskbarList4;
3873     }
3874
3875     [
3876         uuid(77f10cf0-3db5-4966-b520-b7c54fd35ed6)
3877     ]
3878     coclass DestinationList {
3879         interface ICustomDestinationList;
3880     }
3881
3882     [
3883         uuid(2d3468c1-36a7-43b6-ac24-d3f02fd9607a)
3884     ]
3885     coclass EnumerableObjectCollection
3886     {
3887         interface IEnumObjects;
3888     }
3889
3890     [
3891         uuid(331f1768-05a9-4ddd-b86e-dae34ddc998a)
3892     ]
3893     coclass QueryCancelAutoPlay
3894     {
3895         interface IQueryCancelAutoPlay;
3896     }
3897
3898     [
3899         uuid(45ba127d-10a8-46ea-8ab7-56ea9078943c)
3900     ]
3901     coclass ApplicationActivationManager
3902     {
3903         interface IApplicationActivationManager;
3904     }
3905
3906     [
3907         uuid(3ad05575-8857-4850-9277-11b85bdb8e09)
3908     ]
3909     coclass FileOperation
3910     {
3911         interface IFileOperation;
3912     }
3913 }
3914
3915 [v1_enum] enum _OPPROGDLGF
3916 {
3917     OPPROGDLG_DEFAULT               = 0x00000000,
3918     OPPROGDLG_ENABLEPAUSE           = 0x00000080,
3919     OPPROGDLG_ALLOWUNDO             = 0x00000100,
3920     OPPROGDLG_DONTDISPLAYSOURCEPATH = 0x00000200,
3921     OPPROGDLG_DONTDISPLAYDESTPATH   = 0x00000400,
3922     OPPROGDLG_NOMULTIDAYESTIMATES   = 0x00000800,
3923     OPPROGDLG_DONTDISPLAYLOCATIONS  = 0x00001000,
3924 };
3925 typedef DWORD OPPROGDLGF;
3926
3927 typedef [v1_enum] enum _SPACTION {
3928     SPACTION_NONE,
3929     SPACTION_MOVING,
3930     SPACTION_COPYING,
3931     SPACTION_RECYCLING,
3932     SPACTION_APPLYINGATTRIBS,
3933     SPACTION_DOWNLOADING,
3934     SPACTION_SEARCHING_INTERNET,
3935     SPACTION_CALCULATING,
3936     SPACTION_UPLOADING,
3937     SPACTION_SEARCHING_FILES,
3938     SPACTION_DELETING,
3939     SPACTION_RENAMING,
3940     SPACTION_FORMATTING,
3941     SPACTION_COPY_MOVING,
3942 } SPACTION;
3943
3944 [
3945     object,
3946     uuid(0c9fb851-e5c9-43eb-a370-f0677b13874c),
3947     pointer_default(unique)
3948 ]
3949 interface IOperationsProgressDialog : IUnknown
3950 {
3951     [v1_enum] enum _PDMODE
3952     {
3953         PDM_DEFAULT        = 0x00000000,
3954         PDM_RUN            = 0x00000001,
3955         PDM_PREFLIGHT      = 0x00000002,
3956         PDM_UNDOING        = 0x00000004,
3957         PDM_ERRORSBLOCKING = 0x00000008,
3958         PDM_INDETERMINATE  = 0x00000010,
3959     };
3960     typedef DWORD PDMODE;
3961
3962     typedef [v1_enum] enum PDOPSTATUS
3963     {
3964         PDOPS_RUNNING = 1,
3965         PDOPS_PAUSED,
3966         PDOPS_CANCELLED,
3967         PDOPS_STOPPED,
3968         PDOPS_ERRORS
3969     } PDOPSTATUS;
3970
3971     HRESULT StartProgressDialog([in, unique] HWND owner, [in] OPPROGDLGF flags);
3972     HRESULT StopProgressDialog();
3973     HRESULT SetOperation([in] SPACTION action);
3974     HRESULT SetMode([in] PDMODE mode);
3975     HRESULT UpdateProgress([in] ULONGLONG current_points, [in] ULONGLONG total_points,
3976                            [in] ULONGLONG current_size, [in] ULONGLONG total_size,
3977                            [in] ULONGLONG current_item, [in] ULONGLONG total_item);
3978     HRESULT UpdateLocations([in, unique] IShellItem *source, [in, unique] IShellItem *target,
3979                             [in, unique] IShellItem *item);
3980     HRESULT ResetTimer();
3981     HRESULT PauseTimer();
3982     HRESULT ResumeTimer();
3983     HRESULT GetMilliseconds([out] ULONGLONG *elapsed, [out] ULONGLONG *remaining);
3984     HRESULT GetOperationStatus([out] PDOPSTATUS *status);
3985 }
3986
3987 [
3988     object,
3989     uuid(947aab5f-0a5c-4c13-b4d6-4bf7836fc9f8),
3990     pointer_default(unique)
3991 ]
3992 interface IFileOperation : IUnknown
3993 {
3994     HRESULT Advise([in] IFileOperationProgressSink *sink, [out] DWORD *cookie);
3995     HRESULT Unadvise([in] DWORD cookie);
3996     HRESULT SetOperationFlags([in] DWORD flags);
3997     HRESULT SetProgressMessage([in, string] LPCWSTR message);
3998     HRESULT SetProgressDialog([in] IOperationsProgressDialog *dialog);
3999     HRESULT SetProperties([in] IPropertyChangeArray *array);
4000     HRESULT SetOwnerWindow([in] HWND owner);
4001     HRESULT ApplyPropertiesToItem([in] IShellItem *item);
4002     HRESULT ApplyPropertiesToItems([in] IUnknown *items);
4003     HRESULT RenameItem([in] IShellItem *item, [in, string] LPCWSTR name,
4004                        [in, unique] IFileOperationProgressSink *sink);
4005     HRESULT RenameItems([in] IUnknown *items, [in, string] LPCWSTR name);
4006     HRESULT MoveItem([in] IShellItem *item, [in] IShellItem *folder,
4007                      [in, unique, string] LPCWSTR name,
4008                      [in, unique] IFileOperationProgressSink *sink);
4009     HRESULT MoveItems([in] IUnknown *items, [in] IShellItem *folder);
4010     HRESULT CopyItem([in] IShellItem *item, [in] IShellItem *folder,
4011                      [in, unique, string] LPCWSTR name,
4012                      [in, unique] IFileOperationProgressSink *sink);
4013     HRESULT CopyItems([in] IUnknown *items, [in] IShellItem *folder);
4014     HRESULT DeleteItem([in] IShellItem *item,
4015                        [in, unique] IFileOperationProgressSink *sink);
4016     HRESULT DeleteItems([in] IUnknown *items);
4017     HRESULT NewItem([in] IShellItem *folder, [in] DWORD attributes,
4018                     [in, unique, string] LPCWSTR name, [in, unique, string] LPCWSTR template_name,
4019                     [in, unique] IFileOperationProgressSink *sink);
4020     HRESULT PerformOperations();
4021     HRESULT GetAnyOperationsAborted([out] BOOL *aborted);
4022 }