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