gdi: Also initialize a variable in the failure case.
[wine/multimedia.git] / include / shobjidl.idl
blobce98620605ca74b492fe30d301aa664d2028c00a
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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 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 );
88 /*****************************************************************************
89 * IShellFolder interface
92 object,
93 uuid(000214e6-0000-0000-c000-000000000046),
94 pointer_default(unique)
96 interface IShellFolder : IUnknown
98 typedef IShellFolder * LPSHELLFOLDER;
100 typedef enum tagSHGDN
102 SHGDN_NORMAL = 0,
103 SHGDN_INFOLDER = 1,
104 SHGDN_FOREDITING = 0x1000,
105 SHGDN_INCLUDE_NONFILESYS = 0x2000,
106 SHGDN_FORADDRESSBAR = 0x4000,
107 SHGDN_FORPARSING = 0x8000
108 } SHGNO;
110 typedef DWORD SHGDNF;
112 enum tagSHCONTF
114 SHCONTF_FOLDERS = 32,
115 SHCONTF_NONFOLDERS = 64,
116 SHCONTF_INCLUDEHIDDEN = 128,
117 SHCONTF_INIT_ON_FIRST_NEXT = 256,
118 SHCONTF_NETPRINTERSRCH = 512,
119 SHCONTF_SHAREABLE = 1024,
120 SHCONTF_STORAGE = 2048
123 typedef DWORD SHCONTF;
125 cpp_quote("#define SFGAO_CANCOPY DROPEFFECT_COPY")
126 cpp_quote("#define SFGAO_CANMOVE DROPEFFECT_MOVE")
127 cpp_quote("#define SFGAO_CANLINK DROPEFFECT_LINK")
128 cpp_quote("#define SFGAO_STORAGE 0x00000008L")
129 cpp_quote("#define SFGAO_CANRENAME 0x00000010L")
130 cpp_quote("#define SFGAO_CANDELETE 0x00000020L")
131 cpp_quote("#define SFGAO_HASPROPSHEET 0x00000040L")
132 cpp_quote("#define SFGAO_DROPTARGET 0x00000100L")
133 cpp_quote("#define SFGAO_CAPABILITYMASK 0x00000177L")
134 cpp_quote("#define SFGAO_ENCRYPTED 0x00002000L")
135 cpp_quote("#define SFGAO_ISSLOW 0x00004000L")
136 cpp_quote("#define SFGAO_GHOSTED 0x00008000L")
137 cpp_quote("#define SFGAO_LINK 0x00010000L")
138 cpp_quote("#define SFGAO_SHARE 0x00020000L")
139 cpp_quote("#define SFGAO_READONLY 0x00040000L")
140 cpp_quote("#define SFGAO_HIDDEN 0x00080000L")
141 cpp_quote("#define SFGAO_DISPLAYATTRMASK 0x000FC000L")
142 cpp_quote("#define SFGAO_FILESYSANCESTOR 0x10000000L")
143 cpp_quote("#define SFGAO_FOLDER 0x20000000L")
144 cpp_quote("#define SFGAO_FILESYSTEM 0x40000000L")
145 cpp_quote("#define SFGAO_HASSUBFOLDER 0x80000000L")
146 cpp_quote("#define SFGAO_CONTENTSMASK 0x80000000L")
147 cpp_quote("#define SFGAO_VALIDATE 0x01000000L")
148 cpp_quote("#define SFGAO_REMOVABLE 0x02000000L")
149 cpp_quote("#define SFGAO_COMPRESSED 0x04000000L")
150 cpp_quote("#define SFGAO_BROWSABLE 0x08000000L")
151 cpp_quote("#define SFGAO_NONENUMERATED 0x00100000L")
152 cpp_quote("#define SFGAO_NEWCONTENT 0x00200000L")
153 cpp_quote("#define SFGAO_STREAM 0x00400000L")
154 cpp_quote("#define SFGAO_STORAGEANCESTOR 0x00800000L")
156 typedef ULONG SFGAOF;
158 HRESULT ParseDisplayName(
159 [in] HWND hwndOwner,
160 [in] LPBC pbcReserved,
161 [in, string] LPOLESTR lpszDisplayName,
162 [out] ULONG *pchEaten,
163 [out] LPITEMIDLIST *ppidl,
164 [in, out, unique] ULONG *pdwAttributes);
166 HRESULT EnumObjects(
167 [in] HWND hwndOwner,
168 [in] SHCONTF grfFlags,
169 [out] IEnumIDList **ppenumIDList);
171 HRESULT BindToObject(
172 [in] LPCITEMIDLIST pidl,
173 [in] LPBC pbcReserved,
174 [in] REFIID riid,
175 [out, iid_is(riid)] void **ppvOut);
177 HRESULT BindToStorage(
178 [in] LPCITEMIDLIST pidl,
179 [in] LPBC pbcReserved,
180 [in] REFIID riid,
181 [out, iid_is(riid)] void **ppvObj);
183 HRESULT CompareIDs(
184 [in] LPARAM lParam,
185 [in] LPCITEMIDLIST pidl1,
186 [in] LPCITEMIDLIST pidl2);
188 HRESULT CreateViewObject(
189 [in] HWND hwndOwner,
190 [in] REFIID riid,
191 [out, iid_is(riid)] void **ppvOut);
193 HRESULT GetAttributesOf(
194 [in] UINT cidl,
195 [in, size_is(cidl)] LPCITEMIDLIST *apidl,
196 [in, out] SFGAOF *rgfInOut);
198 HRESULT GetUIObjectOf(
199 [in] HWND hwndOwner,
200 [in] UINT cidl,
201 [in, size_is(cidl)] LPCITEMIDLIST *apidl,
202 [in] REFIID riid,
203 [in, out, unique] UINT *prgfInOut,
204 [out, iid_is(riid)] void **ppvOut);
206 HRESULT GetDisplayNameOf(
207 [in] LPCITEMIDLIST pidl,
208 [in] SHGDNF uFlags,
209 [out] STRRET *lpName);
211 HRESULT SetNameOf(
212 [in] HWND hwnd,
213 [in] LPCITEMIDLIST pidl,
214 [in, string] LPCOLESTR lpszName,
215 [in] SHGDNF uFlags,
216 [out] LPITEMIDLIST *ppidlOut);
220 /*****************************************************************************
221 * IEnumExtraSearch interface
224 object,
225 uuid(0e700be1-9db6-11d1-a1ce-00c04fd75d13),
226 pointer_default(unique)
228 interface IEnumExtraSearch : IUnknown
230 typedef IEnumExtraSearch *LPENUMEXTRASEARCH;
232 typedef struct
234 GUID guidSearch;
235 WCHAR wszFriendlyName[80];
237 *WCHAR wszMenuText[80];
238 *WCHAR wszHelpText[MAX_PATH];
240 WCHAR wszUrl[2084];
242 *WCHAR wszIcon[MAX_PATH+10];
243 *WCHAR wszGreyIcon[MAX_PATH+10];
244 *WCHAR wszClrIcon[MAX_PATH+10];
246 } EXTRASEARCH, *LPEXTRASEARCH;
248 HRESULT Next(
249 [in] ULONG celt,
250 [out, size_is(celt), length_is(*pceltFetched)] EXTRASEARCH *rgelt,
251 [out] ULONG *pceltFetched);
253 HRESULT Skip( [in] ULONG celt );
254 HRESULT Reset();
255 HRESULT Clone( [out] IEnumExtraSearch **ppenum );
259 /*****************************************************************************
260 * IShellFolder2 interface
263 object,
264 uuid(93f2f68c-1d1b-11d3-a30e-00c04f79abd1),
265 pointer_default(unique)
267 interface IShellFolder2 : IShellFolder
269 typedef enum
271 SHCOLSTATE_TYPE_STR = 0x00000001,
272 SHCOLSTATE_TYPE_INT = 0x00000002,
273 SHCOLSTATE_TYPE_DATE = 0x00000003,
274 SHCOLSTATE_TYPEMASK = 0x0000000f,
275 SHCOLSTATE_ONBYDEFAULT = 0x00000010,
276 SHCOLSTATE_SLOW = 0x00000020,
277 SHCOLSTATE_EXTENDED = 0x00000040,
278 SHCOLSTATE_SECONDARYUI = 0x00000080,
279 SHCOLSTATE_HIDDEN = 0x00000100,
280 SHCOLSTATE_PREFER_VARCMP = 0x00000200
281 } SHCOLSTATE;
283 typedef DWORD SHCOLSTATEF;
285 typedef struct
287 GUID fmtid;
288 DWORD pid;
289 } SHCOLUMNID, *LPSHCOLUMNID;
290 typedef const SHCOLUMNID *LPCSHCOLUMNID;
292 HRESULT GetDefaultSearchGUID( [out] GUID *lpguid );
293 HRESULT EnumSearches( [out] IEnumExtraSearch **ppenum );
294 HRESULT GetDefaultColumn( [in] DWORD dwReserved, [out] ULONG *pSort, [out] ULONG *pDisplay );
295 HRESULT GetDefaultColumnState( [in] UINT iColumn, [out] SHCOLSTATEF *pcsFlags );
296 HRESULT GetDetailsEx( [in] LPCITEMIDLIST pidl, [in] const SHCOLUMNID *pscid, [out] VARIANT *pv);
297 HRESULT GetDetailsOf( [in] LPCITEMIDLIST pidl, [in] UINT iColumn, [out] SHELLDETAILS *psd);
298 HRESULT MapColumnToSCID( [in] UINT iColumn, [in] SHCOLUMNID *pscid );
303 /*****************************************************************************
304 * FOLDERSETTINGS
306 typedef char *LPVIEWSETTINGS;
308 typedef enum
310 FWF_AUTOARRANGE = 0x00000001,
311 FWF_ABBREVIATEDNAMES = 0x00000002,
312 FWF_SNAPTOGRID = 0x00000004,
313 FWF_OWNERDATA = 0x00000008,
314 FWF_BESTFITWINDOW = 0x00000010,
315 FWF_DESKTOP = 0x00000020,
316 FWF_SINGLESEL = 0x00000040,
317 FWF_NOSUBFOLDERS = 0x00000080,
318 FWF_TRANSPARENT = 0x00000100,
319 FWF_NOCLIENTEDGE = 0x00000200,
320 FWF_NOSCROLL = 0x00000400,
321 FWF_ALIGNLEFT = 0x00000800,
322 FWF_NOICONS = 0x00001000,
323 FWF_SHOWSELALWAYS = 0x00002000,
324 FWF_NOVISIBLE = 0x00004000,
325 FWF_SINGLECLICKACTIVATE = 0x00008000,
326 FWF_NOWEBVIEW = 0x00010000,
327 FWF_HIDEFILENAMES = 0x00020000,
328 FWF_CHECKSELECT = 0x00040000
329 } FOLDERFLAGS;
331 typedef enum
333 FVM_ICON = 1,
334 FVM_FIRST = FVM_ICON,
335 FVM_SMALLICON = 2,
336 FVM_LIST = 3,
337 FVM_DETAILS = 4,
338 FVM_THUMBNAIL = 5,
339 FVM_TILE = 6,
340 FVM_THUMBSTRIP = 7,
341 FVM_LAST = FVM_THUMBSTRIP
342 } FOLDERVIEWMODE;
344 typedef struct
346 UINT ViewMode;
347 UINT fFlags;
348 } FOLDERSETTINGS, *PFOLDERSETTINGS, *LPFOLDERSETTINGS;
349 typedef const FOLDERSETTINGS *LPCFOLDERSETTINGS;
352 /*****************************************************************************
353 * IShellView interface
355 interface IShellBrowser; /* forward declaration */
357 object,
358 uuid(000214e3-0000-0000-c000-000000000046),
359 pointer_default(unique)
361 interface IShellView : IOleWindow
363 typedef IShellView *LPSHELLVIEW;
365 cpp_quote("#define SVSI_DESELECT 0x00000000")
366 cpp_quote("#define SVSI_SELECT 0x00000001")
367 cpp_quote("#define SVSI_EDIT 0x00000003")
368 cpp_quote("#define SVSI_DESELECTOTHERS 0x00000004")
369 cpp_quote("#define SVSI_ENSUREVISIBLE 0x00000008")
370 cpp_quote("#define SVSI_FOCUSED 0x00000010")
371 cpp_quote("#define SVSI_TRANSLATEPT 0x00000020")
372 cpp_quote("#define SVSI_SELECTIONMARK 0x00000040")
373 cpp_quote("#define SVSI_POSITIONITEM 0x00000080")
374 cpp_quote("#define SVSI_CHECK 0x00000100")
375 cpp_quote("#define SVSI_NOSTATECHANGE 0x80000000")
377 typedef UINT SVSIF;
379 typedef enum
381 SVGIO_BACKGROUND = 0x00000000,
382 SVGIO_SELECTION = 0x00000001,
383 SVGIO_ALLVIEW = 0x00000002,
384 SVGIO_CHECKED = 0x00000003,
385 SVGIO_TYPE_MASK = 0x0000000f,
386 SVGIO_FLAG_VIEWORDER = 0x80000000,
387 } SVGIO;
389 typedef enum
391 SVUIA_DEACTIVATE = 0,
392 SVUIA_ACTIVATE_NOFOCUS = 1,
393 SVUIA_ACTIVATE_FOCUS = 2,
394 SVUIA_INPLACEACTIVATE = 3
395 } SVUIA_STATUS;
397 cpp_quote("#if 0")
398 typedef LPARAM LPFNSVADDPROPSHEETPAGE;
399 cpp_quote("#else")
400 cpp_quote("#include <prsht.h>")
401 cpp_quote("typedef LPFNADDPROPSHEETPAGE LPFNSVADDPROPSHEETPAGE;")
402 cpp_quote("#endif")
404 HRESULT TranslateAccelerator( [in] MSG *pmsg );
405 HRESULT EnableModeless( [in] BOOL fEnable );
406 HRESULT UIActivate( [in] UINT uState );
407 HRESULT Refresh();
408 HRESULT CreateViewWindow(
409 [in] IShellView *psvPrevious,
410 [in] LPCFOLDERSETTINGS lpfs,
411 [in] IShellBrowser *psb,
412 [out] RECT *prcView,
413 [out] HWND *phWnd);
415 HRESULT DestroyViewWindow();
416 HRESULT GetCurrentInfo( [out] LPFOLDERSETTINGS lpfs );
418 [local] HRESULT AddPropertySheetPages(
419 [in] DWORD dwReserved,
420 [in] LPFNSVADDPROPSHEETPAGE pfn,
421 [in] LPARAM lparam);
423 HRESULT SaveViewState();
424 HRESULT SelectItem(
425 [in] LPCITEMIDLIST pidlItem,
426 [in] SVSIF uFlags);
427 HRESULT GetItemObject(
428 [in] UINT uItem,
429 [in] REFIID riid,
430 [out, iid_is(riid)] void **ppv);
434 /*****************************************************************************
435 * IShellBrowser interface
438 object,
439 uuid(000214e2-0000-0000-c000-000000000046),
440 pointer_default(unique)
442 interface IShellBrowser : IOleWindow
444 typedef IShellBrowser *LPSHELLBROWSER;
446 cpp_quote("#define SBSP_DEFBROWSER 0x00000000")
447 cpp_quote("#define SBSP_SAMEBROWSER 0x00000001")
448 cpp_quote("#define SBSP_NEWBROWSER 0x00000002")
449 cpp_quote("#define SBSP_DEFMODE 0x00000000")
450 cpp_quote("#define SBSP_OPENMODE 0x00000010")
451 cpp_quote("#define SBSP_EXPLOREMODE 0x00000020")
452 cpp_quote("#define SBSP_HELPMODE 0x00000040")
453 cpp_quote("#define SBSP_NOTRANSFERHIST 0x00000080")
454 cpp_quote("#define SBSP_ABSOLUTE 0x00000000")
455 cpp_quote("#define SBSP_RELATIVE 0x00001000")
456 cpp_quote("#define SBSP_PARENT 0x00002000")
457 cpp_quote("#define SBSP_NAVIGATEBACK 0x00004000")
458 cpp_quote("#define SBSP_NAVIGATEFORWARD 0x00008000")
459 cpp_quote("#define SBSP_ALLOW_AUTONAVIGATE 0x00010000")
460 cpp_quote("#define SBSP_NOAUTOSELECT 0x04000000")
461 cpp_quote("#define SBSP_WRITENOHISTORY 0x08000000")
462 cpp_quote("#define SBSP_REDIRECT 0x40000000")
463 cpp_quote("#define SBSP_INITIATEDBYHLINKFRAME 0x80000000")
465 cpp_quote("#define FCW_STATUS 0x0001")
466 cpp_quote("#define FCW_TOOLBAR 0x0002")
467 cpp_quote("#define FCW_TREE 0x0003")
468 cpp_quote("#define FCW_INTERNETBAR 0x0006")
469 cpp_quote("#define FCW_PROGRESS 0x0008")
471 cpp_quote("#define FCT_MERGE 0x0001")
472 cpp_quote("#define FCT_CONFIGABLE 0x0002")
473 cpp_quote("#define FCT_ADDTOEND 0x0004")
475 cpp_quote("#if 0")
476 typedef LPARAM LPTBBUTTONSB;
477 cpp_quote("#else")
478 cpp_quote("#include <commctrl.h>")
479 cpp_quote("typedef LPTBBUTTON LPTBBUTTONSB;")
480 cpp_quote("#endif")
482 HRESULT InsertMenusSB(
483 [in] HMENU hmenuShared,
484 [in, out] LPOLEMENUGROUPWIDTHS lpMenuWidths);
486 HRESULT SetMenuSB(
487 [in] HMENU hmenuShared,
488 [in] HOLEMENU holemenuReserved,
489 [in] HWND hwndActiveObject);
491 HRESULT RemoveMenusSB( [in] HMENU hmenuShared );
492 HRESULT SetStatusTextSB( [in, unique] LPCOLESTR pszStatusText );
493 HRESULT EnableModelessSB( [in] BOOL fEnable );
494 HRESULT TranslateAcceleratorSB( [in] MSG *pmsg, [in] WORD wID );
496 HRESULT BrowseObject(
497 [in] LPCITEMIDLIST pidl,
498 [in] UINT wFlags);
500 HRESULT GetViewStateStream(
501 [in] DWORD grfMode,
502 [out] IStream **ppStrm);
504 HRESULT GetControlWindow(
505 [in] UINT id,
506 [out] HWND *phwnd);
508 [local] HRESULT SendControlMsg(
509 [in] UINT id,
510 [in] UINT uMsg,
511 [in] WPARAM wParam,
512 [in] LPARAM lParam,
513 [in] LRESULT *pret);
515 HRESULT QueryActiveShellView( [out] IShellView **ppshv );
516 HRESULT OnViewWindowActive( [in] IShellView *pshv );
518 [local]
519 HRESULT SetToolbarItems(
520 [in] LPTBBUTTONSB lpButtons,
521 [in] UINT nButtons,
522 [in] UINT uFlags);
526 /*****************************************************************************
527 * IShellLinkA interface
530 object,
531 uuid(000214ee-0000-0000-c000-000000000046),
532 pointer_default(unique)
534 interface IShellLinkA : IUnknown
536 typedef enum
538 SLR_NO_UI = 0x0001,
539 SLR_ANY_MATCH = 0x0002,
540 SLR_UPDATE = 0x0004,
541 SLR_NOUPDATE = 0x0008,
542 SLR_NOSEARCH = 0x0010,
543 SLR_NOTRACK = 0x0020,
544 SLR_NOLINKINFO = 0x0040,
545 SLR_INVOKE_MSI = 0x0080,
546 SLR_NO_UI_WITH_MSG_PUMP = 0x0101,
547 } SLR_FLAGS;
549 typedef enum
551 SLGP_SHORTPATH = 0x0001,
552 SLGP_UNCPRIORITY = 0x0002,
553 SLGP_RAWPATH = 0x0004,
554 } SLGP_FLAGS;
556 HRESULT GetPath(
557 [out, size_is(cch)] LPSTR pszFile,
558 [in] int cch,
559 [in, out] WIN32_FIND_DATAA *pfd,
560 [in] DWORD fFlags);
562 HRESULT GetIDList( [out] LPITEMIDLIST * ppidl );
564 HRESULT SetIDList( [in] LPCITEMIDLIST pidl );
566 HRESULT GetDescription(
567 [out, size_is(cch)] LPSTR pszName,
568 [in] int cch);
570 HRESULT SetDescription( [in] LPCSTR pszName );
572 HRESULT GetWorkingDirectory(
573 [out, size_is(cch)] LPSTR pszDir,
574 [in] int cch);
576 HRESULT SetWorkingDirectory( [in] LPCSTR pszDir );
578 HRESULT GetArguments(
579 [out, size_is(cch)] LPSTR pszArgs,
580 [in] int cch);
582 HRESULT SetArguments( [in] LPCSTR pszArgs );
584 HRESULT GetHotkey( [out] WORD *pwHotkey );
586 HRESULT SetHotkey( [in] WORD wHotkey );
588 HRESULT GetShowCmd( [out] int *piShowCmd );
590 HRESULT SetShowCmd( [in] int iShowCmd );
592 HRESULT GetIconLocation(
593 [out, size_is(cch)] LPSTR pszIconPath,
594 [in] int cch,
595 [out] int *piIcon);
597 HRESULT SetIconLocation(
598 [in] LPCSTR pszIconPath,
599 [in] int iIcon);
601 HRESULT SetRelativePath(
602 [in] LPCSTR pszPathRel,
603 [in] DWORD dwReserved);
605 HRESULT Resolve(
606 [in] HWND hwnd,
607 [in] DWORD fFlags);
609 HRESULT SetPath( [in] LPCSTR pszFile );
613 /*****************************************************************************
614 * IShellLinkW interface
617 object,
618 uuid(000214f9-0000-0000-c000-000000000046),
619 pointer_default(unique)
621 interface IShellLinkW : IUnknown
623 HRESULT GetPath(
624 [out, size_is(cch)] LPWSTR pszFile,
625 [in] int cch,
626 [in, out] WIN32_FIND_DATAW *pfd,
627 [in] DWORD fFlags);
629 HRESULT GetIDList( [out] LPITEMIDLIST * ppidl );
631 HRESULT SetIDList( [in] LPCITEMIDLIST pidl );
633 HRESULT GetDescription(
634 [out, size_is(cch)] LPWSTR pszName,
635 [in] int cch);
637 HRESULT SetDescription( [in] LPCWSTR pszName );
639 HRESULT GetWorkingDirectory(
640 [out, size_is(cch)] LPWSTR pszDir,
641 [in] int cch);
643 HRESULT SetWorkingDirectory( [in] LPCWSTR pszDir );
645 HRESULT GetArguments(
646 [out, size_is(cch)] LPWSTR pszArgs,
647 [in] int cch);
649 HRESULT SetArguments( [in] LPCWSTR pszArgs );
651 HRESULT GetHotkey( [out] WORD *pwHotkey );
653 HRESULT SetHotkey( [in] WORD wHotkey );
655 HRESULT GetShowCmd( [out] int *piShowCmd );
657 HRESULT SetShowCmd( [in] int iShowCmd );
659 HRESULT GetIconLocation(
660 [out, size_is(cch)] LPWSTR pszIconPath,
661 [in] int cch,
662 [out] int *piIcon);
664 HRESULT SetIconLocation(
665 [in] LPCWSTR pszIconPath,
666 [in] int iIcon);
668 HRESULT SetRelativePath(
669 [in] LPCWSTR pszPathRel,
670 [in] DWORD dwReserved);
672 HRESULT Resolve(
673 [in] HWND hwnd,
674 [in] DWORD fFlags);
676 HRESULT SetPath( [in] LPCWSTR pszFile );
679 cpp_quote("#define IShellLink WINELIB_NAME_AW(IShellLink)")
682 /*****************************************************************************
683 * IShellExtInit interface
686 object,
687 uuid(000214e8-0000-0000-c000-000000000046),
688 pointer_default(unique)
690 interface IShellExtInit : IUnknown
692 typedef IShellExtInit *LPSHELLEXTINIT;
694 HRESULT Initialize(
695 [in] LPCITEMIDLIST pidlFolder,
696 [in] IDataObject *pdtobj,
697 [in] HKEY hkeyProgID);
701 /*******************************************************************************/
702 /* Note: the following interfaces are not in shobjidl.idl under Windows, they */
703 /* are declared directly in shlobj.h. It hopefully won't break anything to put */
704 /* them here anyway. */
705 /*******************************************************************************/
707 #ifndef MAX_PATH
708 #define MAX_PATH 260
709 #endif
712 /*****************************************************************************
713 * IPersistFolder3 interface
716 object,
717 uuid(cef04fdf-fe72-11d2-87a5-00c04f6837cf),
718 pointer_default(unique)
720 interface IPersistFolder3 : IPersistFolder2
722 typedef struct
724 LPITEMIDLIST pidlTargetFolder;
725 WCHAR szTargetParsingName[MAX_PATH];
726 WCHAR szNetworkProvider[MAX_PATH];
727 DWORD dwAttributes;
728 int csidl;
729 } PERSIST_FOLDER_TARGET_INFO;
731 HRESULT InitializeEx(
732 [in] IBindCtx *pbc,
733 [in] LPCITEMIDLIST pidlRoot,
734 [in] const PERSIST_FOLDER_TARGET_INFO *ppfti);
736 HRESULT GetFolderTargetInfo( [out] PERSIST_FOLDER_TARGET_INFO *ppfti );
740 /*****************************************************************************
741 * IExtractIconA interface
744 object,
745 uuid(000214eb-0000-0000-c000-000000000046),
746 pointer_default(unique)
748 interface IExtractIconA : IUnknown
750 cpp_quote("#define GIL_OPENICON 0x0001")
751 cpp_quote("#define GIL_FORSHELL 0x0002")
752 cpp_quote("#define GIL_ASYNC 0x0020")
753 cpp_quote("#define GIL_DEFAULTICON 0x0040")
754 cpp_quote("#define GIL_FORSHORTCUT 0x0080")
756 cpp_quote("#define GIL_SIMULATEDOC 0x0001")
757 cpp_quote("#define GIL_PERINSTANCE 0x0002")
758 cpp_quote("#define GIL_PERCLASS 0x0004")
759 cpp_quote("#define GIL_NOTFILENAME 0x0008")
760 cpp_quote("#define GIL_DONTCACHE 0x0010")
762 typedef IExtractIconA *LPEXTRACTICONA;
764 HRESULT GetIconLocation(
765 [in] UINT uFlags,
766 [out, size_is(cchMax)] LPSTR szIconFile,
767 [in] UINT cchMax,
768 [out] INT *piIndex,
769 [out] UINT *pwFlags);
771 HRESULT Extract(
772 [in] LPCSTR pszFile,
773 [in] UINT nIconIndex,
774 [out] HICON *phiconLarge,
775 [out] HICON *phiconSmall,
776 [in] UINT nIconSize );
780 /*****************************************************************************
781 * IExtractIconW interface
784 object,
785 uuid(000214fa-0000-0000-c000-000000000046),
786 pointer_default(unique)
788 interface IExtractIconW : IUnknown
790 typedef IExtractIconW *LPEXTRACTICONW;
792 HRESULT GetIconLocation(
793 [in] UINT uFlags,
794 [out, size_is(cchMax)] LPWSTR szIconFile,
795 [in] UINT cchMax,
796 [out] INT *piIndex,
797 [out] UINT *pwFlags);
799 HRESULT Extract(
800 [in] LPCWSTR pszFile,
801 [in] UINT nIconIndex,
802 [out] HICON *phiconLarge,
803 [out] HICON *phiconSmall,
804 [in] UINT nIconSize );
807 cpp_quote("#define LPEXTRACTICON WINELIB_NAME_AW(LPEXTRACTICON)")
808 cpp_quote("#define IExtractIcon WINELIB_NAME_AW(IExtractIcon)")
811 /*****************************************************************************
812 * ICommDlgBrowser interface
815 object,
816 uuid(000214f1-0000-0000-c000-000000000046),
817 pointer_default(unique)
819 interface ICommDlgBrowser : IUnknown
821 cpp_quote("#define CDBOSC_SETFOCUS 0x00000000")
822 cpp_quote("#define CDBOSC_KILLFOCUS 0x00000001")
823 cpp_quote("#define CDBOSC_SELCHANGE 0x00000002")
824 cpp_quote("#define CDBOSC_RENAME 0x00000003")
825 cpp_quote("#define CDBOSC_STATECHANGE 0x00000004")
827 typedef ICommDlgBrowser *LPCOMMDLGBROWSER;
829 HRESULT OnDefaultCommand( [in] IShellView *shv );
830 HRESULT OnStateChange( [in] IShellView *shv, [in] ULONG uChange );
831 HRESULT IncludeObject( [in] IShellView *shv, [in] LPCITEMIDLIST pidl );
835 /*****************************************************************************
836 * IDockingWindowFrame interface
839 object,
840 uuid(47d2657a-7b27-11d0-8ca9-00a0c92dbfe8),
841 pointer_default(unique)
843 interface IDockingWindowFrame : IOleWindow
845 cpp_quote("#define DWFRF_NORMAL 0x0000")
846 cpp_quote("#define DWFRF_DELETECONFIGDATA 0x0001")
847 cpp_quote("#define DWFAF_HIDDEN 0x0001")
849 HRESULT AddToolbar(
850 [in] IUnknown *punkSrc,
851 [in] LPCWSTR pwszItem,
852 [in] DWORD dwAddFlags);
854 HRESULT RemoveToolbar(
855 [in] IUnknown *punkSrc,
856 [in] DWORD dwRemoveFlags);
858 HRESULT FindToolbar(
859 [in] LPCWSTR pwszItem,
860 [in] REFIID riid,
861 [out] LPVOID *ppvObj);
865 /*****************************************************************************
866 * IDragSourceHelper interface
869 object,
870 uuid(de5bf786-477a-11d2-839d-00c04fd918d0),
871 pointer_default(unique)
873 interface IDragSourceHelper : IUnknown
875 typedef struct
877 SIZE sizeDragImage;
878 POINT ptOffset;
879 HBITMAP hbmpDragImage;
880 COLORREF crColorKey;
881 } SHDRAGIMAGE, *LPSHDRAGIMAGE;
883 HRESULT InitializeFromBitmap(
884 [in] LPSHDRAGIMAGE pshdi,
885 [in] IDataObject *pDataObject);
887 HRESULT InitializeFromWindow(
888 [in] HWND hwnd,
889 [in] POINT *ppt,
890 [in] IDataObject *pDataObject);
894 /*****************************************************************************
895 * IDropTargetHelper interface
898 object,
899 uuid(4657278b-411b-11d2-839a-00c04fd918d0),
900 pointer_default(unique)
902 interface IDropTargetHelper : IUnknown
904 HRESULT DragEnter(
905 [in] HWND hwndTarget,
906 [in] IDataObject *pDataObject,
907 [in] POINT *ppt,
908 [in] DWORD dwEffect);
910 HRESULT DragLeave();
912 HRESULT DragOver(
913 [in] POINT *ppt,
914 [in] DWORD dwEffect);
916 HRESULT Drop(
917 [in] IDataObject *pDataObject,
918 [in] POINT *ppt,
919 [in] DWORD dwEffect);
921 HRESULT Show( [in] BOOL fShow );
925 /*****************************************************************************
926 * IContextMenu interface
929 object,
930 uuid(000214e4-0000-0000-c000-000000000046),
931 pointer_default(unique)
933 interface IContextMenu : IUnknown
935 cpp_quote("#define CMF_NORMAL 0x00000000")
936 cpp_quote("#define CMF_DEFAULTONLY 0x00000001")
937 cpp_quote("#define CMF_VERBSONLY 0x00000002")
938 cpp_quote("#define CMF_EXPLORE 0x00000004")
939 cpp_quote("#define CMF_NOVERBS 0x00000008")
940 cpp_quote("#define CMF_CANRENAME 0x00000010")
941 cpp_quote("#define CMF_NODEFAULT 0x00000020")
942 cpp_quote("#define CMF_INCLUDESTATIC 0x00000040")
943 cpp_quote("#define CMF_EXTENDEDVERBS 0x00000100")
944 cpp_quote("#define CMF_RESERVED 0xffff0000")
946 cpp_quote("#define GCS_VERBA 0x00000000")
947 cpp_quote("#define GCS_HELPTEXTA 0x00000001")
948 cpp_quote("#define GCS_VALIDATEA 0x00000002")
949 cpp_quote("#define GCS_VERBW 0x00000004")
950 cpp_quote("#define GCS_HELPTEXTW 0x00000005")
951 cpp_quote("#define GCS_VALIDATEW 0x00000006")
952 cpp_quote("#define GCS_UNICODE 0x00000004")
953 cpp_quote("#define GCS_VERB WINELIB_NAME_AW(GCS_VERB)")
954 cpp_quote("#define GCS_HELPTEXT WINELIB_NAME_AW(GCS_HELPTEXT)")
955 cpp_quote("#define GCS_VALIDATE WINELIB_NAME_AW(GCS_VALIDATE)")
957 cpp_quote("#define CMDSTR_NEWFOLDERA \"NewFolder\"")
958 cpp_quote("#define CMDSTR_VIEWLISTA \"ViewList\"")
959 cpp_quote("#define CMDSTR_VIEWDETAILSA \"ViewDetails\"")
960 cpp_quote("#if defined(__GNUC__)")
961 cpp_quote("# define CMDSTR_NEWFOLDERW (const WCHAR []){ 'N','e','w','F','o','l','d','e','r',0 }")
962 cpp_quote("# define CMDSTR_VIEWLISTW (const WCHAR []){ 'V','i','e','w','L','i','s','t',0 }")
963 cpp_quote("# define CMDSTR_VIEWDETAILSW (const WCHAR []){ 'V','i','e','w','D','e','t','a','i','l','s',0 }")
964 cpp_quote("#elif defined(_MSC_VER)")
965 cpp_quote("# define CMDSTR_NEWFOLDERW L\"NewFolder\"")
966 cpp_quote("# define CMDSTR_VIEWLISTW L\"ViewList\"")
967 cpp_quote("# define CMDSTR_VIEWDETAILSW L\"ViewDetails\"")
968 cpp_quote("#else")
969 cpp_quote("static const WCHAR CMDSTR_NEWFOLDERW[] = {'N','e','w','F','o','l','d','e','r',0};")
970 cpp_quote("static const WCHAR CMDSTR_VIEWLISTW [] = {'V','i','e','w','L','i','s','t',0};")
971 cpp_quote("static const WCHAR CMDSTR_VIEWDETAILSW[] = {'V','i','e','w','D','e','t','a','i','l','s',0};")
972 cpp_quote("#endif")
973 cpp_quote("#define CMDSTR_NEWFOLDER WINELIB_NAME_AW(CMDSTR_NEWFOLDER)")
974 cpp_quote("#define CMDSTR_VIEWLIST WINELIB_NAME_AW(CMDSTR_VIEWLIST)")
975 cpp_quote("#define CMDSTR_VIEWDETAILS WINELIB_NAME_AW(CMDSTR_VIEWDETAILS)")
977 cpp_quote("#define CMIC_MASK_HOTKEY SEE_MASK_HOTKEY")
978 cpp_quote("#define CMIC_MASK_ICON SEE_MASK_ICON")
979 cpp_quote("#define CMIC_MASK_FLAG_NO_UI SEE_MASK_FLAG_NO_UI")
980 cpp_quote("#define CMIC_MASK_UNICODE SEE_MASK_UNICODE")
981 cpp_quote("#define CMIC_MASK_NO_CONSOLE SEE_MASK_NO_CONSOLE")
982 cpp_quote("#define CMIC_MASK_HASLINKNAME SEE_MASK_HASLINKNAME")
983 cpp_quote("#define CMIC_MASK_FLAG_SEP_VDM SEE_MASK_FLAG_SEPVDM")
984 cpp_quote("#define CMIC_MASK_HASTITLE SEE_MASK_HASTITLE")
985 cpp_quote("#define CMIC_MASK_ASYNCOK SEE_MASK_ASYNCOK")
986 cpp_quote("#define CMIC_MASK_SHIFT_DOWN 0x10000000")
987 cpp_quote("#define CMIC_MASK_PTINVOKE 0x20000000")
988 cpp_quote("#define CMIC_MASK_CONTROL_DOWN 0x40000000")
989 cpp_quote("#define CMIC_MASK_FLAG_LOG_USAGE SEE_MASK_FLAG_LOG_USAGE")
990 cpp_quote("#define CMIC_MASK_NOZONECHECKS SEE_MASK_NOZONECHECKS")
992 typedef IContextMenu *LPCONTEXTMENU;
994 typedef struct tagCMINVOKECOMMANDINFO
996 DWORD cbSize;
997 DWORD fMask;
998 HWND hwnd;
999 LPCSTR lpVerb;
1000 LPCSTR lpParameters;
1001 LPCSTR lpDirectory;
1002 INT nShow;
1003 DWORD dwHotKey;
1004 HANDLE hIcon;
1005 } CMINVOKECOMMANDINFO, *LPCMINVOKECOMMANDINFO;
1007 typedef struct tagCMInvokeCommandInfoEx
1009 DWORD cbSize;
1010 DWORD fMask;
1011 HWND hwnd;
1012 LPCSTR lpVerb;
1013 LPCSTR lpParameters;
1014 LPCSTR lpDirectory;
1015 INT nShow;
1016 DWORD dwHotKey;
1017 HANDLE hIcon;
1018 LPCSTR lpTitle;
1019 LPCWSTR lpVerbW;
1020 LPCWSTR lpParametersW;
1021 LPCWSTR lpDirectoryW;
1022 LPCWSTR lpTitleW;
1023 POINT ptInvoke;
1024 } CMINVOKECOMMANDINFOEX, *LPCMINVOKECOMMANDINFOEX;
1026 HRESULT QueryContextMenu(
1027 [in] HMENU hmenu,
1028 [in] UINT indexMenu,
1029 [in] UINT idCmdFirst,
1030 [in] UINT idCmdLast,
1031 [in] UINT uFlags);
1033 HRESULT InvokeCommand( [in] LPCMINVOKECOMMANDINFO lpici );
1035 HRESULT GetCommandString(
1036 [in] UINT_PTR idCmd,
1037 [in] UINT uType,
1038 [out] UINT *pwReserved,
1039 [out, size_is(cchMax)] LPSTR pszName,
1040 [in] UINT cchMax);
1044 /*****************************************************************************
1045 * IContextMenu2 interface
1048 object,
1049 uuid(000214f4-0000-0000-c000-000000000046),
1050 pointer_default(unique)
1052 interface IContextMenu2 : IContextMenu
1054 typedef IContextMenu2 *LPCONTEXTMENU2;
1056 HRESULT HandleMenuMsg(
1057 [in] UINT uMsg,
1058 [in] WPARAM wParam,
1059 [in] LPARAM lParam);
1063 /*****************************************************************************
1064 * IContextMenu3 interface
1067 object,
1068 uuid(bcfce0a0-ec17-11d0-8d10-00a0c90f2719),
1069 pointer_default(unique)
1071 interface IContextMenu3 : IContextMenu2
1073 typedef IContextMenu3 *LPCONTEXTMENU3;
1075 HRESULT HandleMenuMsg2(
1076 [in] UINT uMsg,
1077 [in] WPARAM wParam,
1078 [in] LPARAM lParam,
1079 [out] LRESULT *plResult);
1083 /*****************************************************************************
1084 * IShellExecuteHookA interface
1087 object,
1088 uuid(000214f5-0000-0000-c000-000000000046),
1089 pointer_default(unique)
1091 interface IShellExecuteHookA : IUnknown
1093 cpp_quote("struct _SHELLEXECUTEINFOA;");
1094 HRESULT Execute(
1095 [in, out] struct _SHELLEXECUTEINFOA* pei);
1099 /*****************************************************************************
1100 * IShellExecuteHookW interface
1103 object,
1104 uuid(000214fb-0000-0000-c000-000000000046),
1105 pointer_default(unique)
1107 interface IShellExecuteHookW : IUnknown
1109 cpp_quote("struct _SHELLEXECUTEINFOW;");
1110 HRESULT Execute(
1111 [in, out] struct _SHELLEXECUTEINFOW* pei);
1114 /*****************************************************************************
1115 * IShellLinkDataList interface
1118 object,
1119 uuid(45e2b4ae-b1c3-11d0-b92f-00a0c90312e1),
1120 pointer_default(unique)
1122 interface IShellLinkDataList : IUnknown
1124 HRESULT AddDataBlock(
1125 [in] void *pDataBlock);
1126 HRESULT CopyDataBlock(
1127 [in] DWORD dwSig,
1128 [out] void **ppDataBlock);
1129 HRESULT RemoveDataBlock(
1130 [in] DWORD dwSig);
1131 HRESULT GetFlags(
1132 [out] DWORD *pdwFlags);
1133 HRESULT SetFlags(
1134 [in] DWORD dwFlags);
1138 /*****************************************************************************
1139 * IResolveShellLink interface
1142 object,
1143 uuid(5cd52983-9449-11d2-963a-00c04f79adf0),
1144 pointer_default(unique)
1146 interface IResolveShellLink : IUnknown
1148 HRESULT ResolveShellLink(
1149 [in] IUnknown *punk,
1150 [in] HWND hwnd,
1151 [in] DWORD fFlags);
1155 /*****************************************************************************
1156 * IURLSearchHook interface
1159 object,
1160 uuid(ac60f6a0-0fd9-11d0-99cb-00c04fd64497),
1161 pointer_default(unique)
1163 interface IURLSearchHook : IUnknown
1165 HRESULT Translate(
1166 [in, out] LPWSTR lpwszSearchURL,
1167 [in] DWORD cchBufferSize);
1171 /*****************************************************************************
1172 * ISearchContext interface
1175 object,
1176 uuid(09f656a2-41af-480c-88f7-16cc0d164615),
1177 pointer_default(unique)
1179 interface ISearchContext : IUnknown
1181 HRESULT GetSearchUrl(
1182 [in] BSTR *pbstrSearchUrl);
1183 HRESULT GetSearchText(
1184 [in] BSTR *pbstrSearchText);
1185 HRESULT GetSearchStyle(
1186 [in] BSTR *pdwSearchStyle);
1190 /*****************************************************************************
1191 * IURLSearchHook2 interface
1194 object,
1195 uuid(5ee44da4-6d32-46e3-86bc-07540dedd0e0),
1196 pointer_default(unique)
1198 interface IURLSearchHook2 : IURLSearchHook
1200 HRESULT TranslateWithSearchContext(
1201 [in, out] LPWSTR lpwszSearchURL,
1202 [in] DWORD cchBufferSize,
1203 [in] ISearchContext *pSearchContext);
1207 cpp_quote("#define INewShortcutHook WINELIB_NAME_AW(INewShortcutHook)")
1209 /*****************************************************************************
1210 * INewShortcutHookA interface
1213 object,
1214 uuid(000214e1-0000-0000-c000-000000000046),
1215 pointer_default(unique)
1217 interface INewShortcutHookA : IUnknown
1219 HRESULT SetReferent(
1220 [in] LPCSTR pcszReferent,
1221 [in] HWND hwnd);
1222 HRESULT GetReferent(
1223 [out] LPCSTR pcszReferent,
1224 [in] int cchReferent);
1225 HRESULT SetFolder(
1226 [in] LPCSTR pcszReferent);
1227 HRESULT GetFolder(
1228 [out] LPSTR pcszReferent,
1229 [in] int cchFolder);
1230 HRESULT GetName(
1231 [out] LPSTR pszName,
1232 [in] int cchName);
1233 HRESULT GetExtension(
1234 [out] LPSTR pszExtension,
1235 [in] int cchExtension);
1239 /*****************************************************************************
1240 * INewShortcutHookW interface
1243 object,
1244 uuid(000214f7-0000-0000-c000-000000000046),
1245 pointer_default(unique)
1247 interface INewShortcutHookW : IUnknown
1249 HRESULT SetReferent(
1250 [in] LPCWSTR pcszReferent,
1251 [in] HWND hwnd);
1252 HRESULT GetReferent(
1253 [out] LPCWSTR pcszReferent,
1254 [in] int cchReferent);
1255 HRESULT SetFolder(
1256 [in] LPCWSTR pcszReferent);
1257 HRESULT GetFolder(
1258 [out] LPWSTR pcszReferent,
1259 [in] int cchFolder);
1260 HRESULT GetName(
1261 [out] LPWSTR pszName,
1262 [in] int cchName);
1263 HRESULT GetExtension(
1264 [out] LPWSTR pszExtension,
1265 [in] int cchExtension);
1269 /*****************************************************************************
1270 * IShellChangeNotify interface
1273 object,
1274 uuid(d82be2b1-5764-11d0-a96e-00c04fd705a2),
1275 pointer_default(unique)
1277 interface IShellChangeNotify : IUnknown
1279 HRESULT OnChange(
1280 [in] LONG lEvent,
1281 [in] LPCITEMIDLIST pidl1,
1282 [in] LPCITEMIDLIST pidl2);
1285 /*****************************************************************************
1286 * IFileSystemBindData interface
1289 object,
1290 uuid(01e18d10-4d8b-11d2-855d-006008059367),
1291 pointer_default(unique)
1293 interface IFileSystemBindData : IUnknown
1295 HRESULT SetFindData(
1296 [in] const WIN32_FIND_DATAW *pfd);
1297 HRESULT GetFindData(
1298 [out] WIN32_FIND_DATAW *pfd);