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
21 /* Msi top level apis directly related to installs */
28 #include "wine/debug.h"
33 #include "wine/unicode.h"
36 WINE_DEFAULT_DEBUG_CHANNEL(msi);
38 /***********************************************************************
39 * MsiDoActionA (MSI.@)
41 UINT WINAPI MsiDoActionA( MSIHANDLE hInstall, LPCSTR szAction )
46 TRACE("%s\n", debugstr_a(szAction));
48 szwAction = strdupAtoW(szAction);
49 if (szAction && !szwAction)
50 return ERROR_FUNCTION_FAILED;
52 ret = MsiDoActionW( hInstall, szwAction );
53 msi_free( szwAction );
57 /***********************************************************************
58 * MsiDoActionW (MSI.@)
60 UINT WINAPI MsiDoActionW( MSIHANDLE hInstall, LPCWSTR szAction )
65 TRACE("%s\n",debugstr_w(szAction));
68 return ERROR_INVALID_PARAMETER;
70 package = msihandle2msiinfo( hInstall, MSIHANDLETYPE_PACKAGE );
72 return ERROR_INVALID_HANDLE;
74 ret = ACTION_PerformUIAction( package, szAction );
75 msiobj_release( &package->hdr );
80 /***********************************************************************
81 * MsiSequenceA (MSI.@)
83 UINT WINAPI MsiSequenceA( MSIHANDLE hInstall, LPCSTR szTable, INT iSequenceMode )
88 TRACE("%s\n", debugstr_a(szTable));
90 szwTable = strdupAtoW(szTable);
91 if (szTable && !szwTable)
92 return ERROR_FUNCTION_FAILED;
94 ret = MsiSequenceW( hInstall, szwTable, iSequenceMode );
99 /***********************************************************************
100 * MsiSequenceW (MSI.@)
102 UINT WINAPI MsiSequenceW( MSIHANDLE hInstall, LPCWSTR szTable, INT iSequenceMode )
107 TRACE("%s\n", debugstr_w(szTable));
109 package = msihandle2msiinfo( hInstall, MSIHANDLETYPE_PACKAGE );
111 return ERROR_INVALID_HANDLE;
113 ret = MSI_Sequence( package, szTable, iSequenceMode );
114 msiobj_release( &package->hdr );
119 UINT msi_strcpy_to_awstring( LPCWSTR str, awstring *awbuf, DWORD *sz )
121 UINT len, r = ERROR_SUCCESS;
123 if (awbuf->str.w && !sz )
124 return ERROR_INVALID_PARAMETER;
131 len = lstrlenW( str );
133 lstrcpynW( awbuf->str.w, str, *sz );
137 len = WideCharToMultiByte( CP_ACP, 0, str, -1, NULL, 0, NULL, NULL );
140 WideCharToMultiByte( CP_ACP, 0, str, -1, awbuf->str.a, *sz, NULL, NULL );
141 if ( *sz && (len >= *sz) )
142 awbuf->str.a[*sz - 1] = 0;
145 if (awbuf->str.w && len >= *sz)
151 /***********************************************************************
152 * MsiGetTargetPath (internal)
154 UINT WINAPI MSI_GetTargetPath( MSIHANDLE hInstall, LPCWSTR szFolder,
155 awstring *szPathBuf, DWORD* pcchPathBuf )
162 return ERROR_INVALID_PARAMETER;
164 package = msihandle2msiinfo( hInstall, MSIHANDLETYPE_PACKAGE );
166 return ERROR_INVALID_HANDLE;
168 path = resolve_folder( package, szFolder, FALSE, FALSE, NULL );
169 msiobj_release( &package->hdr );
172 return ERROR_DIRECTORY;
174 r = msi_strcpy_to_awstring( path, szPathBuf, pcchPathBuf );
179 /***********************************************************************
180 * MsiGetTargetPathA (MSI.@)
182 UINT WINAPI MsiGetTargetPathA( MSIHANDLE hInstall, LPCSTR szFolder,
183 LPSTR szPathBuf, DWORD* pcchPathBuf )
189 TRACE("%s %p %p\n", debugstr_a(szFolder), szPathBuf, pcchPathBuf);
191 szwFolder = strdupAtoW(szFolder);
192 if (szFolder && !szwFolder)
193 return ERROR_FUNCTION_FAILED;
195 path.unicode = FALSE;
196 path.str.a = szPathBuf;
198 r = MSI_GetTargetPath( hInstall, szwFolder, &path, pcchPathBuf );
200 msi_free( szwFolder );
205 /***********************************************************************
206 * MsiGetTargetPathW (MSI.@)
208 UINT WINAPI MsiGetTargetPathW( MSIHANDLE hInstall, LPCWSTR szFolder,
209 LPWSTR szPathBuf, DWORD* pcchPathBuf )
213 TRACE("%s %p %p\n", debugstr_w(szFolder), szPathBuf, pcchPathBuf);
216 path.str.w = szPathBuf;
218 return MSI_GetTargetPath( hInstall, szFolder, &path, pcchPathBuf );
221 /***********************************************************************
222 * MsiGetSourcePath (internal)
224 static UINT MSI_GetSourcePath( MSIHANDLE hInstall, LPCWSTR szFolder,
225 awstring *szPathBuf, DWORD* pcchPathBuf )
231 TRACE("%s %p %p\n", debugstr_w(szFolder), szPathBuf, pcchPathBuf );
234 return ERROR_INVALID_PARAMETER;
236 package = msihandle2msiinfo(hInstall, MSIHANDLETYPE_PACKAGE);
238 return ERROR_INVALID_HANDLE;
240 if (szPathBuf->str.w && !pcchPathBuf )
242 msiobj_release( &package->hdr );
243 return ERROR_INVALID_PARAMETER;
246 path = resolve_folder(package, szFolder, TRUE, FALSE, NULL);
247 msiobj_release( &package->hdr );
249 TRACE("path = %s\n",debugstr_w(path));
251 return ERROR_DIRECTORY;
253 r = msi_strcpy_to_awstring( path, szPathBuf, pcchPathBuf );
258 /***********************************************************************
259 * MsiGetSourcePathA (MSI.@)
261 UINT WINAPI MsiGetSourcePathA( MSIHANDLE hInstall, LPCSTR szFolder,
262 LPSTR szPathBuf, DWORD* pcchPathBuf )
268 TRACE("%s %p %p\n", szFolder, debugstr_a(szPathBuf), pcchPathBuf);
271 str.str.a = szPathBuf;
273 folder = strdupAtoW( szFolder );
274 r = MSI_GetSourcePath( hInstall, folder, &str, pcchPathBuf );
280 /***********************************************************************
281 * MsiGetSourcePathW (MSI.@)
283 UINT WINAPI MsiGetSourcePathW( MSIHANDLE hInstall, LPCWSTR szFolder,
284 LPWSTR szPathBuf, DWORD* pcchPathBuf )
288 TRACE("%s %p %p\n", debugstr_w(szFolder), szPathBuf, pcchPathBuf );
291 str.str.w = szPathBuf;
293 return MSI_GetSourcePath( hInstall, szFolder, &str, pcchPathBuf );
296 /***********************************************************************
297 * MsiSetTargetPathA (MSI.@)
299 UINT WINAPI MsiSetTargetPathA( MSIHANDLE hInstall, LPCSTR szFolder,
300 LPCSTR szFolderPath )
302 LPWSTR szwFolder = NULL, szwFolderPath = NULL;
303 UINT rc = ERROR_OUTOFMEMORY;
305 if ( !szFolder || !szFolderPath )
306 return ERROR_INVALID_PARAMETER;
308 szwFolder = strdupAtoW(szFolder);
309 szwFolderPath = strdupAtoW(szFolderPath);
310 if (!szwFolder || !szwFolderPath)
313 rc = MsiSetTargetPathW( hInstall, szwFolder, szwFolderPath );
317 msi_free(szwFolderPath);
323 * Ok my original interpretation of this was wrong. And it looks like msdn has
324 * changed a bit also. The given folder path does not have to actually already
325 * exist, it just cannot be read only and must be a legal folder path.
327 UINT MSI_SetTargetPathW(MSIPACKAGE *package, LPCWSTR szFolder,
328 LPCWSTR szFolderPath)
335 TRACE("(%p %s %s)\n",package, debugstr_w(szFolder),debugstr_w(szFolderPath));
337 attrib = GetFileAttributesW(szFolderPath);
338 if ( attrib != INVALID_FILE_ATTRIBUTES &&
339 (attrib & FILE_ATTRIBUTE_OFFLINE ||
340 attrib & FILE_ATTRIBUTE_READONLY)) /* actually native MSI tests writeability by making temporary files at each drive */
341 return ERROR_FUNCTION_FAILED;
343 path = resolve_folder(package,szFolder,FALSE,FALSE,&folder);
345 return ERROR_DIRECTORY;
348 msi_free(folder->Property);
349 folder->Property = build_directory_name(2, szFolderPath, NULL);
351 if (lstrcmpiW(path, folder->Property) == 0)
354 * Resolved Target has not really changed, so just
355 * set this folder and do not recalculate everything.
357 msi_free(folder->ResolvedTarget);
358 folder->ResolvedTarget = NULL;
359 path2 = resolve_folder(package,szFolder,FALSE,TRUE,NULL);
366 LIST_FOR_EACH_ENTRY( f, &package->folders, MSIFOLDER, entry )
368 msi_free(f->ResolvedTarget);
369 f->ResolvedTarget=NULL;
372 LIST_FOR_EACH_ENTRY( f, &package->folders, MSIFOLDER, entry )
374 path2 = resolve_folder(package, f->Directory, FALSE, TRUE, NULL);
380 return ERROR_SUCCESS;
383 /***********************************************************************
384 * MsiSetTargetPathW (MSI.@)
386 UINT WINAPI MsiSetTargetPathW(MSIHANDLE hInstall, LPCWSTR szFolder,
387 LPCWSTR szFolderPath)
392 TRACE("(%s %s)\n",debugstr_w(szFolder),debugstr_w(szFolderPath));
394 if ( !szFolder || !szFolderPath )
395 return ERROR_INVALID_PARAMETER;
397 package = msihandle2msiinfo(hInstall, MSIHANDLETYPE_PACKAGE);
399 return ERROR_INVALID_HANDLE;
401 ret = MSI_SetTargetPathW( package, szFolder, szFolderPath );
402 msiobj_release( &package->hdr );
406 /***********************************************************************
409 * Returns an internal installer state (if it is running in a mode iRunMode)
412 * hInstall [I] Handle to the installation
413 * hRunMode [I] Checking run mode
414 * MSIRUNMODE_ADMIN Administrative mode
415 * MSIRUNMODE_ADVERTISE Advertisement mode
416 * MSIRUNMODE_MAINTENANCE Maintenance mode
417 * MSIRUNMODE_ROLLBACKENABLED Rollback is enabled
418 * MSIRUNMODE_LOGENABLED Log file is writing
419 * MSIRUNMODE_OPERATIONS Operations in progress??
420 * MSIRUNMODE_REBOOTATEND We need to reboot after installation completed
421 * MSIRUNMODE_REBOOTNOW We need to reboot to continue the installation
422 * MSIRUNMODE_CABINET Files from cabinet are installed
423 * MSIRUNMODE_SOURCESHORTNAMES Long names in source files is suppressed
424 * MSIRUNMODE_TARGETSHORTNAMES Long names in destination files is suppressed
425 * MSIRUNMODE_RESERVED11 Reserved
426 * MSIRUNMODE_WINDOWS9X Running under Windows95/98
427 * MSIRUNMODE_ZAWENABLED Demand installation is supported
428 * MSIRUNMODE_RESERVED14 Reserved
429 * MSIRUNMODE_RESERVED15 Reserved
430 * MSIRUNMODE_SCHEDULED called from install script
431 * MSIRUNMODE_ROLLBACK called from rollback script
432 * MSIRUNMODE_COMMIT called from commit script
436 * Not in the state: FALSE
440 BOOL WINAPI MsiGetMode(MSIHANDLE hInstall, MSIRUNMODE iRunMode)
446 case MSIRUNMODE_WINDOWS9X:
447 if (GetVersion() & 0x80000000)
451 case MSIRUNMODE_RESERVED11:
452 case MSIRUNMODE_RESERVED14:
453 case MSIRUNMODE_RESERVED15:
456 case MSIRUNMODE_SCHEDULED:
457 case MSIRUNMODE_ROLLBACK:
458 case MSIRUNMODE_COMMIT:
462 FIXME("%ld %d\n", hInstall, iRunMode);
469 /***********************************************************************
472 BOOL WINAPI MsiSetMode(MSIHANDLE hInstall, MSIRUNMODE iRunMode, BOOL fState)
476 case MSIRUNMODE_RESERVED11:
477 case MSIRUNMODE_WINDOWS9X:
478 case MSIRUNMODE_RESERVED14:
479 case MSIRUNMODE_RESERVED15:
482 FIXME("%ld %d %d\n", hInstall, iRunMode, fState);
487 /***********************************************************************
488 * MsiSetFeatureStateA (MSI.@)
490 * According to the docs, when this is called it immediately recalculates
491 * all the component states as well
493 UINT WINAPI MsiSetFeatureStateA(MSIHANDLE hInstall, LPCSTR szFeature,
496 LPWSTR szwFeature = NULL;
499 szwFeature = strdupAtoW(szFeature);
502 return ERROR_FUNCTION_FAILED;
504 rc = MsiSetFeatureStateW(hInstall,szwFeature, iState);
506 msi_free(szwFeature);
513 UINT WINAPI MSI_SetFeatureStateW(MSIPACKAGE* package, LPCWSTR szFeature,
516 UINT rc = ERROR_SUCCESS;
517 MSIFEATURE *feature, *child;
519 TRACE(" %s to %i\n",debugstr_w(szFeature), iState);
521 feature = get_loaded_feature(package,szFeature);
523 return ERROR_UNKNOWN_FEATURE;
525 if (iState == INSTALLSTATE_ADVERTISED &&
526 feature->Attributes & msidbFeatureAttributesDisallowAdvertise)
527 return ERROR_FUNCTION_FAILED;
529 feature->ActionRequest = iState;
530 feature->Action = iState;
532 ACTION_UpdateComponentStates(package,szFeature);
534 /* update all the features that are children of this feature */
535 LIST_FOR_EACH_ENTRY( child, &package->features, MSIFEATURE, entry )
537 if (lstrcmpW(szFeature, child->Feature_Parent) == 0)
538 MSI_SetFeatureStateW(package, child->Feature, iState);
544 /***********************************************************************
545 * MsiSetFeatureStateW (MSI.@)
547 UINT WINAPI MsiSetFeatureStateW(MSIHANDLE hInstall, LPCWSTR szFeature,
551 UINT rc = ERROR_SUCCESS;
553 TRACE(" %s to %i\n",debugstr_w(szFeature), iState);
555 package = msihandle2msiinfo(hInstall, MSIHANDLETYPE_PACKAGE);
557 return ERROR_INVALID_HANDLE;
559 rc = MSI_SetFeatureStateW(package,szFeature,iState);
561 msiobj_release( &package->hdr );
565 /***********************************************************************
566 * MsiGetFeatureStateA (MSI.@)
568 UINT WINAPI MsiGetFeatureStateA(MSIHANDLE hInstall, LPSTR szFeature,
569 INSTALLSTATE *piInstalled, INSTALLSTATE *piAction)
571 LPWSTR szwFeature = NULL;
574 szwFeature = strdupAtoW(szFeature);
576 rc = MsiGetFeatureStateW(hInstall,szwFeature,piInstalled, piAction);
578 msi_free( szwFeature);
583 UINT MSI_GetFeatureStateW(MSIPACKAGE *package, LPWSTR szFeature,
584 INSTALLSTATE *piInstalled, INSTALLSTATE *piAction)
588 feature = get_loaded_feature(package,szFeature);
590 return ERROR_UNKNOWN_FEATURE;
593 *piInstalled = feature->Installed;
596 *piAction = feature->Action;
598 TRACE("returning %i %i\n", feature->Installed, feature->Action);
600 return ERROR_SUCCESS;
603 /***********************************************************************
604 * MsiGetFeatureStateW (MSI.@)
606 UINT WINAPI MsiGetFeatureStateW(MSIHANDLE hInstall, LPWSTR szFeature,
607 INSTALLSTATE *piInstalled, INSTALLSTATE *piAction)
612 TRACE("%ld %s %p %p\n", hInstall, debugstr_w(szFeature), piInstalled,
615 package = msihandle2msiinfo(hInstall, MSIHANDLETYPE_PACKAGE);
617 return ERROR_INVALID_HANDLE;
618 ret = MSI_GetFeatureStateW(package, szFeature, piInstalled, piAction);
619 msiobj_release( &package->hdr );
623 /***********************************************************************
624 * MsiSetComponentStateA (MSI.@)
626 UINT WINAPI MsiSetComponentStateA(MSIHANDLE hInstall, LPCSTR szComponent,
630 LPWSTR szwComponent = strdupAtoW(szComponent);
632 rc = MsiSetComponentStateW(hInstall, szwComponent, iState);
634 msi_free(szwComponent);
639 /***********************************************************************
640 * MsiGetComponentStateA (MSI.@)
642 UINT WINAPI MsiGetComponentStateA(MSIHANDLE hInstall, LPSTR szComponent,
643 INSTALLSTATE *piInstalled, INSTALLSTATE *piAction)
645 LPWSTR szwComponent= NULL;
648 szwComponent= strdupAtoW(szComponent);
650 rc = MsiGetComponentStateW(hInstall,szwComponent,piInstalled, piAction);
652 msi_free( szwComponent);
657 static UINT MSI_SetComponentStateW(MSIPACKAGE *package, LPCWSTR szComponent,
662 TRACE("%p %s %d\n", package, debugstr_w(szComponent), iState);
664 comp = get_loaded_component(package, szComponent);
666 return ERROR_UNKNOWN_COMPONENT;
668 comp->Installed = iState;
670 return ERROR_SUCCESS;
673 UINT MSI_GetComponentStateW(MSIPACKAGE *package, LPWSTR szComponent,
674 INSTALLSTATE *piInstalled, INSTALLSTATE *piAction)
678 TRACE("%p %s %p %p\n", package, debugstr_w(szComponent),
679 piInstalled, piAction);
681 comp = get_loaded_component(package,szComponent);
683 return ERROR_UNKNOWN_COMPONENT;
686 *piInstalled = comp->Installed;
689 *piAction = comp->Action;
691 TRACE("states (%i, %i)\n", comp->Installed, comp->Action );
693 return ERROR_SUCCESS;
696 /***********************************************************************
697 * MsiSetComponentStateW (MSI.@)
699 UINT WINAPI MsiSetComponentStateW(MSIHANDLE hInstall, LPCWSTR szComponent,
705 package = msihandle2msiinfo(hInstall, MSIHANDLETYPE_PACKAGE);
707 return ERROR_INVALID_HANDLE;
708 ret = MSI_SetComponentStateW(package, szComponent, iState);
709 msiobj_release(&package->hdr);
713 /***********************************************************************
714 * MsiGetComponentStateW (MSI.@)
716 UINT WINAPI MsiGetComponentStateW(MSIHANDLE hInstall, LPWSTR szComponent,
717 INSTALLSTATE *piInstalled, INSTALLSTATE *piAction)
722 TRACE("%ld %s %p %p\n", hInstall, debugstr_w(szComponent),
723 piInstalled, piAction);
725 package = msihandle2msiinfo(hInstall, MSIHANDLETYPE_PACKAGE);
727 return ERROR_INVALID_HANDLE;
728 ret = MSI_GetComponentStateW( package, szComponent, piInstalled, piAction);
729 msiobj_release( &package->hdr );
733 /***********************************************************************
734 * MsiGetLanguage (MSI.@)
736 LANGID WINAPI MsiGetLanguage(MSIHANDLE hInstall)
741 static const WCHAR szProductLanguage[] =
742 {'P','r','o','d','u','c','t','L','a','n','g','u','a','g','e',0};
744 package = msihandle2msiinfo(hInstall, MSIHANDLETYPE_PACKAGE);
746 return ERROR_INVALID_HANDLE;
748 buffer = msi_dup_property( package, szProductLanguage );
749 langid = atoiW(buffer);
752 msiobj_release (&package->hdr);