dsound: Simplify IDirectSoundBufferImpl_GetCurrentPosition.
[wine/multimedia.git] / include / shobjidl.idl
blob474b2643918ac53985083bfcbd7c841488c3960c
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 "shtypes.idl";
26 import "servprov.idl";
27 import "comcat.idl";
28 import "propidl.idl";
29 /*import "prsht.idl";*/
30 /*import "msxml.idl";*/
33 /*****************************************************************************
34 * IPersistFolder interface
37 object,
38 uuid(000214ea-0000-0000-c000-000000000046),
39 pointer_default(unique)
41 interface IPersistFolder : IPersist
43 typedef IPersistFolder *LPPERSISTFOLDER;
45 HRESULT Initialize( [in] LPCITEMIDLIST pidl );
49 /*****************************************************************************
50 * IPersistFolder2 interface
53 object,
54 uuid(1ac3d9f0-175c-11d1-95be-00609797ea4f),
55 pointer_default(unique)
57 interface IPersistFolder2 : IPersistFolder
59 typedef IPersistFolder2 *LPPERSISTFOLDER2;
61 HRESULT GetCurFolder( [out] LPITEMIDLIST *ppidl );
65 /*****************************************************************************
66 * IEnumIDList interface
69 object,
70 uuid(000214f2-0000-0000-c000-000000000046),
71 pointer_default(unique)
73 interface IEnumIDList : IUnknown
75 typedef IEnumIDList *LPENUMIDLIST;
77 HRESULT Next(
78 [in] ULONG celt,
79 [out, size_is(celt), length_is(*pceltFetched)] LPITEMIDLIST *rgelt,
80 [out] ULONG *pceltFetched);
82 HRESULT Skip( [in] ULONG celt );
83 HRESULT Reset();
84 HRESULT Clone( [out] IEnumIDList **ppenum );
87 /*****************************************************************************
88 * IShellPropSheetExt interface
90 cpp_quote("#if 0")
91 typedef LPARAM LPFNSVADDPROPSHEETPAGE;
92 cpp_quote("#else")
93 cpp_quote("#include <prsht.h>")
94 cpp_quote("typedef LPFNADDPROPSHEETPAGE LPFNSVADDPROPSHEETPAGE;")
95 cpp_quote("#endif")
98 object,
99 uuid(000214E9-0000-0000-C000-000000000046),
100 pointer_default(unique)
102 interface IShellPropSheetExt : IUnknown
104 enum tagSHELLPROPSHEETEXTPAGEID {
105 EXPPS_FILETYPES = 0x1
108 typedef UINT EXPPS;
110 HRESULT AddPages(
111 [in] LPFNSVADDPROPSHEETPAGE pfnAddPage,
112 [in] LPARAM lParam);
113 HRESULT ReplacePage(
114 [in] EXPPS uPageID,
115 [in] LPFNSVADDPROPSHEETPAGE pfnReplaceWith,
116 [in] LPARAM lParam);
118 typedef IShellPropSheetExt *LPSHELLPROPSHEETEXT;
120 /*****************************************************************************
121 * IShellFolder interface
124 object,
125 uuid(000214e6-0000-0000-c000-000000000046),
126 pointer_default(unique)
128 interface IShellFolder : IUnknown
130 typedef IShellFolder * LPSHELLFOLDER;
132 typedef enum tagSHGDN
134 SHGDN_NORMAL = 0,
135 SHGDN_INFOLDER = 1,
136 SHGDN_FOREDITING = 0x1000,
137 SHGDN_INCLUDE_NONFILESYS = 0x2000,
138 SHGDN_FORADDRESSBAR = 0x4000,
139 SHGDN_FORPARSING = 0x8000
140 } SHGNO;
142 typedef DWORD SHGDNF;
144 enum tagSHCONTF
146 SHCONTF_FOLDERS = 32,
147 SHCONTF_NONFOLDERS = 64,
148 SHCONTF_INCLUDEHIDDEN = 128,
149 SHCONTF_INIT_ON_FIRST_NEXT = 256,
150 SHCONTF_NETPRINTERSRCH = 512,
151 SHCONTF_SHAREABLE = 1024,
152 SHCONTF_STORAGE = 2048
155 typedef DWORD SHCONTF;
157 cpp_quote("#define SFGAO_CANCOPY DROPEFFECT_COPY")
158 cpp_quote("#define SFGAO_CANMOVE DROPEFFECT_MOVE")
159 cpp_quote("#define SFGAO_CANLINK DROPEFFECT_LINK")
160 cpp_quote("#define SFGAO_STORAGE 0x00000008L")
161 cpp_quote("#define SFGAO_CANRENAME 0x00000010L")
162 cpp_quote("#define SFGAO_CANDELETE 0x00000020L")
163 cpp_quote("#define SFGAO_HASPROPSHEET 0x00000040L")
164 cpp_quote("#define SFGAO_DROPTARGET 0x00000100L")
165 cpp_quote("#define SFGAO_CAPABILITYMASK 0x00000177L")
166 cpp_quote("#define SFGAO_ENCRYPTED 0x00002000L")
167 cpp_quote("#define SFGAO_ISSLOW 0x00004000L")
168 cpp_quote("#define SFGAO_GHOSTED 0x00008000L")
169 cpp_quote("#define SFGAO_LINK 0x00010000L")
170 cpp_quote("#define SFGAO_SHARE 0x00020000L")
171 cpp_quote("#define SFGAO_READONLY 0x00040000L")
172 cpp_quote("#define SFGAO_HIDDEN 0x00080000L")
173 cpp_quote("#define SFGAO_DISPLAYATTRMASK 0x000FC000L")
174 cpp_quote("#define SFGAO_FILESYSANCESTOR 0x10000000L")
175 cpp_quote("#define SFGAO_FOLDER 0x20000000L")
176 cpp_quote("#define SFGAO_FILESYSTEM 0x40000000L")
177 cpp_quote("#define SFGAO_HASSUBFOLDER 0x80000000L")
178 cpp_quote("#define SFGAO_CONTENTSMASK 0x80000000L")
179 cpp_quote("#define SFGAO_VALIDATE 0x01000000L")
180 cpp_quote("#define SFGAO_REMOVABLE 0x02000000L")
181 cpp_quote("#define SFGAO_COMPRESSED 0x04000000L")
182 cpp_quote("#define SFGAO_BROWSABLE 0x08000000L")
183 cpp_quote("#define SFGAO_NONENUMERATED 0x00100000L")
184 cpp_quote("#define SFGAO_NEWCONTENT 0x00200000L")
185 cpp_quote("#define SFGAO_STREAM 0x00400000L")
186 cpp_quote("#define SFGAO_STORAGEANCESTOR 0x00800000L")
188 typedef ULONG SFGAOF;
190 HRESULT ParseDisplayName(
191 [in] HWND hwndOwner,
192 [in] LPBC pbcReserved,
193 [in, string] LPOLESTR lpszDisplayName,
194 [out] ULONG *pchEaten,
195 [out] LPITEMIDLIST *ppidl,
196 [in, out, unique] ULONG *pdwAttributes);
198 HRESULT EnumObjects(
199 [in] HWND hwndOwner,
200 [in] SHCONTF grfFlags,
201 [out] IEnumIDList **ppenumIDList);
203 HRESULT BindToObject(
204 [in] LPCITEMIDLIST pidl,
205 [in] LPBC pbcReserved,
206 [in] REFIID riid,
207 [out, iid_is(riid)] void **ppvOut);
209 HRESULT BindToStorage(
210 [in] LPCITEMIDLIST pidl,
211 [in] LPBC pbcReserved,
212 [in] REFIID riid,
213 [out, iid_is(riid)] void **ppvObj);
215 HRESULT CompareIDs(
216 [in] LPARAM lParam,
217 [in] LPCITEMIDLIST pidl1,
218 [in] LPCITEMIDLIST pidl2);
220 HRESULT CreateViewObject(
221 [in] HWND hwndOwner,
222 [in] REFIID riid,
223 [out, iid_is(riid)] void **ppvOut);
225 HRESULT GetAttributesOf(
226 [in] UINT cidl,
227 [in, size_is(cidl)] LPCITEMIDLIST *apidl,
228 [in, out] SFGAOF *rgfInOut);
230 HRESULT GetUIObjectOf(
231 [in] HWND hwndOwner,
232 [in] UINT cidl,
233 [in, size_is(cidl)] LPCITEMIDLIST *apidl,
234 [in] REFIID riid,
235 [in, out, unique] UINT *prgfInOut,
236 [out, iid_is(riid)] void **ppvOut);
238 HRESULT GetDisplayNameOf(
239 [in] LPCITEMIDLIST pidl,
240 [in] SHGDNF uFlags,
241 [out] STRRET *lpName);
243 HRESULT SetNameOf(
244 [in] HWND hwnd,
245 [in] LPCITEMIDLIST pidl,
246 [in, string] LPCOLESTR lpszName,
247 [in] SHGDNF uFlags,
248 [out] LPITEMIDLIST *ppidlOut);
252 /*****************************************************************************
253 * IEnumExtraSearch interface
256 object,
257 uuid(0e700be1-9db6-11d1-a1ce-00c04fd75d13),
258 pointer_default(unique)
260 interface IEnumExtraSearch : IUnknown
262 typedef IEnumExtraSearch *LPENUMEXTRASEARCH;
264 typedef struct
266 GUID guidSearch;
267 WCHAR wszFriendlyName[80];
269 *WCHAR wszMenuText[80];
270 *WCHAR wszHelpText[MAX_PATH];
272 WCHAR wszUrl[2084];
274 *WCHAR wszIcon[MAX_PATH+10];
275 *WCHAR wszGreyIcon[MAX_PATH+10];
276 *WCHAR wszClrIcon[MAX_PATH+10];
278 } EXTRASEARCH, *LPEXTRASEARCH;
280 HRESULT Next(
281 [in] ULONG celt,
282 [out, size_is(celt), length_is(*pceltFetched)] EXTRASEARCH *rgelt,
283 [out] ULONG *pceltFetched);
285 HRESULT Skip( [in] ULONG celt );
286 HRESULT Reset();
287 HRESULT Clone( [out] IEnumExtraSearch **ppenum );
291 /*****************************************************************************
292 * IShellFolder2 interface
295 object,
296 uuid(93f2f68c-1d1b-11d3-a30e-00c04f79abd1),
297 pointer_default(unique)
299 interface IShellFolder2 : IShellFolder
301 typedef enum
303 SHCOLSTATE_TYPE_STR = 0x00000001,
304 SHCOLSTATE_TYPE_INT = 0x00000002,
305 SHCOLSTATE_TYPE_DATE = 0x00000003,
306 SHCOLSTATE_TYPEMASK = 0x0000000f,
307 SHCOLSTATE_ONBYDEFAULT = 0x00000010,
308 SHCOLSTATE_SLOW = 0x00000020,
309 SHCOLSTATE_EXTENDED = 0x00000040,
310 SHCOLSTATE_SECONDARYUI = 0x00000080,
311 SHCOLSTATE_HIDDEN = 0x00000100,
312 SHCOLSTATE_PREFER_VARCMP = 0x00000200
313 } SHCOLSTATE;
315 typedef DWORD SHCOLSTATEF;
317 typedef struct
319 GUID fmtid;
320 DWORD pid;
321 } SHCOLUMNID, *LPSHCOLUMNID;
322 typedef const SHCOLUMNID *LPCSHCOLUMNID;
324 HRESULT GetDefaultSearchGUID( [out] GUID *lpguid );
325 HRESULT EnumSearches( [out] IEnumExtraSearch **ppenum );
326 HRESULT GetDefaultColumn( [in] DWORD dwReserved, [out] ULONG *pSort, [out] ULONG *pDisplay );
327 HRESULT GetDefaultColumnState( [in] UINT iColumn, [out] SHCOLSTATEF *pcsFlags );
328 HRESULT GetDetailsEx( [in] LPCITEMIDLIST pidl, [in] const SHCOLUMNID *pscid, [out] VARIANT *pv);
329 HRESULT GetDetailsOf( [in] LPCITEMIDLIST pidl, [in] UINT iColumn, [out] SHELLDETAILS *psd);
330 HRESULT MapColumnToSCID( [in] UINT iColumn, [in] SHCOLUMNID *pscid );
335 /*****************************************************************************
336 * FOLDERSETTINGS
338 typedef char *LPVIEWSETTINGS;
340 typedef enum
342 FWF_AUTOARRANGE = 0x00000001,
343 FWF_ABBREVIATEDNAMES = 0x00000002,
344 FWF_SNAPTOGRID = 0x00000004,
345 FWF_OWNERDATA = 0x00000008,
346 FWF_BESTFITWINDOW = 0x00000010,
347 FWF_DESKTOP = 0x00000020,
348 FWF_SINGLESEL = 0x00000040,
349 FWF_NOSUBFOLDERS = 0x00000080,
350 FWF_TRANSPARENT = 0x00000100,
351 FWF_NOCLIENTEDGE = 0x00000200,
352 FWF_NOSCROLL = 0x00000400,
353 FWF_ALIGNLEFT = 0x00000800,
354 FWF_NOICONS = 0x00001000,
355 FWF_SHOWSELALWAYS = 0x00002000,
356 FWF_NOVISIBLE = 0x00004000,
357 FWF_SINGLECLICKACTIVATE = 0x00008000,
358 FWF_NOWEBVIEW = 0x00010000,
359 FWF_HIDEFILENAMES = 0x00020000,
360 FWF_CHECKSELECT = 0x00040000
361 } FOLDERFLAGS;
363 typedef enum
365 FVM_ICON = 1,
366 FVM_FIRST = FVM_ICON,
367 FVM_SMALLICON = 2,
368 FVM_LIST = 3,
369 FVM_DETAILS = 4,
370 FVM_THUMBNAIL = 5,
371 FVM_TILE = 6,
372 FVM_THUMBSTRIP = 7,
373 FVM_LAST = FVM_THUMBSTRIP
374 } FOLDERVIEWMODE;
376 typedef struct
378 UINT ViewMode;
379 UINT fFlags;
380 } FOLDERSETTINGS, *PFOLDERSETTINGS, *LPFOLDERSETTINGS;
381 typedef const FOLDERSETTINGS *LPCFOLDERSETTINGS;
384 /*****************************************************************************
385 * IShellView interface
387 interface IShellBrowser; /* forward declaration */
389 object,
390 uuid(000214e3-0000-0000-c000-000000000046),
391 pointer_default(unique)
393 interface IShellView : IOleWindow
395 typedef IShellView *LPSHELLVIEW;
397 cpp_quote("#define SVSI_DESELECT 0x00000000")
398 cpp_quote("#define SVSI_SELECT 0x00000001")
399 cpp_quote("#define SVSI_EDIT 0x00000003")
400 cpp_quote("#define SVSI_DESELECTOTHERS 0x00000004")
401 cpp_quote("#define SVSI_ENSUREVISIBLE 0x00000008")
402 cpp_quote("#define SVSI_FOCUSED 0x00000010")
403 cpp_quote("#define SVSI_TRANSLATEPT 0x00000020")
404 cpp_quote("#define SVSI_SELECTIONMARK 0x00000040")
405 cpp_quote("#define SVSI_POSITIONITEM 0x00000080")
406 cpp_quote("#define SVSI_CHECK 0x00000100")
407 cpp_quote("#define SVSI_NOSTATECHANGE 0x80000000")
409 typedef UINT SVSIF;
411 typedef enum
413 SVGIO_BACKGROUND = 0x00000000,
414 SVGIO_SELECTION = 0x00000001,
415 SVGIO_ALLVIEW = 0x00000002,
416 SVGIO_CHECKED = 0x00000003,
417 SVGIO_TYPE_MASK = 0x0000000f,
418 SVGIO_FLAG_VIEWORDER = 0x80000000,
419 } SVGIO;
421 typedef enum
423 SVUIA_DEACTIVATE = 0,
424 SVUIA_ACTIVATE_NOFOCUS = 1,
425 SVUIA_ACTIVATE_FOCUS = 2,
426 SVUIA_INPLACEACTIVATE = 3
427 } SVUIA_STATUS;
429 HRESULT TranslateAccelerator( [in] MSG *pmsg );
430 HRESULT EnableModeless( [in] BOOL fEnable );
431 HRESULT UIActivate( [in] UINT uState );
432 HRESULT Refresh();
433 HRESULT CreateViewWindow(
434 [in] IShellView *psvPrevious,
435 [in] LPCFOLDERSETTINGS lpfs,
436 [in] IShellBrowser *psb,
437 [out] RECT *prcView,
438 [out] HWND *phWnd);
440 HRESULT DestroyViewWindow();
441 HRESULT GetCurrentInfo( [out] LPFOLDERSETTINGS lpfs );
443 [local] HRESULT AddPropertySheetPages(
444 [in] DWORD dwReserved,
445 [in] LPFNSVADDPROPSHEETPAGE pfn,
446 [in] LPARAM lparam);
448 HRESULT SaveViewState();
449 HRESULT SelectItem(
450 [in] LPCITEMIDLIST pidlItem,
451 [in] SVSIF uFlags);
452 HRESULT GetItemObject(
453 [in] UINT uItem,
454 [in] REFIID riid,
455 [out, iid_is(riid)] void **ppv);
459 /*****************************************************************************
460 * IShellBrowser interface
463 object,
464 uuid(000214e2-0000-0000-c000-000000000046),
465 pointer_default(unique)
467 interface IShellBrowser : IOleWindow
469 typedef IShellBrowser *LPSHELLBROWSER;
471 cpp_quote("#define SBSP_DEFBROWSER 0x00000000")
472 cpp_quote("#define SBSP_SAMEBROWSER 0x00000001")
473 cpp_quote("#define SBSP_NEWBROWSER 0x00000002")
474 cpp_quote("#define SBSP_DEFMODE 0x00000000")
475 cpp_quote("#define SBSP_OPENMODE 0x00000010")
476 cpp_quote("#define SBSP_EXPLOREMODE 0x00000020")
477 cpp_quote("#define SBSP_HELPMODE 0x00000040")
478 cpp_quote("#define SBSP_NOTRANSFERHIST 0x00000080")
479 cpp_quote("#define SBSP_ABSOLUTE 0x00000000")
480 cpp_quote("#define SBSP_RELATIVE 0x00001000")
481 cpp_quote("#define SBSP_PARENT 0x00002000")
482 cpp_quote("#define SBSP_NAVIGATEBACK 0x00004000")
483 cpp_quote("#define SBSP_NAVIGATEFORWARD 0x00008000")
484 cpp_quote("#define SBSP_ALLOW_AUTONAVIGATE 0x00010000")
485 cpp_quote("#define SBSP_NOAUTOSELECT 0x04000000")
486 cpp_quote("#define SBSP_WRITENOHISTORY 0x08000000")
487 cpp_quote("#define SBSP_REDIRECT 0x40000000")
488 cpp_quote("#define SBSP_INITIATEDBYHLINKFRAME 0x80000000")
490 cpp_quote("#define FCW_STATUS 0x0001")
491 cpp_quote("#define FCW_TOOLBAR 0x0002")
492 cpp_quote("#define FCW_TREE 0x0003")
493 cpp_quote("#define FCW_INTERNETBAR 0x0006")
494 cpp_quote("#define FCW_PROGRESS 0x0008")
496 cpp_quote("#define FCT_MERGE 0x0001")
497 cpp_quote("#define FCT_CONFIGABLE 0x0002")
498 cpp_quote("#define FCT_ADDTOEND 0x0004")
500 cpp_quote("#if 0")
501 typedef LPARAM LPTBBUTTONSB;
502 cpp_quote("#else")
503 cpp_quote("#include <commctrl.h>")
504 cpp_quote("typedef LPTBBUTTON LPTBBUTTONSB;")
505 cpp_quote("#endif")
507 HRESULT InsertMenusSB(
508 [in] HMENU hmenuShared,
509 [in, out] LPOLEMENUGROUPWIDTHS lpMenuWidths);
511 HRESULT SetMenuSB(
512 [in] HMENU hmenuShared,
513 [in] HOLEMENU holemenuReserved,
514 [in] HWND hwndActiveObject);
516 HRESULT RemoveMenusSB( [in] HMENU hmenuShared );
517 HRESULT SetStatusTextSB( [in, unique] LPCOLESTR pszStatusText );
518 HRESULT EnableModelessSB( [in] BOOL fEnable );
519 HRESULT TranslateAcceleratorSB( [in] MSG *pmsg, [in] WORD wID );
521 HRESULT BrowseObject(
522 [in] LPCITEMIDLIST pidl,
523 [in] UINT wFlags);
525 HRESULT GetViewStateStream(
526 [in] DWORD grfMode,
527 [out] IStream **ppStrm);
529 HRESULT GetControlWindow(
530 [in] UINT id,
531 [out] HWND *phwnd);
533 [local] HRESULT SendControlMsg(
534 [in] UINT id,
535 [in] UINT uMsg,
536 [in] WPARAM wParam,
537 [in] LPARAM lParam,
538 [in] LRESULT *pret);
540 HRESULT QueryActiveShellView( [out] IShellView **ppshv );
541 HRESULT OnViewWindowActive( [in] IShellView *pshv );
543 [local]
544 HRESULT SetToolbarItems(
545 [in] LPTBBUTTONSB lpButtons,
546 [in] UINT nButtons,
547 [in] UINT uFlags);
551 /*****************************************************************************
552 * IShellLinkA interface
555 object,
556 uuid(000214ee-0000-0000-c000-000000000046),
557 pointer_default(unique)
559 interface IShellLinkA : IUnknown
561 typedef enum
563 SLR_NO_UI = 0x0001,
564 SLR_ANY_MATCH = 0x0002,
565 SLR_UPDATE = 0x0004,
566 SLR_NOUPDATE = 0x0008,
567 SLR_NOSEARCH = 0x0010,
568 SLR_NOTRACK = 0x0020,
569 SLR_NOLINKINFO = 0x0040,
570 SLR_INVOKE_MSI = 0x0080,
571 SLR_NO_UI_WITH_MSG_PUMP = 0x0101,
572 } SLR_FLAGS;
574 typedef enum
576 SLGP_SHORTPATH = 0x0001,
577 SLGP_UNCPRIORITY = 0x0002,
578 SLGP_RAWPATH = 0x0004,
579 } SLGP_FLAGS;
581 HRESULT GetPath(
582 [out, size_is(cch)] LPSTR pszFile,
583 [in] int cch,
584 [in, out] WIN32_FIND_DATAA *pfd,
585 [in] DWORD fFlags);
587 HRESULT GetIDList( [out] LPITEMIDLIST * ppidl );
589 HRESULT SetIDList( [in] LPCITEMIDLIST pidl );
591 HRESULT GetDescription(
592 [out, size_is(cch)] LPSTR pszName,
593 [in] int cch);
595 HRESULT SetDescription( [in] LPCSTR pszName );
597 HRESULT GetWorkingDirectory(
598 [out, size_is(cch)] LPSTR pszDir,
599 [in] int cch);
601 HRESULT SetWorkingDirectory( [in] LPCSTR pszDir );
603 HRESULT GetArguments(
604 [out, size_is(cch)] LPSTR pszArgs,
605 [in] int cch);
607 HRESULT SetArguments( [in] LPCSTR pszArgs );
609 HRESULT GetHotkey( [out] WORD *pwHotkey );
611 HRESULT SetHotkey( [in] WORD wHotkey );
613 HRESULT GetShowCmd( [out] int *piShowCmd );
615 HRESULT SetShowCmd( [in] int iShowCmd );
617 HRESULT GetIconLocation(
618 [out, size_is(cch)] LPSTR pszIconPath,
619 [in] int cch,
620 [out] int *piIcon);
622 HRESULT SetIconLocation(
623 [in] LPCSTR pszIconPath,
624 [in] int iIcon);
626 HRESULT SetRelativePath(
627 [in] LPCSTR pszPathRel,
628 [in] DWORD dwReserved);
630 HRESULT Resolve(
631 [in] HWND hwnd,
632 [in] DWORD fFlags);
634 HRESULT SetPath( [in] LPCSTR pszFile );
638 /*****************************************************************************
639 * IShellLinkW interface
642 object,
643 uuid(000214f9-0000-0000-c000-000000000046),
644 pointer_default(unique)
646 interface IShellLinkW : IUnknown
648 HRESULT GetPath(
649 [out, size_is(cch)] LPWSTR pszFile,
650 [in] int cch,
651 [in, out] WIN32_FIND_DATAW *pfd,
652 [in] DWORD fFlags);
654 HRESULT GetIDList( [out] LPITEMIDLIST * ppidl );
656 HRESULT SetIDList( [in] LPCITEMIDLIST pidl );
658 HRESULT GetDescription(
659 [out, size_is(cch)] LPWSTR pszName,
660 [in] int cch);
662 HRESULT SetDescription( [in] LPCWSTR pszName );
664 HRESULT GetWorkingDirectory(
665 [out, size_is(cch)] LPWSTR pszDir,
666 [in] int cch);
668 HRESULT SetWorkingDirectory( [in] LPCWSTR pszDir );
670 HRESULT GetArguments(
671 [out, size_is(cch)] LPWSTR pszArgs,
672 [in] int cch);
674 HRESULT SetArguments( [in] LPCWSTR pszArgs );
676 HRESULT GetHotkey( [out] WORD *pwHotkey );
678 HRESULT SetHotkey( [in] WORD wHotkey );
680 HRESULT GetShowCmd( [out] int *piShowCmd );
682 HRESULT SetShowCmd( [in] int iShowCmd );
684 HRESULT GetIconLocation(
685 [out, size_is(cch)] LPWSTR pszIconPath,
686 [in] int cch,
687 [out] int *piIcon);
689 HRESULT SetIconLocation(
690 [in] LPCWSTR pszIconPath,
691 [in] int iIcon);
693 HRESULT SetRelativePath(
694 [in] LPCWSTR pszPathRel,
695 [in] DWORD dwReserved);
697 HRESULT Resolve(
698 [in] HWND hwnd,
699 [in] DWORD fFlags);
701 HRESULT SetPath( [in] LPCWSTR pszFile );
704 cpp_quote("#define IShellLink WINELIB_NAME_AW(IShellLink)")
707 /*****************************************************************************
708 * IShellExtInit interface
711 object,
712 uuid(000214e8-0000-0000-c000-000000000046),
713 pointer_default(unique)
715 interface IShellExtInit : IUnknown
717 typedef IShellExtInit *LPSHELLEXTINIT;
719 HRESULT Initialize(
720 [in] LPCITEMIDLIST pidlFolder,
721 [in] IDataObject *pdtobj,
722 [in] HKEY hkeyProgID);
726 /*******************************************************************************/
727 /* Note: the following interfaces are not in shobjidl.idl under Windows, they */
728 /* are declared directly in shlobj.h. It hopefully won't break anything to put */
729 /* them here anyway. */
730 /*******************************************************************************/
732 #ifndef MAX_PATH
733 #define MAX_PATH 260
734 #endif
737 /*****************************************************************************
738 * IPersistFolder3 interface
741 object,
742 uuid(cef04fdf-fe72-11d2-87a5-00c04f6837cf),
743 pointer_default(unique)
745 interface IPersistFolder3 : IPersistFolder2
747 typedef struct
749 LPITEMIDLIST pidlTargetFolder;
750 WCHAR szTargetParsingName[MAX_PATH];
751 WCHAR szNetworkProvider[MAX_PATH];
752 DWORD dwAttributes;
753 int csidl;
754 } PERSIST_FOLDER_TARGET_INFO;
756 HRESULT InitializeEx(
757 [in] IBindCtx *pbc,
758 [in] LPCITEMIDLIST pidlRoot,
759 [in] const PERSIST_FOLDER_TARGET_INFO *ppfti);
761 HRESULT GetFolderTargetInfo( [out] PERSIST_FOLDER_TARGET_INFO *ppfti );
765 /*****************************************************************************
766 * IExtractIconA interface
769 object,
770 uuid(000214eb-0000-0000-c000-000000000046),
771 pointer_default(unique)
773 interface IExtractIconA : IUnknown
775 cpp_quote("#define GIL_OPENICON 0x0001")
776 cpp_quote("#define GIL_FORSHELL 0x0002")
777 cpp_quote("#define GIL_ASYNC 0x0020")
778 cpp_quote("#define GIL_DEFAULTICON 0x0040")
779 cpp_quote("#define GIL_FORSHORTCUT 0x0080")
781 cpp_quote("#define GIL_SIMULATEDOC 0x0001")
782 cpp_quote("#define GIL_PERINSTANCE 0x0002")
783 cpp_quote("#define GIL_PERCLASS 0x0004")
784 cpp_quote("#define GIL_NOTFILENAME 0x0008")
785 cpp_quote("#define GIL_DONTCACHE 0x0010")
787 typedef IExtractIconA *LPEXTRACTICONA;
789 HRESULT GetIconLocation(
790 [in] UINT uFlags,
791 [out, size_is(cchMax)] LPSTR szIconFile,
792 [in] UINT cchMax,
793 [out] INT *piIndex,
794 [out] UINT *pwFlags);
796 HRESULT Extract(
797 [in] LPCSTR pszFile,
798 [in] UINT nIconIndex,
799 [out] HICON *phiconLarge,
800 [out] HICON *phiconSmall,
801 [in] UINT nIconSize );
805 /*****************************************************************************
806 * IExtractIconW interface
809 object,
810 uuid(000214fa-0000-0000-c000-000000000046),
811 pointer_default(unique)
813 interface IExtractIconW : IUnknown
815 typedef IExtractIconW *LPEXTRACTICONW;
817 HRESULT GetIconLocation(
818 [in] UINT uFlags,
819 [out, size_is(cchMax)] LPWSTR szIconFile,
820 [in] UINT cchMax,
821 [out] INT *piIndex,
822 [out] UINT *pwFlags);
824 HRESULT Extract(
825 [in] LPCWSTR pszFile,
826 [in] UINT nIconIndex,
827 [out] HICON *phiconLarge,
828 [out] HICON *phiconSmall,
829 [in] UINT nIconSize );
832 cpp_quote("#define LPEXTRACTICON WINELIB_NAME_AW(LPEXTRACTICON)")
833 cpp_quote("#define IExtractIcon WINELIB_NAME_AW(IExtractIcon)")
836 /*****************************************************************************
837 * ICommDlgBrowser interface
840 object,
841 uuid(000214f1-0000-0000-c000-000000000046),
842 pointer_default(unique)
844 interface ICommDlgBrowser : IUnknown
846 cpp_quote("#define CDBOSC_SETFOCUS 0x00000000")
847 cpp_quote("#define CDBOSC_KILLFOCUS 0x00000001")
848 cpp_quote("#define CDBOSC_SELCHANGE 0x00000002")
849 cpp_quote("#define CDBOSC_RENAME 0x00000003")
850 cpp_quote("#define CDBOSC_STATECHANGE 0x00000004")
852 typedef ICommDlgBrowser *LPCOMMDLGBROWSER;
854 HRESULT OnDefaultCommand( [in] IShellView *shv );
855 HRESULT OnStateChange( [in] IShellView *shv, [in] ULONG uChange );
856 HRESULT IncludeObject( [in] IShellView *shv, [in] LPCITEMIDLIST pidl );
860 /*****************************************************************************
861 * IDockingWindowFrame interface
864 object,
865 uuid(47d2657a-7b27-11d0-8ca9-00a0c92dbfe8),
866 pointer_default(unique)
868 interface IDockingWindowFrame : IOleWindow
870 cpp_quote("#define DWFRF_NORMAL 0x0000")
871 cpp_quote("#define DWFRF_DELETECONFIGDATA 0x0001")
872 cpp_quote("#define DWFAF_HIDDEN 0x0001")
874 HRESULT AddToolbar(
875 [in] IUnknown *punkSrc,
876 [in] LPCWSTR pwszItem,
877 [in] DWORD dwAddFlags);
879 HRESULT RemoveToolbar(
880 [in] IUnknown *punkSrc,
881 [in] DWORD dwRemoveFlags);
883 HRESULT FindToolbar(
884 [in] LPCWSTR pwszItem,
885 [in] REFIID riid,
886 [out] LPVOID *ppvObj);
890 /*****************************************************************************
891 * IDragSourceHelper interface
894 object,
895 uuid(de5bf786-477a-11d2-839d-00c04fd918d0),
896 pointer_default(unique)
898 interface IDragSourceHelper : IUnknown
900 typedef struct
902 SIZE sizeDragImage;
903 POINT ptOffset;
904 HBITMAP hbmpDragImage;
905 COLORREF crColorKey;
906 } SHDRAGIMAGE, *LPSHDRAGIMAGE;
908 HRESULT InitializeFromBitmap(
909 [in] LPSHDRAGIMAGE pshdi,
910 [in] IDataObject *pDataObject);
912 HRESULT InitializeFromWindow(
913 [in] HWND hwnd,
914 [in] POINT *ppt,
915 [in] IDataObject *pDataObject);
919 /*****************************************************************************
920 * IDropTargetHelper interface
923 object,
924 uuid(4657278b-411b-11d2-839a-00c04fd918d0),
925 pointer_default(unique)
927 interface IDropTargetHelper : IUnknown
929 HRESULT DragEnter(
930 [in] HWND hwndTarget,
931 [in] IDataObject *pDataObject,
932 [in] POINT *ppt,
933 [in] DWORD dwEffect);
935 HRESULT DragLeave();
937 HRESULT DragOver(
938 [in] POINT *ppt,
939 [in] DWORD dwEffect);
941 HRESULT Drop(
942 [in] IDataObject *pDataObject,
943 [in] POINT *ppt,
944 [in] DWORD dwEffect);
946 HRESULT Show( [in] BOOL fShow );
950 /*****************************************************************************
951 * IContextMenu interface
954 object,
955 uuid(000214e4-0000-0000-c000-000000000046),
956 pointer_default(unique)
958 interface IContextMenu : IUnknown
960 cpp_quote("#define CMF_NORMAL 0x00000000")
961 cpp_quote("#define CMF_DEFAULTONLY 0x00000001")
962 cpp_quote("#define CMF_VERBSONLY 0x00000002")
963 cpp_quote("#define CMF_EXPLORE 0x00000004")
964 cpp_quote("#define CMF_NOVERBS 0x00000008")
965 cpp_quote("#define CMF_CANRENAME 0x00000010")
966 cpp_quote("#define CMF_NODEFAULT 0x00000020")
967 cpp_quote("#define CMF_INCLUDESTATIC 0x00000040")
968 cpp_quote("#define CMF_EXTENDEDVERBS 0x00000100")
969 cpp_quote("#define CMF_RESERVED 0xffff0000")
971 cpp_quote("#define GCS_VERBA 0x00000000")
972 cpp_quote("#define GCS_HELPTEXTA 0x00000001")
973 cpp_quote("#define GCS_VALIDATEA 0x00000002")
974 cpp_quote("#define GCS_VERBW 0x00000004")
975 cpp_quote("#define GCS_HELPTEXTW 0x00000005")
976 cpp_quote("#define GCS_VALIDATEW 0x00000006")
977 cpp_quote("#define GCS_UNICODE 0x00000004")
978 cpp_quote("#define GCS_VERB WINELIB_NAME_AW(GCS_VERB)")
979 cpp_quote("#define GCS_HELPTEXT WINELIB_NAME_AW(GCS_HELPTEXT)")
980 cpp_quote("#define GCS_VALIDATE WINELIB_NAME_AW(GCS_VALIDATE)")
982 cpp_quote("#define CMDSTR_NEWFOLDERA \"NewFolder\"")
983 cpp_quote("#define CMDSTR_VIEWLISTA \"ViewList\"")
984 cpp_quote("#define CMDSTR_VIEWDETAILSA \"ViewDetails\"")
985 cpp_quote("#if defined(__GNUC__)")
986 cpp_quote("# define CMDSTR_NEWFOLDERW (const WCHAR []){ 'N','e','w','F','o','l','d','e','r',0 }")
987 cpp_quote("# define CMDSTR_VIEWLISTW (const WCHAR []){ 'V','i','e','w','L','i','s','t',0 }")
988 cpp_quote("# define CMDSTR_VIEWDETAILSW (const WCHAR []){ 'V','i','e','w','D','e','t','a','i','l','s',0 }")
989 cpp_quote("#elif defined(_MSC_VER)")
990 cpp_quote("# define CMDSTR_NEWFOLDERW L\"NewFolder\"")
991 cpp_quote("# define CMDSTR_VIEWLISTW L\"ViewList\"")
992 cpp_quote("# define CMDSTR_VIEWDETAILSW L\"ViewDetails\"")
993 cpp_quote("#else")
994 cpp_quote("static const WCHAR CMDSTR_NEWFOLDERW[] = {'N','e','w','F','o','l','d','e','r',0};")
995 cpp_quote("static const WCHAR CMDSTR_VIEWLISTW [] = {'V','i','e','w','L','i','s','t',0};")
996 cpp_quote("static const WCHAR CMDSTR_VIEWDETAILSW[] = {'V','i','e','w','D','e','t','a','i','l','s',0};")
997 cpp_quote("#endif")
998 cpp_quote("#define CMDSTR_NEWFOLDER WINELIB_NAME_AW(CMDSTR_NEWFOLDER)")
999 cpp_quote("#define CMDSTR_VIEWLIST WINELIB_NAME_AW(CMDSTR_VIEWLIST)")
1000 cpp_quote("#define CMDSTR_VIEWDETAILS WINELIB_NAME_AW(CMDSTR_VIEWDETAILS)")
1002 cpp_quote("#define CMIC_MASK_HOTKEY SEE_MASK_HOTKEY")
1003 cpp_quote("#define CMIC_MASK_ICON SEE_MASK_ICON")
1004 cpp_quote("#define CMIC_MASK_FLAG_NO_UI SEE_MASK_FLAG_NO_UI")
1005 cpp_quote("#define CMIC_MASK_UNICODE SEE_MASK_UNICODE")
1006 cpp_quote("#define CMIC_MASK_NO_CONSOLE SEE_MASK_NO_CONSOLE")
1007 cpp_quote("#define CMIC_MASK_HASLINKNAME SEE_MASK_HASLINKNAME")
1008 cpp_quote("#define CMIC_MASK_FLAG_SEP_VDM SEE_MASK_FLAG_SEPVDM")
1009 cpp_quote("#define CMIC_MASK_HASTITLE SEE_MASK_HASTITLE")
1010 cpp_quote("#define CMIC_MASK_ASYNCOK SEE_MASK_ASYNCOK")
1011 cpp_quote("#define CMIC_MASK_SHIFT_DOWN 0x10000000")
1012 cpp_quote("#define CMIC_MASK_PTINVOKE 0x20000000")
1013 cpp_quote("#define CMIC_MASK_CONTROL_DOWN 0x40000000")
1014 cpp_quote("#define CMIC_MASK_FLAG_LOG_USAGE SEE_MASK_FLAG_LOG_USAGE")
1015 cpp_quote("#define CMIC_MASK_NOZONECHECKS SEE_MASK_NOZONECHECKS")
1017 typedef IContextMenu *LPCONTEXTMENU;
1019 typedef struct tagCMINVOKECOMMANDINFO
1021 DWORD cbSize;
1022 DWORD fMask;
1023 HWND hwnd;
1024 LPCSTR lpVerb;
1025 LPCSTR lpParameters;
1026 LPCSTR lpDirectory;
1027 INT nShow;
1028 DWORD dwHotKey;
1029 HANDLE hIcon;
1030 } CMINVOKECOMMANDINFO, *LPCMINVOKECOMMANDINFO;
1032 typedef struct tagCMInvokeCommandInfoEx
1034 DWORD cbSize;
1035 DWORD fMask;
1036 HWND hwnd;
1037 LPCSTR lpVerb;
1038 LPCSTR lpParameters;
1039 LPCSTR lpDirectory;
1040 INT nShow;
1041 DWORD dwHotKey;
1042 HANDLE hIcon;
1043 LPCSTR lpTitle;
1044 LPCWSTR lpVerbW;
1045 LPCWSTR lpParametersW;
1046 LPCWSTR lpDirectoryW;
1047 LPCWSTR lpTitleW;
1048 POINT ptInvoke;
1049 } CMINVOKECOMMANDINFOEX, *LPCMINVOKECOMMANDINFOEX;
1051 HRESULT QueryContextMenu(
1052 [in] HMENU hmenu,
1053 [in] UINT indexMenu,
1054 [in] UINT idCmdFirst,
1055 [in] UINT idCmdLast,
1056 [in] UINT uFlags);
1058 HRESULT InvokeCommand( [in] LPCMINVOKECOMMANDINFO lpici );
1060 HRESULT GetCommandString(
1061 [in] UINT_PTR idCmd,
1062 [in] UINT uType,
1063 [out] UINT *pwReserved,
1064 [out, size_is(cchMax)] LPSTR pszName,
1065 [in] UINT cchMax);
1069 /*****************************************************************************
1070 * IContextMenu2 interface
1073 object,
1074 uuid(000214f4-0000-0000-c000-000000000046),
1075 pointer_default(unique)
1077 interface IContextMenu2 : IContextMenu
1079 typedef IContextMenu2 *LPCONTEXTMENU2;
1081 HRESULT HandleMenuMsg(
1082 [in] UINT uMsg,
1083 [in] WPARAM wParam,
1084 [in] LPARAM lParam);
1088 /*****************************************************************************
1089 * IContextMenu3 interface
1092 object,
1093 uuid(bcfce0a0-ec17-11d0-8d10-00a0c90f2719),
1094 pointer_default(unique)
1096 interface IContextMenu3 : IContextMenu2
1098 typedef IContextMenu3 *LPCONTEXTMENU3;
1100 HRESULT HandleMenuMsg2(
1101 [in] UINT uMsg,
1102 [in] WPARAM wParam,
1103 [in] LPARAM lParam,
1104 [out] LRESULT *plResult);
1108 /*****************************************************************************
1109 * IShellExecuteHookA interface
1112 object,
1113 uuid(000214f5-0000-0000-c000-000000000046),
1114 pointer_default(unique)
1116 interface IShellExecuteHookA : IUnknown
1118 cpp_quote("struct _SHELLEXECUTEINFOA;")
1119 HRESULT Execute(
1120 [in, out] struct _SHELLEXECUTEINFOA* pei);
1124 /*****************************************************************************
1125 * IShellExecuteHookW interface
1128 object,
1129 uuid(000214fb-0000-0000-c000-000000000046),
1130 pointer_default(unique)
1132 interface IShellExecuteHookW : IUnknown
1134 cpp_quote("struct _SHELLEXECUTEINFOW;")
1135 HRESULT Execute(
1136 [in, out] struct _SHELLEXECUTEINFOW* pei);
1139 /*****************************************************************************
1140 * IShellLinkDataList interface
1143 object,
1144 uuid(45e2b4ae-b1c3-11d0-b92f-00a0c90312e1),
1145 pointer_default(unique)
1147 interface IShellLinkDataList : IUnknown
1149 HRESULT AddDataBlock(
1150 [in] void *pDataBlock);
1151 HRESULT CopyDataBlock(
1152 [in] DWORD dwSig,
1153 [out] void **ppDataBlock);
1154 HRESULT RemoveDataBlock(
1155 [in] DWORD dwSig);
1156 HRESULT GetFlags(
1157 [out] DWORD *pdwFlags);
1158 HRESULT SetFlags(
1159 [in] DWORD dwFlags);
1163 /*****************************************************************************
1164 * IResolveShellLink interface
1167 object,
1168 uuid(5cd52983-9449-11d2-963a-00c04f79adf0),
1169 pointer_default(unique)
1171 interface IResolveShellLink : IUnknown
1173 HRESULT ResolveShellLink(
1174 [in] IUnknown *punk,
1175 [in] HWND hwnd,
1176 [in] DWORD fFlags);
1180 /*****************************************************************************
1181 * IURLSearchHook interface
1184 object,
1185 uuid(ac60f6a0-0fd9-11d0-99cb-00c04fd64497),
1186 pointer_default(unique)
1188 interface IURLSearchHook : IUnknown
1190 HRESULT Translate(
1191 [in, out] LPWSTR lpwszSearchURL,
1192 [in] DWORD cchBufferSize);
1196 /*****************************************************************************
1197 * ISearchContext interface
1200 object,
1201 uuid(09f656a2-41af-480c-88f7-16cc0d164615),
1202 pointer_default(unique)
1204 interface ISearchContext : IUnknown
1206 HRESULT GetSearchUrl(
1207 [in] BSTR *pbstrSearchUrl);
1208 HRESULT GetSearchText(
1209 [in] BSTR *pbstrSearchText);
1210 HRESULT GetSearchStyle(
1211 [in] BSTR *pdwSearchStyle);
1215 /*****************************************************************************
1216 * IURLSearchHook2 interface
1219 object,
1220 uuid(5ee44da4-6d32-46e3-86bc-07540dedd0e0),
1221 pointer_default(unique)
1223 interface IURLSearchHook2 : IURLSearchHook
1225 HRESULT TranslateWithSearchContext(
1226 [in, out] LPWSTR lpwszSearchURL,
1227 [in] DWORD cchBufferSize,
1228 [in] ISearchContext *pSearchContext);
1232 cpp_quote("#define INewShortcutHook WINELIB_NAME_AW(INewShortcutHook)")
1234 /*****************************************************************************
1235 * INewShortcutHookA interface
1238 object,
1239 uuid(000214e1-0000-0000-c000-000000000046),
1240 pointer_default(unique)
1242 interface INewShortcutHookA : IUnknown
1244 HRESULT SetReferent(
1245 [in] LPCSTR pcszReferent,
1246 [in] HWND hwnd);
1247 HRESULT GetReferent(
1248 [out] LPCSTR pcszReferent,
1249 [in] int cchReferent);
1250 HRESULT SetFolder(
1251 [in] LPCSTR pcszReferent);
1252 HRESULT GetFolder(
1253 [out] LPSTR pcszReferent,
1254 [in] int cchFolder);
1255 HRESULT GetName(
1256 [out] LPSTR pszName,
1257 [in] int cchName);
1258 HRESULT GetExtension(
1259 [out] LPSTR pszExtension,
1260 [in] int cchExtension);
1264 /*****************************************************************************
1265 * INewShortcutHookW interface
1268 object,
1269 uuid(000214f7-0000-0000-c000-000000000046),
1270 pointer_default(unique)
1272 interface INewShortcutHookW : IUnknown
1274 HRESULT SetReferent(
1275 [in] LPCWSTR pcszReferent,
1276 [in] HWND hwnd);
1277 HRESULT GetReferent(
1278 [out] LPCWSTR pcszReferent,
1279 [in] int cchReferent);
1280 HRESULT SetFolder(
1281 [in] LPCWSTR pcszReferent);
1282 HRESULT GetFolder(
1283 [out] LPWSTR pcszReferent,
1284 [in] int cchFolder);
1285 HRESULT GetName(
1286 [out] LPWSTR pszName,
1287 [in] int cchName);
1288 HRESULT GetExtension(
1289 [out] LPWSTR pszExtension,
1290 [in] int cchExtension);
1294 /*****************************************************************************
1295 * IShellChangeNotify interface
1298 object,
1299 uuid(d82be2b1-5764-11d0-a96e-00c04fd705a2),
1300 pointer_default(unique)
1302 interface IShellChangeNotify : IUnknown
1304 HRESULT OnChange(
1305 [in] LONG lEvent,
1306 [in] LPCITEMIDLIST pidl1,
1307 [in] LPCITEMIDLIST pidl2);
1310 /*****************************************************************************
1311 * IFileSystemBindData interface
1314 object,
1315 uuid(01e18d10-4d8b-11d2-855d-006008059367),
1316 pointer_default(unique)
1318 interface IFileSystemBindData : IUnknown
1320 HRESULT SetFindData(
1321 [in] const WIN32_FIND_DATAW *pfd);
1322 HRESULT GetFindData(
1323 [out] WIN32_FIND_DATAW *pfd);