Fixed naming of the A/W types.
[wine] / include / shlobj.h
1 /*
2  * Copyright (C) the Wine project
3  *
4  * This library is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU Lesser General Public
6  * License as published by the Free Software Foundation; either
7  * version 2.1 of the License, or (at your option) any later version.
8  *
9  * This library is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12  * Lesser General Public License for more details.
13  *
14  * You should have received a copy of the GNU Lesser General Public
15  * License along with this library; if not, write to the Free Software
16  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
17  */
18
19 #ifndef __WINE_SHLOBJ_H
20 #define __WINE_SHLOBJ_H
21
22 #include <ole2.h>
23 #include <commctrl.h>
24 #include <prsht.h>
25 #include <shlguid.h>
26
27 #ifdef __cplusplus
28 extern "C" {
29 #endif /* defined(__cplusplus) */
30
31 #include <pshpack1.h>
32
33 #include <shtypes.h>
34 #include <shobjidl.h>
35
36
37 BOOL WINAPI SHGetPathFromIDListA (LPCITEMIDLIST pidl,LPSTR pszPath);
38 BOOL WINAPI SHGetPathFromIDListW (LPCITEMIDLIST pidl,LPWSTR pszPath);
39 #define     SHGetPathFromIDList WINELIB_NAME_AW(SHGetPathFromIDList)
40
41 /*****************************************************************************
42  * Predeclare interfaces
43  */
44 typedef struct IShellIcon IShellIcon, *LPSHELLICON;
45
46
47 /*****************************************************************************
48  * IContextMenu interface
49  */
50
51
52 /* DATAOBJECT_InitShellIDList*/
53 #define CFSTR_SHELLIDLIST       "Shell IDList Array"      /* CF_IDLIST */
54
55 extern UINT cfShellIDList;
56
57 typedef struct
58 {       UINT cidl;
59         UINT aoffset[1];
60 } CIDA, *LPIDA;
61
62 #define CFSTR_SHELLIDLISTOFFSET "Shell Object Offsets"    /* CF_OBJECTPOSITIONS */
63 #define CFSTR_NETRESOURCES      "Net Resource"            /* CF_NETRESOURCE */
64
65 /* DATAOBJECT_InitFileGroupDesc */
66 #define CFSTR_FILEDESCRIPTORA   "FileGroupDescriptor"     /* CF_FILEGROUPDESCRIPTORA */
67 extern UINT cfFileGroupDesc;
68
69 #define CFSTR_FILEDESCRIPTORW   "FileGroupDescriptorW"    /* CF_FILEGROUPDESCRIPTORW */
70
71 /* DATAOBJECT_InitFileContents*/
72 #define CFSTR_FILECONTENTS      "FileContents"            /* CF_FILECONTENTS */
73 extern UINT cfFileContents;
74
75 #define CFSTR_FILENAMEA         "FileName"                /* CF_FILENAMEA */
76 #define CFSTR_FILENAMEW         "FileNameW"               /* CF_FILENAMEW */
77 #define CFSTR_PRINTERGROUP      "PrinterFriendlyName"     /* CF_PRINTERS */
78 #define CFSTR_FILENAMEMAPA      "FileNameMap"             /* CF_FILENAMEMAPA */
79 #define CFSTR_FILENAMEMAPW      "FileNameMapW"            /* CF_FILENAMEMAPW */
80 #define CFSTR_SHELLURL          "UniformResourceLocator"
81 #define CFSTR_PREFERREDDROPEFFECT "Preferred DropEffect"
82 #define CFSTR_PERFORMEDDROPEFFECT "Performed DropEffect"
83 #define CFSTR_PASTESUCCEEDED    "Paste Succeeded"
84 #define CFSTR_INDRAGLOOP        "InShellDragLoop"
85
86 #define CFSTR_FILENAME WINELIB_NAME_AW(CFSTR_FILENAME)
87
88
89 /************************************************************************
90 * IShellView interface
91 */
92
93 typedef GUID SHELLVIEWID;
94 #define SV_CLASS_NAME   ("SHELLDLL_DefView")
95
96 #define FCIDM_SHVIEWFIRST       0x0000
97 /* undocumented */
98 #define FCIDM_SHVIEW_ARRANGE    0x7001
99 #define FCIDM_SHVIEW_DELETE     0x7011
100 #define FCIDM_SHVIEW_PROPERTIES 0x7013
101 #define FCIDM_SHVIEW_CUT        0x7018
102 #define FCIDM_SHVIEW_COPY       0x7019
103 #define FCIDM_SHVIEW_INSERT     0x701A
104 #define FCIDM_SHVIEW_UNDO       0x701B
105 #define FCIDM_SHVIEW_INSERTLINK 0x701C
106 #define FCIDM_SHVIEW_SELECTALL  0x7021
107 #define FCIDM_SHVIEW_INVERTSELECTION 0x7022
108
109 #define FCIDM_SHVIEW_BIGICON    0x7029
110 #define FCIDM_SHVIEW_SMALLICON  0x702A
111 #define FCIDM_SHVIEW_LISTVIEW   0x702B
112 #define FCIDM_SHVIEW_REPORTVIEW 0x702C
113 /* 0x7030-0x703f are used by the shellbrowser */
114 #define FCIDM_SHVIEW_AUTOARRANGE 0x7031
115 #define FCIDM_SHVIEW_SNAPTOGRID 0x7032
116
117 #define FCIDM_SHVIEW_HELP       0x7041
118 #define FCIDM_SHVIEW_RENAME     0x7050
119 #define FCIDM_SHVIEW_CREATELINK 0x7051
120 #define FCIDM_SHVIEW_NEWLINK    0x7052
121 #define FCIDM_SHVIEW_NEWFOLDER  0x7053
122
123 #define FCIDM_SHVIEW_REFRESH    0x7100 /* FIXME */
124 #define FCIDM_SHVIEW_EXPLORE    0x7101 /* FIXME */
125 #define FCIDM_SHVIEW_OPEN       0x7102 /* FIXME */
126
127 #define FCIDM_SHVIEWLAST        0x7fff
128 #define FCIDM_BROWSERFIRST      0xA000
129 /* undocumented toolbar items from stddlg's*/
130 #define FCIDM_TB_UPFOLDER       0xA001
131 #define FCIDM_TB_NEWFOLDER      0xA002
132 #define FCIDM_TB_SMALLICON      0xA003
133 #define FCIDM_TB_REPORTVIEW     0xA004
134 #define FCIDM_TB_DESKTOP        0xA005  /* FIXME */
135
136 #define FCIDM_BROWSERLAST       0xbf00
137 #define FCIDM_GLOBALFIRST       0x8000
138 #define FCIDM_GLOBALLAST        0x9fff
139
140 /*
141 * Global submenu IDs and separator IDs
142 */
143 #define FCIDM_MENU_FILE             (FCIDM_GLOBALFIRST+0x0000)
144 #define FCIDM_MENU_EDIT             (FCIDM_GLOBALFIRST+0x0040)
145 #define FCIDM_MENU_VIEW             (FCIDM_GLOBALFIRST+0x0080)
146 #define FCIDM_MENU_VIEW_SEP_OPTIONS (FCIDM_GLOBALFIRST+0x0081)
147 #define FCIDM_MENU_TOOLS            (FCIDM_GLOBALFIRST+0x00c0)
148 #define FCIDM_MENU_TOOLS_SEP_GOTO   (FCIDM_GLOBALFIRST+0x00c1)
149 #define FCIDM_MENU_HELP             (FCIDM_GLOBALFIRST+0x0100)
150 #define FCIDM_MENU_FIND             (FCIDM_GLOBALFIRST+0x0140)
151 #define FCIDM_MENU_EXPLORE          (FCIDM_GLOBALFIRST+0x0150)
152 #define FCIDM_MENU_FAVORITES        (FCIDM_GLOBALFIRST+0x0170)
153
154 /* control IDs known to the view */
155 #define FCIDM_TOOLBAR      (FCIDM_BROWSERFIRST + 0)
156 #define FCIDM_STATUS       (FCIDM_BROWSERFIRST + 1)
157
158
159 /****************************************************************************
160  * IShellIcon interface
161  */
162
163 #define INTERFACE IShellIcon
164 #define IShellIcon_METHODS \
165     IUnknown_METHODS \
166     STDMETHOD(GetIconOf)(THIS_ LPCITEMIDLIST pidl, UINT flags, LPINT lpIconIndex) PURE;
167 ICOM_DEFINE(IShellIcon, IUnknown)
168 #undef INTERFACE
169
170 #ifdef COBJMACROS
171 /*** IUnknown methods ***/
172 #define IShellIcon_QueryInterface(p,a,b)      (p)->lpVtbl->QueryInterface(p,a,b)
173 #define IShellIcon_AddRef(p)                  (p)->lpVtbl->AddRef(p)
174 #define IShellIcon_Release(p)                 (p)->lpVtbl->Release(p)
175 /*** IShellIcon methods ***/
176 #define IShellIcon_GetIconOf(p,a,b,c)         (p)->lpVtbl->GetIconOf(p,a,b,c)
177 #endif
178
179 /****************************************************************************
180 * SHAddToRecentDocs API
181 */
182 #define SHARD_PIDL      0x00000001L
183 #define SHARD_PATHA     0x00000002L
184 #define SHARD_PATHW     0x00000003L
185 #define SHARD_PATH WINELIB_NAME_AW(SHARD_PATH)
186
187 DWORD WINAPI SHAddToRecentDocs(UINT uFlags, LPCVOID pv);
188
189 /****************************************************************************
190  * Shell Execute API
191  */
192 #define SE_ERR_FNF              2       /* file not found */
193 #define SE_ERR_PNF              3       /* path not found */
194 #define SE_ERR_ACCESSDENIED     5       /* access denied */
195 #define SE_ERR_OOM              8       /* out of memory */
196 #define SE_ERR_DLLNOTFOUND      32
197 #define SE_ERR_SHARE                    26
198 #define SE_ERR_ASSOCINCOMPLETE          27
199 #define SE_ERR_DDETIMEOUT               28
200 #define SE_ERR_DDEFAIL                  29
201 #define SE_ERR_DDEBUSY                  30
202 #define SE_ERR_NOASSOC                  31
203
204 #define SEE_MASK_CLASSNAME        0x00000001
205 #define SEE_MASK_CLASSKEY         0x00000003
206 #define SEE_MASK_IDLIST           0x00000004
207 #define SEE_MASK_INVOKEIDLIST     0x0000000c
208 #define SEE_MASK_ICON             0x00000010
209 #define SEE_MASK_HOTKEY           0x00000020
210 #define SEE_MASK_NOCLOSEPROCESS   0x00000040
211 #define SEE_MASK_CONNECTNETDRV    0x00000080
212 #define SEE_MASK_FLAG_DDEWAIT     0x00000100
213 #define SEE_MASK_DOENVSUBST       0x00000200
214 #define SEE_MASK_FLAG_NO_UI       0x00000400
215 #define SEE_MASK_UNICODE          0x00004000
216 #define SEE_MASK_NO_CONSOLE       0x00008000
217 #define SEE_MASK_ASYNCOK          0x00100000
218 #define SEE_MASK_HMONITOR         0x00200000
219
220 typedef struct _SHELLEXECUTEINFOA
221 {       DWORD cbSize;
222         ULONG fMask;
223         HWND hwnd;
224         LPCSTR   lpVerb;
225         LPCSTR   lpFile;
226         LPCSTR   lpParameters;
227         LPCSTR   lpDirectory;
228        INT nShow;
229         HINSTANCE hInstApp;
230         /* Optional fields */
231         LPVOID lpIDList;
232         LPCSTR   lpClass;
233         HKEY hkeyClass;
234         DWORD dwHotKey;
235         union
236         { HANDLE hIcon;
237           HANDLE hMonitor;
238         } DUMMYUNIONNAME;
239         HANDLE hProcess;
240 } SHELLEXECUTEINFOA, *LPSHELLEXECUTEINFOA;
241
242 typedef struct _SHELLEXECUTEINFOW
243 {       DWORD cbSize;
244         ULONG fMask;
245         HWND hwnd;
246         LPCWSTR  lpVerb;
247         LPCWSTR  lpFile;
248         LPCWSTR  lpParameters;
249         LPCWSTR  lpDirectory;
250        INT nShow;
251         HINSTANCE hInstApp;
252         /* Optional fields*/
253         LPVOID lpIDList;
254         LPCWSTR  lpClass;
255         HKEY hkeyClass;
256         DWORD dwHotKey;
257         union
258         { HANDLE hIcon;
259           HANDLE hMonitor;
260         } DUMMYUNIONNAME;
261         HANDLE hProcess;
262 } SHELLEXECUTEINFOW, *LPSHELLEXECUTEINFOW;
263
264 #define SHELLEXECUTEINFO   WINELIB_NAME_AW(SHELLEXECUTEINFO)
265 #define LPSHELLEXECUTEINFO WINELIB_NAME_AW(LPSHELLEXECUTEINFO)
266
267 BOOL WINAPI ShellExecuteExA(LPSHELLEXECUTEINFOA lpExecInfo);
268 BOOL WINAPI ShellExecuteExW(LPSHELLEXECUTEINFOW lpExecInfo);
269 #define ShellExecuteEx  WINELIB_NAME_AW(ShellExecuteEx)
270
271 void WINAPI WinExecErrorA(HWND hwnd,INT error, LPCSTR lpstrFileName, LPCSTR lpstrTitle);
272 void WINAPI WinExecErrorW(HWND hwnd,INT error, LPCWSTR lpstrFileName, LPCWSTR lpstrTitle);
273 #define WinExecError  WINELIB_NAME_AW(WinExecError)
274
275
276
277 /****************************************************************************
278  * SHBrowseForFolder API
279  */
280 typedef INT (CALLBACK *BFFCALLBACK)(HWND hwnd, UINT uMsg, LPARAM lParam, LPARAM lpData);
281
282 typedef struct tagBROWSEINFOA {
283     HWND        hwndOwner;
284     LPCITEMIDLIST pidlRoot;
285     LPSTR         pszDisplayName;
286     LPCSTR        lpszTitle;
287     UINT        ulFlags;
288     BFFCALLBACK   lpfn;
289     LPARAM        lParam;
290     INT         iImage;
291 } BROWSEINFOA, *PBROWSEINFOA, *LPBROWSEINFOA;
292
293 typedef struct tagBROWSEINFOW {
294     HWND        hwndOwner;
295     LPCITEMIDLIST pidlRoot;
296     LPWSTR        pszDisplayName;
297     LPCWSTR       lpszTitle;
298     UINT        ulFlags;
299     BFFCALLBACK   lpfn;
300     LPARAM        lParam;
301     INT         iImage;
302 } BROWSEINFOW, *PBROWSEINFOW, *LPBROWSEINFOW;
303
304 #define BROWSEINFO   WINELIB_NAME_AW(BROWSEINFO)
305 #define PBROWSEINFO  WINELIB_NAME_AW(PBROWSEINFO)
306 #define LPBROWSEINFO WINELIB_NAME_AW(LPBROWSEINFO)
307
308 /* Browsing for directory. */
309 #define BIF_RETURNONLYFSDIRS   0x0001
310 #define BIF_DONTGOBELOWDOMAIN  0x0002
311 #define BIF_STATUSTEXT         0x0004
312 #define BIF_RETURNFSANCESTORS  0x0008
313 #define BIF_EDITBOX            0x0010
314 #define BIF_VALIDATE           0x0020
315 #define BIF_NEWDIALOGSTYLE     0x0040   
316
317 #define BIF_BROWSEFORCOMPUTER  0x1000
318 #define BIF_BROWSEFORPRINTER   0x2000
319 #define BIF_BROWSEINCLUDEFILES 0x4000
320
321 /* message from browser */
322 #define BFFM_INITIALIZED        1
323 #define BFFM_SELCHANGED         2
324 #define BFFM_VALIDATEFAILEDA    3   /* lParam:szPath ret:1(cont),0(EndDialog) */
325 #define BFFM_VALIDATEFAILEDW    4   /* lParam:wzPath ret:1(cont),0(EndDialog) */
326
327 /* messages to browser */
328 #define BFFM_SETSTATUSTEXTA     (WM_USER+100)
329 #define BFFM_ENABLEOK           (WM_USER+101)
330 #define BFFM_SETSELECTIONA      (WM_USER+102)
331 #define BFFM_SETSELECTIONW      (WM_USER+103)
332 #define BFFM_SETSTATUSTEXTW     (WM_USER+104)
333 #define BFFM_SETOKTEXT          (WM_USER+105)
334 #define BFFM_SETEXPANDED        (WM_USER+106)
335
336 LPITEMIDLIST WINAPI SHBrowseForFolderA(LPBROWSEINFOA lpbi);
337 LPITEMIDLIST WINAPI SHBrowseForFolderW(LPBROWSEINFOW lpbi);
338 #define SHBrowseForFolder        WINELIB_NAME_AW(SHBrowseForFolder)
339 #define BFFM_SETSTATUSTEXT  WINELIB_NAME_AW(BFFM_SETSTATUSTEXT)
340 #define BFFM_SETSELECTION   WINELIB_NAME_AW(BFFM_SETSELECTION)
341 #define BFFM_VALIDATEFAILED WINELIB_NAME_AW(BFFM_VALIDATEFAILED)
342
343 /****************************************************************************
344 *       SHGetDataFromIDList API
345 */
346 #define SHGDFIL_FINDDATA        1
347 #define SHGDFIL_NETRESOURCE     2
348 #define SHGDFIL_DESCRIPTIONID   3
349
350 #define SHDID_ROOT_REGITEM          1
351 #define SHDID_FS_FILE               2
352 #define SHDID_FS_DIRECTORY          3
353 #define SHDID_FS_OTHER              4
354 #define SHDID_COMPUTER_DRIVE35      5
355 #define SHDID_COMPUTER_DRIVE525     6
356 #define SHDID_COMPUTER_REMOVABLE    7
357 #define SHDID_COMPUTER_FIXED        8
358 #define SHDID_COMPUTER_NETDRIVE     9
359 #define SHDID_COMPUTER_CDROM        10
360 #define SHDID_COMPUTER_RAMDISK      11
361 #define SHDID_COMPUTER_OTHER        12
362 #define SHDID_NET_DOMAIN            13
363 #define SHDID_NET_SERVER            14
364 #define SHDID_NET_SHARE             15
365 #define SHDID_NET_RESTOFNET         16
366 #define SHDID_NET_OTHER             17
367 #define SHDID_COMPUTER_IMAGING      18
368 #define SHDID_COMPUTER_AUDIO        19
369 #define SHDID_COMPUTER_SHAREDDOCS   20
370
371 typedef struct _SHDESCRIPTIONID
372 {   DWORD   dwDescriptionId;
373     CLSID   clsid;
374 } SHDESCRIPTIONID, *LPSHDESCRIPTIONID;
375
376 HRESULT WINAPI SHGetDataFromIDListA(LPSHELLFOLDER psf, LPCITEMIDLIST pidl, int nFormat, LPVOID pv, int cb);
377 HRESULT WINAPI SHGetDataFromIDListW(LPSHELLFOLDER psf, LPCITEMIDLIST pidl, int nFormat, LPVOID pv, int cb);
378 #define  SHGetDataFromIDList WINELIB_NAME_AW(SHGetDataFromIDList)
379
380 BOOL WINAPI SHGetSpecialFolderPathA (HWND hwndOwner, LPSTR szPath, int nFolder, BOOL bCreate);
381 BOOL WINAPI SHGetSpecialFolderPathW (HWND hwndOwner, LPWSTR szPath, int nFolder, BOOL bCreate);
382 #define  SHGetSpecialFolderPath WINELIB_NAME_AW(SHGetSpecialFolderPath)
383
384 /****************************************************************************
385 * shlview structures
386 */
387
388 /*
389 * IShellFolderViewCallback Callback
390 *  This "callback" is called by the shells default IShellView implementation (that
391 *  we got using SHCreateShellViewEx()), to notify us of the various things that
392 *  are happening to the shellview (and ask for things too).
393 *
394 *  You don't have to support anything here - anything you don't want to
395 *  handle, the shell will do itself if you just return E_NOTIMPL. This parameters
396 *  that the shell passes to this function are entirely undocumented.
397 *
398 *  HOWEVER, as the cabview sample as originally written used this callback, the
399 *  writers implemented the callback mechanism on top of their own IShellView.
400 *  Look there for some clues on what to do here.
401 */
402
403 typedef HRESULT (CALLBACK *SHELLVIEWPROC)(DWORD dwUserParam,LPSHELLFOLDER psf,
404                          HWND hwnd,UINT uMsg,UINT wParam,LPARAM lParam);
405
406 /* NF valid values for the "viewmode" item of the SHELLTEMPLATE*/
407 #define NF_INHERITVIEW    0x0000
408 #define NF_LOCALVIEW        0x0001
409
410 typedef struct _SHELLVIEWDATA   /* idl */
411 { DWORD           dwSize;
412   LPSHELLFOLDER   pShellFolder;
413   DWORD           dwUserParam;
414   LPCITEMIDLIST   pidl;
415   DWORD           v3;        /* always 0 */
416   SHELLVIEWPROC   pCallBack;
417   DWORD           viewmode;  /* NF_* enum */
418 } SHELLVIEWDATA, * LPSHELLVIEWDATA;
419
420 HRESULT WINAPI SHGetMalloc(LPMALLOC *lpmal) ;
421
422 /**********************************************************************
423  * SHGetSetSettings ()
424  */
425
426 typedef struct
427 {
428     BOOL fShowAllObjects : 1;
429     BOOL fShowExtensions : 1;
430     BOOL fNoConfirmRecycle : 1;
431
432     BOOL fShowSysFiles : 1;
433     BOOL fShowCompColor : 1;
434     BOOL fDoubleClickInWebView : 1;
435     BOOL fDesktopHTML : 1;
436     BOOL fWin95Classic : 1;
437     BOOL fDontPrettyPath : 1;
438     BOOL fShowAttribCol : 1;
439     BOOL fMapNetDrvBtn : 1;
440     BOOL fShowInfoTip : 1;
441     BOOL fHideIcons : 1;
442     BOOL fWebView : 1;
443     BOOL fFilter : 1;
444     BOOL fShowSuperHidden : 1;
445     BOOL fNoNetCrawling : 1;
446
447     DWORD dwWin95Unused;
448     UINT  uWin95Unused;
449     LONG   lParamSort;
450     int    iSortDirection;
451     UINT   version;
452     UINT uNotUsed;
453     BOOL fSepProcess: 1;
454     BOOL fStartPanelOn: 1;
455     BOOL fShowStartPage: 1;
456     UINT fSpareFlags : 13;
457 } SHELLSTATE, *LPSHELLSTATE;
458
459 /**********************************************************************
460  * SHGetSettings ()
461  */
462 typedef struct
463 {       BOOL fShowAllObjects : 1;
464         BOOL fShowExtensions : 1;
465         BOOL fNoConfirmRecycle : 1;
466         BOOL fShowSysFiles : 1;
467
468         BOOL fShowCompColor : 1;
469         BOOL fDoubleClickInWebView : 1;
470         BOOL fDesktopHTML : 1;
471         BOOL fWin95Classic : 1;
472
473         BOOL fDontPrettyPath : 1;
474         BOOL fShowAttribCol : 1;
475         BOOL fMapNetDrvBtn : 1;
476         BOOL fShowInfoTip : 1;
477
478         BOOL fHideIcons : 1;
479         UINT fRestFlags : 3;
480 } SHELLFLAGSTATE, * LPSHELLFLAGSTATE;
481
482 VOID WINAPI SHGetSettings(LPSHELLFLAGSTATE lpsfs, DWORD dwMask);
483
484 #define SSF_SHOWALLOBJECTS              0x0001
485 #define SSF_SHOWEXTENSIONS              0x0002
486 #define SSF_SHOWCOMPCOLOR               0x0008
487 #define SSF_SHOWSYSFILES                0x0020
488 #define SSF_DOUBLECLICKINWEBVIEW        0x0080
489 #define SSF_SHOWATTRIBCOL               0x0100
490 #define SSF_DESKTOPHTML                 0x0200
491 #define SSF_WIN95CLASSIC                0x0400
492 #define SSF_DONTPRETTYPATH              0x0800
493 #define SSF_SHOWINFOTIP                 0x2000
494 #define SSF_MAPNETDRVBUTTON             0x1000
495 #define SSF_NOCONFIRMRECYCLE            0x8000
496 #define SSF_HIDEICONS                   0x4000
497
498 /****************************************************************************
499 * SHRestricted API
500 */
501 typedef enum RESTRICTIONS
502 {
503         REST_NONE                       = 0x00000000,
504         REST_NORUN                      = 0x00000001,
505         REST_NOCLOSE                    = 0x00000002,
506         REST_NOSAVESET                  = 0x00000004,
507         REST_NOFILEMENU                 = 0x00000008,
508         REST_NOSETFOLDERS               = 0x00000010,
509         REST_NOSETTASKBAR               = 0x00000020,
510         REST_NODESKTOP                  = 0x00000040,
511         REST_NOFIND                     = 0x00000080,
512         REST_NODRIVES                   = 0x00000100,
513         REST_NODRIVEAUTORUN             = 0x00000200,
514         REST_NODRIVETYPEAUTORUN         = 0x00000400,
515         REST_NONETHOOD                  = 0x00000800,
516         REST_STARTBANNER                = 0x00001000,
517         REST_RESTRICTRUN                = 0x00002000,
518         REST_NOPRINTERTABS              = 0x00004000,
519         REST_NOPRINTERDELETE            = 0x00008000,
520         REST_NOPRINTERADD               = 0x00010000,
521         REST_NOSTARTMENUSUBFOLDERS      = 0x00020000,
522         REST_MYDOCSONNET                = 0x00040000,
523         REST_NOEXITTODOS                = 0x00080000,
524         REST_ENFORCESHELLEXTSECURITY    = 0x00100000,
525         REST_LINKRESOLVEIGNORELINKINFO  = 0x00200000,
526         REST_NOCOMMONGROUPS             = 0x00400000,
527         REST_SEPARATEDESKTOPPROCESS     = 0x00800000,
528         REST_NOWEB                      = 0x01000000,
529         REST_NOTRAYCONTEXTMENU          = 0x02000000,
530         REST_NOVIEWCONTEXTMENU          = 0x04000000,
531         REST_NONETCONNECTDISCONNECT     = 0x08000000,
532         REST_STARTMENULOGOFF            = 0x10000000,
533         REST_NOSETTINGSASSIST           = 0x20000000,
534         REST_NOINTERNETICON             = 0x40000001,
535         REST_NORECENTDOCSHISTORY,
536         REST_NORECENTDOCSMENU,
537         REST_NOACTIVEDESKTOP,
538         REST_NOACTIVEDESKTOPCHANGES,
539         REST_NOFAVORITESMENU,
540         REST_CLEARRECENTDOCSONEXIT,
541         REST_CLASSICSHELL,
542         REST_NOCUSTOMIZEWEBVIEW,
543
544         REST_NOHTMLWALLPAPER            = 0x40000010,
545         REST_NOCHANGINGWALLPAPER,
546         REST_NODESKCOMP,
547         REST_NOADDDESKCOMP,
548         REST_NODELDESKCOMP,
549         REST_NOCLOSEDESKCOMP,
550         REST_NOCLOSE_DRAGDROPBAND,
551         REST_NOMOVINGBAND,
552         REST_NOEDITDESKCOMP,
553         REST_NORESOLVESEARCH,
554         REST_NORESOLVETRACK,
555         REST_FORCECOPYACLWITHFILE,
556         REST_NOLOGO3CHANNELNOTIFY,
557         REST_NOFORGETSOFTWAREUPDATE,
558         REST_NOSETACTIVEDESKTOP,
559         REST_NOUPDATEWINDOWS,
560         REST_NOCHANGESTARMENU,          /* 0x40000020 */
561         REST_NOFOLDEROPTIONS,
562         REST_HASFINDCOMPUTERS,
563         REST_INTELLIMENUS,
564         REST_RUNDLGMEMCHECKBOX,
565         REST_ARP_ShowPostSetup,
566         REST_NOCSC,
567         REST_NOCONTROLPANEL,
568         REST_ENUMWORKGROUP,
569         REST_ARP_NOARP,
570         REST_ARP_NOREMOVEPAGE,
571         REST_ARP_NOADDPAGE,
572         REST_ARP_NOWINSETUPPAGE,
573         REST_GREYMSIADS,
574         REST_NOCHANGEMAPPEDDRIVELABEL,
575         REST_NOCHANGEMAPPEDDRIVECOMMENT,
576         REST_MaxRecentDocs,             /* 0x40000030 */
577         REST_NONETWORKCONNECTIONS,
578         REST_FORCESTARTMENULOGOFF,
579         REST_NOWEBVIEW,
580         REST_NOCUSTOMIZETHISFOLDER,
581         REST_NOENCRYPTION,
582
583         REST_ALLOWFRENCHENCRYPTION,     /* not documented */
584
585         REST_DONTSHOWSUPERHIDDEN,
586         REST_NOSHELLSEARCHBUTTON,
587         REST_NOHARDWARETAB,
588         REST_NORUNASINSTALLPROMPT,
589         REST_PROMPTRUNASINSTALLNETPATH,
590         REST_NOMANAGEMYCOMPUTERVERB,
591         REST_NORECENTDOCSNETHOOD,
592         REST_DISALLOWRUN,
593         REST_NOWELCOMESCREEN,
594         REST_RESTRICTCPL,               /* 0x40000040 */
595         REST_DISALLOWCPL,
596         REST_NOSMBALLOONTIP,
597         REST_NOSMHELP,
598         REST_NOWINKEYS,
599         REST_NOENCRYPTONMOVE,
600         REST_NOLOCALMACHINERUN,
601         REST_NOCURRENTUSERRUN,
602         REST_NOLOCALMACHINERUNONCE,
603         REST_NOCURRENTUSERRUNONCE,
604         REST_FORCEACTIVEDESKTOPON,
605         REST_NOCOMPUTERSNEARME,
606         REST_NOVIEWONDRIVE,
607         REST_NONETCRAWL,
608         REST_NOSHAREDDOCUMENTS,
609         REST_NOSMMYDOCS,
610         REST_NOSMMYPICS,                /* 0x40000050 */
611         REST_ALLOWBITBUCKDRIVES,
612         REST_NONLEGACYSHELLMODE,
613         REST_NOCONTROLPANELBARRICADE,
614         REST_NOSTARTPAGE,
615         REST_NOAUTOTRAYNOTIFY,
616         REST_NOTASKGROUPING,
617         REST_NOCDBURNING,
618         REST_MYCOMPNOPROP,
619         REST_MYDOCSNOPROP,
620         REST_NOSTARTPANEL,
621         REST_NODISPLAYAPPEARANCEPAGE,
622         REST_NOTHEMESTAB,
623         REST_NOVISUALSTYLECHOICE,
624         REST_NOSIZECHOICE,
625         REST_NOCOLORCHOICE,
626         REST_SETVISUALSTYLE,            /* 0x40000060 */
627         REST_STARTRUNNOHOMEPATH,
628         REST_NOUSERNAMEINSTARTPANEL,
629         REST_NOMYCOMPUTERICON,
630         REST_NOSMNETWORKPLACES,
631         REST_NOSMPINNEDLIST,
632         REST_NOSMMYMUSIC,
633         REST_NOSMEJECTPC,
634         REST_NOSMMOREPROGRAMS,
635         REST_NOSMMFUPROGRAMS,
636         REST_NOTRAYITEMSDISPLAY,
637         REST_NOTOOLBARSONTASKBAR,
638         /* 0x4000006C
639            0x4000006D
640            0x4000006E */
641         REST_NOSMCONFIGUREPROGRAMS      = 0x4000006F,
642         REST_HIDECLOCK,                 /* 0x40000070 */
643         REST_NOLOWDISKSPACECHECKS,
644         REST_NOENTIRENETWORK,
645         REST_NODESKTOPCLEANUP,
646         REST_BITBUCKNUKEONDELETE,
647         REST_BITBUCKCONFIRMDELETE,
648         REST_BITBUCKNOPROP,
649         REST_NODISPBACKGROUND,
650         REST_NODISPSCREENSAVEPG,
651         REST_NODISPSETTINGSPG,
652         REST_NODISPSCREENSAVEPREVIEW,
653         REST_NODISPLAYCPL,
654         REST_HIDERUNASVERB,
655         REST_NOTHUMBNAILCACHE,
656         REST_NOSTRCMPLOGICAL,
657         REST_NOPUBLISHWIZARD,
658         REST_NOONLINEPRINTSWIZARD,      /* 0x40000080 */
659         REST_NOWEBSERVICES,
660         REST_ALLOWUNHASHEDWEBVIEW,
661         REST_ALLOWLEGACYWEBVIEW,
662         REST_REVERTWEBVIEWSECURITY,
663         
664         REST_INHERITCONSOLEHANDLES      = 0x40000086,
665
666         REST_NODISCONNECT               = 0x41000001,
667         REST_NOSECURITY,
668         REST_NOFILEASSOCIATE,           /* 0x41000003 */
669 } RESTRICTIONS;
670
671 DWORD WINAPI SHRestricted(RESTRICTIONS rest);
672
673 /****************************************************************************
674 * SHChangeNotify API
675 */
676 typedef struct _SHChangeNotifyEntry
677 {
678     LPCITEMIDLIST pidl;
679     BOOL   fRecursive;
680 } SHChangeNotifyEntry;
681
682 #define SHCNE_RENAMEITEM        0x00000001
683 #define SHCNE_CREATE            0x00000002
684 #define SHCNE_DELETE            0x00000004
685 #define SHCNE_MKDIR             0x00000008
686 #define SHCNE_RMDIR             0x00000010
687 #define SHCNE_MEDIAINSERTED     0x00000020
688 #define SHCNE_MEDIAREMOVED      0x00000040
689 #define SHCNE_DRIVEREMOVED      0x00000080
690 #define SHCNE_DRIVEADD          0x00000100
691 #define SHCNE_NETSHARE          0x00000200
692 #define SHCNE_NETUNSHARE        0x00000400
693 #define SHCNE_ATTRIBUTES        0x00000800
694 #define SHCNE_UPDATEDIR         0x00001000
695 #define SHCNE_UPDATEITEM        0x00002000
696 #define SHCNE_SERVERDISCONNECT  0x00004000
697 #define SHCNE_UPDATEIMAGE       0x00008000
698 #define SHCNE_DRIVEADDGUI       0x00010000
699 #define SHCNE_RENAMEFOLDER      0x00020000
700 #define SHCNE_FREESPACE         0x00040000
701
702 #define SHCNE_EXTENDED_EVENT    0x04000000
703 #define SHCNE_ASSOCCHANGED      0x08000000
704 #define SHCNE_DISKEVENTS        0x0002381F
705 #define SHCNE_GLOBALEVENTS      0x0C0581E0
706 #define SHCNE_ALLEVENTS         0x7FFFFFFF
707 #define SHCNE_INTERRUPT         0x80000000
708
709 #define SHCNEE_ORDERCHANGED     0x0002L
710 #define SHCNEE_MSI_CHANGE       0x0004L
711 #define SHCNEE_MSI_UNINSTALL    0x0005L
712
713 #define SHCNF_IDLIST            0x0000
714 #define SHCNF_PATHA             0x0001
715 #define SHCNF_PRINTERA          0x0002
716 #define SHCNF_DWORD             0x0003
717 #define SHCNF_PATHW             0x0005
718 #define SHCNF_PRINTERW          0x0006
719 #define SHCNF_TYPE              0x00FF
720 #define SHCNF_FLUSH             0x1000
721 #define SHCNF_FLUSHNOWAIT       0x2000
722
723 #define SHCNF_PATH              WINELIB_NAME_AW(SHCNF_PATH)
724 #define SHCNF_PRINTER           WINELIB_NAME_AW(SHCNF_PRINTER)
725
726 void WINAPI SHChangeNotify(LONG wEventId, UINT uFlags, LPCVOID dwItem1, LPCVOID dwItem2);
727
728 /*
729  * IShellChangeNotify
730  */
731 typedef struct IShellChangeNotify IShellChangeNotify, *LPSHELLCHANGENOTIFY;
732
733 #define INTERFACE IShellChangeNotify
734 #define IShellChangeNotify_METHODS \
735     IUnknown_METHODS \
736     STDMETHOD(OnChange)(THIS_ LONG lEvent, LPCITEMIDLIST pidl1, LPCITEMIDLIST pidl2) PURE;
737
738 ICOM_DEFINE(IShellChangeNotify, IUnknown)
739 #undef INTERFACE
740
741 #ifdef COBJMACROS
742 /*** IUnknown methods ***/
743 #define IShellChangeNotify_QueryInterface(p,a,b)      (p)->lpVtbl->QueryInterface(p,a,b)
744 #define IShellChangeNotify_AddRef(p)                  (p)->lpVtbl->AddRef(p)
745 #define IShellChangeNotify_Release(p)                 (p)->lpVtbl->Release(p)
746 /*** IShellChangeNotify methods ***/
747 #define IShellChangeNotify_OnChange(p,a,b,c)         (p)->lpVtbl->OnChange(p,a,b,c)
748 #endif
749
750 typedef struct _SHChangeDWORDAsIDList {
751     USHORT   cb;
752     DWORD    dwItem1;
753     DWORD    dwItem2;
754     USHORT   cbZero;
755 } SHChangeDWORDAsIDList, *LPSHChangeDWORDAsIDList;
756
757 typedef struct _SHChangeProductKeyAsIDList {
758     USHORT cb;
759     WCHAR wszProductKey[39];
760     USHORT cbZero;
761 } SHChangeProductKeyAsIDList, *LPSHChangeProductKeyAsIDList;
762
763 ULONG WINAPI SHChangeNotifyRegister(HWND hwnd, int fSources, LONG fEvents, UINT wMsg,
764                                     int cEntries, SHChangeNotifyEntry *pshcne);
765 BOOL WINAPI SHChangeNotifyDeregister(ULONG ulID);
766 HANDLE WINAPI SHChangeNotification_Lock(HANDLE hChangeNotification, DWORD dwProcessId,
767                                         LPITEMIDLIST **pppidl, LONG *plEvent);
768 BOOL WINAPI SHChangeNotification_Unlock(HANDLE hLock);
769
770 HRESULT WINAPI SHGetRealIDL(IShellFolder *psf, LPCITEMIDLIST pidlSimple, LPITEMIDLIST * ppidlReal);
771
772 /****************************************************************************
773 * SHCreateDirectory API
774 */
775 DWORD WINAPI SHCreateDirectory(HWND, LPCVOID);
776 DWORD WINAPI SHCreateDirectoryExA(HWND, LPCSTR, LPSECURITY_ATTRIBUTES);
777 DWORD WINAPI SHCreateDirectoryExW(HWND, LPCWSTR, LPSECURITY_ATTRIBUTES);
778
779 /****************************************************************************
780 * SHGetSpecialFolderLocation API
781 */
782 HRESULT WINAPI SHGetSpecialFolderLocation(HWND hwndOwner, int nFolder, LPITEMIDLIST * ppidl);
783 HRESULT WINAPI SHGetFolderLocation(HWND hwndOwner, int nFolder, HANDLE hToken, DWORD dwReserved, LPITEMIDLIST *ppidl);
784
785 #define CSIDL_DESKTOP           0x0000
786 #define CSIDL_INTERNET          0x0001
787 #define CSIDL_PROGRAMS          0x0002
788 #define CSIDL_CONTROLS          0x0003
789 #define CSIDL_PRINTERS          0x0004
790 #define CSIDL_PERSONAL          0x0005
791 #define CSIDL_FAVORITES         0x0006
792 #define CSIDL_STARTUP           0x0007
793 #define CSIDL_RECENT            0x0008
794 #define CSIDL_SENDTO            0x0009
795 #define CSIDL_BITBUCKET         0x000a
796 #define CSIDL_STARTMENU         0x000b
797 #define CSIDL_MYDOCUMENTS       0x000c
798 #define CSIDL_MYMUSIC           0x000d
799 #define CSIDL_MYVIDEO           0x000e
800 #define CSIDL_DESKTOPDIRECTORY  0x0010
801 #define CSIDL_DRIVES            0x0011
802 #define CSIDL_NETWORK           0x0012
803 #define CSIDL_NETHOOD           0x0013
804 #define CSIDL_FONTS             0x0014
805 #define CSIDL_TEMPLATES         0x0015
806 #define CSIDL_COMMON_STARTMENU  0x0016
807 #define CSIDL_COMMON_PROGRAMS   0X0017
808 #define CSIDL_COMMON_STARTUP    0x0018
809 #define CSIDL_COMMON_DESKTOPDIRECTORY   0x0019
810 #define CSIDL_APPDATA           0x001a
811 #define CSIDL_PRINTHOOD         0x001b
812 #define CSIDL_LOCAL_APPDATA     0x001c
813 #define CSIDL_ALTSTARTUP        0x001d
814 #define CSIDL_COMMON_ALTSTARTUP 0x001e
815 #define CSIDL_COMMON_FAVORITES  0x001f
816 #define CSIDL_INTERNET_CACHE    0x0020
817 #define CSIDL_COOKIES           0x0021
818 #define CSIDL_HISTORY           0x0022
819 #define CSIDL_COMMON_APPDATA    0x0023
820 #define CSIDL_WINDOWS           0x0024
821 #define CSIDL_SYSTEM            0x0025
822 #define CSIDL_PROGRAM_FILES     0x0026
823 #define CSIDL_MYPICTURES        0x0027
824 #define CSIDL_PROFILE           0x0028
825 #define CSIDL_SYSTEMX86         0x0029
826 #define CSIDL_PROGRAM_FILESX86  0x002a
827 #define CSIDL_PROGRAM_FILES_COMMON      0x002b
828 #define CSIDL_PROGRAM_FILES_COMMONX86   0x002c
829 #define CSIDL_COMMON_TEMPLATES  0x002d
830 #define CSIDL_COMMON_DOCUMENTS  0x002e
831 #define CSIDL_COMMON_ADMINTOOLS 0x002f
832 #define CSIDL_ADMINTOOLS        0x0030
833 #define CSIDL_CONNECTIONS       0x0031
834 #define CSIDL_COMMON_MUSIC      0x0035
835 #define CSIDL_COMMON_PICTURES   0x0036
836 #define CSIDL_COMMON_VIDEO      0x0037
837 #define CSIDL_RESOURCES         0x0038
838 #define CSIDL_RESOURCES_LOCALIZED 0x0039
839 #define CSIDL_COMMON_OEM_LINKS  0x003a
840 #define CSIDL_CDBURN_AREA       0x003b
841 #define CSIDL_COMPUTERSNEARME   0x003d
842 #define CSIDL_PROFILES          0x003e
843 #define CSIDL_FOLDER_MASK       0x00ff
844 #define CSIDL_FLAG_PER_USER_INIT 0x0800
845 #define CSIDL_FLAG_NO_ALIAS     0x1000
846 #define CSIDL_FLAG_DONT_VERIFY  0x4000
847 #define CSIDL_FLAG_CREATE       0x8000
848
849 #define CSIDL_FLAG_MASK         0xff00
850
851 /****************************************************************************
852  * SHGetDesktopFolder API
853  */
854 DWORD WINAPI SHGetDesktopFolder(IShellFolder * *);
855
856 /****************************************************************************
857  * SHBindToParent API
858  */
859 HRESULT WINAPI SHBindToParent(LPCITEMIDLIST pidl, REFIID riid, LPVOID *ppv, LPCITEMIDLIST *ppidlLast);
860
861 /****************************************************************************
862 * SHDefExtractIcon API
863 */
864 HRESULT WINAPI SHDefExtractIconA(LPCSTR pszIconFile, int iIndex, UINT uFlags,
865                                  HICON* phiconLarge, HICON* phiconSmall, UINT nIconSize);
866 HRESULT WINAPI SHDefExtractIconW(LPCWSTR pszIconFile, int iIndex, UINT uFlags,
867                                  HICON* phiconLarge, HICON* phiconSmall, UINT nIconSize);
868 #define        SHDefExtractIcon WINELIB_NAME_AW(SHDefExtractIcon)
869
870 /*
871  * DROPFILES for CF_HDROP and CF_PRINTERS
872  */
873 typedef struct _DROPFILES
874 {
875   DWORD pFiles;
876   POINT pt;
877   BOOL  fNC;
878   BOOL  fWide;
879 } DROPFILES, *LPDROPFILES;
880
881 #include <poppack.h> 
882
883 /*****************************************************************************
884  * IFileSystemBindData interface
885  */
886 #ifndef __IFileSystemBindData_FWD_DEFINED__
887 #define __IFileSystemBindData_FWD_DEFINED__
888 typedef struct IFileSystemBindData IFileSystemBindData;
889 #endif
890
891 typedef IFileSystemBindData *LPFILESYSTEMBINDDATA;
892
893 #ifndef __IFileSystemBindData_INTERFACE_DEFINED__
894 #define __IFileSystemBindData_INTERFACE_DEFINED__
895
896 DEFINE_GUID(IID_IFileSystemBindData, 0x01e18d10, 0x4d8b, 0x11d2, 0x85,0x5d, 0x00,0x60,0x08,0x05,0x93,0x67);
897 #if defined(__cplusplus) && !defined(CINTERFACE)
898 struct IFileSystemBindData : public IUnknown
899 {
900     virtual HRESULT STDMETHODCALLTYPE GetFindData(
901         WIN32_FIND_DATAW* pfd) = 0;
902
903     virtual HRESULT STDMETHODCALLTYPE SetFindData(
904         const WIN32_FIND_DATAW* pfd) = 0;
905
906 };
907 #else
908 typedef struct IFileSystemBindDataVtbl IFileSystemBindDataVtbl;
909 struct IFileSystemBindData {
910     const IFileSystemBindDataVtbl* lpVtbl;
911 };
912 struct IFileSystemBindDataVtbl {
913     ICOM_MSVTABLE_COMPAT_FIELDS
914
915     /*** IUnknown methods ***/
916     HRESULT (STDMETHODCALLTYPE *QueryInterface)(
917         IFileSystemBindData* This,
918         REFIID riid,
919         void** ppvObject);
920
921     ULONG (STDMETHODCALLTYPE *AddRef)(
922         IFileSystemBindData* This);
923
924     ULONG (STDMETHODCALLTYPE *Release)(
925         IFileSystemBindData* This);
926
927     /*** IFileSystemBindData methods ***/
928     HRESULT (STDMETHODCALLTYPE *GetFindData)(
929         IFileSystemBindData* This,
930         WIN32_FIND_DATAW* pfd);
931
932     HRESULT (STDMETHODCALLTYPE *SetFindData)(
933         IFileSystemBindData* This,
934         const WIN32_FIND_DATAW* pfd);
935
936 };
937
938 /*** IUnknown methods ***/
939 #define IFileSystemBindData_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
940 #define IFileSystemBindData_AddRef(p) (p)->lpVtbl->AddRef(p)
941 #define IFileSystemBindData_Release(p) (p)->lpVtbl->Release(p)
942 /*** IFileSystemBindData methods ***/
943 #define IFileSystemBindData_GetFindData(p,a) (p)->lpVtbl->GetFindData(p,a)
944 #define IFileSystemBindData_SetFindData(p,a) (p)->lpVtbl->SetFindData(p,a)
945
946 #endif
947
948 #define IFileSystemBindData_METHODS \
949     ICOM_MSVTABLE_COMPAT_FIELDS \
950     /*** IUnknown methods ***/ \
951     STDMETHOD_(HRESULT,QueryInterface)(THIS_ REFIID riid, void** ppvObject) PURE; \
952     STDMETHOD_(ULONG,AddRef)(THIS) PURE; \
953     STDMETHOD_(ULONG,Release)(THIS) PURE; \
954     /*** IFileSystemBindData methods ***/ \
955     STDMETHOD_(HRESULT,GetFindData)(THIS_ WIN32_FIND_DATAW* pfd) PURE; \
956     STDMETHOD_(HRESULT,SetFindData)(THIS_ const WIN32_FIND_DATAW* pfd) PURE;
957
958 #endif  /* __IFileSystemBindData_INTERFACE_DEFINED__ */
959
960
961 #ifdef __cplusplus
962 } /* extern "C" */
963 #endif /* defined(__cplusplus) */
964
965 #endif /* __WINE_SHLOBJ_H */