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