2 * Implementation of the Microsoft Installer (msi.dll)
4 * Copyright 2005 Aric Stewart for CodeWeavers
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
23 http://msdn.microsoft.com/library/default.asp?url=/library/en-us/msi/setup/controlevent_overview.asp
36 #include "wine/debug.h"
37 #include "wine/unicode.h"
39 WINE_DEFAULT_DEBUG_CHANNEL(msi);
41 typedef UINT (*EVENTHANDLER)(MSIPACKAGE*,LPCWSTR,msi_dialog *);
56 static UINT ControlEvent_HandleControlEvent(MSIPACKAGE *, LPCWSTR, LPCWSTR, msi_dialog*);
59 * Create a dialog box and run it if it's modal
61 static UINT event_do_dialog( MSIPACKAGE *package, LPCWSTR name, msi_dialog *parent, BOOL destroy_modeless )
66 /* create a new dialog */
67 dialog = msi_dialog_create( package, name, parent,
68 ControlEvent_HandleControlEvent );
71 /* kill the current modeless dialog */
72 if( destroy_modeless && package->dialog )
74 msi_dialog_destroy( package->dialog );
75 package->dialog = NULL;
78 /* modeless dialogs return an error message */
79 r = msi_dialog_run_message_loop( dialog );
80 if( r == ERROR_SUCCESS )
81 msi_dialog_destroy( dialog );
83 package->dialog = dialog;
86 r = ERROR_FUNCTION_FAILED;
93 * End a modal dialog box
95 static UINT ControlEvent_EndDialog(MSIPACKAGE* package, LPCWSTR argument,
98 static const WCHAR szExit[] = {
100 static const WCHAR szRetry[] = {
101 'R','e','t','r','y',0};
102 static const WCHAR szIgnore[] = {
103 'I','g','n','o','r','e',0};
104 static const WCHAR szReturn[] = {
105 'R','e','t','u','r','n',0};
107 if (lstrcmpW(argument,szExit)==0)
108 package->CurrentInstallState = ERROR_INSTALL_USEREXIT;
109 else if (lstrcmpW(argument, szRetry) == 0)
110 package->CurrentInstallState = ERROR_INSTALL_SUSPEND;
111 else if (lstrcmpW(argument, szIgnore) == 0)
112 package->CurrentInstallState = -1;
113 else if (lstrcmpW(argument, szReturn) == 0)
115 msi_dialog *parent = msi_dialog_get_parent(dialog);
116 msi_free(package->next_dialog);
117 package->next_dialog = (parent) ? strdupW(msi_dialog_get_name(parent)) : NULL;
118 package->CurrentInstallState = ERROR_SUCCESS;
122 ERR("Unknown argument string %s\n",debugstr_w(argument));
123 package->CurrentInstallState = ERROR_FUNCTION_FAILED;
126 ControlEvent_CleanupDialogSubscriptions(package, msi_dialog_get_name( dialog ));
127 msi_dialog_end_dialog( dialog );
128 return ERROR_SUCCESS;
132 * transition from one modal dialog to another modal dialog
134 static UINT ControlEvent_NewDialog(MSIPACKAGE* package, LPCWSTR argument,
137 /* store the name of the next dialog, and signal this one to end */
138 package->next_dialog = strdupW(argument);
139 ControlEvent_CleanupSubscriptions(package);
140 msi_dialog_end_dialog( dialog );
141 return ERROR_SUCCESS;
145 * Create a new child dialog of an existing modal dialog
147 static UINT ControlEvent_SpawnDialog(MSIPACKAGE* package, LPCWSTR argument,
150 /* don't destroy a modeless dialogs that might be our parent */
151 event_do_dialog( package, argument, dialog, FALSE );
152 if( package->CurrentInstallState != ERROR_SUCCESS )
153 msi_dialog_end_dialog( dialog );
154 return ERROR_SUCCESS;
158 * Creates a dialog that remains up for a period of time
159 * based on a condition
161 static UINT ControlEvent_SpawnWaitDialog(MSIPACKAGE* package, LPCWSTR argument,
164 FIXME("Doing Nothing\n");
165 return ERROR_SUCCESS;
168 static UINT ControlEvent_DoAction(MSIPACKAGE* package, LPCWSTR argument,
171 ACTION_PerformAction(package,argument,-1,TRUE);
172 return ERROR_SUCCESS;
175 static UINT ControlEvent_AddLocal(MSIPACKAGE* package, LPCWSTR argument,
178 static const WCHAR szAll[] = {'A','L','L',0};
179 MSIFEATURE *feature = NULL;
181 if (lstrcmpW(szAll,argument))
183 MSI_SetFeatureStateW(package,argument,INSTALLSTATE_LOCAL);
187 LIST_FOR_EACH_ENTRY( feature, &package->features, MSIFEATURE, entry )
188 msi_feature_set_state( feature, INSTALLSTATE_LOCAL );
190 ACTION_UpdateComponentStates(package,argument);
192 return ERROR_SUCCESS;
195 static UINT ControlEvent_Remove(MSIPACKAGE* package, LPCWSTR argument,
198 static const WCHAR szAll[] = {'A','L','L',0};
199 MSIFEATURE *feature = NULL;
201 if (lstrcmpW(szAll,argument))
203 MSI_SetFeatureStateW(package,argument,INSTALLSTATE_ABSENT);
207 LIST_FOR_EACH_ENTRY( feature, &package->features, MSIFEATURE, entry )
208 msi_feature_set_state( feature, INSTALLSTATE_ABSENT );
210 ACTION_UpdateComponentStates(package,argument);
212 return ERROR_SUCCESS;
215 static UINT ControlEvent_AddSource(MSIPACKAGE* package, LPCWSTR argument,
218 static const WCHAR szAll[] = {'A','L','L',0};
219 MSIFEATURE *feature = NULL;
221 if (lstrcmpW(szAll,argument))
223 MSI_SetFeatureStateW(package,argument,INSTALLSTATE_SOURCE);
227 LIST_FOR_EACH_ENTRY( feature, &package->features, MSIFEATURE, entry )
228 msi_feature_set_state( feature, INSTALLSTATE_SOURCE );
229 ACTION_UpdateComponentStates(package,argument);
231 return ERROR_SUCCESS;
234 static UINT ControlEvent_SetTargetPath(MSIPACKAGE* package, LPCWSTR argument,
237 LPWSTR path = msi_dup_property( package, argument );
238 MSIRECORD *rec = MSI_CreateRecord( 1 );
241 static const WCHAR szSelectionPath[] = {'S','e','l','e','c','t','i','o','n','P','a','t','h',0};
243 MSI_RecordSetStringW( rec, 1, path );
244 ControlEvent_FireSubscribedEvent( package, szSelectionPath, rec );
246 /* failure to set the path halts the executing of control events */
247 r = MSI_SetTargetPathW(package, argument, path);
253 static UINT ControlEvent_Reset(MSIPACKAGE* package, LPCWSTR argument,
256 msi_dialog_reset(dialog);
257 return ERROR_SUCCESS;
263 static void free_subscriber( struct subscriber *sub )
265 msi_free(sub->event);
266 msi_free(sub->control);
267 msi_free(sub->attribute);
271 VOID ControlEvent_SubscribeToEvent( MSIPACKAGE *package, msi_dialog *dialog,
272 LPCWSTR event, LPCWSTR control, LPCWSTR attribute )
274 struct subscriber *sub;
276 sub = msi_alloc(sizeof (*sub));
279 sub->dialog = dialog;
280 sub->event = strdupW(event);
281 sub->control = strdupW(control);
282 sub->attribute = strdupW(attribute);
283 list_add_tail( &package->subscriptions, &sub->entry );
286 VOID ControlEvent_UnSubscribeToEvent( MSIPACKAGE *package, LPCWSTR event,
287 LPCWSTR control, LPCWSTR attribute )
290 struct subscriber *sub;
292 LIST_FOR_EACH_SAFE( i, t, &package->subscriptions )
294 sub = LIST_ENTRY( i, struct subscriber, entry );
296 if( lstrcmpiW(sub->control,control) )
298 if( lstrcmpiW(sub->attribute,attribute) )
300 if( lstrcmpiW(sub->event,event) )
302 list_remove( &sub->entry );
303 free_subscriber( sub );
307 VOID ControlEvent_FireSubscribedEvent( MSIPACKAGE *package, LPCWSTR event,
310 struct subscriber *sub;
312 TRACE("Firing Event %s\n",debugstr_w(event));
314 LIST_FOR_EACH_ENTRY( sub, &package->subscriptions, struct subscriber, entry )
316 if (lstrcmpiW(sub->event, event))
318 msi_dialog_handle_event( sub->dialog, sub->control,
319 sub->attribute, rec );
323 VOID ControlEvent_CleanupDialogSubscriptions(MSIPACKAGE *package, LPWSTR dialog)
326 struct subscriber *sub;
328 LIST_FOR_EACH_SAFE( i, t, &package->subscriptions )
330 sub = LIST_ENTRY( i, struct subscriber, entry );
332 if ( lstrcmpW( msi_dialog_get_name( sub->dialog ), dialog ))
335 list_remove( &sub->entry );
336 free_subscriber( sub );
340 VOID ControlEvent_CleanupSubscriptions(MSIPACKAGE *package)
343 struct subscriber *sub;
345 LIST_FOR_EACH_SAFE( i, t, &package->subscriptions )
347 sub = LIST_ENTRY( i, struct subscriber, entry );
349 list_remove( &sub->entry );
350 free_subscriber( sub );
357 * Return ERROR_SUCCESS if dialog is process and ERROR_FUNCTION_FAILED
358 * if the given parameter is not a dialog box
360 UINT ACTION_DialogBox( MSIPACKAGE* package, LPCWSTR szDialogName )
362 UINT r = ERROR_SUCCESS;
364 if( package->next_dialog )
365 ERR("Already a next dialog... ignoring it\n");
366 package->next_dialog = NULL;
369 * Dialogs are chained by filling in the next_dialog member
370 * of the package structure, then terminating the current dialog.
371 * The code below sees the next_dialog member set, and runs the
373 * We fall out of the loop below if we come across a modeless
374 * dialog, as it returns ERROR_IO_PENDING when we try to run
377 r = event_do_dialog( package, szDialogName, NULL, TRUE );
378 while( r == ERROR_SUCCESS && package->next_dialog )
380 LPWSTR name = package->next_dialog;
382 package->next_dialog = NULL;
383 r = event_do_dialog( package, name, NULL, TRUE );
387 if( r == ERROR_IO_PENDING )
393 static UINT ControlEvent_SetInstallLevel(MSIPACKAGE* package, LPCWSTR argument,
396 int iInstallLevel = atolW(argument);
398 TRACE("Setting install level: %i\n", iInstallLevel);
400 return MSI_SetInstallLevel( package, iInstallLevel );
403 static UINT ControlEvent_DirectoryListUp(MSIPACKAGE *package, LPCWSTR argument,
406 return msi_dialog_directorylist_up( dialog );
409 static UINT ControlEvent_ReinstallMode(MSIPACKAGE *package, LPCWSTR argument,
412 static const WCHAR szReinstallMode[] = {'R','E','I','N','S','T','A','L','L','M','O','D','E',0};
413 return MSI_SetPropertyW( package, szReinstallMode, argument );
416 static const struct _events Events[] = {
417 { "EndDialog",ControlEvent_EndDialog },
418 { "NewDialog",ControlEvent_NewDialog },
419 { "SpawnDialog",ControlEvent_SpawnDialog },
420 { "SpawnWaitDialog",ControlEvent_SpawnWaitDialog },
421 { "DoAction",ControlEvent_DoAction },
422 { "AddLocal",ControlEvent_AddLocal },
423 { "Remove",ControlEvent_Remove },
424 { "AddSource",ControlEvent_AddSource },
425 { "SetTargetPath",ControlEvent_SetTargetPath },
426 { "Reset",ControlEvent_Reset },
427 { "SetInstallLevel",ControlEvent_SetInstallLevel },
428 { "DirectoryListUp",ControlEvent_DirectoryListUp },
429 { "SelectionBrowse",ControlEvent_SpawnDialog },
430 { "ReinstallMode",ControlEvent_ReinstallMode },
434 UINT ControlEvent_HandleControlEvent(MSIPACKAGE *package, LPCWSTR event,
435 LPCWSTR argument, msi_dialog* dialog)
438 UINT rc = ERROR_SUCCESS;
440 TRACE("Handling Control Event %s\n",debugstr_w(event));
444 while( Events[i].event != NULL)
446 LPWSTR wevent = strdupAtoW(Events[i].event);
447 if (lstrcmpW(wevent,event)==0)
450 rc = Events[i].handler(package,argument,dialog);
456 FIXME("unhandled control event %s arg(%s)\n",
457 debugstr_w(event), debugstr_w(argument));