ntdll: Bump Win 10 version to 17763.
[wine/zf.git] / include / shobjidl.idl
blob42ef264ed86fd59c539c61ee29c38488ff0366d7
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 * IDropTargetHelper interface
1583 object,
1584 uuid(4657278b-411b-11d2-839a-00c04fd918d0),
1585 pointer_default(unique),
1586 local
1588 interface IDropTargetHelper : IUnknown
1590 HRESULT DragEnter(
1591 [in] HWND hwndTarget,
1592 [in] IDataObject *pDataObject,
1593 [in] POINT *ppt,
1594 [in] DWORD dwEffect);
1596 HRESULT DragLeave();
1598 HRESULT DragOver(
1599 [in] POINT *ppt,
1600 [in] DWORD dwEffect);
1602 HRESULT Drop(
1603 [in] IDataObject *pDataObject,
1604 [in] POINT *ppt,
1605 [in] DWORD dwEffect);
1607 HRESULT Show( [in] BOOL fShow );
1611 /*****************************************************************************
1612 * IContextMenu interface
1615 object,
1616 uuid(000214e4-0000-0000-c000-000000000046),
1617 pointer_default(unique),
1618 local
1620 interface IContextMenu : IUnknown
1622 cpp_quote("#define CMF_NORMAL 0x00000000")
1623 cpp_quote("#define CMF_DEFAULTONLY 0x00000001")
1624 cpp_quote("#define CMF_VERBSONLY 0x00000002")
1625 cpp_quote("#define CMF_EXPLORE 0x00000004")
1626 cpp_quote("#define CMF_NOVERBS 0x00000008")
1627 cpp_quote("#define CMF_CANRENAME 0x00000010")
1628 cpp_quote("#define CMF_NODEFAULT 0x00000020")
1629 cpp_quote("#define CMF_INCLUDESTATIC 0x00000040")
1630 cpp_quote("#define CMF_ITEMMENU 0x00000080")
1631 cpp_quote("#define CMF_EXTENDEDVERBS 0x00000100")
1632 cpp_quote("#define CMF_DISABLEDVERBS 0x00000200")
1633 cpp_quote("#define CMF_ASYNCVERBSTATE 0x00000400")
1634 cpp_quote("#define CMF_OPTIMIZEFORINVOKE 0x00000800")
1635 cpp_quote("#define CMF_SYNCCASCADEMENU 0x00001000")
1636 cpp_quote("#define CMF_DONOTPICKDEFAULT 0x00002000")
1637 cpp_quote("#define CMF_RESERVED 0xffff0000")
1639 cpp_quote("#define GCS_VERBA 0x00000000")
1640 cpp_quote("#define GCS_HELPTEXTA 0x00000001")
1641 cpp_quote("#define GCS_VALIDATEA 0x00000002")
1642 cpp_quote("#define GCS_VERBW 0x00000004")
1643 cpp_quote("#define GCS_HELPTEXTW 0x00000005")
1644 cpp_quote("#define GCS_VALIDATEW 0x00000006")
1645 cpp_quote("#define GCS_UNICODE 0x00000004")
1646 cpp_quote("#define GCS_VERB WINELIB_NAME_AW(GCS_VERB)")
1647 cpp_quote("#define GCS_HELPTEXT WINELIB_NAME_AW(GCS_HELPTEXT)")
1648 cpp_quote("#define GCS_VALIDATE WINELIB_NAME_AW(GCS_VALIDATE)")
1650 cpp_quote("#define CMDSTR_NEWFOLDERA \"NewFolder\"")
1651 cpp_quote("#define CMDSTR_VIEWLISTA \"ViewList\"")
1652 cpp_quote("#define CMDSTR_VIEWDETAILSA \"ViewDetails\"")
1653 cpp_quote("#if defined(__GNUC__)")
1654 cpp_quote("# define CMDSTR_NEWFOLDERW (const WCHAR []){ 'N','e','w','F','o','l','d','e','r',0 }")
1655 cpp_quote("# define CMDSTR_VIEWLISTW (const WCHAR []){ 'V','i','e','w','L','i','s','t',0 }")
1656 cpp_quote("# define CMDSTR_VIEWDETAILSW (const WCHAR []){ 'V','i','e','w','D','e','t','a','i','l','s',0 }")
1657 cpp_quote("#elif defined(_MSC_VER)")
1658 cpp_quote("# define CMDSTR_NEWFOLDERW L\"NewFolder\"")
1659 cpp_quote("# define CMDSTR_VIEWLISTW L\"ViewList\"")
1660 cpp_quote("# define CMDSTR_VIEWDETAILSW L\"ViewDetails\"")
1661 cpp_quote("#else")
1662 cpp_quote("static const WCHAR CMDSTR_NEWFOLDERW[] = {'N','e','w','F','o','l','d','e','r',0};")
1663 cpp_quote("static const WCHAR CMDSTR_VIEWLISTW [] = {'V','i','e','w','L','i','s','t',0};")
1664 cpp_quote("static const WCHAR CMDSTR_VIEWDETAILSW[] = {'V','i','e','w','D','e','t','a','i','l','s',0};")
1665 cpp_quote("#endif")
1666 cpp_quote("#define CMDSTR_NEWFOLDER WINELIB_NAME_AW(CMDSTR_NEWFOLDER)")
1667 cpp_quote("#define CMDSTR_VIEWLIST WINELIB_NAME_AW(CMDSTR_VIEWLIST)")
1668 cpp_quote("#define CMDSTR_VIEWDETAILS WINELIB_NAME_AW(CMDSTR_VIEWDETAILS)")
1670 cpp_quote("#define CMIC_MASK_HOTKEY SEE_MASK_HOTKEY")
1671 cpp_quote("#define CMIC_MASK_ICON SEE_MASK_ICON")
1672 cpp_quote("#define CMIC_MASK_FLAG_NO_UI SEE_MASK_FLAG_NO_UI")
1673 cpp_quote("#define CMIC_MASK_UNICODE SEE_MASK_UNICODE")
1674 cpp_quote("#define CMIC_MASK_NO_CONSOLE SEE_MASK_NO_CONSOLE")
1675 cpp_quote("#define CMIC_MASK_HASLINKNAME SEE_MASK_HASLINKNAME")
1676 cpp_quote("#define CMIC_MASK_FLAG_SEP_VDM SEE_MASK_FLAG_SEPVDM")
1677 cpp_quote("#define CMIC_MASK_HASTITLE SEE_MASK_HASTITLE")
1678 cpp_quote("#define CMIC_MASK_ASYNCOK SEE_MASK_ASYNCOK")
1679 cpp_quote("#define CMIC_MASK_NOASYNC SEE_MASK_NOASYNC")
1680 cpp_quote("#define CMIC_MASK_SHIFT_DOWN 0x10000000")
1681 cpp_quote("#define CMIC_MASK_PTINVOKE 0x20000000")
1682 cpp_quote("#define CMIC_MASK_CONTROL_DOWN 0x40000000")
1683 cpp_quote("#define CMIC_MASK_FLAG_LOG_USAGE SEE_MASK_FLAG_LOG_USAGE")
1684 cpp_quote("#define CMIC_MASK_NOZONECHECKS SEE_MASK_NOZONECHECKS")
1686 typedef IContextMenu *LPCONTEXTMENU;
1688 typedef struct tagCMINVOKECOMMANDINFO
1690 DWORD cbSize;
1691 DWORD fMask;
1692 HWND hwnd;
1693 LPCSTR lpVerb;
1694 LPCSTR lpParameters;
1695 LPCSTR lpDirectory;
1696 INT nShow;
1697 DWORD dwHotKey;
1698 HANDLE hIcon;
1699 } CMINVOKECOMMANDINFO, *LPCMINVOKECOMMANDINFO;
1701 typedef struct tagCMInvokeCommandInfoEx
1703 DWORD cbSize;
1704 DWORD fMask;
1705 HWND hwnd;
1706 LPCSTR lpVerb;
1707 LPCSTR lpParameters;
1708 LPCSTR lpDirectory;
1709 INT nShow;
1710 DWORD dwHotKey;
1711 HANDLE hIcon;
1712 LPCSTR lpTitle;
1713 LPCWSTR lpVerbW;
1714 LPCWSTR lpParametersW;
1715 LPCWSTR lpDirectoryW;
1716 LPCWSTR lpTitleW;
1717 POINT ptInvoke;
1718 } CMINVOKECOMMANDINFOEX, *LPCMINVOKECOMMANDINFOEX;
1720 HRESULT QueryContextMenu(
1721 [in] HMENU hmenu,
1722 [in] UINT indexMenu,
1723 [in] UINT idCmdFirst,
1724 [in] UINT idCmdLast,
1725 [in] UINT uFlags);
1727 HRESULT InvokeCommand( [in] LPCMINVOKECOMMANDINFO lpici );
1729 HRESULT GetCommandString(
1730 [in] UINT_PTR idCmd,
1731 [in] UINT uType,
1732 [out] UINT *pwReserved,
1733 [out, size_is(cchMax)] LPSTR pszName,
1734 [in] UINT cchMax);
1738 /*****************************************************************************
1739 * IContextMenu2 interface
1742 object,
1743 uuid(000214f4-0000-0000-c000-000000000046),
1744 pointer_default(unique),
1745 local
1747 interface IContextMenu2 : IContextMenu
1749 typedef IContextMenu2 *LPCONTEXTMENU2;
1751 HRESULT HandleMenuMsg(
1752 [in] UINT uMsg,
1753 [in] WPARAM wParam,
1754 [in] LPARAM lParam);
1758 /*****************************************************************************
1759 * IContextMenu3 interface
1762 object,
1763 uuid(bcfce0a0-ec17-11d0-8d10-00a0c90f2719),
1764 pointer_default(unique),
1765 local
1767 interface IContextMenu3 : IContextMenu2
1769 typedef IContextMenu3 *LPCONTEXTMENU3;
1771 HRESULT HandleMenuMsg2(
1772 [in] UINT uMsg,
1773 [in] WPARAM wParam,
1774 [in] LPARAM lParam,
1775 [out] LRESULT *plResult);
1780 object,
1781 uuid(3409e930-5a39-11d1-83fa-00a0c90dc849),
1782 pointer_default(unique),
1783 local
1785 interface IContextMenuCB : IUnknown
1787 HRESULT CallBack(
1788 [in] IShellFolder *psf,
1789 [in] HWND hwndOwner,
1790 [in] IDataObject *pdtobj,
1791 [in] UINT uMsg,
1792 [in] WPARAM wParam,
1793 [in] LPARAM lParam);
1796 /*****************************************************************************
1797 * IShellExecuteHookA interface
1800 object,
1801 uuid(000214f5-0000-0000-c000-000000000046),
1802 pointer_default(unique),
1803 local
1805 interface IShellExecuteHookA : IUnknown
1807 cpp_quote("struct _SHELLEXECUTEINFOA;")
1808 HRESULT Execute(
1809 [in, out] struct _SHELLEXECUTEINFOA* pei);
1813 /*****************************************************************************
1814 * IShellExecuteHookW interface
1817 object,
1818 uuid(000214fb-0000-0000-c000-000000000046),
1819 pointer_default(unique),
1820 local
1822 interface IShellExecuteHookW : IUnknown
1824 cpp_quote("struct _SHELLEXECUTEINFOW;")
1825 HRESULT Execute(
1826 [in, out] struct _SHELLEXECUTEINFOW* pei);
1829 /*****************************************************************************
1830 * IShellLinkDataList interface
1833 object,
1834 uuid(45e2b4ae-b1c3-11d0-b92f-00a0c90312e1),
1835 pointer_default(unique)
1837 interface IShellLinkDataList : IUnknown
1839 [local] HRESULT AddDataBlock(
1840 [in] void *pDataBlock);
1841 [local] HRESULT CopyDataBlock(
1842 [in] DWORD dwSig,
1843 [out] void **ppDataBlock);
1844 HRESULT RemoveDataBlock(
1845 [in] DWORD dwSig);
1846 HRESULT GetFlags(
1847 [out] DWORD *pdwFlags);
1848 HRESULT SetFlags(
1849 [in] DWORD dwFlags);
1853 /*****************************************************************************
1854 * IResolveShellLink interface
1857 object,
1858 uuid(5cd52983-9449-11d2-963a-00c04f79adf0),
1859 pointer_default(unique)
1861 interface IResolveShellLink : IUnknown
1863 HRESULT ResolveShellLink(
1864 [in] IUnknown *punk,
1865 [in] HWND hwnd,
1866 [in] DWORD fFlags);
1870 /*****************************************************************************
1871 * IURLSearchHook interface
1874 object,
1875 uuid(ac60f6a0-0fd9-11d0-99cb-00c04fd64497),
1876 pointer_default(unique),
1877 local
1879 interface IURLSearchHook : IUnknown
1881 HRESULT Translate(
1882 [in, out] LPWSTR lpwszSearchURL,
1883 [in] DWORD cchBufferSize);
1887 /*****************************************************************************
1888 * ISearchContext interface
1891 object,
1892 uuid(09f656a2-41af-480c-88f7-16cc0d164615),
1893 pointer_default(unique),
1894 local
1896 interface ISearchContext : IUnknown
1898 HRESULT GetSearchUrl(
1899 [in] BSTR *pbstrSearchUrl);
1900 HRESULT GetSearchText(
1901 [in] BSTR *pbstrSearchText);
1902 HRESULT GetSearchStyle(
1903 [in] DWORD *pdwSearchStyle);
1907 /*****************************************************************************
1908 * IURLSearchHook2 interface
1911 object,
1912 uuid(5ee44da4-6d32-46e3-86bc-07540dedd0e0),
1913 pointer_default(unique),
1914 local
1916 interface IURLSearchHook2 : IURLSearchHook
1918 HRESULT TranslateWithSearchContext(
1919 [in, out] LPWSTR lpwszSearchURL,
1920 [in] DWORD cchBufferSize,
1921 [in] ISearchContext *pSearchContext);
1925 cpp_quote("#define INewShortcutHook WINELIB_NAME_AW(INewShortcutHook)")
1927 /*****************************************************************************
1928 * INewShortcutHookA interface
1931 object,
1932 uuid(000214e1-0000-0000-c000-000000000046),
1933 pointer_default(unique),
1934 local
1936 interface INewShortcutHookA : IUnknown
1938 HRESULT SetReferent(
1939 [in] LPCSTR pcszReferent,
1940 [in] HWND hwnd);
1941 HRESULT GetReferent(
1942 [out] LPSTR pcszReferent,
1943 [in] int cchReferent);
1944 HRESULT SetFolder(
1945 [in] LPCSTR pcszReferent);
1946 HRESULT GetFolder(
1947 [out] LPSTR pcszReferent,
1948 [in] int cchFolder);
1949 HRESULT GetName(
1950 [out] LPSTR pszName,
1951 [in] int cchName);
1952 HRESULT GetExtension(
1953 [out] LPSTR pszExtension,
1954 [in] int cchExtension);
1958 /*****************************************************************************
1959 * INewShortcutHookW interface
1962 object,
1963 uuid(000214f7-0000-0000-c000-000000000046),
1964 pointer_default(unique),
1965 local
1967 interface INewShortcutHookW : IUnknown
1969 HRESULT SetReferent(
1970 [in] LPCWSTR pcszReferent,
1971 [in] HWND hwnd);
1972 HRESULT GetReferent(
1973 [out] LPWSTR pcszReferent,
1974 [in] int cchReferent);
1975 HRESULT SetFolder(
1976 [in] LPCWSTR pcszReferent);
1977 HRESULT GetFolder(
1978 [out] LPWSTR pcszReferent,
1979 [in] int cchFolder);
1980 HRESULT GetName(
1981 [out] LPWSTR pszName,
1982 [in] int cchName);
1983 HRESULT GetExtension(
1984 [out] LPWSTR pszExtension,
1985 [in] int cchExtension);
1988 /*****************************************************************************
1989 * IRunnableTask interface
1992 object,
1993 uuid(85788d00-6807-11d0-b810-00c04fd706ec),
1994 pointer_default(unique),
1995 local
1997 interface IRunnableTask : IUnknown
1999 HRESULT Run();
2000 HRESULT Kill([in] BOOL fWait);
2001 HRESULT Suspend();
2002 HRESULT Resume();
2003 ULONG IsRunning();
2006 /*****************************************************************************
2007 * IShellChangeNotify interface
2010 object,
2011 uuid(d82be2b1-5764-11d0-a96e-00c04fd705a2),
2012 pointer_default(unique),
2013 local
2015 interface IShellChangeNotify : IUnknown
2017 HRESULT OnChange(
2018 [in] LONG lEvent,
2019 [in] LPCITEMIDLIST pidl1,
2020 [in] LPCITEMIDLIST pidl2);
2023 /*****************************************************************************
2024 * IFileSystemBindData interface
2027 object,
2028 uuid(01e18d10-4d8b-11d2-855d-006008059367),
2029 pointer_default(unique),
2030 local
2032 interface IFileSystemBindData : IUnknown
2034 HRESULT SetFindData(
2035 [in] const WIN32_FIND_DATAW *pfd);
2036 HRESULT GetFindData(
2037 [out] WIN32_FIND_DATAW *pfd);
2040 /*****************************************************************************
2041 * ITaskbarList interface
2044 object,
2045 uuid(56FDF342-FD6D-11d0-958A-006097C9A090),
2046 pointer_default(unique)
2048 interface ITaskbarList : IUnknown
2050 HRESULT HrInit();
2052 HRESULT AddTab(
2053 [in] HWND hwnd);
2055 HRESULT DeleteTab(
2056 [in] HWND hwnd);
2058 HRESULT ActivateTab(
2059 [in] HWND hwnd);
2061 HRESULT SetActiveAlt(
2062 [in] HWND hwnd);
2065 /*****************************************************************************
2066 * ITaskbarList2 interface
2069 object,
2070 uuid(602D4995-B13A-429B-A66E-1935E44F4317),
2071 pointer_default(unique)
2073 interface ITaskbarList2 : ITaskbarList
2075 HRESULT MarkFullscreenWindow(
2076 [in] HWND hwnd,
2077 [in] BOOL fullscreen);
2080 cpp_quote("#ifdef MIDL_PASS")
2081 typedef IUnknown* HIMAGELIST;
2082 cpp_quote("#endif")
2084 typedef [v1_enum] enum THUMBBUTTONFLAGS {
2085 THBF_ENABLED = 0x0000,
2086 THBF_DISABLED = 0x0001,
2087 THBF_DISMISSONCLICK = 0x0002,
2088 THBF_NOBACKGROUND = 0x0004,
2089 THBF_HIDDEN = 0x0008,
2090 THBF_NONINTERACTIVE = 0x0010
2091 } THUMBBUTTONFLAGS;
2093 cpp_quote("DEFINE_ENUM_FLAG_OPERATORS(THUMBBUTTONFLAGS)")
2095 typedef [v1_enum] enum THUMBBUTTONMASK {
2096 THB_BITMAP = 0x0001,
2097 THB_ICON = 0x0002,
2098 THB_TOOLTIP = 0x0004,
2099 THB_FLAGS = 0x0008
2100 } THUMBBUTTONMASK;
2102 cpp_quote("DEFINE_ENUM_FLAG_OPERATORS(THUMBBUTTONMASK)")
2104 cpp_quote("#include <pshpack8.h>")
2105 typedef struct THUMBBUTTON {
2106 THUMBBUTTONMASK dwMask;
2107 UINT iId;
2108 UINT iBitmap;
2109 HICON hIcon;
2110 WCHAR szTip[260];
2111 THUMBBUTTONFLAGS dwFlags;
2112 } THUMBBUTTON, *LPTHUMBBUTTON;
2113 cpp_quote("#include <poppack.h>")
2116 uuid(ea1afb91-9e28-4b86-90e9-9e9f8a5eefaf),
2117 object
2119 interface ITaskbarList3 : ITaskbarList2
2121 typedef [v1_enum] enum TBPFLAG {
2122 TBPF_NOPROGRESS = 0x0000,
2123 TBPF_INDETERMINATE = 0x0001,
2124 TBPF_NORMAL = 0x0002,
2125 TBPF_ERROR = 0x0004,
2126 TBPF_PAUSED = 0x0008
2127 } TBPFLAG;
2129 cpp_quote("DEFINE_ENUM_FLAG_OPERATORS(TBPFLAG)")
2131 HRESULT SetProgressValue(
2132 [in] HWND hwnd,
2133 [in] ULONGLONG ullCompleted,
2134 [in] ULONGLONG ullTotal);
2136 HRESULT SetProgressState(
2137 [in] HWND hwnd,
2138 [in] TBPFLAG tbpFlags);
2140 HRESULT RegisterTab(
2141 [in] HWND hwndTab,
2142 [in] HWND hwndMDI);
2144 HRESULT UnregisterTab([in] HWND hwndTab);
2146 HRESULT SetTabOrder(
2147 [in] HWND hwndTab,
2148 [in] HWND hwndInsertBefore);
2150 HRESULT SetTabActive(
2151 [in] HWND hwndTab,
2152 [in] HWND hwndMDI,
2153 [in] DWORD dwReserved);
2155 HRESULT ThumbBarAddButtons(
2156 [in] HWND hwnd,
2157 [in] UINT cButtons,
2158 [in, size_is(cButtons)] LPTHUMBBUTTON pButton);
2160 HRESULT ThumbBarUpdateButtons(
2161 [in] HWND hwnd,
2162 [in] UINT cButtons,
2163 [in, size_is(cButtons)] LPTHUMBBUTTON pButton);
2165 HRESULT ThumbBarSetImageList(
2166 [in] HWND hwnd,
2167 [in] HIMAGELIST himl);
2169 HRESULT SetOverlayIcon(
2170 [in] HWND hwnd,
2171 [in] HICON hIcon,
2172 [in, unique, string] LPCWSTR pszDescription);
2174 HRESULT SetThumbnailTooltip(
2175 [in] HWND hwnd,
2176 [in, unique, string] LPCWSTR pszTip);
2178 HRESULT SetThumbnailClip(
2179 [in] HWND hwnd,
2180 [in] RECT *prcClip);
2184 uuid(c43dc798-95d1-4bea-9030-bb99e2983a1a),
2185 object
2187 interface ITaskbarList4 : ITaskbarList3
2189 typedef [v1_enum] enum STPFLAG {
2190 STPF_NONE = 0x0000,
2191 STPF_USEAPPTHUMBNAILALWAYS = 0x0001,
2192 STPF_USEAPPTHUMBNAILWHENACTIVE = 0x0002,
2193 STPF_USEAPPPEEKALWAYS = 0x0004,
2194 STPF_USEAPPPEEKWHENACTIVE = 0x0008
2195 } STPFLAG;
2197 cpp_quote("DEFINE_ENUM_FLAG_OPERATORS(STPFLAG)")
2199 HRESULT SetTabProperties(
2200 [in] HWND hwndTab,
2201 [in] STPFLAG stpFlags);
2204 /*****************************************************************************
2205 * IAutoCompleteDropDown interface
2208 object,
2209 uuid(3CD141F4-3C6A-11d2-BCAA-00C04FD929DB),
2210 pointer_default(unique)
2212 interface IAutoCompleteDropDown : IUnknown
2214 cpp_quote("#define ACDD_VISIBLE 0x0001")
2216 HRESULT GetDropDownStatus(
2217 [out] DWORD *pdwFlags,
2218 [out, string] LPWSTR *ppwszString);
2220 HRESULT ResetEnumerator();
2224 object,
2225 uuid(cb728b20-f786-11ce-92ad-00aa00a74cd0),
2226 pointer_default(unique)
2228 interface IProfferService : IUnknown
2230 HRESULT ProfferService(
2231 [in] REFGUID service,
2232 [in] IServiceProvider *pService,
2233 [out] DWORD *pCookie);
2235 HRESULT RevokeService([in] DWORD cookie);
2238 /*****************************************************************************
2239 * IExplorerBrowserEvents interface
2242 object,
2243 uuid(361BBDC7-E6EE-4E13-BE58-58E2240C810F)
2245 interface IExplorerBrowserEvents : IUnknown
2247 HRESULT OnNavigationPending(
2248 [in] PCIDLIST_ABSOLUTE pidlFolder);
2250 HRESULT OnViewCreated(
2251 [in] IShellView *psv);
2253 HRESULT OnNavigationComplete(
2254 [in] PCIDLIST_ABSOLUTE pidlFolder);
2256 HRESULT OnNavigationFailed(
2257 [in] PCIDLIST_ABSOLUTE pidlFolder);
2260 typedef GUID EXPLORERPANE;
2261 typedef EXPLORERPANE *REFEXPLORERPANE;
2263 cpp_quote("#define SID_ExplorerPaneVisibility IID_IExplorerPaneVisibility")
2265 /*****************************************************************************
2266 * IExplorerPaneVisibility interface
2269 object,
2270 uuid(E07010EC-BC17-44C0-97B0-46C7C95B9EDC)
2272 interface IExplorerPaneVisibility : IUnknown
2274 [v1_enum] enum _EXPLORERPANESTATE {
2275 EPS_DONTCARE = 0x0,
2276 EPS_DEFAULT_ON = 0x1,
2277 EPS_DEFAULT_OFF = 0x2,
2278 EPS_STATE_MASK = 0xffff,
2279 EPS_INITIALSTATE = 0x10000,
2280 EPS_FORCE = 0x20000
2282 typedef DWORD EXPLORERPANESTATE;
2284 HRESULT GetPaneState(
2285 [in] REFEXPLORERPANE ep,
2286 [out] EXPLORERPANESTATE *peps);
2289 typedef [v1_enum] enum tagEXPLORER_BROWSER_FILL_FLAGS {
2290 EBF_NONE = 0,
2291 EBF_SELECTFROMDATAOBJECT = 0x100,
2292 EBF_NODROPTARGET = 0x200
2293 } EXPLORER_BROWSER_FILL_FLAGS;
2295 typedef [v1_enum] enum tagEXPLORER_BROWSER_OPTIONS {
2296 EBO_NONE = 0x00,
2297 EBO_NAVIGATEONCE = 0x01,
2298 EBO_SHOWFRAMES = 0x02,
2299 EBO_ALWAYSNAVIGATE = 0x04,
2300 EBO_NOTRAVELLOG = 0x08,
2301 EBO_NOWRAPPERWINDOW = 0x10,
2302 EBO_HTMLSHAREPOINTVIEW = 0x20,
2303 EBO_NOBORDER = 0x40,
2304 EBO_NOPERSISTVIEWSTATE = 0x80,
2305 } EXPLORER_BROWSER_OPTIONS;
2307 cpp_quote("#define SID_SExplorerBrowserFrame IID_ICommDlgBrowser")
2309 /*****************************************************************************
2310 * IExplorerBrowser interface
2313 object,
2314 uuid(DFD3B6B5-C10C-4BE9-85F6-A66969F402F6),
2315 pointer_default(unique)
2317 interface IExplorerBrowser : IUnknown
2320 [local] HRESULT Initialize(
2321 [in] HWND hwndParent,
2322 [in] const RECT *prc,
2323 [in, unique] const FOLDERSETTINGS *pfs);
2325 HRESULT Destroy();
2327 [local] HRESULT SetRect(
2328 [in,out,unique] HDWP *phdwp,
2329 [in] RECT rcBrowser);
2331 HRESULT SetPropertyBag(
2332 [in, string] LPCWSTR pszPropertyBag);
2334 HRESULT SetEmptyText(
2335 [in, string] LPCWSTR pszEmptyText);
2337 HRESULT SetFolderSettings(
2338 [in] const FOLDERSETTINGS *pfs);
2340 HRESULT Advise(
2341 [in] IExplorerBrowserEvents *psbe,
2342 [out] DWORD *pdwCookie);
2344 HRESULT Unadvise(
2345 [in] DWORD dwCookie);
2347 HRESULT SetOptions(
2348 [in] EXPLORER_BROWSER_OPTIONS dwFlag);
2350 HRESULT GetOptions(
2351 [out] EXPLORER_BROWSER_OPTIONS *pdwFlag);
2353 HRESULT BrowseToIDList(
2354 [in] PCUIDLIST_RELATIVE pidl,
2355 [in] UINT uFlags);
2357 HRESULT BrowseToObject(
2358 [in] IUnknown *punk,
2359 [in] UINT uFlags);
2361 HRESULT FillFromObject(
2362 [in] IUnknown *punk,
2363 [in] EXPLORER_BROWSER_FILL_FLAGS dwFlags);
2365 HRESULT RemoveAll();
2367 HRESULT GetCurrentView(
2368 [in] REFIID riid,
2369 [out, iid_is(riid)] void **ppv);
2372 /*****************************************************************************
2373 * INameSpaceTreeControl interface
2376 object,
2377 uuid(028212A3-B627-47E9-8856-C14265554E4F)
2379 interface INameSpaceTreeControl : IUnknown
2381 [v1_enum] enum _NSTCSTYLE {
2382 NSTCS_HASEXPANDOS = 0x00000001,
2383 NSTCS_HASLINES = 0x00000002,
2384 NSTCS_SINGLECLICKEXPAND = 0x00000004,
2385 NSTCS_FULLROWSELECT = 0x00000008,
2386 NSTCS_SPRINGEXPAND = 0x00000010,
2387 NSTCS_HORIZONTALSCROLL = 0x00000020,
2388 NSTCS_ROOTHASEXPANDO = 0x00000040,
2389 NSTCS_SHOWSELECTIONALWAYS = 0x00000080,
2390 NSTCS_NOINFOTIP = 0x00000200,
2391 NSTCS_EVENHEIGHT = 0x00000400,
2392 NSTCS_NOREPLACEOPEN = 0x00000800,
2393 NSTCS_DISABLEDRAGDROP = 0x00001000,
2394 NSTCS_NOORDERSTREAM = 0x00002000,
2395 NSTCS_RICHTOOLTIP = 0x00004000,
2396 NSTCS_BORDER = 0x00008000,
2397 NSTCS_NOEDITLABELS = 0x00010000,
2398 NSTCS_TABSTOP = 0x00020000,
2399 NSTCS_FAVORITESMODE = 0x00080000,
2400 NSTCS_AUTOHSCROLL = 0x00100000,
2401 NSTCS_FADEINOUTEXPANDOS = 0x00200000,
2402 NSTCS_EMPTYTEXT = 0x00400000,
2403 NSTCS_CHECKBOXES = 0x00800000,
2404 NSTCS_PARTIALCHECKBOXES = 0x01000000,
2405 NSTCS_EXCLUSIONCHECKBOXES = 0x02000000,
2406 NSTCS_DIMMEDCHECKBOXES = 0x04000000,
2407 NSTCS_NOINDENTCHECKS = 0x08000000,
2408 NSTCS_ALLOWJUNCTIONS = 0x10000000,
2409 NSTCS_SHOWTABSBUTTON = 0x20000000,
2410 NSTCS_SHOWDELETEBUTTON = 0x40000000,
2411 NSTCS_SHOWREFRESHBUTTON = (int)0x80000000
2413 typedef DWORD NSTCSTYLE;
2415 [v1_enum] enum _NSTCROOTSTYLE {
2416 NSTCRS_VISIBLE = 0x0000,
2417 NSTCRS_HIDDEN = 0x0001,
2418 NSTCRS_EXPANDED = 0x0002
2420 typedef DWORD NSTCROOTSTYLE;
2422 [v1_enum] enum _NSTCITEMSTATE {
2423 NSTCIS_NONE = 0x0000,
2424 NSTCIS_SELECTED = 0x0001,
2425 NSTCIS_EXPANDED = 0x0002,
2426 NSTCIS_BOLD = 0x0004,
2427 NSTCIS_DISABLED = 0x0008,
2428 NSTCIS_SELECTEDNOEXPAND = 0x0010
2430 typedef DWORD NSTCITEMSTATE;
2432 typedef [v1_enum] enum NSTCGNI {
2433 NSTCGNI_NEXT = 0,
2434 NSTCGNI_NEXTVISIBLE = 1,
2435 NSTCGNI_PREV = 2,
2436 NSTCGNI_PREVVISIBLE = 3,
2437 NSTCGNI_PARENT = 4,
2438 NSTCGNI_CHILD = 5,
2439 NSTCGNI_FIRSTVISIBLE = 6,
2440 NSTCGNI_LASTVISIBLE = 7
2441 } NSTCGNI;
2443 HRESULT Initialize(
2444 [in] HWND hwndParent,
2445 [in, unique] RECT *prc,
2446 [in] NSTCSTYLE nstcsFlags);
2448 HRESULT TreeAdvise(
2449 [in] IUnknown *punk,
2450 [out] DWORD *pdwCookie);
2452 HRESULT TreeUnadvise(
2453 [in] DWORD dwCookie);
2455 HRESULT AppendRoot(
2456 [in] IShellItem *psiRoot,
2457 [in] SHCONTF grfEnumFlags,
2458 [in] NSTCROOTSTYLE grfRootStyle,
2459 [in, unique] IShellItemFilter *pif);
2461 HRESULT InsertRoot(
2462 [in] int iIndex,
2463 [in] IShellItem *psiRoot,
2464 [in] SHCONTF grfEnumFlags,
2465 [in] NSTCROOTSTYLE grfRootStyle,
2466 [in, unique] IShellItemFilter *pif);
2468 HRESULT RemoveRoot(
2469 [in] IShellItem *psiRoot);
2471 HRESULT RemoveAllRoots();
2473 HRESULT GetRootItems(
2474 [out] IShellItemArray **ppsiaRootItems);
2476 HRESULT SetItemState(
2477 [in] IShellItem *psi,
2478 [in] NSTCITEMSTATE nstcisMask,
2479 [in] NSTCITEMSTATE nstcisFlags);
2481 HRESULT GetItemState(
2482 [in] IShellItem *psi,
2483 [in] NSTCITEMSTATE nstcismask,
2484 [out] NSTCITEMSTATE *pnstcisFlags);
2486 HRESULT GetSelectedItems(
2487 [out] IShellItemArray **psiaItems);
2489 HRESULT GetItemCustomState(
2490 [in] IShellItem *psi,
2491 [out] int *piStateNumber);
2493 HRESULT SetItemCustomState(
2494 [in] IShellItem *psi,
2495 [in] int iStateNumber);
2497 HRESULT EnsureItemVisible(
2498 [in] IShellItem *psi);
2500 HRESULT SetTheme(
2501 [in, string] LPCWSTR pszTheme);
2503 HRESULT GetNextItem(
2504 [in, unique] IShellItem *psi,
2505 [in] NSTCGNI nstcgi,
2506 [out] IShellItem **ppsiNext);
2508 HRESULT HitTest(
2509 [in] POINT *ppt,
2510 [out] IShellItem **ppsiOut);
2512 HRESULT GetItemRect(
2513 [in] IShellItem *psi,
2514 [out] RECT *prect);
2516 HRESULT CollapseAll();
2519 /*****************************************************************************
2520 * INameSpaceTreeControl2 interface
2523 object,
2524 uuid(7CC7AED8-290E-49BC-8945-C1401CC9306C)
2526 interface INameSpaceTreeControl2 : INameSpaceTreeControl
2528 typedef [v1_enum] enum NSTCSTYLE2 {
2529 NSTCS2_DEFAULT = 0x00,
2530 NSTCS2_INTERRUPTNOTIFICATIONS = 0x01,
2531 NSTCS2_SHOWNULLSPACEMENU = 0x02,
2532 NSTCS2_DISPLAYPADDING = 0x04,
2533 NSTCS2_DISPLAYPINNEDONLY = 0x08,
2534 NTSCS2_NOSINGLETONAUTOEXPAND = 0x10, /* The apparent typo here is */
2535 NTSCS2_NEVERINSERTNONENUMERATED = 0x20 /* present also in the Win SDK */
2536 } NSTCSTYLE2;
2537 cpp_quote("DEFINE_ENUM_FLAG_OPERATORS(NSTCSTYLE2)")
2539 HRESULT SetControlStyle(
2540 [in] NSTCSTYLE nstcsMask,
2541 [in] NSTCSTYLE nstcsStyle);
2543 HRESULT GetControlStyle(
2544 [in] NSTCSTYLE nstcsMask,
2545 [out] NSTCSTYLE *pnstcsStyle);
2547 HRESULT SetControlStyle2(
2548 [in] NSTCSTYLE2 nstcsMask,
2549 [in] NSTCSTYLE2 nstcsStyle);
2551 HRESULT GetControlStyle2(
2552 [in] NSTCSTYLE2 nstcsMask,
2553 [out] NSTCSTYLE2 *pnstcsStyle);
2556 /*****************************************************************************
2557 * INameSpaceTreeControlEvents interface
2561 object,
2562 uuid(93D77985-B3D8-4484-8318-672CDDA002CE),
2563 local
2565 interface INameSpaceTreeControlEvents : IUnknown
2567 [v1_enum] enum _NSTCEHITTEST {
2568 NSTCEHT_NOWHERE = 0x0001,
2569 NSTCEHT_ONITEMICON = 0x0002,
2570 NSTCEHT_ONITEMLABEL = 0x0004,
2571 NSTCEHT_ONITEMIDENT = 0x0008,
2572 NSTCEHT_ONITEMBUTTON = 0x0010,
2573 NSTCEHT_ONITEMRIGHT = 0x0020,
2574 NSTCEHT_ONITEMSTATEICON = 0x0040,
2575 NSTCEHT_ONITEM = 0x0046,
2576 NSTCEHT_ONITEMTABBUTTON = 0x1000
2578 typedef DWORD NSTCEHITTEST;
2580 [v1_enum] enum _NSTCECLICKTYPE {
2581 NSTCECT_LBUTTON = 0x1,
2582 NSTCECT_MBUTTON = 0x2,
2583 NSTCECT_RBUTTON = 0x3,
2584 NSTCECT_BUTTON = 0x3,
2585 NSTCECT_DBLCLICK = 0x4
2587 typedef DWORD NSTCECLICKTYPE;
2589 HRESULT OnItemClick(
2590 [in] IShellItem *psi,
2591 [in] NSTCEHITTEST nstceHitTest,
2592 [in] NSTCECLICKTYPE nstceClickType);
2594 HRESULT OnPropertyItemCommit(
2595 [in] IShellItem *psi);
2597 HRESULT OnItemStateChanging(
2598 [in] IShellItem *psi,
2599 [in] NSTCITEMSTATE nstcisMask,
2600 [in] NSTCITEMSTATE nstcisState);
2602 HRESULT OnItemStateChanged(
2603 [in] IShellItem *psi,
2604 [in] NSTCITEMSTATE nstcisMask,
2605 [in] NSTCITEMSTATE nstcisState);
2607 HRESULT OnSelectionChanged(
2608 [in] IShellItemArray *psiaSelection);
2610 HRESULT OnKeyboardInput(
2611 [in] UINT uMsg,
2612 [in] WPARAM wParam,
2613 [in] LPARAM lParam);
2615 HRESULT OnBeforeExpand(
2616 [in] IShellItem *psi);
2618 HRESULT OnAfterExpand(
2619 [in] IShellItem *psi);
2621 HRESULT OnBeginLabelEdit(
2622 [in] IShellItem *psi);
2624 HRESULT OnEndLabelEdit(
2625 [in] IShellItem *psi);
2627 HRESULT OnGetToolTip(
2628 [in] IShellItem *psi,
2629 [out, string, size_is(cchTip)] LPWSTR pszTip,
2630 [in] int cchTip);
2632 HRESULT OnBeforeItemDelete(
2633 [in] IShellItem *psi);
2635 HRESULT OnItemAdded(
2636 [in] IShellItem *psi,
2637 [in] BOOL fIsRoot);
2639 HRESULT OnItemDeleted(
2640 [in] IShellItem *psi,
2641 [in] BOOL fIsRoot);
2643 HRESULT OnBeforeContextMenu(
2644 [in, unique] IShellItem *psi,
2645 [in] REFIID riid,
2646 [out, iid_is(riid)] void **ppv);
2648 HRESULT OnAfterContextMenu(
2649 [in] IShellItem *psi,
2650 [in] IContextMenu *pcmIn,
2651 [in] REFIID riid,
2652 [out, iid_is(riid)] void **ppv);
2654 HRESULT OnBeforeStateImageChange(
2655 [in] IShellItem *psi);
2657 HRESULT OnGetDefaultIconIndex(
2658 [in] IShellItem *psi,
2659 [out] int *piDefaultIcon,
2660 [out] int *piOpenIcon);
2663 /*****************************************************************************
2664 * INameSpaceTreeControlCustomDraw interface
2667 object,
2668 uuid(2D3BA758-33EE-42D5-BB7B-5F3431D86C78),
2669 local
2672 interface INameSpaceTreeControlCustomDraw : IUnknown
2674 typedef struct NSTCCUSTOMDRAW
2676 IShellItem *psi;
2677 UINT uItemState;
2678 NSTCITEMSTATE nstcis;
2679 LPCWSTR pszText;
2680 int iImage;
2681 HIMAGELIST himl;
2682 int iLevel;
2683 int iIndent;
2684 } NSTCCUSTOMDRAW;
2686 HRESULT PrePaint(
2687 [in] HDC hdc,
2688 [in] RECT *prc,
2689 [out] LRESULT *plres);
2691 HRESULT PostPaint(
2692 [in] HDC hdc,
2693 [in] RECT *prc);
2695 HRESULT ItemPrePaint(
2696 [in] HDC hdc,
2697 [in] RECT *prc,
2698 [in] NSTCCUSTOMDRAW *pnstccdItem,
2699 [in, out] COLORREF *pclrText,
2700 [in, out] COLORREF *pclrTextBk,
2701 [out] LRESULT *plres);
2703 HRESULT ItemPostPaint(
2704 [in] HDC hdc,
2705 [in] RECT *prc,
2706 [in] NSTCCUSTOMDRAW *pnstccdItem);
2709 /*****************************************************************************
2710 * INameSpaceTreeControlDropHandler interface
2713 object,
2714 uuid(F9C665D6-C2F2-4C19-BF33-8322D7352F51),
2715 local
2717 interface INameSpaceTreeControlDropHandler : IUnknown
2719 HRESULT OnDragEnter(
2720 [in, unique] IShellItem *psiOver,
2721 [in] IShellItemArray *psiaData,
2722 [in] BOOL fOutsideSource,
2723 [in] DWORD grfKeyState,
2724 [in, out] DWORD *pdwEffect);
2726 HRESULT OnDragOver(
2727 [in, unique] IShellItem *psiOver,
2728 [in] IShellItemArray *psiaData,
2729 [in] DWORD grfKeyState,
2730 [in, out] DWORD *pdwEffect);
2732 HRESULT OnDragPosition(
2733 [in, unique] IShellItem *psiOver,
2734 [in] IShellItemArray *psiaData,
2735 [in] int iNewPosition,
2736 [in] int iOldPosition);
2738 HRESULT OnDrop(
2739 [in, unique] IShellItem *psiOver,
2740 [in] IShellItemArray *psiaData,
2741 [in] int iPosition,
2742 [in] DWORD grfKeyState,
2743 [in, out] DWORD *pdwEffect);
2745 HRESULT OnDropPosition(
2746 [in, unique] IShellItem *psiOver,
2747 [in] IShellItemArray *psiaData,
2748 [in] int iNewPosition,
2749 [in] int iOldPosition);
2751 HRESULT OnDragLeave(
2752 [in, unique] IShellItem *psiOver);
2754 cpp_quote("#define NSTCDHPOS_ONTOP -1")
2756 interface IFileDialog;
2758 typedef [v1_enum] enum FDE_OVERWRITE_RESPONSE
2760 FDEOR_DEFAULT = 0,
2761 FDEOR_ACCEPT = 1,
2762 FDEOR_REFUSE = 2
2763 } FDE_OVERWRITE_RESPONSE;
2765 typedef [v1_enum] enum FDE_SHAREVIOLATION_RESPONSE
2767 FDESVR_DEFAULT = 0,
2768 FDESVR_ACCEPT = 1,
2769 FDESVR_REFUSE = 2
2770 } FDE_SHAREVIOLATION_RESPONSE;
2772 /*****************************************************************************
2773 * IFileDialogEvents interface
2776 object,
2777 uuid(973510DB-7D7F-452B-8975-74A85828D354),
2778 pointer_default(unique)
2780 interface IFileDialogEvents : IUnknown
2782 HRESULT OnFileOk(
2783 [in] IFileDialog *pfd);
2785 HRESULT OnFolderChanging(
2786 [in] IFileDialog *pfd,
2787 [in] IShellItem *psiFolder);
2789 HRESULT OnFolderChange(
2790 [in] IFileDialog *pfd);
2792 HRESULT OnSelectionChange(
2793 [in] IFileDialog *pfd);
2795 HRESULT OnShareViolation(
2796 [in] IFileDialog *pfd,
2797 [in] IShellItem *psi,
2798 [out] FDE_SHAREVIOLATION_RESPONSE *pResponse);
2800 HRESULT OnTypeChange(
2801 [in] IFileDialog *pfd);
2803 HRESULT OnOverwrite(
2804 [in] IFileDialog *pfd,
2805 [in] IShellItem *psi,
2806 [out] FDE_OVERWRITE_RESPONSE *pResponse);
2809 /*****************************************************************************
2810 * IModalWindow interface
2813 object,
2814 uuid(B4DB1657-70D7-485E-8E3E-6FCB5A5C1802),
2815 pointer_default(unique)
2817 interface IModalWindow : IUnknown
2819 [local]
2820 HRESULT Show(
2821 [in, unique, annotation("__in_opt")] HWND hwndOwner);
2823 [call_as(Show)]
2824 HRESULT RemoteShow(
2825 [in, unique] HWND hwndOwner);
2828 typedef [v1_enum] enum FDAP
2830 FDAP_BOTTOM = 0,
2831 FDAP_TOP = 1
2832 } FDAP;
2834 /*****************************************************************************
2835 * IFileDialog interface
2838 object,
2839 uuid(42F85136-DB7E-439C-85F1-E4075D135FC8),
2840 pointer_default(unique)
2842 interface IFileDialog : IModalWindow
2844 [v1_enum] enum _FILEOPENDIALOGOPTIONS
2846 FOS_OVERWRITEPROMPT = 0x00000002,
2847 FOS_STRICTFILETYPES = 0x00000004,
2848 FOS_NOCHANGEDIR = 0x00000008,
2849 FOS_PICKFOLDERS = 0x00000020,
2850 FOS_FORCEFILESYSTEM = 0x00000040,
2851 FOS_ALLNONSTORAGEITEMS = 0x00000080,
2852 FOS_NOVALIDATE = 0x00000100,
2853 FOS_ALLOWMULTISELECT = 0x00000200,
2854 FOS_PATHMUSTEXIST = 0x00000800,
2855 FOS_FILEMUSTEXIST = 0x00001000,
2856 FOS_CREATEPROMPT = 0x00002000,
2857 FOS_SHAREAWARE = 0x00004000,
2858 FOS_NOREADONLYRETURN = 0x00008000,
2859 FOS_NOTESTFILECREATE = 0x00010000,
2860 FOS_HIDEMRUPLACES = 0x00020000,
2861 FOS_HIDEPINNEDPLACES = 0x00040000,
2862 FOS_NODEREFERENCELINKS = 0x00100000,
2863 FOS_DONTADDTORECENT = 0x02000000,
2864 FOS_FORCESHOWHIDDEN = 0x10000000,
2865 FOS_DEFAULTNOMINIMODE = 0x20000000,
2866 FOS_FORCEPREVIEWPANEON = 0x40000000,
2867 FOS_SUPPORTSTREAMABLEITEMS = 0x80000000
2869 typedef DWORD FILEOPENDIALOGOPTIONS;
2871 HRESULT SetFileTypes(
2872 [in] UINT cFileTypes,
2873 [in, size_is(cFileTypes)] const COMDLG_FILTERSPEC *rgFilterSpec);
2875 HRESULT SetFileTypeIndex(
2876 [in] UINT iFileType);
2878 HRESULT GetFileTypeIndex(
2879 [out] UINT *piFileType);
2881 HRESULT Advise(
2882 [in] IFileDialogEvents *pfde,
2883 [out] DWORD *pdwCookie);
2885 HRESULT Unadvise(
2886 [in] DWORD dwCookie);
2888 HRESULT SetOptions(
2889 [in] FILEOPENDIALOGOPTIONS fos);
2891 HRESULT GetOptions(
2892 [out] FILEOPENDIALOGOPTIONS *pfos);
2894 HRESULT SetDefaultFolder(
2895 [in] IShellItem *psi);
2897 HRESULT SetFolder(
2898 [in] IShellItem *psi);
2900 HRESULT GetFolder(
2901 [out] IShellItem **ppsi);
2903 HRESULT GetCurrentSelection(
2904 [out] IShellItem **ppsi);
2906 HRESULT SetFileName(
2907 [in, string] LPCWSTR pszName);
2909 HRESULT GetFileName(
2910 [out, string] LPWSTR *pszName);
2912 HRESULT SetTitle(
2913 [in, string] LPCWSTR pszTitle);
2915 HRESULT SetOkButtonLabel(
2916 [in, string] LPCWSTR pszText);
2918 HRESULT SetFileNameLabel(
2919 [in, string] LPCWSTR pszLabel);
2921 HRESULT GetResult(
2922 [out] IShellItem **ppsi);
2924 HRESULT AddPlace(
2925 [in] IShellItem *psi,
2926 [in] FDAP fdap);
2928 HRESULT SetDefaultExtension(
2929 [in, string] LPCWSTR pszDefaultExtension);
2931 HRESULT Close(
2932 [in] HRESULT hr);
2934 HRESULT SetClientGuid(
2935 [in] REFGUID guid);
2937 HRESULT ClearClientData();
2939 HRESULT SetFilter(
2940 [in] IShellItemFilter *pFilter);
2943 /*****************************************************************************
2944 * IFileDialog2 interface
2947 object,
2948 uuid(61744FC7-85B5-4791-A9B0-272276309B13),
2949 pointer_default(unique)
2951 interface IFileDialog2 : IFileDialog
2953 HRESULT SetCancelButtonLabel(
2954 [in] LPCWSTR pszLabel);
2956 HRESULT SetNavigationRoot(
2957 [in] IShellItem *psi);
2960 /*****************************************************************************
2961 * IFileOperationProgressSink interface
2964 object,
2965 uuid(04B0F1A7-9490-44BC-96E1-4296A31252E2),
2966 pointer_default(unique)
2968 interface IFileOperationProgressSink : IUnknown
2970 HRESULT StartOperations();
2972 HRESULT FinishOperations(
2973 [in] HRESULT hrResult);
2975 HRESULT PreRenameItem(
2976 [in] DWORD dwFlags,
2977 [in] IShellItem *psiItem,
2978 [in, unique, string] LPCWSTR pszNewName);
2980 HRESULT PostRenameItem(
2981 [in] DWORD dwFlags,
2982 [in] IShellItem *psiItem,
2983 [in, string] LPCWSTR pszNewName,
2984 [in] HRESULT hrRename,
2985 [in] IShellItem *psiNewlyCreated);
2987 HRESULT PreMoveItem(
2988 [in] DWORD dwFlags,
2989 [in] IShellItem *psiItem,
2990 [in] IShellItem *psiDestinationFolder,
2991 [in, unique, string] LPCWSTR pszNewName);
2993 HRESULT PostMoveItem(
2994 [in] DWORD dwFlags,
2995 [in] IShellItem *psiItem,
2996 [in] IShellItem *psiDestinationFolder,
2997 [in, unique, string] LPCWSTR pszNewName,
2998 [in] HRESULT hrMove,
2999 [in] IShellItem *psiNewlyCreated);
3001 HRESULT PreCopyItem(
3002 [in] DWORD dwFlags,
3003 [in] IShellItem *psiItem,
3004 [in] IShellItem *psiDestinationFolder,
3005 [in, unique, string] LPCWSTR pszNewName);
3007 HRESULT PostCopyItem(
3008 [in] DWORD dwFlags,
3009 [in] IShellItem *psiItem,
3010 [in] IShellItem *psiDestinationFolder,
3011 [in, unique, string] LPCWSTR pszNewName,
3012 [in] HRESULT hrCopy,
3013 [in] IShellItem *psiNewlyCreated);
3015 HRESULT PreDeleteItem(
3016 [in] DWORD dwFlags,
3017 [in] IShellItem *psiItem);
3019 HRESULT PostDeleteItem(
3020 [in] DWORD dwFlags,
3021 [in] IShellItem *psiItem,
3022 [in] HRESULT hrDelete,
3023 [in] IShellItem *psiNewlyCreated);
3025 HRESULT PreNewItem(
3026 [in] DWORD dwFlags,
3027 [in] IShellItem *psiDestinationFolder,
3028 [in, unique, string] LPCWSTR pszNewName);
3030 HRESULT PostNewItem(
3031 [in] DWORD dwFlags,
3032 [in] IShellItem *psiDestinationFolder,
3033 [in, unique, string] LPCWSTR pszNewName,
3034 [in, unique, string] LPCWSTR pszTemplateName,
3035 [in] DWORD dwFileAttributes,
3036 [in] HRESULT hrNew,
3037 [in] IShellItem *psiNewItem);
3039 HRESULT UpdateProgress(
3040 [in] UINT iWorkTotal,
3041 [in] UINT iWorkSoFar);
3043 HRESULT ResetTimer();
3045 HRESULT PauseTimer();
3047 HRESULT ResumeTimer();
3050 /*****************************************************************************
3051 * IFileSaveDialog interface
3054 object,
3055 uuid(84BCCD23-5FDE-4CDB-AEA4-AF64B83D78AB),
3056 pointer_default(unique)
3058 interface IFileSaveDialog : IFileDialog
3060 HRESULT SetSaveAsItem(
3061 [in] IShellItem *psi);
3063 HRESULT SetProperties(
3064 [in] IPropertyStore *pStore);
3066 HRESULT SetCollectedProperties(
3067 [in] IPropertyDescriptionList *pList,
3068 [in] BOOL fAppendDefault);
3070 HRESULT GetProperties(
3071 [in] IPropertyStore **ppStore);
3073 HRESULT ApplyProperties(
3074 [in] IShellItem *psi,
3075 [in] IPropertyStore *pStore,
3076 [in, unique] HWND hwnd,
3077 [in, unique] IFileOperationProgressSink *pSink);
3081 /*****************************************************************************
3082 * IFileOpenDialog interface
3085 object,
3086 uuid(D57C7288-D4AD-4768-BE02-9D969532D960),
3087 pointer_default(unique)
3089 interface IFileOpenDialog : IFileDialog
3091 HRESULT GetResults(
3092 [out] IShellItemArray **ppenum);
3094 HRESULT GetSelectedItems(
3095 [out] IShellItemArray **ppsai);
3098 typedef [v1_enum] enum CDCONTROLSTATEF
3100 CDCS_INACTIVE = 0x0,
3101 CDCS_ENABLED = 0x1,
3102 CDCS_VISIBLE = 0x2,
3103 CDCS_ENABLEDVISIBLE = 0x3
3104 } CDCONTROLSTATEF;
3105 cpp_quote("DEFINE_ENUM_FLAG_OPERATORS(CDCONTROLSTATEF)")
3106 /*****************************************************************************
3107 * IFileDialogCustomize interface
3110 object,
3111 uuid(E6FDD21A-163F-4975-9C8C-A69F1BA37034),
3112 pointer_default(unique)
3114 interface IFileDialogCustomize : IUnknown
3116 HRESULT EnableOpenDropDown(
3117 [in] DWORD dwIDCtl);
3119 HRESULT AddMenu(
3120 [in] DWORD dwIDCtl,
3121 [in, string] LPCWSTR pszLabel);
3123 HRESULT AddPushButton(
3124 [in] DWORD dwIDCtl,
3125 [in, string] LPCWSTR pszLabel);
3127 HRESULT AddComboBox(
3128 [in] DWORD dwIDCtl);
3130 HRESULT AddRadioButtonList(
3131 [in] DWORD dwIDCtl);
3133 HRESULT AddCheckButton(
3134 [in] DWORD dwIDCtl,
3135 [in, string] LPCWSTR pszLabel,
3136 [in] BOOL bChecked);
3138 HRESULT AddEditBox(
3139 [in] DWORD dwIDCtl,
3140 [in, string] LPCWSTR pszText);
3142 HRESULT AddSeparator(
3143 [in] DWORD dwIDCtl);
3145 HRESULT AddText(
3146 [in] DWORD dwIDCtl,
3147 [in, string] LPCWSTR pszText);
3149 HRESULT SetControlLabel(
3150 [in] DWORD dwIDCtl,
3151 [in, string] LPCWSTR pszLabel);
3153 HRESULT GetControlState(
3154 [in] DWORD dwIDCtl,
3155 [out] CDCONTROLSTATEF *pdwState);
3157 HRESULT SetControlState(
3158 [in] DWORD dwIDCtl,
3159 [in] CDCONTROLSTATEF dwState);
3161 HRESULT GetEditBoxText(
3162 [in] DWORD dwIDCtl,
3163 [out, string] WCHAR **ppszText);
3165 HRESULT SetEditBoxText(
3166 [in] DWORD dwIDCtl,
3167 [in, string] LPCWSTR pszText);
3169 HRESULT GetCheckButtonState(
3170 [in] DWORD dwIDCtl,
3171 [out] BOOL *pbChecked);
3173 HRESULT SetCheckButtonState(
3174 [in] DWORD dwIDCtl,
3175 [in] BOOL bChecked);
3177 HRESULT AddControlItem(
3178 [in] DWORD dwIDCtl,
3179 [in] DWORD dwIDItem,
3180 [in] LPCWSTR pszLabel);
3182 HRESULT RemoveControlItem(
3183 [in] DWORD dwIDCtl,
3184 [in] DWORD dwIDItem);
3186 HRESULT RemoveAllControlItems(
3187 [in] DWORD dwIDCtl);
3189 HRESULT GetControlItemState(
3190 [in] DWORD dwIDCtl,
3191 [in] DWORD dwIDItem,
3192 [out] CDCONTROLSTATEF *pdwState);
3194 HRESULT SetControlItemState(
3195 [in] DWORD dwIDCtl,
3196 [in] DWORD dwIDItem,
3197 [in] CDCONTROLSTATEF dwState);
3199 HRESULT GetSelectedControlItem(
3200 [in] DWORD dwIDCtl,
3201 [out] DWORD *pdwIDItem);
3203 HRESULT SetSelectedControlItem(
3204 [in] DWORD dwIDCtl,
3205 [in] DWORD dwIDItem);
3207 HRESULT StartVisualGroup(
3208 [in] DWORD dwIDCtl,
3209 [in, string] LPCWSTR pszLabel);
3211 HRESULT EndVisualGroup();
3213 HRESULT MakeProminent(
3214 [in] DWORD dwIDCtl);
3216 HRESULT SetControlItemText(
3217 [in] DWORD dwIDCtl,
3218 [in] DWORD dwIDItem,
3219 [in, string] LPCWSTR pszLabel);
3222 /*****************************************************************************
3223 * IFileDialogControlEvents interface
3226 object,
3227 uuid(36116642-D713-4B97-9B83-7484A9D00433),
3228 pointer_default(unique)
3230 interface IFileDialogControlEvents : IUnknown
3232 HRESULT OnItemSelected(
3233 [in] IFileDialogCustomize *pfdc,
3234 [in] DWORD dwIDCtl,
3235 [in] DWORD dwIDItem);
3237 HRESULT OnButtonClicked(
3238 [in] IFileDialogCustomize *pfdc,
3239 [in] DWORD dwIDCtl);
3241 HRESULT OnCheckButtonToggled(
3242 [in] IFileDialogCustomize *pfdc,
3243 [in] DWORD dwIDCtl,
3244 [in] BOOL bChecked);
3246 HRESULT OnControlActivating(
3247 [in] IFileDialogCustomize *pfdc,
3248 [in] DWORD dwIDCtl);
3251 typedef [v1_enum] enum tagKF_CATEGORY
3253 KF_CATEGORY_VIRTUAL = 0x00000001,
3254 KF_CATEGORY_FIXED = 0x00000002,
3255 KF_CATEGORY_COMMON = 0x00000003,
3256 KF_CATEGORY_PERUSER = 0x00000004
3257 } KF_CATEGORY;
3259 typedef [v1_enum] enum tagKF_REDIRECTION_CAPABILITIES
3261 KF_REDIRECTION_CAPABILITIES_ALLOW_ALL = 0x000000ff,
3262 KF_REDIRECTION_CAPABILITIES_REDIRECTABLE = 0x00000001,
3263 KF_REDIRECTION_CAPABILITIES_DENY_ALL = 0x000fff00,
3264 KF_REDIRECTION_CAPABILITIES_DENY_POLICY_REDIRECTED = 0x00000100,
3265 KF_REDIRECTION_CAPABILITIES_DENY_POLICY = 0x00000200,
3266 KF_REDIRECTION_CAPABILITIES_DENY_PERMISSIONS = 0x00000400
3267 } KF_REDIRECTION_CAPABILITIES;
3269 typedef [v1_enum] enum tagKF_DEFINITION_FLAGS
3271 KFDF_LOCAL_REDIRECT_ONLY = 0x00000002,
3272 KFDF_ROAMABLE = 0x00000004,
3273 KFDF_PRECREATE = 0x00000008,
3274 KFDF_STREAM = 0x00000010,
3275 KFDF_PUBLISHEXPANDEDPATH = 0x00000020,
3276 KFDF_NO_REDIRECT_UI = 0x00000040
3277 } KF_DEFINITION_FLAGS;
3279 typedef struct tagKNOWNFOLDER_DEFINITION
3281 KF_CATEGORY category;
3282 LPWSTR pszName;
3283 LPWSTR pszDescription;
3284 KNOWNFOLDERID fidParent;
3285 LPWSTR pszRelativePath;
3286 LPWSTR pszParsingName;
3287 LPWSTR pszTooltip;
3288 LPWSTR pszLocalizedName;
3289 LPWSTR pszIcon;
3290 LPWSTR pszSecurity;
3291 DWORD dwAttributes;
3292 KF_DEFINITION_FLAGS kfdFlags;
3293 FOLDERTYPEID ftidType;
3294 } KNOWNFOLDER_DEFINITION;
3297 object,
3298 uuid(3aa7af7e-9b36-420C-a8e3-f77d4674a488),
3299 pointer_default(ref)
3301 interface IKnownFolder : IUnknown
3303 HRESULT GetId(
3304 [out] KNOWNFOLDERID *pkfid);
3306 HRESULT GetCategory(
3307 [out] KF_CATEGORY *pCategory);
3309 HRESULT GetShellItem(
3310 [in] DWORD dwFlags,
3311 [in] REFIID riid,
3312 [out, iid_is(riid)] void **ppv);
3314 HRESULT GetPath(
3315 [in] DWORD dwFlags,
3316 [out, string] LPWSTR *ppszPath);
3318 HRESULT SetPath(
3319 [in] DWORD dwFlags,
3320 [in, string] LPCWSTR pszPath);
3322 HRESULT GetIDList(
3323 [in] DWORD dwFlags,
3324 [out] PIDLIST_ABSOLUTE *ppidl);
3326 HRESULT GetFolderType(
3327 [out] FOLDERTYPEID *pftid);
3329 HRESULT GetRedirectionCapabilities(
3330 [out] KF_REDIRECTION_CAPABILITIES *pCapabilities);
3332 HRESULT GetFolderDefinition(
3333 [out] KNOWNFOLDER_DEFINITION *pKFD);
3336 typedef [v1_enum] enum tagKF_REDIRECT_FLAGS
3338 KF_REDIRECT_USER_EXCLUSIVE = 0x00000001,
3339 KF_REDIRECT_COPY_SOURCE_DACL = 0x00000002,
3340 KF_REDIRECT_OWNER_USER = 0x00000004,
3341 KF_REDIRECT_SET_OWNER_EXPLICIT = 0x00000008,
3342 KF_REDIRECT_CHECK_ONLY = 0x00000010,
3343 KF_REDIRECT_WITH_UI = 0x00000020,
3344 KF_REDIRECT_UNPIN = 0x00000040,
3345 KF_REDIRECT_PIN = 0x00000080,
3346 KF_REDIRECT_COPY_CONTENTS = 0x00000200,
3347 KF_REDIRECT_DEL_SOURCE_CONTENTS = 0x00000400,
3348 KF_REDIRECT_EXCLUDE_ALL_KNOWN_SUBFOLDERS = 0x00000800
3349 } KF_REDIRECT_FLAGS;
3352 object,
3353 uuid(8BE2D872-86AA-4d47-B776-32CCA40C7018),
3354 pointer_default(ref)
3356 interface IKnownFolderManager : IUnknown
3358 typedef [v1_enum] enum tagFFFP_MODE
3360 FFFP_EXACTMATCH,
3361 FFFP_NEARESTPARENTMATCH
3362 } FFFP_MODE;
3364 HRESULT FolderIdFromCsidl(
3365 [in] int nCsidl,
3366 [out] KNOWNFOLDERID *pfid);
3368 HRESULT FolderIdToCsidl(
3369 [in] REFKNOWNFOLDERID rfid,
3370 [out] int *pnCsidl);
3372 HRESULT GetFolderIds(
3373 [out, size_is(, *pCount)] KNOWNFOLDERID **ppKFId,
3374 [in, out] UINT *pCount);
3376 HRESULT GetFolder(
3377 [in] REFKNOWNFOLDERID rfid,
3378 [out] IKnownFolder **ppkf);
3380 HRESULT GetFolderByName(
3381 [in, string] LPCWSTR pszCanonicalName,
3382 [out] IKnownFolder **ppkf);
3384 HRESULT RegisterFolder(
3385 [in] REFKNOWNFOLDERID rfid,
3386 [in] KNOWNFOLDER_DEFINITION const *pKFD);
3388 HRESULT UnregisterFolder(
3389 [in] REFKNOWNFOLDERID rfid);
3391 HRESULT FindFolderFromPath(
3392 [in, string] LPCWSTR pszPath,
3393 [in] FFFP_MODE mode,
3394 [out] IKnownFolder **ppkf);
3396 HRESULT FindFolderFromIDList(
3397 [in] PCIDLIST_ABSOLUTE pidl,
3398 [out] IKnownFolder **ppkf);
3400 HRESULT Redirect(
3401 [in] REFKNOWNFOLDERID rfid,
3402 [in, unique] HWND hwnd,
3403 [in] KF_REDIRECT_FLAGS flags,
3404 [in, unique, string] LPCWSTR pszTargetPath,
3405 [in] UINT cFolders,
3406 [in, size_is(cFolders), unique] KNOWNFOLDERID const *pExclusion,
3407 [out, string] LPWSTR *ppszError);
3410 /* function for releasing structure returned from IKnownFolder::GetFolderDefinition */
3411 cpp_quote("static inline void FreeKnownFolderDefinitionFields(KNOWNFOLDER_DEFINITION *pKFD)")
3412 cpp_quote("{")
3413 cpp_quote(" CoTaskMemFree(pKFD->pszName);")
3414 cpp_quote(" CoTaskMemFree(pKFD->pszDescription);")
3415 cpp_quote(" CoTaskMemFree(pKFD->pszRelativePath);")
3416 cpp_quote(" CoTaskMemFree(pKFD->pszParsingName);")
3417 cpp_quote(" CoTaskMemFree(pKFD->pszTooltip);")
3418 cpp_quote(" CoTaskMemFree(pKFD->pszLocalizedName);")
3419 cpp_quote(" CoTaskMemFree(pKFD->pszIcon);")
3420 cpp_quote(" CoTaskMemFree(pKFD->pszSecurity);")
3421 cpp_quote("}")
3423 typedef [v1_enum] enum ASSOCIATIONLEVEL {
3424 AL_MACHINE,
3425 AL_EFFECTIVE,
3426 AL_USER
3427 } ASSOCIATIONLEVEL;
3429 typedef [v1_enum] enum ASSOCIATIONTYPE {
3430 AT_FILEEXTENSION,
3431 AT_URLPROTOCOL,
3432 AT_STARTMENUCLIENT,
3433 AT_MIMETYPE
3434 } ASSOCIATIONTYPE;
3437 object,
3438 uuid(4e530b0a-e611-4c77-a3ac-9031d022281b),
3439 pointer_default(unique)
3441 interface IApplicationAssociationRegistration : IUnknown
3443 HRESULT QueryCurrentDefault(
3444 [in, string] LPCWSTR pszQuery,
3445 [in] ASSOCIATIONTYPE atQueryType,
3446 [in] ASSOCIATIONLEVEL alQueryLevel,
3447 [out, string] LPWSTR *ppszAssociation);
3449 HRESULT QueryAppIsDefault(
3450 [in, string] LPCWSTR pszQuery,
3451 [in] ASSOCIATIONTYPE atQueryType,
3452 [in] ASSOCIATIONLEVEL alQueryLevel,
3453 [in, string] LPCWSTR pszAppRegistryName,
3454 [out] BOOL *pfDefault);
3456 HRESULT QueryAppIsDefaultAll(
3457 [in] ASSOCIATIONLEVEL alQueryLevel,
3458 [in, string] LPCWSTR pszAppRegistryName,
3459 [out] BOOL* pfDefault);
3461 HRESULT SetAppAsDefault(
3462 [in, string] LPCWSTR pszAppRegistryName,
3463 [in, string] LPCWSTR pszSet,
3464 [in] ASSOCIATIONTYPE atSetType);
3466 HRESULT SetAppAsDefaultAll(
3467 [in, string] LPCWSTR pszAppRegistryName);
3469 HRESULT ClearUserAssociations();
3473 object,
3474 uuid(12337d35-94c6-48a0-bce7-6a9c69d4d600),
3475 pointer_default(unique)
3477 interface IApplicationDestinations : IUnknown
3479 HRESULT SetAppID(
3480 [in] LPCWSTR pszAppID);
3482 HRESULT RemoveDestination(
3483 [in] IUnknown *punk);
3485 HRESULT RemoveAllDestinations();
3489 uuid(6332debf-87b5-4670-90c0-5e57b408a49e),
3490 object,
3491 pointer_default(unique)
3493 interface ICustomDestinationList : IUnknown
3495 typedef [v1_enum] enum KNOWNDESTCATEGORY {
3496 KDC_FREQUENT = 1,
3497 KDC_RECENT
3498 } KNOWNDESTCATEGORY;
3500 HRESULT SetAppID([in, string] LPCWSTR pszAppID);
3502 HRESULT BeginList(
3503 [out] UINT *pcMinSlots,
3504 [in] REFIID riid,
3505 [out, iid_is(riid)] void **ppv);
3507 HRESULT AppendCategory(
3508 [in, string] LPCWSTR pszCategory,
3509 [in] IObjectArray *poa);
3511 HRESULT AppendKnownCategory([in] KNOWNDESTCATEGORY category);
3512 HRESULT AddUserTasks([in] IObjectArray *poa);
3513 HRESULT CommitList();
3515 HRESULT GetRemovedDestinations(
3516 [in] REFIID riid,
3517 [out, iid_is(riid)] void **ppv);
3519 HRESULT DeleteList([in, unique, string] LPCWSTR pszAppID);
3520 HRESULT AbortList();
3524 uuid(ddefe873-6997-4e68-be26-39b633adbe12),
3525 object,
3526 pointer_default(unique)
3528 interface IQueryCancelAutoPlay : IUnknown
3530 HRESULT AllowAutoPlay([in, string] LPCWSTR path,
3531 [in] DWORD content_type,
3532 [in, string] LPCWSTR label,
3533 [in] DWORD serial_number);
3537 uuid(d594d0d8-8da7-457b-b3b4-ce5dbaac0b88),
3538 pointer_default(unique)
3540 interface ITransferAdviseSink : IUnknown
3542 [v1_enum] enum _TRANSFER_ADVISE_STATE
3544 TS_NONE = 0,
3545 TS_PERFORMING = 1,
3546 TS_PREPARING = 2,
3547 TS_INDETERMINATE = 4
3549 typedef DWORD TRANSFER_ADVISE_STATE;
3551 HRESULT UpdateProgress([in] ULONGLONG size_current,
3552 [in] ULONGLONG size_total,
3553 [in] INT files_current,
3554 [in] INT files_total,
3555 [in] INT folders_current,
3556 [in] INT folders_total);
3557 HRESULT UpdateTransferState([in] TRANSFER_ADVISE_STATE state);
3558 HRESULT ConfirmOverwrite([in] IShellItem *source,
3559 [in] IShellItem *dest_parent,
3560 [in, string] LPCWSTR name);
3561 HRESULT ConfirmEncryptionLoss([in] IShellItem *source);
3562 HRESULT FileFailure([in] IShellItem *item,
3563 [in, unique, string] LPCWSTR itemname,
3564 [in] HRESULT hr,
3565 [in, out, unique, size_is(crename)] LPWSTR rename,
3566 [in] ULONG crename);
3567 HRESULT SubStreamFailure([in] IShellItem *item,
3568 [in, string] LPCWSTR stream,
3569 [in] HRESULT hr);
3570 HRESULT PropertyFailure([in] IShellItem *item,
3571 [in, unique] const PROPERTYKEY *key,
3572 [in] HRESULT hr);
3575 [v1_enum] enum _TRANSFER_SOURCE_FLAGS
3577 TSF_NORMAL = 0,
3578 TSF_FAIL_EXIST = 0,
3579 TSF_RENAME_EXIST = 0x1,
3580 TSF_OVERWRITE_EXIST = 0x2,
3581 TSF_ALLOW_DECRYPTION = 0x4,
3582 TSF_NO_SECURITY = 0x8,
3583 TSF_COPY_CREATION_TIME = 0x10,
3584 TSF_COPY_WRITE_TIME = 0x20,
3585 TSF_USE_FULL_ACCESS = 0x40,
3586 TSF_DELETE_RECYCLE_IF_POSSIBLE = 0x80,
3587 TSF_COPY_HARD_LINK = 0x100,
3588 TSF_COPY_LOCALIZED_NAME = 0x200,
3589 TSF_MOVE_AS_COPY_DELETE = 0x400,
3590 TSF_SUSPEND_SHELLEVENTS = 0x800
3592 typedef DWORD TRANSFER_SOURCE_FLAGS;
3595 uuid(00adb003-bde9-45c6-8e29-d09f9353e108),
3596 object,
3597 pointer_default(unique)
3599 interface ITransferSource : IUnknown
3601 HRESULT Advise([in] ITransferAdviseSink *sink, [out] DWORD *cookie);
3602 HRESULT Unadvise([in] DWORD cookie);
3603 HRESULT SetProperties([in] IPropertyChangeArray *array);
3604 HRESULT OpenItem([in] IShellItem *item,
3605 [in] TRANSFER_SOURCE_FLAGS flags,
3606 [in] REFIID riid,
3607 [out, iid_is(riid)] void **ppv);
3608 HRESULT MoveItem([in] IShellItem *item,
3609 [in] IShellItem *parent_dest,
3610 [in, string] LPCWSTR name_dest,
3611 [in] TRANSFER_SOURCE_FLAGS flags,
3612 [out] IShellItem **newitem);
3613 HRESULT RecycleItem([in] IShellItem *source,
3614 [in] IShellItem *parent_dest,
3615 [in] TRANSFER_SOURCE_FLAGS flags,
3616 [out] IShellItem **new_dest);
3617 HRESULT RemoveItem([in] IShellItem *source, [in] TRANSFER_SOURCE_FLAGS flags);
3618 HRESULT RenameItem([in] IShellItem *source,
3619 [in, string] LPCWSTR newname,
3620 [in] TRANSFER_SOURCE_FLAGS flags,
3621 [out] IShellItem **new_dest);
3622 HRESULT LinkItem([in] IShellItem *source,
3623 [in] IShellItem *parent_dest,
3624 [in, unique, string] LPCWSTR new_name,
3625 [in] TRANSFER_SOURCE_FLAGS flags,
3626 [out] IShellItem **new_dest);
3627 HRESULT ApplyPropertiesToItem([in] IShellItem *source, [out] IShellItem **newitem);
3628 HRESULT GetDefaultDestinationName([in] IShellItem *source,
3629 [in] IShellItem *parent_dest,
3630 [out, string] LPWSTR *dest_name);
3631 HRESULT EnterFolder([in] IShellItem *child_folder);
3632 HRESULT LeaveFolder([in] IShellItem *child_folder);
3636 uuid(48addd32-3ca5-4124-abe3-b5a72531b207),
3637 object,
3638 pointer_default(unique)
3640 interface ITransferDestination : IUnknown
3642 HRESULT Advise([in] ITransferAdviseSink *sink, [out] DWORD *cookie);
3643 HRESULT Unadvise([in] DWORD cookie);
3644 HRESULT CreateItem([in, string] LPCWSTR name,
3645 [in] DWORD attr,
3646 [in] ULONGLONG size,
3647 [in] TRANSFER_SOURCE_FLAGS flags,
3648 [in] REFIID riid,
3649 [out, iid_is(riid)] void **ppv,
3650 [in] REFIID resources,
3651 [out, iid_is(riid)] void **presources);
3655 uuid(92218cab-ecaa-4335-8133-807fd234c2ee),
3656 object,
3657 pointer_default(unique)
3659 interface IAssocHandlerInvoker : IUnknown
3661 HRESULT SupportsSelection();
3662 HRESULT Invoke();
3666 uuid(f04061ac-1659-4a3f-a954-775aa57fc083),
3667 object,
3668 pointer_default(unique)
3670 interface IAssocHandler : IUnknown
3672 HRESULT GetName([out, string] LPWSTR *name);
3673 HRESULT GetUIName([out, string] LPWSTR *uiname);
3674 HRESULT GetIconLocation([out, string] LPWSTR *path,
3675 [out] int *index);
3676 HRESULT IsRecommended();
3677 HRESULT MakeDefault([in, string] LPCWSTR description);
3678 HRESULT Invoke([in] IDataObject *object);
3679 HRESULT CreateInvoker([in] IDataObject *object,
3680 [out] IAssocHandlerInvoker **invoker);
3684 uuid(973810ae-9599-4b88-9e4d-6ee98c9552da),
3685 object,
3686 pointer_default(unique)
3688 interface IEnumAssocHandlers : IUnknown
3690 HRESULT Next([in] ULONG count,
3691 [out, size_is(count), length_is(*fetched)] IAssocHandler **handlers,
3692 [out] ULONG *fetched);
3695 typedef enum ASSOC_FILTER
3697 ASSOC_FILTER_NONE = 0,
3698 ASSOC_FILTER_RECOMMENDED
3699 } ASSOC_FILTER;
3700 cpp_quote("HRESULT WINAPI SHAssocEnumHandlers(PCWSTR extra, ASSOC_FILTER filter, IEnumAssocHandlers **handlersenum);")
3703 uuid(1df0d7f1-b267-4d28-8b10-12e23202a5c4),
3705 interface IItemNameLimits : IUnknown
3707 HRESULT GetValidCharacters(
3708 [out, string] LPWSTR *validchars,
3709 [out, string] LPWSTR *invalidchars);
3711 HRESULT GetMaxLength(
3712 [in, string] LPCWSTR name,
3713 [out] int *max_length);
3716 typedef [v1_enum] enum ACTIVATEOPTIONS
3718 AO_NONE = 0x00000000,
3719 AO_DESIGNMODE = 0x00000001,
3720 AO_NOERRORUI = 0x00000002,
3721 AO_NOSPLASHSCREEN = 0x00000004,
3722 AO_PRELAUNCH = 0x02000000
3723 } ACTIVATEOPTIONS;
3726 uuid(2e941141-7f97-4756-ba1d-9decde894a3d),
3727 object,
3728 pointer_default(unique)
3730 interface IApplicationActivationManager : IUnknown
3732 HRESULT ActivateApplication([in] LPCWSTR appusermodelid,
3733 [in, unique] LPCWSTR arguments,
3734 [in] ACTIVATEOPTIONS options,
3735 [out] DWORD *processid);
3736 HRESULT ActivateForFile([in] LPCWSTR appusermodelid,
3737 [in] IShellItemArray *itemarray,
3738 [in, unique] LPCWSTR verb,
3739 [out] DWORD *processid);
3740 HRESULT ActivateForProtocol([in] LPCWSTR appusermodelid,
3741 [in] IShellItemArray *itemarray,
3742 [out] DWORD *processid);
3746 object,
3747 uuid(fec87aaf-35f9-447a-adb7-20234491401a),
3748 pointer_default(unique)
3750 interface IPreviewHandlerFrame : IUnknown
3752 typedef struct PREVIEWHANDLERFRAMEINFO
3754 HACCEL haccel;
3755 UINT cAccelEntries;
3756 } PREVIEWHANDLERFRAMEINFO;
3758 HRESULT GetWindowContext([out] PREVIEWHANDLERFRAMEINFO *info);
3759 HRESULT TranslateAccelerator([in] MSG *msg);
3762 /*****************************************************************************
3763 * ShellObjects typelibrary
3766 uuid(50A7E9B1-70EF-11D1-B75A-00A0C90564FE),
3767 lcid(0x0000),
3768 version(1.0)
3770 library ShellObjects
3773 uuid(71F96385-DDD6-48D3-A0C1-AE06E8B055FB)
3775 coclass ExplorerBrowser
3777 interface IExplorerBrowser;
3781 uuid(DC1C5A9C-E88A-4DDE-A5A1-60F82A20AEF7)
3783 coclass FileOpenDialog
3785 interface IFileOpenDialog;
3789 uuid(C0B4E2F3-BA21-4773-8DBA-335EC946EB8B)
3791 coclass FileSaveDialog
3793 interface IFileSaveDialog;
3797 uuid(AE054212-3535-4430-83ED-D501AA6680E6)
3799 coclass NamespaceTreeControl
3801 interface INameSpaceTreeControl2;
3805 uuid(4df0c730-df9d-4ae3-9153-aa6b82e9795a)
3807 coclass KnownFolderManager
3809 interface IKnownFolderManager;
3813 uuid(591209c7-767b-42b2-9fba-44ee4615f2c7)
3815 coclass ApplicationAssociationRegistration
3817 interface IApplicationAssociationRegistration;
3821 uuid(86c14003-4d6b-4ef3-a7b4-0506663b2e68)
3823 coclass ApplicationDestinations
3825 interface IApplicationDestinations;
3829 uuid(00021401-0000-0000-c000-000000000046)
3831 coclass ShellLink
3833 interface IShellLinkW;
3837 uuid(56fdf344-fd6d-11d0-958a-006097c9a090)
3839 coclass TaskbarList
3841 interface ITaskbarList4;
3845 uuid(77f10cf0-3db5-4966-b520-b7c54fd35ed6)
3847 coclass DestinationList {
3848 interface ICustomDestinationList;
3852 uuid(2d3468c1-36a7-43b6-ac24-d3f02fd9607a)
3854 coclass EnumerableObjectCollection
3856 interface IEnumObjects;
3860 uuid(331f1768-05a9-4ddd-b86e-dae34ddc998a)
3862 coclass QueryCancelAutoPlay
3864 interface IQueryCancelAutoPlay;
3868 uuid(45ba127d-10a8-46ea-8ab7-56ea9078943c)
3870 coclass ApplicationActivationManager
3872 interface IApplicationActivationManager;