开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 游戏 > 模拟服务器 > 查看源码
ShObjIdl.idl
资源名称：SwordOnline.rar　[点击查看]
上传用户：dzyhzl
上传日期：2019-04-29
资源大小：56270k
文件大小：78k
源码类别：

模拟服务器

开发平台：

C/C++

ShObjIdl.idl：源码内容
  1. //
  2. //  Microsoft Windows
  3. //  Copyright (c) Microsoft Corporation. All rights reserved.
  4. //
  5. //  File: shobjidl.idl
  6. //
  7. //  Contents: This interface definition contains shell objects that can be remoted
  8. //
  11. import "objidl.idl";
  12. import "oleidl.idl";
  13. import "oaidl.idl";
  14. import "shtypes.idl";
  15. import "servprov.idl";
  16. import "comcat.idl";        // for IEnumGUID
  17. import "propidl.idl";
  18. import "prsht.idl";
  19. import "msxml.idl";
  21. cpp_quote("#ifndef _WINRESRC_")
  22. cpp_quote("#ifndef _WIN32_IE")
  23. cpp_quote("#define _WIN32_IE 0x0501")
  24. cpp_quote("#else")
  25. cpp_quote("#if (_WIN32_IE < 0x0400) && defined(_WIN32_WINNT) && (_WIN32_WINNT >= 0x0500)")
  26. cpp_quote("#error _WIN32_IE setting conflicts with _WIN32_WINNT setting")
  27. cpp_quote("#endif")
  28. cpp_quote("#endif")
  29. cpp_quote("#endif")
  31. // IPersistFolder
  32. [
  33.     object,
  34.     uuid(000214EA-0000-0000-C000-000000000046),  // IID_IPersistFolder
  35.     pointer_default(unique),
  36. ]
  37. interface IPersistFolder : IPersist
  38. {
  39.     // IShellFolder::BindToObject when it is initializing a shell folder object.")
  40.     // called when the explorer is initializing a shell folder object.
  41.     // pidl -- Specifies the absolute location of the folder
  42.     HRESULT Initialize([in] LPCITEMIDLIST pidl);
  43. };
  45. typedef IPersistFolder *LPPERSISTFOLDER;
  47. cpp_quote("#if (_WIN32_IE >= 0x0400)")
  49. // IPersistFolder2
  50. [
  51.     object,
  52.     uuid(1AC3D9F0-175C-11d1-95BE-00609797EA4F),  // IID_IPersistFolder2
  53.     pointer_default(unique),
  54. ]
  55. interface IPersistFolder2 : IPersistFolder
  56. {
  57.     HRESULT GetCurFolder([out] LPITEMIDLIST *ppidl);
  58. };
  60. typedef IPersistFolder2 *LPPERSISTFOLDER2;
  62. cpp_quote("#endif")
  64. [
  65.     object,
  66.     uuid(1079acfc-29bd-11d3-8e0d-00c04f6837d5),  // IID_IPersistIDList
  67.     pointer_default(unique),
  68. ]
  69. interface IPersistIDList : IPersist
  70. {
  71.     // sets or gets a fully qualifed idlist for an object
  72.     HRESULT SetIDList([in] LPCITEMIDLIST pidl);
  73.     HRESULT GetIDList([out] LPITEMIDLIST *ppidl);
  74. };
  75.     
  76. [
  77.     helpstring("IEnumIDList "),
  78.     uuid(000214F2-0000-0000-C000-000000000046),
  79.     object,
  80.     pointer_default(unique)
  81. ]
  82. interface IEnumIDList : IUnknown
  83. {
  84.     HRESULT Next(
  85.         [in] ULONG celt,
  86.         [out, size_is(celt), length_is(*pceltFetched)] LPITEMIDLIST *rgelt,
  87.         [out] ULONG *pceltFetched);
  88.         
  89.     HRESULT Skip([in] ULONG celt);
  90.     HRESULT Reset();
  91.     HRESULT Clone([out] IEnumIDList **ppenum);
  92. };
  94. typedef IEnumIDList *LPENUMIDLIST;
  96. // IShellFolder::GetDisplayNameOf/SetNameOf uFlags                                      
  97. cpp_quote("typedef enum tagSHGDN")
  98. cpp_quote("{")
  99. cpp_quote("    SHGDN_NORMAL             = 0x0000,  // default (display purpose)")
  100. cpp_quote("    SHGDN_INFOLDER           = 0x0001,  // displayed under a folder (relative)")
  101. cpp_quote("    SHGDN_FOREDITING         = 0x1000,  // for in-place editing")
  102. cpp_quote("    SHGDN_FORADDRESSBAR      = 0x4000,  // UI friendly parsing name (remove ugly stuff)")
  103. cpp_quote("    SHGDN_FORPARSING         = 0x8000,  // parsing name for ParseDisplayName()")
  104. cpp_quote("} SHGNO;")
  106. typedef DWORD SHGDNF;
  108. // IShellFolder::EnumObjects grfFlags bits
  109. cpp_quote("typedef enum tagSHCONTF")
  110. cpp_quote("{")
  111. cpp_quote("    SHCONTF_FOLDERS             = 0x0020,   // only want folders enumerated (SFGAO_FOLDER)")
  112. cpp_quote("    SHCONTF_NONFOLDERS          = 0x0040,   // include non folders")
  113. cpp_quote("    SHCONTF_INCLUDEHIDDEN       = 0x0080,   // show items normally hidden")
  114. cpp_quote("    SHCONTF_INIT_ON_FIRST_NEXT  = 0x0100,   // allow EnumObject() to return before validating enum")
  115. cpp_quote("    SHCONTF_NETPRINTERSRCH      = 0x0200,   // hint that client is looking for printers")
  116. cpp_quote("    SHCONTF_SHAREABLE           = 0x0400,   // hint that client is looking sharable resources (remote shares)")
  117. cpp_quote("    SHCONTF_STORAGE             = 0x0800,   // include all items with accessible storage and their ancestors")
  118. cpp_quote("};")
  119. typedef DWORD SHCONTF;
  121. // IShellFolder::CompareIDs lParam flags
  122. //
  123. //  SHCIDS_ALLFIELDS is a mask for lParam indicating that the shell folder
  124. //  should first compare on the lParam column, and if that proves equal,
  125. //  then perform a full comparison on all fields.  This flag is supported
  126. //  if the IShellFolder supports IShellFolder2.
  127. //
  128. //  SHCIDS_CANONICALONLY is a mask for lParam indicating that the shell folder
  129. //  that the caller doesn't care about proper sort order -- only equality matters.
  130. //  (Most CompareIDs test for equality first, and in the case of inequality do
  131. //  a UI sort.  This bit allows for a more efficient sort in the inequality case.)
  132. //
  133. //
  135. cpp_quote("#define SHCIDS_ALLFIELDS        0x80000000L")
  136. cpp_quote("#define SHCIDS_CANONICALONLY    0x10000000L")
  137. cpp_quote("#define SHCIDS_BITMASK          0xFFFF0000L")
  138. cpp_quote("#define SHCIDS_COLUMNMASK       0x0000FFFFL")
  140. // IShellFolder::GetAttributesOf flags
  141. // SFGAO_CANLINK: If this bit is set on an item in the shell folder, a
  142. //            'Create Shortcut' menu item will be added to the File
  143. //            menu and context menus for the item.  If the user selects
  144. //            that command, your IContextMenu::InvokeCommand() will be called
  145. //            with 'link'.
  146. //                 That flag will also be used to determine if 'Create Shortcut'
  147. //            should be added when the item in your folder is dragged to another
  148. //            folder.
  149. cpp_quote("#define SFGAO_CANCOPY           DROPEFFECT_COPY // Objects can be copied    (0x1)")
  150. cpp_quote("#define SFGAO_CANMOVE           DROPEFFECT_MOVE // Objects can be moved     (0x2)")
  151. cpp_quote("#define SFGAO_CANLINK           DROPEFFECT_LINK // Objects can be linked    (0x4)")
  152. cpp_quote("#define SFGAO_STORAGE           0x00000008L     // supports BindToObject(IID_IStorage)")
  153. cpp_quote("#define SFGAO_CANRENAME         0x00000010L     // Objects can be renamed")
  154. cpp_quote("#define SFGAO_CANDELETE         0x00000020L     // Objects can be deleted")
  155. cpp_quote("#define SFGAO_HASPROPSHEET      0x00000040L     // Objects have property sheets")
  156. //         unused                          0x00000080
  157. cpp_quote("#define SFGAO_DROPTARGET        0x00000100L     // Objects are drop target")
  158. cpp_quote("#define SFGAO_CAPABILITYMASK    0x00000177L")
  159. //         unused                          0x00000200
  160. //         unused                          0x00000400
  161. //         unused                          0x00000800
  162. //         unused                          0x00001000
  163. cpp_quote("#define SFGAO_ENCRYPTED         0x00002000L     // object is encrypted (use alt color)")
  164. cpp_quote("#define SFGAO_ISSLOW            0x00004000L     // 'slow' object")
  165. cpp_quote("#define SFGAO_GHOSTED           0x00008000L     // ghosted icon")
  166. cpp_quote("#define SFGAO_LINK              0x00010000L     // Shortcut (link)")
  167. cpp_quote("#define SFGAO_SHARE             0x00020000L     // shared")
  168. cpp_quote("#define SFGAO_READONLY          0x00040000L     // read-only")
  169. cpp_quote("#define SFGAO_HIDDEN            0x00080000L     // hidden object")
  170. cpp_quote("#define SFGAO_DISPLAYATTRMASK   0x000FC000L")
  171. cpp_quote("#define SFGAO_FILESYSANCESTOR   0x10000000L     // may contain children with SFGAO_FILESYSTEM")
  172. cpp_quote("#define SFGAO_FOLDER            0x20000000L     // support BindToObject(IID_IShellFolder)")
  173. cpp_quote("#define SFGAO_FILESYSTEM        0x40000000L     // is a win32 file system object (file/folder/root)")
  174. cpp_quote("#define SFGAO_HASSUBFOLDER      0x80000000L     // may contain children with SFGAO_FOLDER")
  175. cpp_quote("#define SFGAO_CONTENTSMASK      0x80000000L")
  176. cpp_quote("#define SFGAO_VALIDATE          0x01000000L     // invalidate cached information")
  177. cpp_quote("#define SFGAO_REMOVABLE         0x02000000L     // is this removeable media?")
  178. cpp_quote("#define SFGAO_COMPRESSED        0x04000000L     // Object is compressed (use alt color)")
  179. cpp_quote("#define SFGAO_BROWSABLE         0x08000000L     // supports IShellFolder, but only implements CreateViewObject() (non-folder view)")
  180. cpp_quote("#define SFGAO_NONENUMERATED     0x00100000L     // is a non-enumerated object")
  181. cpp_quote("#define SFGAO_NEWCONTENT        0x00200000L     // should show bold in explorer tree")
  182. cpp_quote("#define SFGAO_CANMONIKER        0x00400000L     // defunct")
  183. cpp_quote("#define SFGAO_HASSTORAGE        0x00400000L     // defunct")
  184. cpp_quote("#define SFGAO_STREAM            0x00400000L     // supports BindToObject(IID_IStream)")
  185. cpp_quote("#define SFGAO_STORAGEANCESTOR   0x00800000L     // may contain children with SFGAO_STORAGE or SFGAO_STREAM")
  186. cpp_quote("#define SFGAO_STORAGECAPMASK    0x70C50008L     // for determining storage capabilities, ie for open/save semantics")
  188. typedef ULONG SFGAOF;
  190. //      passed to ISF::ParseDisplayName() or ISF::BindToObject() via IBindCtx::RegisterObjectParam()
  191. // * IPersist must be supported by the ObjectParam
  192. // the CLSID returned by IPersist::GetCLSID() should be skipped
  193. // in the binding process. used to avoid loops or to allow delegation to
  194. // base name space functionality. see SHSkipJunction()
  195. cpp_quote("#define STR_SKIP_BINDING_CLSID      L"Skip Binding CLSID"")
  197. //      passed to SHGetDesktopFolder()->ParseDisplayName() via IBindCtx::RegisterObjectParam()
  198. // * no interface support required on object param
  199. // instructing to prefer folder support for URLs.  specifically used by the common
  200. // dialog to make it use the DAV NP when parsing http: URLs.
  201. cpp_quote("#define STR_PARSE_PREFER_FOLDER_BROWSING     L"Parse Prefer Folder Browsing"")
  203. //      passed to SHGetDesktopFolder()->ParseDisplayName() via IBindCtx::RegisterObjectParam()
  204. // instructing to fail parsing relative paths.  only succeeds for fully qualified paths/urls.
  205. // * no interface support required on object param
  206. // 
  207. //      eg. even if "foo.txt" is a child of the desktop, it will still fail
  208. //  but it will succeed for "C:Documents and SettingsUsernameDesktopfoo.txt"
  209. cpp_quote("#define STR_DONT_PARSE_RELATIVE              L"Don't Parse Relative"")
  211. //      passed to SHGetDesktopFolder()->ParseDisplayName() via IBindCtx::RegisterObjectParam()
  212. // to try translate from a full file system pidl to a alias to that pidl, if available.  
  213. // * no interface support required on object param
  214. //
  215. //      eg.  if you pass the following path "C:Documents and SettingsUsernameDesktopfoo.txt"
  216. // if TRANSLATE is SET result is: [foo.txt] (the alias for the desktop being an empty pidl) 
  217. // if TRANSLATE is NOT SET result is: [CLSID_MyComputer][c:][Documents and Settings][Username][Desktop][foo.txt].
  218. cpp_quote("#define STR_PARSE_TRANSLATE_ALIASES          L"Parse Translate Aliases"")
  220. interface IShellFolder;
  221. [
  222.     helpstring("IShellFolder"),
  223.     uuid(000214E6-0000-0000-C000-000000000046),
  224.     object,
  225.     pointer_default(unique)
  226. ]
  228. interface IShellFolder : IUnknown
  229. {
  230.     HRESULT ParseDisplayName(
  231.         [in] HWND hwnd, 
  232.         [in] LPBC pbc, 
  233.         [in, string] LPOLESTR pszDisplayName,
  234.         [out] ULONG *pchEaten, 
  235.         [out] LPITEMIDLIST *ppidl, 
  236.         [in, out, unique] ULONG *pdwAttributes);
  238.     HRESULT EnumObjects(
  239.         [in] HWND hwnd, 
  240.         [in] SHCONTF grfFlags, 
  241.         [out] IEnumIDList **ppenumIDList);
  243.     //  returns an instance of a sub-folder which is specified by the IDList (pidl).
  244.     HRESULT BindToObject(
  245.         [in] LPCITEMIDLIST pidl, 
  246.         [in] LPBC pbc, 
  247.         [in] REFIID riid, 
  248.         [out, iid_is(riid)] void **ppv);
  249.         
  250.     HRESULT BindToStorage(
  251.         [in] LPCITEMIDLIST pidl, 
  252.         [in] LPBC pbc, 
  253.         [in] REFIID riid, 
  254.         [out, iid_is(riid)] void **ppv);
  255.         
  256.     //  compares two IDLists and returns the result. The shell
  257.     //  explorer always passes 0 as lParam, which indicates 'sort by name'.
  258.     //  It should return 0 (as CODE of the scode), if two id indicates the
  259.     //  same object; negative value if pidl1 should be placed before pidl2;
  260.     //  positive value if pidl2 should be placed before pidl1.
  261.     HRESULT CompareIDs(
  262.         [in] LPARAM lParam, 
  263.         [in] LPCITEMIDLIST pidl1, 
  264.         [in] LPCITEMIDLIST pidl2);
  265.     
  266.     //  creates a view object of the folder itself. The view
  267.     //  object is a difference instance from the shell folder object.
  268.     //   'hwndOwner' can be used  as the owner window of its dialog box or
  269.     //  menu during the lifetime of the view object.
  270.     //  This member function should always create a new
  271.     //  instance which has only one reference count. The explorer may create
  272.     //  more than one instances of view object from one shell folder object
  273.     //  and treat them as separate instances.
  274.     HRESULT CreateViewObject(
  275.         [in] HWND hwndOwner, 
  276.         [in] REFIID riid, 
  277.         [out, iid_is(riid)] void **ppv);
  279.     //  returns the attributes of specified objects in that
  280.     //  folder. 'cidl' and 'apidl' specifies objects. 'apidl' contains only
  281.     //  simple IDLists. The explorer initializes *prgfInOut with a set of
  282.     //  flags to be evaluated. The shell folder may optimize the operation
  283.     //  by not returning unspecified flags.
  284.     HRESULT GetAttributesOf(
  285.         [in] UINT cidl, 
  286.         [in, size_is(cidl)] LPCITEMIDLIST * apidl, 
  287.         [in, out] SFGAOF * rgfInOut);
  289.     //  creates a UI object to be used for specified objects.
  290.     //  The shell explorer passes either IID_IDataObject (for transfer operation)
  291.     //  or IID_IContextMenu (for context menu operation) as riid.
  292.     HRESULT GetUIObjectOf(
  293.         [in] HWND hwndOwner, 
  294.         [in] UINT cidl, 
  295.         [in, size_is(cidl)] LPCITEMIDLIST * apidl,
  296.         [in] REFIID riid, 
  297.         [in, out, unique] UINT * rgfReserved,
  298.         [out, iid_is(riid)] void **ppv);
  300.     //  returns the display name of the specified object.
  301.     //  If the ID contains the display name (in the locale character set),
  302.     //  it returns the offset to the name. Otherwise, it returns a pointer
  303.     //  to the display name string (UNICODE), which is allocated by the
  304.     //  task allocator, or fills in a buffer.
  305.     HRESULT GetDisplayNameOf(
  306.         [in] LPCITEMIDLIST pidl, 
  307.         [in] SHGDNF uFlags, 
  308.         [out] STRRET *pName);
  310.     //  sets the display name of the specified object.
  311.     //  If it changes the ID as well, it returns the new ID which is
  312.     //  alocated by the task allocator.
  313.     HRESULT SetNameOf(
  314.         [in] HWND hwnd, 
  315.         [in] LPCITEMIDLIST pidl, 
  316.         [in, string] LPCOLESTR pszName, 
  317.         [in] SHGDNF uFlags, 
  318.         [out] LPITEMIDLIST *ppidlOut);
  319. };
  321. typedef IShellFolder * LPSHELLFOLDER;
  324. cpp_quote("#if (_WIN32_IE >= 0x0500)")
  326. typedef struct tagEXTRASEARCH
  327. {
  328.     GUID    guidSearch;
  329.     WCHAR   wszFriendlyName[80];
  330.     WCHAR   wszUrl[2084];
  331. }EXTRASEARCH, *LPEXTRASEARCH;
  333. typedef struct IEnumExtraSearch *LPENUMEXTRASEARCH;
  335. interface IShellFolder2;    // forward
  337. [
  338.     helpstring("IEnumExtraSearch"),
  339.     uuid(0E700BE1-9DB6-11d1-A1CE-00C04FD75D13),
  340.     object,
  341.     pointer_default(unique)
  342. ]
  343. interface IEnumExtraSearch : IUnknown
  344. {
  345.     HRESULT Next(
  346.         [in] ULONG celt,
  347.         [out, size_is(celt), length_is(*pceltFetched)] EXTRASEARCH *rgelt,
  348.         [out] ULONG *pceltFetched);
  350.     HRESULT Skip([in] ULONG celt);
  351.     HRESULT Reset();
  352.     HRESULT Clone([out] IEnumExtraSearch **ppenum);
  353. };
  355. // IShellFolder2::GetDefaultColumnState values
  357. typedef [v1_enum] enum {
  358.     SHCOLSTATE_TYPE_STR      = 0x00000001,
  359.     SHCOLSTATE_TYPE_INT      = 0x00000002,
  360.     SHCOLSTATE_TYPE_DATE     = 0x00000003,
  361.     SHCOLSTATE_TYPEMASK      = 0x0000000F,
  362.     SHCOLSTATE_ONBYDEFAULT   = 0x00000010,   // should on by default in details view
  363.     SHCOLSTATE_SLOW          = 0x00000020,   // will be slow to compute, do on a background thread
  364.     SHCOLSTATE_EXTENDED      = 0x00000040,   // provided by a handler, not the folder
  365.     SHCOLSTATE_SECONDARYUI   = 0x00000080,   // not displayed in context menu, but listed in the "More..." dialog
  366.     SHCOLSTATE_HIDDEN        = 0x00000100,   // not displayed in the UI
  367.     SHCOLSTATE_PREFER_VARCMP = 0x00000200,   // VarCmp() (with folderness test) produces same result as CompareIDs()
  368. } SHCOLSTATE;
  370. typedef DWORD SHCOLSTATEF; 
  372. typedef struct {
  373.     GUID fmtid;
  374.     DWORD pid;
  375. } SHCOLUMNID, *LPSHCOLUMNID;
  376. typedef const SHCOLUMNID* LPCSHCOLUMNID;
  378. [
  379.     helpstring("IShellFolder2"),
  380.     uuid(93F2F68C-1D1B-11d3-A30E-00C04F79ABD1),
  381.     object,
  382.     pointer_default(unique)
  383. ]
  384. interface IShellFolder2 : IShellFolder
  385. {
  386.     // Returns the guid of the search that is to be invoked when user clicks 
  387.     // on the search toolbar button
  388.     HRESULT GetDefaultSearchGUID([out] GUID *pguid);
  389.     // gives an enumerator of the searches to be added to the search menu
  390.     HRESULT EnumSearches([out] IEnumExtraSearch **ppenum);
  391.     HRESULT GetDefaultColumn([in] DWORD dwRes, [out] ULONG *pSort, [out] ULONG *pDisplay);
  392.     // return SHCOLSTATE_ values
  393.     HRESULT GetDefaultColumnState([in] UINT iColumn, [out] SHCOLSTATEF *pcsFlags);
  394.     HRESULT GetDetailsEx([in] LPCITEMIDLIST pidl, [in] const SHCOLUMNID *pscid, [out] VARIANT *pv);
  395.     HRESULT GetDetailsOf([in] LPCITEMIDLIST pidl, [in]UINT iColumn, [out] SHELLDETAILS *psd);
  396.     HRESULT MapColumnToSCID([in] UINT iColumn, [in] SHCOLUMNID *pscid);
  397. };
  399. cpp_quote("#endif // _WIN32_IE >= 0x0500)")
  403. //--------------------------------------------------------------------------
  404. //
  405. // FOLDERSETTINGS
  406. //
  407. //  FOLDERSETTINGS is a data structure that explorer passes from one folder
  408. // view to another, when the user is browsing. It calls ISV::GetCurrentInfo
  409. // member to get the current settings and pass it to ISV::CreateViewWindow
  410. // to allow the next folder view 'inherit' it. These settings assumes a
  411. // particular UI (which the shell's folder view has), and shell extensions
  412. // may or may not use those settings.
  413. //
  414. //--------------------------------------------------------------------------
  415. typedef char * LPVIEWSETTINGS;
  417. // NB Bitfields.
  418. // FWF_DESKTOP implies FWF_TRANSPARENT/NOCLIENTEDGE/NOSCROLL
  420. typedef [v1_enum] enum
  421.     {
  422.     FWF_AUTOARRANGE =       0x00000001,
  423.     FWF_ABBREVIATEDNAMES =  0x00000002,
  424.     FWF_SNAPTOGRID =        0x00000004,
  425.     FWF_OWNERDATA =         0x00000008,
  426.     FWF_BESTFITWINDOW =     0x00000010,
  427.     FWF_DESKTOP =           0x00000020,
  428.     FWF_SINGLESEL =         0x00000040,
  429.     FWF_NOSUBFOLDERS =      0x00000080,
  430.     FWF_TRANSPARENT  =      0x00000100,
  431.     FWF_NOCLIENTEDGE =      0x00000200,
  432.     FWF_NOSCROLL     =      0x00000400,
  433.     FWF_ALIGNLEFT    =      0x00000800,
  434.     FWF_NOICONS      =      0x00001000,
  435.     FWF_SHOWSELALWAYS =     0x00002000,
  436.     FWF_NOVISIBLE    =      0X00004000,
  437.     FWF_SINGLECLICKACTIVATE=0x00008000,     // TEMPORARY -- NO UI FOR THIS
  438.     FWF_NOWEBVIEW =         0x00010000,
  439.     FWF_HIDEFILENAMES =     0x00020000,
  440.     FWF_CHECKSELECT =       0x00040000,
  441.     } FOLDERFLAGS;
  443. typedef [v1_enum] enum
  444.     {
  445.     FVM_FIRST =             1,
  446.     FVM_ICON =              1,
  447.     FVM_SMALLICON =         2,
  448.     FVM_LIST =              3,
  449.     FVM_DETAILS =           4,
  450.     FVM_THUMBNAIL =         5,
  451.     FVM_TILE =              6,
  452.     FVM_THUMBSTRIP =        7,
  453.     FVM_LAST =              7,
  454.     } FOLDERVIEWMODE;
  456. typedef struct
  457.     {
  458.     UINT ViewMode;       // View mode (FOLDERVIEWMODE values)
  459.     UINT fFlags;         // View options (FOLDERFLAGS bits)
  460.     } FOLDERSETTINGS;
  462. typedef FOLDERSETTINGS *LPFOLDERSETTINGS;                
  463. typedef const FOLDERSETTINGS * LPCFOLDERSETTINGS;
  464. typedef FOLDERSETTINGS *PFOLDERSETTINGS;                
  466. //==========================================================================
  467. //
  468. // Interface:   IShellView
  469. //
  470. // IShellView::GetWindow(phwnd)
  471. //
  472. //   Inherited from IOleWindow::GetWindow.
  473. //
  474. //
  475. // IShellView::ContextSensitiveHelp(fEnterMode)
  476. //
  477. //   Inherited from IOleWindow::ContextSensitiveHelp.
  478. //
  479. //
  480. // IShellView::TranslateAccelerator(lpmsg)
  481. //
  482. //   Similar to IOleInPlaceActiveObject::TranlateAccelerator. The explorer
  483. //  calls this function BEFORE any other translation. Returning S_OK
  484. //  indicates that the message was translated (eaten) and should not be
  485. //  translated or dispatched by the explorer.
  486. //
  487. //
  488. // IShellView::EnableModeless(fEnable)
  489. //   Similar to IOleInPlaceActiveObject::EnableModeless.
  490. //
  491. //
  492. // IShellView::UIActivate(uState)
  493. //
  494. //   The explorer calls this member function whenever the activation
  495. //  state of the view window is changed by a certain event that is
  496. //  NOT caused by the shell view itself.
  497. //
  498. //   SVUIA_DEACTIVATE will be passed when the explorer is about to
  499. //  destroy the shell view window; the shell view is supposed to remove
  500. //  all the extended UIs (typically merged menu and modeless popup windows).
  501. //
  502. //   SVUIA_ACTIVATE_NOFOCUS will be passsed when the shell view is losing
  503. //  the input focus or the shell view has been just created without the
  504. //  input focus; the shell view is supposed to set menuitems appropriate
  505. //  for non-focused state (no selection specific items should be added).
  506. //
  507. //   SVUIA_ACTIVATE_FOCUS will be passed when the explorer has just
  508. //  created the view window with the input focus; the shell view is
  509. //  supposed to set menuitems appropriate for focused state.
  510. //
  511. //   SVUIA_INPLACEACTIVATE(new) will be passed when the shell view is opened
  512. //  within an ActiveX control, which is not a UI active. In this case,
  513. //  the shell view should not merge menus or put toolbas. To be compatible
  514. //  with Win95 client, we don't pass this value unless the view supports
  515. //  IShellView2.
  516. //
  517. //   The shell view should not change focus within this member function.
  518. //  The shell view should not hook the WM_KILLFOCUS message to remerge
  519. //  menuitems. However, the shell view typically hook the WM_SETFOCUS
  520. //  message, and re-merge the menu after calling IShellBrowser::
  521. //  OnViewWindowActivated.
  522. //
  523. //   One of the ACTIVATE / INPLACEACTIVATE messages will be sent when
  524. //  the view window becomes the currently displayed view.  On Win95 systems,
  525. //  this will happen immediately after the CreateViewWindow call.  On IE4, Win98,
  526. //  and NT5 systems this may happen when the view reports it is ready (if the
  527. //  IShellView supports async creation).  This can be used as a hint as to when
  528. //  to make your view window visible.  Note: the Win95/Win98/NT4 common dialogs
  529. //  do not send either of these on creation.
  530. //
  531. //
  532. // IShellView::Refresh()
  533. //
  534. //   The explorer calls this member when the view needs to refresh its
  535. //  contents (such as when the user hits F5 key).
  536. //
  537. //
  538. // IShellView::CreateViewWindow
  539. //
  540. //   This member creates the view window (right-pane of the explorer or the
  541. //  client window of the folder window).
  542. //
  543. //
  544. // IShellView::DestroyViewWindow
  545. //
  546. //   This member destroys the view window.
  547. //
  548. //
  549. // IShellView::GetCurrentInfo
  550. //
  551. //   This member returns the folder settings.
  552. //
  553. //
  554. // IShellView::AddPropertySHeetPages
  555. //
  556. //   The explorer calls this member when it is opening the option property
  557. //  sheet. This allows the view to add additional pages to it.
  558. //
  559. //
  560. // IShellView::SaveViewState()
  561. //
  562. //   The explorer calls this member when the shell view is supposed to
  563. //  store its view settings. The shell view is supposed to get a view
  564. //  stream by calling IShellBrowser::GetViewStateStream and store the
  565. //  current view state into that stream.
  566. //
  567. //
  568. // IShellView::SelectItem(pidlItem, uFlags)
  569. //
  570. //   The explorer calls this member to change the selection state of
  571. //  item(s) within the shell view window.  If pidlItem is NULL and uFlags
  572. //  is SVSI_DESELECTOTHERS, all items should be deselected.
  573. //
  574. //-------------------------------------------------------------------------
  576. //
  577. // shellview select item flags
  578. //
  579. cpp_quote("#define SVSI_DESELECT       0x00000000")
  580. cpp_quote("#define SVSI_SELECT         0x00000001")
  581. cpp_quote("#define SVSI_EDIT           0x00000003  // includes select")
  582. cpp_quote("#define SVSI_DESELECTOTHERS 0x00000004")
  583. cpp_quote("#define SVSI_ENSUREVISIBLE  0x00000008")
  584. cpp_quote("#define SVSI_FOCUSED        0x00000010")
  585. cpp_quote("#define SVSI_TRANSLATEPT    0x00000020")
  586. cpp_quote("#define SVSI_SELECTIONMARK  0x00000040")
  587. cpp_quote("#define SVSI_POSITIONITEM   0x00000080")
  588. cpp_quote("#define SVSI_CHECK          0x00000100")
  589. cpp_quote("#define SVSI_NOSTATECHANGE  0x80000000")
  590. typedef UINT SVSIF;
  592. //
  593. // shellview get item object flags
  594. //
  595. typedef [v1_enum] enum {
  596.     SVGIO_BACKGROUND        = 0x00000000,
  597.     SVGIO_SELECTION         = 0x00000001,
  598.     SVGIO_ALLVIEW           = 0x00000002,
  599.     SVGIO_CHECKED           = 0x00000003,
  600.     SVGIO_TYPE_MASK         = 0x0000000F,
  601.     SVGIO_FLAG_VIEWORDER    = 0x80000000,
  602. } SVGIO;
  604. //
  605. // uState values for IShellView::UIActivate
  606. //
  607. typedef [v1_enum] enum {
  608.     SVUIA_DEACTIVATE       = 0,
  609.     SVUIA_ACTIVATE_NOFOCUS = 1,
  610.     SVUIA_ACTIVATE_FOCUS   = 2,
  611.     SVUIA_INPLACEACTIVATE  = 3          // new flag for IShellView2
  612. } SVUIA_STATUS;
  614. //  this is to handle name collisions 
  615. cpp_quote("#ifdef _FIX_ENABLEMODELESS_CONFLICT")
  616. cpp_quote("#define    EnableModeless EnableModelessSV")
  617. cpp_quote("#endif")
  619. //
  620. //  this is so that all the implementations still get the function pointer.
  621. //  and midl wont complain about the data type
  622. //
  623. cpp_quote("#ifdef _NEVER_")
  624. typedef LPARAM LPFNSVADDPROPSHEETPAGE;
  625. cpp_quote("#else //!_NEVER_")
  626. cpp_quote("#include <prsht.h>")
  627. cpp_quote("typedef LPFNADDPROPSHEETPAGE LPFNSVADDPROPSHEETPAGE;")
  628. cpp_quote("#endif //_NEVER_")
  630. interface IShellBrowser;
  632. [
  633.     helpstring("IShellView"),
  634.     uuid(000214E3-0000-0000-C000-000000000046),
  635.     object,
  636.     pointer_default(unique)
  637. ]
  638. interface IShellView : IOleWindow
  639. {
  640.     HRESULT TranslateAccelerator([in] MSG *pmsg);
  641.     HRESULT EnableModeless([in] BOOL fEnable);
  642.     HRESULT UIActivate([in] UINT uState);
  643.     HRESULT Refresh();
  644.     HRESULT CreateViewWindow(
  645.         [in] IShellView *psvPrevious,
  646.         [in] LPCFOLDERSETTINGS pfs, 
  647.         [in] IShellBrowser *psb,
  648.         [out] RECT *prcView, 
  649.         [out] HWND *phWnd);
  650.         
  651.     HRESULT DestroyViewWindow();
  652.     
  653.     HRESULT GetCurrentInfo([out] LPFOLDERSETTINGS pfs);
  655.     [local] HRESULT AddPropertySheetPages(
  656.         [in] DWORD dwReserved,
  657.         [in] LPFNSVADDPROPSHEETPAGE pfn, 
  658.         [in] LPARAM lparam);
  660.     HRESULT SaveViewState();
  661.     
  662.     HRESULT SelectItem(
  663.         [in] LPCITEMIDLIST pidlItem, 
  664.         [in] SVSIF uFlags);
  665.         
  666.     HRESULT GetItemObject(
  667.         [in] UINT uItem, 
  668.         [in] REFIID riid,
  669.         [out, iid_is(riid)] void **ppv);
  671. typedef IShellView *LPSHELLVIEW;
  672. };
  674. [
  675.     helpstring("IShellView2"),
  676.     uuid(88E39E80-3578-11CF-AE69-08002B2E1262),
  677.     object,
  678.     pointer_default(unique)
  679. ]
  680. interface IShellView2 :  IShellView
  681. {
  682. typedef GUID SHELLVIEWID;
  684. cpp_quote("#define SV2GV_CURRENTVIEW ((UINT)-1)")
  685. cpp_quote("#define SV2GV_DEFAULTVIEW ((UINT)-2)")
  686. //
  687. //  NOTE if the cbSize param is ever updated,")
  688. //  then there will have to be custom [wire_marshal]")
  689. //  implementation to support it")
  690. //
  691. cpp_quote("#include <pshpack8.h>")
  692. typedef struct _SV2CVW2_PARAMS
  693. {
  694.     DWORD cbSize;
  696.     IShellView *psvPrev;
  697.     LPCFOLDERSETTINGS pfs;
  698.     IShellBrowser *psbOwner;
  699.     RECT *prcView;
  700.     SHELLVIEWID const *pvid;
  701.     HWND hwndView;
  702. } SV2CVW2_PARAMS, *LPSV2CVW2_PARAMS;
  703. cpp_quote("#include <poppack.h>")   // Return to byte packing
  705.     HRESULT GetView(
  706.         [in, out] SHELLVIEWID* pvid, 
  707.         [in] ULONG uView);
  708.         
  709.     HRESULT CreateViewWindow2(
  710.         [in] LPSV2CVW2_PARAMS lpParams);
  711.         
  712.     HRESULT HandleRename(
  713.         [in] LPCITEMIDLIST pidlNew);
  714.         
  715.     HRESULT SelectAndPositionItem(
  716.         [in] LPCITEMIDLIST pidlItem,
  717.         [in] UINT uFlags,
  718.         [in] POINT *ppt);
  719. };
  722. [
  723.     helpstring("IFolderView"),
  724.     uuid(cde725b0-ccc9-4519-917e-325d72fab4ce),
  725.     object,
  726.     pointer_default(unique)
  727. ]
  728. interface IFolderView : IUnknown
  729. {
  730.     HRESULT GetCurrentViewMode([in, out] UINT *pViewMode);
  731.     HRESULT SetCurrentViewMode([in] UINT ViewMode);
  733.     HRESULT GetFolder([in] REFIID riid, [out, iid_is(riid)] void **ppv);
  735.     HRESULT Item([in] int iItemIndex, [out] LPITEMIDLIST *ppidl);
  737.     HRESULT ItemCount([in] UINT uFlags,[out] int *pcItems);
  738.     HRESULT Items([in] UINT uFlags,[in] REFIID riid, [out, iid_is(riid)] void **ppv);
  740.     HRESULT GetSelectionMarkedItem([out] int *piItem);
  741.     HRESULT GetFocusedItem([out] int *piItem);
  743.     HRESULT GetItemPosition([in] LPCITEMIDLIST pidl, [out] POINT* ppt);
  744.     HRESULT GetSpacing([in, out, ptr] POINT* ppt);
  745.     HRESULT GetDefaultSpacing([out] POINT* ppt);
  746.     HRESULT GetAutoArrange();
  748.     // like IShellView::SelectItem() by index
  749.     HRESULT SelectItem([in] int iItem, [in] DWORD dwFlags);
  750.     HRESULT SelectAndPositionItems([in] UINT cidl, [in, size_is(cidl)] LPCITEMIDLIST* apidl, [in, ptr, size_is(cidl)] POINT* apt, [in] DWORD dwFlags);
  751. };
  753. cpp_quote("#define SID_SFolderView IID_IFolderView    // folder view, usuaally IFolderView")
  756. //  this is to handle name collisions 
  757. cpp_quote("#ifdef _FIX_ENABLEMODELESS_CONFLICT")
  758. cpp_quote("#undef    EnableModeless ")
  759. cpp_quote("#endif")
  762. [
  763.     helpstring("IFolderFilterSite"),
  764.     uuid(C0A651F5-B48B-11d2-B5ED-006097C686F6), // IID_IFolderFilterSite
  765.     object,
  766.     pointer_default(unique)
  767. ]
  768. interface IFolderFilterSite : IUnknown
  769. {
  770.     HRESULT SetFilter([in]IUnknown* punk);
  771. };
  774. [
  775.     helpstring("IFolderFilter"),
  776.     uuid(9CC22886-DC8E-11d2-B1D0-00C04F8EEB3E), // IID_IFolderFilter
  777.     object,
  778.     pointer_default(unique)
  779. ]
  780. interface IFolderFilter : IUnknown
  781. {
  782.     HRESULT ShouldShow([in] IShellFolder* psf, [in] LPCITEMIDLIST pidlFolder, [in] LPCITEMIDLIST pidlItem);
  783.     HRESULT GetEnumFlags([in] IShellFolder* psf, [in] LPCITEMIDLIST pidlFolder, [in] HWND *phwnd, [out] DWORD *pgrfFlags);
  784. };
  787. //--------------------------------------------------------------------------
  788. //
  789. // Interface:   IShellBrowser
  790. //
  791. //  IShellBrowser interface is the interface that is provided by the shell
  792. // explorer/folder frame window. When it creates the 'contents pane' of
  793. // a shell folder (which provides IShellFolder interface), it calls its
  794. // CreateViewObject member function to create an IShellView object. Then,
  795. // it calls its CreateViewWindow member to create the 'contents pane'
  796. // window. The pointer to the IShellBrowser interface is passed to
  797. // the IShellView object as a parameter to this CreateViewWindow member
  798. // function call.
  799. //
  800. //    +--------------------------+  <-- Explorer window
  801. //    | [] Explorer              |
  802. //    |--------------------------+       IShellBrowser
  803. //    | File Edit View ..        |
  804. //    |--------------------------|
  805. //    |        |                 |
  806. //    |        |              <-------- Content pane
  807. //    |        |                 |
  808. //    |        |                 |       IShellView
  809. //    |        |                 |
  810. //    |        |                 |
  811. //    +--------------------------+
  812. //
  813. //
  814. //
  815. // [Member functions]
  816. //
  817. //
  818. // IShellBrowser::GetWindow(phwnd)
  819. //
  820. //   Inherited from IOleWindow::GetWindow.
  821. //
  822. //
  823. // IShellBrowser::ContextSensitiveHelp(fEnterMode)
  824. //
  825. //   Inherited from IOleWindow::ContextSensitiveHelp.
  826. //
  827. //
  828. // IShellBrowser::InsertMenusSB(hmenuShared, lpMenuWidths)
  829. //
  830. //   Similar to the IOleInPlaceFrame::InsertMenus. The explorer will put
  831. //  'File' and 'Edit' pulldown in the File menu group, 'View' and 'Tools'
  832. //  in the Container menu group and 'Help' in the Window menu group. Each
  833. //  pulldown menu will have a uniqu ID, FCIDM_MENU_FILE/EDIT/VIEW/TOOLS/HELP
  834. //  The view is allowed to insert menuitems into those sub-menus by those
  835. //  IDs must be between FCIDM_SHVIEWFIRST and FCIDM_SHVIEWLAST.
  836. //
  837. //
  838. // IShellBrowser::SetMenuSB(hmenuShared, holemenu, hwndActiveObject)
  839. //
  840. //   Similar to the IOleInPlaceFrame::SetMenu. The explorer ignores the
  841. //  holemenu parameter (reserved for future enhancement)  and performs
  842. //  menu-dispatch based on the menuitem IDs (see the description above).
  843. //  It is important to note that the explorer will add different
  844. //  set of menuitems depending on whether the view has a focus or not.
  845. //  Therefore, it is very important to call ISB::OnViewWindowActivate
  846. //  whenever the view window (or its children) gets the focus.
  847. //
  848. //
  849. // IShellBrowser::RemoveMenusSB(hmenuShared)
  850. //
  851. //   Same as the IOleInPlaceFrame::RemoveMenus.
  852. //
  853. //
  854. // IShellBrowser::SetStatusTextSB(pszStatusText)
  855. //
  856. //   Same as the IOleInPlaceFrame::SetStatusText. It is also possible to
  857. //  send messages directly to the status window via SendControlMsg.
  858. //
  859. //
  860. // IShellBrowser::EnableModelessSB(fEnable)
  861. //
  862. //   Same as the IOleInPlaceFrame::EnableModeless.
  863. //
  864. //
  865. // IShellBrowser::TranslateAcceleratorSB(lpmsg, wID)
  866. //
  867. //   Same as the IOleInPlaceFrame::TranslateAccelerator, but will be
  868. //  never called because we don't support EXEs (i.e., the explorer has
  869. //  the message loop). This member function is defined here for possible
  870. //  future enhancement.
  871. //
  872. //
  873. // IShellBrowser::BrowseObject(pidl, wFlags)")
  874. //
  875. //   The view calls this member to let shell explorer browse to another")
  876. //  folder. The pidl and wFlags specifies the folder to be browsed.")
  877. //
  878. //  Following three flags specifies whether it creates another window or not.
  879. //   SBSP_SAMEBROWSER  -- Browse to another folder with the same window.
  880. //   SBSP_NEWBROWSER   -- Creates another window for the specified folder.
  881. //   SBSP_DEFBROWSER   -- Default behavior (respects the view option).
  882. //
  883. //  Following three flags specifies open, explore, or default mode. These   .
  884. //  are ignored if SBSP_SAMEBROWSER or (SBSP_DEFBROWSER && (single window   .
  885. //  browser || explorer)).                                                  .
  886. //   SBSP_OPENMODE     -- Use a normal folder window
  887. //   SBSP_EXPLOREMODE  -- Use an explorer window
  888. //   SBSP_DEFMODE      -- Use the same as the current window
  889. //
  890. //  Following three flags specifies the pidl.
  891. //   SBSP_ABSOLUTE -- pidl is an absolute pidl (relative from desktop)
  892. //   SBSP_RELATIVE -- pidl is relative from the current folder.
  893. //   SBSP_PARENT   -- Browse the parent folder (ignores the pidl)
  894. //   SBSP_NAVIGATEBACK    -- Navigate back (ignores the pidl)
  895. //   SBSP_NAVIGATEFORWARD -- Navigate forward (ignores the pidl)
  896. //
  897. //  Following two flags control history manipulation as result of navigate
  898. //   SBSP_WRITENOHISTORY -- write no history (shell folder) entry
  899. //   SBSP_NOAUTOSELECT -- suppress selection in history pane
  900. //
  901. // IShellBrowser::GetViewStateStream(grfMode, ppstm)
  902. //
  903. //   The browser returns an IStream interface as the storage for view
  904. //  specific state information.
  905. //
  906. //   grfMode -- Specifies the read/write access (STGM_READ/WRITE/READWRITE)
  907. //   ppstm   -- Specifies the IStream *variable to be filled.
  908. //
  909. //
  910. // IShellBrowser::GetControlWindow(id, phwnd)
  911. //
  912. //   The shell view may call this member function to get the window handle
  913. //  of Explorer controls (toolbar or status winodw -- FCW_TOOLBAR or
  914. //  FCW_STATUS).
  915. //
  916. //
  917. // IShellBrowser::SendControlMsg(id, uMsg, wParam, lParam, pret)
  918. //
  919. //   The shell view calls this member function to send control messages to
  920. //  one of Explorer controls (toolbar or status window -- FCW_TOOLBAR or
  921. //  FCW_STATUS).
  922. //
  923. //
  924. // IShellBrowser::QueryActiveShellView(IShellView * ppshv)
  925. //
  926. //   This member returns currently activated (displayed) shellview object.
  927. //  A shellview never need to call this member function.
  928. //
  929. //
  930. // IShellBrowser::OnViewWindowActive(pshv)
  931. //
  932. //   The shell view window calls this member function when the view window
  933. //  (or one of its children) got the focus. It MUST call this member before
  934. //  calling IShellBrowser::InsertMenus, because it will insert different
  935. //  set of menu items depending on whether the view has the focus or not.
  936. //
  937. //
  938. // IShellBrowser::SetToolbarItems(lpButtons, nButtons, uFlags)
  939. //
  940. //   The view calls this function to add toolbar items to the exporer's
  941. //  toolbar. 'lpButtons' and 'nButtons' specifies the array of toolbar
  942. //  items. 'uFlags' must be one of FCT_MERGE, FCT_CONFIGABLE, FCT_ADDTOEND.
  943. //
  944. //-------------------------------------------------------------------------
  946. //
  947. // Values for wFlags parameter of ISB::BrowseObject() member.
  948. //
  949. cpp_quote("#define SBSP_DEFBROWSER         0x0000")
  950. cpp_quote("#define SBSP_SAMEBROWSER        0x0001")
  951. cpp_quote("#define SBSP_NEWBROWSER         0x0002")
  953. cpp_quote("#define SBSP_DEFMODE            0x0000")
  954. cpp_quote("#define SBSP_OPENMODE           0x0010")
  955. cpp_quote("#define SBSP_EXPLOREMODE        0x0020")
  956. cpp_quote("#define SBSP_HELPMODE           0x0040 // IEUNIX : Help window uses this.")
  957. cpp_quote("#define SBSP_NOTRANSFERHIST     0x0080")
  959. cpp_quote("#define SBSP_ABSOLUTE           0x0000")
  960. cpp_quote("#define SBSP_RELATIVE           0x1000")
  961. cpp_quote("#define SBSP_PARENT             0x2000")
  962. cpp_quote("#define SBSP_NAVIGATEBACK       0x4000")
  963. cpp_quote("#define SBSP_NAVIGATEFORWARD    0x8000")
  965. cpp_quote("#define SBSP_ALLOW_AUTONAVIGATE 0x10000")
  967. cpp_quote("#define SBSP_NOAUTOSELECT       0x04000000")
  968. cpp_quote("#define SBSP_WRITENOHISTORY     0x08000000")
  970. cpp_quote("#define SBSP_REDIRECT                     0x40000000")
  971. cpp_quote("#define SBSP_INITIATEDBYHLINKFRAME        0x80000000")
  972. //
  973. // Values for id parameter of ISB::GetWindow/SendControlMsg members.
  974. //
  975. // WARNING:
  976. //  Any shell extensions which sends messages to those control windows
  977. // might not work in the future version of windows. If you really need
  978. // to send messages to them, (1) don't assume that those control window
  979. // always exist (i.e. GetControlWindow may fail) and (2) verify the window
  980. // class of the window before sending any messages.
  981. //
  982. cpp_quote("#define FCW_STATUS      0x0001")
  983. cpp_quote("#define FCW_TOOLBAR     0x0002")
  984. cpp_quote("#define FCW_TREE        0x0003")
  985. cpp_quote("#define FCW_INTERNETBAR 0x0006")
  986. cpp_quote("#define FCW_PROGRESS    0x0008")
  989. //
  990. // Values for uFlags paremeter of ISB::SetToolbarItems member.
  991. //
  992. cpp_quote("#define FCT_MERGE       0x0001")
  993. cpp_quote("#define FCT_CONFIGABLE  0x0002")
  994. cpp_quote("#define FCT_ADDTOEND    0x0004")
  996. cpp_quote("#ifdef _NEVER_")
  997. typedef LPARAM LPTBBUTTONSB;
  998. cpp_quote("#else //!_NEVER_")
  999. cpp_quote("#include <commctrl.h>")
  1000. cpp_quote("typedef LPTBBUTTON LPTBBUTTONSB;")
  1001. cpp_quote("#endif //_NEVER_")
  1003. [
  1004.     helpstring("IShellBrowser"),
  1005.     uuid(000214E2-0000-0000-C000-000000000046),
  1006.     object,
  1007.     pointer_default(unique)
  1008. ]
  1009. interface IShellBrowser : IOleWindow
  1010. {
  1011.     // same as IOleInPlaceFrame
  1012.     HRESULT InsertMenusSB(
  1013.         [in] HMENU hmenuShared, 
  1014.         [in, out] LPOLEMENUGROUPWIDTHS lpMenuWidths);
  1015.         
  1016.     HRESULT SetMenuSB(
  1017.         [in] HMENU hmenuShared, 
  1018.         [in] HOLEMENU holemenuRes, 
  1019.         [in] HWND hwndActiveObject);
  1020.         
  1021.     HRESULT RemoveMenusSB([in] HMENU hmenuShared);
  1022.     HRESULT SetStatusTextSB([in, unique] LPCOLESTR pszStatusText);
  1023.     HRESULT EnableModelessSB([in] BOOL fEnable);
  1024.     HRESULT TranslateAcceleratorSB([in] MSG *pmsg, [in] WORD wID);
  1026.     // IShellBrowser
  1027.     HRESULT BrowseObject(
  1028.         [in] LPCITEMIDLIST pidl, 
  1029.         [in] UINT wFlags);
  1030.         
  1031.     HRESULT GetViewStateStream(
  1032.         [in] DWORD grfMode, 
  1033.         [out] IStream **ppStrm);
  1034.         
  1035.     HRESULT GetControlWindow(
  1036.         [in] UINT id, 
  1037.         [out] HWND * phwnd);
  1038.         
  1039.     [local] HRESULT SendControlMsg(
  1040.         [in] UINT id, 
  1041.         [in] UINT uMsg, 
  1042.         [in] WPARAM wParam, 
  1043.         [in] LPARAM lParam, 
  1044.         [in] LRESULT *pret);
  1045.         
  1046.     HRESULT QueryActiveShellView([out] IShellView **ppshv);
  1047.     HRESULT OnViewWindowActive([in] IShellView *pshv);
  1048.     [local] HRESULT SetToolbarItems(
  1049.         [in] LPTBBUTTONSB lpButtons, 
  1050.         [in] UINT nButtons, 
  1051.         [in] UINT uFlags);
  1052. };
  1054. typedef IShellBrowser * LPSHELLBROWSER;
  1057. [
  1058.     helpstring("IProfferService"),
  1059.     uuid(cb728b20-f786-11ce-92ad-00aa00a74cd0), // IID_IProfferService
  1060.     object,
  1061.     pointer_default(unique)
  1062. ]
  1063. interface IProfferService : IUnknown
  1064. {
  1065.     HRESULT ProfferService([in]REFGUID rguidService, [in] IServiceProvider *psp, [out] DWORD *pdwCookie);
  1066.     HRESULT RevokeService([in]DWORD dwCookie);
  1067. }
  1069. cpp_quote("#define SID_SProfferService IID_IProfferService    // nearest service that you can proffer to")
  1071. typedef [v1_enum] enum
  1072. {
  1073.     PUIFNF_DEFAULT          = 0x00000000,
  1074.     PUIFNF_MNEMONIC         = 0x00000001,   // include mnemonic in display name
  1075. } PROPERTYUI_NAME_FLAGS;
  1077. typedef [v1_enum] enum
  1078. {
  1079.     PUIF_DEFAULT            = 0x00000000,
  1080.     PUIF_RIGHTALIGN         = 0x00000001,   // this property should be right alligned
  1081.     PUIF_NOLABELININFOTIP   = 0x00000002,   // this property should not display a label in the infotip
  1082. } PROPERTYUI_FLAGS;
  1084. typedef [v1_enum] enum
  1085. {
  1086.     PUIFFDF_DEFAULT         = 0x00000000,
  1087.     PUIFFDF_RIGHTTOLEFT     = 0x00000001,   // BIDI support, right to left caller
  1088.     PUIFFDF_SHORTFORMAT     = 0x00000002,   // short format version of string
  1089.     PUIFFDF_NOTIME          = 0x00000004,   // truncate time to days, not hours/mins/sec
  1090.     PUIFFDF_FRIENDLYDATE    = 0x00000008,   // "Today", "Yesterday", etc
  1091.     PUIFFDF_NOUNITS         = 0x00000010,   // don't do "KB", "MB", "KHz"
  1092. } PROPERTYUI_FORMAT_FLAGS;
  1094. [
  1095.     helpstring("IPropertyUI - helper for dealing with properties ala IPropertySetStorage"),
  1096.     uuid(757a7d9f-919a-4118-99d7-dbb208c8cc66),
  1097.     object,
  1098.     pointer_default(unique)
  1099. ]
  1100. interface IPropertyUI : IUnknown
  1101. {
  1102.     HRESULT ParsePropertyName([in] LPCWSTR pszName, [out] FMTID *pfmtid, [out] PROPID *ppid, [in, out] ULONG *pchEaten);
  1103.     HRESULT GetCannonicalName([in] REFFMTID fmtid, [in] PROPID pid, [out, size_is(cchText)] LPWSTR pwszText, [in] DWORD cchText);
  1104.     HRESULT GetDisplayName([in] REFFMTID fmtid, [in] PROPID pid, [in] PROPERTYUI_NAME_FLAGS flags, [out, size_is(cchText)] LPWSTR pwszText, [in] DWORD cchText);
  1105.     HRESULT GetPropertyDescription([in] REFFMTID fmtid, [in] PROPID pid, [out, size_is(cchText)] LPWSTR pwszText, [in] DWORD cchText);
  1106.     HRESULT GetDefaultWidth([in] REFFMTID fmtid, [in] PROPID pid, [out] ULONG *pcxChars);
  1107.     HRESULT GetFlags([in] REFFMTID fmtid, [in] PROPID pid, [out] PROPERTYUI_FLAGS *pFlags);
  1108.     HRESULT FormatForDisplay([in] REFFMTID fmtid, [in] PROPID pid, [in] const PROPVARIANT *pvar, [in] PROPERTYUI_FORMAT_FLAGS flags, [out, size_is(cchText)] LPWSTR pwszText, [in] DWORD cchText);
  1109.     HRESULT GetHelpInfo([in] REFFMTID fmtid, [in] PROPID pid, [out, size_is(cch)] LPWSTR pwszHelpFile, [in] DWORD cch, [out] UINT *puHelpID);
  1110. };
  1112. cpp_quote("#if (_WIN32_IE >= 0x0500)")
  1114. // Folder Category Support
  1116. [
  1117.     helpstring("ICategoryProvider - Provides a list of catagorizers registered on an IShellFolder"),
  1118.     uuid(9af64809-5864-4c26-a720-c1f78c086ee3),
  1119.     object,
  1120.     pointer_default(unique)
  1121. ]
  1122. interface ICategoryProvider : IUnknown
  1123. {
  1124.     [helpstring("Returns S_OK if the view should display this column in category selection UI, or S_FALSE to remove it.")]
  1125.     HRESULT CanCategorizeOnSCID(SHCOLUMNID* pscid);
  1126.     [helpstring("Returns either a GUID to create in CreateCategory, or a SHCOLUNNID that is used by the default categorizer. Return S_FALSE if you do not support a default group. GUID_NULL returned in pguid indicates to the client to use pscid as the default category.")]
  1127.     HRESULT GetDefaultCategory(GUID* pguid, SHCOLUMNID* pscid);
  1128.     [helpstring("Returns either a GUID that represents the categoizer to use for the specified SHCOLUMNID.")]
  1129.     HRESULT GetCategoryForSCID(SHCOLUMNID* pscid, GUID* pguid);
  1130.     [helpstring("Returns an IEnumGUID that has a list of GUIDs that represent categories.")]
  1131.     HRESULT EnumCategories(IEnumGUID** penum);
  1132.     [helpstring("Returns the name of the given category.")]
  1133.     HRESULT GetCategoryName(GUID* pguid, LPWSTR pszName, UINT cch);
  1134.     [helpstring("Creates the category.")]
  1135.     HRESULT CreateCategory(GUID* pguid, REFIID riid, [iid_is(riid)]void** ppv);
  1136. }
  1138. typedef [v1_enum] enum
  1139. {
  1140.     CATINFO_NORMAL      = 0x00000000,   // Apply default properties to this category
  1141.     CATINFO_COLLAPSED   = 0x00000001,   // This category should appear collapsed. useful for the "None" category. 
  1142.     CATINFO_HIDDEN      = 0x00000002,   // This category should follow the "Hidden" files setting for being displayed
  1143. } CATEGORYINFO_FLAGS;
  1145. typedef [v1_enum] enum
  1146. {
  1147.     CATSORT_DEFAULT     = 0x00000000,   // Default Sort order
  1148.     CATSORT_NAME        = 0x00000001,   // Sort by name
  1149. } CATSORT_FLAGS;
  1151. typedef struct
  1152. {
  1153.     CATEGORYINFO_FLAGS cif;
  1154.     WCHAR wszName[260];
  1155. } CATEGORY_INFO;
  1157. [
  1158.     helpstring("ICategorizer - Categorizes pidls"),
  1159.     uuid(a3b14589-9174-49a8-89a3-06a1ae2b9ba7),
  1160.     object,
  1161.     pointer_default(unique)
  1162. ]
  1163. interface ICategorizer : IUnknown
  1164. {
  1165.     [helpstring("Returns the description of this category that will be displayed in the UI")]
  1166.     HRESULT GetDescription(LPWSTR pszDesc, UINT cch);
  1167.     [helpstring("Returns a list of categories associated with a list of ID Lists. NOTE: -1 is an invalid Category ID, and they cannot be persisted")]
  1168.     HRESULT GetCategory([in] UINT cidl, 
  1169.                         [in, size_is(cidl)] LPCITEMIDLIST * apidl, 
  1170.                         [in, out, size_is(cidl)] DWORD* rgCategoryIds);
  1172.     [helpstring("Returns information about the category, such as default display and the text to display in the UI")]
  1173.     HRESULT GetCategoryInfo(DWORD dwCategoryId, CATEGORY_INFO* pci);
  1174.     [helpstring("Returns HRESULTFromShort. -1, 0, 1 indicate the comparison of the IDs. Used for sorting categories in the UI")]
  1175.     HRESULT CompareCategory(CATSORT_FLAGS csfFlags, DWORD dwCategoryId1, DWORD dwCategoryId2);
  1176. };
  1177. cpp_quote("#endif // (_WIN32_IE >= 0x0500)")
  1180. cpp_quote("#ifdef UNICODE")
  1181. cpp_quote("#define IShellLink      IShellLinkW")
  1182. cpp_quote("#else")
  1183. cpp_quote("#define IShellLink      IShellLinkA")
  1184. cpp_quote("#endif")
  1186. // IShellLink::Resolve fFlags
  1187. typedef enum 
  1188. {
  1189.     SLR_NO_UI               = 0x0001,   // don't post any UI durring the resolve operation, not msgs are pumped
  1190.     SLR_ANY_MATCH           = 0x0002,   // no longer used
  1191.     SLR_UPDATE              = 0x0004,   // save the link back to it's file if the track made it dirty
  1192.     SLR_NOUPDATE            = 0x0008,
  1193.     SLR_NOSEARCH            = 0x0010,   // don't execute the search heuristics
  1194.     SLR_NOTRACK             = 0x0020,   // don't use NT5 object ID to track the link
  1195.     SLR_NOLINKINFO          = 0x0040,   // don't use the net and volume relative info
  1196.     SLR_INVOKE_MSI          = 0x0080,   // if we have a darwin link, then call msi to fault in the applicaion
  1197.     SLR_NO_UI_WITH_MSG_PUMP = 0x0101,   // SLR_NO_UI + requires an enable modeless site or HWND
  1198. } SLR_FLAGS;
  1200. // IShellLink::GetPath fFlags
  1201. typedef enum 
  1202. {
  1203.     SLGP_SHORTPATH      = 0x0001,
  1204.     SLGP_UNCPRIORITY    = 0x0002,
  1205.     SLGP_RAWPATH        = 0x0004,
  1206. } SLGP_FLAGS;
  1208. [
  1209.     uuid(000214EE-0000-0000-C000-000000000046),
  1210.     object,
  1211.     pointer_default(unique)
  1212. ]
  1213. interface IShellLinkA : IUnknown
  1214. {
  1215.     HRESULT GetPath([out, size_is(cch)] LPSTR pszFile, [in] int cch, [in, out, ptr] WIN32_FIND_DATAA *pfd, [in] DWORD fFlags);
  1216.     HRESULT GetIDList([out] LPITEMIDLIST * ppidl);
  1217.     HRESULT SetIDList([in] LPCITEMIDLIST pidl);
  1218.     HRESULT GetDescription([out, size_is(cch)] LPSTR pszName, [in] int cch);
  1219.     HRESULT SetDescription([in] LPCSTR pszName);
  1220.     HRESULT GetWorkingDirectory([out, size_is(cch)] LPSTR pszDir, [in] int cch);
  1221.     HRESULT SetWorkingDirectory([in] LPCSTR pszDir);
  1222.     HRESULT GetArguments([out, size_is(cch)] LPSTR pszArgs, [in] int cch);
  1223.     HRESULT SetArguments([in] LPCSTR pszArgs);
  1224.     HRESULT GetHotkey([out] WORD *pwHotkey);
  1225.     HRESULT SetHotkey([in] WORD wHotkey);
  1226.     HRESULT GetShowCmd([out] int *piShowCmd);
  1227.     HRESULT SetShowCmd([in] int iShowCmd);
  1228.     HRESULT GetIconLocation([out, size_is(cch)] LPSTR pszIconPath, [in] int cch, [out] int *piIcon);
  1229.     HRESULT SetIconLocation([in] LPCSTR pszIconPath, [in] int iIcon);
  1230.     HRESULT SetRelativePath([in] LPCSTR pszPathRel, [in] DWORD dwReserved);
  1231.     HRESULT Resolve([in] HWND hwnd, [in] DWORD fFlags);
  1232.     HRESULT SetPath([in] LPCSTR pszFile);
  1233. };
  1235. [
  1236.     uuid(000214F9-0000-0000-C000-000000000046),
  1237.     object,
  1238.     pointer_default(unique)
  1239. ]
  1240. interface IShellLinkW : IUnknown
  1241. {
  1242.     HRESULT GetPath([out, size_is(cch)] LPWSTR pszFile, [in] int cch, [in, out, ptr] WIN32_FIND_DATAW *pfd, [in] DWORD fFlags);
  1243.     HRESULT GetIDList([out] LPITEMIDLIST * ppidl);
  1244.     HRESULT SetIDList([in] LPCITEMIDLIST pidl);
  1245.     HRESULT GetDescription([out, size_is(cch)] LPWSTR pszName, int cch);
  1246.     HRESULT SetDescription([in] LPCWSTR pszName);
  1247.     HRESULT GetWorkingDirectory([out, size_is(cch)] LPWSTR pszDir, int cch);
  1248.     HRESULT SetWorkingDirectory([in] LPCWSTR pszDir);
  1249.     HRESULT GetArguments([out, size_is(cch)] LPWSTR pszArgs, int cch);
  1250.     HRESULT SetArguments([in] LPCWSTR pszArgs);
  1251.     HRESULT GetHotkey([out] WORD *pwHotkey);
  1252.     HRESULT SetHotkey([in] WORD wHotkey);
  1253.     HRESULT GetShowCmd([out] int *piShowCmd);
  1254.     HRESULT SetShowCmd([in] int iShowCmd);
  1255.     HRESULT GetIconLocation([out, size_is(cch)] LPWSTR pszIconPath, [in] int cch, [out] int *piIcon);
  1256.     HRESULT SetIconLocation([in] LPCWSTR pszIconPath, [in] int iIcon);
  1257.     HRESULT SetRelativePath([in] LPCWSTR pszPathRel, [in] DWORD dwReserved);
  1258.     HRESULT Resolve([in] HWND hwnd, [in] DWORD fFlags);
  1259.     HRESULT SetPath([in] LPCWSTR pszFile);
  1260. };
  1262. [
  1263.     object,
  1264.     uuid(49ff1172-eadc-446d-9285-156453a6431c),
  1265.     helpstring("IActionProgressDialog Interface"),
  1266.     pointer_default(unique)
  1267. ]
  1268. interface IActionProgressDialog : IUnknown
  1269. {
  1270.     [v1_enum] enum {
  1271.         SPINITF_NORMAL         = 0x00000000,      // default normal progress behavior
  1272.         SPINITF_MODAL          = 0x00000001,      // call punkSite->EnableModeless() or EnableWindow()
  1273.         SPINITF_NOMINIMIZE     = 0x00000008,      // Do not have a minimize button in the caption bar.
  1274.     };
  1275.     typedef DWORD SPINITF;
  1276.     
  1277.     HRESULT Initialize(
  1278.         [in] SPINITF flags, 
  1279.         [in, string] LPCWSTR pszTitle, 
  1280.         [in, string] LPCWSTR pszCancel);
  1282.     HRESULT Stop();
  1283. };
  1285. [
  1286.     object,
  1287.     uuid(C1FB73D0-EC3A-4ba2-B512-8CDB9187B6D1),
  1288.     helpstring("HW Event Handler Interface"),
  1289.     pointer_default(unique)
  1290. ]
  1291. interface IHWEventHandler : IUnknown
  1292. {
  1293.     HRESULT Initialize([in, string] LPCWSTR pszParams);
  1294.     HRESULT HandleEvent([in, string] LPCWSTR pszDeviceID,
  1295.         [in, string] LPCWSTR pszAltDeviceID,
  1296.         [in, string] LPCWSTR pszEventType);
  1297.     HRESULT HandleEventWithContent([in, string] LPCWSTR pszDeviceID,
  1298.         [in, string] LPCWSTR pszAltDeviceID,
  1299.         [in, string] LPCWSTR pszEventType,
  1300.         [in, string] LPCWSTR pszContentTypeHandler,
  1301.         [in] IDataObject* pdataobject);
  1302. };
  1304. cpp_quote("#define ARCONTENT_AUTORUNINF         0x00000002") // That's the one we have today, and always had 
  1305. cpp_quote("#define ARCONTENT_AUDIOCD         0x00000004") // Audio CD (not MP3 and the like, the stuff you buy at the store) 
  1306. cpp_quote("#define ARCONTENT_DVDMOVIE        0x00000008") // DVD Movie (not MPEGs, the stuff you buy at the store) 
  1307. cpp_quote("#define ARCONTENT_BLANKCD         0x00000010") // Blank CD-R/CD-RW 
  1308. cpp_quote("#define ARCONTENT_BLANKDVD        0x00000020") // Blank DVD-R/DVD-RW 
  1309. cpp_quote("#define ARCONTENT_UNKNOWNCONTENT     0x00000040") // Whatever files.  Mean that it's formatted.
  1310. cpp_quote("#define ARCONTENT_AUTOPLAYPIX     0x00000080") // Whatever files.  Mean that it's formatted.
  1311. cpp_quote("#define ARCONTENT_AUTOPLAYMUSIC      0x00000100") // Whatever files.  Mean that it's formatted.
  1312. cpp_quote("#define ARCONTENT_AUTOPLAYVIDEO      0x00000200") // Whatever files.  Mean that it's formatted.
  1314. [
  1315.     object,
  1316.     uuid(DDEFE873-6997-4e68-BE26-39B633ADBE12),
  1317.     helpstring("HW Event Handler Interface"),
  1318.     pointer_default(unique)
  1319. ]
  1320. interface IQueryCancelAutoPlay : IUnknown
  1321. {
  1322.     HRESULT AllowAutoPlay([in, string]LPCWSTR pszPath, [in]DWORD dwContentType,
  1323.       [in, string]LPCWSTR pszLabel, [in] DWORD dwSerialNumber);
  1324. };
  1326. [
  1327.     object,
  1328.     uuid(49ff1173-eadc-446d-9285-156453a6431c),
  1329.     helpstring("IActionProgress Interface"),
  1330.     pointer_default(unique)
  1331. ]
  1332. interface IActionProgress : IUnknown
  1333. {
  1334.     [v1_enum] enum {
  1335.         SPBEGINF_NORMAL             = 0x00000000,      // default normal progress behavior
  1336.         SPBEGINF_AUTOTIME           = 0x00000002,      // automatically updates the "time remaining" text 
  1337.         SPBEGINF_NOPROGRESSBAR      = 0x00000010,      // Don't display the progress bar (SetProgress() wont be called)
  1338.         SPBEGINF_MARQUEEPROGRESS    = 0x00000020,      // use marquee progress (comctl32 v6 required)
  1339.     };
  1340.     typedef DWORD SPBEGINF;
  1342.     typedef [v1_enum] enum _SPACTION {
  1343.         SPACTION_NONE            = 0,      
  1344.         SPACTION_MOVING,
  1345.         SPACTION_COPYING,
  1346.         SPACTION_RECYCLING,
  1347.         SPACTION_APPLYINGATTRIBS,
  1348.         SPACTION_DOWNLOADING,
  1349.         SPACTION_SEARCHING_INTERNET,
  1350.         SPACTION_CALCULATING,
  1351.         SPACTION_UPLOADING,
  1352.         SPACTION_SEARCHING_FILES,
  1353.     } SPACTION;
  1354.     
  1355.     HRESULT Begin(
  1356.         [in] SPACTION action,
  1357.         [in] SPBEGINF flags);
  1359.     HRESULT UpdateProgress(
  1360.         [in] ULONGLONG ulCompleted, 
  1361.         [in] ULONGLONG ulTotal);
  1363.     typedef [v1_enum] enum _SPTEXT
  1364.     {
  1365.         SPTEXT_ACTIONDESCRIPTION        = 1,
  1366.         SPTEXT_ACTIONDETAIL,
  1367.     } SPTEXT;
  1368.     
  1369.     HRESULT UpdateText(
  1370.         [in] SPTEXT sptext, 
  1371.         [in, string] LPCWSTR pszText, 
  1372.         [in] BOOL fMayCompact);
  1374.     HRESULT QueryCancel([out] BOOL * pfCancelled);
  1375.     HRESULT ResetCancel();
  1377.     HRESULT End();
  1379. };
  1381. //  The IShellExtInit interface is used by the explorer to initialize shell
  1382. // extension objects. The explorer (1) calls CoCreateInstance (or equivalent)
  1383. // with the registered CLSID and IID_IShellExtInit, (2) calls its Initialize
  1384. // member, then (3) calls its QueryInterface to a particular interface (such
  1385. // as IContextMenu or IPropSheetExt and (4) performs the rest of operation.
  1386. //
  1387. // IShellExtInit::Initialize
  1388. //
  1389. //  This member function is called when the explorer is initializing either
  1390. // context menu extension, property sheet extension or non-default drag-drop
  1391. // extension.
  1392. //
  1393. //  Parameters: (context menu or property sheet extension)
  1394. //   pidlFolder -- Specifies the parent folder
  1395. //   lpdobj -- Spefifies the set of items selected in that folder.
  1396. //   hkeyProgID -- Specifies the type of the focused item in the selection.
  1397. //
  1398. //  Parameters: (non-default drag-and-drop extension)
  1399. //   pidlFolder -- Specifies the target (destination) folder
  1400. //   lpdobj -- Specifies the items that are dropped (see the description
  1401. //    about shell's clipboard below for clipboard formats).
  1402. //   hkeyProgID -- Specifies the folder type.
  1404. [
  1405.     uuid(000214E8-0000-0000-C000-000000000046),
  1406.     object,
  1407.     local,
  1408.     pointer_default(unique)
  1409. ]
  1410. interface IShellExtInit : IUnknown
  1411. {
  1412.     HRESULT Initialize([in] LPCITEMIDLIST pidlFolder, [in] IDataObject *pdtobj, [in] HKEY hkeyProgID);
  1413. }
  1414. typedef IShellExtInit * LPSHELLEXTINIT;
  1417. //  The explorer uses the IShellPropSheetExt to allow property sheet
  1418. // extensions or control panel extensions to add additional property
  1419. // sheet pages.
  1420. //
  1421. // IShellPropSheetExt::AddPages
  1422. //
  1423. //  The explorer calls this member function when it finds a registered
  1424. // property sheet extension for a particular type of object. For each
  1425. // additional page, the extension creates a page object by calling
  1426. // CreatePropertySheetPage API and calls lpfnAddPage.
  1427. //
  1428. //  Parameters:
  1429. //   lpfnAddPage -- Specifies the callback function.
  1430. //   lParam -- Specifies the opaque handle to be passed to the callback function.
  1431. //
  1432. //
  1433. // IShellPropSheetExt::ReplacePage
  1434. //
  1435. //  The explorer never calls this member of property sheet extensions. The
  1436. // explorer calls this member of control panel extensions, so that they
  1437. // can replace some of default control panel pages (such as a page of
  1438. // mouse control panel).
  1439. //
  1440. //  Parameters:
  1441. //   uPageID -- Specifies the page to be replaced.
  1442. //   lpfnReplace Specifies the callback function.
  1443. //   lParam -- Specifies the opaque handle to be passed to the callback function.
  1444. //
  1445. [
  1446.     uuid(000214E9-0000-0000-C000-000000000046),
  1447.     object,
  1448.     local,
  1449.     pointer_default(unique)
  1450. ]
  1451. interface IShellPropSheetExt : IUnknown
  1452. {
  1453.     HRESULT AddPages([in] LPFNSVADDPROPSHEETPAGE pfnAddPage, [in] LPARAM lParam);
  1454.     enum
  1455.     {
  1456.         EXPPS_FILETYPES     = 0x00000001,
  1457.     };
  1458.     typedef UINT EXPPS;
  1459.     HRESULT ReplacePage([in] EXPPS uPageID, [in] LPFNSVADDPROPSHEETPAGE pfnReplaceWith, [in] LPARAM lParam);
  1460. }
  1461. typedef IShellPropSheetExt * LPSHELLPROPSHEETEXT;
  1464. [
  1465.     helpstring("used to initialize an object on a remote computer (server)"),
  1466.     uuid(000214FE-0000-0000-C000-000000000046),
  1467.     object,
  1468.     pointer_default(unique)
  1469. ]
  1470. interface IRemoteComputer : IUnknown
  1471. {
  1472.     // function is called when the explorer is initializing or
  1473.     // enumerating the name space extension. If failure is returned during
  1474.     // enumeration, the extension won't appear for this computer. Otherwise,
  1475.     // the extension will appear, and should target the given machine.
  1476.     //
  1477.     // pszMachine       Specifies the name of the machine to target. (\server)
  1478.     // bEnumerationg    test to see if this object should be enumerated
  1479.     //                  on this server
  1480.     HRESULT Initialize([in] LPCWSTR pszMachine, [in] BOOL bEnumerating);
  1481. };
  1483. [
  1484.     uuid(7307055c-b24a-486b-9f25-163e597a28a9), object, pointer_default(unique)
  1485. ]
  1486. interface IQueryContinue : IUnknown
  1487. {
  1488.     HRESULT QueryContinue();    // S_OK -> Continue, other 
  1489. };
  1491. [
  1492.     uuid(ba9711ba-5893-4787-a7e1-41277151550b), object, pointer_default(unique)
  1493. ]
  1494. interface IUserNotification : IUnknown
  1495. {
  1496.     HRESULT SetBalloonInfo([in, string] LPCWSTR pszTitle, [in, string] LPCWSTR pszText, [in] DWORD dwInfoFlags);
  1497.     // times in msec
  1498.     HRESULT SetBalloonRetry([in] DWORD dwShowTime, [in] DWORD dwInterval, [in] UINT cRetryCount);
  1499.     HRESULT SetIconInfo([in] HICON hIcon, [in, string] LPCWSTR pszToolTip);
  1500.     HRESULT Show([in] IQueryContinue *pqc, [in] DWORD dwContinuePollInterval);
  1501.     HRESULT PlaySound([in, string] LPCWSTR pszSoundName);
  1502. };
  1505. // interface for describing the limits placed on a name, used for validation
  1506. // parsing and translation.
  1508. [
  1509.     uuid(1df0d7f1-b267-4d28-8b10-12e23202a5c4)
  1510. ]
  1511. interface IItemNameLimits : IUnknown
  1512. {
  1513.     HRESULT GetValidCharacters([out] LPWSTR *ppwszValidChars, [out] LPWSTR *ppwszInvalidChars);
  1514.     HRESULT GetMaxLength([in] LPCWSTR pszName, [out] int *piMaxNameLen);
  1515. };
  1518. // INetCrawler interface
  1519. //
  1520. // [Member functions]
  1521. //
  1522. //   INetCrawler::Update
  1523. //   Causes an enumeration of the local workgroup and subsequent addition
  1524. //   of folder shortcut and printer objects.   As is a blocking call
  1525. //   which will potentially take a long time (seconds) it should be called
  1526. //   on a seperate thread
  1528. cpp_quote("#define SNCF_REFRESHLIST 0x00000001  // refresh the list (eg. from F5 or opening a folder)")
  1530. [
  1531.     helpstring("INetCrawler"),
  1532.     uuid(49c929ee-a1b7-4c58-b539-e63be392b6f3),
  1533.     object,
  1534.     pointer_default(unique)
  1535. ]
  1536. interface INetCrawler : IUnknown
  1537. {
  1538.     HRESULT Update([in] DWORD dwFlags);
  1539. }
  1543. cpp_quote("#if (_WIN32_IE >= 0x0400)")
  1545. // --- IExtractImage
  1546. // this interface is provided for objects to provide a thumbnail image.
  1547. // IExtractImage::GetLocation()
  1548. //      Gets a path description of the image that is to be extracted. This is used to
  1549. //      identify the image in the view so that multiple instances of the same image can reuse the
  1550. //      original image. If *pdwFlags == IEIFLAG_ASYNC and the result is E_PENDING, then *pdwPriority
  1551. //      is used to return the priority of the item, this is usually a measure of how long it will take
  1552. //      to perform the extraction. *pdwFlags can return IEIFLAG_CACHE if the view should cache a copy
  1553. //      of the image for future reference and faster access. This flag is used to tell the difference
  1554. //      between file formats that cache a thumbnail image such as Flashpix or Office documents, and those
  1555. //      that don't cache one.
  1556. // IExtractImage::Extract()
  1557. //      Extract the thumbnail of the specified size. If GetLocation() returned the values indicating
  1558. //      it is free-threaded and can be placed on a background thread. If the object
  1559. //      supports IRunnableTask as well, then long extractions can be started and paused as appropriate.
  1560. //      At this point it is asssumed the object is free-threaded.
  1561. //      If dwRecClrDepth contains a recommended Colour depth
  1562. //      If *phBmpthumbnail is non NULL, then it contains the destination bitmap that should be used.
  1564. cpp_quote("#define IEI_PRIORITY_MAX        ITSAT_MAX_PRIORITY")
  1565. cpp_quote("#define IEI_PRIORITY_MIN        ITSAT_MIN_PRIORITY")
  1566. cpp_quote("#define IEIT_PRIORITY_NORMAL     ITSAT_DEFAULT_PRIORITY")
  1568. cpp_quote("#define IEIFLAG_ASYNC       0x0001      // ask the extractor if it supports ASYNC extract (free threaded)")
  1569. cpp_quote("#define IEIFLAG_CACHE       0x0002      // returned from the extractor if it does NOT cache the thumbnail")
  1570. cpp_quote("#define IEIFLAG_ASPECT      0x0004      // passed to the extractor to beg it to render to the aspect ratio of the supplied rect")
  1571. cpp_quote("#define IEIFLAG_OFFLINE     0x0008      // if the extractor shouldn't hit the net to get any content neede for the rendering")
  1572. cpp_quote("#define IEIFLAG_GLEAM       0x0010      // does the image have a gleam ? this will be returned if it does")
  1573. cpp_quote("#define IEIFLAG_SCREEN      0x0020      // render as if for the screen  (this is exlusive with IEIFLAG_ASPECT )")
  1574. cpp_quote("#define IEIFLAG_ORIGSIZE    0x0040      // render to the approx size passed, but crop if neccessary")
  1575. cpp_quote("#define IEIFLAG_NOSTAMP     0x0080      // returned from the extractor if it does NOT want an icon stamp on the thumbnail")
  1576. cpp_quote("#define IEIFLAG_NOBORDER    0x0100      // returned from the extractor if it does NOT want an a border around the thumbnail")
  1577. cpp_quote("#define IEIFLAG_QUALITY     0x0200      // passed to the Extract method to indicate that a slower, higher quality image is desired, re-compute the thumbnail")
  1579. [
  1580.     helpstring("IExtractImage"),
  1581.     uuid(BB2E617C-0920-11d1-9A0B-00C04FC2D6C1),
  1582.     object,
  1583.     pointer_default(unique)
  1584. ]
  1585. interface IExtractImage : IUnknown
  1586. {
  1587.     HRESULT GetLocation([out, size_is(cch)] LPWSTR pszPathBuffer,
  1588.                         [in] DWORD cch,
  1589.                         [in, out, unique] DWORD *pdwPriority,
  1590.                         [in] const SIZE * prgSize,
  1591.                         [in] DWORD dwRecClrDepth,
  1592.                         [in] DWORD *pdwFlags);
  1594.    HRESULT Extract([out] HBITMAP *phBmpThumbnail);
  1595. }
  1596. typedef IExtractImage * LPEXTRACTIMAGE;
  1598. cpp_quote("#endif")
  1600. cpp_quote("#if (_WIN32_IE >= 0x0500)")
  1602. // GetDateStamp : returns the date stamp associated with the image. If this image is already cached,
  1603. //                then it is easy to find out if the image is out of date.
  1605. [
  1606.     helpstring("IExtractImage2"),
  1607.     uuid(953BB1EE-93B4-11d1-98A3-00C04FB687DA),
  1608.     object,
  1609.     pointer_default(unique)
  1610. ]
  1611. interface IExtractImage2 : IExtractImage
  1612. {
  1613.     HRESULT GetDateStamp([out] FILETIME *pDateStamp);
  1614. }
  1615. typedef IExtractImage2 * LPEXTRACTIMAGE2;
  1617. cpp_quote("#endif")
  1621. //-------------------------------------------------------------------------
  1622. //
  1623. // IUserEventTimerCallback interface
  1624. //
  1625. //-------------------------------------------------------------------------
  1626. interface IUserEventTimerCallback;
  1627. [
  1628.     helpstring("IUserEventTimerCallback "),
  1629.     uuid(e9ead8e6-2a25-410e-9b58-a9fbef1dd1a2),     // IID_IUserEventTimerCallback
  1630.     object,
  1631.     pointer_default(unique)
  1632. ]
  1634. interface IUserEventTimerCallback : IUnknown
  1635. {
  1636.     HRESULT UserEventTimerProc(
  1637.         [in] ULONG uUserEventTimerID,
  1638.         [in] UINT uTimerElapse); 
  1639. };
  1642. //-------------------------------------------------------------------------
  1643. //
  1644. // IUserEventTimer interface
  1645. //
  1646. //  Timer to keep track of user presence at the machine
  1647. //
  1648. //-------------------------------------------------------------------------
  1649. interface IUserEventTimer;
  1650. [
  1651.     helpstring("IUserEventTimer "),
  1652.     uuid(0F504B94-6E42-42E6-99E0-E20FAFE52AB4),     // IID_IUserEventTimer
  1653.     object,
  1654.     pointer_default(unique)
  1655. ]
  1657. interface IUserEventTimer : IUnknown
  1658. {
  1659.     HRESULT SetUserEventTimer
  1660.     (
  1661.         [in] HWND hWnd,
  1662.         [in] UINT uCallbackMessage,
  1663.         [in] UINT uTimerElapse,
  1664.         [in] IUserEventTimerCallback * pUserEventTimerCallback,
  1665.         [in, out] ULONG * puUserEventTimerID
  1666.     );
  1668.     HRESULT KillUserEventTimer 
  1669.     (    
  1670.         [in] HWND hWnd,
  1671.         [in] ULONG uUserEventTimerID 
  1672.     );
  1674.     HRESULT GetUserEventTimerElapsed
  1675.     (
  1676.         [in] HWND hWnd,
  1677.         [in] ULONG uUserEventTimerID,
  1678.         [out] UINT * puTimerElapsed 
  1679.     );
  1681.     HRESULT InitTimerTickInterval
  1682.     (
  1683.         [in] UINT uTimerTickIntervalMs
  1684.     );                            
  1685. };
  1688. //-------------------------------------------------------------------------
  1689. //
  1690. // IDockingWindow interface
  1691. //
  1692. //   An object (docking window) implements this interface so the site can
  1693. // communicate with it.  An example of a docking window is a toolbar.
  1694. //
  1695. // [Member functions]
  1696. //
  1697. // IDockingWindow::ShowDW(fShow)
  1698. //   Shows or hides the docking window.
  1699. //
  1700. // IDockingWindow::CloseDW(dwReserved)
  1701. //   Closes the docking window.  dwReserved must be 0.
  1702. //
  1703. // IDockingWindow::ResizeBorderDW(prcBorder, punkToolbarSite, fReserved)
  1704. //   Resizes the docking window's border to *prcBorder.  fReserved must
  1705. //   be 0.
  1706. //
  1707. // IObjectWithSite::SetSite(punkSite)
  1708. //   IDockingWindow usually paired with IObjectWithSite.
  1709. //   Provides the IUnknown pointer of the site to the docking window.
  1710. //
  1711. //-------------------------------------------------------------------------
  1713. [
  1714.     uuid(012dd920-7b26-11d0-8ca9-00a0c92dbfe8),
  1715.     object
  1716. ]
  1717. interface IDockingWindow : IOleWindow
  1718. {
  1719.     HRESULT ShowDW([in] BOOL fShow);
  1720.     HRESULT CloseDW([in] DWORD dwReserved);
  1721.     HRESULT ResizeBorderDW([in] LPCRECT prcBorder, [in] IUnknown* punkToolbarSite, [in] BOOL fReserved);
  1722. };
  1724. //-------------------------------------------------------------------------
  1725. //
  1726. // IDeskBand interface
  1727. //
  1728. //
  1729. // [Member functions]
  1730. //
  1731. // IDeskBand::GetBandInfo(dwBandID, dwViewMode, pdbi)
  1732. //   Returns info on the given band in *pdbi, according to the mask
  1733. //   field in the DESKBANDINFO structure and the given viewmode.
  1734. //
  1735. //-------------------------------------------------------------------------
  1738. // Mask values for DESKBANDINFO
  1739. cpp_quote("#define DBIM_MINSIZE    0x0001")
  1740. cpp_quote("#define DBIM_MAXSIZE    0x0002")
  1741. cpp_quote("#define DBIM_INTEGRAL   0x0004")
  1742. cpp_quote("#define DBIM_ACTUAL     0x0008")
  1743. cpp_quote("#define DBIM_TITLE      0x0010")
  1744. cpp_quote("#define DBIM_MODEFLAGS  0x0020")
  1745. cpp_quote("#define DBIM_BKCOLOR    0x0040")
  1747. cpp_quote("#include <pshpack8.h>")
  1749. typedef struct {
  1750.     DWORD       dwMask;
  1751.     POINTL      ptMinSize;
  1752.     POINTL      ptMaxSize;
  1753.     POINTL      ptIntegral;
  1754.     POINTL      ptActual;
  1755.     WCHAR       wszTitle[256];
  1756.     DWORD       dwModeFlags;
  1757.     COLORREF    crBkgnd;
  1758. } DESKBANDINFO;
  1760. cpp_quote("#include <poppack.h>")   // Return to byte packing
  1762. // DESKBANDINFO dwModeFlags values
  1763. cpp_quote("#define DBIMF_NORMAL            0x0000")
  1764. cpp_quote("#define DBIMF_FIXED             0x0001")
  1765. cpp_quote("#define DBIMF_FIXEDBMP          0x0004   // a fixed background bitmap (if supported)")
  1766. cpp_quote("#define DBIMF_VARIABLEHEIGHT    0x0008")
  1767. cpp_quote("#define DBIMF_UNDELETEABLE      0x0010")
  1768. cpp_quote("#define DBIMF_DEBOSSED          0x0020")
  1769. cpp_quote("#define DBIMF_BKCOLOR           0x0040")
  1770. cpp_quote("#define DBIMF_USECHEVRON        0x0080")
  1771. cpp_quote("#define DBIMF_BREAK             0x0100")
  1772. cpp_quote("#define DBIMF_ADDTOFRONT        0x0200")
  1773. cpp_quote("#define DBIMF_TOPALIGN          0x0400")
  1775. // GetBandInfo view mode values
  1776. cpp_quote("#define DBIF_VIEWMODE_NORMAL         0x0000")
  1777. cpp_quote("#define DBIF_VIEWMODE_VERTICAL       0x0001")
  1778. cpp_quote("#define DBIF_VIEWMODE_FLOATING       0x0002")
  1779. cpp_quote("#define DBIF_VIEWMODE_TRANSPARENT    0x0004")
  1781. // Command Target IDs
  1782. enum {
  1783.     DBID_BANDINFOCHANGED    = 0,
  1784.     DBID_SHOWONLY           = 1,
  1785.     DBID_MAXIMIZEBAND       = 2,      // Maximize the specified band (VT_UI4 == dwID)
  1786.     DBID_PUSHCHEVRON        = 3,
  1787.     DBID_DELAYINIT          = 4,      // Note: _bandsite_ calls _band_ with this code
  1788.     DBID_FINISHINIT         = 5,      // Note: _bandsite_ calls _band_ with this code
  1789.     DBID_SETWINDOWTHEME     = 6,      // Note: _bandsite_ calls _band_ with this code
  1790.     DBID_PERMITAUTOHIDE     = 7,
  1791. };
  1793. cpp_quote("#define DBPC_SELECTFIRST    (DWORD)-1")
  1794. cpp_quote("#define DBPC_SELECTLAST     (DWORD)-2")
  1796. cpp_quote("#define CGID_DeskBand IID_IDeskBand")
  1798. [
  1799.     uuid(EB0FE172-1A3A-11D0-89B3-00A0C90A90AC),
  1800.     object,
  1801. ]
  1802. interface IDeskBand : IDockingWindow
  1803. {
  1804.     HRESULT GetBandInfo([in] DWORD dwBandID, [in] DWORD dwViewMode, [in, out] DESKBANDINFO* pdbi);
  1805. };
  1808. //-------------------------------------------------------------------------
  1809. //
  1810. // ITaskbarList interface
  1811. //
  1812. //
  1813. // [Member functions]
  1814. //
  1815. // ITaskbarList::HrInit()
  1816. //   This function must be called first to validate use of other members.
  1817. //
  1818. // ITaskbarList::AddTab(hwnd)
  1819. //   This function adds a tab for hwnd to the taskbar.
  1820. //
  1821. // ITaskbarList::DeleteTab(hwnd)
  1822. //   This function deletes a tab for hwnd from the taskbar.
  1823. //
  1824. // ITaskbarList::ActivateTab(hwnd)
  1825. //   This function activates the tab associated with hwnd on the taskbar.
  1826. //
  1827. // ITaskbarList::SetActivateAlt(hwnd)
  1828. //   This function marks hwnd in the taskbar as the active tab
  1829. //
  1830. //-------------------------------------------------------------------------
  1831. [
  1832.     uuid(56FDF342-FD6D-11d0-958A-006097C9A090),
  1833.     object,
  1834. ]
  1835. interface ITaskbarList : IUnknown
  1836. {
  1837.     HRESULT HrInit();
  1838.     HRESULT AddTab([in] HWND hwnd);
  1839.     HRESULT DeleteTab([in] HWND hwnd);
  1840.     HRESULT ActivateTab([in] HWND hwnd);
  1841.     HRESULT SetActiveAlt([in] HWND hwnd);
  1842. };
  1844. [
  1845.     uuid(602D4995-B13A-429b-A66E-1935E44F4317),
  1846.     object,
  1847. ]
  1848. interface ITaskbarList2 : ITaskbarList
  1849. {
  1850.     HRESULT MarkFullscreenWindow([in] HWND hwnd, [in] BOOL fFullscreen);
  1851. };
  1854. [
  1855.     object,
  1856.     uuid(3d73a659-e5d0-4d42-afc0-5121ba425c8d),     // IID_ICDBurn
  1857.     pointer_default(unique)
  1858. ]
  1859. interface ICDBurn : IUnknown
  1860. {
  1861.     HRESULT GetRecorderDriveLetter([out, size_is(cch)] LPWSTR pszDrive, [in] UINT cch);
  1862.     HRESULT Burn([in] HWND hwnd);
  1863.     HRESULT HasRecordableDrive([out] BOOL *pfHasRecorder);
  1864. };
  1866. [
  1867.     uuid(C9D81948-443A-40C7-945C-5E171B8C66B4),
  1868.     object,
  1869.     pointer_default(unique)
  1870. ]
  1871. interface IAddressBarParser : IUnknown
  1872. {
  1873.     HRESULT ParseFromOutsideSource([in, string] LPCWSTR pcszUrlIn, [in] DWORD dwParseFlags, [out] BOOL *pfWasCorrected);
  1874.     HRESULT GetUrl([out, size_is(cchUrlOutSize) ] LPWSTR pszUrlOut, [in] DWORD cchUrlOutSize);
  1875.     HRESULT SetUrl([in, string] LPCWSTR pcszUrlIn, [in] DWORD dwGenType);
  1876.     HRESULT GetDisplayName([out, size_is(cchUrlOutSize)] LPWSTR pszUrlOut, [in] DWORD cchUrlOutSize);
  1877.     HRESULT GetPidl([out] LPITEMIDLIST * ppidl);
  1878.     HRESULT SetPidl([in] LPCITEMIDLIST pidl);
  1879.     HRESULT GetArgs([out, size_is(cchArgsOutSize)] LPWSTR pszArgsOut, [in]DWORD cchArgsOutSize);
  1880.     HRESULT AddPath([in] LPCITEMIDLIST pidl);
  1881. };
  1883. // Wizard Extension objects.  These interfaces defined methods for extending 
  1884. // Win32 wizard in a progromatic way.
  1886. // Range of ID's that extensions can used, these mustn't clash with
  1887. // the existing wizards dialog IDS.  (That enables them to still
  1888. // do PropSheet_SetCurSelByID).
  1890. cpp_quote("#define IDD_WIZEXTN_FIRST    0x5000")
  1891. cpp_quote("#define IDD_WIZEXTN_LAST     0x5100")
  1894. // This site object is requested via a QueryService of the objects site,
  1895. // it allows the extension to navigate in/out out itself, eg. when the
  1896. // extension has shown all of its pages and wants to navigate to the
  1897. // next page it would call GetNextPage and select the specified HPAGE.
  1899. [
  1900.     uuid(88960f5b-422f-4e7b-8013-73415381c3c3),
  1901.     helpstring("Wizard Extension Site"),
  1902.     local
  1903. ]
  1904. interface IWizardSite : IUnknown
  1905. {
  1906.     HRESULT GetPreviousPage([out] HPROPSHEETPAGE *phpage);
  1907.     HRESULT GetNextPage([out] HPROPSHEETPAGE *phpage);
  1908.     HRESULT GetCancelledPage([out] HPROPSHEETPAGE *phpage);
  1909. };
  1911. // A wizard extension is implemented using this object, the extension will declare the
  1912. // pages that it supports using the AddPages method, and then when its host needs to navigate
  1913. // into the extenion it will do so via GetFirstPage and selecting that.
  1915. [
  1916.     uuid(c02ea696-86cc-491e-9b23-74394a0444a8),
  1917.     helpstring("Wizard Extension"),
  1918.     local
  1919. ]
  1920. interface IWizardExtension : IUnknown
  1921. {
  1922.     HRESULT AddPages([in, out] HPROPSHEETPAGE* aPages, [in] UINT cPages, [out] UINT *pnPagesAdded);
  1923.     HRESULT GetFirstPage([out] HPROPSHEETPAGE *phpage);
  1924.     HRESULT GetLastPage([out] HPROPSHEETPAGE *phpage);
  1925. };
  1928. // The Web Wizard is a HTML host for wizard pages, it allows you
  1929. // create a HTML wizard starting at the URL defined via SetInitialURL.
  1931. [
  1932.     helpstring("Web Wizard Page Extension"),
  1933.     uuid(0e6b3f66-98d1-48c0-a222-fbde74e2fbc5),
  1934.     object,
  1935.     pointer_default(unique)
  1936. ]
  1937. interface IWebWizardExtension : IWizardExtension
  1938. {
  1939.     HRESULT SetInitialURL([in, string] LPCWSTR pszURL);
  1940.     HRESULT SetErrorURL([in, string] LPCWSTR pszErrorURL);
  1941. };
  1943. cpp_quote("#define SID_WebWizardHost IID_IWebWizardExtension")
  1946. // flags for the host to control the publishing wizard
  1948. cpp_quote ("#define SHPWHF_NORECOMPRESS             0x00000001  // don't allow/prompt for recompress of streams")
  1949. cpp_quote ("#define SHPWHF_NONETPLACECREATE         0x00000002  // don't create a network place when transfer is complete")
  1950. cpp_quote ("#define SHPWHF_NOFILESELECTOR           0x00000004  // don't show the file selector")
  1951. cpp_quote ("#define SHPWHF_VALIDATEVIAWEBFOLDERS    0x00010000  // enable web folders to validate network places (ANP support)")
  1953. [ 
  1954.     helpstring("Web Publishing Wizard"),
  1955.     uuid(aa9198bb-ccec-472d-beed-19a4f6733f7a),
  1956.     object,
  1957.     pointer_default(unique)
  1958. ]
  1959. interface IPublishingWizard : IWizardExtension
  1960. {
  1961.     HRESULT Initialize([in] IDataObject *pdo, [in] DWORD dwOptions, [in, string] LPCWSTR pszServiceProvider);
  1962.     HRESULT GetTransferManifest([out] HRESULT *phrFromTransfer, [out] IXMLDOMDocument **pdocManifest);
  1963. }
  1966. // Object to host an IFolderView in a window.  This is used to build check mark selection
  1967. // UI for files.
  1969. [
  1970.     uuid(1ea58f02-d55a-411d-b09e-9e65ac21605b),
  1971.     helpstring("Shell Folder Host"),
  1972.     local,
  1973. ]
  1974. interface IFolderViewHost : IUnknown
  1975. {
  1976.     HRESULT Initialize([in] HWND hwndParent, [in] IDataObject *pdo, [in] RECT *prc);
  1977. };
  1980. //
  1981. //  Flags for IAutoCompleteDropDown::GetDropDownStatus
  1982. //
  1983. cpp_quote("#define ACDD_VISIBLE        0x0001")
  1985. [
  1986.     uuid(3CD141F4-3C6A-11d2-BCAA-00C04FD929DB),
  1987.     object,
  1988.     pointer_default(unique)
  1989. ]
  1990. interface IAutoCompleteDropDown : IUnknown
  1991. {
  1992.     HRESULT GetDropDownStatus([out] DWORD *pdwFlags, [out, string] LPWSTR *ppwszString);
  1993.     HRESULT ResetEnumerator();
  1994. };
  1996. //
  1997. //  NOTE - this typelib is never registered anywhere
  1998. //  objects that want their typelibs to be registered 
  1999. //  in shell32 should add their coclass to shldisp.idl
  2000. //
  2001. [
  2002.     uuid(50a7e9b1-70ef-11d1-b75a-00a0c90564fe), // LIBID_ShellObjects
  2003.     helpstring("Microsoft Shell Objects"),
  2004.     lcid(0x0000),
  2005.     version(1.0)
  2006. ]
  2007. library ShellObjects
  2008. {    
  2009.     // CLSID_QueryCancelAutoPlay
  2010.     [ uuid(331F1768-05A9-4ddd-B86E-DAE34DDC998A) ] coclass QueryCancelAutoPlay { interface IQueryCancelAutoPlay; }
  2012.     // CLSID_DriveSizeCategorizer
  2013.     [ uuid(94357B53-CA29-4b78-83AE-E8FE7409134F) ] coclass DriveSizeCategorizer { interface ICategorizer; }
  2015.     // CLSID_DriveTypeCategorizer
  2016.     [ uuid(B0A8F3CF-4333-4bab-8873-1CCB1CADA48B) ] coclass DriveTypeCategorizer { interface ICategorizer; }
  2018.     // CLSID_FreeSpaceCategorizer
  2019.     [ uuid(B5607793-24AC-44c7-82E2-831726AA6CB7) ] coclass FreeSpaceCategorizer { interface ICategorizer; }
  2021.     // CLSID_TimeCategorizer
  2022.     [ uuid(3bb4118f-ddfd-4d30-a348-9fb5d6bf1afe) ] coclass TimeCategorizer { interface ICategorizer; }
  2024.     // CLSID_SizeCategorizer
  2025.     [ uuid(55d7b852-f6d1-42f2-aa75-8728a1b2d264) ] coclass SizeCategorizer { interface ICategorizer; }
  2027.     // CLSID_AlphabeticalCategorizer
  2028.     [ uuid(3c2654c6-7372-4f6b-b310-55d6128f49d2) ] coclass AlphabeticalCategorizer { interface ICategorizer; }
  2030.     // CLSID_MergedCategorizer
  2031.     [ uuid(8e827c11-33e7-4bc1-b242-8cd9a1c2b304) ] coclass MergedCategorizer { interface ICategorizer; }
  2033.     // CLSID_ImageProperties
  2034.     [ uuid(7ab770c7-0e23-4d7a-8aa2-19bfad479829) ] coclass ImageProperties { interface IPersistFile; }
  2036.     // CLSID_ImageProperties
  2037.     [ uuid(d912f8cf-0396-4915-884e-fb425d32943b) ] coclass PropertiesUI { interface IPropertyUI; }
  2039.     // CLSID_UserNotification
  2040.     [ uuid(0010890e-8789-413c-adbc-48f5b511b3af) ] coclass UserNotification { interface IUserNotification; }
  2042.     // CLSID_UserEventTimerCallback
  2043.     [ uuid(15fffd13-5140-41b8-b89a-c8d5759cd2b2) ] coclass UserEventTimerCallback { interface IUserEventTimerCallback; }
  2045.     // CLSID_UserEventTimer
  2046.     [ uuid(864A1288-354C-4D19-9D68-C2742BB14997) ] coclass UserEventTimer { interface IUserEventTimer; }
  2048.     // CLSID_NetCrawler
  2049.     [ uuid(601ac3dc-786a-4eb0-bf40-ee3521e70bfb) ] coclass NetCrawler { interface INetCrawler; }
  2051.     // CLSID_CDBurn
  2052.     [ uuid(fbeb8a05-beee-4442-804e-409d6c4515e9) ] coclass CDBurn { interface ICDBurn; }
  2054.     // CLSID_AddressBarParser
  2055.     [ uuid(e0e11a09-5cb8-4b6c-8332-e00720a168f2) ] coclass AddressBarParser { interface IAddressBarParser; }
  2057.     // CLSID_TaskbarList
  2058.     [ uuid(56FDF344-FD6D-11d0-958A-006097C9A090) ] coclass TaskbarList { interface ITaskbarList; }
  2060.     // For supporting HTML wizard extensions we provide this object, it implements the IWizardExtenion
  2061.     // and allows the site to specific via an IPropertyBag an URL which should be displayed.  The property
  2062.     // bag is requested from the SID_WebWizardHost, and it used inturn to return parameter information
  2063.     // back to the site (eg. any information that the displayed HTML would like to communicate).
  2064.     
  2065.     // CLSID_WebWizardHost
  2066.     [ uuid(c827f149-55c1-4d28-935e-57e47caed973) ] coclass WebWizardHost { interface IWebWizardExtension; }
  2068.     // CLSID_PublishDropTarget
  2069.     [ uuid(CC6EEFFB-43F6-46c5-9619-51D571967F7D) ] coclass PublishDropTarget { interface IDropTarget; }
  2071.     // CLSID_PublishingWizard
  2072.     [ uuid(6b33163c-76a5-4b6c-bf21-45de9cd503a1) ] coclass PublishingWizard { interface IPublishingWizard; }
  2073.     cpp_quote("#define SID_PublishingWizard CLSID_PublishingWizard")
  2075.     // CLSID_InternetPrintOrdering
  2076.     [ uuid(add36aa8-751a-4579-a266-d66f5202ccbb) ] coclass InternetPrintOrdering { interface IDropTarget; }
  2078.     // CLSID_FolderViewHost
  2079.     [ uuid(20b1cb23-6968-4eb9-b7d4-a66d00d07cee) ] coclass FolderViewHost { interface IFolderViewHost; }
  2080. };