xref: /reactos/sdk/include/psdk/shlobj.h (revision f308c6a2)
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., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, 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 
26 #ifndef INITGUID
27 #include <shlguid.h>
28 #endif
29 
30 #ifdef WINE_NO_UNICODE_MACROS
31 #undef GetObject
32 #endif
33 
34 #ifdef __cplusplus
35 extern "C" {
36 #endif /* defined(__cplusplus) */
37 
38 /* Except for specific structs, this header is byte packed */
39 #include <pshpack1.h>
40 
41 #include <shtypes.h>
42 #include <shobjidl.h>
43 
44 #include <pshpack8.h>
45 
46 typedef struct
47 {
48     DWORD         dwSize;
49     DWORD         dwMask;
50     SHELLVIEWID*  pvid;
51     LPSTR         pszWebViewTemplate;
52     DWORD         cchWebViewTemplate;
53     LPSTR         pszWebViewTemplateVersion;
54     LPSTR         pszInfoTip;
55     DWORD         cchInfoTip;
56     CLSID*        pclsid;
57     DWORD         dwFlags;
58     LPSTR         pszIconFile;
59     DWORD         cchIconFile;
60     int           iIconIndex;
61     LPSTR         pszLogo;
62     DWORD         cchLogo;
63 } SHFOLDERCUSTOMSETTINGSA, *LPSHFOLDERCUSTOMSETTINGSA;
64 
65 typedef struct
66 {
67     DWORD         dwSize;
68     DWORD         dwMask;
69     SHELLVIEWID*  pvid;
70     LPWSTR        pszWebViewTemplate;
71     DWORD         cchWebViewTemplate;
72     LPWSTR        pszWebViewTemplateVersion;
73     LPWSTR        pszInfoTip;
74     DWORD         cchInfoTip;
75     CLSID*        pclsid;
76     DWORD         dwFlags;
77     LPWSTR        pszIconFile;
78     DWORD         cchIconFile;
79     int           iIconIndex;
80     LPWSTR        pszLogo;
81     DWORD         cchLogo;
82 } SHFOLDERCUSTOMSETTINGSW, *LPSHFOLDERCUSTOMSETTINGSW;
83 
84 #include <poppack.h>
85 
86 #define FCS_READ       0x00000001
87 #define FCS_FORCEWRITE 0x00000002
88 
89 #define FCSM_ICONFILE 0x00000010
90 
91 #ifndef HPSXA_DEFINED
92 #define HPSXA_DEFINED
93 DECLARE_HANDLE(HPSXA);
94 #endif
95 
96 typedef enum
97 {
98     KF_FLAG_DEFAULT                     = 0x00000000,
99     KF_FLAG_SIMPLE_IDLIST               = 0x00000100,
100     KF_FLAG_NOT_PARENT_RELATIVE         = 0x00000200,
101     KF_FLAG_DEFAULT_PATH                = 0x00000400,
102     KF_FLAG_INIT                        = 0x00000800,
103     KF_FLAG_NO_ALIAS                    = 0x00001000,
104     KF_FLAG_DONT_UNEXPAND               = 0x00002000,
105     KF_FLAG_DONT_VERIFY                 = 0x00004000,
106     KF_FLAG_CREATE                      = 0x00008000,
107     KF_FLAG_NO_APPCONTAINER_REDIRECTION = 0x00010000,
108     KF_FLAG_ALIAS_ONLY                  = 0x80000000
109 } KNOWN_FOLDER_FLAG;
110 
111 typedef int GPFIDL_FLAGS;
112 
113 UINT
114 WINAPI
115 SHAddFromPropSheetExtArray(
116   _In_ HPSXA,
117   _In_ LPFNADDPROPSHEETPAGE,
118   LPARAM);
119 
120 LPVOID       WINAPI SHAlloc(SIZE_T) __WINE_ALLOC_SIZE(1);
121 
122 HRESULT
123 WINAPI
124 SHCoCreateInstance(
125   _In_opt_ LPCWSTR,
126   _In_opt_ const CLSID*,
127   _In_opt_ IUnknown*,
128   _In_ REFIID,
129   _Outptr_ LPVOID*);
130 
131 HPSXA        WINAPI SHCreatePropSheetExtArray(_In_ HKEY, _In_opt_ LPCWSTR, UINT);
132 HPSXA        WINAPI SHCreatePropSheetExtArrayEx(HKEY,LPCWSTR,UINT,IDataObject*);
133 HRESULT      WINAPI SHCreateQueryCancelAutoPlayMoniker(IMoniker**);
134 
135 HRESULT
136 WINAPI
137 SHCreateShellItem(
138   _In_opt_ PCIDLIST_ABSOLUTE,
139   _In_opt_ IShellFolder*,
140   _In_ PCUITEMID_CHILD,
141   _Outptr_ IShellItem**);
142 
143 DWORD        WINAPI SHCLSIDFromStringA(_In_ LPCSTR, _Out_ CLSID*);
144 DWORD        WINAPI SHCLSIDFromStringW(_In_ LPCWSTR, _Out_ CLSID*);
145 #define             SHCLSIDFromString WINELIB_NAME_AW(SHCLSIDFromString)
146 
147 HRESULT
148 WINAPI
149 SHCreateStdEnumFmtEtc(
150   _In_ UINT cfmt,
151   _In_reads_(cfmt) const FORMATETC *,
152   _Outptr_ IEnumFORMATETC**);
153 
154 void         WINAPI SHDestroyPropSheetExtArray(_In_ HPSXA);
155 BOOL         WINAPI SHFindFiles(_In_opt_ PCIDLIST_ABSOLUTE, _In_opt_ PCIDLIST_ABSOLUTE);
156 DWORD        WINAPI SHFormatDrive(_In_ HWND, UINT, UINT, UINT);
157 void         WINAPI SHFree(_In_opt_ LPVOID);
158 
159 BOOL
160 WINAPI
161 GetFileNameFromBrowse(
162   _In_opt_ HWND,
163   _Inout_updates_(cchFilePath) LPWSTR,
164   UINT cchFilePath,
165   _In_opt_ LPCWSTR,
166   _In_ LPCWSTR,
167   _In_opt_ LPCWSTR,
168   _In_opt_ LPCWSTR);
169 
170 _Check_return_ HRESULT WINAPI SHGetInstanceExplorer(_Outptr_ IUnknown**);
171 
172 VOID         WINAPI SHSetInstanceExplorer(_In_opt_ IUnknown*);
173 
174 HRESULT
175 WINAPI
176 SHGetFolderPathAndSubDirA(
177   _Reserved_ HWND,
178   _In_ int,
179   _In_opt_ HANDLE,
180   _In_ DWORD,
181   _In_opt_ LPCSTR, _Out_writes_(MAX_PATH) LPSTR);
182 
183 HRESULT
184 WINAPI
185 SHGetFolderPathAndSubDirW(
186   _Reserved_ HWND,
187   _In_ int,
188   _In_opt_ HANDLE,
189   _In_ DWORD,
190   _In_opt_ LPCWSTR,
191   _Out_writes_(MAX_PATH) LPWSTR);
192 
193 #define SHGetFolderPathAndSubDir WINELIB_NAME_AW(SHGetFolderPathAndSubDir);
194 
195 _Success_(return != 0)
196 BOOL
197 WINAPI
198 SHGetPathFromIDListA(
199   _In_ PCIDLIST_ABSOLUTE,
200   _Out_writes_(MAX_PATH) LPSTR);
201 
202 _Success_(return != 0)
203 BOOL
204 WINAPI
205 SHGetPathFromIDListW(
206   _In_ PCIDLIST_ABSOLUTE,
207   _Out_writes_(MAX_PATH) LPWSTR);
208 
209 #define SHGetPathFromIDList WINELIB_NAME_AW(SHGetPathFromIDList)
210 
211 INT          WINAPI SHHandleUpdateImage(_In_ PCIDLIST_ABSOLUTE);
212 
213 HRESULT
214 WINAPI
215 SHILCreateFromPath(
216   _In_ PCWSTR,
217   _Outptr_ PIDLIST_ABSOLUTE*,
218   _Inout_opt_ DWORD*);
219 
220 HRESULT      WINAPI SHLoadOLE(LPARAM);
221 
222 HRESULT
223 WINAPI
224 SHParseDisplayName(
225   _In_ PCWSTR pszName,
226   _In_opt_ IBindCtx* pbc,
227   _Outptr_ PIDLIST_ABSOLUTE* ppidl,
228   _In_ SFGAOF sfgaoIn,
229   _Out_opt_ SFGAOF* psfgaoOut);
230 
231 HRESULT
232 WINAPI
233 SHPathPrepareForWriteA(
234   _In_opt_ HWND,
235   _In_opt_ IUnknown*,
236   _In_ LPCSTR, DWORD);
237 
238 HRESULT
239 WINAPI
240 SHPathPrepareForWriteW(
241   _In_opt_ HWND,
242   _In_opt_ IUnknown*,
243   _In_ LPCWSTR, DWORD);
244 
245 #define SHPathPrepareForWrite WINELIB_NAME_AW(SHPathPrepareForWrite);
246 
247 UINT
248 WINAPI
249 SHReplaceFromPropSheetExtArray(
250   _In_ HPSXA,
251   UINT,
252   _In_ LPFNADDPROPSHEETPAGE,
253   LPARAM);
254 
255 PIDLIST_ABSOLUTE WINAPI SHSimpleIDListFromPath(PCWSTR);
256 
257 int
258 WINAPI
259 SHMapPIDLToSystemImageListIndex(
260   _In_ IShellFolder*,
261   _In_ PCUITEMID_CHILD,
262   _Out_opt_ int*);
263 
264 HRESULT      WINAPI SHStartNetConnectionDialog(HWND,LPCSTR,DWORD);
265 VOID         WINAPI SHUpdateImageA(_In_ LPCSTR, INT, UINT, INT);
266 VOID         WINAPI SHUpdateImageW(_In_ LPCWSTR, INT, UINT, INT);
267 #define             SHUpdateImage WINELIB_NAME_AW(SHUpdateImage)
268 
269 INT
270 WINAPI
271 PickIconDlg(
272   _In_opt_ HWND,
273   _Inout_updates_(cchIconPath) LPWSTR,
274   UINT cchIconPath,
275   _Inout_opt_ int *);
276 
277 HRESULT
278 WINAPI
279 SHLimitInputEdit(
280   _In_ HWND hwnd,
281   _In_ IShellFolder *folder);
282 
283 int          WINAPI RestartDialog(_In_opt_ HWND, _In_opt_ LPCWSTR, DWORD);
284 int          WINAPI RestartDialogEx(_In_opt_ HWND, _In_opt_ LPCWSTR, DWORD, DWORD);
285 int          WINAPI DriveType(int);
286 int          WINAPI RealDriveType(int, BOOL);
287 int          WINAPI IsNetDrive(int);
288 BOOL         WINAPI IsUserAnAdmin(void);
289 
290 #define KF_FLAG_DEFAULT_PATH        0x00000400
291 
292 #define SHFMT_ERROR     0xFFFFFFFFL  /* Error on last format, drive may be formattable */
293 #define SHFMT_CANCEL    0xFFFFFFFEL  /* Last format was cancelled */
294 #define SHFMT_NOFORMAT  0xFFFFFFFDL  /* Drive is not formattable */
295 
296 /* SHFormatDrive flags */
297 #define SHFMT_ID_DEFAULT	0xFFFF
298 #define SHFMT_OPT_FULL		1
299 #define SHFMT_OPT_SYSONLY	2
300 
301 /* SHPathPrepareForWrite flags */
302 #define SHPPFW_NONE             0x00000000
303 #define SHPPFW_DIRCREATE        0x00000001
304 #define SHPPFW_DEFAULT          SHPPFW_DIRCREATE
305 #define SHPPFW_ASKDIRCREATE     0x00000002
306 #define SHPPFW_IGNOREFILENAME   0x00000004
307 #define SHPPFW_NOWRITECHECK     0x00000008
308 #define SHPPFW_MEDIACHECKONLY   0x00000010
309 
310 /* SHObjectProperties flags */
311 #define SHOP_PRINTERNAME 0x01
312 #define SHOP_FILEPATH    0x02
313 #define SHOP_VOLUMEGUID  0x04
314 
315 BOOL
316 WINAPI
317 SHObjectProperties(
318   _In_opt_ HWND,
319   _In_ DWORD,
320   _In_ LPCWSTR,
321   _In_opt_ LPCWSTR);
322 
323 HRESULT
324 WINAPI
325 SHOpenFolderAndSelectItems(
326   _In_ PCIDLIST_ABSOLUTE pidlFolder,
327   _In_ UINT cidl,
328   _In_reads_opt_(cidl) PCUITEMID_CHILD_ARRAY,
329   _In_ DWORD);
330 
331 #define PCS_FATAL           0x80000000
332 #define PCS_REPLACEDCHAR    0x00000001
333 #define PCS_REMOVEDCHAR     0x00000002
334 #define PCS_TRUNCATED       0x00000004
335 #define PCS_PATHTOOLONG     0x00000008
336 
337 int WINAPI PathCleanupSpec(_In_opt_ LPCWSTR, _Inout_ LPWSTR);
338 
339 /*****************************************************************************
340  * IContextMenu interface
341  */
342 
343 
344 /* DATAOBJECT_InitShellIDList*/
345 #define CFSTR_SHELLIDLISTA           "Shell IDList Array"   /* CF_IDLIST */
346 #define CFSTR_SHELLIDLISTOFFSETA     "Shell Object Offsets" /* CF_OBJECTPOSITIONS */
347 #define CFSTR_NETRESOURCESA          "Net Resource"         /* CF_NETRESOURCE */
348 /* DATAOBJECT_InitFileGroupDesc */
349 #define CFSTR_FILEDESCRIPTORA        "FileGroupDescriptor"  /* CF_FILEGROUPDESCRIPTORA */
350 /* DATAOBJECT_InitFileContents*/
351 #define CFSTR_FILECONTENTSA          "FileContents"         /* CF_FILECONTENTS */
352 #define CFSTR_FILENAMEA              "FileName"             /* CF_FILENAMEA */
353 #define CFSTR_FILENAMEMAPA           "FileNameMap"          /* CF_FILENAMEMAPA */
354 #define CFSTR_PRINTERGROUPA          "PrinterFriendlyName"  /* CF_PRINTERS */
355 #define CFSTR_SHELLURLA              "UniformResourceLocator"
356 #define CFSTR_INETURLA               CFSTR_SHELLURLA
357 #define CFSTR_PREFERREDDROPEFFECTA   "Preferred DropEffect"
358 #define CFSTR_PERFORMEDDROPEFFECTA   "Performed DropEffect"
359 #define CFSTR_PASTESUCCEEDEDA        "Paste Succeeded"
360 #define CFSTR_INDRAGLOOPA            "InShellDragLoop"
361 #define CFSTR_DRAGCONTEXTA           "DragContext"
362 #define CFSTR_MOUNTEDVOLUMEA         "MountedVolume"
363 #define CFSTR_PERSISTEDDATAOBJECTA   "PersistedDataObject"
364 #define CFSTR_TARGETCLSIDA           "TargetCLSID"
365 #define CFSTR_AUTOPLAY_SHELLIDLISTSA "Autoplay Enumerated IDList Array"
366 #define CFSTR_LOGICALPERFORMEDDROPEFFECTA "Logical Performed DropEffect"
367 
368 #if defined(__GNUC__)
369 # define CFSTR_SHELLIDLISTW \
370     (const WCHAR []){ 'S','h','e','l','l',' ','I','D','L','i','s','t',' ','A','r','r','a','y',0 }
371 # define CFSTR_SHELLIDLISTOFFSETW \
372     (const WCHAR []){ 'S','h','e','l','l',' ','O','b','j','e','c','t',' ','O','f','f','s','e','t','s',0 }
373 # define CFSTR_NETRESOURCESW \
374     (const WCHAR []){ 'N','e','t',' ','R','e','s','o','u','r','c','e',0 }
375 # define CFSTR_FILEDESCRIPTORW \
376     (const WCHAR []){ 'F','i','l','e','G','r','o','u','p','D','e','s','c','r','i','p','t','o','r','W',0 }
377 # define CFSTR_FILECONTENTSW \
378     (const WCHAR []){ 'F','i','l','e','C','o','n','t','e','n','t','s',0 }
379 # define CFSTR_FILENAMEW \
380     (const WCHAR []){ 'F','i','l','e','N','a','m','e','W',0 }
381 # define CFSTR_FILENAMEMAPW \
382     (const WCHAR []){ 'F','i','l','e','N','a','m','e','M','a','p','W',0 }
383 # define CFSTR_PRINTERGROUPW \
384     (const WCHAR []){ 'P','r','i','n','t','e','r','F','r','i','e','n','d','l','y','N','a','m','e',0 }
385 # define CFSTR_SHELLURLW \
386     (const WCHAR []){ 'U','n','i','f','o','r','m','R','e','s','o','u','r','c','e','L','o','c','a','t','o','r',0 }
387 # define CFSTR_INETURLW \
388     (const WCHAR []){ 'U','n','i','f','o','r','m','R','e','s','o','u','r','c','e','L','o','c','a','t','o','r','W',0 }
389 # define CFSTR_PREFERREDDROPEFFECTW \
390     (const WCHAR []){ 'P','r','e','f','e','r','r','e','d',' ','D','r','o','p','E','f','f','e','c','t',0 }
391 # define CFSTR_PERFORMEDDROPEFFECTW \
392     (const WCHAR []){ 'P','e','r','f','o','r','m','e','d',' ','D','r','o','p','E','f','f','e','c','t',0 }
393 # define CFSTR_PASTESUCCEEDEDW \
394     (const WCHAR []){ 'P','a','s','t','e',' ','S','u','c','c','e','e','d','e','d',0 }
395 # define CFSTR_INDRAGLOOPW \
396     (const WCHAR []){ 'I','n','S','h','e','l','l','D','r','a','g','L','o','o','p',0 }
397 # define CFSTR_DRAGCONTEXTW \
398     (const WCHAR []){ 'D','r','a','g','C','o','n','t','e','x','t',0 }
399 # define CFSTR_MOUNTEDVOLUMEW \
400     (const WCHAR []){ 'M','o','u','n','t','e','d','V','o','l','u','m','e',0 }
401 # define CFSTR_PERSISTEDDATAOBJECTW \
402     (const WCHAR []){ 'P','e','r','s','i','s','t','e','d','D','a','t','a','O','b','j','e','c','t',0 }
403 # define CFSTR_TARGETCLSIDW \
404     (const WCHAR []){ 'T','a','r','g','e','t','C','L','S','I','D',0 }
405 # define CFSTR_AUTOPLAY_SHELLIDLISTSW \
406     (const WCHAR []){ 'A','u','t','o','p','l','a','y',' ','E','n','u','m','e','r','a','t','e','d',\
407                       ' ','I','D','L','i','s','t',' ','A','r','r','a','y',0 }
408 # define CFSTR_LOGICALPERFORMEDDROPEFFECTW \
409     (const WCHAR []){ 'L','o','g','i','c','a','l',' ','P','e','r','f','o','r','m','e','d',\
410                       ' ','D','r','o','p','E','f','f','e','c','t',0 }
411 #elif defined(_MSC_VER)
412 # define CFSTR_SHELLIDLISTW           L"Shell IDList Array"
413 # define CFSTR_SHELLIDLISTOFFSETW     L"Shell Object Offsets"
414 # define CFSTR_NETRESOURCESW          L"Net Resource"
415 # define CFSTR_FILEDESCRIPTORW        L"FileGroupDescriptorW"
416 # define CFSTR_FILECONTENTSW          L"FileContents"
417 # define CFSTR_FILENAMEW              L"FileNameW"
418 # define CFSTR_FILENAMEMAPW           L"FileNameMapW"
419 # define CFSTR_PRINTERGROUPW          L"PrinterFriendlyName"
420 # define CFSTR_SHELLURLW              L"UniformResourceLocator"
421 # define CFSTR_INETURLW               L"UniformResourceLocatorW"
422 # define CFSTR_PREFERREDDROPEFFECTW   L"Preferred DropEffect"
423 # define CFSTR_PERFORMEDDROPEFFECTW   L"Performed DropEffect"
424 # define CFSTR_PASTESUCCEEDEDW        L"Paste Succeeded"
425 # define CFSTR_INDRAGLOOPW            L"InShellDragLoop"
426 # define CFSTR_DRAGCONTEXTW           L"DragContext"
427 # define CFSTR_MOUNTEDVOLUMEW         L"MountedVolume"
428 # define CFSTR_PERSISTEDDATAOBJECTW   L"PersistedDataObject"
429 # define CFSTR_TARGETCLSIDW           L"TargetCLSID"
430 # define CFSTR_AUTOPLAY_SHELLIDLISTSW L"Autoplay Enumerated IDList Array"
431 # define CFSTR_LOGICALPERFORMEDDROPEFFECTW L"Logical Performed DropEffect"
432 #else
433 static const WCHAR CFSTR_SHELLIDLISTW[] =
434     { 'S','h','e','l','l',' ','I','D','L','i','s','t',' ','A','r','r','a','y',0 };
435 static const WCHAR CFSTR_SHELLIDLISTOFFSETW[] =
436     { 'S','h','e','l','l',' ','O','b','j','e','c','t',' ','O','f','f','s','e','t','s',0 };
437 static const WCHAR CFSTR_NETRESOURCESW[] =
438     { 'N','e','t',' ','R','e','s','o','u','r','c','e',0 };
439 static const WCHAR CFSTR_FILEDESCRIPTORW[] =
440     { 'F','i','l','e','G','r','o','u','p','D','e','s','c','r','i','p','t','o','r','W',0 };
441 static const WCHAR CFSTR_FILECONTENTSW[] =
442     { 'F','i','l','e','C','o','n','t','e','n','t','s',0 };
443 static const WCHAR CFSTR_FILENAMEW[] =
444     { 'F','i','l','e','N','a','m','e','W',0 };
445 static const WCHAR CFSTR_FILENAMEMAPW[] =
446     { 'F','i','l','e','N','a','m','e','M','a','p','W',0 };
447 static const WCHAR CFSTR_PRINTERGROUPW[] =
448     { 'P','r','i','n','t','e','r','F','r','i','e','n','d','l','y','N','a','m','e',0 };
449 static const WCHAR CFSTR_SHELLURLW[] =
450     { 'U','n','i','f','o','r','m','R','e','s','o','u','r','c','e','L','o','c','a','t','o','r',0 };
451 static const WCHAR CFSTR_INETURLW[] =
452     { 'U','n','i','f','o','r','m','R','e','s','o','u','r','c','e','L','o','c','a','t','o','r','W',0 };
453 static const WCHAR CFSTR_PREFERREDDROPEFFECTW[] =
454     { 'P','r','e','f','e','r','r','e','d',' ','D','r','o','p','E','f','f','e','c','t',0 };
455 static const WCHAR CFSTR_PERFORMEDDROPEFFECTW[] =
456     { 'P','e','r','f','o','r','m','e','d',' ','D','r','o','p','E','f','f','e','c','t',0 };
457 static const WCHAR CFSTR_PASTESUCCEEDEDW[] =
458     { 'P','a','s','t','e',' ','S','u','c','c','e','e','d','e','d',0 };
459 static const WCHAR CFSTR_INDRAGLOOPW[] =
460     { 'I','n','S','h','e','l','l','D','r','a','g','L','o','o','p',0 };
461 static const WCHAR CFSTR_DRAGCONTEXTW[] =
462     { 'D','r','a','g','C','o','n','t','e','x','t',0 };
463 static const WCHAR CFSTR_MOUNTEDVOLUMEW[] =
464     { 'M','o','u','n','t','e','d','V','o','l','u','m','e',0 };
465 static const WCHAR CFSTR_PERSISTEDDATAOBJECTW[] =
466     { 'P','e','r','s','i','s','t','e','d','D','a','t','a','O','b','j','e','c','t',0 };
467 static const WCHAR CFSTR_TARGETCLSIDW[] =
468     { 'T','a','r','g','e','t','C','L','S','I','D',0 };
469 static const WCHAR CFSTR_AUTOPLAY_SHELLIDLISTSW[] =
470     { 'A','u','t','o','p','l','a','y',' ','E','n','u','m','e','r','a','t','e','d',
471       ' ','I','D','L','i','s','t',' ','A','r','r','a','y',0 };
472 static const WCHAR CFSTR_LOGICALPERFORMEDDROPEFFECTW[] =
473     { 'L','o','g','i','c','a','l',' ','P','e','r','f','o','r','m','e','d',
474       ' ','D','r','o','p','E','f','f','e','c','t',0 };
475 #endif
476 
477 #define CFSTR_SHELLIDLIST           WINELIB_NAME_AW(CFSTR_SHELLIDLIST)
478 #define CFSTR_SHELLIDLISTOFFSET     WINELIB_NAME_AW(CFSTR_SHELLIDLISTOFFSET)
479 #define CFSTR_NETRESOURCES          WINELIB_NAME_AW(CFSTR_NETRESOURCES)
480 #define CFSTR_FILEDESCRIPTOR        WINELIB_NAME_AW(CFSTR_FILEDESCRIPTOR)
481 #define CFSTR_FILECONTENTS          WINELIB_NAME_AW(CFSTR_FILECONTENTS)
482 #define CFSTR_FILENAME              WINELIB_NAME_AW(CFSTR_FILENAME)
483 #define CFSTR_FILENAMEMAP           WINELIB_NAME_AW(CFSTR_FILENAMEMAP)
484 #define CFSTR_PRINTERGROUP          WINELIB_NAME_AW(CFSTR_PRINTERGROUP)
485 #define CFSTR_SHELLURL              WINELIB_NAME_AW(CFSTR_SHELLURL)
486 #define CFSTR_INETURL               WINELIB_NAME_AW(CFSTR_INETURL)
487 #define CFSTR_PREFERREDDROPEFFECT   WINELIB_NAME_AW(CFSTR_PREFERREDDROPEFFECT)
488 #define CFSTR_PERFORMEDDROPEFFECT   WINELIB_NAME_AW(CFSTR_PERFORMEDDROPEFFECT)
489 #define CFSTR_PASTESUCCEEDED        WINELIB_NAME_AW(CFSTR_PASTESUCCEEDED)
490 #define CFSTR_INDRAGLOOP            WINELIB_NAME_AW(CFSTR_INDRAGLOOP)
491 #define CFSTR_DRAGCONTEXT           WINELIB_NAME_AW(CFSTR_DRAGCONTEXT)
492 #define CFSTR_MOUNTEDVOLUME         WINELIB_NAME_AW(CFSTR_MOUNTEDVOLUME)
493 #define CFSTR_PERSISTEDDATAOBJECT   WINELIB_NAME_AW(CFSTR_PERSISTEDDATAOBJECT)
494 #define CFSTR_TARGETCLSID           WINELIB_NAME_AW(CFSTR_TARGETCLSID)
495 #define CFSTR_AUTOPLAY_SHELLIDLISTS WINELIB_NAME_AW(CFSTR_AUTOPLAY_SHELLIDLISTS)
496 #define CFSTR_LOGICALPERFORMEDDROPEFFECT WINELIB_NAME_AW(CFSTR_LOGICALPERFORMEDDROPEFFECT)
497 
498 typedef struct
499 {	UINT cidl;
500 	UINT aoffset[1];
501 } CIDA, *LPIDA;
502 
503 /************************************************************************
504 * IShellView interface
505 */
506 
507 #define FCIDM_SHVIEWFIRST       0x0000
508 /* undocumented */
509 #define FCIDM_SHVIEW_ARRANGE    0x7001
510 #define FCIDM_SHVIEW_DELETE     0x7011
511 #define FCIDM_SHVIEW_PROPERTIES 0x7013
512 #define FCIDM_SHVIEW_CUT        0x7018
513 #define FCIDM_SHVIEW_COPY       0x7019
514 #define FCIDM_SHVIEW_INSERT     0x701A
515 #define FCIDM_SHVIEW_UNDO       0x701B
516 #define FCIDM_SHVIEW_INSERTLINK 0x701C
517 #define FCIDM_SHVIEW_COPYTO     0x701E
518 #define FCIDM_SHVIEW_MOVETO     0x701F
519 #define FCIDM_SHVIEW_SELECTALL  0x7021
520 #define FCIDM_SHVIEW_INVERTSELECTION 0x7022
521 
522 #define FCIDM_SHVIEW_BIGICON    0x7029
523 #define FCIDM_SHVIEW_SMALLICON  0x702A
524 #define FCIDM_SHVIEW_LISTVIEW   0x702B
525 #define FCIDM_SHVIEW_REPORTVIEW 0x702C
526 /* 0x7030-0x703f are used by the shellbrowser */
527 #define FCIDM_SHVIEW_AUTOARRANGE 0x7031
528 #define FCIDM_SHVIEW_SNAPTOGRID 0x7032
529 #define FCIDM_SHVIEW_ALIGNTOGRID 0x7033
530 
531 #define FCIDM_SHVIEW_HELP       0x7041
532 #define FCIDM_SHVIEW_RENAME     0x7050
533 #define FCIDM_SHVIEW_CREATELINK 0x7051
534 #define FCIDM_SHVIEW_NEWLINK    0x7052
535 #define FCIDM_SHVIEW_NEWFOLDER  0x7053
536 
537 #define FCIDM_SHVIEW_REFRESH    0x7100 /* FIXME */
538 #define FCIDM_SHVIEW_EXPLORE    0x7101 /* FIXME */
539 #define FCIDM_SHVIEW_OPEN       0x7102 /* FIXME */
540 
541 #define FCIDM_SHVIEWLAST        0x7fff
542 #define FCIDM_BROWSERFIRST      0xA000
543 /* undocumented toolbar items from stddlg's*/
544 #define FCIDM_TB_UPFOLDER       0xA001
545 #define FCIDM_TB_NEWFOLDER      0xA002
546 #define FCIDM_TB_SMALLICON      0xA003
547 #define FCIDM_TB_REPORTVIEW     0xA004
548 #define FCIDM_TB_DESKTOP        0xA005  /* FIXME */
549 
550 #define FCIDM_BROWSERLAST       0xbf00
551 #define FCIDM_GLOBALFIRST       0x8000
552 #define FCIDM_GLOBALLAST        0x9fff
553 
554 /*
555 * Global submenu IDs and separator IDs
556 */
557 #define FCIDM_MENU_FILE             (FCIDM_GLOBALFIRST+0x0000)
558 #define FCIDM_MENU_EDIT             (FCIDM_GLOBALFIRST+0x0040)
559 #define FCIDM_MENU_VIEW             (FCIDM_GLOBALFIRST+0x0080)
560 #define FCIDM_MENU_VIEW_SEP_OPTIONS (FCIDM_GLOBALFIRST+0x0081)
561 #define FCIDM_MENU_TOOLS            (FCIDM_GLOBALFIRST+0x00c0)
562 #define FCIDM_MENU_TOOLS_SEP_GOTO   (FCIDM_GLOBALFIRST+0x00c1)
563 #define FCIDM_MENU_HELP             (FCIDM_GLOBALFIRST+0x0100)
564 #define FCIDM_MENU_FIND             (FCIDM_GLOBALFIRST+0x0140)
565 #define FCIDM_MENU_EXPLORE          (FCIDM_GLOBALFIRST+0x0150)
566 #define FCIDM_MENU_FAVORITES        (FCIDM_GLOBALFIRST+0x0170)
567 
568 /* control IDs known to the view */
569 #define FCIDM_TOOLBAR      (FCIDM_BROWSERFIRST + 0)
570 #define FCIDM_STATUS       (FCIDM_BROWSERFIRST + 1)
571 
572 #define INTERFACE IShellDetails
573 DECLARE_INTERFACE_(IShellDetails, IUnknown)
574 {
575     /*** IUnknown methods ***/
576     STDMETHOD_(HRESULT,QueryInterface) (THIS_ REFIID riid, void **ppv) PURE;
577     STDMETHOD_(ULONG,AddRef) (THIS)  PURE;
578     STDMETHOD_(ULONG,Release) (THIS) PURE;
579     /*** IShellDetails methods ***/
580     STDMETHOD(GetDetailsOf)(THIS_ _In_opt_ PCUITEMID_CHILD pidl, UINT iColumn, _Out_ SHELLDETAILS *pDetails) PURE;
581     STDMETHOD(ColumnClick)(THIS_ UINT iColumn) PURE;
582 };
583 #undef INTERFACE
584 
585 #if !defined(__cplusplus) || defined(CINTERFACE)
586 /*** IUnknown methods ***/
587 #define IShellDetails_QueryInterface(p,a,b)    (p)->lpVtbl->QueryInterface(p,a,b)
588 #define IShellDetails_AddRef(p)                (p)->lpVtbl->AddRef(p)
589 #define IShellDetails_Release(p)               (p)->lpVtbl->Release(p)
590 /*** IShellDetails methods ***/
591 #define IShellDetails_GetDetailsOf(p,a,b,c)    (p)->lpVtbl->GetDetailsOf(p,a,b,c)
592 #define IShellDetails_ColumnClick(p,a)         (p)->lpVtbl->ColumnClick(p,a)
593 #endif
594 
595 /* IQueryInfo interface */
596 #define INTERFACE IQueryInfo
597 DECLARE_INTERFACE_(IQueryInfo,IUnknown)
598 {
599     /*** IUnknown methods ***/
600     STDMETHOD_(HRESULT,QueryInterface)(THIS_ REFIID riid, void** ppvObject) PURE;
601     STDMETHOD_(ULONG,AddRef)(THIS) PURE;
602     STDMETHOD_(ULONG,Release)(THIS) PURE;
603     /*** IQueryInfo methods ***/
604     STDMETHOD(GetInfoTip)(THIS_ DWORD dwFlags, _Outptr_ WCHAR** lppTips) PURE;
605     STDMETHOD(GetInfoFlags)(THIS_ _Out_ DWORD* lpFlags) PURE;
606 };
607 #undef INTERFACE
608 
609 #if !defined(__cplusplus) || defined(CINTERFACE)
610 /*** IUnknown methods ***/
611 #define IQueryInfo_QueryInterface(p,a,b)      (p)->lpVtbl->QueryInterface(p,a,b)
612 #define IQueryInfo_AddRef(p)                  (p)->lpVtbl->AddRef(p)
613 #define IQueryInfo_Release(p)                 (p)->lpVtbl->Release(p)
614 /*** IQueryInfo methods ***/
615 #define IQueryInfo_GetInfoTip(p,a,b)          (p)->lpVtbl->GetInfoTip(p,a,b)
616 #define IQueryInfo_GetInfoFlags(p,a)          (p)->lpVtbl->GetInfoFlags(p,a)
617 #endif
618 
619 /* IInputObject interface */
620 #define INTERFACE IInputObject
621 DECLARE_INTERFACE_(IInputObject,IUnknown)
622 {
623     /*** IUnknown methods ***/
624     STDMETHOD_(HRESULT,QueryInterface)(THIS_ REFIID riid, void** ppvObject) PURE;
625     STDMETHOD_(ULONG,AddRef)(THIS) PURE;
626     STDMETHOD_(ULONG,Release)(THIS) PURE;
627     /*** IInputObject methods ***/
628     STDMETHOD(UIActivateIO)(THIS_ BOOL bActivating, LPMSG lpMsg) PURE;
629     STDMETHOD(HasFocusIO)(THIS) PURE;
630     STDMETHOD(TranslateAcceleratorIO)(THIS_ LPMSG lpMsg) PURE;
631 };
632 #undef INTERFACE
633 
634 #if !defined(__cplusplus) || defined(CINTERFACE)
635 /*** IUnknown methods ***/
636 #define IInputObject_QueryInterface(p,a,b)       (p)->lpVtbl->QueryInterface(p,a,b)
637 #define IInputObject_AddRef(p)                   (p)->lpVtbl->AddRef(p)
638 #define IInputObject_Release(p)                  (p)->lpVtbl->Release(p)
639 /*** IInputObject methods ***/
640 #define IInputObject_UIActivateIO(p,a,b)         (p)->lpVtbl->UIActivateIO(p,a,b)
641 #define IInputObject_HasFocusIO(p)               (p)->lpVtbl->HasFocusIO(p)
642 #define IInputObject_TranslateAcceleratorIO(p,a) (p)->lpVtbl->TranslateAcceleratorIO(p,a)
643 #endif
644 
645 /* IInputObjectSite interface */
646 #define INTERFACE IInputObjectSite
647 DECLARE_INTERFACE_(IInputObjectSite,IUnknown)
648 {
649     /*** IUnknown methods ***/
650     STDMETHOD_(HRESULT,QueryInterface) (THIS_ REFIID riid, void** ppvObject) PURE;
651     STDMETHOD_(ULONG,AddRef) (THIS) PURE;
652     STDMETHOD_(ULONG,Release) (THIS) PURE;
653     /*** IInputObjectSite methods ***/
654     STDMETHOD(OnFocusChangeIS)(THIS_ LPUNKNOWN lpUnknown, BOOL bFocus) PURE;
655 };
656 #undef INTERFACE
657 
658 #if !defined(__cplusplus) || defined(CINTERFACE)
659 /*** IUnknown methods ***/
660 #define IInputObjectSite_QueryInterface(p,a,b)  (p)->lpVtbl->QueryInterface(p,a,b)
661 #define IInputObjectSite_AddRef(p)              (p)->lpVtbl->AddRef(p)
662 #define IInputObjectSite_Release(p)             (p)->lpVtbl->Release(p)
663 /*** IInputObject methods ***/
664 #define IInputObjectSite_OnFocusChangeIS(p,a,b) (p)->lpVtbl->OnFocusChangeIS(p,a,b)
665 #endif
666 
667 /* IObjMgr interface */
668 #define INTERFACE IObjMgr
669 DECLARE_INTERFACE_(IObjMgr,IUnknown)
670 {
671     /*** IUnknown methods ***/
672     STDMETHOD_(HRESULT,QueryInterface) (THIS_ REFIID riid, void** ppvObject) PURE;
673     STDMETHOD_(ULONG,AddRef) (THIS) PURE;
674     STDMETHOD_(ULONG,Release) (THIS) PURE;
675     /*** IObjMgr methods ***/
676     STDMETHOD(Append)(THIS_ _In_ LPUNKNOWN punk) PURE;
677     STDMETHOD(Remove)(THIS_ _In_ LPUNKNOWN punk) PURE;
678 };
679 #undef INTERFACE
680 
681 #if !defined(__cplusplus) || defined(CINTERFACE)
682 /*** IUnknown methods ***/
683 #define IObjMgr_QueryInterface(p,a,b)  (p)->lpVtbl->QueryInterface(p,a,b)
684 #define IObjMgr_AddRef(p)              (p)->lpVtbl->AddRef(p)
685 #define IObjMgr_Release(p)             (p)->lpVtbl->Release(p)
686 /*** IObjMgr methods ***/
687 #define IObjMgr_Append(p,a) (p)->lpVtbl->Append(p,a)
688 #define IObjMgr_Remove(p,a) (p)->lpVtbl->Remove(p,a)
689 #endif
690 
691 /* ICurrentWorkingDirectory interface */
692 #define INTERFACE ICurrentWorkingDirectory
693 DECLARE_INTERFACE_(ICurrentWorkingDirectory,IUnknown)
694 {
695     /*** IUnknown methods ***/
696     STDMETHOD_(HRESULT,QueryInterface) (THIS_ REFIID riid, void** ppvObject) PURE;
697     STDMETHOD_(ULONG,AddRef) (THIS) PURE;
698     STDMETHOD_(ULONG,Release) (THIS) PURE;
699     /*** ICurrentWorkingDirectory methods ***/
700     STDMETHOD(GetDirectory)(THIS_ _Out_writes_(cchSize) PWSTR pwzPath, DWORD cchSize) PURE;
701     STDMETHOD(SetDirectory)(THIS_ _In_ PCWSTR pwzPath) PURE;
702 };
703 #undef INTERFACE
704 
705 #if !defined(__cplusplus) || defined(CINTERFACE)
706 /*** IUnknown methods ***/
707 #define ICurrentWorkingDirectory_QueryInterface(p,a,b)  (p)->lpVtbl->QueryInterface(p,a,b)
708 #define ICurrentWorkingDirectory_AddRef(p)              (p)->lpVtbl->AddRef(p)
709 #define ICurrentWorkingDirectory_Release(p)             (p)->lpVtbl->Release(p)
710 /*** ICurrentWorkingDirectory methods ***/
711 #define ICurrentWorkingDirectory_GetDirectory(p,a,b)    (p)->lpVtbl->GetDirectory(p,a,b)
712 #define ICurrentWorkingDirectory_SetDirectory(p,a)      (p)->lpVtbl->SetDirectory(p,a)
713 #endif
714 
715 /* IACList interface */
716 #define INTERFACE IACList
717 DECLARE_INTERFACE_(IACList,IUnknown)
718 {
719     /*** IUnknown methods ***/
720     STDMETHOD_(HRESULT,QueryInterface) (THIS_ REFIID riid, void** ppvObject) PURE;
721     STDMETHOD_(ULONG,AddRef) (THIS) PURE;
722     STDMETHOD_(ULONG,Release) (THIS) PURE;
723     /*** IACList methods ***/
724     STDMETHOD(Expand)(THIS_ _In_ LPCOLESTR str) PURE;
725 };
726 #undef INTERFACE
727 
728 #if !defined(__cplusplus) || defined(CINTERFACE)
729 /*** IUnknown methods ***/
730 #define IACList_QueryInterface(p,a,b)  (p)->lpVtbl->QueryInterface(p,a,b)
731 #define IACList_AddRef(p)              (p)->lpVtbl->AddRef(p)
732 #define IACList_Release(p)             (p)->lpVtbl->Release(p)
733 /*** IACList methods ***/
734 #define IACList_Expand(p,a)             (p)->lpVtbl->Expand(p,a)
735 #endif
736 
737 /* IACList2 interface */
738 
739 #define ACLO_NONE           0x00000000
740 #define ACLO_CURRENTDIR     0x00000001
741 #define ACLO_MYCOMPUTER     0x00000002
742 #define ACLO_DESKTOP        0x00000004
743 #define ACLO_FAVORITES      0x00000008
744 #define ACLO_FILESYSONLY    0x00000010
745 #define ACLO_FILESYSDIRS    0x00000020
746 
747 #define INTERFACE IACList2
748 DECLARE_INTERFACE_(IACList2,IACList)
749 {
750     /*** IUnknown methods ***/
751     STDMETHOD_(HRESULT,QueryInterface) (THIS_ REFIID riid, void** ppvObject) PURE;
752     STDMETHOD_(ULONG,AddRef) (THIS) PURE;
753     STDMETHOD_(ULONG,Release) (THIS) PURE;
754     /*** IACList methods ***/
755     STDMETHOD(Expand)(THIS_ LPCOLESTR str) PURE;
756     /*** IACList2 methods ***/
757     STDMETHOD(SetOptions)(THIS_ DWORD dwFlag) PURE;
758     STDMETHOD(GetOptions)(THIS_ _Out_ DWORD* pdwFlag) PURE;
759 };
760 #undef INTERFACE
761 
762 #if !defined(__cplusplus) || defined(CINTERFACE)
763 /*** IUnknown methods ***/
764 #define IACList2_QueryInterface(p,a,b)  (p)->lpVtbl->QueryInterface(p,a,b)
765 #define IACList2_AddRef(p)              (p)->lpVtbl->AddRef(p)
766 #define IACList2_Release(p)             (p)->lpVtbl->Release(p)
767 /*** IACList2 methods ***/
768 #define IACList2_GetOptions(p,a)        (p)->lpVtbl->GetOptions(p,a)
769 #define IACList2_SetOptions(p,a)        (p)->lpVtbl->SetOptions(p,a)
770 #endif
771 
772 /****************************************************************************
773  * IShellFolderViewCB interface
774  */
775 
776 #define INTERFACE IShellFolderViewCB
777 DECLARE_INTERFACE_(IShellFolderViewCB,IUnknown)
778 {
779     /*** IUnknown methods ***/
780     STDMETHOD_(HRESULT,QueryInterface)(THIS_ REFIID riid, void** ppvObject) PURE;
781     STDMETHOD_(ULONG,AddRef)(THIS) PURE;
782     STDMETHOD_(ULONG,Release)(THIS) PURE;
783     /*** IShellFolderViewCB methods ***/
784     STDMETHOD(MessageSFVCB)(THIS_ UINT uMsg, WPARAM wParam, LPARAM lParam) PURE;
785 };
786 #undef INTERFACE
787 
788 #if !defined(__cplusplus) || defined(CINTERFACE)
789 /*** IUnknown methods ***/
790 #define IShellFolderViewCB_QueryInterface(p,a,b)      (p)->lpVtbl->QueryInterface(p,a,b)
791 #define IShellFolderViewCB_AddRef(p)                  (p)->lpVtbl->AddRef(p)
792 #define IShellFolderViewCB_Release(p)                 (p)->lpVtbl->Release(p)
793 /*** IShellFolderViewCB methods ***/
794 #define IShellFolderViewCB_MessageSFVCB(p,a,b,c)      (p)->lpVtbl->MessageSFVCB(p,a,b,c)
795 #endif
796 
797 /****************************************************************************
798  * IShellFolderView interface
799  */
800 
801 #include <pshpack8.h>
802 
803 typedef struct _ITEMSPACING
804 {
805     int cxSmall;
806     int cySmall;
807     int cxLarge;
808     int cyLarge;
809 } ITEMSPACING;
810 
811 #include <poppack.h>
812 
813 #define INTERFACE IShellFolderView
814 DEFINE_GUID(IID_IShellFolderView,0x37a378c0,0xf82d,0x11ce,0xae,0x65,0x08,0x00,0x2b,0x2e,0x12,0x62);
815 DECLARE_INTERFACE_(IShellFolderView, IUnknown)
816 {
817     /*** IUnknown methods ***/
818     STDMETHOD_(HRESULT,QueryInterface) (THIS_ REFIID riid, void **ppv) PURE;
819     STDMETHOD_(ULONG,AddRef) (THIS)  PURE;
820     STDMETHOD_(ULONG,Release) (THIS) PURE;
821 
822     /*** IShellFolderView methods ***/
823     STDMETHOD(Rearrange) (THIS_ LPARAM lParamSort) PURE;
824     STDMETHOD(GetArrangeParam) (THIS_ _Out_ LPARAM *plParamSort) PURE;
825     STDMETHOD(ArrangeGrid) (THIS) PURE;
826     STDMETHOD(AutoArrange) (THIS) PURE;
827     STDMETHOD(GetAutoArrange) (THIS) PURE;
828     STDMETHOD(AddObject) (THIS_ _In_ PITEMID_CHILD pidl, _Out_ UINT *puItem) PURE;
829     STDMETHOD(GetObject) (THIS_ _Outptr_ PITEMID_CHILD *ppidl, UINT uItem) PURE;
830     STDMETHOD(RemoveObject) (THIS_ _In_opt_ PITEMID_CHILD pidl, _Out_ UINT *puItem) PURE;
831     STDMETHOD(GetObjectCount) (THIS_ _Out_ UINT *puCount) PURE;
832     STDMETHOD(SetObjectCount) (THIS_ UINT uCount, UINT dwFlags) PURE;
833     STDMETHOD(UpdateObject) (THIS_ _In_ PITEMID_CHILD pidlOld, _In_ PITEMID_CHILD pidlNew, _Out_ UINT *puItem) PURE;
834     STDMETHOD(RefreshObject) (THIS_ _In_ PITEMID_CHILD pidl, _Out_ UINT *puItem) PURE;
835     STDMETHOD(SetRedraw) (THIS_ BOOL bRedraw) PURE;
836     STDMETHOD(GetSelectedCount) (THIS_ _Out_ UINT *puSelected) PURE;
837     STDMETHOD(GetSelectedObjects) (THIS_ _Outptr_result_buffer_(*puItems) PCUITEMID_CHILD **pppidl, _Out_ UINT *puItems) PURE;
838     STDMETHOD(IsDropOnSource) (THIS_ _In_opt_ IDropTarget *pDropTarget) PURE;
839     STDMETHOD(GetDragPoint) (THIS_ _Out_ POINT *ppt) PURE;
840     STDMETHOD(GetDropPoint) (THIS_ _Out_ POINT *ppt) PURE;
841     STDMETHOD(MoveIcons) (THIS_ _In_ IDataObject *pDataObject) PURE;
842     STDMETHOD(SetItemPos) (THIS_ _In_ PCUITEMID_CHILD pidl, _In_ POINT *ppt) PURE;
843     STDMETHOD(IsBkDropTarget) (THIS_ _In_opt_ IDropTarget *pDropTarget) PURE;
844     STDMETHOD(SetClipboard) (THIS_ BOOL bMove) PURE;
845     STDMETHOD(SetPoints) (THIS_ _In_ IDataObject *pDataObject) PURE;
846     STDMETHOD(GetItemSpacing) (THIS_ _Out_ ITEMSPACING *pSpacing) PURE;
847     STDMETHOD(SetCallback) (THIS_ _In_opt_ IShellFolderViewCB* pNewCB, _Outptr_result_maybenull_ IShellFolderViewCB** ppOldCB) PURE;
848     STDMETHOD(Select) ( THIS_  UINT dwFlags ) PURE;
849     STDMETHOD(QuerySupport) (THIS_ _Inout_ UINT * pdwSupport) PURE;
850     STDMETHOD(SetAutomationObject)(THIS_ _In_opt_ IDispatch* pdisp) PURE;
851 };
852 #undef INTERFACE
853 
854 #if !defined(__cplusplus) || defined(CINTERFACE)
855 /*** IUnknown methods ***/
856 #define IShellFolderView_QueryInterface(p,a,b)      (p)->lpVtbl->QueryInterface(p,a,b)
857 #define IShellFolderView_AddRef(p)                  (p)->lpVtbl->AddRef(p)
858 #define IShellFolderView_Release(p)                 (p)->lpVtbl->Release(p)
859 /*** IShellFolderView methods ***/
860 #define IShellFolderView_Rearrange(p,a)             (p)->lpVtbl->Rearrange(p,a)
861 #define IShellFolderView_GetArrangeParam(p,a)       (p)->lpVtbl->GetArrangeParam(p,a)
862 #define IShellFolderView_ArrangeGrid(p)             (p)->lpVtbl->ArrangeGrid(p)
863 #define IShellFolderView_AutoArrange(p)             (p)->lpVtbl->AutoArrange(p)
864 #define IShellFolderView_GetAutoArrange(p)          (p)->lpVtbl->GetAutoArrange(p)
865 #define IShellFolderView_AddObject(p,a,b)           (p)->lpVtbl->AddObject(p,a,b)
866 #define IShellFolderView_GetObject(p,a,b)           (p)->lpVtbl->GetObject(p,a,b)
867 #define IShellFolderView_RemoveObject(p,a,b)        (p)->lpVtbl->RemoveObject(p,a,b)
868 #define IShellFolderView_GetObjectCount(p,a)        (p)->lpVtbl->GetObjectCount(p,a)
869 #define IShellFolderView_SetObjectCount(p,a,b)      (p)->lpVtbl->SetObjectCount(p,a,b)
870 #define IShellFolderView_UpdateObject(p,a,b,c)      (p)->lpVtbl->UpdateObject(p,a,b,c)
871 #define IShellFolderView_RefreshObject(p,a,b)       (p)->lpVtbl->RefreshObject(p,a,b)
872 #define IShellFolderView_SetRedraw(p,a)             (p)->lpVtbl->SetRedraw(p,a)
873 #define IShellFolderView_GetSelectedCount(p,a)      (p)->lpVtbl->GetSelectedCount(p,a)
874 #define IShellFolderView_GetSelectedObjects(p,a,b)  (p)->lpVtbl->GetSelectedObjects(p,a,b)
875 #define IShellFolderView_IsDropOnSource(p,a)        (p)->lpVtbl->IsDropOnSource(p,a)
876 #define IShellFolderView_GetDragPoint(p,a)          (p)->lpVtbl->GetDragPoint(p,a)
877 #define IShellFolderView_GetDropPoint(p,a)          (p)->lpVtbl->GetDropPoint(p,a)
878 #define IShellFolderView_MoveIcons(p,a)             (p)->lpVtbl->MoveIcons(p,a)
879 #define IShellFolderView_SetItemPos(p,a,b)          (p)->lpVtbl->SetItemPos(p,a,b)
880 #define IShellFolderView_DropTarget(p,a)            (p)->lpVtbl->DropTarget(p,a)
881 #define IShellFolderView_SetClipboard(p,a)          (p)->lpVtbl->SetClipboard(p,a)
882 #define IShellFolderView_SetPoints(p,a)             (p)->lpVtbl->SetPoints(p,a)
883 #define IShellFolderView_GetItemSpacing(p,a)        (p)->lpVtbl->GetItemSpacing(p,a)
884 #define IShellFolderView_SetCallback(p,a)           (p)->lpVtbl->SetCallback(p,a)
885 #define IShellFolderView_Select(p,a)                (p)->lpVtbl->Select(p,a)
886 #define IShellFolderView_QuerySupport(p,a)          (p)->lpVtbl->QuerySupport(p,a)
887 #define IShellFolderView_SetAutomationObject(p,a)   (p)->lpVtbl->SetAutomationObject(p,a)
888 #endif
889 
890 /* IProgressDialog interface */
891 #define PROGDLG_NORMAL           0x00000000
892 #define PROGDLG_MODAL            0x00000001
893 #define PROGDLG_AUTOTIME         0x00000002
894 #define PROGDLG_NOTIME           0x00000004
895 #define PROGDLG_NOMINIMIZE       0x00000008
896 #define PROGDLG_NOPROGRESSBAR    0x00000010
897 #define PROGDLG_MARQUEEPROGRESS  0x00000020
898 #define PROGDLG_NOCANCEL         0x00000040
899 
900 #define PDTIMER_RESET            0x00000001
901 #define PDTIMER_PAUSE            0x00000002
902 #define PDTIMER_RESUME           0x00000003
903 
904 #define INTERFACE IProgressDialog
905 DECLARE_INTERFACE_(IProgressDialog,IUnknown)
906 {
907     /*** IUnknown methods ***/
908     STDMETHOD_(HRESULT,QueryInterface) (THIS_ REFIID riid, void** ppvObject) PURE;
909     STDMETHOD_(ULONG,AddRef) (THIS) PURE;
910     STDMETHOD_(ULONG,Release) (THIS) PURE;
911     /*** IProgressDialog methods ***/
912     STDMETHOD(StartProgressDialog)(THIS_ _In_opt_ HWND hwndParent, _In_opt_ IUnknown *punkEnableModeless, DWORD dwFlags, _Reserved_ LPCVOID reserved) PURE;
913     STDMETHOD(StopProgressDialog)(THIS) PURE;
914     STDMETHOD(SetTitle)(THIS_ _In_ LPCWSTR pwzTitle) PURE;
915     STDMETHOD(SetAnimation)(THIS_ _In_opt_ HINSTANCE hInstance, UINT uiResourceId) PURE;
916     STDMETHOD_(BOOL,HasUserCancelled)(THIS) PURE;
917     STDMETHOD(SetProgress)(THIS_ DWORD dwCompleted, DWORD dwTotal) PURE;
918     STDMETHOD(SetProgress64)(THIS_ ULONGLONG ullCompleted, ULONGLONG ullTotal) PURE;
919     STDMETHOD(SetLine)(THIS_ DWORD dwLineNum, _In_ LPCWSTR pwzString, BOOL bPath, _Reserved_ LPCVOID reserved) PURE;
920     STDMETHOD(SetCancelMsg)(THIS_ _In_ LPCWSTR pwzCancelMsg, _Reserved_ LPCVOID reserved) PURE;
921     STDMETHOD(Timer)(THIS_ DWORD dwTimerAction, _Reserved_ LPCVOID reserved) PURE;
922 };
923 #undef INTERFACE
924 
925 #if !defined(__cplusplus) || defined(CINTERFACE)
926 /*** IUnknown methods ***/
927 #define IProgressDialog_QueryInterface(p,a,b)  (p)->lpVtbl->QueryInterface(p,a,b)
928 #define IProgressDialog_AddRef(p)              (p)->lpVtbl->AddRef(p)
929 #define IProgressDialog_Release(p)             (p)->lpVtbl->Release(p)
930 /*** IProgressDialog methods ***/
931 #define IProgressDialog_StartProgressDialog(p,a,b,c,d)    (p)->lpVtbl->StartProgressDialog(p,a,b,c,d)
932 #define IProgressDialog_StopProgressDialog(p)             (p)->lpVtbl->StopProgressDialog(p)
933 #define IProgressDialog_SetTitle(p,a)                     (p)->lpVtbl->SetTitle(p,a)
934 #define IProgressDialog_SetAnimation(p,a,b)               (p)->lpVtbl->SetAnimation(p,a,b)
935 #define IProgressDialog_HasUserCancelled(p)               (p)->lpVtbl->HasUserCancelled(p)
936 #define IProgressDialog_SetProgress(p,a,b)                (p)->lpVtbl->SetProgress(p,a,b)
937 #define IProgressDialog_SetProgress64(p,a,b)              (p)->lpVtbl->SetProgress64(p,a,b)
938 #define IProgressDialog_SetLine(p,a,b,c,d)                (p)->lpVtbl->SetLine(p,a,b,c,d)
939 #define IProgressDialog_SetCancelMsg(p,a,b)               (p)->lpVtbl->SetCancelMsg(p,a,b)
940 #define IProgressDialog_Timer(p,a,b)                      (p)->lpVtbl->Timer(p,a,b)
941 #endif
942 
943 
944 /* IDeskBarClient interface */
945 #define INTERFACE IDeskBarClient
946 DECLARE_INTERFACE_(IDeskBarClient,IOleWindow)
947 {
948     /*** IUnknown methods ***/
949     STDMETHOD(QueryInterface)(THIS_ REFIID,PVOID*) PURE;
950     STDMETHOD_(ULONG,AddRef)(THIS) PURE;
951     STDMETHOD_(ULONG,Release)(THIS) PURE;
952     /*** IOleWindow methods ***/
953     STDMETHOD_(HRESULT,GetWindow)(THIS_ HWND*) PURE;
954     STDMETHOD_(HRESULT,ContextSensitiveHelp)(THIS_ BOOL) PURE;
955     /*** IDeskBarClient methods ***/
956     STDMETHOD_(HRESULT,SetDeskBarSite)(THIS_ _In_opt_ IUnknown*) PURE;
957     STDMETHOD_(HRESULT,SetModeDBC)(THIS_ DWORD) PURE;
958     STDMETHOD_(HRESULT,UIActivateDBC)(THIS_ DWORD) PURE;
959     STDMETHOD_(HRESULT,GetSize)(THIS_ DWORD, _Out_ LPRECT) PURE;
960 };
961 #undef INTERFACE
962 
963 #if !defined(__cplusplus) || defined(CINTERFACE)
964 /*** IUnknown methods ***/
965 #define IDeskBarClient_QueryInterface(p,a,b)       (p)->lpVtbl->QueryInterface(p,a,b)
966 #define IDeskBarClient_AddRef(p)                   (p)->lpVtbl->AddRef(p)
967 #define IDeskBarClient_Release(p)                  (p)->lpVtbl->Release(p)
968 /*** IOleWindow methods ***/
969 #define IDeskBarClient_GetWindow(p,a)              (p)->lpVtbl->GetWindow(p,a)
970 #define IDeskBarClient_ContextSensitiveHelp(p,a)   (p)->lpVtbl->ContextSensitiveHelp(p,a)
971 /*** IOleWindow IDeskBarClient ***/
972 #define IDeskBarClient_SetDeskBarSite(p,a)         (p)->lpVtbl->SetDeskBarSite(p,a)
973 #define IDeskBarClient_SetModeDBC(p,a)             (p)->lpVtbl->SetModeDBC(p,a)
974 #define IDeskBarClient_UIActivateDBC(p,a)          (p)->lpVtbl->UIActivateDBC(p,a)
975 #define IDeskBarClient_GetSize(p,a,b)              (p)->lpVtbl->GetSize(p,a,b)
976 #endif
977 
978 #define DBC_GS_IDEAL    0
979 #define DBC_GS_SIZEDOWN 1
980 
981 #define DBC_HIDE        0
982 #define DBC_SHOW        1
983 #define DBC_SHOWOBSCURE 2
984 
985 
986 /* As indicated by the documentation for IActiveDesktop,
987    you must include wininet.h before shlobj.h */
988 #ifdef _WINE_WININET_H_
989 
990 
991 /* Structs are taken from msdn, and not verified!
992    Only stuff needed to make it compile are here, no flags or anything */
993 
994 typedef struct _tagWALLPAPEROPT
995 {
996     DWORD dwSize;
997     DWORD dwStyle;
998 } WALLPAPEROPT;
999 
1000 typedef WALLPAPEROPT *LPWALLPAPEROPT;
1001 typedef const WALLPAPEROPT *LPCWALLPAPEROPT;
1002 
1003 typedef struct _tagCOMPONENTSOPT
1004 {
1005     DWORD dwSize;
1006     BOOL  fEnableComponents;
1007     BOOL  fActiveDesktop;
1008 } COMPONENTSOPT;
1009 
1010 typedef COMPONENTSOPT *LPCOMPONENTSOPT;
1011 typedef const COMPONENTSOPT *LPCCOMPONENTSOPT;
1012 
1013 
1014 typedef struct _tagCOMPPOS
1015 {
1016     DWORD dwSize;
1017     int   iLeft;
1018     int   iTop;
1019     DWORD dwWidth;
1020     DWORD dwHeight;
1021     int   izIndex;
1022     BOOL  fCanResize;
1023     BOOL  fCanResizeX;
1024     BOOL  fCanResizeY;
1025     int   iPreferredLeftPercent;
1026     int   iPreferredTopPercent;
1027 } COMPPOS;
1028 
1029 typedef struct _tagCOMPSTATEINFO
1030 {
1031     DWORD dwSize;
1032     int   iLeft;
1033     int   iTop;
1034     DWORD dwWidth;
1035     DWORD dwHeight;
1036     DWORD dwItemState;
1037 } COMPSTATEINFO;
1038 
1039 typedef struct _tagCOMPONENT
1040 {
1041     DWORD         dwSize;
1042     DWORD         dwID;
1043     int           iComponentType;
1044     BOOL          fChecked;
1045     BOOL          fDirty;
1046     BOOL          fNoScroll;
1047     COMPPOS       cpPos;
1048     WCHAR         wszFriendlyName[MAX_PATH];
1049     WCHAR         wszSource[INTERNET_MAX_URL_LENGTH];
1050     WCHAR         wszSubscribedURL[INTERNET_MAX_URL_LENGTH];
1051     DWORD         dwCurItemState;
1052     COMPSTATEINFO csiOriginal;
1053     COMPSTATEINFO csiRestored;
1054 } COMPONENT;
1055 
1056 typedef COMPONENT *LPCOMPONENT;
1057 typedef const COMPONENT *LPCCOMPONENT;
1058 
1059 #pragma push_macro("AddDesktopItem")
1060 #undef AddDesktopItem
1061 
1062 /* IDeskBarClient interface */
1063 #define INTERFACE IActiveDesktop
1064 DECLARE_INTERFACE_(IActiveDesktop, IUnknown)
1065 {
1066     /*** IUnknown methods ***/
1067     STDMETHOD(QueryInterface) (THIS_ _In_ REFIID riid, _Outptr_ void **ppv) PURE;
1068     STDMETHOD_(ULONG,AddRef)  (THIS) PURE;
1069     STDMETHOD_(ULONG,Release) (THIS) PURE;
1070 
1071     /*** IActiveDesktop methods ***/
1072     STDMETHOD(ApplyChanges)(THIS_ DWORD dwFlags) PURE;
1073     STDMETHOD(GetWallpaper)(THIS_ PWSTR pwszWallpaper, UINT cchWallpaper, DWORD dwFlags) PURE;
1074     STDMETHOD(SetWallpaper)(THIS_ PCWSTR pwszWallpaper, DWORD dwReserved) PURE;
1075     STDMETHOD(GetWallpaperOptions)(THIS_ LPWALLPAPEROPT pwpo, DWORD dwReserved) PURE;
1076     STDMETHOD(SetWallpaperOptions)(THIS_ LPCWALLPAPEROPT pwpo, DWORD dwReserved) PURE;
1077     STDMETHOD(GetPattern)(THIS_ PWSTR pwszPattern, UINT cchPattern, DWORD dwReserved) PURE;
1078     STDMETHOD(SetPattern)(THIS_ PCWSTR pwszPattern, DWORD dwReserved) PURE;
1079     STDMETHOD(GetDesktopItemOptions)(THIS_ LPCOMPONENTSOPT pco, DWORD dwReserved) PURE;
1080     STDMETHOD(SetDesktopItemOptions)(THIS_ LPCCOMPONENTSOPT pco, DWORD dwReserved) PURE;
1081     STDMETHOD(AddDesktopItem)(THIS_ LPCCOMPONENT pcomp, DWORD dwReserved) PURE;
1082     STDMETHOD(AddDesktopItemWithUI)(THIS_ HWND hwnd, LPCOMPONENT pcomp, DWORD dwReserved) PURE;
1083     STDMETHOD(ModifyDesktopItem)(THIS_ LPCCOMPONENT pcomp, DWORD dwFlags) PURE;
1084     STDMETHOD(RemoveDesktopItem)(THIS_ LPCCOMPONENT pcomp, DWORD dwReserved) PURE;
1085     STDMETHOD(GetDesktopItemCount)(THIS_ int *pcItems, DWORD dwReserved) PURE;
1086     STDMETHOD(GetDesktopItem)(THIS_ int nComponent, LPCOMPONENT pcomp, DWORD dwReserved) PURE;
1087     STDMETHOD(GetDesktopItemByID)(THIS_ ULONG_PTR dwID, LPCOMPONENT pcomp, DWORD dwReserved) PURE;
1088     STDMETHOD(GenerateDesktopItemHtml)(THIS_ PCWSTR pwszFileName, LPCOMPONENT pcomp, DWORD dwReserved) PURE;
1089     STDMETHOD(AddUrl)(THIS_ HWND hwnd, PCWSTR pszSource, LPCOMPONENT pcomp, DWORD dwFlags) PURE;
1090     STDMETHOD(GetDesktopItemBySource)(THIS_ PCWSTR pwszSource, LPCOMPONENT pcomp, DWORD dwReserved) PURE;
1091 };
1092 #undef INTERFACE
1093 
1094 #pragma pop_macro("AddDesktopItem")
1095 
1096 #endif
1097 
1098 /****************************************************************************
1099 * SHAddToRecentDocs API
1100 */
1101 #define SHARD_PIDL      0x00000001L
1102 #define SHARD_PATHA     0x00000002L
1103 #define SHARD_PATHW     0x00000003L
1104 #define SHARD_PATH WINELIB_NAME_AW(SHARD_PATH)
1105 
1106 void WINAPI SHAddToRecentDocs(UINT, _In_opt_ LPCVOID);
1107 
1108 /****************************************************************************
1109  * SHBrowseForFolder API
1110  */
1111 typedef INT (CALLBACK *BFFCALLBACK)(HWND,UINT,LPARAM,LPARAM);
1112 
1113 #include <pshpack8.h>
1114 
1115 typedef struct tagBROWSEINFOA {
1116     HWND                hwndOwner;
1117     PCIDLIST_ABSOLUTE   pidlRoot;
1118     LPSTR               pszDisplayName;
1119     LPCSTR              lpszTitle;
1120     UINT                ulFlags;
1121     BFFCALLBACK         lpfn;
1122     LPARAM              lParam;
1123     INT                 iImage;
1124 } BROWSEINFOA, *PBROWSEINFOA, *LPBROWSEINFOA;
1125 
1126 typedef struct tagBROWSEINFOW {
1127     HWND                hwndOwner;
1128     PCIDLIST_ABSOLUTE   pidlRoot;
1129     LPWSTR              pszDisplayName;
1130     LPCWSTR             lpszTitle;
1131     UINT                ulFlags;
1132     BFFCALLBACK         lpfn;
1133     LPARAM              lParam;
1134     INT                 iImage;
1135 } BROWSEINFOW, *PBROWSEINFOW, *LPBROWSEINFOW;
1136 
1137 #define BROWSEINFO   WINELIB_NAME_AW(BROWSEINFO)
1138 #define PBROWSEINFO  WINELIB_NAME_AW(PBROWSEINFO)
1139 #define LPBROWSEINFO WINELIB_NAME_AW(LPBROWSEINFO)
1140 
1141 #include <poppack.h>
1142 
1143 /* Browsing for directory. */
1144 #define BIF_RETURNONLYFSDIRS   0x0001
1145 #define BIF_DONTGOBELOWDOMAIN  0x0002
1146 #define BIF_STATUSTEXT         0x0004
1147 #define BIF_RETURNFSANCESTORS  0x0008
1148 #define BIF_EDITBOX            0x0010
1149 #define BIF_VALIDATE           0x0020
1150 #define BIF_NEWDIALOGSTYLE     0x0040
1151 #define BIF_USENEWUI           (BIF_NEWDIALOGSTYLE | BIF_EDITBOX)
1152 #define BIF_BROWSEINCLUDEURLS  0x0080
1153 #define BIF_UAHINT             0x0100
1154 #define BIF_NONEWFOLDERBUTTON  0x0200
1155 #define BIF_NOTRANSLATETARGETS 0x0400
1156 
1157 #define BIF_BROWSEFORCOMPUTER  0x1000
1158 #define BIF_BROWSEFORPRINTER   0x2000
1159 #define BIF_BROWSEINCLUDEFILES 0x4000
1160 #define BIF_SHAREABLE          0x8000
1161 
1162 /* message from browser */
1163 #define BFFM_INITIALIZED        1
1164 #define BFFM_SELCHANGED         2
1165 #define BFFM_VALIDATEFAILEDA    3
1166 #define BFFM_VALIDATEFAILEDW    4
1167 #define BFFM_IUNKNOWN           5
1168 
1169 /* messages to browser */
1170 #define BFFM_SETSTATUSTEXTA     (WM_USER+100)
1171 #define BFFM_ENABLEOK           (WM_USER+101)
1172 #define BFFM_SETSELECTIONA      (WM_USER+102)
1173 #define BFFM_SETSELECTIONW      (WM_USER+103)
1174 #define BFFM_SETSTATUSTEXTW     (WM_USER+104)
1175 #define BFFM_SETOKTEXT          (WM_USER+105)
1176 #define BFFM_SETEXPANDED        (WM_USER+106)
1177 
1178 PIDLIST_ABSOLUTE WINAPI SHBrowseForFolderA(_In_ LPBROWSEINFOA lpbi);
1179 PIDLIST_ABSOLUTE WINAPI SHBrowseForFolderW(_In_ LPBROWSEINFOW lpbi);
1180 #define SHBrowseForFolder WINELIB_NAME_AW(SHBrowseForFolder)
1181 
1182 #define BFFM_SETSTATUSTEXT  WINELIB_NAME_AW(BFFM_SETSTATUSTEXT)
1183 #define BFFM_SETSELECTION   WINELIB_NAME_AW(BFFM_SETSELECTION)
1184 #define BFFM_VALIDATEFAILED WINELIB_NAME_AW(BFFM_VALIDATEFAILED)
1185 
1186 /**********************************************************************
1187  * SHCreateShellFolderViewEx API
1188  */
1189 
1190 typedef HRESULT
1191 (CALLBACK *LPFNVIEWCALLBACK)(
1192   _In_ IShellView* dwUser,
1193   _In_ IShellFolder* pshf,
1194   _In_ HWND hWnd,
1195   UINT uMsg,
1196   WPARAM wParam,
1197   LPARAM lParam);
1198 
1199 #include <pshpack8.h>
1200 
1201 typedef struct _CSFV
1202 {
1203   UINT                 cbSize;
1204   IShellFolder*        pshf;
1205   IShellView*          psvOuter;
1206   PCIDLIST_ABSOLUTE    pidl;
1207   LONG                 lEvents;
1208   LPFNVIEWCALLBACK     pfnCallback;
1209   FOLDERVIEWMODE       fvm;
1210 } CSFV, *LPCSFV;
1211 
1212 #include <poppack.h>
1213 
1214 HRESULT
1215 WINAPI
1216 SHCreateShellFolderViewEx(
1217   _In_ LPCSFV pshfvi,
1218   _Outptr_ IShellView **ppshv);
1219 
1220 /* SHCreateShellFolderViewEx callback messages */
1221 #define SFVM_MERGEMENU                 1
1222 #define SFVM_INVOKECOMMAND             2
1223 #define SFVM_GETHELPTEXT               3
1224 #define SFVM_GETTOOLTIPTEXT            4
1225 #define SFVM_GETBUTTONINFO             5
1226 #define SFVM_GETBUTTONS                6
1227 #define SFVM_INITMENUPOPUP             7
1228 #define SFVM_SELECTIONCHANGED          8 /* undocumented */
1229 #define SFVM_DRAWMENUITEM              9 /* undocumented */
1230 #define SFVM_MEASUREMENUITEM          10 /* undocumented */
1231 #define SFVM_EXITMENULOOP             11 /* undocumented */
1232 #define SFVM_VIEWRELEASE              12 /* undocumented */
1233 #define SFVM_GETNAMELENGTH            13 /* undocumented */
1234 #define SFVM_FSNOTIFY                 14
1235 #define SFVM_WINDOWCREATED            15
1236 #define SFVM_WINDOWCLOSING            16 /* undocumented */
1237 #define SFVM_LISTREFRESHED            17 /* undocumented */
1238 #define SFVM_WINDOWFOCUSED            18 /* undocumented */
1239 #define SFVM_REGISTERCOPYHOOK         20 /* undocumented */
1240 #define SFVM_COPYHOOKCALLBACK         21 /* undocumented */
1241 #define SFVM_GETDETAILSOF             23
1242 #define SFVM_COLUMNCLICK              24
1243 #define SFVM_QUERYFSNOTIFY            25
1244 #define SFVM_DEFITEMCOUNT             26
1245 #define SFVM_DEFVIEWMODE              27
1246 #define SFVM_UNMERGEFROMMENU          28
1247 #define SFVM_ADDINGOBJECT             29 /* undocumented */
1248 #define SFVM_REMOVINGOBJECT           30 /* undocumented */
1249 #define SFVM_UPDATESTATUSBAR          31
1250 #define SFVM_BACKGROUNDENUM           32
1251 #define SFVM_GETCOMMANDDIR            33 /* undocumented */
1252 #define SFVM_GETCOLUMNSTREAM          34 /* undocumented */
1253 #define SFVM_CANSELECTALL             35 /* undocumented */
1254 #define SFVM_DIDDRAGDROP              36
1255 #define SFVM_ISSTRICTREFRESH          37 /* undocumented */
1256 #define SFVM_ISCHILDOBJECT            38 /* undocumented */
1257 #define SFVM_SETISFV                  39
1258 #define SFVM_GETEXTVIEWS              40 /* undocumented */
1259 #define SFVM_THISIDLIST               41
1260 #define SFVM_ADDPROPERTYPAGES         47
1261 #define SFVM_BACKGROUNDENUMDONE       48
1262 #define SFVM_GETNOTIFY                49
1263 #define SFVM_GETSORTDEFAULTS          53
1264 #define SFVM_SIZE                     57
1265 #define SFVM_GETZONE                  58
1266 #define SFVM_GETPANE                  59
1267 #define SFVM_GETHELPTOPIC             63
1268 #define SFVM_GETANIMATION             68
1269 #define SFVM_GET_CUSTOMVIEWINFO       77 /* undocumented */
1270 #define SFVM_ENUMERATEDITEMS          79 /* undocumented */
1271 #define SFVM_GET_VIEW_DATA            80 /* undocumented */
1272 #define SFVM_GET_WEBVIEW_LAYOUT       82 /* undocumented */
1273 #define SFVM_GET_WEBVIEW_CONTENT      83 /* undocumented */
1274 #define SFVM_GET_WEBVIEW_TASKS        84 /* undocumented */
1275 #define SFVM_GET_WEBVIEW_THEME        86 /* undocumented */
1276 #define SFVM_GETDEFERREDVIEWSETTINGS  92 /* undocumented */
1277 
1278 #include <pshpack8.h>
1279 
1280 typedef struct _SFV_CREATE
1281 {
1282     UINT cbSize;
1283     IShellFolder *pshf;
1284     IShellView *psvOuter;
1285     IShellFolderViewCB *psfvcb;
1286 } SFV_CREATE;
1287 
1288 #include <poppack.h>
1289 
1290 HRESULT
1291 WINAPI
1292 SHCreateShellFolderView(
1293   _In_ const SFV_CREATE *pscfv,
1294   _Outptr_ IShellView **ppsv);
1295 
1296 /* Types and definitions for the SFM_* parameters */
1297 #include <pshpack8.h>
1298 
1299 #define QCMINFO_PLACE_BEFORE          0
1300 #define QCMINFO_PLACE_AFTER           1
1301 typedef struct _QCMINFO_IDMAP_PLACEMENT
1302 {
1303     UINT id;
1304     UINT fFlags;
1305 } QCMINFO_IDMAP_PLACEMENT;
1306 
1307 typedef struct _QCMINFO_IDMAP
1308 {
1309     UINT nMaxIds;
1310     QCMINFO_IDMAP_PLACEMENT pIdList[1];
1311 } QCMINFO_IDMAP;
1312 
1313 typedef struct _QCMINFO
1314 {
1315     HMENU hmenu;
1316     UINT indexMenu;
1317     UINT idCmdFirst;
1318     UINT idCmdLast;
1319     QCMINFO_IDMAP const* pIdMap;
1320 } QCMINFO, *LPQCMINFO;
1321 
1322 #define TBIF_DEFAULT           0x00000000
1323 #define TBIF_APPEND            0x00000000
1324 #define TBIF_PREPEND           0x00000001
1325 #define TBIF_REPLACE           0x00000002
1326 #define TBIF_INTERNETBAR       0x00010000
1327 #define TBIF_STANDARDTOOLBAR   0x00020000
1328 #define TBIF_NOTOOLBAR         0x00030000
1329 
1330 typedef struct _TBINFO
1331 {
1332     UINT cbuttons;
1333     UINT uFlags;
1334 } TBINFO, *LPTBINFO;
1335 
1336 #include <poppack.h>
1337 
1338 /****************************************************************************
1339 *	SHShellFolderView_Message API
1340 */
1341 
1342 LRESULT
1343 WINAPI
1344 SHShellFolderView_Message(
1345   _In_ HWND hwndCabinet,
1346   UINT uMessage,
1347   LPARAM lParam);
1348 
1349 /* SHShellFolderView_Message messages */
1350 #define SFVM_REARRANGE          0x0001
1351 #define SFVM_GETARRANGECOLUMN   0x0002 /* undocumented */
1352 #define SFVM_ADDOBJECT          0x0003
1353 #define SFVM_GETITEMCOUNT       0x0004 /* undocumented */
1354 #define SFVM_GETITEMPIDL        0x0005 /* undocumented */
1355 #define SFVM_REMOVEOBJECT       0x0006
1356 #define SFVM_UPDATEOBJECT       0x0007
1357 #define SFVM_SETREDRAW          0x0008 /* undocumented */
1358 #define SFVM_GETSELECTEDOBJECTS 0x0009
1359 #define SFVM_ISDROPONSOURCE     0x000A /* undocumented */
1360 #define SFVM_MOVEICONS          0x000B /* undocumented */
1361 #define SFVM_GETDRAGPOINT       0x000C /* undocumented */
1362 #define SFVM_GETDROPPOINT       0x000D /* undocumented */
1363 #define SFVM_SETITEMPOS         0x000E
1364 #define SFVM_ISDROPONBACKGROUND 0x000F /* undocumented */
1365 #define SFVM_SETCLIPBOARD       0x0010
1366 #define SFVM_TOGGLEAUTOARRANGE  0x0011 /* undocumented */
1367 #define SFVM_LINEUPICONS        0x0012 /* undocumented */
1368 #define SFVM_GETAUTOARRANGE     0x0013 /* undocumented */
1369 #define SFVM_GETSELECTEDCOUNT   0x0014 /* undocumented */
1370 #define SFVM_GETITEMSPACING     0x0015 /* undocumented */
1371 #define SFVM_REFRESHOBJECT      0x0016 /* undocumented */
1372 #define SFVM_SETPOINTS          0x0017
1373 
1374 /****************************************************************************
1375 *	SHGetDataFromIDList API
1376 */
1377 #define SHGDFIL_FINDDATA        1
1378 #define SHGDFIL_NETRESOURCE     2
1379 #define SHGDFIL_DESCRIPTIONID   3
1380 
1381 #define SHDID_ROOT_REGITEM          1
1382 #define SHDID_FS_FILE               2
1383 #define SHDID_FS_DIRECTORY          3
1384 #define SHDID_FS_OTHER              4
1385 #define SHDID_COMPUTER_DRIVE35      5
1386 #define SHDID_COMPUTER_DRIVE525     6
1387 #define SHDID_COMPUTER_REMOVABLE    7
1388 #define SHDID_COMPUTER_FIXED        8
1389 #define SHDID_COMPUTER_NETDRIVE     9
1390 #define SHDID_COMPUTER_CDROM        10
1391 #define SHDID_COMPUTER_RAMDISK      11
1392 #define SHDID_COMPUTER_OTHER        12
1393 #define SHDID_NET_DOMAIN            13
1394 #define SHDID_NET_SERVER            14
1395 #define SHDID_NET_SHARE             15
1396 #define SHDID_NET_RESTOFNET         16
1397 #define SHDID_NET_OTHER             17
1398 #define SHDID_COMPUTER_IMAGING      18
1399 #define SHDID_COMPUTER_AUDIO        19
1400 #define SHDID_COMPUTER_SHAREDDOCS   20
1401 
1402 #include <pshpack8.h>
1403 
1404 typedef struct _SHDESCRIPTIONID
1405 {   DWORD   dwDescriptionId;
1406     CLSID   clsid;
1407 } SHDESCRIPTIONID, *LPSHDESCRIPTIONID;
1408 
1409 #include <poppack.h>
1410 
1411 HRESULT
1412 WINAPI
1413 SHGetDataFromIDListA(
1414   _In_ LPSHELLFOLDER psf,
1415   _In_ PCUITEMID_CHILD pidl,
1416   int nFormat,
1417   _Out_writes_bytes_(cb) LPVOID pv,
1418   int cb);
1419 
1420 HRESULT
1421 WINAPI
1422 SHGetDataFromIDListW(
1423   _In_ LPSHELLFOLDER psf,
1424   _In_ PCUITEMID_CHILD pidl,
1425   int nFormat,
1426   _Out_writes_bytes_(cb) LPVOID pv,
1427   int cb);
1428 
1429 #define SHGetDataFromIDList WINELIB_NAME_AW(SHGetDataFromIDList)
1430 
1431 PIDLIST_ABSOLUTE
1432 WINAPI
1433 SHCloneSpecialIDList(
1434   _Reserved_ HWND hwnd,
1435   _In_ int csidl,
1436   _In_ BOOL fCreate);
1437 
1438 _Success_(return != 0)
1439 BOOL
1440 WINAPI
1441 SHGetSpecialFolderPathA(
1442   _Reserved_ HWND hwndOwner,
1443   _Out_writes_(MAX_PATH) LPSTR szPath,
1444   _In_ int nFolder,
1445   _In_ BOOL bCreate);
1446 
1447 _Success_(return != 0)
1448 BOOL
1449 WINAPI
1450 SHGetSpecialFolderPathW(
1451   _Reserved_ HWND hwndOwner,
1452   _Out_writes_(MAX_PATH) LPWSTR szPath,
1453   _In_ int nFolder,
1454   _In_ BOOL bCreate);
1455 
1456 #define SHGetSpecialFolderPath WINELIB_NAME_AW(SHGetSpecialFolderPath)
1457 
1458 _Check_return_ HRESULT WINAPI SHGetMalloc(_Outptr_ LPMALLOC *lpmal);
1459 
1460 /**********************************************************************
1461  * SHGetSetSettings ()
1462  */
1463 
1464 typedef struct
1465 {
1466     BOOL  fShowAllObjects : 1;
1467     BOOL  fShowExtensions : 1;
1468     BOOL  fNoConfirmRecycle : 1;
1469 
1470     BOOL  fShowSysFiles : 1;
1471     BOOL  fShowCompColor : 1;
1472     BOOL  fDoubleClickInWebView : 1;
1473     BOOL  fDesktopHTML : 1;
1474     BOOL  fWin95Classic : 1;
1475     BOOL  fDontPrettyPath : 1;
1476     BOOL  fShowAttribCol : 1;
1477     BOOL  fMapNetDrvBtn : 1;
1478     BOOL  fShowInfoTip : 1;
1479     BOOL  fHideIcons : 1;
1480     BOOL  fWebView : 1;
1481     BOOL  fFilter : 1;
1482     BOOL  fShowSuperHidden : 1;
1483     BOOL  fNoNetCrawling : 1;
1484 
1485     UINT  :15; /* Required for proper binary layout with gcc */
1486     DWORD dwWin95Unused;
1487     UINT  uWin95Unused;
1488     LONG  lParamSort;
1489     int   iSortDirection;
1490     UINT  version;
1491     UINT  uNotUsed;
1492     BOOL  fSepProcess: 1;
1493     BOOL  fStartPanelOn: 1;
1494     BOOL  fShowStartPage: 1;
1495     UINT  fSpareFlags : 13;
1496     UINT  :15; /* Required for proper binary layout with gcc */
1497 } SHELLSTATE, *LPSHELLSTATE;
1498 
1499 VOID WINAPI SHGetSetSettings(LPSHELLSTATE lpss, DWORD dwMask, BOOL bSet);
1500 
1501 /**********************************************************************
1502  * SHGetSettings ()
1503  */
1504 typedef struct
1505 {	BOOL fShowAllObjects : 1;
1506 	BOOL fShowExtensions : 1;
1507 	BOOL fNoConfirmRecycle : 1;
1508 	BOOL fShowSysFiles : 1;
1509 
1510 	BOOL fShowCompColor : 1;
1511 	BOOL fDoubleClickInWebView : 1;
1512 	BOOL fDesktopHTML : 1;
1513 	BOOL fWin95Classic : 1;
1514 
1515 	BOOL fDontPrettyPath : 1;
1516 	BOOL fShowAttribCol : 1;
1517 	BOOL fMapNetDrvBtn : 1;
1518 	BOOL fShowInfoTip : 1;
1519 
1520 	BOOL fHideIcons : 1;
1521 	UINT fRestFlags : 3;
1522 	UINT :15; /* Required for proper binary layout with gcc */
1523 } SHELLFLAGSTATE, * LPSHELLFLAGSTATE;
1524 
1525 VOID WINAPI SHGetSettings(_Out_ LPSHELLFLAGSTATE lpsfs, DWORD dwMask);
1526 
1527 #define SSF_SHOWALLOBJECTS		0x0001
1528 #define SSF_SHOWEXTENSIONS		0x0002
1529 #define SSF_SHOWCOMPCOLOR		0x0008
1530 #define SSF_SHOWSYSFILES		0x0020
1531 #define SSF_DOUBLECLICKINWEBVIEW	0x0080
1532 #define SSF_SHOWATTRIBCOL		0x0100
1533 #define SSF_DESKTOPHTML			0x0200
1534 #define SSF_WIN95CLASSIC		0x0400
1535 #define SSF_DONTPRETTYPATH		0x0800
1536 #define SSF_SHOWINFOTIP			0x2000
1537 #define SSF_MAPNETDRVBUTTON		0x1000
1538 #define SSF_NOCONFIRMRECYCLE		0x8000
1539 #define SSF_HIDEICONS			0x4000
1540 #define SSF_SHOWSUPERHIDDEN		0x00040000
1541 #define SSF_SEPPROCESS			0x00080000
1542 
1543 /****************************************************************************
1544 * SHRestricted API
1545 */
1546 typedef enum RESTRICTIONS
1547 {
1548 	REST_NONE			= 0x00000000,
1549 	REST_NORUN			= 0x00000001,
1550 	REST_NOCLOSE			= 0x00000002,
1551 	REST_NOSAVESET			= 0x00000004,
1552 	REST_NOFILEMENU			= 0x00000008,
1553 	REST_NOSETFOLDERS		= 0x00000010,
1554 	REST_NOSETTASKBAR		= 0x00000020,
1555 	REST_NODESKTOP			= 0x00000040,
1556 	REST_NOFIND			= 0x00000080,
1557 	REST_NODRIVES			= 0x00000100,
1558 	REST_NODRIVEAUTORUN		= 0x00000200,
1559 	REST_NODRIVETYPEAUTORUN		= 0x00000400,
1560 	REST_NONETHOOD			= 0x00000800,
1561 	REST_STARTBANNER		= 0x00001000,
1562 	REST_RESTRICTRUN		= 0x00002000,
1563 	REST_NOPRINTERTABS		= 0x00004000,
1564 	REST_NOPRINTERDELETE		= 0x00008000,
1565 	REST_NOPRINTERADD		= 0x00010000,
1566 	REST_NOSTARTMENUSUBFOLDERS	= 0x00020000,
1567 	REST_MYDOCSONNET		= 0x00040000,
1568 	REST_NOEXITTODOS		= 0x00080000,
1569 	REST_ENFORCESHELLEXTSECURITY	= 0x00100000,
1570 	REST_LINKRESOLVEIGNORELINKINFO	= 0x00200000,
1571 	REST_NOCOMMONGROUPS		= 0x00400000,
1572 	REST_SEPARATEDESKTOPPROCESS	= 0x00800000,
1573 	REST_NOWEB			= 0x01000000,
1574 	REST_NOTRAYCONTEXTMENU		= 0x02000000,
1575 	REST_NOVIEWCONTEXTMENU		= 0x04000000,
1576 	REST_NONETCONNECTDISCONNECT	= 0x08000000,
1577 	REST_STARTMENULOGOFF		= 0x10000000,
1578 	REST_NOSETTINGSASSIST		= 0x20000000,
1579 	REST_NOINTERNETICON		= 0x40000001,
1580 	REST_NORECENTDOCSHISTORY,
1581 	REST_NORECENTDOCSMENU,
1582 	REST_NOACTIVEDESKTOP,
1583 	REST_NOACTIVEDESKTOPCHANGES,
1584 	REST_NOFAVORITESMENU,
1585 	REST_CLEARRECENTDOCSONEXIT,
1586 	REST_CLASSICSHELL,
1587 	REST_NOCUSTOMIZEWEBVIEW,
1588 
1589 	REST_NOHTMLWALLPAPER		= 0x40000010,
1590 	REST_NOCHANGINGWALLPAPER,
1591 	REST_NODESKCOMP,
1592 	REST_NOADDDESKCOMP,
1593 	REST_NODELDESKCOMP,
1594 	REST_NOCLOSEDESKCOMP,
1595 	REST_NOCLOSE_DRAGDROPBAND,
1596 	REST_NOMOVINGBAND,
1597 	REST_NOEDITDESKCOMP,
1598 	REST_NORESOLVESEARCH,
1599 	REST_NORESOLVETRACK,
1600 	REST_FORCECOPYACLWITHFILE,
1601 #if (NTDDI_VERSION < NTDDI_LONGHORN)
1602 	REST_NOLOGO3CHANNELNOTIFY	= 0x4000001C,
1603 #endif
1604 	REST_NOFORGETSOFTWAREUPDATE	= 0x4000001D,
1605 	REST_NOSETACTIVEDESKTOP,
1606 	REST_NOUPDATEWINDOWS,
1607 	REST_NOCHANGESTARMENU,		/* 0x40000020 */
1608 	REST_NOFOLDEROPTIONS,
1609 	REST_HASFINDCOMPUTERS,
1610 	REST_INTELLIMENUS,
1611 	REST_RUNDLGMEMCHECKBOX,
1612 	REST_ARP_ShowPostSetup,
1613 	REST_NOCSC,
1614 	REST_NOCONTROLPANEL,
1615 	REST_ENUMWORKGROUP,
1616 	REST_ARP_NOARP,
1617 	REST_ARP_NOREMOVEPAGE,
1618 	REST_ARP_NOADDPAGE,
1619 	REST_ARP_NOWINSETUPPAGE,
1620 	REST_GREYMSIADS,
1621 	REST_NOCHANGEMAPPEDDRIVELABEL,
1622 	REST_NOCHANGEMAPPEDDRIVECOMMENT,
1623 	REST_MaxRecentDocs,		/* 0x40000030 */
1624 	REST_NONETWORKCONNECTIONS,
1625 	REST_FORCESTARTMENULOGOFF,
1626 	REST_NOWEBVIEW,
1627 	REST_NOCUSTOMIZETHISFOLDER,
1628 	REST_NOENCRYPTION,
1629 
1630 	REST_ALLOWFRENCHENCRYPTION,	/* not documented */
1631 
1632 	REST_DONTSHOWSUPERHIDDEN,
1633 	REST_NOSHELLSEARCHBUTTON,
1634 	REST_NOHARDWARETAB,
1635 	REST_NORUNASINSTALLPROMPT,
1636 	REST_PROMPTRUNASINSTALLNETPATH,
1637 	REST_NOMANAGEMYCOMPUTERVERB,
1638 	REST_NORECENTDOCSNETHOOD,
1639 	REST_DISALLOWRUN,
1640 	REST_NOWELCOMESCREEN,
1641 	REST_RESTRICTCPL,		/* 0x40000040 */
1642 	REST_DISALLOWCPL,
1643 	REST_NOSMBALLOONTIP,
1644 	REST_NOSMHELP,
1645 	REST_NOWINKEYS,
1646 	REST_NOENCRYPTONMOVE,
1647 	REST_NOLOCALMACHINERUN,
1648 	REST_NOCURRENTUSERRUN,
1649 	REST_NOLOCALMACHINERUNONCE,
1650 	REST_NOCURRENTUSERRUNONCE,
1651 	REST_FORCEACTIVEDESKTOPON,
1652 	REST_NOCOMPUTERSNEARME,
1653 	REST_NOVIEWONDRIVE,
1654 	REST_NONETCRAWL,
1655 	REST_NOSHAREDDOCUMENTS,
1656 	REST_NOSMMYDOCS,
1657 	REST_NOSMMYPICS,		/* 0x40000050 */
1658 	REST_ALLOWBITBUCKDRIVES,
1659 	REST_NONLEGACYSHELLMODE,
1660 	REST_NOCONTROLPANELBARRICADE,
1661 	REST_NOSTARTPAGE,
1662 	REST_NOAUTOTRAYNOTIFY,
1663 	REST_NOTASKGROUPING,
1664 	REST_NOCDBURNING,
1665 	REST_MYCOMPNOPROP,
1666 	REST_MYDOCSNOPROP,
1667 	REST_NOSTARTPANEL,
1668 	REST_NODISPLAYAPPEARANCEPAGE,
1669 	REST_NOTHEMESTAB,
1670 	REST_NOVISUALSTYLECHOICE,
1671 	REST_NOSIZECHOICE,
1672 	REST_NOCOLORCHOICE,
1673 	REST_SETVISUALSTYLE,		/* 0x40000060 */
1674 	REST_STARTRUNNOHOMEPATH,
1675 	REST_NOUSERNAMEINSTARTPANEL,
1676 	REST_NOMYCOMPUTERICON,
1677 	REST_NOSMNETWORKPLACES,
1678 	REST_NOSMPINNEDLIST,
1679 	REST_NOSMMYMUSIC,
1680 	REST_NOSMEJECTPC,
1681 	REST_NOSMMOREPROGRAMS,
1682 	REST_NOSMMFUPROGRAMS,
1683 	REST_NOTRAYITEMSDISPLAY,
1684 	REST_NOTOOLBARSONTASKBAR,
1685 	/* 0x4000006C
1686 	   0x4000006D
1687 	   0x4000006E */
1688 	REST_NOSMCONFIGUREPROGRAMS	= 0x4000006F,
1689 	REST_HIDECLOCK,			/* 0x40000070 */
1690 	REST_NOLOWDISKSPACECHECKS,
1691 	REST_NOENTIRENETWORK,
1692 	REST_NODESKTOPCLEANUP,
1693 	REST_BITBUCKNUKEONDELETE,
1694 	REST_BITBUCKCONFIRMDELETE,
1695 	REST_BITBUCKNOPROP,
1696 	REST_NODISPBACKGROUND,
1697 	REST_NODISPSCREENSAVEPG,
1698 	REST_NODISPSETTINGSPG,
1699 	REST_NODISPSCREENSAVEPREVIEW,
1700 	REST_NODISPLAYCPL,
1701 	REST_HIDERUNASVERB,
1702 	REST_NOTHUMBNAILCACHE,
1703 	REST_NOSTRCMPLOGICAL,
1704 	REST_NOPUBLISHWIZARD,
1705 	REST_NOONLINEPRINTSWIZARD,	/* 0x40000080 */
1706 	REST_NOWEBSERVICES,
1707 	REST_ALLOWUNHASHEDWEBVIEW,
1708 	REST_ALLOWLEGACYWEBVIEW,
1709 	REST_REVERTWEBVIEWSECURITY,
1710 
1711 	REST_INHERITCONSOLEHANDLES	= 0x40000086,
1712 
1713 	REST_NODISCONNECT		= 0x41000001,
1714 	REST_NOSECURITY,
1715 	REST_NOFILEASSOCIATE,		/* 0x41000003 */
1716 } RESTRICTIONS;
1717 
1718 DWORD WINAPI SHRestricted(RESTRICTIONS rest);
1719 
1720 /****************************************************************************
1721 * SHChangeNotify API
1722 */
1723 typedef struct _SHChangeNotifyEntry
1724 {
1725     PCIDLIST_ABSOLUTE pidl;
1726     BOOL   fRecursive;
1727 } SHChangeNotifyEntry;
1728 
1729 #define SHCNE_RENAMEITEM	0x00000001
1730 #define SHCNE_CREATE		0x00000002
1731 #define SHCNE_DELETE		0x00000004
1732 #define SHCNE_MKDIR		0x00000008
1733 #define SHCNE_RMDIR		0x00000010
1734 #define SHCNE_MEDIAINSERTED	0x00000020
1735 #define SHCNE_MEDIAREMOVED	0x00000040
1736 #define SHCNE_DRIVEREMOVED	0x00000080
1737 #define SHCNE_DRIVEADD		0x00000100
1738 #define SHCNE_NETSHARE		0x00000200
1739 #define SHCNE_NETUNSHARE	0x00000400
1740 #define SHCNE_ATTRIBUTES	0x00000800
1741 #define SHCNE_UPDATEDIR		0x00001000
1742 #define SHCNE_UPDATEITEM	0x00002000
1743 #define SHCNE_SERVERDISCONNECT	0x00004000
1744 #define SHCNE_UPDATEIMAGE	0x00008000
1745 #define SHCNE_DRIVEADDGUI	0x00010000
1746 #define SHCNE_RENAMEFOLDER	0x00020000
1747 #define SHCNE_FREESPACE		0x00040000
1748 
1749 #define SHCNE_EXTENDED_EVENT	0x04000000
1750 #define SHCNE_ASSOCCHANGED	0x08000000
1751 #define SHCNE_DISKEVENTS	0x0002381F
1752 #define SHCNE_GLOBALEVENTS	0x0C0581E0
1753 #define SHCNE_ALLEVENTS		0x7FFFFFFF
1754 #define SHCNE_INTERRUPT		0x80000000
1755 
1756 #define SHCNEE_ORDERCHANGED	0x0002L
1757 #define SHCNEE_MSI_CHANGE	0x0004L
1758 #define SHCNEE_MSI_UNINSTALL	0x0005L
1759 
1760 #define SHCNF_IDLIST		0x0000
1761 #define SHCNF_PATHA		0x0001
1762 #define SHCNF_PRINTERA		0x0002
1763 #define SHCNF_DWORD		0x0003
1764 #define SHCNF_PATHW		0x0005
1765 #define SHCNF_PRINTERW		0x0006
1766 #define SHCNF_TYPE		0x00FF
1767 #define SHCNF_FLUSH		0x1000
1768 #define SHCNF_FLUSHNOWAIT	0x3000
1769 #define SHCNF_NOTIFYRECURSIVE	0x10000
1770 
1771 #define SHCNF_PATH              WINELIB_NAME_AW(SHCNF_PATH)
1772 #define SHCNF_PRINTER           WINELIB_NAME_AW(SHCNF_PRINTER)
1773 
1774 #define SHCNRF_InterruptLevel 0x0001
1775 #define SHCNRF_ShellLevel 0x0002
1776 #define SHCNRF_RecursiveInterrupt 0x1000
1777 #define SHCNRF_NewDelivery 0x8000
1778 
1779 void WINAPI SHChangeNotify(LONG wEventId, UINT uFlags, LPCVOID dwItem1, LPCVOID dwItem2);
1780 
1781 typedef enum {
1782     SLDF_DEFAULT = 0x00000000,
1783     SLDF_HAS_ID_LIST = 0x00000001,
1784     SLDF_HAS_LINK_INFO = 0x00000002,
1785     SLDF_HAS_NAME = 0x00000004,
1786     SLDF_HAS_RELPATH = 0x00000008,
1787     SLDF_HAS_WORKINGDIR = 0x00000010,
1788     SLDF_HAS_ARGS = 0x00000020,
1789     SLDF_HAS_ICONLOCATION = 0x00000040,
1790     SLDF_UNICODE = 0x00000080,
1791     SLDF_FORCE_NO_LINKINFO = 0x00000100,
1792     SLDF_HAS_EXP_SZ = 0x00000200,
1793     SLDF_RUN_IN_SEPARATE = 0x00000400,
1794 #if (NTDDI_VERSION < NTDDI_LONGHORN)
1795     SLDF_HAS_LOGO3ID = 0x00000800,
1796 #endif
1797     SLDF_HAS_DARWINID = 0x00001000,
1798     SLDF_RUNAS_USER = 0x00002000,
1799     SLDF_HAS_EXP_ICON_SZ = 0x00004000,
1800     SLDF_NO_PIDL_ALIAS = 0x00008000,
1801     SLDF_FORCE_UNCNAME = 0x00010000,
1802     SLDF_RUN_WITH_SHIMLAYER = 0x00020000,
1803 #if (NTDDI_VERSION >= NTDDI_LONGHORN)
1804     SLDF_FORCE_NO_LINKTRACK = 0x00040000,
1805     SLDF_ENABLE_TARGET_METADATA = 0x00080000,
1806     SLDF_DISABLE_LINK_PATH_TRACKING = 0x00100000,
1807     SLDF_DISABLE_KNOWNFOLDER_RELATIVE_TRACKING = 0x00200000,
1808 #if (NTDDI_VERSION >= NTDDI_WIN7)
1809     SLDF_NO_KF_ALIAS = 0x00400000,
1810     SLDF_ALLOW_LINK_TO_LINK = 0x00800000,
1811     SLDF_UNALIAS_ON_SAVE = 0x01000000,
1812     SLDF_PREFER_ENVIRONMENT_PATH = 0x02000000,
1813     SLDF_KEEP_LOCAL_IDLIST_FOR_UNC_TARGET = 0x04000000,
1814 #if (NTDDI_VERSION >= NTDDI_WIN8)
1815     SLDF_PERSIST_VOLUME_ID_RELATIVE = 0x08000000,
1816     SLDF_VALID = 0x0ffff7ff, /* Windows 8 */
1817 #else
1818     SLDF_VALID = 0x07fff7ff, /* Windows 7 */
1819 #endif
1820 #else
1821     SLDF_VALID = 0x003ff7ff, /* Windows Vista */
1822 #endif
1823 #endif
1824     SLDF_RESERVED = 0x80000000,
1825 } SHELL_LINK_DATA_FLAGS;
1826 
1827 typedef struct tagDATABLOCKHEADER
1828 {
1829     DWORD cbSize;
1830     DWORD dwSignature;
1831 } DATABLOCK_HEADER, *LPDATABLOCK_HEADER, *LPDBLIST;
1832 
1833 #ifdef LF_FACESIZE
1834 typedef struct {
1835     DATABLOCK_HEADER dbh;
1836     WORD  wFillAttribute;
1837     WORD  wPopupFillAttribute;
1838     COORD dwScreenBufferSize;
1839     COORD dwWindowSize;
1840     COORD dwWindowOrigin;
1841     DWORD nFont;
1842     DWORD nInputBufferSize;
1843     COORD dwFontSize;
1844     UINT  uFontFamily;
1845     UINT  uFontWeight;
1846     WCHAR FaceName[LF_FACESIZE];
1847     UINT  uCursorSize;
1848     BOOL  bFullScreen;
1849     BOOL  bQuickEdit;
1850     BOOL  bInsertMode;
1851     BOOL  bAutoPosition;
1852     UINT  uHistoryBufferSize;
1853     UINT  uNumberOfHistoryBuffers;
1854     BOOL  bHistoryNoDup;
1855     COLORREF ColorTable[16];
1856 } NT_CONSOLE_PROPS, *LPNT_CONSOLE_PROPS;
1857 #endif
1858 
1859 typedef struct {
1860     DATABLOCK_HEADER dbh;
1861     UINT uCodePage;
1862 } NT_FE_CONSOLE_PROPS, *LPNT_FE_CONSOLE_PROPS;
1863 
1864 typedef struct {
1865     DWORD cbSize;
1866     DWORD dwSignature;
1867     CHAR szTarget[MAX_PATH];
1868     WCHAR szwTarget[MAX_PATH];
1869 } EXP_SZ_LINK, *LPEXP_SZ_LINK;
1870 
1871 typedef struct {
1872     DATABLOCK_HEADER dbh;
1873     CHAR szDarwinID[MAX_PATH];
1874     WCHAR szwDarwinID[MAX_PATH];
1875 } EXP_DARWIN_LINK, *LPEXP_DARWIN_LINK;
1876 
1877 typedef struct {
1878     DWORD cbSize;
1879     DWORD dwSignature;
1880     DWORD idSpecialFolder;
1881     DWORD cbOffset;
1882 } EXP_SPECIAL_FOLDER, *LPEXP_SPECIAL_FOLDER;
1883 
1884 typedef struct {
1885     DWORD cbSize;
1886     DWORD dwSignature;
1887     BYTE  abPropertyStorage[1];
1888 } EXP_PROPERTYSTORAGE;
1889 
1890 #define EXP_SZ_LINK_SIG         0xA0000001 /* EXP_SZ_LINK */
1891 #define NT_CONSOLE_PROPS_SIG    0xA0000002 /* NT_CONSOLE_PROPS */
1892 #define NT_FE_CONSOLE_PROPS_SIG 0xA0000004 /* NT_FE_CONSOLE_PROPS */
1893 #define EXP_SPECIAL_FOLDER_SIG  0xA0000005 /* EXP_SPECIAL_FOLDER */
1894 #define EXP_DARWIN_ID_SIG       0xA0000006 /* EXP_DARWIN_LINK */
1895 #if (NTDDI_VERSION < NTDDI_LONGHORN)
1896 #define EXP_LOGO3_ID_SIG        0xA0000007 /* EXP_DARWIN_LINK, for Logo3 / MS Internet Component Download (MSICD) shortcuts; old SDKs only (deprecated) */
1897 #endif
1898 #define EXP_SZ_ICON_SIG         0xA0000007 /* EXP_SZ_LINK */
1899 #define EXP_PROPERTYSTORAGE_SIG 0xA0000009 /* EXP_PROPERTYSTORAGE */
1900 
1901 typedef struct _SHChangeDWORDAsIDList {
1902     USHORT   cb;
1903     DWORD    dwItem1;
1904     DWORD    dwItem2;
1905     USHORT   cbZero;
1906 } SHChangeDWORDAsIDList, *LPSHChangeDWORDAsIDList;
1907 
1908 typedef struct _SHChangeProductKeyAsIDList {
1909     USHORT cb;
1910     WCHAR wszProductKey[39];
1911     USHORT cbZero;
1912 } SHChangeProductKeyAsIDList, *LPSHChangeProductKeyAsIDList;
1913 
1914 ULONG
1915 WINAPI
1916 SHChangeNotifyRegister(
1917   _In_ HWND hwnd,
1918   int fSources,
1919   LONG fEvents,
1920   UINT wMsg,
1921   int cEntries,
1922   _In_ SHChangeNotifyEntry *pshcne);
1923 
1924 BOOL WINAPI SHChangeNotifyDeregister(ULONG ulID);
1925 
1926 HANDLE
1927 WINAPI
1928 SHChangeNotification_Lock(
1929   _In_ HANDLE hChangeNotification,
1930   DWORD dwProcessId,
1931   _Outptr_opt_result_buffer_(2)_Outptr_opt_result_buffer_(2) PIDLIST_ABSOLUTE **pppidl,
1932   _Out_opt_ LONG *plEvent);
1933 
1934 BOOL WINAPI SHChangeNotification_Unlock(_In_ HANDLE hLock);
1935 
1936 HRESULT
1937 WINAPI
1938 SHGetRealIDL(
1939   _In_ IShellFolder *psf,
1940   _In_ PCUITEMID_CHILD pidlSimple,
1941   _Outptr_ PITEMID_CHILD * ppidlReal);
1942 
1943 /****************************************************************************
1944 * SHCreateDirectory API
1945 */
1946 int WINAPI SHCreateDirectory(_In_opt_ HWND, _In_ LPCWSTR);
1947 
1948 int
1949 WINAPI
1950 SHCreateDirectoryExA(
1951   _In_opt_ HWND,
1952   _In_ LPCSTR,
1953   _In_opt_ LPSECURITY_ATTRIBUTES);
1954 
1955 int
1956 WINAPI
1957 SHCreateDirectoryExW(
1958   _In_opt_ HWND,
1959   _In_ LPCWSTR,
1960   _In_opt_ LPSECURITY_ATTRIBUTES);
1961 
1962 #define SHCreateDirectoryEx WINELIB_NAME_AW(SHCreateDirectoryEx)
1963 
1964 /****************************************************************************
1965 * SHGetSpecialFolderLocation API
1966 */
1967 _Check_return_
1968 HRESULT
1969 WINAPI
1970 SHGetSpecialFolderLocation(
1971   _Reserved_ HWND hwndOwner,
1972   _In_ int nFolder,
1973   _Outptr_ PIDLIST_ABSOLUTE *ppidl);
1974 
1975 HRESULT
1976 WINAPI
1977 SHGetFolderLocation(
1978   _Reserved_ HWND hwndOwner,
1979   _In_ int nFolder,
1980   _In_opt_ HANDLE hToken,
1981   _In_ DWORD dwReserved,
1982   _Outptr_ PIDLIST_ABSOLUTE *ppidl);
1983 
1984 /****************************************************************************
1985 * SHGetFolderPath API
1986 */
1987 typedef enum {
1988     SHGFP_TYPE_CURRENT = 0,
1989     SHGFP_TYPE_DEFAULT = 1
1990 } SHGFP_TYPE;
1991 
1992 HRESULT
1993 WINAPI
1994 SHGetFolderPathA(
1995   _Reserved_ HWND hwnd,
1996   _In_ int nFolder,
1997   _In_opt_ HANDLE hToken,
1998   _In_ DWORD dwFlags,
1999   _Out_writes_(MAX_PATH) LPSTR pszPath);
2000 
2001 HRESULT
2002 WINAPI
2003 SHGetFolderPathW(
2004   _Reserved_ HWND hwnd,
2005   _In_ int nFolder,
2006   _In_opt_ HANDLE hToken,
2007   _In_ DWORD dwFlags,
2008   _Out_writes_(MAX_PATH) LPWSTR pszPath);
2009 
2010 #define SHGetFolderPath WINELIB_NAME_AW(SHGetFolderPath)
2011 
2012 #define CSIDL_DESKTOP		0x0000
2013 #define CSIDL_INTERNET		0x0001
2014 #define CSIDL_PROGRAMS		0x0002
2015 #define CSIDL_CONTROLS		0x0003
2016 #define CSIDL_PRINTERS		0x0004
2017 #define CSIDL_PERSONAL		0x0005
2018 #define CSIDL_FAVORITES		0x0006
2019 #define CSIDL_STARTUP		0x0007
2020 #define CSIDL_RECENT		0x0008
2021 #define CSIDL_SENDTO		0x0009
2022 #define CSIDL_BITBUCKET		0x000a
2023 #define CSIDL_STARTMENU		0x000b
2024 #define CSIDL_MYDOCUMENTS	CSIDL_PERSONAL
2025 #define CSIDL_MYMUSIC		0x000d
2026 #define CSIDL_MYVIDEO		0x000e
2027 #define CSIDL_DESKTOPDIRECTORY	0x0010
2028 #define CSIDL_DRIVES		0x0011
2029 #define CSIDL_NETWORK		0x0012
2030 #define CSIDL_NETHOOD		0x0013
2031 #define CSIDL_FONTS		0x0014
2032 #define CSIDL_TEMPLATES		0x0015
2033 #define CSIDL_COMMON_STARTMENU	0x0016
2034 #define CSIDL_COMMON_PROGRAMS	0X0017
2035 #define CSIDL_COMMON_STARTUP	0x0018
2036 #define CSIDL_COMMON_DESKTOPDIRECTORY	0x0019
2037 #define CSIDL_APPDATA		0x001a
2038 #define CSIDL_PRINTHOOD		0x001b
2039 #define CSIDL_LOCAL_APPDATA	0x001c
2040 #define CSIDL_ALTSTARTUP	0x001d
2041 #define CSIDL_COMMON_ALTSTARTUP	0x001e
2042 #define CSIDL_COMMON_FAVORITES  0x001f
2043 #define CSIDL_INTERNET_CACHE	0x0020
2044 #define CSIDL_COOKIES		0x0021
2045 #define CSIDL_HISTORY		0x0022
2046 #define CSIDL_COMMON_APPDATA	0x0023
2047 #define CSIDL_WINDOWS		0x0024
2048 #define CSIDL_SYSTEM		0x0025
2049 #define CSIDL_PROGRAM_FILES	0x0026
2050 #define CSIDL_MYPICTURES	0x0027
2051 #define CSIDL_PROFILE		0x0028
2052 #define CSIDL_SYSTEMX86		0x0029
2053 #define CSIDL_PROGRAM_FILESX86	0x002a
2054 #define CSIDL_PROGRAM_FILES_COMMON	0x002b
2055 #define CSIDL_PROGRAM_FILES_COMMONX86	0x002c
2056 #define CSIDL_COMMON_TEMPLATES	0x002d
2057 #define CSIDL_COMMON_DOCUMENTS	0x002e
2058 #define CSIDL_COMMON_ADMINTOOLS	0x002f
2059 #define CSIDL_ADMINTOOLS	0x0030
2060 #define CSIDL_CONNECTIONS	0x0031
2061 #define CSIDL_COMMON_MUSIC	0x0035
2062 #define CSIDL_COMMON_PICTURES	0x0036
2063 #define CSIDL_COMMON_VIDEO	0x0037
2064 #define CSIDL_RESOURCES		0x0038
2065 #define CSIDL_RESOURCES_LOCALIZED 0x0039
2066 #define CSIDL_COMMON_OEM_LINKS	0x003a
2067 #define CSIDL_CDBURN_AREA	0x003b
2068 #define CSIDL_COMPUTERSNEARME	0x003d
2069 #define CSIDL_PROFILES		0x003e
2070 #define CSIDL_FOLDER_MASK	0x00ff
2071 #define CSIDL_FLAG_PER_USER_INIT 0x0800
2072 #define CSIDL_FLAG_NO_ALIAS	0x1000
2073 #define CSIDL_FLAG_DONT_VERIFY	0x4000
2074 #define CSIDL_FLAG_CREATE	0x8000
2075 
2076 #define CSIDL_FLAG_MASK		0xff00
2077 
2078 /****************************************************************************
2079  * SHGetDesktopFolder API
2080  */
2081 _Check_return_ HRESULT WINAPI SHGetDesktopFolder(_Outptr_ IShellFolder * *);
2082 
2083 /****************************************************************************
2084  * SHBindToParent API
2085  */
2086 HRESULT
2087 WINAPI
2088 SHBindToParent(
2089   _In_ PCIDLIST_ABSOLUTE pidl,
2090   _In_ REFIID riid,
2091   _Outptr_ LPVOID *ppv,
2092   _Outptr_opt_ PCUITEMID_CHILD *ppidlLast);
2093 
2094 /****************************************************************************
2095  * SHCreateFileExtractIcon API
2096  */
2097 #if (NTDDI_VERSION >= NTDDI_WINXP)
2098 
2099 // NOTE: Even if documented on MSDN, the SHCreateFileExtractIconA()
2100 // ANSI function never existed on Windows!
2101 
2102 HRESULT
2103 WINAPI
2104 SHCreateFileExtractIconW(
2105     _In_ LPCWSTR pszFile,
2106     _In_ DWORD dwFileAttributes,
2107     _In_ REFIID riid,
2108     _Outptr_ void **ppv);
2109 
2110 #ifdef UNICODE
2111 #define SHCreateFileExtractIcon  SHCreateFileExtractIconW
2112 #endif
2113 
2114 #endif /* (NTDDI_VERSION >= NTDDI_WINXP) */
2115 
2116 /****************************************************************************
2117 * SHDefExtractIcon API
2118 */
2119 HRESULT
2120 WINAPI
2121 SHDefExtractIconA(
2122   _In_ LPCSTR pszIconFile,
2123   int iIndex,
2124   UINT uFlags,
2125   _Out_opt_ HICON* phiconLarge,
2126   _Out_opt_ HICON* phiconSmall,
2127   UINT nIconSize);
2128 
2129 HRESULT
2130 WINAPI
2131 SHDefExtractIconW(
2132   _In_ LPCWSTR pszIconFile,
2133   int iIndex,
2134   UINT uFlags,
2135   _Out_opt_ HICON* phiconLarge,
2136   _Out_opt_ HICON* phiconSmall,
2137   UINT nIconSize);
2138 
2139 #define SHDefExtractIcon WINELIB_NAME_AW(SHDefExtractIcon)
2140 
2141 /*
2142  * DROPFILES for CF_HDROP and CF_PRINTERS
2143  */
2144 typedef struct _DROPFILES
2145 {
2146   DWORD pFiles;
2147   POINT pt;
2148   BOOL  fNC;
2149   BOOL  fWide;
2150 } DROPFILES, *LPDROPFILES;
2151 
2152 
2153 /*
2154  * FILEDESCRIPTOR[A|W].dwFlags
2155  */
2156 #define FD_CLSID        0x00000001
2157 #define FD_SIZEPOINT    0x00000002
2158 #define FD_ATTRIBUTES   0x00000004
2159 #define FD_CREATETIME   0x00000008
2160 #define FD_ACCESSTIME   0x00000010
2161 #define FD_WRITESTIME   0x00000020
2162 #define FD_FILESIZE     0x00000040
2163 #define FD_PROGRESSUI   0x00004000
2164 #define FD_LINKUI       0x00008000
2165 #if (NTDDI_VERSION >= NTDDI_VISTA)
2166 #define FD_UNICODE      0x80000000
2167 #endif
2168 
2169 /*
2170  * Properties of a file in the clipboard
2171  */
2172 typedef struct _FILEDESCRIPTORA {
2173     DWORD dwFlags;
2174     CLSID clsid;
2175     SIZEL sizel;
2176     POINTL pointl;
2177     DWORD dwFileAttributes;
2178     FILETIME ftCreationTime;
2179     FILETIME ftLastAccessTime;
2180     FILETIME ftLastWriteTime;
2181     DWORD nFileSizeHigh;
2182     DWORD nFileSizeLow;
2183     CHAR cFileName[MAX_PATH];
2184 } FILEDESCRIPTORA, *LPFILEDESCRIPTORA;
2185 
2186 typedef struct _FILEDESCRIPTORW {
2187     DWORD dwFlags;
2188     CLSID clsid;
2189     SIZEL sizel;
2190     POINTL pointl;
2191     DWORD dwFileAttributes;
2192     FILETIME ftCreationTime;
2193     FILETIME ftLastAccessTime;
2194     FILETIME ftLastWriteTime;
2195     DWORD nFileSizeHigh;
2196     DWORD nFileSizeLow;
2197     WCHAR cFileName[MAX_PATH];
2198 } FILEDESCRIPTORW, *LPFILEDESCRIPTORW;
2199 
2200 DECL_WINELIB_TYPE_AW(FILEDESCRIPTOR)
2201 DECL_WINELIB_TYPE_AW(LPFILEDESCRIPTOR)
2202 
2203 /*
2204  * CF_FILEGROUPDESCRIPTOR clipboard format
2205  */
2206 typedef struct _FILEGROUPDESCRIPTORA {
2207     UINT cItems;
2208     FILEDESCRIPTORA fgd[1];
2209 } FILEGROUPDESCRIPTORA, *LPFILEGROUPDESCRIPTORA;
2210 
2211 typedef struct _FILEGROUPDESCRIPTORW {
2212     UINT cItems;
2213     FILEDESCRIPTORW fgd[1];
2214 } FILEGROUPDESCRIPTORW, *LPFILEGROUPDESCRIPTORW;
2215 
2216 DECL_WINELIB_TYPE_AW(FILEGROUPDESCRIPTOR)
2217 DECL_WINELIB_TYPE_AW(LPFILEGROUPDESCRIPTOR)
2218 
2219 /****************************************************************************
2220  * Cabinet functions
2221  */
2222 
2223 typedef struct {
2224     WORD cLength;
2225     WORD nVersion;
2226     BOOL fFullPathTitle:1;
2227     BOOL fSaveLocalView:1;
2228     BOOL fNotShell:1;
2229     BOOL fSimpleDefault:1;
2230     BOOL fDontShowDescBar:1;
2231     BOOL fNewWindowMode:1;
2232     BOOL fShowCompColor:1;
2233     BOOL fDontPrettyNames:1;
2234     BOOL fAdminsCreateCommonGroups:1;
2235     UINT fUnusedFlags:7;
2236     UINT :15; /* Required for proper binary layout with gcc */
2237     UINT fMenuEnumFilter;
2238 } CABINETSTATE, *LPCABINETSTATE;
2239 
2240 #define CABINETSTATE_VERSION 2
2241 
2242 BOOL
2243 WINAPI
2244 ReadCabinetState(
2245   _Out_writes_bytes_(cLength) CABINETSTATE *,
2246   int cLength);
2247 
2248 BOOL WINAPI WriteCabinetState(_In_ CABINETSTATE *);
2249 
2250 /****************************************************************************
2251  * Path Manipulation Routines
2252  */
2253 
2254 /* PathProcessCommand flags */
2255 #define PPCF_ADDQUOTES        0x01
2256 #define PPCF_INCLUDEARGS      0x02
2257 #define PPCF_ADDARGUMENTS     0x03
2258 #define PPCF_NODIRECTORIES    0x10
2259 #define PPCF_DONTRESOLVE      0x20
2260 #define PPCF_FORCEQUALIFY     0x40
2261 #define PPCF_LONGESTPOSSIBLE  0x80
2262 
2263 /* PathResolve flags */
2264 #define PRF_VERIFYEXISTS         0x01
2265 #define PRF_EXECUTABLE           0x02
2266 #define PRF_TRYPROGRAMEXTENSIONS (PRF_EXECUTABLE | PRF_VERIFYEXISTS)
2267 #define PRF_FIRSTDIRDEF          0x04
2268 #define PRF_DONTFINDLNK          0x08 // Used when PRF_TRYPROGRAMEXTENSIONS is specified
2269 #if (NTDDI_VERSION >= NTDDI_WINXPSP2)
2270 #define PRF_REQUIREABSOLUTE      0x10
2271 #endif
2272 
2273 VOID WINAPI PathGetShortPath(_Inout_updates_(MAX_PATH) LPWSTR pszPath);
2274 
2275 LONG
2276 WINAPI
2277 PathProcessCommand(
2278   _In_ LPCWSTR,
2279   _Out_writes_(cchDest) LPWSTR,
2280   int cchDest,
2281   DWORD);
2282 
2283 _Success_(return != 0)
2284 BOOL
2285 WINAPI
2286 PathYetAnotherMakeUniqueName(
2287   _Out_writes_(MAX_PATH) LPWSTR,
2288   _In_ LPCWSTR,
2289   _In_opt_ LPCWSTR,
2290   _In_opt_ LPCWSTR);
2291 
2292 /****************************************************************************
2293  * Drag And Drop Routines
2294  */
2295 
2296 /* DAD_AutoScroll sample structure */
2297 #define NUM_POINTS 3
2298 typedef struct
2299 {
2300     int   iNextSample;
2301     DWORD dwLastScroll;
2302     BOOL  bFull;
2303     POINT pts[NUM_POINTS];
2304     DWORD dwTimes[NUM_POINTS];
2305 } AUTO_SCROLL_DATA;
2306 
2307 BOOL         WINAPI DAD_SetDragImage(HIMAGELIST,LPPOINT);
2308 BOOL         WINAPI DAD_DragEnterEx(HWND,POINT);
2309 BOOL         WINAPI DAD_DragEnterEx2(_In_ HWND, POINT, _In_opt_ IDataObject*);
2310 BOOL         WINAPI DAD_DragMove(POINT);
2311 BOOL         WINAPI DAD_DragLeave(void);
2312 BOOL         WINAPI DAD_AutoScroll(HWND,AUTO_SCROLL_DATA*,const POINT*);
2313 
2314 HRESULT
2315 WINAPI
2316 SHDoDragDrop(
2317   _In_opt_ HWND,
2318   _In_ IDataObject*,
2319   _In_opt_ IDropSource*,
2320   _In_ DWORD,
2321   _Out_ LPDWORD);
2322 
2323 /****************************************************************************
2324  * Internet shortcut properties
2325  */
2326 
2327 #define PID_IS_URL         2
2328 #define PID_IS_NAME        4
2329 #define PID_IS_WORKINGDIR  5
2330 #define PID_IS_HOTKEY      6
2331 #define PID_IS_SHOWCMD     7
2332 #define PID_IS_ICONINDEX   8
2333 #define PID_IS_ICONFILE    9
2334 #define PID_IS_WHATSNEW    10
2335 #define PID_IS_AUTHOR      11
2336 #define PID_IS_DESCRIPTION 12
2337 #define PID_IS_COMMENT     13
2338 
2339 
2340 PIDLIST_RELATIVE WINAPI ILAppendID(_In_opt_ PIDLIST_RELATIVE, _In_ LPCSHITEMID, BOOL);
2341 PIDLIST_RELATIVE WINAPI ILClone(_In_ PCUIDLIST_RELATIVE);
2342 PITEMID_CHILD WINAPI ILCloneFirst(_In_ PCUIDLIST_RELATIVE);
2343 PIDLIST_ABSOLUTE WINAPI ILCreateFromPathA(_In_ PCSTR);
2344 PIDLIST_ABSOLUTE WINAPI ILCreateFromPathW(_In_ PCWSTR);
2345 #define             ILCreateFromPath WINELIB_NAME_AW(ILCreateFromPath)
2346 PIDLIST_ABSOLUTE WINAPI ILCombine(_In_opt_ PCIDLIST_ABSOLUTE, _In_opt_ PCUIDLIST_RELATIVE);
2347 PUIDLIST_RELATIVE WINAPI ILFindChild(_In_ PIDLIST_ABSOLUTE, _In_ PCIDLIST_ABSOLUTE);
2348 PUITEMID_CHILD WINAPI ILFindLastID(_In_ PCUIDLIST_RELATIVE);
2349 void         WINAPI ILFree(_In_opt_ PIDLIST_RELATIVE);
2350 PUIDLIST_RELATIVE WINAPI ILGetNext(_In_opt_ PCUIDLIST_RELATIVE);
2351 UINT         WINAPI ILGetSize(_In_opt_ PCUIDLIST_RELATIVE);
2352 BOOL         WINAPI ILIsEqual(_In_ PCIDLIST_ABSOLUTE, _In_ PCIDLIST_ABSOLUTE);
2353 BOOL         WINAPI ILIsParent(_In_ PCIDLIST_ABSOLUTE, _In_ PCIDLIST_ABSOLUTE, BOOL);
2354 HRESULT      WINAPI ILLoadFromStream(_In_ LPSTREAM, _Inout_ PIDLIST_RELATIVE*);
2355 BOOL         WINAPI ILRemoveLastID(_Inout_opt_ PUIDLIST_RELATIVE);
2356 HRESULT      WINAPI ILSaveToStream(_In_ LPSTREAM, _In_ PCUIDLIST_RELATIVE);
2357 
2358 static inline BOOL ILIsEmpty(_In_opt_ PCUIDLIST_RELATIVE pidl)
2359 {
2360     return !(pidl && pidl->mkid.cb);
2361 }
2362 
2363 #include <poppack.h>
2364 
2365 
2366 /* menu merging */
2367 #define MM_ADDSEPARATOR         0x00000001L
2368 #define MM_SUBMENUSHAVEIDS      0x00000002L
2369 #define MM_DONTREMOVESEPS       0x00000004L
2370 
2371 UINT
2372 WINAPI
2373 Shell_MergeMenus(
2374   _In_ HMENU hmDst,
2375   _In_ HMENU hmSrc,
2376   UINT uInsert,
2377   UINT uIDAdjust,
2378   UINT uIDAdjustMax,
2379   ULONG uFlags);
2380 
2381 
2382 /****************************************************************************
2383  * SHCreateDefaultContextMenu API
2384  */
2385 
2386 typedef struct
2387 {
2388   HWND hwnd;
2389   IContextMenuCB *pcmcb;
2390   PCIDLIST_ABSOLUTE pidlFolder;
2391   IShellFolder *psf;
2392   UINT cidl;
2393   PCUITEMID_CHILD_ARRAY apidl;
2394   IUnknown *punkAssociationInfo;
2395   UINT cKeys;
2396   const HKEY *aKeys;
2397 }DEFCONTEXTMENU;
2398 
2399 HRESULT
2400 WINAPI
2401 SHCreateDefaultContextMenu(
2402   _In_ const DEFCONTEXTMENU *,
2403   _In_ REFIID,
2404   _Outptr_ void **ppv);
2405 
2406 typedef HRESULT
2407 (CALLBACK * LPFNDFMCALLBACK)(
2408   _In_opt_ IShellFolder*,
2409   _In_opt_ HWND,
2410   _In_opt_ IDataObject*,
2411   UINT,
2412   WPARAM,
2413   LPARAM);
2414 
2415 HRESULT
2416 WINAPI
2417 CDefFolderMenu_Create2(
2418   _In_opt_ PCIDLIST_ABSOLUTE,
2419   _In_opt_ HWND,
2420   UINT cidl,
2421   _In_reads_opt_(cidl) PCUITEMID_CHILD_ARRAY,
2422   _In_opt_ IShellFolder*,
2423   _In_opt_ LPFNDFMCALLBACK,
2424   UINT nKeys,
2425   _In_reads_opt_(nKeys) const HKEY *,
2426   _Outptr_ IContextMenu **);
2427 
2428 #define DFM_MERGECONTEXTMENU         1
2429 #define DFM_INVOKECOMMAND            2
2430 #define DFM_INVOKECOMMANDEX          12
2431 #define DFM_GETDEFSTATICID           14
2432 
2433 #define DFM_GETHELPTEXT              5
2434 #define DFM_WM_MEASUREITEM           6
2435 #define DFM_WM_DRAWITEM              7
2436 #define DFM_WM_INITMENUPOPUP         8
2437 #define DFM_VALIDATECMD              9
2438 #define DFM_MERGECONTEXTMENU_TOP    10
2439 #define DFM_GETHELPTEXTW            11
2440 #define DFM_MAPCOMMANDNAME          13
2441 #define DFM_GETVERBW                15
2442 #define DFM_GETVERBA                16
2443 #define DFM_MERGECONTEXTMENU_BOTTOM 17
2444 #define DFM_MODIFYQCMFLAGS          18
2445 
2446 
2447 #define DFM_CMD_DELETE          ((UINT)-1)
2448 #define DFM_CMD_MOVE            ((UINT)-2)
2449 #define DFM_CMD_COPY            ((UINT)-3)
2450 #define DFM_CMD_LINK            ((UINT)-4)
2451 #define DFM_CMD_PROPERTIES      ((UINT)-5)
2452 #define DFM_CMD_NEWFOLDER       ((UINT)-6)
2453 #define DFM_CMD_PASTE           ((UINT)-7)
2454 #define DFM_CMD_VIEWLIST        ((UINT)-8)
2455 #define DFM_CMD_VIEWDETAILS     ((UINT)-9)
2456 #define DFM_CMD_PASTELINK       ((UINT)-10)
2457 #define DFM_CMD_PASTESPECIAL    ((UINT)-11)
2458 #define DFM_CMD_MODALPROP       ((UINT)-12)
2459 #define DFM_CMD_RENAME          ((UINT)-13)
2460 
2461 /****************************************************************************
2462  * SHCreateDefaultExtractIcon API
2463  */
2464 
2465 HRESULT WINAPI
2466 SHCreateDefaultExtractIcon(
2467   REFIID riid,
2468   void **ppv);
2469 /****************************************************************************
2470  * SHCreateDataObject API
2471  */
2472 
2473 HRESULT WINAPI SHCreateDataObject(
2474   _In_opt_ PCIDLIST_ABSOLUTE pidlFolder,
2475   _In_ UINT cidl,
2476   _In_reads_opt_(cidl) PCUITEMID_CHILD_ARRAY apidl,
2477   _In_opt_ IDataObject *pdtInner,
2478   _In_ REFIID riid,
2479   _Outptr_ void **ppv);
2480 
2481 /****************************************************************************
2482  * CIDLData_CreateFromIDArray API
2483  */
2484 
2485 HRESULT WINAPI CIDLData_CreateFromIDArray(
2486   _In_ PCIDLIST_ABSOLUTE pidlFolder,
2487   _In_ UINT cidl,
2488   _In_reads_opt_(cidl) PCUIDLIST_RELATIVE_ARRAY apidl,
2489   _Outptr_ IDataObject **ppdtobj);
2490 
2491 /****************************************************************************
2492  * SHRunControlPanel
2493  */
2494 
2495 BOOL
2496 WINAPI
2497 SHRunControlPanel(
2498   _In_ LPCWSTR commandLine,
2499   _In_opt_ HWND parent);
2500 
2501 /****************************************************************************
2502  * SHGetAttributesFromDataObject
2503  */
2504 
2505 HRESULT
2506 WINAPI
2507 SHGetAttributesFromDataObject(
2508     _In_opt_ IDataObject* pdo,
2509     DWORD dwAttributeMask,
2510     _Out_opt_ DWORD* pdwAttributes,
2511     _Out_opt_ UINT* pcItems);
2512 
2513 /****************************************************************************
2514  * SHOpenWithDialog
2515  */
2516 
2517 enum tagOPEN_AS_INFO_FLAGS
2518 {
2519 	OAIF_ALLOW_REGISTRATION = 1,
2520 	OAIF_REGISTER_EXT       = 2,
2521 	OAIF_EXEC               = 4,
2522 	OAIF_FORCE_REGISTRATION = 8,
2523 #if (NTDDI_VERSION >= NTDDI_VISTA)
2524 	OAIF_HIDE_REGISTRATION  = 32,
2525 	OAIF_URL_PROTOCOL       = 64,
2526 #endif
2527 };
2528 typedef int OPEN_AS_INFO_FLAGS;
2529 
2530 
2531 typedef struct tagOPENASINFO {
2532 	LPCWSTR pcszFile;
2533 	LPCWSTR pcszClass;
2534 	OPEN_AS_INFO_FLAGS oaifInFlags;
2535 } OPENASINFO;
2536 
2537 HRESULT
2538 WINAPI
2539 SHOpenWithDialog(
2540   _In_opt_ HWND hwndParent,
2541   _In_ const OPENASINFO *poainfo);
2542 
2543 #define INTERFACE   IShellIconOverlayIdentifier
2544 
2545 DECLARE_INTERFACE_(IShellIconOverlayIdentifier, IUnknown)
2546 {
2547     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void **ppv) PURE;
2548     STDMETHOD_(ULONG,AddRef) (THIS)  PURE;
2549     STDMETHOD_(ULONG,Release) (THIS) PURE;
2550 
2551     STDMETHOD (IsMemberOf)(THIS_ _In_ LPCWSTR pwszPath, DWORD dwAttrib) PURE;
2552     STDMETHOD (GetOverlayInfo)(THIS_ _Out_writes_(cchMax) LPWSTR pwszIconFile, int cchMax, _Out_ int * pIndex, _Out_ DWORD * pdwFlags) PURE;
2553     STDMETHOD (GetPriority)(THIS_ _Out_ int * pIPriority) PURE;
2554 };
2555 
2556 #if !defined(__cplusplus) || defined(CINTERFACE)
2557 /*** IUnknown methods ***/
2558 #define IShellIconOverlayIdentifier_QueryInterface(p,a,b)         (p)->lpVtbl->QueryInterface(p,a,b)
2559 #define IShellIconOverlayIdentifier_AddRef(p)                     (p)->lpVtbl->AddRef(p)
2560 #define IShellIconOverlayIdentifier_Release(p)                    (p)->lpVtbl->Release(p)
2561 /*** IShellIconOverlayIdentifier methods ***/
2562 #define IShellIconOverlayIdentifier_IsMemberOf(p,a,b)             (p)->lpVtbl->IsMemberOf(p,a,b)
2563 #define IShellIconOverlayIdentifier_GetOverlayInfo(p,a,b,c,d)     (p)->lpVtbl->GetOverlayInfo(p,a,b,c,d)
2564 #define IShellIconOverlayIdentifier_GetPriority(p,a)              (p)->lpVtbl->GetPriority(p,a)
2565 #endif
2566 
2567 #define ISIOI_ICONFILE  0x00000001
2568 #define ISIOI_ICONINDEX 0x00000002
2569 
2570 #undef INTERFACE
2571 
2572 /****************************************************************************
2573  * Travel log
2574  */
2575 
2576 #define TLOG_BACK  -1
2577 #define TLOG_FORE   1
2578 
2579 #define TLMENUF_INCLUDECURRENT      0x00000001
2580 #define TLMENUF_CHECKCURRENT        (TLMENUF_INCLUDECURRENT | 0x00000002)
2581 #define TLMENUF_BACK                0x00000010  // Default
2582 #define TLMENUF_FORE                0x00000020
2583 #define TLMENUF_BACKANDFORTH        (TLMENUF_BACK | TLMENUF_FORE | TLMENUF_INCLUDECURRENT)
2584 
2585 /*****************************************************************************
2586  * IDockingWindowSite interface
2587  */
2588 #define INTERFACE IDockingWindowSite
2589 DECLARE_INTERFACE_(IDockingWindowSite, IOleWindow)
2590 {
2591     // *** IUnknown methods ***
2592     STDMETHOD(QueryInterface)(THIS_ REFIID riid, void **ppv) PURE;
2593     STDMETHOD_(ULONG,AddRef)(THIS) PURE;
2594     STDMETHOD_(ULONG,Release)(THIS) PURE;
2595 
2596     // *** IOleWindow methods ***
2597     STDMETHOD(GetWindow)(THIS_ HWND *lphwnd) PURE;
2598     STDMETHOD(ContextSensitiveHelp)(THIS_ BOOL fEnterMode) PURE;
2599 
2600     // *** IDockingWindowSite methods ***
2601     STDMETHOD(GetBorderDW)(THIS_ _In_ IUnknown *punkObj, _Out_ LPRECT prcBorder) PURE;
2602     STDMETHOD(RequestBorderSpaceDW)(THIS_ _In_ IUnknown *punkObj, _In_ LPCBORDERWIDTHS pbw) PURE;
2603     STDMETHOD(SetBorderSpaceDW)(THIS_ _In_ IUnknown *punkObj, _In_ LPCBORDERWIDTHS pbw) PURE;
2604 };
2605 #undef INTERFACE
2606 
2607 #if !defined(__cplusplus) || defined(CINTERFACE)
2608 /*** IUnknown methods ***/
2609 #define IDockingWindowSite_QueryInterface(p,a,b)         (p)->lpVtbl->QueryInterface(p,a,b)
2610 #define IDockingWindowSite_AddRef(p)                     (p)->lpVtbl->AddRef(p)
2611 #define IDockingWindowSite_Release(p)                    (p)->lpVtbl->Release(p)
2612 /*** IOleWindow methods ***/
2613 #define IDockingWindowSite_GetWindow(p,a)                (p)->lpVtbl->GetWindow(p,a)
2614 #define IDockingWindowSite_ContextSensitiveHelp(p,a)     (p)->lpVtbl->ContextSensitiveHelp(p,a)
2615 /*** IDockingWindowSite methods ***/
2616 #define IDockingWindowSite_GetBorderDW(p,a,b)            (p)->lpVtbl->GetBorderDW(p,a,b)
2617 #define IDockingWindowSite_RequestBorderSpaceDW(p,a,b)   (p)->lpVtbl->RequestBorderSpaceDW(p,a,b)
2618 #define IDockingWindowSite_SetBorderSpaceDW(p,a,b)       (p)->lpVtbl->SetBorderSpaceDW(p,a,b)
2619 #endif
2620 
2621 typedef void (CALLBACK *PFNASYNCICONTASKBALLBACK)(LPCITEMIDLIST pidl, LPVOID pvData, LPVOID pvHint, INT iIconIndex, INT iOpenIconIndex);
2622 
2623 #define ISFB_MASK_STATE       0x00000001
2624 #define ISFB_MASK_IDLIST      0x00000010
2625 
2626 #define ISFB_STATE_QLINKSMODE 0x00000020
2627 #define ISFB_STATE_NOSHOWTEXT 0x00000004
2628 
2629 #include <pshpack8.h>
2630 
2631 typedef struct {
2632     DWORD       dwMask;
2633     DWORD       dwStateMask;
2634     DWORD       dwState;
2635     COLORREF    crBkgnd;
2636     COLORREF    crBtnLt;
2637     COLORREF    crBtnDk;
2638     WORD        wViewMode;
2639     WORD        wAlign;
2640     IShellFolder * psf;
2641     PIDLIST_ABSOLUTE pidl;
2642 } BANDINFOSFB, *PBANDINFOSFB;
2643 
2644 #include <poppack.h>
2645 
2646 #undef INTERFACE
2647 #define INTERFACE IShellFolderBand
2648 
2649 DECLARE_INTERFACE_(IShellFolderBand, IUnknown)
2650 {
2651     // *** IUnknown methods ***
2652     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void **ppv) PURE;
2653     STDMETHOD_(ULONG,AddRef) (THIS)  PURE;
2654     STDMETHOD_(ULONG,Release) (THIS) PURE;
2655 
2656     // *** IShellFolderBand Methods ***
2657     STDMETHOD(InitializeSFB)(THIS_ IShellFolder *psf, PCIDLIST_ABSOLUTE pidl) PURE;
2658     STDMETHOD(SetBandInfoSFB)(THIS_ PBANDINFOSFB pbi) PURE;
2659     STDMETHOD(GetBandInfoSFB)(THIS_ PBANDINFOSFB pbi) PURE;
2660 };
2661 #undef INTERFACE
2662 
2663 #if (NTDDI_VERSION >= NTDDI_WIN2K) && (NTDDI_VERSION <= NTDDI_WINXPSP2)
2664 /*****************************************************************************
2665  * Control Panel functions
2666  */
2667 DECLARE_HANDLE(FARPROC16);
2668 LRESULT WINAPI CallCPLEntry16(HINSTANCE hMod, FARPROC16 pFunc, HWND dw3, UINT dw4, LPARAM dw5, LPARAM dw6);
2669 #endif
2670 
2671 #ifdef __cplusplus
2672 } /* extern "C" */
2673 #endif /* defined(__cplusplus) */
2674 
2675 #endif /* __WINE_SHLOBJ_H */
2676