shell32: Avoid checking for <0 for unsigned variables.
[wine.git] / include / shobjidl.idl
blob5e937dc7368a8ef22ae35e95ca0b669157fb0f1f
1 /*
2 * COM interfaces for shell objects
4 * Copyright (C) 1999 Juergen Schmied
5 * Copyright (C) 2003 Alexandre Julliard
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.
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.
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
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 /* FIXME: import "propsys.idl"; */
34 /* FIXME: import "structuredquery.idl"; */
36 cpp_quote("/* FIXME: #include <sherrors.h> */")
39 /*****************************************************************************
40 * IPersistFolder interface
43 object,
44 uuid(000214ea-0000-0000-c000-000000000046),
45 pointer_default(unique)
47 interface IPersistFolder : IPersist
49 typedef IPersistFolder *LPPERSISTFOLDER;
51 HRESULT Initialize( [in] LPCITEMIDLIST pidl );
55 /*****************************************************************************
56 * IPersistFolder2 interface
59 object,
60 uuid(1ac3d9f0-175c-11d1-95be-00609797ea4f),
61 pointer_default(unique)
63 interface IPersistFolder2 : IPersistFolder
65 typedef IPersistFolder2 *LPPERSISTFOLDER2;
67 HRESULT GetCurFolder( [out] LPITEMIDLIST *ppidl );
71 /*****************************************************************************
72 * IEnumIDList interface
75 object,
76 uuid(000214f2-0000-0000-c000-000000000046),
77 pointer_default(unique)
79 interface IEnumIDList : IUnknown
81 typedef IEnumIDList *LPENUMIDLIST;
83 HRESULT Next(
84 [in] ULONG celt,
85 [out, size_is(celt), length_is(*pceltFetched)] LPITEMIDLIST *rgelt,
86 [out] ULONG *pceltFetched);
88 HRESULT Skip( [in] ULONG celt );
89 HRESULT Reset();
90 HRESULT Clone( [out] IEnumIDList **ppenum );
93 /*****************************************************************************
94 * IShellPropSheetExt interface
96 cpp_quote("#if 0")
97 typedef LPARAM LPFNSVADDPROPSHEETPAGE;
98 cpp_quote("#else")
99 cpp_quote("#include <prsht.h>")
100 cpp_quote("typedef LPFNADDPROPSHEETPAGE LPFNSVADDPROPSHEETPAGE;")
101 cpp_quote("#endif")
104 object,
105 uuid(000214E9-0000-0000-C000-000000000046),
106 pointer_default(unique)
108 interface IShellPropSheetExt : IUnknown
110 enum tagSHELLPROPSHEETEXTPAGEID {
111 EXPPS_FILETYPES = 0x1
114 typedef UINT EXPPS;
116 HRESULT AddPages(
117 [in] LPFNSVADDPROPSHEETPAGE pfnAddPage,
118 [in] LPARAM lParam);
119 HRESULT ReplacePage(
120 [in] EXPPS uPageID,
121 [in] LPFNSVADDPROPSHEETPAGE pfnReplaceWith,
122 [in] LPARAM lParam);
124 typedef IShellPropSheetExt *LPSHELLPROPSHEETEXT;
126 /*****************************************************************************
127 * IShellFolder interface
130 object,
131 uuid(000214e6-0000-0000-c000-000000000046),
132 pointer_default(unique)
134 interface IShellFolder : IUnknown
136 typedef IShellFolder * LPSHELLFOLDER;
138 typedef enum tagSHGDN
140 SHGDN_NORMAL = 0,
141 SHGDN_INFOLDER = 1,
142 SHGDN_FOREDITING = 0x1000,
143 SHGDN_INCLUDE_NONFILESYS = 0x2000,
144 SHGDN_FORADDRESSBAR = 0x4000,
145 SHGDN_FORPARSING = 0x8000
146 } SHGNO;
148 typedef DWORD SHGDNF;
150 enum tagSHCONTF
152 SHCONTF_FOLDERS = 32,
153 SHCONTF_NONFOLDERS = 64,
154 SHCONTF_INCLUDEHIDDEN = 128,
155 SHCONTF_INIT_ON_FIRST_NEXT = 256,
156 SHCONTF_NETPRINTERSRCH = 512,
157 SHCONTF_SHAREABLE = 1024,
158 SHCONTF_STORAGE = 2048
161 typedef DWORD SHCONTF;
163 cpp_quote("#define SFGAO_CANCOPY DROPEFFECT_COPY")
164 cpp_quote("#define SFGAO_CANMOVE DROPEFFECT_MOVE")
165 cpp_quote("#define SFGAO_CANLINK DROPEFFECT_LINK")
166 cpp_quote("#define SFGAO_STORAGE 0x00000008L")
167 cpp_quote("#define SFGAO_CANRENAME 0x00000010L")
168 cpp_quote("#define SFGAO_CANDELETE 0x00000020L")
169 cpp_quote("#define SFGAO_HASPROPSHEET 0x00000040L")
170 cpp_quote("#define SFGAO_DROPTARGET 0x00000100L")
171 cpp_quote("#define SFGAO_CAPABILITYMASK 0x00000177L")
172 cpp_quote("#define SFGAO_ENCRYPTED 0x00002000L")
173 cpp_quote("#define SFGAO_ISSLOW 0x00004000L")
174 cpp_quote("#define SFGAO_GHOSTED 0x00008000L")
175 cpp_quote("#define SFGAO_LINK 0x00010000L")
176 cpp_quote("#define SFGAO_SHARE 0x00020000L")
177 cpp_quote("#define SFGAO_READONLY 0x00040000L")
178 cpp_quote("#define SFGAO_HIDDEN 0x00080000L")
179 cpp_quote("#define SFGAO_DISPLAYATTRMASK 0x000FC000L")
180 cpp_quote("#define SFGAO_FILESYSANCESTOR 0x10000000L")
181 cpp_quote("#define SFGAO_FOLDER 0x20000000L")
182 cpp_quote("#define SFGAO_FILESYSTEM 0x40000000L")
183 cpp_quote("#define SFGAO_HASSUBFOLDER 0x80000000L")
184 cpp_quote("#define SFGAO_CONTENTSMASK 0x80000000L")
185 cpp_quote("#define SFGAO_VALIDATE 0x01000000L")
186 cpp_quote("#define SFGAO_REMOVABLE 0x02000000L")
187 cpp_quote("#define SFGAO_COMPRESSED 0x04000000L")
188 cpp_quote("#define SFGAO_BROWSABLE 0x08000000L")
189 cpp_quote("#define SFGAO_NONENUMERATED 0x00100000L")
190 cpp_quote("#define SFGAO_NEWCONTENT 0x00200000L")
191 cpp_quote("#define SFGAO_STREAM 0x00400000L")
192 cpp_quote("#define SFGAO_STORAGEANCESTOR 0x00800000L")
194 typedef ULONG SFGAOF;
196 HRESULT ParseDisplayName(
197 [in] HWND hwndOwner,
198 [in] LPBC pbcReserved,
199 [in, string] LPOLESTR lpszDisplayName,
200 [out] ULONG *pchEaten,
201 [out] LPITEMIDLIST *ppidl,
202 [in, out, unique] ULONG *pdwAttributes);
204 HRESULT EnumObjects(
205 [in] HWND hwndOwner,
206 [in] SHCONTF grfFlags,
207 [out] IEnumIDList **ppenumIDList);
209 HRESULT BindToObject(
210 [in] LPCITEMIDLIST pidl,
211 [in] LPBC pbcReserved,
212 [in] REFIID riid,
213 [out, iid_is(riid)] void **ppvOut);
215 HRESULT BindToStorage(
216 [in] LPCITEMIDLIST pidl,
217 [in] LPBC pbcReserved,
218 [in] REFIID riid,
219 [out, iid_is(riid)] void **ppvObj);
221 HRESULT CompareIDs(
222 [in] LPARAM lParam,
223 [in] LPCITEMIDLIST pidl1,
224 [in] LPCITEMIDLIST pidl2);
226 HRESULT CreateViewObject(
227 [in] HWND hwndOwner,
228 [in] REFIID riid,
229 [out, iid_is(riid)] void **ppvOut);
231 HRESULT GetAttributesOf(
232 [in] UINT cidl,
233 [in, size_is(cidl)] LPCITEMIDLIST *apidl,
234 [in, out] SFGAOF *rgfInOut);
236 HRESULT GetUIObjectOf(
237 [in] HWND hwndOwner,
238 [in] UINT cidl,
239 [in, size_is(cidl)] LPCITEMIDLIST *apidl,
240 [in] REFIID riid,
241 [in, out, unique] UINT *prgfInOut,
242 [out, iid_is(riid)] void **ppvOut);
244 HRESULT GetDisplayNameOf(
245 [in] LPCITEMIDLIST pidl,
246 [in] SHGDNF uFlags,
247 [out] STRRET *lpName);
249 HRESULT SetNameOf(
250 [in] HWND hwnd,
251 [in] LPCITEMIDLIST pidl,
252 [in, string] LPCOLESTR lpszName,
253 [in] SHGDNF uFlags,
254 [out] LPITEMIDLIST *ppidlOut);
258 /*****************************************************************************
259 * IEnumExtraSearch interface
262 object,
263 uuid(0e700be1-9db6-11d1-a1ce-00c04fd75d13),
264 pointer_default(unique)
266 interface IEnumExtraSearch : IUnknown
268 typedef IEnumExtraSearch *LPENUMEXTRASEARCH;
270 typedef struct
272 GUID guidSearch;
273 WCHAR wszFriendlyName[80];
275 *WCHAR wszMenuText[80];
276 *WCHAR wszHelpText[MAX_PATH];
278 WCHAR wszUrl[2084];
280 *WCHAR wszIcon[MAX_PATH+10];
281 *WCHAR wszGreyIcon[MAX_PATH+10];
282 *WCHAR wszClrIcon[MAX_PATH+10];
284 } EXTRASEARCH, *LPEXTRASEARCH;
286 HRESULT Next(
287 [in] ULONG celt,
288 [out, size_is(celt), length_is(*pceltFetched)] EXTRASEARCH *rgelt,
289 [out] ULONG *pceltFetched);
291 HRESULT Skip( [in] ULONG celt );
292 HRESULT Reset();
293 HRESULT Clone( [out] IEnumExtraSearch **ppenum );
297 /*****************************************************************************
298 * IShellFolder2 interface
301 object,
302 uuid(93f2f68c-1d1b-11d3-a30e-00c04f79abd1),
303 pointer_default(unique)
305 interface IShellFolder2 : IShellFolder
307 typedef enum
309 SHCOLSTATE_TYPE_STR = 0x00000001,
310 SHCOLSTATE_TYPE_INT = 0x00000002,
311 SHCOLSTATE_TYPE_DATE = 0x00000003,
312 SHCOLSTATE_TYPEMASK = 0x0000000f,
313 SHCOLSTATE_ONBYDEFAULT = 0x00000010,
314 SHCOLSTATE_SLOW = 0x00000020,
315 SHCOLSTATE_EXTENDED = 0x00000040,
316 SHCOLSTATE_SECONDARYUI = 0x00000080,
317 SHCOLSTATE_HIDDEN = 0x00000100,
318 SHCOLSTATE_PREFER_VARCMP = 0x00000200
319 } SHCOLSTATE;
321 typedef DWORD SHCOLSTATEF;
323 typedef struct
325 GUID fmtid;
326 DWORD pid;
327 } SHCOLUMNID, *LPSHCOLUMNID;
328 typedef const SHCOLUMNID *LPCSHCOLUMNID;
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 );
341 /*****************************************************************************
342 * FOLDERSETTINGS
344 typedef char *LPVIEWSETTINGS;
346 typedef enum
348 FWF_AUTOARRANGE = 0x00000001,
349 FWF_ABBREVIATEDNAMES = 0x00000002,
350 FWF_SNAPTOGRID = 0x00000004,
351 FWF_OWNERDATA = 0x00000008,
352 FWF_BESTFITWINDOW = 0x00000010,
353 FWF_DESKTOP = 0x00000020,
354 FWF_SINGLESEL = 0x00000040,
355 FWF_NOSUBFOLDERS = 0x00000080,
356 FWF_TRANSPARENT = 0x00000100,
357 FWF_NOCLIENTEDGE = 0x00000200,
358 FWF_NOSCROLL = 0x00000400,
359 FWF_ALIGNLEFT = 0x00000800,
360 FWF_NOICONS = 0x00001000,
361 FWF_SHOWSELALWAYS = 0x00002000,
362 FWF_NOVISIBLE = 0x00004000,
363 FWF_SINGLECLICKACTIVATE = 0x00008000,
364 FWF_NOWEBVIEW = 0x00010000,
365 FWF_HIDEFILENAMES = 0x00020000,
366 FWF_CHECKSELECT = 0x00040000
367 } FOLDERFLAGS;
369 typedef enum
371 FVM_ICON = 1,
372 FVM_FIRST = FVM_ICON,
373 FVM_SMALLICON = 2,
374 FVM_LIST = 3,
375 FVM_DETAILS = 4,
376 FVM_THUMBNAIL = 5,
377 FVM_TILE = 6,
378 FVM_THUMBSTRIP = 7,
379 FVM_LAST = FVM_THUMBSTRIP
380 } FOLDERVIEWMODE;
382 typedef struct
384 UINT ViewMode;
385 UINT fFlags;
386 } FOLDERSETTINGS, *PFOLDERSETTINGS, *LPFOLDERSETTINGS;
387 typedef const FOLDERSETTINGS *LPCFOLDERSETTINGS;
390 /*****************************************************************************
391 * IShellView interface
393 interface IShellBrowser; /* forward declaration */
395 object,
396 uuid(000214e3-0000-0000-c000-000000000046),
397 pointer_default(unique)
399 interface IShellView : IOleWindow
401 typedef IShellView *LPSHELLVIEW;
403 cpp_quote("#define SVSI_DESELECT 0x00000000")
404 cpp_quote("#define SVSI_SELECT 0x00000001")
405 cpp_quote("#define SVSI_EDIT 0x00000003")
406 cpp_quote("#define SVSI_DESELECTOTHERS 0x00000004")
407 cpp_quote("#define SVSI_ENSUREVISIBLE 0x00000008")
408 cpp_quote("#define SVSI_FOCUSED 0x00000010")
409 cpp_quote("#define SVSI_TRANSLATEPT 0x00000020")
410 cpp_quote("#define SVSI_SELECTIONMARK 0x00000040")
411 cpp_quote("#define SVSI_POSITIONITEM 0x00000080")
412 cpp_quote("#define SVSI_CHECK 0x00000100")
413 cpp_quote("#define SVSI_NOSTATECHANGE 0x80000000")
415 typedef UINT SVSIF;
417 typedef enum
419 SVGIO_BACKGROUND = 0x00000000,
420 SVGIO_SELECTION = 0x00000001,
421 SVGIO_ALLVIEW = 0x00000002,
422 SVGIO_CHECKED = 0x00000003,
423 SVGIO_TYPE_MASK = 0x0000000f,
424 SVGIO_FLAG_VIEWORDER = 0x80000000,
425 } SVGIO;
427 typedef enum
429 SVUIA_DEACTIVATE = 0,
430 SVUIA_ACTIVATE_NOFOCUS = 1,
431 SVUIA_ACTIVATE_FOCUS = 2,
432 SVUIA_INPLACEACTIVATE = 3
433 } SVUIA_STATUS;
435 HRESULT TranslateAccelerator( [in] MSG *pmsg );
436 HRESULT EnableModeless( [in] BOOL fEnable );
437 HRESULT UIActivate( [in] UINT uState );
438 HRESULT Refresh();
439 HRESULT CreateViewWindow(
440 [in] IShellView *psvPrevious,
441 [in] LPCFOLDERSETTINGS lpfs,
442 [in] IShellBrowser *psb,
443 [out] RECT *prcView,
444 [out] HWND *phWnd);
446 HRESULT DestroyViewWindow();
447 HRESULT GetCurrentInfo( [out] LPFOLDERSETTINGS lpfs );
449 [local] HRESULT AddPropertySheetPages(
450 [in] DWORD dwReserved,
451 [in] LPFNSVADDPROPSHEETPAGE pfn,
452 [in] LPARAM lparam);
454 HRESULT SaveViewState();
455 HRESULT SelectItem(
456 [in] LPCITEMIDLIST pidlItem,
457 [in] SVSIF uFlags);
458 HRESULT GetItemObject(
459 [in] UINT uItem,
460 [in] REFIID riid,
461 [out, iid_is(riid)] void **ppv);
465 /*****************************************************************************
466 * IShellBrowser interface
469 object,
470 uuid(000214e2-0000-0000-c000-000000000046),
471 pointer_default(unique)
473 interface IShellBrowser : IOleWindow
475 typedef IShellBrowser *LPSHELLBROWSER;
477 cpp_quote("#define SBSP_DEFBROWSER 0x00000000")
478 cpp_quote("#define SBSP_SAMEBROWSER 0x00000001")
479 cpp_quote("#define SBSP_NEWBROWSER 0x00000002")
480 cpp_quote("#define SBSP_DEFMODE 0x00000000")
481 cpp_quote("#define SBSP_OPENMODE 0x00000010")
482 cpp_quote("#define SBSP_EXPLOREMODE 0x00000020")
483 cpp_quote("#define SBSP_HELPMODE 0x00000040")
484 cpp_quote("#define SBSP_NOTRANSFERHIST 0x00000080")
485 cpp_quote("#define SBSP_ABSOLUTE 0x00000000")
486 cpp_quote("#define SBSP_RELATIVE 0x00001000")
487 cpp_quote("#define SBSP_PARENT 0x00002000")
488 cpp_quote("#define SBSP_NAVIGATEBACK 0x00004000")
489 cpp_quote("#define SBSP_NAVIGATEFORWARD 0x00008000")
490 cpp_quote("#define SBSP_ALLOW_AUTONAVIGATE 0x00010000")
491 cpp_quote("#define SBSP_NOAUTOSELECT 0x04000000")
492 cpp_quote("#define SBSP_WRITENOHISTORY 0x08000000")
493 cpp_quote("#define SBSP_REDIRECT 0x40000000")
494 cpp_quote("#define SBSP_INITIATEDBYHLINKFRAME 0x80000000")
496 cpp_quote("#define FCW_STATUS 0x0001")
497 cpp_quote("#define FCW_TOOLBAR 0x0002")
498 cpp_quote("#define FCW_TREE 0x0003")
499 cpp_quote("#define FCW_INTERNETBAR 0x0006")
500 cpp_quote("#define FCW_PROGRESS 0x0008")
502 cpp_quote("#define FCT_MERGE 0x0001")
503 cpp_quote("#define FCT_CONFIGABLE 0x0002")
504 cpp_quote("#define FCT_ADDTOEND 0x0004")
506 cpp_quote("#if 0")
507 typedef LPARAM LPTBBUTTONSB;
508 cpp_quote("#else")
509 cpp_quote("#include <commctrl.h>")
510 cpp_quote("typedef LPTBBUTTON LPTBBUTTONSB;")
511 cpp_quote("#endif")
513 HRESULT InsertMenusSB(
514 [in] HMENU hmenuShared,
515 [in, out] LPOLEMENUGROUPWIDTHS lpMenuWidths);
517 HRESULT SetMenuSB(
518 [in] HMENU hmenuShared,
519 [in] HOLEMENU holemenuReserved,
520 [in] HWND hwndActiveObject);
522 HRESULT RemoveMenusSB( [in] HMENU hmenuShared );
523 HRESULT SetStatusTextSB( [in, unique] LPCOLESTR pszStatusText );
524 HRESULT EnableModelessSB( [in] BOOL fEnable );
525 HRESULT TranslateAcceleratorSB( [in] MSG *pmsg, [in] WORD wID );
527 HRESULT BrowseObject(
528 [in] LPCITEMIDLIST pidl,
529 [in] UINT wFlags);
531 HRESULT GetViewStateStream(
532 [in] DWORD grfMode,
533 [out] IStream **ppStrm);
535 HRESULT GetControlWindow(
536 [in] UINT id,
537 [out] HWND *phwnd);
539 [local] HRESULT SendControlMsg(
540 [in] UINT id,
541 [in] UINT uMsg,
542 [in] WPARAM wParam,
543 [in] LPARAM lParam,
544 [in] LRESULT *pret);
546 HRESULT QueryActiveShellView( [out] IShellView **ppshv );
547 HRESULT OnViewWindowActive( [in] IShellView *pshv );
549 [local]
550 HRESULT SetToolbarItems(
551 [in] LPTBBUTTONSB lpButtons,
552 [in] UINT nButtons,
553 [in] UINT uFlags);
557 /*****************************************************************************
558 * IShellLinkA interface
561 object,
562 uuid(000214ee-0000-0000-c000-000000000046),
563 pointer_default(unique)
565 interface IShellLinkA : IUnknown
567 typedef enum
569 SLR_NO_UI = 0x0001,
570 SLR_ANY_MATCH = 0x0002,
571 SLR_UPDATE = 0x0004,
572 SLR_NOUPDATE = 0x0008,
573 SLR_NOSEARCH = 0x0010,
574 SLR_NOTRACK = 0x0020,
575 SLR_NOLINKINFO = 0x0040,
576 SLR_INVOKE_MSI = 0x0080,
577 SLR_NO_UI_WITH_MSG_PUMP = 0x0101,
578 } SLR_FLAGS;
580 typedef enum
582 SLGP_SHORTPATH = 0x0001,
583 SLGP_UNCPRIORITY = 0x0002,
584 SLGP_RAWPATH = 0x0004,
585 } SLGP_FLAGS;
587 HRESULT GetPath(
588 [out, size_is(cch)] LPSTR pszFile,
589 [in] int cch,
590 [in, out] WIN32_FIND_DATAA *pfd,
591 [in] DWORD fFlags);
593 HRESULT GetIDList( [out] LPITEMIDLIST * ppidl );
595 HRESULT SetIDList( [in] LPCITEMIDLIST pidl );
597 HRESULT GetDescription(
598 [out, size_is(cch)] LPSTR pszName,
599 [in] int cch);
601 HRESULT SetDescription( [in] LPCSTR pszName );
603 HRESULT GetWorkingDirectory(
604 [out, size_is(cch)] LPSTR pszDir,
605 [in] int cch);
607 HRESULT SetWorkingDirectory( [in] LPCSTR pszDir );
609 HRESULT GetArguments(
610 [out, size_is(cch)] LPSTR pszArgs,
611 [in] int cch);
613 HRESULT SetArguments( [in] LPCSTR pszArgs );
615 HRESULT GetHotkey( [out] WORD *pwHotkey );
617 HRESULT SetHotkey( [in] WORD wHotkey );
619 HRESULT GetShowCmd( [out] int *piShowCmd );
621 HRESULT SetShowCmd( [in] int iShowCmd );
623 HRESULT GetIconLocation(
624 [out, size_is(cch)] LPSTR pszIconPath,
625 [in] int cch,
626 [out] int *piIcon);
628 HRESULT SetIconLocation(
629 [in] LPCSTR pszIconPath,
630 [in] int iIcon);
632 HRESULT SetRelativePath(
633 [in] LPCSTR pszPathRel,
634 [in] DWORD dwReserved);
636 HRESULT Resolve(
637 [in] HWND hwnd,
638 [in] DWORD fFlags);
640 HRESULT SetPath( [in] LPCSTR pszFile );
644 /*****************************************************************************
645 * IShellLinkW interface
648 object,
649 uuid(000214f9-0000-0000-c000-000000000046),
650 pointer_default(unique)
652 interface IShellLinkW : IUnknown
654 HRESULT GetPath(
655 [out, size_is(cch)] LPWSTR pszFile,
656 [in] int cch,
657 [in, out] WIN32_FIND_DATAW *pfd,
658 [in] DWORD fFlags);
660 HRESULT GetIDList( [out] LPITEMIDLIST * ppidl );
662 HRESULT SetIDList( [in] LPCITEMIDLIST pidl );
664 HRESULT GetDescription(
665 [out, size_is(cch)] LPWSTR pszName,
666 [in] int cch);
668 HRESULT SetDescription( [in] LPCWSTR pszName );
670 HRESULT GetWorkingDirectory(
671 [out, size_is(cch)] LPWSTR pszDir,
672 [in] int cch);
674 HRESULT SetWorkingDirectory( [in] LPCWSTR pszDir );
676 HRESULT GetArguments(
677 [out, size_is(cch)] LPWSTR pszArgs,
678 [in] int cch);
680 HRESULT SetArguments( [in] LPCWSTR pszArgs );
682 HRESULT GetHotkey( [out] WORD *pwHotkey );
684 HRESULT SetHotkey( [in] WORD wHotkey );
686 HRESULT GetShowCmd( [out] int *piShowCmd );
688 HRESULT SetShowCmd( [in] int iShowCmd );
690 HRESULT GetIconLocation(
691 [out, size_is(cch)] LPWSTR pszIconPath,
692 [in] int cch,
693 [out] int *piIcon);
695 HRESULT SetIconLocation(
696 [in] LPCWSTR pszIconPath,
697 [in] int iIcon);
699 HRESULT SetRelativePath(
700 [in] LPCWSTR pszPathRel,
701 [in] DWORD dwReserved);
703 HRESULT Resolve(
704 [in] HWND hwnd,
705 [in] DWORD fFlags);
707 HRESULT SetPath( [in] LPCWSTR pszFile );
710 cpp_quote("#define IShellLink WINELIB_NAME_AW(IShellLink)")
713 /*****************************************************************************
714 * IShellExtInit interface
717 object,
718 uuid(000214e8-0000-0000-c000-000000000046),
719 pointer_default(unique)
721 interface IShellExtInit : IUnknown
723 typedef IShellExtInit *LPSHELLEXTINIT;
725 HRESULT Initialize(
726 [in] LPCITEMIDLIST pidlFolder,
727 [in] IDataObject *pdtobj,
728 [in] HKEY hkeyProgID);
732 /*******************************************************************************/
733 /* Note: the following interfaces are not in shobjidl.idl under Windows, they */
734 /* are declared directly in shlobj.h. It hopefully won't break anything to put */
735 /* them here anyway. */
736 /*******************************************************************************/
738 #ifndef MAX_PATH
739 #define MAX_PATH 260
740 #endif
743 /*****************************************************************************
744 * IPersistFolder3 interface
747 object,
748 uuid(cef04fdf-fe72-11d2-87a5-00c04f6837cf),
749 pointer_default(unique)
751 interface IPersistFolder3 : IPersistFolder2
753 typedef struct
755 LPITEMIDLIST pidlTargetFolder;
756 WCHAR szTargetParsingName[MAX_PATH];
757 WCHAR szNetworkProvider[MAX_PATH];
758 DWORD dwAttributes;
759 int csidl;
760 } PERSIST_FOLDER_TARGET_INFO;
762 HRESULT InitializeEx(
763 [in] IBindCtx *pbc,
764 [in] LPCITEMIDLIST pidlRoot,
765 [in] const PERSIST_FOLDER_TARGET_INFO *ppfti);
767 HRESULT GetFolderTargetInfo( [out] PERSIST_FOLDER_TARGET_INFO *ppfti );
771 /*****************************************************************************
772 * IExtractIconA interface
775 object,
776 uuid(000214eb-0000-0000-c000-000000000046),
777 pointer_default(unique)
779 interface IExtractIconA : IUnknown
781 cpp_quote("#define GIL_OPENICON 0x0001")
782 cpp_quote("#define GIL_FORSHELL 0x0002")
783 cpp_quote("#define GIL_ASYNC 0x0020")
784 cpp_quote("#define GIL_DEFAULTICON 0x0040")
785 cpp_quote("#define GIL_FORSHORTCUT 0x0080")
787 cpp_quote("#define GIL_SIMULATEDOC 0x0001")
788 cpp_quote("#define GIL_PERINSTANCE 0x0002")
789 cpp_quote("#define GIL_PERCLASS 0x0004")
790 cpp_quote("#define GIL_NOTFILENAME 0x0008")
791 cpp_quote("#define GIL_DONTCACHE 0x0010")
793 typedef IExtractIconA *LPEXTRACTICONA;
795 HRESULT GetIconLocation(
796 [in] UINT uFlags,
797 [out, size_is(cchMax)] LPSTR szIconFile,
798 [in] UINT cchMax,
799 [out] INT *piIndex,
800 [out] UINT *pwFlags);
802 HRESULT Extract(
803 [in] LPCSTR pszFile,
804 [in] UINT nIconIndex,
805 [out] HICON *phiconLarge,
806 [out] HICON *phiconSmall,
807 [in] UINT nIconSize );
811 /*****************************************************************************
812 * IExtractIconW interface
815 object,
816 uuid(000214fa-0000-0000-c000-000000000046),
817 pointer_default(unique)
819 interface IExtractIconW : IUnknown
821 typedef IExtractIconW *LPEXTRACTICONW;
823 HRESULT GetIconLocation(
824 [in] UINT uFlags,
825 [out, size_is(cchMax)] LPWSTR szIconFile,
826 [in] UINT cchMax,
827 [out] INT *piIndex,
828 [out] UINT *pwFlags);
830 HRESULT Extract(
831 [in] LPCWSTR pszFile,
832 [in] UINT nIconIndex,
833 [out] HICON *phiconLarge,
834 [out] HICON *phiconSmall,
835 [in] UINT nIconSize );
838 cpp_quote("#define LPEXTRACTICON WINELIB_NAME_AW(LPEXTRACTICON)")
839 cpp_quote("#define IExtractIcon WINELIB_NAME_AW(IExtractIcon)")
842 /*****************************************************************************
843 * ICommDlgBrowser interface
846 object,
847 uuid(000214f1-0000-0000-c000-000000000046),
848 pointer_default(unique)
850 interface ICommDlgBrowser : IUnknown
852 cpp_quote("#define CDBOSC_SETFOCUS 0x00000000")
853 cpp_quote("#define CDBOSC_KILLFOCUS 0x00000001")
854 cpp_quote("#define CDBOSC_SELCHANGE 0x00000002")
855 cpp_quote("#define CDBOSC_RENAME 0x00000003")
856 cpp_quote("#define CDBOSC_STATECHANGE 0x00000004")
858 typedef ICommDlgBrowser *LPCOMMDLGBROWSER;
860 HRESULT OnDefaultCommand( [in] IShellView *shv );
861 HRESULT OnStateChange( [in] IShellView *shv, [in] ULONG uChange );
862 HRESULT IncludeObject( [in] IShellView *shv, [in] LPCITEMIDLIST pidl );
866 /*****************************************************************************
867 * IDockingWindowFrame interface
870 object,
871 uuid(47d2657a-7b27-11d0-8ca9-00a0c92dbfe8),
872 pointer_default(unique)
874 interface IDockingWindowFrame : IOleWindow
876 cpp_quote("#define DWFRF_NORMAL 0x0000")
877 cpp_quote("#define DWFRF_DELETECONFIGDATA 0x0001")
878 cpp_quote("#define DWFAF_HIDDEN 0x0001")
880 HRESULT AddToolbar(
881 [in] IUnknown *punkSrc,
882 [in] LPCWSTR pwszItem,
883 [in] DWORD dwAddFlags);
885 HRESULT RemoveToolbar(
886 [in] IUnknown *punkSrc,
887 [in] DWORD dwRemoveFlags);
889 HRESULT FindToolbar(
890 [in] LPCWSTR pwszItem,
891 [in] REFIID riid,
892 [out] LPVOID *ppvObj);
896 /*****************************************************************************
897 * IDragSourceHelper interface
900 object,
901 uuid(de5bf786-477a-11d2-839d-00c04fd918d0),
902 pointer_default(unique)
904 interface IDragSourceHelper : IUnknown
906 typedef struct
908 SIZE sizeDragImage;
909 POINT ptOffset;
910 HBITMAP hbmpDragImage;
911 COLORREF crColorKey;
912 } SHDRAGIMAGE, *LPSHDRAGIMAGE;
914 HRESULT InitializeFromBitmap(
915 [in] LPSHDRAGIMAGE pshdi,
916 [in] IDataObject *pDataObject);
918 HRESULT InitializeFromWindow(
919 [in] HWND hwnd,
920 [in] POINT *ppt,
921 [in] IDataObject *pDataObject);
925 /*****************************************************************************
926 * IDropTargetHelper interface
929 object,
930 uuid(4657278b-411b-11d2-839a-00c04fd918d0),
931 pointer_default(unique)
933 interface IDropTargetHelper : IUnknown
935 HRESULT DragEnter(
936 [in] HWND hwndTarget,
937 [in] IDataObject *pDataObject,
938 [in] POINT *ppt,
939 [in] DWORD dwEffect);
941 HRESULT DragLeave();
943 HRESULT DragOver(
944 [in] POINT *ppt,
945 [in] DWORD dwEffect);
947 HRESULT Drop(
948 [in] IDataObject *pDataObject,
949 [in] POINT *ppt,
950 [in] DWORD dwEffect);
952 HRESULT Show( [in] BOOL fShow );
956 /*****************************************************************************
957 * IContextMenu interface
960 object,
961 uuid(000214e4-0000-0000-c000-000000000046),
962 pointer_default(unique)
964 interface IContextMenu : IUnknown
966 cpp_quote("#define CMF_NORMAL 0x00000000")
967 cpp_quote("#define CMF_DEFAULTONLY 0x00000001")
968 cpp_quote("#define CMF_VERBSONLY 0x00000002")
969 cpp_quote("#define CMF_EXPLORE 0x00000004")
970 cpp_quote("#define CMF_NOVERBS 0x00000008")
971 cpp_quote("#define CMF_CANRENAME 0x00000010")
972 cpp_quote("#define CMF_NODEFAULT 0x00000020")
973 cpp_quote("#define CMF_INCLUDESTATIC 0x00000040")
974 cpp_quote("#define CMF_EXTENDEDVERBS 0x00000100")
975 cpp_quote("#define CMF_RESERVED 0xffff0000")
977 cpp_quote("#define GCS_VERBA 0x00000000")
978 cpp_quote("#define GCS_HELPTEXTA 0x00000001")
979 cpp_quote("#define GCS_VALIDATEA 0x00000002")
980 cpp_quote("#define GCS_VERBW 0x00000004")
981 cpp_quote("#define GCS_HELPTEXTW 0x00000005")
982 cpp_quote("#define GCS_VALIDATEW 0x00000006")
983 cpp_quote("#define GCS_UNICODE 0x00000004")
984 cpp_quote("#define GCS_VERB WINELIB_NAME_AW(GCS_VERB)")
985 cpp_quote("#define GCS_HELPTEXT WINELIB_NAME_AW(GCS_HELPTEXT)")
986 cpp_quote("#define GCS_VALIDATE WINELIB_NAME_AW(GCS_VALIDATE)")
988 cpp_quote("#define CMDSTR_NEWFOLDERA \"NewFolder\"")
989 cpp_quote("#define CMDSTR_VIEWLISTA \"ViewList\"")
990 cpp_quote("#define CMDSTR_VIEWDETAILSA \"ViewDetails\"")
991 cpp_quote("#if defined(__GNUC__)")
992 cpp_quote("# define CMDSTR_NEWFOLDERW (const WCHAR []){ 'N','e','w','F','o','l','d','e','r',0 }")
993 cpp_quote("# define CMDSTR_VIEWLISTW (const WCHAR []){ 'V','i','e','w','L','i','s','t',0 }")
994 cpp_quote("# define CMDSTR_VIEWDETAILSW (const WCHAR []){ 'V','i','e','w','D','e','t','a','i','l','s',0 }")
995 cpp_quote("#elif defined(_MSC_VER)")
996 cpp_quote("# define CMDSTR_NEWFOLDERW L\"NewFolder\"")
997 cpp_quote("# define CMDSTR_VIEWLISTW L\"ViewList\"")
998 cpp_quote("# define CMDSTR_VIEWDETAILSW L\"ViewDetails\"")
999 cpp_quote("#else")
1000 cpp_quote("static const WCHAR CMDSTR_NEWFOLDERW[] = {'N','e','w','F','o','l','d','e','r',0};")
1001 cpp_quote("static const WCHAR CMDSTR_VIEWLISTW [] = {'V','i','e','w','L','i','s','t',0};")
1002 cpp_quote("static const WCHAR CMDSTR_VIEWDETAILSW[] = {'V','i','e','w','D','e','t','a','i','l','s',0};")
1003 cpp_quote("#endif")
1004 cpp_quote("#define CMDSTR_NEWFOLDER WINELIB_NAME_AW(CMDSTR_NEWFOLDER)")
1005 cpp_quote("#define CMDSTR_VIEWLIST WINELIB_NAME_AW(CMDSTR_VIEWLIST)")
1006 cpp_quote("#define CMDSTR_VIEWDETAILS WINELIB_NAME_AW(CMDSTR_VIEWDETAILS)")
1008 cpp_quote("#define CMIC_MASK_HOTKEY SEE_MASK_HOTKEY")
1009 cpp_quote("#define CMIC_MASK_ICON SEE_MASK_ICON")
1010 cpp_quote("#define CMIC_MASK_FLAG_NO_UI SEE_MASK_FLAG_NO_UI")
1011 cpp_quote("#define CMIC_MASK_UNICODE SEE_MASK_UNICODE")
1012 cpp_quote("#define CMIC_MASK_NO_CONSOLE SEE_MASK_NO_CONSOLE")
1013 cpp_quote("#define CMIC_MASK_HASLINKNAME SEE_MASK_HASLINKNAME")
1014 cpp_quote("#define CMIC_MASK_FLAG_SEP_VDM SEE_MASK_FLAG_SEPVDM")
1015 cpp_quote("#define CMIC_MASK_HASTITLE SEE_MASK_HASTITLE")
1016 cpp_quote("#define CMIC_MASK_ASYNCOK SEE_MASK_ASYNCOK")
1017 cpp_quote("#define CMIC_MASK_SHIFT_DOWN 0x10000000")
1018 cpp_quote("#define CMIC_MASK_PTINVOKE 0x20000000")
1019 cpp_quote("#define CMIC_MASK_CONTROL_DOWN 0x40000000")
1020 cpp_quote("#define CMIC_MASK_FLAG_LOG_USAGE SEE_MASK_FLAG_LOG_USAGE")
1021 cpp_quote("#define CMIC_MASK_NOZONECHECKS SEE_MASK_NOZONECHECKS")
1023 typedef IContextMenu *LPCONTEXTMENU;
1025 typedef struct tagCMINVOKECOMMANDINFO
1027 DWORD cbSize;
1028 DWORD fMask;
1029 HWND hwnd;
1030 LPCSTR lpVerb;
1031 LPCSTR lpParameters;
1032 LPCSTR lpDirectory;
1033 INT nShow;
1034 DWORD dwHotKey;
1035 HANDLE hIcon;
1036 } CMINVOKECOMMANDINFO, *LPCMINVOKECOMMANDINFO;
1038 typedef struct tagCMInvokeCommandInfoEx
1040 DWORD cbSize;
1041 DWORD fMask;
1042 HWND hwnd;
1043 LPCSTR lpVerb;
1044 LPCSTR lpParameters;
1045 LPCSTR lpDirectory;
1046 INT nShow;
1047 DWORD dwHotKey;
1048 HANDLE hIcon;
1049 LPCSTR lpTitle;
1050 LPCWSTR lpVerbW;
1051 LPCWSTR lpParametersW;
1052 LPCWSTR lpDirectoryW;
1053 LPCWSTR lpTitleW;
1054 POINT ptInvoke;
1055 } CMINVOKECOMMANDINFOEX, *LPCMINVOKECOMMANDINFOEX;
1057 HRESULT QueryContextMenu(
1058 [in] HMENU hmenu,
1059 [in] UINT indexMenu,
1060 [in] UINT idCmdFirst,
1061 [in] UINT idCmdLast,
1062 [in] UINT uFlags);
1064 HRESULT InvokeCommand( [in] LPCMINVOKECOMMANDINFO lpici );
1066 HRESULT GetCommandString(
1067 [in] UINT_PTR idCmd,
1068 [in] UINT uType,
1069 [out] UINT *pwReserved,
1070 [out, size_is(cchMax)] LPSTR pszName,
1071 [in] UINT cchMax);
1075 /*****************************************************************************
1076 * IContextMenu2 interface
1079 object,
1080 uuid(000214f4-0000-0000-c000-000000000046),
1081 pointer_default(unique)
1083 interface IContextMenu2 : IContextMenu
1085 typedef IContextMenu2 *LPCONTEXTMENU2;
1087 HRESULT HandleMenuMsg(
1088 [in] UINT uMsg,
1089 [in] WPARAM wParam,
1090 [in] LPARAM lParam);
1094 /*****************************************************************************
1095 * IContextMenu3 interface
1098 object,
1099 uuid(bcfce0a0-ec17-11d0-8d10-00a0c90f2719),
1100 pointer_default(unique)
1102 interface IContextMenu3 : IContextMenu2
1104 typedef IContextMenu3 *LPCONTEXTMENU3;
1106 HRESULT HandleMenuMsg2(
1107 [in] UINT uMsg,
1108 [in] WPARAM wParam,
1109 [in] LPARAM lParam,
1110 [out] LRESULT *plResult);
1114 /*****************************************************************************
1115 * IShellExecuteHookA interface
1118 object,
1119 uuid(000214f5-0000-0000-c000-000000000046),
1120 pointer_default(unique)
1122 interface IShellExecuteHookA : IUnknown
1124 cpp_quote("struct _SHELLEXECUTEINFOA;")
1125 HRESULT Execute(
1126 [in, out] struct _SHELLEXECUTEINFOA* pei);
1130 /*****************************************************************************
1131 * IShellExecuteHookW interface
1134 object,
1135 uuid(000214fb-0000-0000-c000-000000000046),
1136 pointer_default(unique)
1138 interface IShellExecuteHookW : IUnknown
1140 cpp_quote("struct _SHELLEXECUTEINFOW;")
1141 HRESULT Execute(
1142 [in, out] struct _SHELLEXECUTEINFOW* pei);
1145 /*****************************************************************************
1146 * IShellLinkDataList interface
1149 object,
1150 uuid(45e2b4ae-b1c3-11d0-b92f-00a0c90312e1),
1151 pointer_default(unique)
1153 interface IShellLinkDataList : IUnknown
1155 HRESULT AddDataBlock(
1156 [in] void *pDataBlock);
1157 HRESULT CopyDataBlock(
1158 [in] DWORD dwSig,
1159 [out] void **ppDataBlock);
1160 HRESULT RemoveDataBlock(
1161 [in] DWORD dwSig);
1162 HRESULT GetFlags(
1163 [out] DWORD *pdwFlags);
1164 HRESULT SetFlags(
1165 [in] DWORD dwFlags);
1169 /*****************************************************************************
1170 * IResolveShellLink interface
1173 object,
1174 uuid(5cd52983-9449-11d2-963a-00c04f79adf0),
1175 pointer_default(unique)
1177 interface IResolveShellLink : IUnknown
1179 HRESULT ResolveShellLink(
1180 [in] IUnknown *punk,
1181 [in] HWND hwnd,
1182 [in] DWORD fFlags);
1186 /*****************************************************************************
1187 * IURLSearchHook interface
1190 object,
1191 uuid(ac60f6a0-0fd9-11d0-99cb-00c04fd64497),
1192 pointer_default(unique)
1194 interface IURLSearchHook : IUnknown
1196 HRESULT Translate(
1197 [in, out] LPWSTR lpwszSearchURL,
1198 [in] DWORD cchBufferSize);
1202 /*****************************************************************************
1203 * ISearchContext interface
1206 object,
1207 uuid(09f656a2-41af-480c-88f7-16cc0d164615),
1208 pointer_default(unique)
1210 interface ISearchContext : IUnknown
1212 HRESULT GetSearchUrl(
1213 [in] BSTR *pbstrSearchUrl);
1214 HRESULT GetSearchText(
1215 [in] BSTR *pbstrSearchText);
1216 HRESULT GetSearchStyle(
1217 [in] BSTR *pdwSearchStyle);
1221 /*****************************************************************************
1222 * IURLSearchHook2 interface
1225 object,
1226 uuid(5ee44da4-6d32-46e3-86bc-07540dedd0e0),
1227 pointer_default(unique)
1229 interface IURLSearchHook2 : IURLSearchHook
1231 HRESULT TranslateWithSearchContext(
1232 [in, out] LPWSTR lpwszSearchURL,
1233 [in] DWORD cchBufferSize,
1234 [in] ISearchContext *pSearchContext);
1238 cpp_quote("#define INewShortcutHook WINELIB_NAME_AW(INewShortcutHook)")
1240 /*****************************************************************************
1241 * INewShortcutHookA interface
1244 object,
1245 uuid(000214e1-0000-0000-c000-000000000046),
1246 pointer_default(unique)
1248 interface INewShortcutHookA : IUnknown
1250 HRESULT SetReferent(
1251 [in] LPCSTR pcszReferent,
1252 [in] HWND hwnd);
1253 HRESULT GetReferent(
1254 [out] LPCSTR pcszReferent,
1255 [in] int cchReferent);
1256 HRESULT SetFolder(
1257 [in] LPCSTR pcszReferent);
1258 HRESULT GetFolder(
1259 [out] LPSTR pcszReferent,
1260 [in] int cchFolder);
1261 HRESULT GetName(
1262 [out] LPSTR pszName,
1263 [in] int cchName);
1264 HRESULT GetExtension(
1265 [out] LPSTR pszExtension,
1266 [in] int cchExtension);
1270 /*****************************************************************************
1271 * INewShortcutHookW interface
1274 object,
1275 uuid(000214f7-0000-0000-c000-000000000046),
1276 pointer_default(unique)
1278 interface INewShortcutHookW : IUnknown
1280 HRESULT SetReferent(
1281 [in] LPCWSTR pcszReferent,
1282 [in] HWND hwnd);
1283 HRESULT GetReferent(
1284 [out] LPCWSTR pcszReferent,
1285 [in] int cchReferent);
1286 HRESULT SetFolder(
1287 [in] LPCWSTR pcszReferent);
1288 HRESULT GetFolder(
1289 [out] LPWSTR pcszReferent,
1290 [in] int cchFolder);
1291 HRESULT GetName(
1292 [out] LPWSTR pszName,
1293 [in] int cchName);
1294 HRESULT GetExtension(
1295 [out] LPWSTR pszExtension,
1296 [in] int cchExtension);
1300 /*****************************************************************************
1301 * IShellChangeNotify interface
1304 object,
1305 uuid(d82be2b1-5764-11d0-a96e-00c04fd705a2),
1306 pointer_default(unique)
1308 interface IShellChangeNotify : IUnknown
1310 HRESULT OnChange(
1311 [in] LONG lEvent,
1312 [in] LPCITEMIDLIST pidl1,
1313 [in] LPCITEMIDLIST pidl2);
1316 /*****************************************************************************
1317 * IFileSystemBindData interface
1320 object,
1321 uuid(01e18d10-4d8b-11d2-855d-006008059367),
1322 pointer_default(unique)
1324 interface IFileSystemBindData : IUnknown
1326 HRESULT SetFindData(
1327 [in] const WIN32_FIND_DATAW *pfd);
1328 HRESULT GetFindData(
1329 [out] WIN32_FIND_DATAW *pfd);