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