msi: Only copy the resulting string if the RegistryValue call succeeded.
[wine] / dlls / shell32 / shell32_main.h
1 /*
2  *      internal Shell32 Library definitions
3  *
4  * Copyright 1998 Marcus Meissner
5  * Copyright 1998 Juergen Schmied (jsch)  *  <juergen.schmied@metronet.de>
6  *
7  * This library is free software; you can redistribute it and/or
8  * modify it under the terms of the GNU Lesser General Public
9  * License as published by the Free Software Foundation; either
10  * version 2.1 of the License, or (at your option) any later version.
11  *
12  * This library is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
15  * Lesser General Public License for more details.
16  *
17  * You should have received a copy of the GNU Lesser General Public
18  * License along with this library; if not, write to the Free Software
19  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
20  */
21
22 #ifndef __WINE_SHELL_MAIN_H
23 #define __WINE_SHELL_MAIN_H
24
25 #include <stdarg.h>
26
27 #include "windef.h"
28 #include "winbase.h"
29 #include "wingdi.h"
30 #include "winuser.h"
31 #include "winnls.h"
32 #include "commctrl.h"
33 #include "objbase.h"
34 #include "docobj.h"
35 #include "undocshell.h"
36 #include "shlobj.h"
37 #include "shellapi.h"
38 #include "wine/windef16.h"
39 #include "wine/unicode.h"
40
41 /*******************************************
42 *  global SHELL32.DLL variables
43 */
44 extern HMODULE  huser32;
45 extern HINSTANCE shell32_hInstance;
46 extern HIMAGELIST       ShellSmallIconList;
47 extern HIMAGELIST       ShellBigIconList;
48
49 BOOL WINAPI Shell_GetImageList(HIMAGELIST * lpBigList, HIMAGELIST * lpSmallList);
50
51 /* Iconcache */
52 #define INVALID_INDEX -1
53 BOOL SIC_Initialize(void);
54 void SIC_Destroy(void);
55 BOOL PidlToSicIndex (IShellFolder * sh, LPCITEMIDLIST pidl, BOOL bBigIcon, UINT uFlags, int * pIndex);
56 INT SIC_GetIconIndex (LPCWSTR sSourceFile, INT dwSourceIndex, DWORD dwFlags );
57
58 /* Classes Root */
59 BOOL HCR_MapTypeToValueW(LPCWSTR szExtension, LPWSTR szFileType, LONG len, BOOL bPrependDot);
60 BOOL HCR_GetDefaultVerbW( HKEY hkeyClass, LPCWSTR szVerb, LPWSTR szDest, DWORD len );
61 BOOL HCR_GetExecuteCommandW( HKEY hkeyClass, LPCWSTR szClass, LPCWSTR szVerb, LPWSTR szDest, DWORD len );
62 BOOL HCR_GetDefaultIconW(LPCWSTR szClass, LPWSTR szDest, DWORD len, int* picon_idx);
63 BOOL HCR_GetDefaultIconFromGUIDW(REFIID riid, LPWSTR szDest, DWORD len, int* picon_idx);
64 BOOL HCR_GetClassNameW(REFIID riid, LPWSTR szDest, DWORD len);
65
66 /* ANSI versions of above functions, supposed to go away as soon as they are not used anymore */
67 BOOL HCR_MapTypeToValueA(LPCSTR szExtension, LPSTR szFileType, LONG len, BOOL bPrependDot);
68 BOOL HCR_GetDefaultIconA(LPCSTR szClass, LPSTR szDest, DWORD len, int* picon_idx);
69 BOOL HCR_GetClassNameA(REFIID riid, LPSTR szDest, DWORD len);
70
71 BOOL HCR_GetFolderAttributes(LPCITEMIDLIST pidlFolder, LPDWORD dwAttributes);
72
73 INT_PTR CALLBACK AboutDlgProc(HWND,UINT,WPARAM,LPARAM);
74 DWORD WINAPI ParseFieldA(LPCSTR src, DWORD nField, LPSTR dst, DWORD len);
75 DWORD WINAPI ParseFieldW(LPCWSTR src, DWORD nField, LPWSTR dst, DWORD len);
76
77 /****************************************************************************
78  * Class constructors
79  */
80 LPDATAOBJECT    IDataObject_Constructor(HWND hwndOwner, LPCITEMIDLIST myPidl, LPCITEMIDLIST * apidl, UINT cidl);
81 LPENUMFORMATETC IEnumFORMATETC_Constructor(UINT, const FORMATETC []);
82
83 LPCLASSFACTORY  IClassFactory_Constructor(REFCLSID);
84 IContextMenu2 * ISvItemCm_Constructor(LPSHELLFOLDER pSFParent, LPCITEMIDLIST pidl, const LPCITEMIDLIST *aPidls, UINT uItemCount);
85 IContextMenu2 * ISvBgCm_Constructor(LPSHELLFOLDER pSFParent, BOOL bDesktop);
86 LPSHELLVIEW     IShellView_Constructor(LPSHELLFOLDER);
87
88 HRESULT WINAPI IFSFolder_Constructor(IUnknown * pUnkOuter, REFIID riid, LPVOID * ppv);
89 HRESULT WINAPI IShellLink_Constructor(IUnknown * pUnkOuter, REFIID riid, LPVOID * ppv);
90 HRESULT WINAPI IShellLink_ConstructFromFile(IUnknown * pUnkOuter, REFIID riid, LPCITEMIDLIST pidl, LPVOID * ppv);
91 HRESULT WINAPI ISF_Desktop_Constructor(IUnknown * pUnkOuter, REFIID riid, LPVOID * ppv);
92 HRESULT WINAPI ISF_MyComputer_Constructor(IUnknown * pUnkOuter, REFIID riid, LPVOID * ppv);
93 HRESULT WINAPI ISF_NetworkPlaces_Constructor(IUnknown * pUnkOuter, REFIID riid, LPVOID * ppv);
94 HRESULT WINAPI IDropTargetHelper_Constructor (IUnknown * pUnkOuter, REFIID riid, LPVOID * ppv);
95 HRESULT WINAPI IFileSystemBindData_Constructor(const WIN32_FIND_DATAW *pfd, LPBC *ppV);
96 HRESULT WINAPI IControlPanel_Constructor(IUnknown * pUnkOuter, REFIID riid, LPVOID * ppv);
97 HRESULT WINAPI UnixFolder_Constructor(IUnknown * pUnkOuter, REFIID riid, LPVOID * ppv);
98 HRESULT WINAPI UnixDosFolder_Constructor(IUnknown * pUnkOuter, REFIID riid, LPVOID *ppv);
99 HRESULT WINAPI FolderShortcut_Constructor(IUnknown * pUnkOuter, REFIID riid, LPVOID *ppv);
100 HRESULT WINAPI MyDocuments_Constructor(IUnknown * pUnkOuter, REFIID riid, LPVOID *ppv);
101 HRESULT WINAPI RecycleBin_Constructor(IUnknown * pUnkOuter, REFIID riif, LPVOID *ppv);
102 HRESULT WINAPI ShellFSFolder_Constructor(IUnknown * pUnkOuter, REFIID riid, LPVOID *ppv);
103 extern HRESULT CPanel_GetIconLocationW(LPCITEMIDLIST, LPWSTR, UINT, int*);
104 HRESULT WINAPI CPanel_ExtractIconA(LPITEMIDLIST pidl, LPCSTR pszFile, UINT nIconIndex, HICON *phiconLarge, HICON *phiconSmall, UINT nIconSize);
105 HRESULT WINAPI CPanel_ExtractIconW(LPITEMIDLIST pidl, LPCWSTR pszFile, UINT nIconIndex, HICON *phiconLarge, HICON *phiconSmall, UINT nIconSize);
106
107 HRESULT WINAPI IAutoComplete_Constructor(IUnknown * pUnkOuter, REFIID riid, LPVOID * ppv);
108
109 LPEXTRACTICONA  IExtractIconA_Constructor(LPCITEMIDLIST);
110 LPEXTRACTICONW  IExtractIconW_Constructor(LPCITEMIDLIST);
111
112 /* menu merging */
113 #define MM_ADDSEPARATOR         0x00000001L
114 #define MM_SUBMENUSHAVEIDS      0x00000002L
115 HRESULT WINAPI Shell_MergeMenus (HMENU hmDst, HMENU hmSrc, UINT uInsert, UINT uIDAdjust, UINT uIDAdjustMax, ULONG uFlags);
116
117 /* initialisation for FORMATETC */
118 #define InitFormatEtc(fe, cf, med) \
119         {\
120         (fe).cfFormat=cf;\
121         (fe).dwAspect=DVASPECT_CONTENT;\
122         (fe).ptd=NULL;\
123         (fe).tymed=med;\
124         (fe).lindex=-1;\
125         };
126
127 #define KeyStateToDropEffect(kst)\
128     ((((kst)&(MK_CONTROL|MK_SHIFT))==(MK_CONTROL|MK_SHIFT)) ? DROPEFFECT_LINK :\
129     (((kst)&(MK_CONTROL|MK_SHIFT)) ? DROPEFFECT_COPY :\
130     DROPEFFECT_MOVE))
131
132
133 HGLOBAL RenderHDROP(LPITEMIDLIST pidlRoot, LPITEMIDLIST * apidl, UINT cidl);
134 HGLOBAL RenderSHELLIDLIST (LPITEMIDLIST pidlRoot, LPITEMIDLIST * apidl, UINT cidl);
135 HGLOBAL RenderSHELLIDLISTOFFSET (LPITEMIDLIST pidlRoot, LPITEMIDLIST * apidl, UINT cidl);
136 HGLOBAL RenderFILECONTENTS (LPITEMIDLIST pidlRoot, LPITEMIDLIST * apidl, UINT cidl);
137 HGLOBAL RenderFILEDESCRIPTOR (LPITEMIDLIST pidlRoot, LPITEMIDLIST * apidl, UINT cidl);
138 HGLOBAL RenderFILENAMEA (LPITEMIDLIST pidlRoot, LPITEMIDLIST * apidl, UINT cidl);
139 HGLOBAL RenderFILENAMEW (LPITEMIDLIST pidlRoot, LPITEMIDLIST * apidl, UINT cidl);
140 HGLOBAL RenderPREFEREDDROPEFFECT (DWORD dwFlags);
141
142 /* Change Notification */
143 void InitChangeNotifications(void);
144 void FreeChangeNotifications(void);
145
146 /* file operation */
147 #define ASK_DELETE_FILE           1
148 #define ASK_DELETE_FOLDER         2
149 #define ASK_DELETE_MULTIPLE_ITEM  3
150 #define ASK_CREATE_FOLDER         4
151 #define ASK_OVERWRITE_FILE        5
152 #define ASK_DELETE_SELECTED       6
153 #define ASK_TRASH_FILE            7
154 #define ASK_TRASH_FOLDER          8
155 #define ASK_TRASH_MULTIPLE_ITEM   9
156 #define ASK_CANT_TRASH_ITEM      10
157 #define ASK_OVERWRITE_FOLDER     11
158
159 BOOL SHELL_DeleteDirectoryW(HWND hwnd, LPCWSTR pwszDir, BOOL bShowUI);
160 BOOL SHELL_ConfirmYesNoW(HWND hWnd, int nKindOfDialog, LPCWSTR szDir);
161
162 /* 16-bit functions */
163 void        WINAPI DragAcceptFiles16(HWND16 hWnd, BOOL16 b);
164 UINT16      WINAPI DragQueryFile16(HDROP16 hDrop, WORD wFile, LPSTR lpszFile, WORD wLength);
165 void        WINAPI DragFinish16(HDROP16 h);
166 BOOL16      WINAPI DragQueryPoint16(HDROP16 hDrop, POINT16 *p);
167 HINSTANCE16 WINAPI ShellExecute16(HWND16,LPCSTR,LPCSTR,LPCSTR,LPCSTR,INT16);
168 HICON16     WINAPI ExtractIcon16(HINSTANCE16,LPCSTR,UINT16);
169 HICON16     WINAPI ExtractAssociatedIcon16(HINSTANCE16,LPSTR,LPWORD);
170 HICON16     WINAPI ExtractIconEx16 ( LPCSTR, INT16, HICON16 *, HICON16 *, UINT16 );
171 HINSTANCE16 WINAPI FindExecutable16(LPCSTR,LPCSTR,LPSTR);
172 HGLOBAL16   WINAPI InternalExtractIcon16(HINSTANCE16,LPCSTR,UINT16,WORD);
173 BOOL16      WINAPI ShellAbout16(HWND16,LPCSTR,LPCSTR,HICON16);
174 BOOL16      WINAPI AboutDlgProc16(HWND16,UINT16,WPARAM16,LPARAM);
175
176 static inline BOOL SHELL_OsIsUnicode(void)
177 {
178     /* if high-bit of version is 0, we are emulating NT */
179     return !(GetVersion() & 0x80000000);
180 }
181
182 #define __SHFreeAndNil(ptr) \
183         {\
184           SHFree(*ptr); \
185           *ptr = NULL; \
186         };
187 static inline void __SHCloneStrA(char ** target,const char * source)
188 {
189         *target = SHAlloc(strlen(source)+1);
190         strcpy(*target, source);
191 }
192
193 static inline void __SHCloneStrWtoA(char ** target, const WCHAR * source)
194 {
195         int len = WideCharToMultiByte(CP_ACP, 0, source, -1, NULL, 0, NULL, NULL);
196         *target = SHAlloc(len);
197         WideCharToMultiByte(CP_ACP, 0, source, -1, *target, len, NULL, NULL);
198 }
199
200 static inline void __SHCloneStrW(WCHAR ** target, const WCHAR * source)
201 {
202         *target = SHAlloc( (lstrlenW(source)+1) * sizeof(WCHAR) );
203         lstrcpyW(*target, source);
204 }
205
206 static inline WCHAR * __SHCloneStrAtoW(WCHAR ** target, const char * source)
207 {
208         int len = MultiByteToWideChar(CP_ACP, 0, source, -1, NULL, 0);
209         *target = SHAlloc(len*sizeof(WCHAR));
210         MultiByteToWideChar(CP_ACP, 0, source, -1, *target, len);
211         return *target;
212 }
213
214 /* handle conversions */
215 #define HICON_16(h32)           (LOWORD(h32))
216 #define HICON_32(h16)           ((HICON)(ULONG_PTR)(h16))
217 #define HINSTANCE_32(h16)       ((HINSTANCE)(ULONG_PTR)(h16))
218 #define HINSTANCE_16(h32)       (LOWORD(h32))
219
220 typedef UINT_PTR (*SHELL_ExecuteW32)(const WCHAR *lpCmd, WCHAR *env, BOOL shWait,
221                             const SHELLEXECUTEINFOW *sei, LPSHELLEXECUTEINFOW sei_out);
222
223 BOOL SHELL_execute(LPSHELLEXECUTEINFOW sei, SHELL_ExecuteW32 execfunc);
224
225 UINT SHELL_FindExecutable(LPCWSTR lpPath, LPCWSTR lpFile, LPCWSTR lpOperation,
226                           LPWSTR lpResult, int resultLen, LPWSTR key, WCHAR **env, LPITEMIDLIST pidl, LPCWSTR args);
227
228 extern WCHAR swShell32Name[MAX_PATH];
229
230 BOOL UNIXFS_is_rooted_at_desktop(void);
231 extern const GUID CLSID_UnixFolder;
232 extern const GUID CLSID_UnixDosFolder;
233
234 /* Default shell folder value registration */
235 HRESULT SHELL_RegisterShellFolders(void);
236
237 /* Detect Shell Links */
238 BOOL SHELL_IsShortcut(LPCITEMIDLIST);
239
240 #endif