msxml3/tests: Add test saving XML with non-english characters.
[wine.git] / include / shobjidl.idl
blobc1a36ab5e93cf8da8987bb579b315cbf35224d42
1 /*
2 * COM interfaces for shell objects
4 * Copyright (C) 1999 Juergen Schmied
5 * Copyright (C) 2003 Alexandre Julliard
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.
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.
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
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"; */
37 cpp_quote("/* FIXME: #include <sherrors.h> */")
40 /*****************************************************************************
41 * IPersistFolder interface
44 object,
45 uuid(000214ea-0000-0000-c000-000000000046),
46 pointer_default(unique)
48 interface IPersistFolder : IPersist
50 typedef IPersistFolder *LPPERSISTFOLDER;
52 HRESULT Initialize( [in] LPCITEMIDLIST pidl );
56 /*****************************************************************************
57 * IPersistFolder2 interface
60 object,
61 uuid(1ac3d9f0-175c-11d1-95be-00609797ea4f),
62 pointer_default(unique)
64 interface IPersistFolder2 : IPersistFolder
66 typedef IPersistFolder2 *LPPERSISTFOLDER2;
68 HRESULT GetCurFolder( [out] LPITEMIDLIST *ppidl );
72 /*****************************************************************************
73 * IPersistIDList interface
76 object,
77 uuid(1079acfc-29bd-11d3-8e0d-00c04f6837d5),
78 pointer_default(unique)
80 interface IPersistIDList : IPersist
82 HRESULT SetIDList( [in] LPCITEMIDLIST pidl );
83 HRESULT GetIDList( [out] LPITEMIDLIST *ppidl );
87 /*****************************************************************************
88 * IEnumIDList interface
91 object,
92 uuid(000214f2-0000-0000-c000-000000000046),
93 pointer_default(unique)
95 interface IEnumIDList : IUnknown
97 typedef IEnumIDList *LPENUMIDLIST;
99 HRESULT Next(
100 [in] ULONG celt,
101 [out, size_is(celt), length_is(*pceltFetched)] LPITEMIDLIST *rgelt,
102 [out] ULONG *pceltFetched);
104 HRESULT Skip( [in] ULONG celt );
105 HRESULT Reset();
106 HRESULT Clone( [out] IEnumIDList **ppenum );
109 /*****************************************************************************
110 * IShellPropSheetExt interface
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")
120 object,
121 uuid(000214E9-0000-0000-C000-000000000046),
122 pointer_default(unique),
123 local
125 interface IShellPropSheetExt : IUnknown
127 enum tagSHELLPROPSHEETEXTPAGEID {
128 EXPPS_FILETYPES = 0x1
131 typedef UINT EXPPS;
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);
141 typedef IShellPropSheetExt *LPSHELLPROPSHEETEXT;
143 /*****************************************************************************
144 * IShellFolder interface
147 object,
148 uuid(000214e6-0000-0000-c000-000000000046),
149 pointer_default(unique)
151 interface IShellFolder : IUnknown
153 typedef IShellFolder * LPSHELLFOLDER;
155 typedef enum tagSHGDN
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;
165 typedef DWORD SHGDNF;
167 enum tagSHCONTF
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
184 typedef DWORD SHCONTF;
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")
222 typedef ULONG SFGAOF;
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);
232 HRESULT EnumObjects(
233 [in] HWND hwndOwner,
234 [in] SHCONTF grfFlags,
235 [out] IEnumIDList **ppenumIDList);
237 HRESULT BindToObject(
238 [in] LPCITEMIDLIST pidl,
239 [in] LPBC pbcReserved,
240 [in] REFIID riid,
241 [out, iid_is(riid)] void **ppvOut);
243 HRESULT BindToStorage(
244 [in] LPCITEMIDLIST pidl,
245 [in] LPBC pbcReserved,
246 [in] REFIID riid,
247 [out, iid_is(riid)] void **ppvObj);
249 HRESULT CompareIDs(
250 [in] LPARAM lParam,
251 [in] LPCITEMIDLIST pidl1,
252 [in] LPCITEMIDLIST pidl2);
254 HRESULT CreateViewObject(
255 [in] HWND hwndOwner,
256 [in] REFIID riid,
257 [out, iid_is(riid)] void **ppvOut);
259 HRESULT GetAttributesOf(
260 [in] UINT cidl,
261 [in, size_is(cidl)] LPCITEMIDLIST *apidl,
262 [in, out] SFGAOF *rgfInOut);
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);
272 HRESULT GetDisplayNameOf(
273 [in] LPCITEMIDLIST pidl,
274 [in] SHGDNF uFlags,
275 [out] STRRET *lpName);
277 HRESULT SetNameOf(
278 [in] HWND hwnd,
279 [in] LPCITEMIDLIST pidl,
280 [in, string] LPCOLESTR lpszName,
281 [in] SHGDNF uFlags,
282 [out] LPITEMIDLIST *ppidlOut);
286 /*****************************************************************************
287 * IEnumExtraSearch interface
290 object,
291 uuid(0e700be1-9db6-11d1-a1ce-00c04fd75d13),
292 pointer_default(unique)
294 interface IEnumExtraSearch : IUnknown
296 typedef IEnumExtraSearch *LPENUMEXTRASEARCH;
298 typedef struct
300 GUID guidSearch;
301 WCHAR wszFriendlyName[80];
303 *WCHAR wszMenuText[80];
304 *WCHAR wszHelpText[MAX_PATH];
306 WCHAR wszUrl[2084];
308 *WCHAR wszIcon[MAX_PATH+10];
309 *WCHAR wszGreyIcon[MAX_PATH+10];
310 *WCHAR wszClrIcon[MAX_PATH+10];
312 } EXTRASEARCH, *LPEXTRASEARCH;
314 HRESULT Next(
315 [in] ULONG celt,
316 [out, size_is(celt), length_is(*pceltFetched)] EXTRASEARCH *rgelt,
317 [out] ULONG *pceltFetched);
319 HRESULT Skip( [in] ULONG celt );
320 HRESULT Reset();
321 HRESULT Clone( [out] IEnumExtraSearch **ppenum );
325 /*****************************************************************************
326 * IShellFolder2 interface
329 object,
330 uuid(93f2f68c-1d1b-11d3-a30e-00c04f79abd1),
331 pointer_default(unique)
333 interface IShellFolder2 : IShellFolder
335 typedef struct
337 GUID fmtid;
338 DWORD pid;
339 } SHCOLUMNID, *LPSHCOLUMNID;
340 typedef const SHCOLUMNID *LPCSHCOLUMNID;
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 );
351 /*****************************************************************************
352 * IShellItem interface
355 object,
356 uuid(43826d1e-e718-42ee-bc55-a1e261c37bfe),
357 pointer_default(unique)
359 interface IShellItem : IUnknown
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 */
374 [v1_enum] enum _SICHINTF
376 SICHINT_DISPLAY = 0x00000000,
377 SICHINT_CANONICAL = 0x10000000,
378 SICHINT_TEST_FILESYSPATH_IF_NOT_EQUAL = 0x20000000,
379 SICHINT_ALLFIELDS = 0x80000000
381 typedef DWORD SICHINTF;
383 HRESULT BindToHandler(
384 [in] IBindCtx *pbc,
385 [in] REFGUID rbhid,
386 [in] REFIID riid,
387 [out, iid_is(riid)] void **ppvOut);
389 HRESULT GetParent( [out] IShellItem **ppsi );
391 HRESULT GetDisplayName(
392 [in] SIGDN sigdnName,
393 [out] LPWSTR *ppszName);
395 HRESULT GetAttributes(
396 [in] SFGAOF sfgaoMask,
397 [out] SFGAOF *psfgaoAttribs);
399 HRESULT Compare(
400 [in] IShellItem *psi,
401 [in] SICHINTF hint,
402 [out] int *piOrder);
405 /*****************************************************************************
406 * IShellItem2 interface
409 object,
410 uuid(7E9FB0D3-919F-4307-AB2E-9B1860310C93),
411 pointer_default(unique)
413 interface IShellItem2 : IShellItem
415 HRESULT GetPropertyStore(
416 [in] GETPROPERTYSTOREFLAGS flags,
417 [in] REFIID riid,
418 [out, iid_is(riid)] void **ppv);
420 HRESULT GetPropertyStoreWithCreateObject(
421 [in] GETPROPERTYSTOREFLAGS flags,
422 [in] IUnknown *punkCreateObject,
423 [in] REFIID riid,
424 [out, iid_is(riid)] void **ppv);
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);
433 HRESULT GetPropertyDescriptionList(
434 [in] REFPROPERTYKEY keyType,
435 [in] REFIID riid,
436 [out, iid_is(riid)] void **ppv);
438 HRESULT Update(
439 [in, unique] IBindCtx *pbc);
441 HRESULT GetProperty(
442 [in] REFPROPERTYKEY key,
443 [out] PROPVARIANT *ppropvar);
445 HRESULT GetCLSID(
446 [in] REFPROPERTYKEY key,
447 [out] CLSID *pclsid);
449 HRESULT GetFileTime (
450 [in] REFPROPERTYKEY key,
451 [out] FILETIME *pft);
453 HRESULT GetInt32(
454 [in] REFPROPERTYKEY key,
455 [out] int *pi);
457 HRESULT GetString(
458 [in] REFPROPERTYKEY key,
459 [out, string] LPWSTR *ppsz);
461 HRESULT GetUInt32(
462 [in] REFPROPERTYKEY key,
463 [out] ULONG *pui);
465 HRESULT GetUInt64(
466 [in] REFPROPERTYKEY key,
467 [out] ULONGLONG *pull);
469 HRESULT GetBool(
470 [in] REFPROPERTYKEY key,
471 [out] BOOL *pf);
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;
492 uuid(d2bc4c84-3f72-4a52-a604-7bcbf3982cbb),
493 object,
494 pointer_default(unique)
496 interface INewWindowManager : IUnknown
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);
508 cpp_quote("#define SID_SNewWindowManager IID_INewWindowManager")
510 /*****************************************************************************
511 * IEnumShellItems interface
514 object,
515 uuid(70629033-E363-4A28-A567-0DB78006E6D7),
516 pointer_default(unique)
518 interface IEnumShellItems : IUnknown
520 [local] HRESULT Next(
521 [in] ULONG celt,
522 [out, size_is(celt), length_is(*pceltFetched)] IShellItem **rgelt,
523 [out] ULONG *pceltFetched);
525 [call_as(Next)] HRESULT RemoteNext(
526 [in] ULONG celt,
527 [out, size_is(celt), length_is(*pceltFetched)] IShellItem **rgelt,
528 [out] ULONG *pceltFetched);
530 HRESULT Skip(
531 [in] ULONG celt);
533 HRESULT Reset();
535 HRESULT Clone(
536 [out] IEnumShellItems **ppenum);
539 /*****************************************************************************
540 * IShellItemArray interface
543 object,
544 uuid(B63EA76D-1F85-456F-A19C-48159EFA858B),
545 pointer_default(unique)
547 interface IShellItemArray : IUnknown
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)")
558 HRESULT BindToHandler(
559 [in, unique] IBindCtx *pbc,
560 [in] REFGUID bhid,
561 [in] REFIID riid,
562 [out, iid_is(riid)] void **ppvOut);
564 HRESULT GetPropertyStore(
565 [in] GETPROPERTYSTOREFLAGS flags,
566 [in] REFIID riid,
567 [out, iid_is(riid)] void **ppv);
569 HRESULT GetPropertyDescriptionList(
570 [in] REFPROPERTYKEY keyType,
571 [in] REFIID riid,
572 [out, iid_is(riid)] void **ppv);
574 HRESULT GetAttributes(
575 [in] SIATTRIBFLAGS AttribFlags,
576 [in] SFGAOF sfgaoMask,
577 [out] SFGAOF *psfgaoAttribs);
579 HRESULT GetCount(
580 [out] DWORD *pdwNumItems);
582 HRESULT GetItemAt(
583 [in] DWORD dwIndex,
584 [out] IShellItem **ppsi);
586 HRESULT EnumItems(
587 [out] IEnumShellItems **ppenumShellItems);
591 typedef [v1_enum] enum DATAOBJ_GET_ITEM_FLAGS
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)")
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);")
614 /*****************************************************************************
615 * IShellItemFilter interface
618 object,
619 uuid(2659B475-EEB8-48B7-8F07-B378810F48CF),
620 pointer_default(unique)
622 interface IShellItemFilter : IUnknown
624 HRESULT IncludeItem(
625 [in] IShellItem *psi);
627 HRESULT GetEnumFlagsForItem(
628 [in] IShellItem *psi,
629 [out] SHCONTF *pgrfFlags);
632 /*****************************************************************************
633 * FOLDERSETTINGS
635 typedef char *LPVIEWSETTINGS;
637 typedef [v1_enum] enum FOLDERFLAGS
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;
673 typedef [v1_enum] enum FOLDERVIEWMODE
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;
688 typedef struct
690 UINT ViewMode;
691 UINT fFlags;
692 } FOLDERSETTINGS, *PFOLDERSETTINGS, *LPFOLDERSETTINGS;
693 typedef const FOLDERSETTINGS *LPCFOLDERSETTINGS;
695 /*****************************************************************************
696 * IShellIcon interface
699 uuid(000214e5-0000-0000-c000-000000000046),
700 object,
701 pointer_default(unique)
703 interface IShellIcon : IUnknown
705 HRESULT GetIconOf(
706 [in] PCUITEMID_CHILD pidl,
707 [in] UINT flags,
708 [out] int *pIconIndex);
711 /*****************************************************************************
712 * IShellView interface
714 interface IShellBrowser; /* forward declaration */
716 object,
717 uuid(000214e3-0000-0000-c000-000000000046),
718 pointer_default(unique)
720 interface IShellView : IOleWindow
722 typedef IShellView *LPSHELLVIEW;
724 typedef [v1_enum] enum _SVSIF
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;
741 cpp_quote("#define SVSI_NOSTATECHANGE 0x80000000")
743 typedef UINT SVSIF;
745 typedef [v1_enum] enum _SVGIO
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;
755 typedef INT SVGIO;
757 typedef [v1_enum] enum SVUIA_STATUS
759 SVUIA_DEACTIVATE = 0,
760 SVUIA_ACTIVATE_NOFOCUS = 1,
761 SVUIA_ACTIVATE_FOCUS = 2,
762 SVUIA_INPLACEACTIVATE = 3
763 } SVUIA_STATUS;
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);
776 HRESULT DestroyViewWindow();
777 HRESULT GetCurrentInfo( [out] LPFOLDERSETTINGS lpfs );
779 [local] HRESULT AddPropertySheetPages(
780 [in] DWORD dwReserved,
781 [in] LPFNSVADDPROPSHEETPAGE pfn,
782 [in] LPARAM lparam);
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);
795 object,
796 uuid(88e39e80-3578-11cf-ae69-08002b2e1262),
797 pointer_default(unique)
799 interface IShellView2 : IShellView
801 typedef GUID SHELLVIEWID;
802 cpp_quote("#include <pshpack8.h>")
803 typedef struct _SV2CVW2_PARAMS
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>")
815 HRESULT GetView(
816 [in, out] SHELLVIEWID *view_guid,
817 [in] ULONG view_type
819 HRESULT CreateViewWindow2(
820 [in] LPSV2CVW2_PARAMS view_params
822 HRESULT HandleRename(
823 [in] LPCITEMIDLIST new_pidl
825 HRESULT SelectAndPositionItem(
826 [in] LPCITEMIDLIST item,
827 [in] UINT flags,
828 [in] POINT *point
833 object,
834 uuid(ec39fa88-f8af-41c5-8421-38bed28f4673),
835 pointer_default(unique)
837 interface IShellView3 : IShellView2
839 [v1_enum] enum _SV3CVW3_FLAGS
841 SV3CVW3_DEFAULT = 0x00000000,
842 SV3CVW3_NONINTERACTIVE = 0x00000001,
843 SV3CVW3_FORCEVIEWMODE = 0x00000002,
844 SV3CVW3_FORCEFOLDERFLAGS = 0x00000004
847 typedef DWORD SV3CVW3_FLAGS;
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);
861 /*****************************************************************************
862 * IFolderView interface
865 uuid(cde725b0-ccc9-4519-917e-325d72fab4ce),
866 object,
867 pointer_default(unique)
869 interface IFolderView : IUnknown
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
878 HRESULT ItemCount(
879 [in] UINT flags,
880 [out] int *items
882 HRESULT Items(
883 [in] UINT flags,
884 [in] REFIID riid,
885 [out, iid_is(riid)] void **ppv
887 HRESULT GetSelectionMarkedItem( [out] int *item );
888 HRESULT GetFocusedItem( [out] int *item );
889 HRESULT GetItemPosition(
890 [in] PCUITEMID_CHILD pidl,
891 [out] POINT* ppt
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
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
908 [v1_enum] enum tagSORTDIRECTION
910 SORT_DESCENDING = -1,
911 SORT_ASCENDING = 1
913 typedef int SORTDIRECTION;
915 typedef struct SORTCOLUMN
917 PROPERTYKEY propkey;
918 SORTDIRECTION direction;
919 } SORTCOLUMN;
921 typedef [v1_enum] enum FVTEXTTYPE
923 FVST_EMPTYTEXT = 0
924 } FVTEXTTYPE;
927 uuid(1af3a467-214f-4298-908e-06b03e0b39f9),
928 object,
929 pointer_default(unique)
931 interface IFolderView2 : IFolderView
933 HRESULT SetGroupBy(
934 [in] REFPROPERTYKEY key,
935 [in] BOOL ascending);
937 [local]
938 HRESULT GetGroupBy(
939 [out] PROPERTYKEY *pkey,
940 [out] BOOL *ascending);
942 [call_as(GetGroupBy)]
943 HRESULT RemoteGetGroupBy(
944 [out] PROPERTYKEY *pkey,
945 [out] BOOL *ascending);
947 HRESULT SetViewProperty(
948 [in] PCUITEMID_CHILD pidl,
949 [in] REFPROPERTYKEY propkey,
950 [in] REFPROPVARIANT propvar);
952 HRESULT GetViewProperty(
953 [in] PCUITEMID_CHILD pidl,
954 [in] REFPROPERTYKEY propkey,
955 [out] PROPVARIANT *propvar);
957 HRESULT SetTileViewProperties(
958 [in] PCUITEMID_CHILD pidl,
959 [in, string] LPCWSTR prop_list);
961 HRESULT SetExtendedTileViewProperties(
962 [in] PCUITEMID_CHILD pidl,
963 [in, string] LPCWSTR prop_list);
965 HRESULT SetText(
966 [in] FVTEXTTYPE type,
967 [in] LPCWSTR text);
969 HRESULT SetCurrentFolderFlags(
970 [in] DWORD mask,
971 [in] DWORD flags);
973 HRESULT GetCurrentFolderFlags([out] DWORD *flags);
975 HRESULT GetSortColumnCount([out] int *columns);
977 HRESULT SetSortColumns(
978 [in, size_is(count)] const SORTCOLUMN *columns,
979 [in] int count);
981 HRESULT GetSortColumns(
982 [out, size_is(count)] SORTCOLUMN *columns,
983 [in] int count);
985 HRESULT GetItem(
986 [in] int ittem,
987 [in] REFIID riid,
988 [out, iid_is(riid)] void **ppv);
990 HRESULT GetVisibleItem(
991 [in] int start,
992 [in] BOOL previous,
993 [out] int *item);
995 HRESULT GetSelectedItem(
996 [in] int start,
997 [out] int *item);
999 HRESULT GetSelection(
1000 [in] BOOL none_implies_folder,
1001 [out] IShellItemArray **array);
1003 HRESULT GetSelectionState(
1004 [in] PCUITEMID_CHILD pidl,
1005 [out] DWORD *flags);
1007 HRESULT InvokeVerbOnSelection([in, unique, string] LPCSTR verb);
1009 HRESULT SetViewModeAndIconSize(
1010 [in] FOLDERVIEWMODE mode,
1011 [in] int size);
1013 HRESULT GetViewModeAndIconSize(
1014 [out] FOLDERVIEWMODE *mode,
1015 [out] int *size);
1017 HRESULT SetGroupSubsetCount([in] UINT visible_rows);
1019 HRESULT GetGroupSubsetCount([out] UINT *visible_rows);
1021 HRESULT SetRedraw([in] BOOL redraw);
1023 HRESULT IsMoveInSameFolder();
1025 HRESULT DoRename();
1028 /*****************************************************************************
1029 * IShellBrowser interface
1032 object,
1033 uuid(000214e2-0000-0000-c000-000000000046),
1034 pointer_default(unique)
1036 interface IShellBrowser : IOleWindow
1038 typedef IShellBrowser *LPSHELLBROWSER;
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")
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")
1075 cpp_quote("#define FCT_MERGE 0x0001")
1076 cpp_quote("#define FCT_CONFIGABLE 0x0002")
1077 cpp_quote("#define FCT_ADDTOEND 0x0004")
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")
1086 HRESULT InsertMenusSB(
1087 [in] HMENU hmenuShared,
1088 [in, out] LPOLEMENUGROUPWIDTHS lpMenuWidths);
1090 HRESULT SetMenuSB(
1091 [in] HMENU hmenuShared,
1092 [in] HOLEMENU holemenuReserved,
1093 [in] HWND hwndActiveObject);
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 );
1100 HRESULT BrowseObject(
1101 [in] LPCITEMIDLIST pidl,
1102 [in] UINT wFlags);
1104 HRESULT GetViewStateStream(
1105 [in] DWORD grfMode,
1106 [out] IStream **ppStrm);
1108 HRESULT GetControlWindow(
1109 [in] UINT id,
1110 [out] HWND *phwnd);
1112 [local] HRESULT SendControlMsg(
1113 [in] UINT id,
1114 [in] UINT uMsg,
1115 [in] WPARAM wParam,
1116 [in] LPARAM lParam,
1117 [in] LRESULT *pret);
1119 HRESULT QueryActiveShellView( [out] IShellView **ppshv );
1120 HRESULT OnViewWindowActive( [in] IShellView *pshv );
1122 [local]
1123 HRESULT SetToolbarItems(
1124 [in] LPTBBUTTONSB lpButtons,
1125 [in] UINT nButtons,
1126 [in] UINT uFlags);
1130 /*****************************************************************************
1131 * IShellLinkA interface
1134 object,
1135 uuid(000214ee-0000-0000-c000-000000000046),
1136 pointer_default(unique)
1138 interface IShellLinkA : IUnknown
1140 typedef [v1_enum] enum SLR_FLAGS
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;
1158 typedef [v1_enum] enum SLGP_FLAGS
1160 SLGP_SHORTPATH = 0x0001,
1161 SLGP_UNCPRIORITY = 0x0002,
1162 SLGP_RAWPATH = 0x0004,
1163 SLGP_RELATIVEPRIORITY = 0x0008
1164 } SLGP_FLAGS;
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);
1172 HRESULT GetIDList( [out] LPITEMIDLIST * ppidl );
1174 HRESULT SetIDList( [in] LPCITEMIDLIST pidl );
1176 HRESULT GetDescription(
1177 [out, size_is(cch)] LPSTR pszName,
1178 [in] int cch);
1180 HRESULT SetDescription( [in] LPCSTR pszName );
1182 HRESULT GetWorkingDirectory(
1183 [out, size_is(cch)] LPSTR pszDir,
1184 [in] int cch);
1186 HRESULT SetWorkingDirectory( [in] LPCSTR pszDir );
1188 HRESULT GetArguments(
1189 [out, size_is(cch)] LPSTR pszArgs,
1190 [in] int cch);
1192 HRESULT SetArguments( [in] LPCSTR pszArgs );
1194 HRESULT GetHotkey( [out] WORD *pwHotkey );
1196 HRESULT SetHotkey( [in] WORD wHotkey );
1198 HRESULT GetShowCmd( [out] int *piShowCmd );
1200 HRESULT SetShowCmd( [in] int iShowCmd );
1202 HRESULT GetIconLocation(
1203 [out, size_is(cch)] LPSTR pszIconPath,
1204 [in] int cch,
1205 [out] int *piIcon);
1207 HRESULT SetIconLocation(
1208 [in] LPCSTR pszIconPath,
1209 [in] int iIcon);
1211 HRESULT SetRelativePath(
1212 [in] LPCSTR pszPathRel,
1213 [in] DWORD dwReserved);
1215 HRESULT Resolve(
1216 [in] HWND hwnd,
1217 [in] DWORD fFlags);
1219 HRESULT SetPath( [in] LPCSTR pszFile );
1223 /*****************************************************************************
1224 * IShellLinkW interface
1227 object,
1228 uuid(000214f9-0000-0000-c000-000000000046),
1229 pointer_default(unique)
1231 interface IShellLinkW : IUnknown
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);
1239 HRESULT GetIDList( [out] LPITEMIDLIST * ppidl );
1241 HRESULT SetIDList( [in] LPCITEMIDLIST pidl );
1243 HRESULT GetDescription(
1244 [out, size_is(cch)] LPWSTR pszName,
1245 [in] int cch);
1247 HRESULT SetDescription( [in] LPCWSTR pszName );
1249 HRESULT GetWorkingDirectory(
1250 [out, size_is(cch)] LPWSTR pszDir,
1251 [in] int cch);
1253 HRESULT SetWorkingDirectory( [in] LPCWSTR pszDir );
1255 HRESULT GetArguments(
1256 [out, size_is(cch)] LPWSTR pszArgs,
1257 [in] int cch);
1259 HRESULT SetArguments( [in] LPCWSTR pszArgs );
1261 HRESULT GetHotkey( [out] WORD *pwHotkey );
1263 HRESULT SetHotkey( [in] WORD wHotkey );
1265 HRESULT GetShowCmd( [out] int *piShowCmd );
1267 HRESULT SetShowCmd( [in] int iShowCmd );
1269 HRESULT GetIconLocation(
1270 [out, size_is(cch)] LPWSTR pszIconPath,
1271 [in] int cch,
1272 [out] int *piIcon);
1274 HRESULT SetIconLocation(
1275 [in] LPCWSTR pszIconPath,
1276 [in] int iIcon);
1278 HRESULT SetRelativePath(
1279 [in] LPCWSTR pszPathRel,
1280 [in] DWORD dwReserved);
1282 HRESULT Resolve(
1283 [in] HWND hwnd,
1284 [in] DWORD fFlags);
1286 HRESULT SetPath( [in] LPCWSTR pszFile );
1289 cpp_quote("#define IShellLink WINELIB_NAME_AW(IShellLink)")
1292 /*****************************************************************************
1293 * IShellExtInit interface
1296 object,
1297 uuid(000214e8-0000-0000-c000-000000000046),
1298 pointer_default(unique),
1299 local
1301 interface IShellExtInit : IUnknown
1303 typedef IShellExtInit *LPSHELLEXTINIT;
1305 HRESULT Initialize(
1306 [in] LPCITEMIDLIST pidlFolder,
1307 [in] IDataObject *pdtobj,
1308 [in] HKEY hkeyProgID);
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 /*******************************************************************************/
1318 #ifndef MAX_PATH
1319 #define MAX_PATH 260
1320 #endif
1323 /*****************************************************************************
1324 * IPersistFolder3 interface
1327 object,
1328 uuid(cef04fdf-fe72-11d2-87a5-00c04f6837cf),
1329 pointer_default(unique)
1331 interface IPersistFolder3 : IPersistFolder2
1333 typedef struct
1335 LPITEMIDLIST pidlTargetFolder;
1336 WCHAR szTargetParsingName[MAX_PATH];
1337 WCHAR szNetworkProvider[MAX_PATH];
1338 DWORD dwAttributes;
1339 int csidl;
1340 } PERSIST_FOLDER_TARGET_INFO;
1342 HRESULT InitializeEx(
1343 [in] IBindCtx *pbc,
1344 [in] LPCITEMIDLIST pidlRoot,
1345 [in] const PERSIST_FOLDER_TARGET_INFO *ppfti);
1347 HRESULT GetFolderTargetInfo( [out] PERSIST_FOLDER_TARGET_INFO *ppfti );
1351 /*****************************************************************************
1352 * IExtractIconA interface
1355 object,
1356 uuid(000214eb-0000-0000-c000-000000000046),
1357 pointer_default(unique),
1358 local
1360 interface IExtractIconA : IUnknown
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")
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")
1374 typedef IExtractIconA *LPEXTRACTICONA;
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);
1383 HRESULT Extract(
1384 [in] LPCSTR pszFile,
1385 [in] UINT nIconIndex,
1386 [out] HICON *phiconLarge,
1387 [out] HICON *phiconSmall,
1388 [in] UINT nIconSize );
1392 /*****************************************************************************
1393 * IExtractIconW interface
1396 object,
1397 uuid(000214fa-0000-0000-c000-000000000046),
1398 pointer_default(unique),
1399 local
1401 interface IExtractIconW : IUnknown
1403 typedef IExtractIconW *LPEXTRACTICONW;
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);
1412 HRESULT Extract(
1413 [in] LPCWSTR pszFile,
1414 [in] UINT nIconIndex,
1415 [out] HICON *phiconLarge,
1416 [out] HICON *phiconSmall,
1417 [in] UINT nIconSize );
1420 cpp_quote("#define LPEXTRACTICON WINELIB_NAME_AW(LPEXTRACTICON)")
1421 cpp_quote("#define IExtractIcon WINELIB_NAME_AW(IExtractIcon)")
1424 /*****************************************************************************
1425 * ICommDlgBrowser interface
1428 object,
1429 uuid(000214f1-0000-0000-c000-000000000046),
1430 pointer_default(unique)
1432 interface ICommDlgBrowser : IUnknown
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")
1440 typedef ICommDlgBrowser *LPCOMMDLGBROWSER;
1442 HRESULT OnDefaultCommand( [in] IShellView *shv );
1443 HRESULT OnStateChange( [in] IShellView *shv, [in] ULONG uChange );
1444 HRESULT IncludeObject( [in] IShellView *shv, [in] LPCITEMIDLIST pidl );
1448 /*****************************************************************************
1449 * ICommDlgBrowser2 interface
1452 object,
1453 uuid(10339516-2894-11D2-9039-00C04F8EEB3E),
1454 pointer_default(unique)
1456 interface ICommDlgBrowser2 : ICommDlgBrowser
1459 HRESULT Notify(
1460 [in] IShellView *ppshv,
1461 [in] DWORD dwNotifyType);
1463 HRESULT GetDefaultMenuText(
1464 [in] IShellView *ppshv,
1465 [out, string, size_is(cchMax)] LPWSTR pszText,
1466 [in] int cchMax);
1468 HRESULT GetViewFlags(
1469 [out] DWORD *pdwFlags);
1473 /*****************************************************************************
1474 * ICommDlgBrowser3 interface
1477 object,
1478 uuid(C8AD25A1-3294-41EE-8165-71174BD01C57),
1479 pointer_default(unique)
1481 interface ICommDlgBrowser3 : ICommDlgBrowser2
1484 HRESULT OnColumnClicked(
1485 [in] IShellView *ppshv,
1486 [in] int iColumn);
1488 HRESULT GetCurrentFilter(
1489 [out, string, size_is(cchFileSpec)] LPWSTR pszFileSpec,
1490 [in] int cchFileSpec);
1492 HRESULT OnPreViewCreated(
1493 [in] IShellView *ppshv);
1496 /*****************************************************************************
1497 * IDockingWindow interface
1500 object,
1501 uuid(012dd920-7b26-11d0-8ca9-00a0c92dbfe8)
1503 interface IDockingWindow : IOleWindow
1505 HRESULT ShowDW(
1506 [in] BOOL fShow);
1508 HRESULT CloseDW(
1509 [in] DWORD dwReserved);
1511 HRESULT ResizeBorderDW(
1512 [in] LPCRECT prcBorder,
1513 [in] IUnknown *punkToolbarSite,
1514 [in] BOOL fReserved);
1518 /*****************************************************************************
1519 * IDockingWindowFrame interface
1522 object,
1523 uuid(47d2657a-7b27-11d0-8ca9-00a0c92dbfe8),
1524 pointer_default(unique),
1525 local
1527 interface IDockingWindowFrame : IOleWindow
1529 cpp_quote("#define DWFRF_NORMAL 0x0000")
1530 cpp_quote("#define DWFRF_DELETECONFIGDATA 0x0001")
1531 cpp_quote("#define DWFAF_HIDDEN 0x0001")
1533 HRESULT AddToolbar(
1534 [in] IUnknown *punkSrc,
1535 [in] LPCWSTR pwszItem,
1536 [in] DWORD dwAddFlags);
1538 HRESULT RemoveToolbar(
1539 [in] IUnknown *punkSrc,
1540 [in] DWORD dwRemoveFlags);
1542 HRESULT FindToolbar(
1543 [in] LPCWSTR pwszItem,
1544 [in] REFIID riid,
1545 [out] LPVOID *ppvObj);
1549 /*****************************************************************************
1550 * IDragSourceHelper interface
1553 object,
1554 uuid(de5bf786-477a-11d2-839d-00c04fd918d0),
1555 pointer_default(unique),
1556 local
1558 interface IDragSourceHelper : IUnknown
1560 typedef struct
1562 SIZE sizeDragImage;
1563 POINT ptOffset;
1564 HBITMAP hbmpDragImage;
1565 COLORREF crColorKey;
1566 } SHDRAGIMAGE, *LPSHDRAGIMAGE;
1568 HRESULT InitializeFromBitmap(
1569 [in] LPSHDRAGIMAGE pshdi,
1570 [in] IDataObject *pDataObject);
1572 HRESULT InitializeFromWindow(
1573 [in] HWND hwnd,
1574 [in] POINT *ppt,
1575 [in] IDataObject *pDataObject);
1579 /*****************************************************************************
1580 * IDragSourceHelper2 interface
1583 object,
1584 uuid(83e07d0d-0c5f-4163-bf1a-60b274051e40),
1585 pointer_default(unique),
1586 local
1588 interface IDragSourceHelper2 : IDragSourceHelper
1590 HRESULT SetFlags([in] DWORD dwFlags);
1594 /*****************************************************************************
1595 * IDropTargetHelper interface
1598 object,
1599 uuid(4657278b-411b-11d2-839a-00c04fd918d0),
1600 pointer_default(unique),
1601 local
1603 interface IDropTargetHelper : IUnknown
1605 HRESULT DragEnter(
1606 [in] HWND hwndTarget,
1607 [in] IDataObject *pDataObject,
1608 [in] POINT *ppt,
1609 [in] DWORD dwEffect);
1611 HRESULT DragLeave();
1613 HRESULT DragOver(
1614 [in] POINT *ppt,
1615 [in] DWORD dwEffect);
1617 HRESULT Drop(
1618 [in] IDataObject *pDataObject,
1619 [in] POINT *ppt,
1620 [in] DWORD dwEffect);
1622 HRESULT Show( [in] BOOL fShow );
1626 /*****************************************************************************
1627 * IContextMenu interface
1630 object,
1631 uuid(000214e4-0000-0000-c000-000000000046),
1632 pointer_default(unique),
1633 local
1635 interface IContextMenu : IUnknown
1637 cpp_quote("#define CMF_NORMAL 0x00000000")
1638 cpp_quote("#define CMF_DEFAULTONLY 0x00000001")
1639 cpp_quote("#define CMF_VERBSONLY 0x00000002")
1640 cpp_quote("#define CMF_EXPLORE 0x00000004")
1641 cpp_quote("#define CMF_NOVERBS 0x00000008")
1642 cpp_quote("#define CMF_CANRENAME 0x00000010")
1643 cpp_quote("#define CMF_NODEFAULT 0x00000020")
1644 cpp_quote("#define CMF_INCLUDESTATIC 0x00000040")
1645 cpp_quote("#define CMF_ITEMMENU 0x00000080")
1646 cpp_quote("#define CMF_EXTENDEDVERBS 0x00000100")
1647 cpp_quote("#define CMF_DISABLEDVERBS 0x00000200")
1648 cpp_quote("#define CMF_ASYNCVERBSTATE 0x00000400")
1649 cpp_quote("#define CMF_OPTIMIZEFORINVOKE 0x00000800")
1650 cpp_quote("#define CMF_SYNCCASCADEMENU 0x00001000")
1651 cpp_quote("#define CMF_DONOTPICKDEFAULT 0x00002000")
1652 cpp_quote("#define CMF_RESERVED 0xffff0000")
1654 cpp_quote("#define GCS_VERBA 0x00000000")
1655 cpp_quote("#define GCS_HELPTEXTA 0x00000001")
1656 cpp_quote("#define GCS_VALIDATEA 0x00000002")
1657 cpp_quote("#define GCS_VERBW 0x00000004")
1658 cpp_quote("#define GCS_HELPTEXTW 0x00000005")
1659 cpp_quote("#define GCS_VALIDATEW 0x00000006")
1660 cpp_quote("#define GCS_UNICODE 0x00000004")
1661 cpp_quote("#define GCS_VERB WINELIB_NAME_AW(GCS_VERB)")
1662 cpp_quote("#define GCS_HELPTEXT WINELIB_NAME_AW(GCS_HELPTEXT)")
1663 cpp_quote("#define GCS_VALIDATE WINELIB_NAME_AW(GCS_VALIDATE)")
1665 cpp_quote("#define CMDSTR_NEWFOLDERA \"NewFolder\"")
1666 cpp_quote("#define CMDSTR_VIEWLISTA \"ViewList\"")
1667 cpp_quote("#define CMDSTR_VIEWDETAILSA \"ViewDetails\"")
1668 cpp_quote("#if defined(__GNUC__)")
1669 cpp_quote("# define CMDSTR_NEWFOLDERW (const WCHAR []){ 'N','e','w','F','o','l','d','e','r',0 }")
1670 cpp_quote("# define CMDSTR_VIEWLISTW (const WCHAR []){ 'V','i','e','w','L','i','s','t',0 }")
1671 cpp_quote("# define CMDSTR_VIEWDETAILSW (const WCHAR []){ 'V','i','e','w','D','e','t','a','i','l','s',0 }")
1672 cpp_quote("#elif defined(_MSC_VER)")
1673 cpp_quote("# define CMDSTR_NEWFOLDERW L\"NewFolder\"")
1674 cpp_quote("# define CMDSTR_VIEWLISTW L\"ViewList\"")
1675 cpp_quote("# define CMDSTR_VIEWDETAILSW L\"ViewDetails\"")
1676 cpp_quote("#else")
1677 cpp_quote("static const WCHAR CMDSTR_NEWFOLDERW[] = {'N','e','w','F','o','l','d','e','r',0};")
1678 cpp_quote("static const WCHAR CMDSTR_VIEWLISTW [] = {'V','i','e','w','L','i','s','t',0};")
1679 cpp_quote("static const WCHAR CMDSTR_VIEWDETAILSW[] = {'V','i','e','w','D','e','t','a','i','l','s',0};")
1680 cpp_quote("#endif")
1681 cpp_quote("#define CMDSTR_NEWFOLDER WINELIB_NAME_AW(CMDSTR_NEWFOLDER)")
1682 cpp_quote("#define CMDSTR_VIEWLIST WINELIB_NAME_AW(CMDSTR_VIEWLIST)")
1683 cpp_quote("#define CMDSTR_VIEWDETAILS WINELIB_NAME_AW(CMDSTR_VIEWDETAILS)")
1685 cpp_quote("#define CMIC_MASK_HOTKEY SEE_MASK_HOTKEY")
1686 cpp_quote("#define CMIC_MASK_ICON SEE_MASK_ICON")
1687 cpp_quote("#define CMIC_MASK_FLAG_NO_UI SEE_MASK_FLAG_NO_UI")
1688 cpp_quote("#define CMIC_MASK_UNICODE SEE_MASK_UNICODE")
1689 cpp_quote("#define CMIC_MASK_NO_CONSOLE SEE_MASK_NO_CONSOLE")
1690 cpp_quote("#define CMIC_MASK_HASLINKNAME SEE_MASK_HASLINKNAME")
1691 cpp_quote("#define CMIC_MASK_FLAG_SEP_VDM SEE_MASK_FLAG_SEPVDM")
1692 cpp_quote("#define CMIC_MASK_HASTITLE SEE_MASK_HASTITLE")
1693 cpp_quote("#define CMIC_MASK_ASYNCOK SEE_MASK_ASYNCOK")
1694 cpp_quote("#define CMIC_MASK_NOASYNC SEE_MASK_NOASYNC")
1695 cpp_quote("#define CMIC_MASK_SHIFT_DOWN 0x10000000")
1696 cpp_quote("#define CMIC_MASK_PTINVOKE 0x20000000")
1697 cpp_quote("#define CMIC_MASK_CONTROL_DOWN 0x40000000")
1698 cpp_quote("#define CMIC_MASK_FLAG_LOG_USAGE SEE_MASK_FLAG_LOG_USAGE")
1699 cpp_quote("#define CMIC_MASK_NOZONECHECKS SEE_MASK_NOZONECHECKS")
1701 typedef IContextMenu *LPCONTEXTMENU;
1703 typedef struct tagCMINVOKECOMMANDINFO
1705 DWORD cbSize;
1706 DWORD fMask;
1707 HWND hwnd;
1708 LPCSTR lpVerb;
1709 LPCSTR lpParameters;
1710 LPCSTR lpDirectory;
1711 INT nShow;
1712 DWORD dwHotKey;
1713 HANDLE hIcon;
1714 } CMINVOKECOMMANDINFO, *LPCMINVOKECOMMANDINFO;
1716 typedef struct tagCMInvokeCommandInfoEx
1718 DWORD cbSize;
1719 DWORD fMask;
1720 HWND hwnd;
1721 LPCSTR lpVerb;
1722 LPCSTR lpParameters;
1723 LPCSTR lpDirectory;
1724 INT nShow;
1725 DWORD dwHotKey;
1726 HANDLE hIcon;
1727 LPCSTR lpTitle;
1728 LPCWSTR lpVerbW;
1729 LPCWSTR lpParametersW;
1730 LPCWSTR lpDirectoryW;
1731 LPCWSTR lpTitleW;
1732 POINT ptInvoke;
1733 } CMINVOKECOMMANDINFOEX, *LPCMINVOKECOMMANDINFOEX;
1735 HRESULT QueryContextMenu(
1736 [in] HMENU hmenu,
1737 [in] UINT indexMenu,
1738 [in] UINT idCmdFirst,
1739 [in] UINT idCmdLast,
1740 [in] UINT uFlags);
1742 HRESULT InvokeCommand( [in] LPCMINVOKECOMMANDINFO lpici );
1744 HRESULT GetCommandString(
1745 [in] UINT_PTR idCmd,
1746 [in] UINT uType,
1747 [out] UINT *pwReserved,
1748 [out, size_is(cchMax)] LPSTR pszName,
1749 [in] UINT cchMax);
1753 /*****************************************************************************
1754 * IContextMenu2 interface
1757 object,
1758 uuid(000214f4-0000-0000-c000-000000000046),
1759 pointer_default(unique),
1760 local
1762 interface IContextMenu2 : IContextMenu
1764 typedef IContextMenu2 *LPCONTEXTMENU2;
1766 HRESULT HandleMenuMsg(
1767 [in] UINT uMsg,
1768 [in] WPARAM wParam,
1769 [in] LPARAM lParam);
1773 /*****************************************************************************
1774 * IContextMenu3 interface
1777 object,
1778 uuid(bcfce0a0-ec17-11d0-8d10-00a0c90f2719),
1779 pointer_default(unique),
1780 local
1782 interface IContextMenu3 : IContextMenu2
1784 typedef IContextMenu3 *LPCONTEXTMENU3;
1786 HRESULT HandleMenuMsg2(
1787 [in] UINT uMsg,
1788 [in] WPARAM wParam,
1789 [in] LPARAM lParam,
1790 [out] LRESULT *plResult);
1795 object,
1796 uuid(3409e930-5a39-11d1-83fa-00a0c90dc849),
1797 pointer_default(unique),
1798 local
1800 interface IContextMenuCB : IUnknown
1802 HRESULT CallBack(
1803 [in] IShellFolder *psf,
1804 [in] HWND hwndOwner,
1805 [in] IDataObject *pdtobj,
1806 [in] UINT uMsg,
1807 [in] WPARAM wParam,
1808 [in] LPARAM lParam);
1811 /*****************************************************************************
1812 * IShellExecuteHookA interface
1815 object,
1816 uuid(000214f5-0000-0000-c000-000000000046),
1817 pointer_default(unique),
1818 local
1820 interface IShellExecuteHookA : IUnknown
1822 cpp_quote("struct _SHELLEXECUTEINFOA;")
1823 HRESULT Execute(
1824 [in, out] struct _SHELLEXECUTEINFOA* pei);
1828 /*****************************************************************************
1829 * IShellExecuteHookW interface
1832 object,
1833 uuid(000214fb-0000-0000-c000-000000000046),
1834 pointer_default(unique),
1835 local
1837 interface IShellExecuteHookW : IUnknown
1839 cpp_quote("struct _SHELLEXECUTEINFOW;")
1840 HRESULT Execute(
1841 [in, out] struct _SHELLEXECUTEINFOW* pei);
1844 /*****************************************************************************
1845 * IShellLinkDataList interface
1848 object,
1849 uuid(45e2b4ae-b1c3-11d0-b92f-00a0c90312e1),
1850 pointer_default(unique)
1852 interface IShellLinkDataList : IUnknown
1854 [local] HRESULT AddDataBlock(
1855 [in] void *pDataBlock);
1856 [local] HRESULT CopyDataBlock(
1857 [in] DWORD dwSig,
1858 [out] void **ppDataBlock);
1859 HRESULT RemoveDataBlock(
1860 [in] DWORD dwSig);
1861 HRESULT GetFlags(
1862 [out] DWORD *pdwFlags);
1863 HRESULT SetFlags(
1864 [in] DWORD dwFlags);
1868 /*****************************************************************************
1869 * IResolveShellLink interface
1872 object,
1873 uuid(5cd52983-9449-11d2-963a-00c04f79adf0),
1874 pointer_default(unique)
1876 interface IResolveShellLink : IUnknown
1878 HRESULT ResolveShellLink(
1879 [in] IUnknown *punk,
1880 [in] HWND hwnd,
1881 [in] DWORD fFlags);
1885 /*****************************************************************************
1886 * IURLSearchHook interface
1889 object,
1890 uuid(ac60f6a0-0fd9-11d0-99cb-00c04fd64497),
1891 pointer_default(unique),
1892 local
1894 interface IURLSearchHook : IUnknown
1896 HRESULT Translate(
1897 [in, out] LPWSTR lpwszSearchURL,
1898 [in] DWORD cchBufferSize);
1902 /*****************************************************************************
1903 * ISearchContext interface
1906 object,
1907 uuid(09f656a2-41af-480c-88f7-16cc0d164615),
1908 pointer_default(unique),
1909 local
1911 interface ISearchContext : IUnknown
1913 HRESULT GetSearchUrl(
1914 [in] BSTR *pbstrSearchUrl);
1915 HRESULT GetSearchText(
1916 [in] BSTR *pbstrSearchText);
1917 HRESULT GetSearchStyle(
1918 [in] DWORD *pdwSearchStyle);
1922 /*****************************************************************************
1923 * IURLSearchHook2 interface
1926 object,
1927 uuid(5ee44da4-6d32-46e3-86bc-07540dedd0e0),
1928 pointer_default(unique),
1929 local
1931 interface IURLSearchHook2 : IURLSearchHook
1933 HRESULT TranslateWithSearchContext(
1934 [in, out] LPWSTR lpwszSearchURL,
1935 [in] DWORD cchBufferSize,
1936 [in] ISearchContext *pSearchContext);
1940 cpp_quote("#define INewShortcutHook WINELIB_NAME_AW(INewShortcutHook)")
1942 /*****************************************************************************
1943 * INewShortcutHookA interface
1946 object,
1947 uuid(000214e1-0000-0000-c000-000000000046),
1948 pointer_default(unique),
1949 local
1951 interface INewShortcutHookA : IUnknown
1953 HRESULT SetReferent(
1954 [in] LPCSTR pcszReferent,
1955 [in] HWND hwnd);
1956 HRESULT GetReferent(
1957 [out] LPSTR pcszReferent,
1958 [in] int cchReferent);
1959 HRESULT SetFolder(
1960 [in] LPCSTR pcszReferent);
1961 HRESULT GetFolder(
1962 [out] LPSTR pcszReferent,
1963 [in] int cchFolder);
1964 HRESULT GetName(
1965 [out] LPSTR pszName,
1966 [in] int cchName);
1967 HRESULT GetExtension(
1968 [out] LPSTR pszExtension,
1969 [in] int cchExtension);
1973 /*****************************************************************************
1974 * INewShortcutHookW interface
1977 object,
1978 uuid(000214f7-0000-0000-c000-000000000046),
1979 pointer_default(unique),
1980 local
1982 interface INewShortcutHookW : IUnknown
1984 HRESULT SetReferent(
1985 [in] LPCWSTR pcszReferent,
1986 [in] HWND hwnd);
1987 HRESULT GetReferent(
1988 [out] LPWSTR pcszReferent,
1989 [in] int cchReferent);
1990 HRESULT SetFolder(
1991 [in] LPCWSTR pcszReferent);
1992 HRESULT GetFolder(
1993 [out] LPWSTR pcszReferent,
1994 [in] int cchFolder);
1995 HRESULT GetName(
1996 [out] LPWSTR pszName,
1997 [in] int cchName);
1998 HRESULT GetExtension(
1999 [out] LPWSTR pszExtension,
2000 [in] int cchExtension);
2003 /*****************************************************************************
2004 * IRunnableTask interface
2007 object,
2008 uuid(85788d00-6807-11d0-b810-00c04fd706ec),
2009 pointer_default(unique),
2010 local
2012 interface IRunnableTask : IUnknown
2014 HRESULT Run();
2015 HRESULT Kill([in] BOOL fWait);
2016 HRESULT Suspend();
2017 HRESULT Resume();
2018 ULONG IsRunning();
2021 /*****************************************************************************
2022 * IShellChangeNotify interface
2025 object,
2026 uuid(d82be2b1-5764-11d0-a96e-00c04fd705a2),
2027 pointer_default(unique),
2028 local
2030 interface IShellChangeNotify : IUnknown
2032 HRESULT OnChange(
2033 [in] LONG lEvent,
2034 [in] LPCITEMIDLIST pidl1,
2035 [in] LPCITEMIDLIST pidl2);
2038 /*****************************************************************************
2039 * IFileSystemBindData interface
2042 object,
2043 uuid(01e18d10-4d8b-11d2-855d-006008059367),
2044 pointer_default(unique),
2045 local
2047 interface IFileSystemBindData : IUnknown
2049 HRESULT SetFindData(
2050 [in] const WIN32_FIND_DATAW *pfd);
2051 HRESULT GetFindData(
2052 [out] WIN32_FIND_DATAW *pfd);
2055 /*****************************************************************************
2056 * ITaskbarList interface
2059 object,
2060 uuid(56FDF342-FD6D-11d0-958A-006097C9A090),
2061 pointer_default(unique)
2063 interface ITaskbarList : IUnknown
2065 HRESULT HrInit();
2067 HRESULT AddTab(
2068 [in] HWND hwnd);
2070 HRESULT DeleteTab(
2071 [in] HWND hwnd);
2073 HRESULT ActivateTab(
2074 [in] HWND hwnd);
2076 HRESULT SetActiveAlt(
2077 [in] HWND hwnd);
2080 /*****************************************************************************
2081 * ITaskbarList2 interface
2084 object,
2085 uuid(602D4995-B13A-429B-A66E-1935E44F4317),
2086 pointer_default(unique)
2088 interface ITaskbarList2 : ITaskbarList
2090 HRESULT MarkFullscreenWindow(
2091 [in] HWND hwnd,
2092 [in] BOOL fullscreen);
2095 cpp_quote("#ifdef MIDL_PASS")
2096 typedef IUnknown* HIMAGELIST;
2097 cpp_quote("#endif")
2099 typedef [v1_enum] enum THUMBBUTTONFLAGS {
2100 THBF_ENABLED = 0x0000,
2101 THBF_DISABLED = 0x0001,
2102 THBF_DISMISSONCLICK = 0x0002,
2103 THBF_NOBACKGROUND = 0x0004,
2104 THBF_HIDDEN = 0x0008,
2105 THBF_NONINTERACTIVE = 0x0010
2106 } THUMBBUTTONFLAGS;
2108 cpp_quote("DEFINE_ENUM_FLAG_OPERATORS(THUMBBUTTONFLAGS)")
2110 typedef [v1_enum] enum THUMBBUTTONMASK {
2111 THB_BITMAP = 0x0001,
2112 THB_ICON = 0x0002,
2113 THB_TOOLTIP = 0x0004,
2114 THB_FLAGS = 0x0008
2115 } THUMBBUTTONMASK;
2117 cpp_quote("DEFINE_ENUM_FLAG_OPERATORS(THUMBBUTTONMASK)")
2119 cpp_quote("#include <pshpack8.h>")
2120 typedef struct THUMBBUTTON {
2121 THUMBBUTTONMASK dwMask;
2122 UINT iId;
2123 UINT iBitmap;
2124 HICON hIcon;
2125 WCHAR szTip[260];
2126 THUMBBUTTONFLAGS dwFlags;
2127 } THUMBBUTTON, *LPTHUMBBUTTON;
2128 cpp_quote("#include <poppack.h>")
2131 uuid(ea1afb91-9e28-4b86-90e9-9e9f8a5eefaf),
2132 object
2134 interface ITaskbarList3 : ITaskbarList2
2136 typedef [v1_enum] enum TBPFLAG {
2137 TBPF_NOPROGRESS = 0x0000,
2138 TBPF_INDETERMINATE = 0x0001,
2139 TBPF_NORMAL = 0x0002,
2140 TBPF_ERROR = 0x0004,
2141 TBPF_PAUSED = 0x0008
2142 } TBPFLAG;
2144 cpp_quote("DEFINE_ENUM_FLAG_OPERATORS(TBPFLAG)")
2146 HRESULT SetProgressValue(
2147 [in] HWND hwnd,
2148 [in] ULONGLONG ullCompleted,
2149 [in] ULONGLONG ullTotal);
2151 HRESULT SetProgressState(
2152 [in] HWND hwnd,
2153 [in] TBPFLAG tbpFlags);
2155 HRESULT RegisterTab(
2156 [in] HWND hwndTab,
2157 [in] HWND hwndMDI);
2159 HRESULT UnregisterTab([in] HWND hwndTab);
2161 HRESULT SetTabOrder(
2162 [in] HWND hwndTab,
2163 [in] HWND hwndInsertBefore);
2165 HRESULT SetTabActive(
2166 [in] HWND hwndTab,
2167 [in] HWND hwndMDI,
2168 [in] DWORD dwReserved);
2170 HRESULT ThumbBarAddButtons(
2171 [in] HWND hwnd,
2172 [in] UINT cButtons,
2173 [in, size_is(cButtons)] LPTHUMBBUTTON pButton);
2175 HRESULT ThumbBarUpdateButtons(
2176 [in] HWND hwnd,
2177 [in] UINT cButtons,
2178 [in, size_is(cButtons)] LPTHUMBBUTTON pButton);
2180 HRESULT ThumbBarSetImageList(
2181 [in] HWND hwnd,
2182 [in] HIMAGELIST himl);
2184 HRESULT SetOverlayIcon(
2185 [in] HWND hwnd,
2186 [in] HICON hIcon,
2187 [in, unique, string] LPCWSTR pszDescription);
2189 HRESULT SetThumbnailTooltip(
2190 [in] HWND hwnd,
2191 [in, unique, string] LPCWSTR pszTip);
2193 HRESULT SetThumbnailClip(
2194 [in] HWND hwnd,
2195 [in] RECT *prcClip);
2199 uuid(c43dc798-95d1-4bea-9030-bb99e2983a1a),
2200 object
2202 interface ITaskbarList4 : ITaskbarList3
2204 typedef [v1_enum] enum STPFLAG {
2205 STPF_NONE = 0x0000,
2206 STPF_USEAPPTHUMBNAILALWAYS = 0x0001,
2207 STPF_USEAPPTHUMBNAILWHENACTIVE = 0x0002,
2208 STPF_USEAPPPEEKALWAYS = 0x0004,
2209 STPF_USEAPPPEEKWHENACTIVE = 0x0008
2210 } STPFLAG;
2212 cpp_quote("DEFINE_ENUM_FLAG_OPERATORS(STPFLAG)")
2214 HRESULT SetTabProperties(
2215 [in] HWND hwndTab,
2216 [in] STPFLAG stpFlags);
2219 /*****************************************************************************
2220 * IAutoCompleteDropDown interface
2223 object,
2224 uuid(3CD141F4-3C6A-11d2-BCAA-00C04FD929DB),
2225 pointer_default(unique)
2227 interface IAutoCompleteDropDown : IUnknown
2229 cpp_quote("#define ACDD_VISIBLE 0x0001")
2231 HRESULT GetDropDownStatus(
2232 [out] DWORD *pdwFlags,
2233 [out, string] LPWSTR *ppwszString);
2235 HRESULT ResetEnumerator();
2239 object,
2240 uuid(cb728b20-f786-11ce-92ad-00aa00a74cd0),
2241 pointer_default(unique)
2243 interface IProfferService : IUnknown
2245 HRESULT ProfferService(
2246 [in] REFGUID service,
2247 [in] IServiceProvider *pService,
2248 [out] DWORD *pCookie);
2250 HRESULT RevokeService([in] DWORD cookie);
2253 /*****************************************************************************
2254 * IExplorerBrowserEvents interface
2257 object,
2258 uuid(361BBDC7-E6EE-4E13-BE58-58E2240C810F)
2260 interface IExplorerBrowserEvents : IUnknown
2262 HRESULT OnNavigationPending(
2263 [in] PCIDLIST_ABSOLUTE pidlFolder);
2265 HRESULT OnViewCreated(
2266 [in] IShellView *psv);
2268 HRESULT OnNavigationComplete(
2269 [in] PCIDLIST_ABSOLUTE pidlFolder);
2271 HRESULT OnNavigationFailed(
2272 [in] PCIDLIST_ABSOLUTE pidlFolder);
2275 typedef GUID EXPLORERPANE;
2276 typedef EXPLORERPANE *REFEXPLORERPANE;
2278 cpp_quote("#define SID_ExplorerPaneVisibility IID_IExplorerPaneVisibility")
2280 /*****************************************************************************
2281 * IExplorerPaneVisibility interface
2284 object,
2285 uuid(E07010EC-BC17-44C0-97B0-46C7C95B9EDC)
2287 interface IExplorerPaneVisibility : IUnknown
2289 [v1_enum] enum _EXPLORERPANESTATE {
2290 EPS_DONTCARE = 0x0,
2291 EPS_DEFAULT_ON = 0x1,
2292 EPS_DEFAULT_OFF = 0x2,
2293 EPS_STATE_MASK = 0xffff,
2294 EPS_INITIALSTATE = 0x10000,
2295 EPS_FORCE = 0x20000
2297 typedef DWORD EXPLORERPANESTATE;
2299 HRESULT GetPaneState(
2300 [in] REFEXPLORERPANE ep,
2301 [out] EXPLORERPANESTATE *peps);
2304 typedef [v1_enum] enum tagEXPLORER_BROWSER_FILL_FLAGS {
2305 EBF_NONE = 0,
2306 EBF_SELECTFROMDATAOBJECT = 0x100,
2307 EBF_NODROPTARGET = 0x200
2308 } EXPLORER_BROWSER_FILL_FLAGS;
2310 typedef [v1_enum] enum tagEXPLORER_BROWSER_OPTIONS {
2311 EBO_NONE = 0x00,
2312 EBO_NAVIGATEONCE = 0x01,
2313 EBO_SHOWFRAMES = 0x02,
2314 EBO_ALWAYSNAVIGATE = 0x04,
2315 EBO_NOTRAVELLOG = 0x08,
2316 EBO_NOWRAPPERWINDOW = 0x10,
2317 EBO_HTMLSHAREPOINTVIEW = 0x20,
2318 EBO_NOBORDER = 0x40,
2319 EBO_NOPERSISTVIEWSTATE = 0x80,
2320 } EXPLORER_BROWSER_OPTIONS;
2322 cpp_quote("#define SID_SExplorerBrowserFrame IID_ICommDlgBrowser")
2324 /*****************************************************************************
2325 * IExplorerBrowser interface
2328 object,
2329 uuid(DFD3B6B5-C10C-4BE9-85F6-A66969F402F6),
2330 pointer_default(unique)
2332 interface IExplorerBrowser : IUnknown
2335 [local] HRESULT Initialize(
2336 [in] HWND hwndParent,
2337 [in] const RECT *prc,
2338 [in, unique] const FOLDERSETTINGS *pfs);
2340 HRESULT Destroy();
2342 [local] HRESULT SetRect(
2343 [in,out,unique] HDWP *phdwp,
2344 [in] RECT rcBrowser);
2346 HRESULT SetPropertyBag(
2347 [in, string] LPCWSTR pszPropertyBag);
2349 HRESULT SetEmptyText(
2350 [in, string] LPCWSTR pszEmptyText);
2352 HRESULT SetFolderSettings(
2353 [in] const FOLDERSETTINGS *pfs);
2355 HRESULT Advise(
2356 [in] IExplorerBrowserEvents *psbe,
2357 [out] DWORD *pdwCookie);
2359 HRESULT Unadvise(
2360 [in] DWORD dwCookie);
2362 HRESULT SetOptions(
2363 [in] EXPLORER_BROWSER_OPTIONS dwFlag);
2365 HRESULT GetOptions(
2366 [out] EXPLORER_BROWSER_OPTIONS *pdwFlag);
2368 HRESULT BrowseToIDList(
2369 [in] PCUIDLIST_RELATIVE pidl,
2370 [in] UINT uFlags);
2372 HRESULT BrowseToObject(
2373 [in] IUnknown *punk,
2374 [in] UINT uFlags);
2376 HRESULT FillFromObject(
2377 [in] IUnknown *punk,
2378 [in] EXPLORER_BROWSER_FILL_FLAGS dwFlags);
2380 HRESULT RemoveAll();
2382 HRESULT GetCurrentView(
2383 [in] REFIID riid,
2384 [out, iid_is(riid)] void **ppv);
2387 /*****************************************************************************
2388 * INameSpaceTreeControl interface
2391 object,
2392 uuid(028212A3-B627-47E9-8856-C14265554E4F)
2394 interface INameSpaceTreeControl : IUnknown
2396 [v1_enum] enum _NSTCSTYLE {
2397 NSTCS_HASEXPANDOS = 0x00000001,
2398 NSTCS_HASLINES = 0x00000002,
2399 NSTCS_SINGLECLICKEXPAND = 0x00000004,
2400 NSTCS_FULLROWSELECT = 0x00000008,
2401 NSTCS_SPRINGEXPAND = 0x00000010,
2402 NSTCS_HORIZONTALSCROLL = 0x00000020,
2403 NSTCS_ROOTHASEXPANDO = 0x00000040,
2404 NSTCS_SHOWSELECTIONALWAYS = 0x00000080,
2405 NSTCS_NOINFOTIP = 0x00000200,
2406 NSTCS_EVENHEIGHT = 0x00000400,
2407 NSTCS_NOREPLACEOPEN = 0x00000800,
2408 NSTCS_DISABLEDRAGDROP = 0x00001000,
2409 NSTCS_NOORDERSTREAM = 0x00002000,
2410 NSTCS_RICHTOOLTIP = 0x00004000,
2411 NSTCS_BORDER = 0x00008000,
2412 NSTCS_NOEDITLABELS = 0x00010000,
2413 NSTCS_TABSTOP = 0x00020000,
2414 NSTCS_FAVORITESMODE = 0x00080000,
2415 NSTCS_AUTOHSCROLL = 0x00100000,
2416 NSTCS_FADEINOUTEXPANDOS = 0x00200000,
2417 NSTCS_EMPTYTEXT = 0x00400000,
2418 NSTCS_CHECKBOXES = 0x00800000,
2419 NSTCS_PARTIALCHECKBOXES = 0x01000000,
2420 NSTCS_EXCLUSIONCHECKBOXES = 0x02000000,
2421 NSTCS_DIMMEDCHECKBOXES = 0x04000000,
2422 NSTCS_NOINDENTCHECKS = 0x08000000,
2423 NSTCS_ALLOWJUNCTIONS = 0x10000000,
2424 NSTCS_SHOWTABSBUTTON = 0x20000000,
2425 NSTCS_SHOWDELETEBUTTON = 0x40000000,
2426 NSTCS_SHOWREFRESHBUTTON = (int)0x80000000
2428 typedef DWORD NSTCSTYLE;
2430 [v1_enum] enum _NSTCROOTSTYLE {
2431 NSTCRS_VISIBLE = 0x0000,
2432 NSTCRS_HIDDEN = 0x0001,
2433 NSTCRS_EXPANDED = 0x0002
2435 typedef DWORD NSTCROOTSTYLE;
2437 [v1_enum] enum _NSTCITEMSTATE {
2438 NSTCIS_NONE = 0x0000,
2439 NSTCIS_SELECTED = 0x0001,
2440 NSTCIS_EXPANDED = 0x0002,
2441 NSTCIS_BOLD = 0x0004,
2442 NSTCIS_DISABLED = 0x0008,
2443 NSTCIS_SELECTEDNOEXPAND = 0x0010
2445 typedef DWORD NSTCITEMSTATE;
2447 typedef [v1_enum] enum NSTCGNI {
2448 NSTCGNI_NEXT = 0,
2449 NSTCGNI_NEXTVISIBLE = 1,
2450 NSTCGNI_PREV = 2,
2451 NSTCGNI_PREVVISIBLE = 3,
2452 NSTCGNI_PARENT = 4,
2453 NSTCGNI_CHILD = 5,
2454 NSTCGNI_FIRSTVISIBLE = 6,
2455 NSTCGNI_LASTVISIBLE = 7
2456 } NSTCGNI;
2458 HRESULT Initialize(
2459 [in] HWND hwndParent,
2460 [in, unique] RECT *prc,
2461 [in] NSTCSTYLE nstcsFlags);
2463 HRESULT TreeAdvise(
2464 [in] IUnknown *punk,
2465 [out] DWORD *pdwCookie);
2467 HRESULT TreeUnadvise(
2468 [in] DWORD dwCookie);
2470 HRESULT AppendRoot(
2471 [in] IShellItem *psiRoot,
2472 [in] SHCONTF grfEnumFlags,
2473 [in] NSTCROOTSTYLE grfRootStyle,
2474 [in, unique] IShellItemFilter *pif);
2476 HRESULT InsertRoot(
2477 [in] int iIndex,
2478 [in] IShellItem *psiRoot,
2479 [in] SHCONTF grfEnumFlags,
2480 [in] NSTCROOTSTYLE grfRootStyle,
2481 [in, unique] IShellItemFilter *pif);
2483 HRESULT RemoveRoot(
2484 [in] IShellItem *psiRoot);
2486 HRESULT RemoveAllRoots();
2488 HRESULT GetRootItems(
2489 [out] IShellItemArray **ppsiaRootItems);
2491 HRESULT SetItemState(
2492 [in] IShellItem *psi,
2493 [in] NSTCITEMSTATE nstcisMask,
2494 [in] NSTCITEMSTATE nstcisFlags);
2496 HRESULT GetItemState(
2497 [in] IShellItem *psi,
2498 [in] NSTCITEMSTATE nstcismask,
2499 [out] NSTCITEMSTATE *pnstcisFlags);
2501 HRESULT GetSelectedItems(
2502 [out] IShellItemArray **psiaItems);
2504 HRESULT GetItemCustomState(
2505 [in] IShellItem *psi,
2506 [out] int *piStateNumber);
2508 HRESULT SetItemCustomState(
2509 [in] IShellItem *psi,
2510 [in] int iStateNumber);
2512 HRESULT EnsureItemVisible(
2513 [in] IShellItem *psi);
2515 HRESULT SetTheme(
2516 [in, string] LPCWSTR pszTheme);
2518 HRESULT GetNextItem(
2519 [in, unique] IShellItem *psi,
2520 [in] NSTCGNI nstcgi,
2521 [out] IShellItem **ppsiNext);
2523 HRESULT HitTest(
2524 [in] POINT *ppt,
2525 [out] IShellItem **ppsiOut);
2527 HRESULT GetItemRect(
2528 [in] IShellItem *psi,
2529 [out] RECT *prect);
2531 HRESULT CollapseAll();
2534 /*****************************************************************************
2535 * INameSpaceTreeControl2 interface
2538 object,
2539 uuid(7CC7AED8-290E-49BC-8945-C1401CC9306C)
2541 interface INameSpaceTreeControl2 : INameSpaceTreeControl
2543 typedef [v1_enum] enum NSTCSTYLE2 {
2544 NSTCS2_DEFAULT = 0x00,
2545 NSTCS2_INTERRUPTNOTIFICATIONS = 0x01,
2546 NSTCS2_SHOWNULLSPACEMENU = 0x02,
2547 NSTCS2_DISPLAYPADDING = 0x04,
2548 NSTCS2_DISPLAYPINNEDONLY = 0x08,
2549 NTSCS2_NOSINGLETONAUTOEXPAND = 0x10, /* The apparent typo here is */
2550 NTSCS2_NEVERINSERTNONENUMERATED = 0x20 /* present also in the Win SDK */
2551 } NSTCSTYLE2;
2552 cpp_quote("DEFINE_ENUM_FLAG_OPERATORS(NSTCSTYLE2)")
2554 HRESULT SetControlStyle(
2555 [in] NSTCSTYLE nstcsMask,
2556 [in] NSTCSTYLE nstcsStyle);
2558 HRESULT GetControlStyle(
2559 [in] NSTCSTYLE nstcsMask,
2560 [out] NSTCSTYLE *pnstcsStyle);
2562 HRESULT SetControlStyle2(
2563 [in] NSTCSTYLE2 nstcsMask,
2564 [in] NSTCSTYLE2 nstcsStyle);
2566 HRESULT GetControlStyle2(
2567 [in] NSTCSTYLE2 nstcsMask,
2568 [out] NSTCSTYLE2 *pnstcsStyle);
2571 /*****************************************************************************
2572 * INameSpaceTreeControlEvents interface
2576 object,
2577 uuid(93D77985-B3D8-4484-8318-672CDDA002CE),
2578 local
2580 interface INameSpaceTreeControlEvents : IUnknown
2582 [v1_enum] enum _NSTCEHITTEST {
2583 NSTCEHT_NOWHERE = 0x0001,
2584 NSTCEHT_ONITEMICON = 0x0002,
2585 NSTCEHT_ONITEMLABEL = 0x0004,
2586 NSTCEHT_ONITEMIDENT = 0x0008,
2587 NSTCEHT_ONITEMBUTTON = 0x0010,
2588 NSTCEHT_ONITEMRIGHT = 0x0020,
2589 NSTCEHT_ONITEMSTATEICON = 0x0040,
2590 NSTCEHT_ONITEM = 0x0046,
2591 NSTCEHT_ONITEMTABBUTTON = 0x1000
2593 typedef DWORD NSTCEHITTEST;
2595 [v1_enum] enum _NSTCECLICKTYPE {
2596 NSTCECT_LBUTTON = 0x1,
2597 NSTCECT_MBUTTON = 0x2,
2598 NSTCECT_RBUTTON = 0x3,
2599 NSTCECT_BUTTON = 0x3,
2600 NSTCECT_DBLCLICK = 0x4
2602 typedef DWORD NSTCECLICKTYPE;
2604 HRESULT OnItemClick(
2605 [in] IShellItem *psi,
2606 [in] NSTCEHITTEST nstceHitTest,
2607 [in] NSTCECLICKTYPE nstceClickType);
2609 HRESULT OnPropertyItemCommit(
2610 [in] IShellItem *psi);
2612 HRESULT OnItemStateChanging(
2613 [in] IShellItem *psi,
2614 [in] NSTCITEMSTATE nstcisMask,
2615 [in] NSTCITEMSTATE nstcisState);
2617 HRESULT OnItemStateChanged(
2618 [in] IShellItem *psi,
2619 [in] NSTCITEMSTATE nstcisMask,
2620 [in] NSTCITEMSTATE nstcisState);
2622 HRESULT OnSelectionChanged(
2623 [in] IShellItemArray *psiaSelection);
2625 HRESULT OnKeyboardInput(
2626 [in] UINT uMsg,
2627 [in] WPARAM wParam,
2628 [in] LPARAM lParam);
2630 HRESULT OnBeforeExpand(
2631 [in] IShellItem *psi);
2633 HRESULT OnAfterExpand(
2634 [in] IShellItem *psi);
2636 HRESULT OnBeginLabelEdit(
2637 [in] IShellItem *psi);
2639 HRESULT OnEndLabelEdit(
2640 [in] IShellItem *psi);
2642 HRESULT OnGetToolTip(
2643 [in] IShellItem *psi,
2644 [out, string, size_is(cchTip)] LPWSTR pszTip,
2645 [in] int cchTip);
2647 HRESULT OnBeforeItemDelete(
2648 [in] IShellItem *psi);
2650 HRESULT OnItemAdded(
2651 [in] IShellItem *psi,
2652 [in] BOOL fIsRoot);
2654 HRESULT OnItemDeleted(
2655 [in] IShellItem *psi,
2656 [in] BOOL fIsRoot);
2658 HRESULT OnBeforeContextMenu(
2659 [in, unique] IShellItem *psi,
2660 [in] REFIID riid,
2661 [out, iid_is(riid)] void **ppv);
2663 HRESULT OnAfterContextMenu(
2664 [in] IShellItem *psi,
2665 [in] IContextMenu *pcmIn,
2666 [in] REFIID riid,
2667 [out, iid_is(riid)] void **ppv);
2669 HRESULT OnBeforeStateImageChange(
2670 [in] IShellItem *psi);
2672 HRESULT OnGetDefaultIconIndex(
2673 [in] IShellItem *psi,
2674 [out] int *piDefaultIcon,
2675 [out] int *piOpenIcon);
2678 /*****************************************************************************
2679 * INameSpaceTreeControlCustomDraw interface
2682 object,
2683 uuid(2D3BA758-33EE-42D5-BB7B-5F3431D86C78),
2684 local
2687 interface INameSpaceTreeControlCustomDraw : IUnknown
2689 typedef struct NSTCCUSTOMDRAW
2691 IShellItem *psi;
2692 UINT uItemState;
2693 NSTCITEMSTATE nstcis;
2694 LPCWSTR pszText;
2695 int iImage;
2696 HIMAGELIST himl;
2697 int iLevel;
2698 int iIndent;
2699 } NSTCCUSTOMDRAW;
2701 HRESULT PrePaint(
2702 [in] HDC hdc,
2703 [in] RECT *prc,
2704 [out] LRESULT *plres);
2706 HRESULT PostPaint(
2707 [in] HDC hdc,
2708 [in] RECT *prc);
2710 HRESULT ItemPrePaint(
2711 [in] HDC hdc,
2712 [in] RECT *prc,
2713 [in] NSTCCUSTOMDRAW *pnstccdItem,
2714 [in, out] COLORREF *pclrText,
2715 [in, out] COLORREF *pclrTextBk,
2716 [out] LRESULT *plres);
2718 HRESULT ItemPostPaint(
2719 [in] HDC hdc,
2720 [in] RECT *prc,
2721 [in] NSTCCUSTOMDRAW *pnstccdItem);
2724 /*****************************************************************************
2725 * INameSpaceTreeControlDropHandler interface
2728 object,
2729 uuid(F9C665D6-C2F2-4C19-BF33-8322D7352F51),
2730 local
2732 interface INameSpaceTreeControlDropHandler : IUnknown
2734 HRESULT OnDragEnter(
2735 [in, unique] IShellItem *psiOver,
2736 [in] IShellItemArray *psiaData,
2737 [in] BOOL fOutsideSource,
2738 [in] DWORD grfKeyState,
2739 [in, out] DWORD *pdwEffect);
2741 HRESULT OnDragOver(
2742 [in, unique] IShellItem *psiOver,
2743 [in] IShellItemArray *psiaData,
2744 [in] DWORD grfKeyState,
2745 [in, out] DWORD *pdwEffect);
2747 HRESULT OnDragPosition(
2748 [in, unique] IShellItem *psiOver,
2749 [in] IShellItemArray *psiaData,
2750 [in] int iNewPosition,
2751 [in] int iOldPosition);
2753 HRESULT OnDrop(
2754 [in, unique] IShellItem *psiOver,
2755 [in] IShellItemArray *psiaData,
2756 [in] int iPosition,
2757 [in] DWORD grfKeyState,
2758 [in, out] DWORD *pdwEffect);
2760 HRESULT OnDropPosition(
2761 [in, unique] IShellItem *psiOver,
2762 [in] IShellItemArray *psiaData,
2763 [in] int iNewPosition,
2764 [in] int iOldPosition);
2766 HRESULT OnDragLeave(
2767 [in, unique] IShellItem *psiOver);
2769 cpp_quote("#define NSTCDHPOS_ONTOP -1")
2771 interface IFileDialog;
2773 typedef [v1_enum] enum FDE_OVERWRITE_RESPONSE
2775 FDEOR_DEFAULT = 0,
2776 FDEOR_ACCEPT = 1,
2777 FDEOR_REFUSE = 2
2778 } FDE_OVERWRITE_RESPONSE;
2780 typedef [v1_enum] enum FDE_SHAREVIOLATION_RESPONSE
2782 FDESVR_DEFAULT = 0,
2783 FDESVR_ACCEPT = 1,
2784 FDESVR_REFUSE = 2
2785 } FDE_SHAREVIOLATION_RESPONSE;
2787 /*****************************************************************************
2788 * IFileDialogEvents interface
2791 object,
2792 uuid(973510DB-7D7F-452B-8975-74A85828D354),
2793 pointer_default(unique)
2795 interface IFileDialogEvents : IUnknown
2797 HRESULT OnFileOk(
2798 [in] IFileDialog *pfd);
2800 HRESULT OnFolderChanging(
2801 [in] IFileDialog *pfd,
2802 [in] IShellItem *psiFolder);
2804 HRESULT OnFolderChange(
2805 [in] IFileDialog *pfd);
2807 HRESULT OnSelectionChange(
2808 [in] IFileDialog *pfd);
2810 HRESULT OnShareViolation(
2811 [in] IFileDialog *pfd,
2812 [in] IShellItem *psi,
2813 [out] FDE_SHAREVIOLATION_RESPONSE *pResponse);
2815 HRESULT OnTypeChange(
2816 [in] IFileDialog *pfd);
2818 HRESULT OnOverwrite(
2819 [in] IFileDialog *pfd,
2820 [in] IShellItem *psi,
2821 [out] FDE_OVERWRITE_RESPONSE *pResponse);
2824 /*****************************************************************************
2825 * IModalWindow interface
2828 object,
2829 uuid(B4DB1657-70D7-485E-8E3E-6FCB5A5C1802),
2830 pointer_default(unique)
2832 interface IModalWindow : IUnknown
2834 [local]
2835 HRESULT Show(
2836 [in, unique, annotation("__in_opt")] HWND hwndOwner);
2838 [call_as(Show)]
2839 HRESULT RemoteShow(
2840 [in, unique] HWND hwndOwner);
2843 typedef [v1_enum] enum FDAP
2845 FDAP_BOTTOM = 0,
2846 FDAP_TOP = 1
2847 } FDAP;
2849 /*****************************************************************************
2850 * IFileDialog interface
2853 object,
2854 uuid(42F85136-DB7E-439C-85F1-E4075D135FC8),
2855 pointer_default(unique)
2857 interface IFileDialog : IModalWindow
2859 [v1_enum] enum _FILEOPENDIALOGOPTIONS
2861 FOS_OVERWRITEPROMPT = 0x00000002,
2862 FOS_STRICTFILETYPES = 0x00000004,
2863 FOS_NOCHANGEDIR = 0x00000008,
2864 FOS_PICKFOLDERS = 0x00000020,
2865 FOS_FORCEFILESYSTEM = 0x00000040,
2866 FOS_ALLNONSTORAGEITEMS = 0x00000080,
2867 FOS_NOVALIDATE = 0x00000100,
2868 FOS_ALLOWMULTISELECT = 0x00000200,
2869 FOS_PATHMUSTEXIST = 0x00000800,
2870 FOS_FILEMUSTEXIST = 0x00001000,
2871 FOS_CREATEPROMPT = 0x00002000,
2872 FOS_SHAREAWARE = 0x00004000,
2873 FOS_NOREADONLYRETURN = 0x00008000,
2874 FOS_NOTESTFILECREATE = 0x00010000,
2875 FOS_HIDEMRUPLACES = 0x00020000,
2876 FOS_HIDEPINNEDPLACES = 0x00040000,
2877 FOS_NODEREFERENCELINKS = 0x00100000,
2878 FOS_DONTADDTORECENT = 0x02000000,
2879 FOS_FORCESHOWHIDDEN = 0x10000000,
2880 FOS_DEFAULTNOMINIMODE = 0x20000000,
2881 FOS_FORCEPREVIEWPANEON = 0x40000000,
2882 FOS_SUPPORTSTREAMABLEITEMS = 0x80000000
2884 typedef DWORD FILEOPENDIALOGOPTIONS;
2886 HRESULT SetFileTypes(
2887 [in] UINT cFileTypes,
2888 [in, size_is(cFileTypes)] const COMDLG_FILTERSPEC *rgFilterSpec);
2890 HRESULT SetFileTypeIndex(
2891 [in] UINT iFileType);
2893 HRESULT GetFileTypeIndex(
2894 [out] UINT *piFileType);
2896 HRESULT Advise(
2897 [in] IFileDialogEvents *pfde,
2898 [out] DWORD *pdwCookie);
2900 HRESULT Unadvise(
2901 [in] DWORD dwCookie);
2903 HRESULT SetOptions(
2904 [in] FILEOPENDIALOGOPTIONS fos);
2906 HRESULT GetOptions(
2907 [out] FILEOPENDIALOGOPTIONS *pfos);
2909 HRESULT SetDefaultFolder(
2910 [in] IShellItem *psi);
2912 HRESULT SetFolder(
2913 [in] IShellItem *psi);
2915 HRESULT GetFolder(
2916 [out] IShellItem **ppsi);
2918 HRESULT GetCurrentSelection(
2919 [out] IShellItem **ppsi);
2921 HRESULT SetFileName(
2922 [in, string] LPCWSTR pszName);
2924 HRESULT GetFileName(
2925 [out, string] LPWSTR *pszName);
2927 HRESULT SetTitle(
2928 [in, string] LPCWSTR pszTitle);
2930 HRESULT SetOkButtonLabel(
2931 [in, string] LPCWSTR pszText);
2933 HRESULT SetFileNameLabel(
2934 [in, string] LPCWSTR pszLabel);
2936 HRESULT GetResult(
2937 [out] IShellItem **ppsi);
2939 HRESULT AddPlace(
2940 [in] IShellItem *psi,
2941 [in] FDAP fdap);
2943 HRESULT SetDefaultExtension(
2944 [in, string] LPCWSTR pszDefaultExtension);
2946 HRESULT Close(
2947 [in] HRESULT hr);
2949 HRESULT SetClientGuid(
2950 [in] REFGUID guid);
2952 HRESULT ClearClientData();
2954 HRESULT SetFilter(
2955 [in] IShellItemFilter *pFilter);
2958 /*****************************************************************************
2959 * IFileDialog2 interface
2962 object,
2963 uuid(61744FC7-85B5-4791-A9B0-272276309B13),
2964 pointer_default(unique)
2966 interface IFileDialog2 : IFileDialog
2968 HRESULT SetCancelButtonLabel(
2969 [in] LPCWSTR pszLabel);
2971 HRESULT SetNavigationRoot(
2972 [in] IShellItem *psi);
2975 /*****************************************************************************
2976 * IFileOperationProgressSink interface
2979 object,
2980 uuid(04B0F1A7-9490-44BC-96E1-4296A31252E2),
2981 pointer_default(unique)
2983 interface IFileOperationProgressSink : IUnknown
2985 HRESULT StartOperations();
2987 HRESULT FinishOperations(
2988 [in] HRESULT hrResult);
2990 HRESULT PreRenameItem(
2991 [in] DWORD dwFlags,
2992 [in] IShellItem *psiItem,
2993 [in, unique, string] LPCWSTR pszNewName);
2995 HRESULT PostRenameItem(
2996 [in] DWORD dwFlags,
2997 [in] IShellItem *psiItem,
2998 [in, string] LPCWSTR pszNewName,
2999 [in] HRESULT hrRename,
3000 [in] IShellItem *psiNewlyCreated);
3002 HRESULT PreMoveItem(
3003 [in] DWORD dwFlags,
3004 [in] IShellItem *psiItem,
3005 [in] IShellItem *psiDestinationFolder,
3006 [in, unique, string] LPCWSTR pszNewName);
3008 HRESULT PostMoveItem(
3009 [in] DWORD dwFlags,
3010 [in] IShellItem *psiItem,
3011 [in] IShellItem *psiDestinationFolder,
3012 [in, unique, string] LPCWSTR pszNewName,
3013 [in] HRESULT hrMove,
3014 [in] IShellItem *psiNewlyCreated);
3016 HRESULT PreCopyItem(
3017 [in] DWORD dwFlags,
3018 [in] IShellItem *psiItem,
3019 [in] IShellItem *psiDestinationFolder,
3020 [in, unique, string] LPCWSTR pszNewName);
3022 HRESULT PostCopyItem(
3023 [in] DWORD dwFlags,
3024 [in] IShellItem *psiItem,
3025 [in] IShellItem *psiDestinationFolder,
3026 [in, unique, string] LPCWSTR pszNewName,
3027 [in] HRESULT hrCopy,
3028 [in] IShellItem *psiNewlyCreated);
3030 HRESULT PreDeleteItem(
3031 [in] DWORD dwFlags,
3032 [in] IShellItem *psiItem);
3034 HRESULT PostDeleteItem(
3035 [in] DWORD dwFlags,
3036 [in] IShellItem *psiItem,
3037 [in] HRESULT hrDelete,
3038 [in] IShellItem *psiNewlyCreated);
3040 HRESULT PreNewItem(
3041 [in] DWORD dwFlags,
3042 [in] IShellItem *psiDestinationFolder,
3043 [in, unique, string] LPCWSTR pszNewName);
3045 HRESULT PostNewItem(
3046 [in] DWORD dwFlags,
3047 [in] IShellItem *psiDestinationFolder,
3048 [in, unique, string] LPCWSTR pszNewName,
3049 [in, unique, string] LPCWSTR pszTemplateName,
3050 [in] DWORD dwFileAttributes,
3051 [in] HRESULT hrNew,
3052 [in] IShellItem *psiNewItem);
3054 HRESULT UpdateProgress(
3055 [in] UINT iWorkTotal,
3056 [in] UINT iWorkSoFar);
3058 HRESULT ResetTimer();
3060 HRESULT PauseTimer();
3062 HRESULT ResumeTimer();
3065 /*****************************************************************************
3066 * IFileSaveDialog interface
3069 object,
3070 uuid(84BCCD23-5FDE-4CDB-AEA4-AF64B83D78AB),
3071 pointer_default(unique)
3073 interface IFileSaveDialog : IFileDialog
3075 HRESULT SetSaveAsItem(
3076 [in] IShellItem *psi);
3078 HRESULT SetProperties(
3079 [in] IPropertyStore *pStore);
3081 HRESULT SetCollectedProperties(
3082 [in] IPropertyDescriptionList *pList,
3083 [in] BOOL fAppendDefault);
3085 HRESULT GetProperties(
3086 [in] IPropertyStore **ppStore);
3088 HRESULT ApplyProperties(
3089 [in] IShellItem *psi,
3090 [in] IPropertyStore *pStore,
3091 [in, unique] HWND hwnd,
3092 [in, unique] IFileOperationProgressSink *pSink);
3096 /*****************************************************************************
3097 * IFileOpenDialog interface
3100 object,
3101 uuid(D57C7288-D4AD-4768-BE02-9D969532D960),
3102 pointer_default(unique)
3104 interface IFileOpenDialog : IFileDialog
3106 HRESULT GetResults(
3107 [out] IShellItemArray **ppenum);
3109 HRESULT GetSelectedItems(
3110 [out] IShellItemArray **ppsai);
3113 typedef [v1_enum] enum CDCONTROLSTATEF
3115 CDCS_INACTIVE = 0x0,
3116 CDCS_ENABLED = 0x1,
3117 CDCS_VISIBLE = 0x2,
3118 CDCS_ENABLEDVISIBLE = 0x3
3119 } CDCONTROLSTATEF;
3120 cpp_quote("DEFINE_ENUM_FLAG_OPERATORS(CDCONTROLSTATEF)")
3121 /*****************************************************************************
3122 * IFileDialogCustomize interface
3125 object,
3126 uuid(E6FDD21A-163F-4975-9C8C-A69F1BA37034),
3127 pointer_default(unique)
3129 interface IFileDialogCustomize : IUnknown
3131 HRESULT EnableOpenDropDown(
3132 [in] DWORD dwIDCtl);
3134 HRESULT AddMenu(
3135 [in] DWORD dwIDCtl,
3136 [in, string] LPCWSTR pszLabel);
3138 HRESULT AddPushButton(
3139 [in] DWORD dwIDCtl,
3140 [in, string] LPCWSTR pszLabel);
3142 HRESULT AddComboBox(
3143 [in] DWORD dwIDCtl);
3145 HRESULT AddRadioButtonList(
3146 [in] DWORD dwIDCtl);
3148 HRESULT AddCheckButton(
3149 [in] DWORD dwIDCtl,
3150 [in, string] LPCWSTR pszLabel,
3151 [in] BOOL bChecked);
3153 HRESULT AddEditBox(
3154 [in] DWORD dwIDCtl,
3155 [in, string] LPCWSTR pszText);
3157 HRESULT AddSeparator(
3158 [in] DWORD dwIDCtl);
3160 HRESULT AddText(
3161 [in] DWORD dwIDCtl,
3162 [in, string] LPCWSTR pszText);
3164 HRESULT SetControlLabel(
3165 [in] DWORD dwIDCtl,
3166 [in, string] LPCWSTR pszLabel);
3168 HRESULT GetControlState(
3169 [in] DWORD dwIDCtl,
3170 [out] CDCONTROLSTATEF *pdwState);
3172 HRESULT SetControlState(
3173 [in] DWORD dwIDCtl,
3174 [in] CDCONTROLSTATEF dwState);
3176 HRESULT GetEditBoxText(
3177 [in] DWORD dwIDCtl,
3178 [out, string] WCHAR **ppszText);
3180 HRESULT SetEditBoxText(
3181 [in] DWORD dwIDCtl,
3182 [in, string] LPCWSTR pszText);
3184 HRESULT GetCheckButtonState(
3185 [in] DWORD dwIDCtl,
3186 [out] BOOL *pbChecked);
3188 HRESULT SetCheckButtonState(
3189 [in] DWORD dwIDCtl,
3190 [in] BOOL bChecked);
3192 HRESULT AddControlItem(
3193 [in] DWORD dwIDCtl,
3194 [in] DWORD dwIDItem,
3195 [in] LPCWSTR pszLabel);
3197 HRESULT RemoveControlItem(
3198 [in] DWORD dwIDCtl,
3199 [in] DWORD dwIDItem);
3201 HRESULT RemoveAllControlItems(
3202 [in] DWORD dwIDCtl);
3204 HRESULT GetControlItemState(
3205 [in] DWORD dwIDCtl,
3206 [in] DWORD dwIDItem,
3207 [out] CDCONTROLSTATEF *pdwState);
3209 HRESULT SetControlItemState(
3210 [in] DWORD dwIDCtl,
3211 [in] DWORD dwIDItem,
3212 [in] CDCONTROLSTATEF dwState);
3214 HRESULT GetSelectedControlItem(
3215 [in] DWORD dwIDCtl,
3216 [out] DWORD *pdwIDItem);
3218 HRESULT SetSelectedControlItem(
3219 [in] DWORD dwIDCtl,
3220 [in] DWORD dwIDItem);
3222 HRESULT StartVisualGroup(
3223 [in] DWORD dwIDCtl,
3224 [in, string] LPCWSTR pszLabel);
3226 HRESULT EndVisualGroup();
3228 HRESULT MakeProminent(
3229 [in] DWORD dwIDCtl);
3231 HRESULT SetControlItemText(
3232 [in] DWORD dwIDCtl,
3233 [in] DWORD dwIDItem,
3234 [in, string] LPCWSTR pszLabel);
3237 /*****************************************************************************
3238 * IFileDialogControlEvents interface
3241 object,
3242 uuid(36116642-D713-4B97-9B83-7484A9D00433),
3243 pointer_default(unique)
3245 interface IFileDialogControlEvents : IUnknown
3247 HRESULT OnItemSelected(
3248 [in] IFileDialogCustomize *pfdc,
3249 [in] DWORD dwIDCtl,
3250 [in] DWORD dwIDItem);
3252 HRESULT OnButtonClicked(
3253 [in] IFileDialogCustomize *pfdc,
3254 [in] DWORD dwIDCtl);
3256 HRESULT OnCheckButtonToggled(
3257 [in] IFileDialogCustomize *pfdc,
3258 [in] DWORD dwIDCtl,
3259 [in] BOOL bChecked);
3261 HRESULT OnControlActivating(
3262 [in] IFileDialogCustomize *pfdc,
3263 [in] DWORD dwIDCtl);
3266 typedef [v1_enum] enum tagKF_CATEGORY
3268 KF_CATEGORY_VIRTUAL = 0x00000001,
3269 KF_CATEGORY_FIXED = 0x00000002,
3270 KF_CATEGORY_COMMON = 0x00000003,
3271 KF_CATEGORY_PERUSER = 0x00000004
3272 } KF_CATEGORY;
3274 typedef [v1_enum] enum tagKF_REDIRECTION_CAPABILITIES
3276 KF_REDIRECTION_CAPABILITIES_ALLOW_ALL = 0x000000ff,
3277 KF_REDIRECTION_CAPABILITIES_REDIRECTABLE = 0x00000001,
3278 KF_REDIRECTION_CAPABILITIES_DENY_ALL = 0x000fff00,
3279 KF_REDIRECTION_CAPABILITIES_DENY_POLICY_REDIRECTED = 0x00000100,
3280 KF_REDIRECTION_CAPABILITIES_DENY_POLICY = 0x00000200,
3281 KF_REDIRECTION_CAPABILITIES_DENY_PERMISSIONS = 0x00000400
3282 } KF_REDIRECTION_CAPABILITIES;
3284 typedef [v1_enum] enum tagKF_DEFINITION_FLAGS
3286 KFDF_LOCAL_REDIRECT_ONLY = 0x00000002,
3287 KFDF_ROAMABLE = 0x00000004,
3288 KFDF_PRECREATE = 0x00000008,
3289 KFDF_STREAM = 0x00000010,
3290 KFDF_PUBLISHEXPANDEDPATH = 0x00000020,
3291 KFDF_NO_REDIRECT_UI = 0x00000040
3292 } KF_DEFINITION_FLAGS;
3294 typedef struct tagKNOWNFOLDER_DEFINITION
3296 KF_CATEGORY category;
3297 LPWSTR pszName;
3298 LPWSTR pszDescription;
3299 KNOWNFOLDERID fidParent;
3300 LPWSTR pszRelativePath;
3301 LPWSTR pszParsingName;
3302 LPWSTR pszTooltip;
3303 LPWSTR pszLocalizedName;
3304 LPWSTR pszIcon;
3305 LPWSTR pszSecurity;
3306 DWORD dwAttributes;
3307 KF_DEFINITION_FLAGS kfdFlags;
3308 FOLDERTYPEID ftidType;
3309 } KNOWNFOLDER_DEFINITION;
3312 object,
3313 uuid(3aa7af7e-9b36-420C-a8e3-f77d4674a488),
3314 pointer_default(ref)
3316 interface IKnownFolder : IUnknown
3318 HRESULT GetId(
3319 [out] KNOWNFOLDERID *pkfid);
3321 HRESULT GetCategory(
3322 [out] KF_CATEGORY *pCategory);
3324 HRESULT GetShellItem(
3325 [in] DWORD dwFlags,
3326 [in] REFIID riid,
3327 [out, iid_is(riid)] void **ppv);
3329 HRESULT GetPath(
3330 [in] DWORD dwFlags,
3331 [out, string] LPWSTR *ppszPath);
3333 HRESULT SetPath(
3334 [in] DWORD dwFlags,
3335 [in, string] LPCWSTR pszPath);
3337 HRESULT GetIDList(
3338 [in] DWORD dwFlags,
3339 [out] PIDLIST_ABSOLUTE *ppidl);
3341 HRESULT GetFolderType(
3342 [out] FOLDERTYPEID *pftid);
3344 HRESULT GetRedirectionCapabilities(
3345 [out] KF_REDIRECTION_CAPABILITIES *pCapabilities);
3347 HRESULT GetFolderDefinition(
3348 [out] KNOWNFOLDER_DEFINITION *pKFD);
3351 typedef [v1_enum] enum tagKF_REDIRECT_FLAGS
3353 KF_REDIRECT_USER_EXCLUSIVE = 0x00000001,
3354 KF_REDIRECT_COPY_SOURCE_DACL = 0x00000002,
3355 KF_REDIRECT_OWNER_USER = 0x00000004,
3356 KF_REDIRECT_SET_OWNER_EXPLICIT = 0x00000008,
3357 KF_REDIRECT_CHECK_ONLY = 0x00000010,
3358 KF_REDIRECT_WITH_UI = 0x00000020,
3359 KF_REDIRECT_UNPIN = 0x00000040,
3360 KF_REDIRECT_PIN = 0x00000080,
3361 KF_REDIRECT_COPY_CONTENTS = 0x00000200,
3362 KF_REDIRECT_DEL_SOURCE_CONTENTS = 0x00000400,
3363 KF_REDIRECT_EXCLUDE_ALL_KNOWN_SUBFOLDERS = 0x00000800
3364 } KF_REDIRECT_FLAGS;
3367 object,
3368 uuid(8BE2D872-86AA-4d47-B776-32CCA40C7018),
3369 pointer_default(ref)
3371 interface IKnownFolderManager : IUnknown
3373 typedef [v1_enum] enum tagFFFP_MODE
3375 FFFP_EXACTMATCH,
3376 FFFP_NEARESTPARENTMATCH
3377 } FFFP_MODE;
3379 HRESULT FolderIdFromCsidl(
3380 [in] int nCsidl,
3381 [out] KNOWNFOLDERID *pfid);
3383 HRESULT FolderIdToCsidl(
3384 [in] REFKNOWNFOLDERID rfid,
3385 [out] int *pnCsidl);
3387 HRESULT GetFolderIds(
3388 [out, size_is(, *pCount)] KNOWNFOLDERID **ppKFId,
3389 [in, out] UINT *pCount);
3391 HRESULT GetFolder(
3392 [in] REFKNOWNFOLDERID rfid,
3393 [out] IKnownFolder **ppkf);
3395 HRESULT GetFolderByName(
3396 [in, string] LPCWSTR pszCanonicalName,
3397 [out] IKnownFolder **ppkf);
3399 HRESULT RegisterFolder(
3400 [in] REFKNOWNFOLDERID rfid,
3401 [in] KNOWNFOLDER_DEFINITION const *pKFD);
3403 HRESULT UnregisterFolder(
3404 [in] REFKNOWNFOLDERID rfid);
3406 HRESULT FindFolderFromPath(
3407 [in, string] LPCWSTR pszPath,
3408 [in] FFFP_MODE mode,
3409 [out] IKnownFolder **ppkf);
3411 HRESULT FindFolderFromIDList(
3412 [in] PCIDLIST_ABSOLUTE pidl,
3413 [out] IKnownFolder **ppkf);
3415 HRESULT Redirect(
3416 [in] REFKNOWNFOLDERID rfid,
3417 [in, unique] HWND hwnd,
3418 [in] KF_REDIRECT_FLAGS flags,
3419 [in, unique, string] LPCWSTR pszTargetPath,
3420 [in] UINT cFolders,
3421 [in, size_is(cFolders), unique] KNOWNFOLDERID const *pExclusion,
3422 [out, string] LPWSTR *ppszError);
3425 /* function for releasing structure returned from IKnownFolder::GetFolderDefinition */
3426 cpp_quote("static inline void FreeKnownFolderDefinitionFields(KNOWNFOLDER_DEFINITION *pKFD)")
3427 cpp_quote("{")
3428 cpp_quote(" CoTaskMemFree(pKFD->pszName);")
3429 cpp_quote(" CoTaskMemFree(pKFD->pszDescription);")
3430 cpp_quote(" CoTaskMemFree(pKFD->pszRelativePath);")
3431 cpp_quote(" CoTaskMemFree(pKFD->pszParsingName);")
3432 cpp_quote(" CoTaskMemFree(pKFD->pszTooltip);")
3433 cpp_quote(" CoTaskMemFree(pKFD->pszLocalizedName);")
3434 cpp_quote(" CoTaskMemFree(pKFD->pszIcon);")
3435 cpp_quote(" CoTaskMemFree(pKFD->pszSecurity);")
3436 cpp_quote("}")
3438 typedef [v1_enum] enum ASSOCIATIONLEVEL {
3439 AL_MACHINE,
3440 AL_EFFECTIVE,
3441 AL_USER
3442 } ASSOCIATIONLEVEL;
3444 typedef [v1_enum] enum ASSOCIATIONTYPE {
3445 AT_FILEEXTENSION,
3446 AT_URLPROTOCOL,
3447 AT_STARTMENUCLIENT,
3448 AT_MIMETYPE
3449 } ASSOCIATIONTYPE;
3452 object,
3453 uuid(4e530b0a-e611-4c77-a3ac-9031d022281b),
3454 pointer_default(unique)
3456 interface IApplicationAssociationRegistration : IUnknown
3458 HRESULT QueryCurrentDefault(
3459 [in, string] LPCWSTR pszQuery,
3460 [in] ASSOCIATIONTYPE atQueryType,
3461 [in] ASSOCIATIONLEVEL alQueryLevel,
3462 [out, string] LPWSTR *ppszAssociation);
3464 HRESULT QueryAppIsDefault(
3465 [in, string] LPCWSTR pszQuery,
3466 [in] ASSOCIATIONTYPE atQueryType,
3467 [in] ASSOCIATIONLEVEL alQueryLevel,
3468 [in, string] LPCWSTR pszAppRegistryName,
3469 [out] BOOL *pfDefault);
3471 HRESULT QueryAppIsDefaultAll(
3472 [in] ASSOCIATIONLEVEL alQueryLevel,
3473 [in, string] LPCWSTR pszAppRegistryName,
3474 [out] BOOL* pfDefault);
3476 HRESULT SetAppAsDefault(
3477 [in, string] LPCWSTR pszAppRegistryName,
3478 [in, string] LPCWSTR pszSet,
3479 [in] ASSOCIATIONTYPE atSetType);
3481 HRESULT SetAppAsDefaultAll(
3482 [in, string] LPCWSTR pszAppRegistryName);
3484 HRESULT ClearUserAssociations();
3488 object,
3489 uuid(12337d35-94c6-48a0-bce7-6a9c69d4d600),
3490 pointer_default(unique)
3492 interface IApplicationDestinations : IUnknown
3494 HRESULT SetAppID(
3495 [in] LPCWSTR pszAppID);
3497 HRESULT RemoveDestination(
3498 [in] IUnknown *punk);
3500 HRESULT RemoveAllDestinations();
3504 object,
3505 uuid(3c594f9f-9f30-47a1-979a-c9e83d3d0a06),
3506 pointer_default(unique)
3508 interface IApplicationDocumentLists : IUnknown
3510 typedef [v1_enum] enum APPDOCLISTTYPE
3512 ADLT_RECENT = 0,
3513 ADLT_FREQUENT = 1,
3514 } APPDOCLISTTYPE;
3516 HRESULT SetAppID(
3517 [in] LPCWSTR pszAppID);
3519 HRESULT GetList(
3520 [in] APPDOCLISTTYPE list_type,
3521 [in] UINT item_count,
3522 [in] REFIID riid,
3523 [out, iid_is(riid)] void **ppv);
3527 uuid(6332debf-87b5-4670-90c0-5e57b408a49e),
3528 object,
3529 pointer_default(unique)
3531 interface ICustomDestinationList : IUnknown
3533 typedef [v1_enum] enum KNOWNDESTCATEGORY {
3534 KDC_FREQUENT = 1,
3535 KDC_RECENT
3536 } KNOWNDESTCATEGORY;
3538 HRESULT SetAppID([in, string] LPCWSTR pszAppID);
3540 HRESULT BeginList(
3541 [out] UINT *pcMinSlots,
3542 [in] REFIID riid,
3543 [out, iid_is(riid)] void **ppv);
3545 HRESULT AppendCategory(
3546 [in, string] LPCWSTR pszCategory,
3547 [in] IObjectArray *poa);
3549 HRESULT AppendKnownCategory([in] KNOWNDESTCATEGORY category);
3550 HRESULT AddUserTasks([in] IObjectArray *poa);
3551 HRESULT CommitList();
3553 HRESULT GetRemovedDestinations(
3554 [in] REFIID riid,
3555 [out, iid_is(riid)] void **ppv);
3557 HRESULT DeleteList([in, unique, string] LPCWSTR pszAppID);
3558 HRESULT AbortList();
3562 uuid(ddefe873-6997-4e68-be26-39b633adbe12),
3563 object,
3564 pointer_default(unique)
3566 interface IQueryCancelAutoPlay : IUnknown
3568 HRESULT AllowAutoPlay([in, string] LPCWSTR path,
3569 [in] DWORD content_type,
3570 [in, string] LPCWSTR label,
3571 [in] DWORD serial_number);
3575 uuid(d594d0d8-8da7-457b-b3b4-ce5dbaac0b88),
3576 pointer_default(unique)
3578 interface ITransferAdviseSink : IUnknown
3580 [v1_enum] enum _TRANSFER_ADVISE_STATE
3582 TS_NONE = 0,
3583 TS_PERFORMING = 1,
3584 TS_PREPARING = 2,
3585 TS_INDETERMINATE = 4
3587 typedef DWORD TRANSFER_ADVISE_STATE;
3589 HRESULT UpdateProgress([in] ULONGLONG size_current,
3590 [in] ULONGLONG size_total,
3591 [in] INT files_current,
3592 [in] INT files_total,
3593 [in] INT folders_current,
3594 [in] INT folders_total);
3595 HRESULT UpdateTransferState([in] TRANSFER_ADVISE_STATE state);
3596 HRESULT ConfirmOverwrite([in] IShellItem *source,
3597 [in] IShellItem *dest_parent,
3598 [in, string] LPCWSTR name);
3599 HRESULT ConfirmEncryptionLoss([in] IShellItem *source);
3600 HRESULT FileFailure([in] IShellItem *item,
3601 [in, unique, string] LPCWSTR itemname,
3602 [in] HRESULT hr,
3603 [in, out, unique, size_is(crename)] LPWSTR rename,
3604 [in] ULONG crename);
3605 HRESULT SubStreamFailure([in] IShellItem *item,
3606 [in, string] LPCWSTR stream,
3607 [in] HRESULT hr);
3608 HRESULT PropertyFailure([in] IShellItem *item,
3609 [in, unique] const PROPERTYKEY *key,
3610 [in] HRESULT hr);
3613 [v1_enum] enum _TRANSFER_SOURCE_FLAGS
3615 TSF_NORMAL = 0,
3616 TSF_FAIL_EXIST = 0,
3617 TSF_RENAME_EXIST = 0x1,
3618 TSF_OVERWRITE_EXIST = 0x2,
3619 TSF_ALLOW_DECRYPTION = 0x4,
3620 TSF_NO_SECURITY = 0x8,
3621 TSF_COPY_CREATION_TIME = 0x10,
3622 TSF_COPY_WRITE_TIME = 0x20,
3623 TSF_USE_FULL_ACCESS = 0x40,
3624 TSF_DELETE_RECYCLE_IF_POSSIBLE = 0x80,
3625 TSF_COPY_HARD_LINK = 0x100,
3626 TSF_COPY_LOCALIZED_NAME = 0x200,
3627 TSF_MOVE_AS_COPY_DELETE = 0x400,
3628 TSF_SUSPEND_SHELLEVENTS = 0x800
3630 typedef DWORD TRANSFER_SOURCE_FLAGS;
3633 uuid(00adb003-bde9-45c6-8e29-d09f9353e108),
3634 object,
3635 pointer_default(unique)
3637 interface ITransferSource : IUnknown
3639 HRESULT Advise([in] ITransferAdviseSink *sink, [out] DWORD *cookie);
3640 HRESULT Unadvise([in] DWORD cookie);
3641 HRESULT SetProperties([in] IPropertyChangeArray *array);
3642 HRESULT OpenItem([in] IShellItem *item,
3643 [in] TRANSFER_SOURCE_FLAGS flags,
3644 [in] REFIID riid,
3645 [out, iid_is(riid)] void **ppv);
3646 HRESULT MoveItem([in] IShellItem *item,
3647 [in] IShellItem *parent_dest,
3648 [in, string] LPCWSTR name_dest,
3649 [in] TRANSFER_SOURCE_FLAGS flags,
3650 [out] IShellItem **newitem);
3651 HRESULT RecycleItem([in] IShellItem *source,
3652 [in] IShellItem *parent_dest,
3653 [in] TRANSFER_SOURCE_FLAGS flags,
3654 [out] IShellItem **new_dest);
3655 HRESULT RemoveItem([in] IShellItem *source, [in] TRANSFER_SOURCE_FLAGS flags);
3656 HRESULT RenameItem([in] IShellItem *source,
3657 [in, string] LPCWSTR newname,
3658 [in] TRANSFER_SOURCE_FLAGS flags,
3659 [out] IShellItem **new_dest);
3660 HRESULT LinkItem([in] IShellItem *source,
3661 [in] IShellItem *parent_dest,
3662 [in, unique, string] LPCWSTR new_name,
3663 [in] TRANSFER_SOURCE_FLAGS flags,
3664 [out] IShellItem **new_dest);
3665 HRESULT ApplyPropertiesToItem([in] IShellItem *source, [out] IShellItem **newitem);
3666 HRESULT GetDefaultDestinationName([in] IShellItem *source,
3667 [in] IShellItem *parent_dest,
3668 [out, string] LPWSTR *dest_name);
3669 HRESULT EnterFolder([in] IShellItem *child_folder);
3670 HRESULT LeaveFolder([in] IShellItem *child_folder);
3674 uuid(48addd32-3ca5-4124-abe3-b5a72531b207),
3675 object,
3676 pointer_default(unique)
3678 interface ITransferDestination : IUnknown
3680 HRESULT Advise([in] ITransferAdviseSink *sink, [out] DWORD *cookie);
3681 HRESULT Unadvise([in] DWORD cookie);
3682 HRESULT CreateItem([in, string] LPCWSTR name,
3683 [in] DWORD attr,
3684 [in] ULONGLONG size,
3685 [in] TRANSFER_SOURCE_FLAGS flags,
3686 [in] REFIID riid,
3687 [out, iid_is(riid)] void **ppv,
3688 [in] REFIID resources,
3689 [out, iid_is(riid)] void **presources);
3693 uuid(92218cab-ecaa-4335-8133-807fd234c2ee),
3694 object,
3695 pointer_default(unique)
3697 interface IAssocHandlerInvoker : IUnknown
3699 HRESULT SupportsSelection();
3700 HRESULT Invoke();
3704 uuid(f04061ac-1659-4a3f-a954-775aa57fc083),
3705 object,
3706 pointer_default(unique)
3708 interface IAssocHandler : IUnknown
3710 HRESULT GetName([out, string] LPWSTR *name);
3711 HRESULT GetUIName([out, string] LPWSTR *uiname);
3712 HRESULT GetIconLocation([out, string] LPWSTR *path,
3713 [out] int *index);
3714 HRESULT IsRecommended();
3715 HRESULT MakeDefault([in, string] LPCWSTR description);
3716 HRESULT Invoke([in] IDataObject *object);
3717 HRESULT CreateInvoker([in] IDataObject *object,
3718 [out] IAssocHandlerInvoker **invoker);
3722 uuid(973810ae-9599-4b88-9e4d-6ee98c9552da),
3723 object,
3724 pointer_default(unique)
3726 interface IEnumAssocHandlers : IUnknown
3728 HRESULT Next([in] ULONG count,
3729 [out, size_is(count), length_is(*fetched)] IAssocHandler **handlers,
3730 [out] ULONG *fetched);
3733 typedef enum ASSOC_FILTER
3735 ASSOC_FILTER_NONE = 0,
3736 ASSOC_FILTER_RECOMMENDED
3737 } ASSOC_FILTER;
3738 cpp_quote("HRESULT WINAPI SHAssocEnumHandlers(PCWSTR extra, ASSOC_FILTER filter, IEnumAssocHandlers **handlersenum);")
3741 uuid(1df0d7f1-b267-4d28-8b10-12e23202a5c4),
3743 interface IItemNameLimits : IUnknown
3745 HRESULT GetValidCharacters(
3746 [out, string] LPWSTR *validchars,
3747 [out, string] LPWSTR *invalidchars);
3749 HRESULT GetMaxLength(
3750 [in, string] LPCWSTR name,
3751 [out] int *max_length);
3754 typedef [v1_enum] enum ACTIVATEOPTIONS
3756 AO_NONE = 0x00000000,
3757 AO_DESIGNMODE = 0x00000001,
3758 AO_NOERRORUI = 0x00000002,
3759 AO_NOSPLASHSCREEN = 0x00000004,
3760 AO_PRELAUNCH = 0x02000000
3761 } ACTIVATEOPTIONS;
3764 uuid(2e941141-7f97-4756-ba1d-9decde894a3d),
3765 object,
3766 pointer_default(unique)
3768 interface IApplicationActivationManager : IUnknown
3770 HRESULT ActivateApplication([in] LPCWSTR appusermodelid,
3771 [in, unique] LPCWSTR arguments,
3772 [in] ACTIVATEOPTIONS options,
3773 [out] DWORD *processid);
3774 HRESULT ActivateForFile([in] LPCWSTR appusermodelid,
3775 [in] IShellItemArray *itemarray,
3776 [in, unique] LPCWSTR verb,
3777 [out] DWORD *processid);
3778 HRESULT ActivateForProtocol([in] LPCWSTR appusermodelid,
3779 [in] IShellItemArray *itemarray,
3780 [out] DWORD *processid);
3784 object,
3785 uuid(fec87aaf-35f9-447a-adb7-20234491401a),
3786 pointer_default(unique)
3788 interface IPreviewHandlerFrame : IUnknown
3790 typedef struct PREVIEWHANDLERFRAMEINFO
3792 HACCEL haccel;
3793 UINT cAccelEntries;
3794 } PREVIEWHANDLERFRAMEINFO;
3796 HRESULT GetWindowContext([out] PREVIEWHANDLERFRAMEINFO *info);
3797 HRESULT TranslateAccelerator([in] MSG *msg);
3800 /*****************************************************************************
3801 * ShellObjects typelibrary
3804 uuid(50A7E9B1-70EF-11D1-B75A-00A0C90564FE),
3805 lcid(0x0000),
3806 version(1.0)
3808 library ShellObjects
3811 uuid(71F96385-DDD6-48D3-A0C1-AE06E8B055FB)
3813 coclass ExplorerBrowser
3815 interface IExplorerBrowser;
3819 uuid(DC1C5A9C-E88A-4DDE-A5A1-60F82A20AEF7)
3821 coclass FileOpenDialog
3823 interface IFileOpenDialog;
3827 uuid(C0B4E2F3-BA21-4773-8DBA-335EC946EB8B)
3829 coclass FileSaveDialog
3831 interface IFileSaveDialog;
3835 uuid(AE054212-3535-4430-83ED-D501AA6680E6)
3837 coclass NamespaceTreeControl
3839 interface INameSpaceTreeControl2;
3843 uuid(4df0c730-df9d-4ae3-9153-aa6b82e9795a)
3845 coclass KnownFolderManager
3847 interface IKnownFolderManager;
3851 uuid(591209c7-767b-42b2-9fba-44ee4615f2c7)
3853 coclass ApplicationAssociationRegistration
3855 interface IApplicationAssociationRegistration;
3859 uuid(86c14003-4d6b-4ef3-a7b4-0506663b2e68)
3861 coclass ApplicationDestinations
3863 interface IApplicationDestinations;
3867 uuid(86bec222-30f2-47e0-9f25-60d11cd75c28)
3869 coclass ApplicationDocumentLists
3871 interface IApplicationDocumentLists;
3875 uuid(00021401-0000-0000-c000-000000000046)
3877 coclass ShellLink
3879 interface IShellLinkW;
3883 uuid(56fdf344-fd6d-11d0-958a-006097c9a090)
3885 coclass TaskbarList
3887 interface ITaskbarList4;
3891 uuid(77f10cf0-3db5-4966-b520-b7c54fd35ed6)
3893 coclass DestinationList {
3894 interface ICustomDestinationList;
3898 uuid(2d3468c1-36a7-43b6-ac24-d3f02fd9607a)
3900 coclass EnumerableObjectCollection
3902 interface IEnumObjects;
3906 uuid(331f1768-05a9-4ddd-b86e-dae34ddc998a)
3908 coclass QueryCancelAutoPlay
3910 interface IQueryCancelAutoPlay;
3914 uuid(45ba127d-10a8-46ea-8ab7-56ea9078943c)
3916 coclass ApplicationActivationManager
3918 interface IApplicationActivationManager;
3922 uuid(3ad05575-8857-4850-9277-11b85bdb8e09)
3924 coclass FileOperation
3926 interface IFileOperation;
3930 [v1_enum] enum _OPPROGDLGF
3932 OPPROGDLG_DEFAULT = 0x00000000,
3933 OPPROGDLG_ENABLEPAUSE = 0x00000080,
3934 OPPROGDLG_ALLOWUNDO = 0x00000100,
3935 OPPROGDLG_DONTDISPLAYSOURCEPATH = 0x00000200,
3936 OPPROGDLG_DONTDISPLAYDESTPATH = 0x00000400,
3937 OPPROGDLG_NOMULTIDAYESTIMATES = 0x00000800,
3938 OPPROGDLG_DONTDISPLAYLOCATIONS = 0x00001000,
3940 typedef DWORD OPPROGDLGF;
3942 typedef [v1_enum] enum _SPACTION {
3943 SPACTION_NONE,
3944 SPACTION_MOVING,
3945 SPACTION_COPYING,
3946 SPACTION_RECYCLING,
3947 SPACTION_APPLYINGATTRIBS,
3948 SPACTION_DOWNLOADING,
3949 SPACTION_SEARCHING_INTERNET,
3950 SPACTION_CALCULATING,
3951 SPACTION_UPLOADING,
3952 SPACTION_SEARCHING_FILES,
3953 SPACTION_DELETING,
3954 SPACTION_RENAMING,
3955 SPACTION_FORMATTING,
3956 SPACTION_COPY_MOVING,
3957 } SPACTION;
3960 object,
3961 uuid(0c9fb851-e5c9-43eb-a370-f0677b13874c),
3962 pointer_default(unique)
3964 interface IOperationsProgressDialog : IUnknown
3966 [v1_enum] enum _PDMODE
3968 PDM_DEFAULT = 0x00000000,
3969 PDM_RUN = 0x00000001,
3970 PDM_PREFLIGHT = 0x00000002,
3971 PDM_UNDOING = 0x00000004,
3972 PDM_ERRORSBLOCKING = 0x00000008,
3973 PDM_INDETERMINATE = 0x00000010,
3975 typedef DWORD PDMODE;
3977 typedef [v1_enum] enum PDOPSTATUS
3979 PDOPS_RUNNING = 1,
3980 PDOPS_PAUSED,
3981 PDOPS_CANCELLED,
3982 PDOPS_STOPPED,
3983 PDOPS_ERRORS
3984 } PDOPSTATUS;
3986 HRESULT StartProgressDialog([in, unique] HWND owner, [in] OPPROGDLGF flags);
3987 HRESULT StopProgressDialog();
3988 HRESULT SetOperation([in] SPACTION action);
3989 HRESULT SetMode([in] PDMODE mode);
3990 HRESULT UpdateProgress([in] ULONGLONG current_points, [in] ULONGLONG total_points,
3991 [in] ULONGLONG current_size, [in] ULONGLONG total_size,
3992 [in] ULONGLONG current_item, [in] ULONGLONG total_item);
3993 HRESULT UpdateLocations([in, unique] IShellItem *source, [in, unique] IShellItem *target,
3994 [in, unique] IShellItem *item);
3995 HRESULT ResetTimer();
3996 HRESULT PauseTimer();
3997 HRESULT ResumeTimer();
3998 HRESULT GetMilliseconds([out] ULONGLONG *elapsed, [out] ULONGLONG *remaining);
3999 HRESULT GetOperationStatus([out] PDOPSTATUS *status);
4003 object,
4004 uuid(947aab5f-0a5c-4c13-b4d6-4bf7836fc9f8),
4005 pointer_default(unique)
4007 interface IFileOperation : IUnknown
4009 HRESULT Advise([in] IFileOperationProgressSink *sink, [out] DWORD *cookie);
4010 HRESULT Unadvise([in] DWORD cookie);
4011 HRESULT SetOperationFlags([in] DWORD flags);
4012 HRESULT SetProgressMessage([in, string] LPCWSTR message);
4013 HRESULT SetProgressDialog([in] IOperationsProgressDialog *dialog);
4014 HRESULT SetProperties([in] IPropertyChangeArray *array);
4015 HRESULT SetOwnerWindow([in] HWND owner);
4016 HRESULT ApplyPropertiesToItem([in] IShellItem *item);
4017 HRESULT ApplyPropertiesToItems([in] IUnknown *items);
4018 HRESULT RenameItem([in] IShellItem *item, [in, string] LPCWSTR name,
4019 [in, unique] IFileOperationProgressSink *sink);
4020 HRESULT RenameItems([in] IUnknown *items, [in, string] LPCWSTR name);
4021 HRESULT MoveItem([in] IShellItem *item, [in] IShellItem *folder,
4022 [in, unique, string] LPCWSTR name,
4023 [in, unique] IFileOperationProgressSink *sink);
4024 HRESULT MoveItems([in] IUnknown *items, [in] IShellItem *folder);
4025 HRESULT CopyItem([in] IShellItem *item, [in] IShellItem *folder,
4026 [in, unique, string] LPCWSTR name,
4027 [in, unique] IFileOperationProgressSink *sink);
4028 HRESULT CopyItems([in] IUnknown *items, [in] IShellItem *folder);
4029 HRESULT DeleteItem([in] IShellItem *item,
4030 [in, unique] IFileOperationProgressSink *sink);
4031 HRESULT DeleteItems([in] IUnknown *items);
4032 HRESULT NewItem([in] IShellItem *folder, [in] DWORD attributes,
4033 [in, unique, string] LPCWSTR name, [in, unique, string] LPCWSTR template_name,
4034 [in, unique] IFileOperationProgressSink *sink);
4035 HRESULT PerformOperations();
4036 HRESULT GetAnyOperationsAborted([out] BOOL *aborted);