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