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