MsiCreateTransformSummaryInfoA function (msiquery.h)
The MsiCreateTransformSummaryInfo function creates summary information of an existing transform to include validation and error conditions. Execution of this function sets the error record, which is accessible by using MsiGetLastErrorRecord.
UINT MsiCreateTransformSummaryInfoA( [in] MSIHANDLE hDatabase, [in] MSIHANDLE hDatabaseReference, [in] LPCSTR szTransformFile, [in] int iErrorConditions, [in] int iValidation );
The handle to the database that contains the new database summary information.
The handle to the database that contains the original summary information.
The name of the transform to which the summary information is added.
The error conditions that should be suppressed when the transform is applied. Use one or more of the following values.
Specifies the properties to be validated to verify that the transform can be applied to the database. This parameter can be one or more of the following values.
||Do not validate properties.|
||Default language must match base database.|
||Product must match base database.|
Validate product version flags.
Product version relationship flags. In the following table the installed version is the version of the package that is being transformed, and the base version is the version of the package that is used to create the transform.
Upgrade code validation flags.
||UpgradeCode must match base database.|
This function returns UINT.
The ProductCode Property and ProductVersion Property must be defined in the Property Table of both the base and reference databases. If MSITRANSFORM_VALIDATE_UPGRADECODE is used, the UpgradeCode Property must also be defined in both databases. If these conditions are not met, MsiCreateTransformSummaryInfo returns ERROR_INSTALL_PACKAGE_INVALID.
- Do not use the semicolon for filenames or paths, because it is used as a list delimiter for transforms, sources, and patches.
- This function cannot be called from custom actions. A call to this function from a custom action causes the function to fail.
The msiquery.h header defines MsiCreateTransformSummaryInfo as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.
|Minimum supported client||Windows Installer 5.0 on Windows Server 2012, Windows 8, Windows Server 2008 R2 or Windows 7. Windows Installer 4.0 or Windows Installer 4.5 on Windows Server 2008 or Windows Vista. Windows Installer on Windows Server 2003 or Windows XP|