aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRob Mensching <rob@firegiant.com>2019-05-08 13:35:21 -0700
committerRob Mensching <rob@firegiant.com>2019-05-08 13:44:59 -0700
commitef6485ac4a03333701d343c1e3a52d25805c58f1 (patch)
tree3093b1410e651a90c3776b42090bb4e62e98c514
parent6e7a3274a1710a734e5369d0a1703b9c9ac9345b (diff)
downloadwix-ef6485ac4a03333701d343c1e3a52d25805c58f1.tar.gz
wix-ef6485ac4a03333701d343c1e3a52d25805c58f1.tar.bz2
wix-ef6485ac4a03333701d343c1e3a52d25805c58f1.zip
Add additional strongly typed tuples
Diffstat
-rw-r--r--src/WixToolset.Data/ComponentKeyPathType.cs27
-rw-r--r--src/WixToolset.Data/IntermediateTupleDefinition.cs2
-rw-r--r--src/WixToolset.Data/LocalizedControl.cs30
-rw-r--r--src/WixToolset.Data/Msi/MsiInterop.cs313
-rw-r--r--src/WixToolset.Data/Tuples/BBControlTuple.cs76
-rw-r--r--src/WixToolset.Data/Tuples/ClassTuple.cs10
-rw-r--r--src/WixToolset.Data/Tuples/CompLocatorTuple.cs14
-rw-r--r--src/WixToolset.Data/Tuples/ComponentTuple.cs81
-rw-r--r--src/WixToolset.Data/Tuples/ControlTuple.cs173
-rw-r--r--src/WixToolset.Data/Tuples/CustomActionTuple.cs120
-rw-r--r--src/WixToolset.Data/Tuples/DialogTuple.cs98
-rw-r--r--src/WixToolset.Data/Tuples/EnvironmentTuple.cs62
-rw-r--r--src/WixToolset.Data/Tuples/FeatureTuple.cs55
-rw-r--r--src/WixToolset.Data/Tuples/IniFileTuple.cs14
-rw-r--r--src/WixToolset.Data/Tuples/InifFileActionType.cs13
-rw-r--r--src/WixToolset.Data/Tuples/LocatorType.cs12
-rw-r--r--src/WixToolset.Data/Tuples/ModuleConfigurationTuple.cs26
-rw-r--r--src/WixToolset.Data/Tuples/MsiEmbeddedUITuple.cs38
-rw-r--r--src/WixToolset.Data/Tuples/MsiServiceConfigFailureActionsTuple.cs38
-rw-r--r--src/WixToolset.Data/Tuples/MsiServiceConfigTuple.cs48
-rw-r--r--src/WixToolset.Data/Tuples/RegistryRootType.cs21
-rw-r--r--src/WixToolset.Data/Tuples/RegistryTuple.cs48
-rw-r--r--src/WixToolset.Data/Tuples/RemoveRegistryTuple.cs28
-rw-r--r--src/WixToolset.Data/Tuples/ServiceControlTuple.cs56
-rw-r--r--src/WixToolset.Data/Tuples/ServiceInstallTuple.cs67
-rw-r--r--src/WixToolset.Data/Tuples/ShortcutTuple.cs47
-rw-r--r--src/WixToolset.Data/Tuples/TextStyleTuple.cs38
-rw-r--r--src/WixToolset.Data/Tuples/TupleDefinitions.cs9
-rw-r--r--src/WixToolset.Data/Tuples/UpgradeTuple.cs50
-rw-r--r--src/WixToolset.Data/Tuples/WixActionTuple.cs2
-rw-r--r--src/WixToolset.Data/Tuples/WixBBControlTuple.cs60
-rw-r--r--src/WixToolset.Data/Tuples/WixControlTuple.cs60
-rw-r--r--src/WixToolset.Data/Tuples/WixRelatedBundleTuple.cs24
-rw-r--r--src/WixToolset.Data/WindowsInstaller/Rows/ComponentRow.cs50
-rw-r--r--src/WixToolset.Data/WindowsInstaller/Rows/FileRow.cs17
-rw-r--r--src/WixToolset.Data/WindowsInstaller/WindowsInstallerConstants.cs259
-rw-r--r--src/WixToolset.Data/WindowsInstaller/WindowsInstallerStandard.cs (renamed from src/WixToolset.Data/WindowsInstallerStandard.cs)6
-rw-r--r--src/WixToolset.Data/WixToolset.Data.csproj3
-rw-r--r--src/WixToolset.Data/Xsd/wix.xsd13035
-rw-r--r--src/WixToolset.Data/Xsd/wixloc.xsd134
-rw-r--r--src/test/WixToolsetTest.Data/SerializeFixture.cs10
-rw-r--r--src/test/WixToolsetTest.Data/WixToolsetTest.Data.csproj4
42 files changed, 1369 insertions, 13909 deletions
diff --git a/src/WixToolset.Data/ComponentKeyPathType.cs b/src/WixToolset.Data/ComponentKeyPathType.cs
new file mode 100644
index 00000000..443049d3
--- /dev/null
+++ b/src/WixToolset.Data/ComponentKeyPathType.cs
@@ -0,0 +1,27 @@
1// Copyright (c) .NET Foundation and contributors. All rights reserved. Licensed under the Microsoft Reciprocal License. See LICENSE.TXT file in the project root for full license information.
2
3namespace WixToolset.Data
4{
5 public enum ComponentKeyPathType
6 {
7 /// <summary>
8 /// Folder as a key path.
9 /// </summary>
10 Directory,
11
12 /// <summary>
13 /// File resource as a key path.
14 /// </summary>
15 File,
16
17 /// <summary>
18 /// ODBC data source as a key path.
19 /// </summary>
20 OdbcDataSource,
21
22 /// <summary>
23 /// A simple registry key acting as a key path.
24 /// </summary>
25 Registry,
26 }
27}
diff --git a/src/WixToolset.Data/IntermediateTupleDefinition.cs b/src/WixToolset.Data/IntermediateTupleDefinition.cs
index ea15c2dd..bc49bc7b 100644
--- a/src/WixToolset.Data/IntermediateTupleDefinition.cs
+++ b/src/WixToolset.Data/IntermediateTupleDefinition.cs
@@ -30,7 +30,7 @@ namespace WixToolset.Data
30 this.FieldDefinitions = fieldDefinitions; 30 this.FieldDefinitions = fieldDefinitions;
31 this.StrongTupleType = strongTupleType ?? typeof(IntermediateTuple); 31 this.StrongTupleType = strongTupleType ?? typeof(IntermediateTuple);
32#if DEBUG 32#if DEBUG
33 if (this.StrongTupleType != typeof(IntermediateTuple) && !this.StrongTupleType.IsSubclassOf(typeof(IntermediateTuple))) throw new ArgumentException(nameof(strongTupleType)); 33 if (this.StrongTupleType != typeof(IntermediateTuple) && !this.StrongTupleType.IsSubclassOf(typeof(IntermediateTuple))) { throw new ArgumentException(nameof(strongTupleType)); }
34#endif 34#endif
35 } 35 }
36 36
diff --git a/src/WixToolset.Data/LocalizedControl.cs b/src/WixToolset.Data/LocalizedControl.cs
index cb60b7ba..1252842b 100644
--- a/src/WixToolset.Data/LocalizedControl.cs
+++ b/src/WixToolset.Data/LocalizedControl.cs
@@ -7,7 +7,7 @@ namespace WixToolset.Data
7 7
8 public class LocalizedControl 8 public class LocalizedControl
9 { 9 {
10 public LocalizedControl(string dialog, string control, int x, int y, int width, int height, int attribs, string text) 10 public LocalizedControl(string dialog, string control, int x, int y, int width, int height, bool rightToLeft, bool rightAligned, bool leftScroll, string text)
11 { 11 {
12 this.Dialog = dialog; 12 this.Dialog = dialog;
13 this.Control = control; 13 this.Control = control;
@@ -15,7 +15,9 @@ namespace WixToolset.Data
15 this.Y = y; 15 this.Y = y;
16 this.Width = width; 16 this.Width = width;
17 this.Height = height; 17 this.Height = height;
18 this.Attributes = attribs; 18 this.RightToLeft = rightToLeft;
19 this.RightAligned = rightAligned;
20 this.LeftScroll = leftScroll;
19 this.Text = text; 21 this.Text = text;
20 } 22 }
21 23
@@ -31,7 +33,11 @@ namespace WixToolset.Data
31 33
32 public int Height { get; } 34 public int Height { get; }
33 35
34 public int Attributes { get; } 36 public bool RightToLeft { get; }
37
38 public bool RightAligned { get; }
39
40 public bool LeftScroll { get; }
35 41
36 public string Text { get; } 42 public string Text { get; }
37 43
@@ -57,11 +63,13 @@ namespace WixToolset.Data
57 }; 63 };
58 64
59 jsonObject.AddIsNotNullOrEmpty("control", this.Control); 65 jsonObject.AddIsNotNullOrEmpty("control", this.Control);
60 jsonObject.AddNonDefaultValue("x", this.X, 0); 66 jsonObject.AddNonDefaultValue("x", this.X);
61 jsonObject.AddNonDefaultValue("y", this.Y, 0); 67 jsonObject.AddNonDefaultValue("y", this.Y);
62 jsonObject.AddNonDefaultValue("width", this.Width, 0); 68 jsonObject.AddNonDefaultValue("width", this.Width);
63 jsonObject.AddNonDefaultValue("height", this.Height, 0); 69 jsonObject.AddNonDefaultValue("height", this.Height);
64 jsonObject.AddNonDefaultValue("attribs", this.Attributes, 0); 70 jsonObject.AddNonDefaultValue("rightToLeft", this.RightToLeft);
71 jsonObject.AddNonDefaultValue("rightAligned", this.RightAligned);
72 jsonObject.AddNonDefaultValue("leftScroll", this.LeftScroll);
65 jsonObject.AddIsNotNullOrEmpty("text", this.Text); 73 jsonObject.AddIsNotNullOrEmpty("text", this.Text);
66 74
67 return jsonObject; 75 return jsonObject;
@@ -75,10 +83,12 @@ namespace WixToolset.Data
75 var y = jsonObject.GetValueOrDefault("y", 0); 83 var y = jsonObject.GetValueOrDefault("y", 0);
76 var width = jsonObject.GetValueOrDefault("width", 0); 84 var width = jsonObject.GetValueOrDefault("width", 0);
77 var height = jsonObject.GetValueOrDefault("height", 0); 85 var height = jsonObject.GetValueOrDefault("height", 0);
78 var attribs = jsonObject.GetValueOrDefault("attribs", 0); 86 var rightToLeft = jsonObject.GetValueOrDefault("rightToLeft", false);
87 var rightAligned = jsonObject.GetValueOrDefault("rightAligned", false);
88 var leftScroll = jsonObject.GetValueOrDefault("leftScroll", false);
79 var text = jsonObject.GetValueOrDefault<string>("text"); 89 var text = jsonObject.GetValueOrDefault<string>("text");
80 90
81 return new LocalizedControl(dialog, control, x, y, width, height, attribs, text); 91 return new LocalizedControl(dialog, control, x, y, width, height, rightToLeft, rightAligned, leftScroll, text);
82 } 92 }
83 } 93 }
84} 94}
diff --git a/src/WixToolset.Data/Msi/MsiInterop.cs b/src/WixToolset.Data/Msi/MsiInterop.cs
deleted file mode 100644
index e4dad358..00000000
--- a/src/WixToolset.Data/Msi/MsiInterop.cs
+++ /dev/null
@@ -1,313 +0,0 @@
1// Copyright (c) .NET Foundation and contributors. All rights reserved. Licensed under the Microsoft Reciprocal License. See LICENSE.TXT file in the project root for full license information.
2
3namespace WixToolset.Data.Msi
4{
5 public class MsiInterop
6 {
7 // Patching constants
8 internal const int MsiMaxStreamNameLength = 62; // http://msdn2.microsoft.com/library/aa370551.aspx
9
10 // Component.Attributes
11 public const int MsidbComponentAttributesLocalOnly = 0;
12 public const int MsidbComponentAttributesSourceOnly = 1;
13 public const int MsidbComponentAttributesOptional = 2;
14 public const int MsidbComponentAttributesRegistryKeyPath = 4;
15 public const int MsidbComponentAttributesSharedDllRefCount = 8;
16 public const int MsidbComponentAttributesPermanent = 16;
17 public const int MsidbComponentAttributesODBCDataSource = 32;
18 public const int MsidbComponentAttributesTransitive = 64;
19 public const int MsidbComponentAttributesNeverOverwrite = 128;
20 public const int MsidbComponentAttributes64bit = 256;
21 public const int MsidbComponentAttributesDisableRegistryReflection = 512;
22 public const int MsidbComponentAttributesUninstallOnSupersedence = 1024;
23 public const int MsidbComponentAttributesShared = 2048;
24
25 // BBControl.Attributes & Control.Attributes
26 internal const int MsidbControlAttributesVisible = 0x00000001;
27 internal const int MsidbControlAttributesEnabled = 0x00000002;
28 internal const int MsidbControlAttributesSunken = 0x00000004;
29 internal const int MsidbControlAttributesIndirect = 0x00000008;
30 internal const int MsidbControlAttributesInteger = 0x00000010;
31 internal const int MsidbControlAttributesRTLRO = 0x00000020;
32 internal const int MsidbControlAttributesRightAligned = 0x00000040;
33 internal const int MsidbControlAttributesLeftScroll = 0x00000080;
34 internal const int MsidbControlAttributesBiDi = MsidbControlAttributesRTLRO | MsidbControlAttributesRightAligned | MsidbControlAttributesLeftScroll;
35
36 // Text controls
37 internal const int MsidbControlAttributesTransparent = 0x00010000;
38 internal const int MsidbControlAttributesNoPrefix = 0x00020000;
39 internal const int MsidbControlAttributesNoWrap = 0x00040000;
40 internal const int MsidbControlAttributesFormatSize = 0x00080000;
41 internal const int MsidbControlAttributesUsersLanguage = 0x00100000;
42
43 // Edit controls
44 internal const int MsidbControlAttributesMultiline = 0x00010000;
45 internal const int MsidbControlAttributesPasswordInput = 0x00200000;
46
47 // ProgressBar controls
48 internal const int MsidbControlAttributesProgress95 = 0x00010000;
49
50 // VolumeSelectCombo and DirectoryCombo controls
51 internal const int MsidbControlAttributesRemovableVolume = 0x00010000;
52 internal const int MsidbControlAttributesFixedVolume = 0x00020000;
53 internal const int MsidbControlAttributesRemoteVolume = 0x00040000;
54 internal const int MsidbControlAttributesCDROMVolume = 0x00080000;
55 internal const int MsidbControlAttributesRAMDiskVolume = 0x00100000;
56 internal const int MsidbControlAttributesFloppyVolume = 0x00200000;
57
58 // VolumeCostList controls
59 internal const int MsidbControlShowRollbackCost = 0x00400000;
60
61 // ListBox and ComboBox controls
62 internal const int MsidbControlAttributesSorted = 0x00010000;
63 internal const int MsidbControlAttributesComboList = 0x00020000;
64
65 // picture button controls
66 internal const int MsidbControlAttributesImageHandle = 0x00010000;
67 internal const int MsidbControlAttributesPushLike = 0x00020000;
68 internal const int MsidbControlAttributesBitmap = 0x00040000;
69 internal const int MsidbControlAttributesIcon = 0x00080000;
70 internal const int MsidbControlAttributesFixedSize = 0x00100000;
71 internal const int MsidbControlAttributesIconSize16 = 0x00200000;
72 internal const int MsidbControlAttributesIconSize32 = 0x00400000;
73 internal const int MsidbControlAttributesIconSize48 = 0x00600000;
74 internal const int MsidbControlAttributesElevationShield = 0x00800000;
75
76 // RadioButton controls
77 internal const int MsidbControlAttributesHasBorder = 0x01000000;
78
79 // CustomAction.Type
80 // executable types
81 internal const int MsidbCustomActionTypeDll = 0x00000001; // Target = entry point name
82 internal const int MsidbCustomActionTypeExe = 0x00000002; // Target = command line args
83 internal const int MsidbCustomActionTypeTextData = 0x00000003; // Target = text string to be formatted and set into property
84 internal const int MsidbCustomActionTypeJScript = 0x00000005; // Target = entry point name; null if none to call
85 internal const int MsidbCustomActionTypeVBScript = 0x00000006; // Target = entry point name; null if none to call
86 internal const int MsidbCustomActionTypeInstall = 0x00000007; // Target = property list for nested engine initialization
87 internal const int MsidbCustomActionTypeSourceBits = 0x00000030;
88 internal const int MsidbCustomActionTypeTargetBits = 0x00000007;
89 internal const int MsidbCustomActionTypeReturnBits = 0x000000C0;
90 internal const int MsidbCustomActionTypeExecuteBits = 0x00000700;
91
92 // source of code
93 internal const int MsidbCustomActionTypeBinaryData = 0x00000000; // Source = Binary.Name; data stored in stream
94 internal const int MsidbCustomActionTypeSourceFile = 0x00000010; // Source = File.File; file part of installation
95 internal const int MsidbCustomActionTypeDirectory = 0x00000020; // Source = Directory.Directory; folder containing existing file
96 internal const int MsidbCustomActionTypeProperty = 0x00000030; // Source = Property.Property; full path to executable
97
98 // return processing; default is syncronous execution; process return code
99 internal const int MsidbCustomActionTypeContinue = 0x00000040; // ignore action return status; continue running
100 internal const int MsidbCustomActionTypeAsync = 0x00000080; // run asynchronously
101
102 // execution scheduling flags; default is execute whenever sequenced
103 internal const int MsidbCustomActionTypeFirstSequence = 0x00000100; // skip if UI sequence already run
104 internal const int MsidbCustomActionTypeOncePerProcess = 0x00000200; // skip if UI sequence already run in same process
105 internal const int MsidbCustomActionTypeClientRepeat = 0x00000300; // run on client only if UI already run on client
106 internal const int MsidbCustomActionTypeInScript = 0x00000400; // queue for execution within script
107 internal const int MsidbCustomActionTypeRollback = 0x00000100; // in conjunction with InScript: queue in Rollback script
108 internal const int MsidbCustomActionTypeCommit = 0x00000200; // in conjunction with InScript: run Commit ops from script on success
109
110 // security context flag; default to impersonate as user; valid only if InScript
111 internal const int MsidbCustomActionTypeNoImpersonate = 0x00000800; // no impersonation; run in system context
112 internal const int MsidbCustomActionTypeTSAware = 0x00004000; // impersonate for per-machine installs on TS machines
113 internal const int MsidbCustomActionType64BitScript = 0x00001000; // script should run in 64bit process
114 internal const int MsidbCustomActionTypeHideTarget = 0x00002000; // don't record the contents of the Target field in the log file.
115
116 internal const int MsidbCustomActionTypePatchUninstall = 0x00008000; // run on patch uninstall
117
118 // Dialog.Attributes
119 internal const int MsidbDialogAttributesVisible = 0x00000001;
120 internal const int MsidbDialogAttributesModal = 0x00000002;
121 internal const int MsidbDialogAttributesMinimize = 0x00000004;
122 internal const int MsidbDialogAttributesSysModal = 0x00000008;
123 internal const int MsidbDialogAttributesKeepModeless = 0x00000010;
124 internal const int MsidbDialogAttributesTrackDiskSpace = 0x00000020;
125 internal const int MsidbDialogAttributesUseCustomPalette = 0x00000040;
126 internal const int MsidbDialogAttributesRTLRO = 0x00000080;
127 internal const int MsidbDialogAttributesRightAligned = 0x00000100;
128 internal const int MsidbDialogAttributesLeftScroll = 0x00000200;
129 internal const int MsidbDialogAttributesBiDi = MsidbDialogAttributesRTLRO | MsidbDialogAttributesRightAligned | MsidbDialogAttributesLeftScroll;
130 internal const int MsidbDialogAttributesError = 0x00010000;
131 internal const int CommonControlAttributesInvert = MsidbControlAttributesVisible + MsidbControlAttributesEnabled;
132 internal const int DialogAttributesInvert = MsidbDialogAttributesVisible + MsidbDialogAttributesModal + MsidbDialogAttributesMinimize;
133
134 // Feature.Attributes
135 internal const int MsidbFeatureAttributesFavorLocal = 0;
136 internal const int MsidbFeatureAttributesFavorSource = 1;
137 internal const int MsidbFeatureAttributesFollowParent = 2;
138 internal const int MsidbFeatureAttributesFavorAdvertise = 4;
139 internal const int MsidbFeatureAttributesDisallowAdvertise = 8;
140 internal const int MsidbFeatureAttributesUIDisallowAbsent = 16;
141 internal const int MsidbFeatureAttributesNoUnsupportedAdvertise = 32;
142
143 // File.Attributes
144 public const int MsidbFileAttributesReadOnly = 1;
145 public const int MsidbFileAttributesHidden = 2;
146 public const int MsidbFileAttributesSystem = 4;
147 public const int MsidbFileAttributesVital = 512;
148 public const int MsidbFileAttributesChecksum = 1024;
149 public const int MsidbFileAttributesPatchAdded = 4096;
150 public const int MsidbFileAttributesNoncompressed = 8192;
151 public const int MsidbFileAttributesCompressed = 16384;
152
153 // IniFile.Action & RemoveIniFile.Action
154 internal const int MsidbIniFileActionAddLine = 0;
155 internal const int MsidbIniFileActionCreateLine = 1;
156 internal const int MsidbIniFileActionRemoveLine = 2;
157 internal const int MsidbIniFileActionAddTag = 3;
158 internal const int MsidbIniFileActionRemoveTag = 4;
159
160 // MoveFile.Options
161 internal const int MsidbMoveFileOptionsMove = 1;
162
163 // ServiceInstall.Attributes
164 internal const int MsidbServiceInstallOwnProcess = 0x00000010;
165 internal const int MsidbServiceInstallShareProcess = 0x00000020;
166 internal const int MsidbServiceInstallInteractive = 0x00000100;
167 internal const int MsidbServiceInstallAutoStart = 0x00000002;
168 internal const int MsidbServiceInstallDemandStart = 0x00000003;
169 internal const int MsidbServiceInstallDisabled = 0x00000004;
170 internal const int MsidbServiceInstallErrorIgnore = 0x00000000;
171 internal const int MsidbServiceInstallErrorNormal = 0x00000001;
172 internal const int MsidbServiceInstallErrorCritical = 0x00000003;
173 internal const int MsidbServiceInstallErrorControlVital = 0x00008000;
174
175 // ServiceConfig.Event
176 internal const int MsidbServiceConfigEventInstall = 0x00000001;
177 internal const int MsidbServiceConfigEventUninstall = 0x00000002;
178 internal const int MsidbServiceConfigEventReinstall = 0x00000004;
179
180 // ServiceControl.Attributes
181 internal const int MsidbServiceControlEventStart = 0x00000001;
182 internal const int MsidbServiceControlEventStop = 0x00000002;
183 internal const int MsidbServiceControlEventDelete = 0x00000008;
184 internal const int MsidbServiceControlEventUninstallStart = 0x00000010;
185 internal const int MsidbServiceControlEventUninstallStop = 0x00000020;
186 internal const int MsidbServiceControlEventUninstallDelete = 0x00000080;
187
188 // TextStyle.StyleBits
189 internal const int MsidbTextStyleStyleBitsBold = 1;
190 internal const int MsidbTextStyleStyleBitsItalic = 2;
191 internal const int MsidbTextStyleStyleBitsUnderline = 4;
192 internal const int MsidbTextStyleStyleBitsStrike = 8;
193
194 // Upgrade.Attributes
195 internal const int MsidbUpgradeAttributesMigrateFeatures = 0x00000001;
196 internal const int MsidbUpgradeAttributesOnlyDetect = 0x00000002;
197 internal const int MsidbUpgradeAttributesIgnoreRemoveFailure = 0x00000004;
198 internal const int MsidbUpgradeAttributesVersionMinInclusive = 0x00000100;
199 internal const int MsidbUpgradeAttributesVersionMaxInclusive = 0x00000200;
200 internal const int MsidbUpgradeAttributesLanguagesExclusive = 0x00000400;
201
202 // Registry Hive Roots
203 internal const int MsidbRegistryRootClassesRoot = 0;
204 internal const int MsidbRegistryRootCurrentUser = 1;
205 internal const int MsidbRegistryRootLocalMachine = 2;
206 internal const int MsidbRegistryRootUsers = 3;
207
208 // Locator Types
209 internal const int MsidbLocatorTypeDirectory = 0;
210 internal const int MsidbLocatorTypeFileName = 1;
211 internal const int MsidbLocatorTypeRawValue = 2;
212 internal const int MsidbLocatorType64bit = 16;
213
214 internal const int MsidbClassAttributesRelativePath = 1;
215
216 // RemoveFile.InstallMode
217 internal const int MsidbRemoveFileInstallModeOnInstall = 0x00000001;
218 internal const int MsidbRemoveFileInstallModeOnRemove = 0x00000002;
219 internal const int MsidbRemoveFileInstallModeOnBoth = 0x00000003;
220
221 // ODBCDataSource.Registration
222 internal const int MsidbODBCDataSourceRegistrationPerMachine = 0;
223 internal const int MsidbODBCDataSourceRegistrationPerUser = 1;
224
225 // ModuleConfiguration.Format
226 internal const int MsidbModuleConfigurationFormatText = 0;
227 internal const int MsidbModuleConfigurationFormatKey = 1;
228 internal const int MsidbModuleConfigurationFormatInteger = 2;
229 internal const int MsidbModuleConfigurationFormatBitfield = 3;
230
231 // ModuleConfiguration.Attributes
232 internal const int MsidbMsmConfigurableOptionKeyNoOrphan = 1;
233 internal const int MsidbMsmConfigurableOptionNonNullable = 2;
234
235 // ' Windows API function ShowWindow constants - used in Shortcut table
236 internal const int SWSHOWNORMAL = 0x00000001;
237 internal const int SWSHOWMAXIMIZED = 0x00000003;
238 internal const int SWSHOWMINNOACTIVE = 0x00000007;
239
240 // NameToBit arrays
241 // UI elements
242 internal static readonly string[] CommonControlAttributes = { "Hidden", "Disabled", "Sunken", "Indirect", "Integer", "RightToLeft", "RightAligned", "LeftScroll" };
243 internal static readonly string[] TextControlAttributes = { "Transparent", "NoPrefix", "NoWrap", "FormatSize", "UserLanguage" };
244 internal static readonly string[] HyperlinkControlAttributes = { "Transparent" };
245 internal static readonly string[] EditControlAttributes = { "Multiline", null, null, null, null, "Password" };
246 internal static readonly string[] ProgressControlAttributes = { "ProgressBlocks" };
247 internal static readonly string[] VolumeControlAttributes = { "Removable", "Fixed", "Remote", "CDROM", "RAMDisk", "Floppy", "ShowRollbackCost" };
248 internal static readonly string[] ListboxControlAttributes = { "Sorted", null, null, null, "UserLanguage" };
249 internal static readonly string[] ListviewControlAttributes = { "Sorted", null, null, null, "FixedSize", "Icon16", "Icon32" };
250 internal static readonly string[] ComboboxControlAttributes = { "Sorted", "ComboList", null, null, "UserLanguage" };
251 internal static readonly string[] RadioControlAttributes = { "Image", "PushLike", "Bitmap", "Icon", "FixedSize", "Icon16", "Icon32", null, "HasBorder" };
252 internal static readonly string[] ButtonControlAttributes = { "Image", null, "Bitmap", "Icon", "FixedSize", "Icon16", "Icon32", "ElevationShield" };
253 internal static readonly string[] IconControlAttributes = { "Image", null, null, null, "FixedSize", "Icon16", "Icon32" };
254 internal static readonly string[] BitmapControlAttributes = { "Image", null, null, null, "FixedSize" };
255 internal static readonly string[] CheckboxControlAttributes = { null, "PushLike", "Bitmap", "Icon", "FixedSize", "Icon16", "Icon32" };
256
257 internal const int MsidbEmbeddedUI = 0x01;
258 internal const int MsidbEmbeddedHandlesBasic = 0x02;
259
260 internal const int INSTALLLOGMODE_FATALEXIT = 0x00001;
261 internal const int INSTALLLOGMODE_ERROR = 0x00002;
262 internal const int INSTALLLOGMODE_WARNING = 0x00004;
263 internal const int INSTALLLOGMODE_USER = 0x00008;
264 internal const int INSTALLLOGMODE_INFO = 0x00010;
265 internal const int INSTALLLOGMODE_FILESINUSE = 0x00020;
266 internal const int INSTALLLOGMODE_RESOLVESOURCE = 0x00040;
267 internal const int INSTALLLOGMODE_OUTOFDISKSPACE = 0x00080;
268 internal const int INSTALLLOGMODE_ACTIONSTART = 0x00100;
269 internal const int INSTALLLOGMODE_ACTIONDATA = 0x00200;
270 internal const int INSTALLLOGMODE_PROGRESS = 0x00400;
271 internal const int INSTALLLOGMODE_COMMONDATA = 0x00800;
272 internal const int INSTALLLOGMODE_INITIALIZE = 0x01000;
273 internal const int INSTALLLOGMODE_TERMINATE = 0x02000;
274 internal const int INSTALLLOGMODE_SHOWDIALOG = 0x04000;
275 internal const int INSTALLLOGMODE_RMFILESINUSE = 0x02000000;
276 internal const int INSTALLLOGMODE_INSTALLSTART = 0x04000000;
277 internal const int INSTALLLOGMODE_INSTALLEND = 0x08000000;
278
279 internal const int MSICONDITIONFALSE = 0; // The table is temporary.
280 internal const int MSICONDITIONTRUE = 1; // The table is persistent.
281 internal const int MSICONDITIONNONE = 2; // The table is unknown.
282 internal const int MSICONDITIONERROR = 3; // An invalid handle or invalid parameter was passed to the function.
283
284 internal const int MSIDBOPENREADONLY = 0;
285 internal const int MSIDBOPENTRANSACT = 1;
286 internal const int MSIDBOPENDIRECT = 2;
287 internal const int MSIDBOPENCREATE = 3;
288 internal const int MSIDBOPENCREATEDIRECT = 4;
289 internal const int MSIDBOPENPATCHFILE = 32;
290
291 internal const int MSIMODIFYSEEK = -1; // Refreshes the information in the supplied record without changing the position in the result set and without affecting subsequent fetch operations. The record may then be used for subsequent Update, Delete, and Refresh. All primary key columns of the table must be in the query and the record must have at least as many fields as the query. Seek cannot be used with multi-table queries. This mode cannot be used with a view containing joins. See also the remarks.
292 internal const int MSIMODIFYREFRESH = 0; // Refreshes the information in the record. Must first call MsiViewFetch with the same record. Fails for a deleted row. Works with read-write and read-only records.
293 internal const int MSIMODIFYINSERT = 1; // Inserts a record. Fails if a row with the same primary keys exists. Fails with a read-only database. This mode cannot be used with a view containing joins.
294 internal const int MSIMODIFYUPDATE = 2; // Updates an existing record. Nonprimary keys only. Must first call MsiViewFetch. Fails with a deleted record. Works only with read-write records.
295 internal const int MSIMODIFYASSIGN = 3; // Writes current data in the cursor to a table row. Updates record if the primary keys match an existing row and inserts if they do not match. Fails with a read-only database. This mode cannot be used with a view containing joins.
296 internal const int MSIMODIFYREPLACE = 4; // Updates or deletes and inserts a record into a table. Must first call MsiViewFetch with the same record. Updates record if the primary keys are unchanged. Deletes old row and inserts new if primary keys have changed. Fails with a read-only database. This mode cannot be used with a view containing joins.
297 internal const int MSIMODIFYMERGE = 5; // Inserts or validates a record in a table. Inserts if primary keys do not match any row and validates if there is a match. Fails if the record does not match the data in the table. Fails if there is a record with a duplicate key that is not identical. Works only with read-write records. This mode cannot be used with a view containing joins.
298 internal const int MSIMODIFYDELETE = 6; // Remove a row from the table. You must first call the MsiViewFetch function with the same record. Fails if the row has been deleted. Works only with read-write records. This mode cannot be used with a view containing joins.
299 internal const int MSIMODIFYINSERTTEMPORARY = 7; // Inserts a temporary record. The information is not persistent. Fails if a row with the same primary key exists. Works only with read-write records. This mode cannot be used with a view containing joins.
300 internal const int MSIMODIFYVALIDATE = 8; // Validates a record. Does not validate across joins. You must first call the MsiViewFetch function with the same record. Obtain validation errors with MsiViewGetError. Works with read-write and read-only records. This mode cannot be used with a view containing joins.
301 internal const int MSIMODIFYVALIDATENEW = 9; // Validate a new record. Does not validate across joins. Checks for duplicate keys. Obtain validation errors by calling MsiViewGetError. Works with read-write and read-only records. This mode cannot be used with a view containing joins.
302 internal const int MSIMODIFYVALIDATEFIELD = 10; // Validates fields of a fetched or new record. Can validate one or more fields of an incomplete record. Obtain validation errors by calling MsiViewGetError. Works with read-write and read-only records. This mode cannot be used with a view containing joins.
303 internal const int MSIMODIFYVALIDATEDELETE = 11; // Validates a record that will be deleted later. You must first call MsiViewFetch. Fails if another row refers to the primary keys of this row. Validation does not check for the existence of the primary keys of this row in properties or strings. Does not check if a column is a foreign key to multiple tables. Obtain validation errors by calling MsiViewGetError. Works with read-write and read-only records. This mode cannot be used with a view containing joins.
304
305 internal const uint VTI2 = 2;
306 internal const uint VTI4 = 3;
307 internal const uint VTLPWSTR = 30;
308 internal const uint VTFILETIME = 64;
309
310 internal const int MSICOLINFONAMES = 0; // return column names
311 internal const int MSICOLINFOTYPES = 1; // return column definitions, datatype code followed by width
312 }
313}
diff --git a/src/WixToolset.Data/Tuples/BBControlTuple.cs b/src/WixToolset.Data/Tuples/BBControlTuple.cs
index dae041d4..b9066f81 100644
--- a/src/WixToolset.Data/Tuples/BBControlTuple.cs
+++ b/src/WixToolset.Data/Tuples/BBControlTuple.cs
@@ -18,7 +18,16 @@ namespace WixToolset.Data
18 new IntermediateFieldDefinition(nameof(BBControlTupleFields.Width), IntermediateFieldType.Number), 18 new IntermediateFieldDefinition(nameof(BBControlTupleFields.Width), IntermediateFieldType.Number),
19 new IntermediateFieldDefinition(nameof(BBControlTupleFields.Height), IntermediateFieldType.Number), 19 new IntermediateFieldDefinition(nameof(BBControlTupleFields.Height), IntermediateFieldType.Number),
20 new IntermediateFieldDefinition(nameof(BBControlTupleFields.Attributes), IntermediateFieldType.Number), 20 new IntermediateFieldDefinition(nameof(BBControlTupleFields.Attributes), IntermediateFieldType.Number),
21 new IntermediateFieldDefinition(nameof(BBControlTupleFields.Enabled), IntermediateFieldType.Bool),
22 new IntermediateFieldDefinition(nameof(BBControlTupleFields.Indirect), IntermediateFieldType.Bool),
23 new IntermediateFieldDefinition(nameof(BBControlTupleFields.Integer), IntermediateFieldType.Bool),
24 new IntermediateFieldDefinition(nameof(BBControlTupleFields.LeftScroll), IntermediateFieldType.Bool),
25 new IntermediateFieldDefinition(nameof(BBControlTupleFields.RightAligned), IntermediateFieldType.Bool),
26 new IntermediateFieldDefinition(nameof(BBControlTupleFields.RightToLeft), IntermediateFieldType.Bool),
27 new IntermediateFieldDefinition(nameof(BBControlTupleFields.Sunken), IntermediateFieldType.Bool),
28 new IntermediateFieldDefinition(nameof(BBControlTupleFields.Visible), IntermediateFieldType.Bool),
21 new IntermediateFieldDefinition(nameof(BBControlTupleFields.Text), IntermediateFieldType.String), 29 new IntermediateFieldDefinition(nameof(BBControlTupleFields.Text), IntermediateFieldType.String),
30 new IntermediateFieldDefinition(nameof(BBControlTupleFields.SourceFile), IntermediateFieldType.Path),
22 }, 31 },
23 typeof(BBControlTuple)); 32 typeof(BBControlTuple));
24 } 33 }
@@ -36,7 +45,16 @@ namespace WixToolset.Data.Tuples
36 Width, 45 Width,
37 Height, 46 Height,
38 Attributes, 47 Attributes,
48 Enabled,
49 Indirect,
50 Integer,
51 LeftScroll,
52 RightAligned,
53 RightToLeft,
54 Sunken,
55 Visible,
39 Text, 56 Text,
57 SourceFile
40 } 58 }
41 59
42 public class BBControlTuple : IntermediateTuple 60 public class BBControlTuple : IntermediateTuple
@@ -83,7 +101,7 @@ namespace WixToolset.Data.Tuples
83 101
84 public int Width 102 public int Width
85 { 103 {
86 get => (int)this.Fields[(int)BBControlTupleFields.Width]?.Value; 104 get => (int)this.Fields[(int)BBControlTupleFields.Width].AsNumber();
87 set => this.Set((int)BBControlTupleFields.Width, value); 105 set => this.Set((int)BBControlTupleFields.Width, value);
88 } 106 }
89 107
@@ -95,14 +113,68 @@ namespace WixToolset.Data.Tuples
95 113
96 public int Attributes 114 public int Attributes
97 { 115 {
98 get => (int)this.Fields[(int)BBControlTupleFields.Attributes]?.Value; 116 get => this.Fields[(int)BBControlTupleFields.Attributes].AsNumber();
99 set => this.Set((int)BBControlTupleFields.Attributes, value); 117 set => this.Set((int)BBControlTupleFields.Attributes, value);
100 } 118 }
101 119
120 public bool Enabled
121 {
122 get => this.Fields[(int)BBControlTupleFields.Enabled].AsBool();
123 set => this.Set((int)BBControlTupleFields.Enabled, value);
124 }
125
126 public bool Indirect
127 {
128 get => this.Fields[(int)BBControlTupleFields.Indirect].AsBool();
129 set => this.Set((int)BBControlTupleFields.Indirect, value);
130 }
131
132 public bool Integer
133 {
134 get => this.Fields[(int)BBControlTupleFields.Integer].AsBool();
135 set => this.Set((int)BBControlTupleFields.Integer, value);
136 }
137
138 public bool LeftScroll
139 {
140 get => this.Fields[(int)BBControlTupleFields.LeftScroll].AsBool();
141 set => this.Set((int)BBControlTupleFields.LeftScroll, value);
142 }
143
144 public bool RightAligned
145 {
146 get => this.Fields[(int)BBControlTupleFields.RightAligned].AsBool();
147 set => this.Set((int)BBControlTupleFields.RightAligned, value);
148 }
149
150 public bool RightToLeft
151 {
152 get => this.Fields[(int)BBControlTupleFields.RightToLeft].AsBool();
153 set => this.Set((int)BBControlTupleFields.RightToLeft, value);
154 }
155
156 public bool Sunken
157 {
158 get => this.Fields[(int)BBControlTupleFields.Sunken].AsBool();
159 set => this.Set((int)BBControlTupleFields.Sunken, value);
160 }
161
162 public bool Visible
163 {
164 get => this.Fields[(int)BBControlTupleFields.Visible].AsBool();
165 set => this.Set((int)BBControlTupleFields.Visible, value);
166 }
167
102 public string Text 168 public string Text
103 { 169 {
104 get => (string)this.Fields[(int)BBControlTupleFields.Text]?.Value; 170 get => (string)this.Fields[(int)BBControlTupleFields.Text]?.Value;
105 set => this.Set((int)BBControlTupleFields.Text, value); 171 set => this.Set((int)BBControlTupleFields.Text, value);
106 } 172 }
173
174 public string SourceFile
175 {
176 get => (string)this.Fields[(int)BBControlTupleFields.SourceFile]?.Value;
177 set => this.Set((int)BBControlTupleFields.SourceFile, value);
178 }
107 } 179 }
108} \ No newline at end of file 180} \ No newline at end of file
diff --git a/src/WixToolset.Data/Tuples/ClassTuple.cs b/src/WixToolset.Data/Tuples/ClassTuple.cs
index a9bb3b95..17212a5e 100644
--- a/src/WixToolset.Data/Tuples/ClassTuple.cs
+++ b/src/WixToolset.Data/Tuples/ClassTuple.cs
@@ -22,7 +22,7 @@ namespace WixToolset.Data
22 new IntermediateFieldDefinition(nameof(ClassTupleFields.DefInprocHandler), IntermediateFieldType.String), 22 new IntermediateFieldDefinition(nameof(ClassTupleFields.DefInprocHandler), IntermediateFieldType.String),
23 new IntermediateFieldDefinition(nameof(ClassTupleFields.Argument), IntermediateFieldType.String), 23 new IntermediateFieldDefinition(nameof(ClassTupleFields.Argument), IntermediateFieldType.String),
24 new IntermediateFieldDefinition(nameof(ClassTupleFields.Feature_), IntermediateFieldType.String), 24 new IntermediateFieldDefinition(nameof(ClassTupleFields.Feature_), IntermediateFieldType.String),
25 new IntermediateFieldDefinition(nameof(ClassTupleFields.Attributes), IntermediateFieldType.Number), 25 new IntermediateFieldDefinition(nameof(ClassTupleFields.RelativePath), IntermediateFieldType.Bool),
26 }, 26 },
27 typeof(ClassTuple)); 27 typeof(ClassTuple));
28 } 28 }
@@ -44,7 +44,7 @@ namespace WixToolset.Data.Tuples
44 DefInprocHandler, 44 DefInprocHandler,
45 Argument, 45 Argument,
46 Feature_, 46 Feature_,
47 Attributes, 47 RelativePath,
48 } 48 }
49 49
50 public class ClassTuple : IntermediateTuple 50 public class ClassTuple : IntermediateTuple
@@ -131,10 +131,10 @@ namespace WixToolset.Data.Tuples
131 set => this.Set((int)ClassTupleFields.Feature_, value); 131 set => this.Set((int)ClassTupleFields.Feature_, value);
132 } 132 }
133 133
134 public int Attributes 134 public bool RelativePath
135 { 135 {
136 get => (int)this.Fields[(int)ClassTupleFields.Attributes]?.Value; 136 get => this.Fields[(int)ClassTupleFields.RelativePath].AsBool();
137 set => this.Set((int)ClassTupleFields.Attributes, value); 137 set => this.Set((int)ClassTupleFields.RelativePath, value);
138 } 138 }
139 } 139 }
140} \ No newline at end of file 140} \ No newline at end of file
diff --git a/src/WixToolset.Data/Tuples/CompLocatorTuple.cs b/src/WixToolset.Data/Tuples/CompLocatorTuple.cs
index e8560711..37bc2a37 100644
--- a/src/WixToolset.Data/Tuples/CompLocatorTuple.cs
+++ b/src/WixToolset.Data/Tuples/CompLocatorTuple.cs
@@ -10,7 +10,6 @@ namespace WixToolset.Data
10 TupleDefinitionType.CompLocator, 10 TupleDefinitionType.CompLocator,
11 new[] 11 new[]
12 { 12 {
13 new IntermediateFieldDefinition(nameof(CompLocatorTupleFields.Signature_), IntermediateFieldType.String),
14 new IntermediateFieldDefinition(nameof(CompLocatorTupleFields.ComponentId), IntermediateFieldType.String), 13 new IntermediateFieldDefinition(nameof(CompLocatorTupleFields.ComponentId), IntermediateFieldType.String),
15 new IntermediateFieldDefinition(nameof(CompLocatorTupleFields.Type), IntermediateFieldType.Number), 14 new IntermediateFieldDefinition(nameof(CompLocatorTupleFields.Type), IntermediateFieldType.Number),
16 }, 15 },
@@ -22,7 +21,6 @@ namespace WixToolset.Data.Tuples
22{ 21{
23 public enum CompLocatorTupleFields 22 public enum CompLocatorTupleFields
24 { 23 {
25 Signature_,
26 ComponentId, 24 ComponentId,
27 Type, 25 Type,
28 } 26 }
@@ -39,22 +37,16 @@ namespace WixToolset.Data.Tuples
39 37
40 public IntermediateField this[CompLocatorTupleFields index] => this.Fields[(int)index]; 38 public IntermediateField this[CompLocatorTupleFields index] => this.Fields[(int)index];
41 39
42 public string Signature_
43 {
44 get => (string)this.Fields[(int)CompLocatorTupleFields.Signature_]?.Value;
45 set => this.Set((int)CompLocatorTupleFields.Signature_, value);
46 }
47
48 public string ComponentId 40 public string ComponentId
49 { 41 {
50 get => (string)this.Fields[(int)CompLocatorTupleFields.ComponentId]?.Value; 42 get => (string)this.Fields[(int)CompLocatorTupleFields.ComponentId]?.Value;
51 set => this.Set((int)CompLocatorTupleFields.ComponentId, value); 43 set => this.Set((int)CompLocatorTupleFields.ComponentId, value);
52 } 44 }
53 45
54 public int Type 46 public LocatorType Type
55 { 47 {
56 get => (int)this.Fields[(int)CompLocatorTupleFields.Type]?.Value; 48 get => (LocatorType)this.Fields[(int)CompLocatorTupleFields.Type].AsNumber();
57 set => this.Set((int)CompLocatorTupleFields.Type, value); 49 set => this.Set((int)CompLocatorTupleFields.Type, (int)value);
58 } 50 }
59 } 51 }
60} \ No newline at end of file 52} \ No newline at end of file
diff --git a/src/WixToolset.Data/Tuples/ComponentTuple.cs b/src/WixToolset.Data/Tuples/ComponentTuple.cs
index 8d679609..609852bd 100644
--- a/src/WixToolset.Data/Tuples/ComponentTuple.cs
+++ b/src/WixToolset.Data/Tuples/ComponentTuple.cs
@@ -13,9 +13,17 @@ namespace WixToolset.Data
13 new IntermediateFieldDefinition(nameof(ComponentTupleFields.Component), IntermediateFieldType.String), 13 new IntermediateFieldDefinition(nameof(ComponentTupleFields.Component), IntermediateFieldType.String),
14 new IntermediateFieldDefinition(nameof(ComponentTupleFields.ComponentId), IntermediateFieldType.String), 14 new IntermediateFieldDefinition(nameof(ComponentTupleFields.ComponentId), IntermediateFieldType.String),
15 new IntermediateFieldDefinition(nameof(ComponentTupleFields.Directory_), IntermediateFieldType.String), 15 new IntermediateFieldDefinition(nameof(ComponentTupleFields.Directory_), IntermediateFieldType.String),
16 new IntermediateFieldDefinition(nameof(ComponentTupleFields.Attributes), IntermediateFieldType.Number), 16 new IntermediateFieldDefinition(nameof(ComponentTupleFields.Location), IntermediateFieldType.Number),
17 new IntermediateFieldDefinition(nameof(ComponentTupleFields.DisableRegistryReflection), IntermediateFieldType.Bool),
18 new IntermediateFieldDefinition(nameof(ComponentTupleFields.NeverOverwrite), IntermediateFieldType.Bool),
19 new IntermediateFieldDefinition(nameof(ComponentTupleFields.Permanent), IntermediateFieldType.Bool),
20 new IntermediateFieldDefinition(nameof(ComponentTupleFields.SharedDllRefCount), IntermediateFieldType.Bool),
21 new IntermediateFieldDefinition(nameof(ComponentTupleFields.Transitive), IntermediateFieldType.Bool),
22 new IntermediateFieldDefinition(nameof(ComponentTupleFields.UninstallWhenSuperseded), IntermediateFieldType.Bool),
23 new IntermediateFieldDefinition(nameof(ComponentTupleFields.Win64), IntermediateFieldType.Bool),
17 new IntermediateFieldDefinition(nameof(ComponentTupleFields.Condition), IntermediateFieldType.String), 24 new IntermediateFieldDefinition(nameof(ComponentTupleFields.Condition), IntermediateFieldType.String),
18 new IntermediateFieldDefinition(nameof(ComponentTupleFields.KeyPath), IntermediateFieldType.String), 25 new IntermediateFieldDefinition(nameof(ComponentTupleFields.KeyPath), IntermediateFieldType.String),
26 new IntermediateFieldDefinition(nameof(ComponentTupleFields.KeyPathType), IntermediateFieldType.Number),
19 }, 27 },
20 typeof(ComponentTuple)); 28 typeof(ComponentTuple));
21 } 29 }
@@ -28,9 +36,24 @@ namespace WixToolset.Data.Tuples
28 Component, 36 Component,
29 ComponentId, 37 ComponentId,
30 Directory_, 38 Directory_,
31 Attributes, 39 Location,
40 DisableRegistryReflection,
41 NeverOverwrite,
42 Permanent,
43 SharedDllRefCount,
44 Transitive,
45 UninstallWhenSuperseded,
46 Win64,
32 Condition, 47 Condition,
33 KeyPath, 48 KeyPath,
49 KeyPathType,
50 }
51
52 public enum ComponentLocation
53 {
54 LocalOnly,
55 SourceOnly,
56 Either
34 } 57 }
35 58
36 public class ComponentTuple : IntermediateTuple 59 public class ComponentTuple : IntermediateTuple
@@ -63,10 +86,52 @@ namespace WixToolset.Data.Tuples
63 set => this.Set((int)ComponentTupleFields.Directory_, value); 86 set => this.Set((int)ComponentTupleFields.Directory_, value);
64 } 87 }
65 88
66 public int Attributes 89 public ComponentLocation Location
90 {
91 get => (ComponentLocation)this.Fields[(int)ComponentTupleFields.Location].AsNumber();
92 set => this.Set((int)ComponentTupleFields.Location, (int)value);
93 }
94
95 public bool DisableRegistryReflection
96 {
97 get => this.Fields[(int)ComponentTupleFields.DisableRegistryReflection].AsBool();
98 set => this.Set((int)ComponentTupleFields.DisableRegistryReflection, value);
99 }
100
101 public bool NeverOverwrite
67 { 102 {
68 get => (int)this.Fields[(int)ComponentTupleFields.Attributes]?.Value; 103 get => this.Fields[(int)ComponentTupleFields.NeverOverwrite].AsBool();
69 set => this.Set((int)ComponentTupleFields.Attributes, value); 104 set => this.Set((int)ComponentTupleFields.NeverOverwrite, value);
105 }
106
107 public bool Permanent
108 {
109 get => this.Fields[(int)ComponentTupleFields.Permanent].AsBool();
110 set => this.Set((int)ComponentTupleFields.Permanent, value);
111 }
112
113 public bool SharedDllRefCount
114 {
115 get => this.Fields[(int)ComponentTupleFields.SharedDllRefCount].AsBool();
116 set => this.Set((int)ComponentTupleFields.SharedDllRefCount, value);
117 }
118
119 public bool Transitive
120 {
121 get => this.Fields[(int)ComponentTupleFields.Transitive].AsBool();
122 set => this.Set((int)ComponentTupleFields.Transitive, value);
123 }
124
125 public bool UninstallWhenSuperseded
126 {
127 get => this.Fields[(int)ComponentTupleFields.UninstallWhenSuperseded].AsBool();
128 set => this.Set((int)ComponentTupleFields.UninstallWhenSuperseded, value);
129 }
130
131 public bool Win64
132 {
133 get => this.Fields[(int)ComponentTupleFields.Win64].AsBool();
134 set => this.Set((int)ComponentTupleFields.Win64, value);
70 } 135 }
71 136
72 public string Condition 137 public string Condition
@@ -80,5 +145,11 @@ namespace WixToolset.Data.Tuples
80 get => (string)this.Fields[(int)ComponentTupleFields.KeyPath]?.Value; 145 get => (string)this.Fields[(int)ComponentTupleFields.KeyPath]?.Value;
81 set => this.Set((int)ComponentTupleFields.KeyPath, value); 146 set => this.Set((int)ComponentTupleFields.KeyPath, value);
82 } 147 }
148
149 public ComponentKeyPathType KeyPathType
150 {
151 get => (ComponentKeyPathType)this.Fields[(int)ComponentTupleFields.KeyPathType].AsNumber();
152 set => this.Set((int)ComponentTupleFields.KeyPathType, (int)value);
153 }
83 } 154 }
84} \ No newline at end of file 155} \ No newline at end of file
diff --git a/src/WixToolset.Data/Tuples/ControlTuple.cs b/src/WixToolset.Data/Tuples/ControlTuple.cs
index 82de917c..f77c3689 100644
--- a/src/WixToolset.Data/Tuples/ControlTuple.cs
+++ b/src/WixToolset.Data/Tuples/ControlTuple.cs
@@ -18,10 +18,20 @@ namespace WixToolset.Data
18 new IntermediateFieldDefinition(nameof(ControlTupleFields.Width), IntermediateFieldType.Number), 18 new IntermediateFieldDefinition(nameof(ControlTupleFields.Width), IntermediateFieldType.Number),
19 new IntermediateFieldDefinition(nameof(ControlTupleFields.Height), IntermediateFieldType.Number), 19 new IntermediateFieldDefinition(nameof(ControlTupleFields.Height), IntermediateFieldType.Number),
20 new IntermediateFieldDefinition(nameof(ControlTupleFields.Attributes), IntermediateFieldType.Number), 20 new IntermediateFieldDefinition(nameof(ControlTupleFields.Attributes), IntermediateFieldType.Number),
21 new IntermediateFieldDefinition(nameof(ControlTupleFields.Enabled), IntermediateFieldType.Bool),
22 new IntermediateFieldDefinition(nameof(ControlTupleFields.Indirect), IntermediateFieldType.Bool),
23 new IntermediateFieldDefinition(nameof(ControlTupleFields.Integer), IntermediateFieldType.Bool),
24 new IntermediateFieldDefinition(nameof(ControlTupleFields.LeftScroll), IntermediateFieldType.Bool),
25 new IntermediateFieldDefinition(nameof(ControlTupleFields.RightAligned), IntermediateFieldType.Bool),
26 new IntermediateFieldDefinition(nameof(ControlTupleFields.RightToLeft), IntermediateFieldType.Bool),
27 new IntermediateFieldDefinition(nameof(ControlTupleFields.Sunken), IntermediateFieldType.Bool),
28 new IntermediateFieldDefinition(nameof(ControlTupleFields.Visible), IntermediateFieldType.Bool),
21 new IntermediateFieldDefinition(nameof(ControlTupleFields.Property), IntermediateFieldType.String), 29 new IntermediateFieldDefinition(nameof(ControlTupleFields.Property), IntermediateFieldType.String),
22 new IntermediateFieldDefinition(nameof(ControlTupleFields.Text), IntermediateFieldType.String), 30 new IntermediateFieldDefinition(nameof(ControlTupleFields.Text), IntermediateFieldType.String),
23 new IntermediateFieldDefinition(nameof(ControlTupleFields.Control_Next), IntermediateFieldType.String), 31 new IntermediateFieldDefinition(nameof(ControlTupleFields.Control_Next), IntermediateFieldType.String),
24 new IntermediateFieldDefinition(nameof(ControlTupleFields.Help), IntermediateFieldType.String), 32 new IntermediateFieldDefinition(nameof(ControlTupleFields.Help), IntermediateFieldType.String),
33 new IntermediateFieldDefinition(nameof(ControlTupleFields.TrackDiskSpace), IntermediateFieldType.Bool),
34 new IntermediateFieldDefinition(nameof(ControlTupleFields.SourceFile), IntermediateFieldType.Path),
25 }, 35 },
26 typeof(ControlTuple)); 36 typeof(ControlTuple));
27 } 37 }
@@ -39,10 +49,20 @@ namespace WixToolset.Data.Tuples
39 Width, 49 Width,
40 Height, 50 Height,
41 Attributes, 51 Attributes,
52 Enabled,
53 Indirect,
54 Integer,
55 LeftScroll,
56 RightAligned,
57 RightToLeft,
58 Sunken,
59 Visible,
42 Property, 60 Property,
43 Text, 61 Text,
44 Control_Next, 62 Control_Next,
45 Help, 63 Help,
64 TrackDiskSpace,
65 SourceFile,
46 } 66 }
47 67
48 public class ControlTuple : IntermediateTuple 68 public class ControlTuple : IntermediateTuple
@@ -101,10 +121,149 @@ namespace WixToolset.Data.Tuples
101 121
102 public int Attributes 122 public int Attributes
103 { 123 {
104 get => (int)this.Fields[(int)ControlTupleFields.Attributes]?.Value; 124 get => this.Fields[(int)ControlTupleFields.Attributes].AsNumber();
105 set => this.Set((int)ControlTupleFields.Attributes, value); 125 set => this.Set((int)ControlTupleFields.Attributes, value);
106 } 126 }
107 127
128 public bool Enabled
129 {
130 get => this.Fields[(int)ControlTupleFields.Enabled].AsBool();
131 set => this.Set((int)ControlTupleFields.Enabled, value);
132 }
133
134 public bool Indirect
135 {
136 get => this.Fields[(int)ControlTupleFields.Indirect].AsBool();
137 set => this.Set((int)ControlTupleFields.Indirect, value);
138 }
139
140 public bool Integer
141 {
142 get => this.Fields[(int)ControlTupleFields.Integer].AsBool();
143 set => this.Set((int)ControlTupleFields.Integer, value);
144 }
145 /*
146 /// <summary>PictureButton control</summary>
147 public bool Bitmap
148 {
149 get => this.Fields[(int)ControlTupleFields.Bitmap].AsBool();
150 set => this.Set((int)ControlTupleFields.Bitmap, value);
151 }
152
153 /// <summary>RadioButton control</summary>
154 public bool Border
155 {
156 get => this.Fields[(int)ControlTupleFields.Border].AsBool();
157 set => this.Set((int)ControlTupleFields.Border, value);
158 }
159
160 /// <summary>ListBox and ComboBox control</summary>
161 public bool ComboList
162 {
163 get => this.Fields[(int)ControlTupleFields.ComboList].AsBool();
164 set => this.Set((int)ControlTupleFields.ComboList, value);
165 }
166
167 /// <summary>PushButton control</summary>
168 public bool ElevationShield
169 {
170 get => this.Fields[(int)ControlTupleFields.ElevationShield].AsBool();
171 set => this.Set((int)ControlTupleFields.ElevationShield, value);
172 }
173
174 /// <summary>PictureButton control</summary>
175 public bool FixedSize
176 {
177 get => this.Fields[(int)ControlTupleFields.FixedSize].AsBool();
178 set => this.Set((int)ControlTupleFields.FixedSize, value);
179 }
180
181 /// <summary>PictureButton control</summary>
182 public bool Icon
183 {
184 get => this.Fields[(int)ControlTupleFields.Icon].AsBool();
185 set => this.Set((int)ControlTupleFields.Icon, value);
186 }
187
188 /// <summary>PictureButton control</summary>
189 public bool Icon16
190 {
191 get => this.Fields[(int)ControlTupleFields.Icon16].AsBool();
192 set => this.Set((int)ControlTupleFields.Icon16, value);
193 }
194
195 /// <summary>PictureButton control</summary>
196 public bool Icon32
197 {
198 get => this.Fields[(int)ControlTupleFields.Icon32].AsBool();
199 set => this.Set((int)ControlTupleFields.Icon32, value);
200 }
201
202 /// <summary>PictureButton control</summary>
203 public bool Icon48
204 {
205 get => this.Fields[(int)ControlTupleFields.Icon48].AsBool();
206 set => this.Set((int)ControlTupleFields.Icon48, value);
207 }
208 */
209 public bool LeftScroll
210 {
211 get => this.Fields[(int)ControlTupleFields.LeftScroll].AsBool();
212 set => this.Set((int)ControlTupleFields.LeftScroll, value);
213 }
214 /*
215 /// <summary>PictureButton control</summary>
216 public bool PushLike
217 {
218 get => this.Fields[(int)ControlTupleFields.PushLike].AsBool();
219 set => this.Set((int)ControlTupleFields.PushLike, value);
220 }
221
222 /// <summary>Edit control</summary>
223 public bool Mulitline
224 {
225 get => this.Fields[(int)ControlTupleFields.Mulitline].AsBool();
226 set => this.Set((int)ControlTupleFields.Mulitline, value);
227 }
228 */
229 public bool RightAligned
230 {
231 get => this.Fields[(int)ControlTupleFields.RightAligned].AsBool();
232 set => this.Set((int)ControlTupleFields.RightAligned, value);
233 }
234
235 public bool RightToLeft
236 {
237 get => this.Fields[(int)ControlTupleFields.RightToLeft].AsBool();
238 set => this.Set((int)ControlTupleFields.RightToLeft, value);
239 }
240 /*
241 /// <summary>VolumeCostList control</summary>
242 public bool ShowRollbackCost
243 {
244 get => this.Fields[(int)ControlTupleFields.ShowRollbackCost].AsBool();
245 set => this.Set((int)ControlTupleFields.ShowRollbackCost, value);
246 }
247
248 /// <summary>ListBox and ComboBox control</summary>
249 public bool Sorted
250 {
251 get => this.Fields[(int)ControlTupleFields.Sorted].AsBool();
252 set => this.Set((int)ControlTupleFields.Sorted, value);
253 }
254 */
255 public bool Sunken
256 {
257 get => this.Fields[(int)ControlTupleFields.Sunken].AsBool();
258 set => this.Set((int)ControlTupleFields.Sunken, value);
259 }
260
261 public bool Visible
262 {
263 get => this.Fields[(int)ControlTupleFields.Visible].AsBool();
264 set => this.Set((int)ControlTupleFields.Visible, value);
265 }
266
108 public string Property 267 public string Property
109 { 268 {
110 get => (string)this.Fields[(int)ControlTupleFields.Property]?.Value; 269 get => (string)this.Fields[(int)ControlTupleFields.Property]?.Value;
@@ -128,5 +287,17 @@ namespace WixToolset.Data.Tuples
128 get => (string)this.Fields[(int)ControlTupleFields.Help]?.Value; 287 get => (string)this.Fields[(int)ControlTupleFields.Help]?.Value;
129 set => this.Set((int)ControlTupleFields.Help, value); 288 set => this.Set((int)ControlTupleFields.Help, value);
130 } 289 }
290
291 public bool TrackDiskSpace
292 {
293 get => this.Fields[(int)ControlTupleFields.TrackDiskSpace].AsBool();
294 set => this.Set((int)ControlTupleFields.TrackDiskSpace, value);
295 }
296
297 public string SourceFile
298 {
299 get => (string)this.Fields[(int)ControlTupleFields.SourceFile]?.Value;
300 set => this.Set((int)ControlTupleFields.SourceFile, value);
301 }
131 } 302 }
132} \ No newline at end of file 303} \ No newline at end of file
diff --git a/src/WixToolset.Data/Tuples/CustomActionTuple.cs b/src/WixToolset.Data/Tuples/CustomActionTuple.cs
index a5d8fd46..9c92593a 100644
--- a/src/WixToolset.Data/Tuples/CustomActionTuple.cs
+++ b/src/WixToolset.Data/Tuples/CustomActionTuple.cs
@@ -10,11 +10,18 @@ namespace WixToolset.Data
10 TupleDefinitionType.CustomAction, 10 TupleDefinitionType.CustomAction,
11 new[] 11 new[]
12 { 12 {
13 new IntermediateFieldDefinition(nameof(CustomActionTupleFields.Action), IntermediateFieldType.String), 13 new IntermediateFieldDefinition(nameof(CustomActionTupleFields.ExecutionType), IntermediateFieldType.Number),
14 new IntermediateFieldDefinition(nameof(CustomActionTupleFields.Type), IntermediateFieldType.Number),
15 new IntermediateFieldDefinition(nameof(CustomActionTupleFields.Source), IntermediateFieldType.String), 14 new IntermediateFieldDefinition(nameof(CustomActionTupleFields.Source), IntermediateFieldType.String),
15 new IntermediateFieldDefinition(nameof(CustomActionTupleFields.SourceType), IntermediateFieldType.Number),
16 new IntermediateFieldDefinition(nameof(CustomActionTupleFields.Target), IntermediateFieldType.String), 16 new IntermediateFieldDefinition(nameof(CustomActionTupleFields.Target), IntermediateFieldType.String),
17 new IntermediateFieldDefinition(nameof(CustomActionTupleFields.ExtendedType), IntermediateFieldType.Number), 17 new IntermediateFieldDefinition(nameof(CustomActionTupleFields.TargetType), IntermediateFieldType.Number),
18 new IntermediateFieldDefinition(nameof(CustomActionTupleFields.Async), IntermediateFieldType.Bool),
19 new IntermediateFieldDefinition(nameof(CustomActionTupleFields.Hidden), IntermediateFieldType.Bool),
20 new IntermediateFieldDefinition(nameof(CustomActionTupleFields.IgnoreResult), IntermediateFieldType.Bool),
21 new IntermediateFieldDefinition(nameof(CustomActionTupleFields.Impersonate), IntermediateFieldType.Bool),
22 new IntermediateFieldDefinition(nameof(CustomActionTupleFields.PatchUninstall), IntermediateFieldType.Bool),
23 new IntermediateFieldDefinition(nameof(CustomActionTupleFields.TSAware), IntermediateFieldType.Bool),
24 new IntermediateFieldDefinition(nameof(CustomActionTupleFields.Win64), IntermediateFieldType.Bool),
18 }, 25 },
19 typeof(CustomActionTuple)); 26 typeof(CustomActionTuple));
20 } 27 }
@@ -24,11 +31,46 @@ namespace WixToolset.Data.Tuples
24{ 31{
25 public enum CustomActionTupleFields 32 public enum CustomActionTupleFields
26 { 33 {
27 Action, 34 ExecutionType,
28 Type,
29 Source, 35 Source,
36 SourceType,
30 Target, 37 Target,
31 ExtendedType, 38 TargetType,
39 Async,
40 Hidden,
41 IgnoreResult,
42 Impersonate,
43 PatchUninstall,
44 TSAware,
45 Win64,
46 }
47
48 public enum CustomActionExecutionType
49 {
50 Immediate,
51 FirstSequence = 256,
52 OncePerProcess = 512,
53 ClientRepeat = 768,
54 Deferred = 1024,
55 Rollback = 1280,
56 Commit = 1536,
57 }
58
59 public enum CustomActionSourceType
60 {
61 Binary,
62 File = 0x10,
63 Directory = 0x20,
64 Property = 0x30,
65 }
66
67 public enum CustomActionTargetType
68 {
69 Dll = 1,
70 Exe = 2,
71 TextData = 3,
72 JScript = 5,
73 VBScript = 6,
32 } 74 }
33 75
34 public class CustomActionTuple : IntermediateTuple 76 public class CustomActionTuple : IntermediateTuple
@@ -43,16 +85,10 @@ namespace WixToolset.Data.Tuples
43 85
44 public IntermediateField this[CustomActionTupleFields index] => this.Fields[(int)index]; 86 public IntermediateField this[CustomActionTupleFields index] => this.Fields[(int)index];
45 87
46 public string Action 88 public CustomActionExecutionType ExecutionType
47 { 89 {
48 get => (string)this.Fields[(int)CustomActionTupleFields.Action]?.Value; 90 get => (CustomActionExecutionType)this.Fields[(int)CustomActionTupleFields.ExecutionType].AsNumber();
49 set => this.Set((int)CustomActionTupleFields.Action, value); 91 set => this.Set((int)CustomActionTupleFields.ExecutionType, (int)value);
50 }
51
52 public int Type
53 {
54 get => (int)this.Fields[(int)CustomActionTupleFields.Type]?.Value;
55 set => this.Set((int)CustomActionTupleFields.Type, value);
56 } 92 }
57 93
58 public string Source 94 public string Source
@@ -61,16 +97,64 @@ namespace WixToolset.Data.Tuples
61 set => this.Set((int)CustomActionTupleFields.Source, value); 97 set => this.Set((int)CustomActionTupleFields.Source, value);
62 } 98 }
63 99
100 public CustomActionSourceType SourceType
101 {
102 get => (CustomActionSourceType)this.Fields[(int)CustomActionTupleFields.SourceType].AsNumber();
103 set => this.Set((int)CustomActionTupleFields.SourceType, (int)value);
104 }
105
64 public string Target 106 public string Target
65 { 107 {
66 get => (string)this.Fields[(int)CustomActionTupleFields.Target]?.Value; 108 get => (string)this.Fields[(int)CustomActionTupleFields.Target]?.Value;
67 set => this.Set((int)CustomActionTupleFields.Target, value); 109 set => this.Set((int)CustomActionTupleFields.Target, value);
68 } 110 }
69 111
70 public int ExtendedType 112 public CustomActionTargetType TargetType
113 {
114 get => (CustomActionTargetType)this.Fields[(int)CustomActionTupleFields.TargetType].AsNumber();
115 set => this.Set((int)CustomActionTupleFields.TargetType, (int)value);
116 }
117
118 public bool Async
119 {
120 get => this.Fields[(int)CustomActionTupleFields.Async].AsBool();
121 set => this.Set((int)CustomActionTupleFields.Async, value);
122 }
123
124 public bool Hidden
125 {
126 get => this.Fields[(int)CustomActionTupleFields.Hidden].AsBool();
127 set => this.Set((int)CustomActionTupleFields.Hidden, value);
128 }
129
130 public bool IgnoreResult
131 {
132 get => this.Fields[(int)CustomActionTupleFields.IgnoreResult].AsBool();
133 set => this.Set((int)CustomActionTupleFields.IgnoreResult, value);
134 }
135
136 public bool Impersonate
137 {
138 get => this.Fields[(int)CustomActionTupleFields.Impersonate].AsBool();
139 set => this.Set((int)CustomActionTupleFields.Impersonate, value);
140 }
141
142 public bool PatchUninstall
143 {
144 get => this.Fields[(int)CustomActionTupleFields.PatchUninstall].AsBool();
145 set => this.Set((int)CustomActionTupleFields.PatchUninstall, value);
146 }
147
148 public bool TSAware
149 {
150 get => this.Fields[(int)CustomActionTupleFields.TSAware].AsBool();
151 set => this.Set((int)CustomActionTupleFields.TSAware, value);
152 }
153
154 public bool Win64
71 { 155 {
72 get => (int)this.Fields[(int)CustomActionTupleFields.ExtendedType]?.Value; 156 get => this.Fields[(int)CustomActionTupleFields.Win64].AsBool();
73 set => this.Set((int)CustomActionTupleFields.ExtendedType, value); 157 set => this.Set((int)CustomActionTupleFields.Win64, value);
74 } 158 }
75 } 159 }
76} \ No newline at end of file 160} \ No newline at end of file
diff --git a/src/WixToolset.Data/Tuples/DialogTuple.cs b/src/WixToolset.Data/Tuples/DialogTuple.cs
index b8bb2361..d66c3b19 100644
--- a/src/WixToolset.Data/Tuples/DialogTuple.cs
+++ b/src/WixToolset.Data/Tuples/DialogTuple.cs
@@ -10,12 +10,21 @@ namespace WixToolset.Data
10 TupleDefinitionType.Dialog, 10 TupleDefinitionType.Dialog,
11 new[] 11 new[]
12 { 12 {
13 new IntermediateFieldDefinition(nameof(DialogTupleFields.Dialog), IntermediateFieldType.String),
14 new IntermediateFieldDefinition(nameof(DialogTupleFields.HCentering), IntermediateFieldType.Number), 13 new IntermediateFieldDefinition(nameof(DialogTupleFields.HCentering), IntermediateFieldType.Number),
15 new IntermediateFieldDefinition(nameof(DialogTupleFields.VCentering), IntermediateFieldType.Number), 14 new IntermediateFieldDefinition(nameof(DialogTupleFields.VCentering), IntermediateFieldType.Number),
16 new IntermediateFieldDefinition(nameof(DialogTupleFields.Width), IntermediateFieldType.Number), 15 new IntermediateFieldDefinition(nameof(DialogTupleFields.Width), IntermediateFieldType.Number),
17 new IntermediateFieldDefinition(nameof(DialogTupleFields.Height), IntermediateFieldType.Number), 16 new IntermediateFieldDefinition(nameof(DialogTupleFields.Height), IntermediateFieldType.Number),
18 new IntermediateFieldDefinition(nameof(DialogTupleFields.Attributes), IntermediateFieldType.Number), 17 new IntermediateFieldDefinition(nameof(DialogTupleFields.CustomPalette), IntermediateFieldType.Bool),
18 new IntermediateFieldDefinition(nameof(DialogTupleFields.ErrorDialog), IntermediateFieldType.Bool),
19 new IntermediateFieldDefinition(nameof(DialogTupleFields.Visible), IntermediateFieldType.Bool),
20 new IntermediateFieldDefinition(nameof(DialogTupleFields.Modal), IntermediateFieldType.Bool),
21 new IntermediateFieldDefinition(nameof(DialogTupleFields.KeepModeless), IntermediateFieldType.Bool),
22 new IntermediateFieldDefinition(nameof(DialogTupleFields.LeftScroll), IntermediateFieldType.Bool),
23 new IntermediateFieldDefinition(nameof(DialogTupleFields.Minimize), IntermediateFieldType.Bool),
24 new IntermediateFieldDefinition(nameof(DialogTupleFields.RightAligned), IntermediateFieldType.Bool),
25 new IntermediateFieldDefinition(nameof(DialogTupleFields.RightToLeft), IntermediateFieldType.Bool),
26 new IntermediateFieldDefinition(nameof(DialogTupleFields.SystemModal), IntermediateFieldType.Bool),
27 new IntermediateFieldDefinition(nameof(DialogTupleFields.TrackDiskSpace), IntermediateFieldType.Bool),
19 new IntermediateFieldDefinition(nameof(DialogTupleFields.Title), IntermediateFieldType.String), 28 new IntermediateFieldDefinition(nameof(DialogTupleFields.Title), IntermediateFieldType.String),
20 new IntermediateFieldDefinition(nameof(DialogTupleFields.Control_First), IntermediateFieldType.String), 29 new IntermediateFieldDefinition(nameof(DialogTupleFields.Control_First), IntermediateFieldType.String),
21 new IntermediateFieldDefinition(nameof(DialogTupleFields.Control_Default), IntermediateFieldType.String), 30 new IntermediateFieldDefinition(nameof(DialogTupleFields.Control_Default), IntermediateFieldType.String),
@@ -29,12 +38,21 @@ namespace WixToolset.Data.Tuples
29{ 38{
30 public enum DialogTupleFields 39 public enum DialogTupleFields
31 { 40 {
32 Dialog,
33 HCentering, 41 HCentering,
34 VCentering, 42 VCentering,
35 Width, 43 Width,
36 Height, 44 Height,
37 Attributes, 45 CustomPalette,
46 ErrorDialog,
47 Visible,
48 Modal,
49 KeepModeless,
50 LeftScroll,
51 Minimize,
52 RightAligned,
53 RightToLeft,
54 SystemModal,
55 TrackDiskSpace,
38 Title, 56 Title,
39 Control_First, 57 Control_First,
40 Control_Default, 58 Control_Default,
@@ -53,12 +71,6 @@ namespace WixToolset.Data.Tuples
53 71
54 public IntermediateField this[DialogTupleFields index] => this.Fields[(int)index]; 72 public IntermediateField this[DialogTupleFields index] => this.Fields[(int)index];
55 73
56 public string Dialog
57 {
58 get => (string)this.Fields[(int)DialogTupleFields.Dialog]?.Value;
59 set => this.Set((int)DialogTupleFields.Dialog, value);
60 }
61
62 public int HCentering 74 public int HCentering
63 { 75 {
64 get => (int)this.Fields[(int)DialogTupleFields.HCentering]?.Value; 76 get => (int)this.Fields[(int)DialogTupleFields.HCentering]?.Value;
@@ -83,10 +95,70 @@ namespace WixToolset.Data.Tuples
83 set => this.Set((int)DialogTupleFields.Height, value); 95 set => this.Set((int)DialogTupleFields.Height, value);
84 } 96 }
85 97
86 public int Attributes 98 public bool CustomPalette
99 {
100 get => this.Fields[(int)DialogTupleFields.CustomPalette].AsBool();
101 set => this.Set((int)DialogTupleFields.CustomPalette, value);
102 }
103
104 public bool ErrorDialog
105 {
106 get => this.Fields[(int)DialogTupleFields.ErrorDialog].AsBool();
107 set => this.Set((int)DialogTupleFields.ErrorDialog, value);
108 }
109
110 public bool Visible
111 {
112 get => this.Fields[(int)DialogTupleFields.Visible].AsBool();
113 set => this.Set((int)DialogTupleFields.Visible, value);
114 }
115
116 public bool Modal
117 {
118 get => this.Fields[(int)DialogTupleFields.Modal].AsBool();
119 set => this.Set((int)DialogTupleFields.Modal, value);
120 }
121
122 public bool KeepModeless
123 {
124 get => this.Fields[(int)DialogTupleFields.KeepModeless].AsBool();
125 set => this.Set((int)DialogTupleFields.KeepModeless, value);
126 }
127
128 public bool LeftScroll
129 {
130 get => this.Fields[(int)DialogTupleFields.LeftScroll].AsBool();
131 set => this.Set((int)DialogTupleFields.LeftScroll, value);
132 }
133
134 public bool Minimize
135 {
136 get => this.Fields[(int)DialogTupleFields.Minimize].AsBool();
137 set => this.Set((int)DialogTupleFields.Minimize, value);
138 }
139
140 public bool RightAligned
141 {
142 get => this.Fields[(int)DialogTupleFields.RightAligned].AsBool();
143 set => this.Set((int)DialogTupleFields.RightAligned, value);
144 }
145
146 public bool RightToLeft
147 {
148 get => this.Fields[(int)DialogTupleFields.RightToLeft].AsBool();
149 set => this.Set((int)DialogTupleFields.RightToLeft, value);
150 }
151
152 public bool TrackDiskSpace
153 {
154 get => this.Fields[(int)DialogTupleFields.TrackDiskSpace].AsBool();
155 set => this.Set((int)DialogTupleFields.TrackDiskSpace, value);
156 }
157
158 public bool SystemModal
87 { 159 {
88 get => (int)this.Fields[(int)DialogTupleFields.Attributes]?.Value; 160 get => this.Fields[(int)DialogTupleFields.SystemModal].AsBool();
89 set => this.Set((int)DialogTupleFields.Attributes, value); 161 set => this.Set((int)DialogTupleFields.SystemModal, value);
90 } 162 }
91 163
92 public string Title 164 public string Title
diff --git a/src/WixToolset.Data/Tuples/EnvironmentTuple.cs b/src/WixToolset.Data/Tuples/EnvironmentTuple.cs
index 9ee05a19..7e3443d8 100644
--- a/src/WixToolset.Data/Tuples/EnvironmentTuple.cs
+++ b/src/WixToolset.Data/Tuples/EnvironmentTuple.cs
@@ -10,9 +10,13 @@ namespace WixToolset.Data
10 TupleDefinitionType.Environment, 10 TupleDefinitionType.Environment,
11 new[] 11 new[]
12 { 12 {
13 new IntermediateFieldDefinition(nameof(EnvironmentTupleFields.Environment), IntermediateFieldType.String),
14 new IntermediateFieldDefinition(nameof(EnvironmentTupleFields.Name), IntermediateFieldType.String), 13 new IntermediateFieldDefinition(nameof(EnvironmentTupleFields.Name), IntermediateFieldType.String),
15 new IntermediateFieldDefinition(nameof(EnvironmentTupleFields.Value), IntermediateFieldType.String), 14 new IntermediateFieldDefinition(nameof(EnvironmentTupleFields.Value), IntermediateFieldType.String),
15 new IntermediateFieldDefinition(nameof(EnvironmentTupleFields.Separator), IntermediateFieldType.String),
16 new IntermediateFieldDefinition(nameof(EnvironmentTupleFields.Action), IntermediateFieldType.Number),
17 new IntermediateFieldDefinition(nameof(EnvironmentTupleFields.Part), IntermediateFieldType.Number),
18 new IntermediateFieldDefinition(nameof(EnvironmentTupleFields.Permanent), IntermediateFieldType.Bool),
19 new IntermediateFieldDefinition(nameof(EnvironmentTupleFields.System), IntermediateFieldType.Bool),
16 new IntermediateFieldDefinition(nameof(EnvironmentTupleFields.Component_), IntermediateFieldType.String), 20 new IntermediateFieldDefinition(nameof(EnvironmentTupleFields.Component_), IntermediateFieldType.String),
17 }, 21 },
18 typeof(EnvironmentTuple)); 22 typeof(EnvironmentTuple));
@@ -23,12 +27,30 @@ namespace WixToolset.Data.Tuples
23{ 27{
24 public enum EnvironmentTupleFields 28 public enum EnvironmentTupleFields
25 { 29 {
26 Environment,
27 Name, 30 Name,
28 Value, 31 Value,
32 Separator,
33 Action,
34 Part,
35 Permanent,
36 System,
29 Component_, 37 Component_,
30 } 38 }
31 39
40 public enum EnvironmentActionType
41 {
42 Set,
43 Create,
44 Remove
45 }
46
47 public enum EnvironmentPartType
48 {
49 All,
50 First,
51 Last
52 }
53
32 public class EnvironmentTuple : IntermediateTuple 54 public class EnvironmentTuple : IntermediateTuple
33 { 55 {
34 public EnvironmentTuple() : base(TupleDefinitions.Environment, null, null) 56 public EnvironmentTuple() : base(TupleDefinitions.Environment, null, null)
@@ -41,12 +63,6 @@ namespace WixToolset.Data.Tuples
41 63
42 public IntermediateField this[EnvironmentTupleFields index] => this.Fields[(int)index]; 64 public IntermediateField this[EnvironmentTupleFields index] => this.Fields[(int)index];
43 65
44 public string Environment
45 {
46 get => (string)this.Fields[(int)EnvironmentTupleFields.Environment]?.Value;
47 set => this.Set((int)EnvironmentTupleFields.Environment, value);
48 }
49
50 public string Name 66 public string Name
51 { 67 {
52 get => (string)this.Fields[(int)EnvironmentTupleFields.Name]?.Value; 68 get => (string)this.Fields[(int)EnvironmentTupleFields.Name]?.Value;
@@ -59,6 +75,36 @@ namespace WixToolset.Data.Tuples
59 set => this.Set((int)EnvironmentTupleFields.Value, value); 75 set => this.Set((int)EnvironmentTupleFields.Value, value);
60 } 76 }
61 77
78 public string Separator
79 {
80 get => (string)this.Fields[(int)EnvironmentTupleFields.Separator]?.Value;
81 set => this.Set((int)EnvironmentTupleFields.Separator, value);
82 }
83
84 public EnvironmentActionType? Action
85 {
86 get => (EnvironmentActionType?)this.Fields[(int)EnvironmentTupleFields.Action].AsNullableNumber();
87 set => this.Set((int)EnvironmentTupleFields.Action, (int)value);
88 }
89
90 public EnvironmentPartType? Part
91 {
92 get => (EnvironmentPartType?)this.Fields[(int)EnvironmentTupleFields.Part].AsNullableNumber();
93 set => this.Set((int)EnvironmentTupleFields.Part, (int)value);
94 }
95
96 public bool Permanent
97 {
98 get => this.Fields[(int)EnvironmentTupleFields.Permanent].AsBool();
99 set => this.Set((int)EnvironmentTupleFields.Permanent, value);
100 }
101
102 public bool System
103 {
104 get => this.Fields[(int)EnvironmentTupleFields.System].AsBool();
105 set => this.Set((int)EnvironmentTupleFields.System, value);
106 }
107
62 public string Component_ 108 public string Component_
63 { 109 {
64 get => (string)this.Fields[(int)EnvironmentTupleFields.Component_]?.Value; 110 get => (string)this.Fields[(int)EnvironmentTupleFields.Component_]?.Value;
diff --git a/src/WixToolset.Data/Tuples/FeatureTuple.cs b/src/WixToolset.Data/Tuples/FeatureTuple.cs
index a04c339b..c3b0e67a 100644
--- a/src/WixToolset.Data/Tuples/FeatureTuple.cs
+++ b/src/WixToolset.Data/Tuples/FeatureTuple.cs
@@ -10,14 +10,16 @@ namespace WixToolset.Data
10 TupleDefinitionType.Feature, 10 TupleDefinitionType.Feature,
11 new[] 11 new[]
12 { 12 {
13 new IntermediateFieldDefinition(nameof(FeatureTupleFields.Feature), IntermediateFieldType.String),
14 new IntermediateFieldDefinition(nameof(FeatureTupleFields.Feature_Parent), IntermediateFieldType.String), 13 new IntermediateFieldDefinition(nameof(FeatureTupleFields.Feature_Parent), IntermediateFieldType.String),
15 new IntermediateFieldDefinition(nameof(FeatureTupleFields.Title), IntermediateFieldType.String), 14 new IntermediateFieldDefinition(nameof(FeatureTupleFields.Title), IntermediateFieldType.String),
16 new IntermediateFieldDefinition(nameof(FeatureTupleFields.Description), IntermediateFieldType.String), 15 new IntermediateFieldDefinition(nameof(FeatureTupleFields.Description), IntermediateFieldType.String),
17 new IntermediateFieldDefinition(nameof(FeatureTupleFields.Display), IntermediateFieldType.Number), 16 new IntermediateFieldDefinition(nameof(FeatureTupleFields.Display), IntermediateFieldType.Number),
18 new IntermediateFieldDefinition(nameof(FeatureTupleFields.Level), IntermediateFieldType.Number), 17 new IntermediateFieldDefinition(nameof(FeatureTupleFields.Level), IntermediateFieldType.Number),
19 new IntermediateFieldDefinition(nameof(FeatureTupleFields.Directory_), IntermediateFieldType.String), 18 new IntermediateFieldDefinition(nameof(FeatureTupleFields.Directory_), IntermediateFieldType.String),
20 new IntermediateFieldDefinition(nameof(FeatureTupleFields.Attributes), IntermediateFieldType.Number), 19 new IntermediateFieldDefinition(nameof(FeatureTupleFields.DisallowAbsent), IntermediateFieldType.Bool),
20 new IntermediateFieldDefinition(nameof(FeatureTupleFields.DisallowAdvertise), IntermediateFieldType.Bool),
21 new IntermediateFieldDefinition(nameof(FeatureTupleFields.InstallDefault), IntermediateFieldType.Number),
22 new IntermediateFieldDefinition(nameof(FeatureTupleFields.TypicalDefault), IntermediateFieldType.Number),
21 }, 23 },
22 typeof(FeatureTuple)); 24 typeof(FeatureTuple));
23 } 25 }
@@ -27,14 +29,29 @@ namespace WixToolset.Data.Tuples
27{ 29{
28 public enum FeatureTupleFields 30 public enum FeatureTupleFields
29 { 31 {
30 Feature,
31 Feature_Parent, 32 Feature_Parent,
32 Title, 33 Title,
33 Description, 34 Description,
34 Display, 35 Display,
35 Level, 36 Level,
36 Directory_, 37 Directory_,
37 Attributes, 38 DisallowAbsent,
39 DisallowAdvertise,
40 InstallDefault,
41 TypicalDefault,
42 }
43
44 public enum FeatureInstallDefault
45 {
46 Local,
47 Source,
48 FollowParent,
49 }
50
51 public enum FeatureTypicalDefault
52 {
53 Install,
54 Advertise
38 } 55 }
39 56
40 public class FeatureTuple : IntermediateTuple 57 public class FeatureTuple : IntermediateTuple
@@ -49,12 +66,6 @@ namespace WixToolset.Data.Tuples
49 66
50 public IntermediateField this[FeatureTupleFields index] => this.Fields[(int)index]; 67 public IntermediateField this[FeatureTupleFields index] => this.Fields[(int)index];
51 68
52 public string Feature
53 {
54 get => (string)this.Fields[(int)FeatureTupleFields.Feature]?.Value;
55 set => this.Set((int)FeatureTupleFields.Feature, value);
56 }
57
58 public string Feature_Parent 69 public string Feature_Parent
59 { 70 {
60 get => (string)this.Fields[(int)FeatureTupleFields.Feature_Parent]?.Value; 71 get => (string)this.Fields[(int)FeatureTupleFields.Feature_Parent]?.Value;
@@ -91,10 +102,28 @@ namespace WixToolset.Data.Tuples
91 set => this.Set((int)FeatureTupleFields.Directory_, value); 102 set => this.Set((int)FeatureTupleFields.Directory_, value);
92 } 103 }
93 104
94 public int Attributes 105 public bool DisallowAbsent
106 {
107 get => this.Fields[(int)FeatureTupleFields.DisallowAbsent].AsBool();
108 set => this.Set((int)FeatureTupleFields.DisallowAbsent, value);
109 }
110
111 public bool DisallowAdvertise
112 {
113 get => this.Fields[(int)FeatureTupleFields.DisallowAdvertise].AsBool();
114 set => this.Set((int)FeatureTupleFields.DisallowAdvertise, value);
115 }
116
117 public FeatureInstallDefault InstallDefault
118 {
119 get => (FeatureInstallDefault)this.Fields[(int)FeatureTupleFields.InstallDefault].AsNumber();
120 set => this.Set((int)FeatureTupleFields.InstallDefault, (int)value);
121 }
122
123 public FeatureTypicalDefault TypicalDefault
95 { 124 {
96 get => (int)this.Fields[(int)FeatureTupleFields.Attributes]?.Value; 125 get => (FeatureTypicalDefault)this.Fields[(int)FeatureTupleFields.TypicalDefault].AsNumber();
97 set => this.Set((int)FeatureTupleFields.Attributes, value); 126 set => this.Set((int)FeatureTupleFields.TypicalDefault, (int)value);
98 } 127 }
99 } 128 }
100} \ No newline at end of file 129} \ No newline at end of file
diff --git a/src/WixToolset.Data/Tuples/IniFileTuple.cs b/src/WixToolset.Data/Tuples/IniFileTuple.cs
index 29fb3264..bae28817 100644
--- a/src/WixToolset.Data/Tuples/IniFileTuple.cs
+++ b/src/WixToolset.Data/Tuples/IniFileTuple.cs
@@ -10,7 +10,6 @@ namespace WixToolset.Data
10 TupleDefinitionType.IniFile, 10 TupleDefinitionType.IniFile,
11 new[] 11 new[]
12 { 12 {
13 new IntermediateFieldDefinition(nameof(IniFileTupleFields.IniFile), IntermediateFieldType.String),
14 new IntermediateFieldDefinition(nameof(IniFileTupleFields.FileName), IntermediateFieldType.String), 13 new IntermediateFieldDefinition(nameof(IniFileTupleFields.FileName), IntermediateFieldType.String),
15 new IntermediateFieldDefinition(nameof(IniFileTupleFields.DirProperty), IntermediateFieldType.String), 14 new IntermediateFieldDefinition(nameof(IniFileTupleFields.DirProperty), IntermediateFieldType.String),
16 new IntermediateFieldDefinition(nameof(IniFileTupleFields.Section), IntermediateFieldType.String), 15 new IntermediateFieldDefinition(nameof(IniFileTupleFields.Section), IntermediateFieldType.String),
@@ -27,7 +26,6 @@ namespace WixToolset.Data.Tuples
27{ 26{
28 public enum IniFileTupleFields 27 public enum IniFileTupleFields
29 { 28 {
30 IniFile,
31 FileName, 29 FileName,
32 DirProperty, 30 DirProperty,
33 Section, 31 Section,
@@ -49,12 +47,6 @@ namespace WixToolset.Data.Tuples
49 47
50 public IntermediateField this[IniFileTupleFields index] => this.Fields[(int)index]; 48 public IntermediateField this[IniFileTupleFields index] => this.Fields[(int)index];
51 49
52 public string IniFile
53 {
54 get => (string)this.Fields[(int)IniFileTupleFields.IniFile]?.Value;
55 set => this.Set((int)IniFileTupleFields.IniFile, value);
56 }
57
58 public string FileName 50 public string FileName
59 { 51 {
60 get => (string)this.Fields[(int)IniFileTupleFields.FileName]?.Value; 52 get => (string)this.Fields[(int)IniFileTupleFields.FileName]?.Value;
@@ -85,10 +77,10 @@ namespace WixToolset.Data.Tuples
85 set => this.Set((int)IniFileTupleFields.Value, value); 77 set => this.Set((int)IniFileTupleFields.Value, value);
86 } 78 }
87 79
88 public int Action 80 public InifFileActionType Action
89 { 81 {
90 get => (int)this.Fields[(int)IniFileTupleFields.Action]?.Value; 82 get => (InifFileActionType)this.Fields[(int)IniFileTupleFields.Action]?.AsNumber();
91 set => this.Set((int)IniFileTupleFields.Action, value); 83 set => this.Set((int)IniFileTupleFields.Action, (int)value);
92 } 84 }
93 85
94 public string Component_ 86 public string Component_
diff --git a/src/WixToolset.Data/Tuples/InifFileActionType.cs b/src/WixToolset.Data/Tuples/InifFileActionType.cs
new file mode 100644
index 00000000..94172f47
--- /dev/null
+++ b/src/WixToolset.Data/Tuples/InifFileActionType.cs
@@ -0,0 +1,13 @@
1// Copyright (c) .NET Foundation and contributors. All rights reserved. Licensed under the Microsoft Reciprocal License. See LICENSE.TXT file in the project root for full license information.
2
3namespace WixToolset.Data.Tuples
4{
5 public enum InifFileActionType
6 {
7 AddLine,
8 AddTag,
9 CreateLine,
10 RemoveLine,
11 RemoveTag,
12 }
13} \ No newline at end of file
diff --git a/src/WixToolset.Data/Tuples/LocatorType.cs b/src/WixToolset.Data/Tuples/LocatorType.cs
new file mode 100644
index 00000000..18f5ada0
--- /dev/null
+++ b/src/WixToolset.Data/Tuples/LocatorType.cs
@@ -0,0 +1,12 @@
1// Copyright (c) .NET Foundation and contributors. All rights reserved. Licensed under the Microsoft Reciprocal License. See LICENSE.TXT file in the project root for full license information.
2
3namespace WixToolset.Data.Tuples
4{
5 public enum LocatorType
6 {
7 Directory,
8 Filename,
9 RawValue,
10 x64 = 16,
11 }
12}
diff --git a/src/WixToolset.Data/Tuples/ModuleConfigurationTuple.cs b/src/WixToolset.Data/Tuples/ModuleConfigurationTuple.cs
index b3c4cd7f..a1c2a777 100644
--- a/src/WixToolset.Data/Tuples/ModuleConfigurationTuple.cs
+++ b/src/WixToolset.Data/Tuples/ModuleConfigurationTuple.cs
@@ -10,12 +10,12 @@ namespace WixToolset.Data
10 TupleDefinitionType.ModuleConfiguration, 10 TupleDefinitionType.ModuleConfiguration,
11 new[] 11 new[]
12 { 12 {
13 new IntermediateFieldDefinition(nameof(ModuleConfigurationTupleFields.Name), IntermediateFieldType.String),
14 new IntermediateFieldDefinition(nameof(ModuleConfigurationTupleFields.Format), IntermediateFieldType.Number), 13 new IntermediateFieldDefinition(nameof(ModuleConfigurationTupleFields.Format), IntermediateFieldType.Number),
15 new IntermediateFieldDefinition(nameof(ModuleConfigurationTupleFields.Type), IntermediateFieldType.String), 14 new IntermediateFieldDefinition(nameof(ModuleConfigurationTupleFields.Type), IntermediateFieldType.String),
16 new IntermediateFieldDefinition(nameof(ModuleConfigurationTupleFields.ContextData), IntermediateFieldType.String), 15 new IntermediateFieldDefinition(nameof(ModuleConfigurationTupleFields.ContextData), IntermediateFieldType.String),
17 new IntermediateFieldDefinition(nameof(ModuleConfigurationTupleFields.DefaultValue), IntermediateFieldType.String), 16 new IntermediateFieldDefinition(nameof(ModuleConfigurationTupleFields.DefaultValue), IntermediateFieldType.String),
18 new IntermediateFieldDefinition(nameof(ModuleConfigurationTupleFields.Attributes), IntermediateFieldType.Number), 17 new IntermediateFieldDefinition(nameof(ModuleConfigurationTupleFields.KeyNoOrphan), IntermediateFieldType.Bool),
18 new IntermediateFieldDefinition(nameof(ModuleConfigurationTupleFields.NonNullable), IntermediateFieldType.Bool),
19 new IntermediateFieldDefinition(nameof(ModuleConfigurationTupleFields.DisplayName), IntermediateFieldType.String), 19 new IntermediateFieldDefinition(nameof(ModuleConfigurationTupleFields.DisplayName), IntermediateFieldType.String),
20 new IntermediateFieldDefinition(nameof(ModuleConfigurationTupleFields.Description), IntermediateFieldType.String), 20 new IntermediateFieldDefinition(nameof(ModuleConfigurationTupleFields.Description), IntermediateFieldType.String),
21 new IntermediateFieldDefinition(nameof(ModuleConfigurationTupleFields.HelpLocation), IntermediateFieldType.String), 21 new IntermediateFieldDefinition(nameof(ModuleConfigurationTupleFields.HelpLocation), IntermediateFieldType.String),
@@ -29,12 +29,12 @@ namespace WixToolset.Data.Tuples
29{ 29{
30 public enum ModuleConfigurationTupleFields 30 public enum ModuleConfigurationTupleFields
31 { 31 {
32 Name,
33 Format, 32 Format,
34 Type, 33 Type,
35 ContextData, 34 ContextData,
36 DefaultValue, 35 DefaultValue,
37 Attributes, 36 KeyNoOrphan,
37 NonNullable,
38 DisplayName, 38 DisplayName,
39 Description, 39 Description,
40 HelpLocation, 40 HelpLocation,
@@ -53,12 +53,6 @@ namespace WixToolset.Data.Tuples
53 53
54 public IntermediateField this[ModuleConfigurationTupleFields index] => this.Fields[(int)index]; 54 public IntermediateField this[ModuleConfigurationTupleFields index] => this.Fields[(int)index];
55 55
56 public string Name
57 {
58 get => (string)this.Fields[(int)ModuleConfigurationTupleFields.Name]?.Value;
59 set => this.Set((int)ModuleConfigurationTupleFields.Name, value);
60 }
61
62 public int Format 56 public int Format
63 { 57 {
64 get => (int)this.Fields[(int)ModuleConfigurationTupleFields.Format]?.Value; 58 get => (int)this.Fields[(int)ModuleConfigurationTupleFields.Format]?.Value;
@@ -83,10 +77,16 @@ namespace WixToolset.Data.Tuples
83 set => this.Set((int)ModuleConfigurationTupleFields.DefaultValue, value); 77 set => this.Set((int)ModuleConfigurationTupleFields.DefaultValue, value);
84 } 78 }
85 79
86 public int Attributes 80 public bool KeyNoOrphan
81 {
82 get => this.Fields[(int)ModuleConfigurationTupleFields.KeyNoOrphan].AsBool();
83 set => this.Set((int)ModuleConfigurationTupleFields.KeyNoOrphan, value);
84 }
85
86 public bool NonNullable
87 { 87 {
88 get => (int)this.Fields[(int)ModuleConfigurationTupleFields.Attributes]?.Value; 88 get => this.Fields[(int)ModuleConfigurationTupleFields.NonNullable].AsBool();
89 set => this.Set((int)ModuleConfigurationTupleFields.Attributes, value); 89 set => this.Set((int)ModuleConfigurationTupleFields.NonNullable, value);
90 } 90 }
91 91
92 public string DisplayName 92 public string DisplayName
diff --git a/src/WixToolset.Data/Tuples/MsiEmbeddedUITuple.cs b/src/WixToolset.Data/Tuples/MsiEmbeddedUITuple.cs
index 82deb53a..b58f2c1a 100644
--- a/src/WixToolset.Data/Tuples/MsiEmbeddedUITuple.cs
+++ b/src/WixToolset.Data/Tuples/MsiEmbeddedUITuple.cs
@@ -10,11 +10,11 @@ namespace WixToolset.Data
10 TupleDefinitionType.MsiEmbeddedUI, 10 TupleDefinitionType.MsiEmbeddedUI,
11 new[] 11 new[]
12 { 12 {
13 new IntermediateFieldDefinition(nameof(MsiEmbeddedUITupleFields.MsiEmbeddedUI), IntermediateFieldType.String),
14 new IntermediateFieldDefinition(nameof(MsiEmbeddedUITupleFields.FileName), IntermediateFieldType.String), 13 new IntermediateFieldDefinition(nameof(MsiEmbeddedUITupleFields.FileName), IntermediateFieldType.String),
15 new IntermediateFieldDefinition(nameof(MsiEmbeddedUITupleFields.Attributes), IntermediateFieldType.Number), 14 new IntermediateFieldDefinition(nameof(MsiEmbeddedUITupleFields.EntryPoint), IntermediateFieldType.Bool),
15 new IntermediateFieldDefinition(nameof(MsiEmbeddedUITupleFields.SupportsBasicUI), IntermediateFieldType.Bool),
16 new IntermediateFieldDefinition(nameof(MsiEmbeddedUITupleFields.MessageFilter), IntermediateFieldType.Number), 16 new IntermediateFieldDefinition(nameof(MsiEmbeddedUITupleFields.MessageFilter), IntermediateFieldType.Number),
17 new IntermediateFieldDefinition(nameof(MsiEmbeddedUITupleFields.Data), IntermediateFieldType.Path), 17 new IntermediateFieldDefinition(nameof(MsiEmbeddedUITupleFields.Source), IntermediateFieldType.Path),
18 }, 18 },
19 typeof(MsiEmbeddedUITuple)); 19 typeof(MsiEmbeddedUITuple));
20 } 20 }
@@ -24,11 +24,11 @@ namespace WixToolset.Data.Tuples
24{ 24{
25 public enum MsiEmbeddedUITupleFields 25 public enum MsiEmbeddedUITupleFields
26 { 26 {
27 MsiEmbeddedUI,
28 FileName, 27 FileName,
29 Attributes, 28 EntryPoint,
29 SupportsBasicUI,
30 MessageFilter, 30 MessageFilter,
31 Data, 31 Source,
32 } 32 }
33 33
34 public class MsiEmbeddedUITuple : IntermediateTuple 34 public class MsiEmbeddedUITuple : IntermediateTuple
@@ -43,22 +43,22 @@ namespace WixToolset.Data.Tuples
43 43
44 public IntermediateField this[MsiEmbeddedUITupleFields index] => this.Fields[(int)index]; 44 public IntermediateField this[MsiEmbeddedUITupleFields index] => this.Fields[(int)index];
45 45
46 public string MsiEmbeddedUI
47 {
48 get => (string)this.Fields[(int)MsiEmbeddedUITupleFields.MsiEmbeddedUI]?.Value;
49 set => this.Set((int)MsiEmbeddedUITupleFields.MsiEmbeddedUI, value);
50 }
51
52 public string FileName 46 public string FileName
53 { 47 {
54 get => (string)this.Fields[(int)MsiEmbeddedUITupleFields.FileName]?.Value; 48 get => (string)this.Fields[(int)MsiEmbeddedUITupleFields.FileName]?.Value;
55 set => this.Set((int)MsiEmbeddedUITupleFields.FileName, value); 49 set => this.Set((int)MsiEmbeddedUITupleFields.FileName, value);
56 } 50 }
57 51
58 public int Attributes 52 public bool EntryPoint
59 { 53 {
60 get => (int)this.Fields[(int)MsiEmbeddedUITupleFields.Attributes]?.Value; 54 get => this.Fields[(int)MsiEmbeddedUITupleFields.EntryPoint].AsBool();
61 set => this.Set((int)MsiEmbeddedUITupleFields.Attributes, value); 55 set => this.Set((int)MsiEmbeddedUITupleFields.EntryPoint, value);
56 }
57
58 public bool SupportsBasicUI
59 {
60 get => this.Fields[(int)MsiEmbeddedUITupleFields.SupportsBasicUI].AsBool();
61 set => this.Set((int)MsiEmbeddedUITupleFields.SupportsBasicUI, value);
62 } 62 }
63 63
64 public int MessageFilter 64 public int MessageFilter
@@ -67,10 +67,10 @@ namespace WixToolset.Data.Tuples
67 set => this.Set((int)MsiEmbeddedUITupleFields.MessageFilter, value); 67 set => this.Set((int)MsiEmbeddedUITupleFields.MessageFilter, value);
68 } 68 }
69 69
70 public string Data 70 public string Source
71 { 71 {
72 get => (string)this.Fields[(int)MsiEmbeddedUITupleFields.Data]?.Value; 72 get => (string)this.Fields[(int)MsiEmbeddedUITupleFields.Source]?.Value;
73 set => this.Set((int)MsiEmbeddedUITupleFields.Data, value); 73 set => this.Set((int)MsiEmbeddedUITupleFields.Source, value);
74 } 74 }
75 } 75 }
76} \ No newline at end of file 76}
diff --git a/src/WixToolset.Data/Tuples/MsiServiceConfigFailureActionsTuple.cs b/src/WixToolset.Data/Tuples/MsiServiceConfigFailureActionsTuple.cs
index 043be793..bcf32cb6 100644
--- a/src/WixToolset.Data/Tuples/MsiServiceConfigFailureActionsTuple.cs
+++ b/src/WixToolset.Data/Tuples/MsiServiceConfigFailureActionsTuple.cs
@@ -10,9 +10,10 @@ namespace WixToolset.Data
10 TupleDefinitionType.MsiServiceConfigFailureActions, 10 TupleDefinitionType.MsiServiceConfigFailureActions,
11 new[] 11 new[]
12 { 12 {
13 new IntermediateFieldDefinition(nameof(MsiServiceConfigFailureActionsTupleFields.MsiServiceConfigFailureActions), IntermediateFieldType.String),
14 new IntermediateFieldDefinition(nameof(MsiServiceConfigFailureActionsTupleFields.Name), IntermediateFieldType.String), 13 new IntermediateFieldDefinition(nameof(MsiServiceConfigFailureActionsTupleFields.Name), IntermediateFieldType.String),
15 new IntermediateFieldDefinition(nameof(MsiServiceConfigFailureActionsTupleFields.Event), IntermediateFieldType.Number), 14 new IntermediateFieldDefinition(nameof(MsiServiceConfigFailureActionsTupleFields.OnInstall), IntermediateFieldType.Bool),
15 new IntermediateFieldDefinition(nameof(MsiServiceConfigFailureActionsTupleFields.OnReinstall), IntermediateFieldType.Bool),
16 new IntermediateFieldDefinition(nameof(MsiServiceConfigFailureActionsTupleFields.OnUninstall), IntermediateFieldType.Bool),
16 new IntermediateFieldDefinition(nameof(MsiServiceConfigFailureActionsTupleFields.ResetPeriod), IntermediateFieldType.Number), 17 new IntermediateFieldDefinition(nameof(MsiServiceConfigFailureActionsTupleFields.ResetPeriod), IntermediateFieldType.Number),
17 new IntermediateFieldDefinition(nameof(MsiServiceConfigFailureActionsTupleFields.RebootMessage), IntermediateFieldType.String), 18 new IntermediateFieldDefinition(nameof(MsiServiceConfigFailureActionsTupleFields.RebootMessage), IntermediateFieldType.String),
18 new IntermediateFieldDefinition(nameof(MsiServiceConfigFailureActionsTupleFields.Command), IntermediateFieldType.String), 19 new IntermediateFieldDefinition(nameof(MsiServiceConfigFailureActionsTupleFields.Command), IntermediateFieldType.String),
@@ -28,9 +29,10 @@ namespace WixToolset.Data.Tuples
28{ 29{
29 public enum MsiServiceConfigFailureActionsTupleFields 30 public enum MsiServiceConfigFailureActionsTupleFields
30 { 31 {
31 MsiServiceConfigFailureActions,
32 Name, 32 Name,
33 Event, 33 OnInstall,
34 OnReinstall,
35 OnUninstall,
34 ResetPeriod, 36 ResetPeriod,
35 RebootMessage, 37 RebootMessage,
36 Command, 38 Command,
@@ -51,27 +53,33 @@ namespace WixToolset.Data.Tuples
51 53
52 public IntermediateField this[MsiServiceConfigFailureActionsTupleFields index] => this.Fields[(int)index]; 54 public IntermediateField this[MsiServiceConfigFailureActionsTupleFields index] => this.Fields[(int)index];
53 55
54 public string MsiServiceConfigFailureActions
55 {
56 get => (string)this.Fields[(int)MsiServiceConfigFailureActionsTupleFields.MsiServiceConfigFailureActions]?.Value;
57 set => this.Set((int)MsiServiceConfigFailureActionsTupleFields.MsiServiceConfigFailureActions, value);
58 }
59
60 public string Name 56 public string Name
61 { 57 {
62 get => (string)this.Fields[(int)MsiServiceConfigFailureActionsTupleFields.Name]?.Value; 58 get => (string)this.Fields[(int)MsiServiceConfigFailureActionsTupleFields.Name]?.Value;
63 set => this.Set((int)MsiServiceConfigFailureActionsTupleFields.Name, value); 59 set => this.Set((int)MsiServiceConfigFailureActionsTupleFields.Name, value);
64 } 60 }
65 61
66 public int Event 62 public bool OnInstall
63 {
64 get => this.Fields[(int)MsiServiceConfigFailureActionsTupleFields.OnInstall].AsBool();
65 set => this.Set((int)MsiServiceConfigFailureActionsTupleFields.OnInstall, value);
66 }
67
68 public bool OnReinstall
69 {
70 get => this.Fields[(int)MsiServiceConfigFailureActionsTupleFields.OnReinstall].AsBool();
71 set => this.Set((int)MsiServiceConfigFailureActionsTupleFields.OnReinstall, value);
72 }
73
74 public bool OnUninstall
67 { 75 {
68 get => (int)this.Fields[(int)MsiServiceConfigFailureActionsTupleFields.Event]?.Value; 76 get => this.Fields[(int)MsiServiceConfigFailureActionsTupleFields.OnUninstall].AsBool();
69 set => this.Set((int)MsiServiceConfigFailureActionsTupleFields.Event, value); 77 set => this.Set((int)MsiServiceConfigFailureActionsTupleFields.OnUninstall, value);
70 } 78 }
71 79
72 public int ResetPeriod 80 public int? ResetPeriod
73 { 81 {
74 get => (int)this.Fields[(int)MsiServiceConfigFailureActionsTupleFields.ResetPeriod]?.Value; 82 get => (int)this.Fields[(int)MsiServiceConfigFailureActionsTupleFields.ResetPeriod].AsNullableNumber();
75 set => this.Set((int)MsiServiceConfigFailureActionsTupleFields.ResetPeriod, value); 83 set => this.Set((int)MsiServiceConfigFailureActionsTupleFields.ResetPeriod, value);
76 } 84 }
77 85
diff --git a/src/WixToolset.Data/Tuples/MsiServiceConfigTuple.cs b/src/WixToolset.Data/Tuples/MsiServiceConfigTuple.cs
index 701d85b4..c0e8e459 100644
--- a/src/WixToolset.Data/Tuples/MsiServiceConfigTuple.cs
+++ b/src/WixToolset.Data/Tuples/MsiServiceConfigTuple.cs
@@ -10,9 +10,10 @@ namespace WixToolset.Data
10 TupleDefinitionType.MsiServiceConfig, 10 TupleDefinitionType.MsiServiceConfig,
11 new[] 11 new[]
12 { 12 {
13 new IntermediateFieldDefinition(nameof(MsiServiceConfigTupleFields.MsiServiceConfig), IntermediateFieldType.String),
14 new IntermediateFieldDefinition(nameof(MsiServiceConfigTupleFields.Name), IntermediateFieldType.String), 13 new IntermediateFieldDefinition(nameof(MsiServiceConfigTupleFields.Name), IntermediateFieldType.String),
15 new IntermediateFieldDefinition(nameof(MsiServiceConfigTupleFields.Event), IntermediateFieldType.Number), 14 new IntermediateFieldDefinition(nameof(MsiServiceConfigFailureActionsTupleFields.OnInstall), IntermediateFieldType.Bool),
15 new IntermediateFieldDefinition(nameof(MsiServiceConfigFailureActionsTupleFields.OnReinstall), IntermediateFieldType.Bool),
16 new IntermediateFieldDefinition(nameof(MsiServiceConfigFailureActionsTupleFields.OnUninstall), IntermediateFieldType.Bool),
16 new IntermediateFieldDefinition(nameof(MsiServiceConfigTupleFields.ConfigType), IntermediateFieldType.Number), 17 new IntermediateFieldDefinition(nameof(MsiServiceConfigTupleFields.ConfigType), IntermediateFieldType.Number),
17 new IntermediateFieldDefinition(nameof(MsiServiceConfigTupleFields.Argument), IntermediateFieldType.String), 18 new IntermediateFieldDefinition(nameof(MsiServiceConfigTupleFields.Argument), IntermediateFieldType.String),
18 new IntermediateFieldDefinition(nameof(MsiServiceConfigTupleFields.Component_), IntermediateFieldType.String), 19 new IntermediateFieldDefinition(nameof(MsiServiceConfigTupleFields.Component_), IntermediateFieldType.String),
@@ -27,12 +28,23 @@ namespace WixToolset.Data.Tuples
27 { 28 {
28 MsiServiceConfig, 29 MsiServiceConfig,
29 Name, 30 Name,
30 Event, 31 OnInstall,
32 OnReinstall,
33 OnUninstall,
31 ConfigType, 34 ConfigType,
32 Argument, 35 Argument,
33 Component_, 36 Component_,
34 } 37 }
35 38
39 public enum MsiServiceConfigType
40 {
41 DelayedAutoStart = 3,
42 FailureActionsFlag,
43 ServiceSidInfo,
44 RequiredPrivilegesInfo,
45 PreshutdownInfo,
46 }
47
36 public class MsiServiceConfigTuple : IntermediateTuple 48 public class MsiServiceConfigTuple : IntermediateTuple
37 { 49 {
38 public MsiServiceConfigTuple() : base(TupleDefinitions.MsiServiceConfig, null, null) 50 public MsiServiceConfigTuple() : base(TupleDefinitions.MsiServiceConfig, null, null)
@@ -45,28 +57,34 @@ namespace WixToolset.Data.Tuples
45 57
46 public IntermediateField this[MsiServiceConfigTupleFields index] => this.Fields[(int)index]; 58 public IntermediateField this[MsiServiceConfigTupleFields index] => this.Fields[(int)index];
47 59
48 public string MsiServiceConfig
49 {
50 get => (string)this.Fields[(int)MsiServiceConfigTupleFields.MsiServiceConfig]?.Value;
51 set => this.Set((int)MsiServiceConfigTupleFields.MsiServiceConfig, value);
52 }
53
54 public string Name 60 public string Name
55 { 61 {
56 get => (string)this.Fields[(int)MsiServiceConfigTupleFields.Name]?.Value; 62 get => (string)this.Fields[(int)MsiServiceConfigTupleFields.Name]?.Value;
57 set => this.Set((int)MsiServiceConfigTupleFields.Name, value); 63 set => this.Set((int)MsiServiceConfigTupleFields.Name, value);
58 } 64 }
59 65
60 public int Event 66 public bool OnInstall
67 {
68 get => this.Fields[(int)MsiServiceConfigTupleFields.OnInstall].AsBool();
69 set => this.Set((int)MsiServiceConfigTupleFields.OnInstall, value);
70 }
71
72 public bool OnReinstall
73 {
74 get => this.Fields[(int)MsiServiceConfigTupleFields.OnReinstall].AsBool();
75 set => this.Set((int)MsiServiceConfigTupleFields.OnReinstall, value);
76 }
77
78 public bool OnUninstall
61 { 79 {
62 get => (int)this.Fields[(int)MsiServiceConfigTupleFields.Event]?.Value; 80 get => this.Fields[(int)MsiServiceConfigTupleFields.OnUninstall].AsBool();
63 set => this.Set((int)MsiServiceConfigTupleFields.Event, value); 81 set => this.Set((int)MsiServiceConfigTupleFields.OnUninstall, value);
64 } 82 }
65 83
66 public int ConfigType 84 public MsiServiceConfigType ConfigType
67 { 85 {
68 get => (int)this.Fields[(int)MsiServiceConfigTupleFields.ConfigType]?.Value; 86 get => (MsiServiceConfigType)this.Fields[(int)MsiServiceConfigTupleFields.ConfigType].AsNumber();
69 set => this.Set((int)MsiServiceConfigTupleFields.ConfigType, value); 87 set => this.Set((int)MsiServiceConfigTupleFields.ConfigType, (int)value);
70 } 88 }
71 89
72 public string Argument 90 public string Argument
diff --git a/src/WixToolset.Data/Tuples/RegistryRootType.cs b/src/WixToolset.Data/Tuples/RegistryRootType.cs
new file mode 100644
index 00000000..b037ca63
--- /dev/null
+++ b/src/WixToolset.Data/Tuples/RegistryRootType.cs
@@ -0,0 +1,21 @@
1// Copyright (c) .NET Foundation and contributors. All rights reserved. Licensed under the Microsoft Reciprocal License. See LICENSE.TXT file in the project root for full license information.
2
3namespace WixToolset.Data.Tuples
4{
5 using System;
6
7 /// <summary>
8 /// Registry root mapping.
9 /// </summary>
10 public enum RegistryRootType
11 {
12 Unknown = Int32.MaxValue,
13
14 /// <summary>HKLM in a per-machine and HKCU in per-user.</summary>
15 MachineUser = -1,
16 ClassesRoot = 0,
17 CurrentUser = 1,
18 LocalMachine = 2,
19 Users = 3
20 }
21}
diff --git a/src/WixToolset.Data/Tuples/RegistryTuple.cs b/src/WixToolset.Data/Tuples/RegistryTuple.cs
index a82cd5ee..d76de213 100644
--- a/src/WixToolset.Data/Tuples/RegistryTuple.cs
+++ b/src/WixToolset.Data/Tuples/RegistryTuple.cs
@@ -10,11 +10,12 @@ namespace WixToolset.Data
10 TupleDefinitionType.Registry, 10 TupleDefinitionType.Registry,
11 new[] 11 new[]
12 { 12 {
13 new IntermediateFieldDefinition(nameof(RegistryTupleFields.Registry), IntermediateFieldType.String),
14 new IntermediateFieldDefinition(nameof(RegistryTupleFields.Root), IntermediateFieldType.Number), 13 new IntermediateFieldDefinition(nameof(RegistryTupleFields.Root), IntermediateFieldType.Number),
15 new IntermediateFieldDefinition(nameof(RegistryTupleFields.Key), IntermediateFieldType.String), 14 new IntermediateFieldDefinition(nameof(RegistryTupleFields.Key), IntermediateFieldType.String),
16 new IntermediateFieldDefinition(nameof(RegistryTupleFields.Name), IntermediateFieldType.String), 15 new IntermediateFieldDefinition(nameof(RegistryTupleFields.Name), IntermediateFieldType.String),
17 new IntermediateFieldDefinition(nameof(RegistryTupleFields.Value), IntermediateFieldType.String), 16 new IntermediateFieldDefinition(nameof(RegistryTupleFields.Value), IntermediateFieldType.String),
17 new IntermediateFieldDefinition(nameof(RegistryTupleFields.ValueType), IntermediateFieldType.Number),
18 new IntermediateFieldDefinition(nameof(RegistryTupleFields.ValueAction), IntermediateFieldType.Number),
18 new IntermediateFieldDefinition(nameof(RegistryTupleFields.Component_), IntermediateFieldType.String), 19 new IntermediateFieldDefinition(nameof(RegistryTupleFields.Component_), IntermediateFieldType.String),
19 }, 20 },
20 typeof(RegistryTuple)); 21 typeof(RegistryTuple));
@@ -25,14 +26,31 @@ namespace WixToolset.Data.Tuples
25{ 26{
26 public enum RegistryTupleFields 27 public enum RegistryTupleFields
27 { 28 {
28 Registry,
29 Root, 29 Root,
30 Key, 30 Key,
31 Name, 31 Name,
32 Value, 32 Value,
33 ValueType,
34 ValueAction,
33 Component_, 35 Component_,
34 } 36 }
35 37
38 public enum RegistryValueType
39 {
40 String,
41 Binary,
42 Expandable,
43 Integer,
44 MultiString,
45 }
46
47 public enum RegistryValueActionType
48 {
49 Write,
50 Append,
51 Prepend,
52 }
53
36 public class RegistryTuple : IntermediateTuple 54 public class RegistryTuple : IntermediateTuple
37 { 55 {
38 public RegistryTuple() : base(TupleDefinitions.Registry, null, null) 56 public RegistryTuple() : base(TupleDefinitions.Registry, null, null)
@@ -45,16 +63,10 @@ namespace WixToolset.Data.Tuples
45 63
46 public IntermediateField this[RegistryTupleFields index] => this.Fields[(int)index]; 64 public IntermediateField this[RegistryTupleFields index] => this.Fields[(int)index];
47 65
48 public string Registry 66 public RegistryRootType Root
49 { 67 {
50 get => (string)this.Fields[(int)RegistryTupleFields.Registry]?.Value; 68 get => (RegistryRootType)this.Fields[(int)RegistryTupleFields.Root].AsNumber();
51 set => this.Set((int)RegistryTupleFields.Registry, value); 69 set => this.Set((int)RegistryTupleFields.Root, (int)value);
52 }
53
54 public int Root
55 {
56 get => (int)this.Fields[(int)RegistryTupleFields.Root]?.Value;
57 set => this.Set((int)RegistryTupleFields.Root, value);
58 } 70 }
59 71
60 public string Key 72 public string Key
@@ -71,10 +83,22 @@ namespace WixToolset.Data.Tuples
71 83
72 public string Value 84 public string Value
73 { 85 {
74 get => (string)this.Fields[(int)RegistryTupleFields.Value]?.Value; 86 get => this.Fields[(int)RegistryTupleFields.Value].AsString();
75 set => this.Set((int)RegistryTupleFields.Value, value); 87 set => this.Set((int)RegistryTupleFields.Value, value);
76 } 88 }
77 89
90 public RegistryValueType ValueType
91 {
92 get => (RegistryValueType)this.Fields[(int)RegistryTupleFields.ValueType].AsNumber();
93 set => this.Set((int)RegistryTupleFields.ValueType, (int)value);
94 }
95
96 public RegistryValueActionType ValueAction
97 {
98 get => (RegistryValueActionType)this.Fields[(int)RegistryTupleFields.ValueAction].AsNumber();
99 set => this.Set((int)RegistryTupleFields.ValueAction, (int)value);
100 }
101
78 public string Component_ 102 public string Component_
79 { 103 {
80 get => (string)this.Fields[(int)RegistryTupleFields.Component_]?.Value; 104 get => (string)this.Fields[(int)RegistryTupleFields.Component_]?.Value;
diff --git a/src/WixToolset.Data/Tuples/RemoveRegistryTuple.cs b/src/WixToolset.Data/Tuples/RemoveRegistryTuple.cs
index 154aad67..89c8d2e2 100644
--- a/src/WixToolset.Data/Tuples/RemoveRegistryTuple.cs
+++ b/src/WixToolset.Data/Tuples/RemoveRegistryTuple.cs
@@ -10,10 +10,10 @@ namespace WixToolset.Data
10 TupleDefinitionType.RemoveRegistry, 10 TupleDefinitionType.RemoveRegistry,
11 new[] 11 new[]
12 { 12 {
13 new IntermediateFieldDefinition(nameof(RemoveRegistryTupleFields.RemoveRegistry), IntermediateFieldType.String),
14 new IntermediateFieldDefinition(nameof(RemoveRegistryTupleFields.Root), IntermediateFieldType.Number), 13 new IntermediateFieldDefinition(nameof(RemoveRegistryTupleFields.Root), IntermediateFieldType.Number),
15 new IntermediateFieldDefinition(nameof(RemoveRegistryTupleFields.Key), IntermediateFieldType.String), 14 new IntermediateFieldDefinition(nameof(RemoveRegistryTupleFields.Key), IntermediateFieldType.String),
16 new IntermediateFieldDefinition(nameof(RemoveRegistryTupleFields.Name), IntermediateFieldType.String), 15 new IntermediateFieldDefinition(nameof(RemoveRegistryTupleFields.Name), IntermediateFieldType.String),
16 new IntermediateFieldDefinition(nameof(RemoveRegistryTupleFields.Action), IntermediateFieldType.Number),
17 new IntermediateFieldDefinition(nameof(RemoveRegistryTupleFields.Component_), IntermediateFieldType.String), 17 new IntermediateFieldDefinition(nameof(RemoveRegistryTupleFields.Component_), IntermediateFieldType.String),
18 }, 18 },
19 typeof(RemoveRegistryTuple)); 19 typeof(RemoveRegistryTuple));
@@ -24,13 +24,19 @@ namespace WixToolset.Data.Tuples
24{ 24{
25 public enum RemoveRegistryTupleFields 25 public enum RemoveRegistryTupleFields
26 { 26 {
27 RemoveRegistry,
28 Root, 27 Root,
29 Key, 28 Key,
30 Name, 29 Name,
30 Action,
31 Component_, 31 Component_,
32 } 32 }
33 33
34 public enum RemoveRegistryActionType
35 {
36 RemoveOnInstall,
37 RemoveOnUninstall
38 };
39
34 public class RemoveRegistryTuple : IntermediateTuple 40 public class RemoveRegistryTuple : IntermediateTuple
35 { 41 {
36 public RemoveRegistryTuple() : base(TupleDefinitions.RemoveRegistry, null, null) 42 public RemoveRegistryTuple() : base(TupleDefinitions.RemoveRegistry, null, null)
@@ -43,16 +49,10 @@ namespace WixToolset.Data.Tuples
43 49
44 public IntermediateField this[RemoveRegistryTupleFields index] => this.Fields[(int)index]; 50 public IntermediateField this[RemoveRegistryTupleFields index] => this.Fields[(int)index];
45 51
46 public string RemoveRegistry 52 public RegistryRootType Root
47 {
48 get => (string)this.Fields[(int)RemoveRegistryTupleFields.RemoveRegistry]?.Value;
49 set => this.Set((int)RemoveRegistryTupleFields.RemoveRegistry, value);
50 }
51
52 public int Root
53 { 53 {
54 get => (int)this.Fields[(int)RemoveRegistryTupleFields.Root]?.Value; 54 get => (RegistryRootType)this.Fields[(int)RemoveRegistryTupleFields.Key]?.AsNumber();
55 set => this.Set((int)RemoveRegistryTupleFields.Root, value); 55 set => this.Set((int)RemoveRegistryTupleFields.Root, (int)value);
56 } 56 }
57 57
58 public string Key 58 public string Key
@@ -67,6 +67,12 @@ namespace WixToolset.Data.Tuples
67 set => this.Set((int)RemoveRegistryTupleFields.Name, value); 67 set => this.Set((int)RemoveRegistryTupleFields.Name, value);
68 } 68 }
69 69
70 public RemoveRegistryActionType Action
71 {
72 get => (RemoveRegistryActionType)this.Fields[(int)RemoveRegistryTupleFields.Action].AsNumber();
73 set => this.Set((int)RemoveRegistryTupleFields.Action, (int)value);
74 }
75
70 public string Component_ 76 public string Component_
71 { 77 {
72 get => (string)this.Fields[(int)RemoveRegistryTupleFields.Component_]?.Value; 78 get => (string)this.Fields[(int)RemoveRegistryTupleFields.Component_]?.Value;
diff --git a/src/WixToolset.Data/Tuples/ServiceControlTuple.cs b/src/WixToolset.Data/Tuples/ServiceControlTuple.cs
index a2cdc7a0..844ee864 100644
--- a/src/WixToolset.Data/Tuples/ServiceControlTuple.cs
+++ b/src/WixToolset.Data/Tuples/ServiceControlTuple.cs
@@ -12,9 +12,14 @@ namespace WixToolset.Data
12 { 12 {
13 new IntermediateFieldDefinition(nameof(ServiceControlTupleFields.ServiceControl), IntermediateFieldType.String), 13 new IntermediateFieldDefinition(nameof(ServiceControlTupleFields.ServiceControl), IntermediateFieldType.String),
14 new IntermediateFieldDefinition(nameof(ServiceControlTupleFields.Name), IntermediateFieldType.String), 14 new IntermediateFieldDefinition(nameof(ServiceControlTupleFields.Name), IntermediateFieldType.String),
15 new IntermediateFieldDefinition(nameof(ServiceControlTupleFields.Event), IntermediateFieldType.Number), 15 new IntermediateFieldDefinition(nameof(ServiceControlTupleFields.InstallRemove), IntermediateFieldType.Bool),
16 new IntermediateFieldDefinition(nameof(ServiceControlTupleFields.UninstallRemove), IntermediateFieldType.Bool),
17 new IntermediateFieldDefinition(nameof(ServiceControlTupleFields.InstallStart), IntermediateFieldType.Bool),
18 new IntermediateFieldDefinition(nameof(ServiceControlTupleFields.UninstallStart), IntermediateFieldType.Bool),
19 new IntermediateFieldDefinition(nameof(ServiceControlTupleFields.InstallStop), IntermediateFieldType.Bool),
20 new IntermediateFieldDefinition(nameof(ServiceControlTupleFields.UninstallStop), IntermediateFieldType.Bool),
16 new IntermediateFieldDefinition(nameof(ServiceControlTupleFields.Arguments), IntermediateFieldType.String), 21 new IntermediateFieldDefinition(nameof(ServiceControlTupleFields.Arguments), IntermediateFieldType.String),
17 new IntermediateFieldDefinition(nameof(ServiceControlTupleFields.Wait), IntermediateFieldType.Number), 22 new IntermediateFieldDefinition(nameof(ServiceControlTupleFields.Wait), IntermediateFieldType.Bool),
18 new IntermediateFieldDefinition(nameof(ServiceControlTupleFields.Component_), IntermediateFieldType.String), 23 new IntermediateFieldDefinition(nameof(ServiceControlTupleFields.Component_), IntermediateFieldType.String),
19 }, 24 },
20 typeof(ServiceControlTuple)); 25 typeof(ServiceControlTuple));
@@ -27,7 +32,12 @@ namespace WixToolset.Data.Tuples
27 { 32 {
28 ServiceControl, 33 ServiceControl,
29 Name, 34 Name,
30 Event, 35 InstallRemove,
36 UninstallRemove,
37 InstallStart,
38 UninstallStart,
39 InstallStop,
40 UninstallStop,
31 Arguments, 41 Arguments,
32 Wait, 42 Wait,
33 Component_, 43 Component_,
@@ -57,10 +67,40 @@ namespace WixToolset.Data.Tuples
57 set => this.Set((int)ServiceControlTupleFields.Name, value); 67 set => this.Set((int)ServiceControlTupleFields.Name, value);
58 } 68 }
59 69
60 public int Event 70 public bool InstallRemove
61 { 71 {
62 get => (int)this.Fields[(int)ServiceControlTupleFields.Event]?.Value; 72 get => this.Fields[(int)ServiceControlTupleFields.InstallRemove].AsBool();
63 set => this.Set((int)ServiceControlTupleFields.Event, value); 73 set => this.Set((int)ServiceControlTupleFields.InstallRemove, value);
74 }
75
76 public bool UninstallRemove
77 {
78 get => this.Fields[(int)ServiceControlTupleFields.UninstallRemove].AsBool();
79 set => this.Set((int)ServiceControlTupleFields.UninstallRemove, value);
80 }
81
82 public bool InstallStart
83 {
84 get => this.Fields[(int)ServiceControlTupleFields.InstallStart].AsBool();
85 set => this.Set((int)ServiceControlTupleFields.InstallStart, value);
86 }
87
88 public bool UninstallStart
89 {
90 get => this.Fields[(int)ServiceControlTupleFields.UninstallStart].AsBool();
91 set => this.Set((int)ServiceControlTupleFields.UninstallStart, value);
92 }
93
94 public bool InstallStop
95 {
96 get => this.Fields[(int)ServiceControlTupleFields.InstallStop].AsBool();
97 set => this.Set((int)ServiceControlTupleFields.InstallStop, value);
98 }
99
100 public bool UninstallStop
101 {
102 get => this.Fields[(int)ServiceControlTupleFields.UninstallStop].AsBool();
103 set => this.Set((int)ServiceControlTupleFields.UninstallStop, value);
64 } 104 }
65 105
66 public string Arguments 106 public string Arguments
@@ -69,9 +109,9 @@ namespace WixToolset.Data.Tuples
69 set => this.Set((int)ServiceControlTupleFields.Arguments, value); 109 set => this.Set((int)ServiceControlTupleFields.Arguments, value);
70 } 110 }
71 111
72 public int Wait 112 public bool? Wait
73 { 113 {
74 get => (int)this.Fields[(int)ServiceControlTupleFields.Wait]?.Value; 114 get => this.Fields[(int)ServiceControlTupleFields.Wait].AsNullableBool();
75 set => this.Set((int)ServiceControlTupleFields.Wait, value); 115 set => this.Set((int)ServiceControlTupleFields.Wait, value);
76 } 116 }
77 117
diff --git a/src/WixToolset.Data/Tuples/ServiceInstallTuple.cs b/src/WixToolset.Data/Tuples/ServiceInstallTuple.cs
index cd02d21e..987dccd7 100644
--- a/src/WixToolset.Data/Tuples/ServiceInstallTuple.cs
+++ b/src/WixToolset.Data/Tuples/ServiceInstallTuple.cs
@@ -10,7 +10,6 @@ namespace WixToolset.Data
10 TupleDefinitionType.ServiceInstall, 10 TupleDefinitionType.ServiceInstall,
11 new[] 11 new[]
12 { 12 {
13 new IntermediateFieldDefinition(nameof(ServiceInstallTupleFields.ServiceInstall), IntermediateFieldType.String),
14 new IntermediateFieldDefinition(nameof(ServiceInstallTupleFields.Name), IntermediateFieldType.String), 13 new IntermediateFieldDefinition(nameof(ServiceInstallTupleFields.Name), IntermediateFieldType.String),
15 new IntermediateFieldDefinition(nameof(ServiceInstallTupleFields.DisplayName), IntermediateFieldType.String), 14 new IntermediateFieldDefinition(nameof(ServiceInstallTupleFields.DisplayName), IntermediateFieldType.String),
16 new IntermediateFieldDefinition(nameof(ServiceInstallTupleFields.ServiceType), IntermediateFieldType.Number), 15 new IntermediateFieldDefinition(nameof(ServiceInstallTupleFields.ServiceType), IntermediateFieldType.Number),
@@ -23,6 +22,8 @@ namespace WixToolset.Data
23 new IntermediateFieldDefinition(nameof(ServiceInstallTupleFields.Arguments), IntermediateFieldType.String), 22 new IntermediateFieldDefinition(nameof(ServiceInstallTupleFields.Arguments), IntermediateFieldType.String),
24 new IntermediateFieldDefinition(nameof(ServiceInstallTupleFields.Component_), IntermediateFieldType.String), 23 new IntermediateFieldDefinition(nameof(ServiceInstallTupleFields.Component_), IntermediateFieldType.String),
25 new IntermediateFieldDefinition(nameof(ServiceInstallTupleFields.Description), IntermediateFieldType.String), 24 new IntermediateFieldDefinition(nameof(ServiceInstallTupleFields.Description), IntermediateFieldType.String),
25 new IntermediateFieldDefinition(nameof(ServiceInstallTupleFields.Interactive), IntermediateFieldType.Bool),
26 new IntermediateFieldDefinition(nameof(ServiceInstallTupleFields.Vital), IntermediateFieldType.Bool),
26 }, 27 },
27 typeof(ServiceInstallTuple)); 28 typeof(ServiceInstallTuple));
28 } 29 }
@@ -32,7 +33,6 @@ namespace WixToolset.Data.Tuples
32{ 33{
33 public enum ServiceInstallTupleFields 34 public enum ServiceInstallTupleFields
34 { 35 {
35 ServiceInstall,
36 Name, 36 Name,
37 DisplayName, 37 DisplayName,
38 ServiceType, 38 ServiceType,
@@ -45,6 +45,33 @@ namespace WixToolset.Data.Tuples
45 Arguments, 45 Arguments,
46 Component_, 46 Component_,
47 Description, 47 Description,
48 Interactive,
49 Vital,
50 }
51
52 public enum ServiceType
53 {
54 KernelDriver,
55 SystemDriver,
56 OwnProcess = 4,
57 ShareProcess = 8,
58 InteractiveProcess = 256,
59 }
60
61 public enum ServiceStartType
62 {
63 Boot,
64 System,
65 Auto,
66 Demand,
67 Disabled,
68 }
69
70 public enum ServiceErrorControl
71 {
72 Ignore,
73 Normal,
74 Critical = 3,
48 } 75 }
49 76
50 public class ServiceInstallTuple : IntermediateTuple 77 public class ServiceInstallTuple : IntermediateTuple
@@ -59,12 +86,6 @@ namespace WixToolset.Data.Tuples
59 86
60 public IntermediateField this[ServiceInstallTupleFields index] => this.Fields[(int)index]; 87 public IntermediateField this[ServiceInstallTupleFields index] => this.Fields[(int)index];
61 88
62 public string ServiceInstall
63 {
64 get => (string)this.Fields[(int)ServiceInstallTupleFields.ServiceInstall]?.Value;
65 set => this.Set((int)ServiceInstallTupleFields.ServiceInstall, value);
66 }
67
68 public string Name 89 public string Name
69 { 90 {
70 get => (string)this.Fields[(int)ServiceInstallTupleFields.Name]?.Value; 91 get => (string)this.Fields[(int)ServiceInstallTupleFields.Name]?.Value;
@@ -77,22 +98,22 @@ namespace WixToolset.Data.Tuples
77 set => this.Set((int)ServiceInstallTupleFields.DisplayName, value); 98 set => this.Set((int)ServiceInstallTupleFields.DisplayName, value);
78 } 99 }
79 100
80 public int ServiceType 101 public ServiceType ServiceType
81 { 102 {
82 get => (int)this.Fields[(int)ServiceInstallTupleFields.ServiceType]?.Value; 103 get => (ServiceType)this.Fields[(int)ServiceInstallTupleFields.ServiceType].AsNumber();
83 set => this.Set((int)ServiceInstallTupleFields.ServiceType, value); 104 set => this.Set((int)ServiceInstallTupleFields.ServiceType, (int)value);
84 } 105 }
85 106
86 public int StartType 107 public ServiceStartType StartType
87 { 108 {
88 get => (int)this.Fields[(int)ServiceInstallTupleFields.StartType]?.Value; 109 get => (ServiceStartType)this.Fields[(int)ServiceInstallTupleFields.StartType].AsNumber();
89 set => this.Set((int)ServiceInstallTupleFields.StartType, value); 110 set => this.Set((int)ServiceInstallTupleFields.StartType, (int)value);
90 } 111 }
91 112
92 public int ErrorControl 113 public ServiceErrorControl ErrorControl
93 { 114 {
94 get => (int)this.Fields[(int)ServiceInstallTupleFields.ErrorControl]?.Value; 115 get => (ServiceErrorControl)this.Fields[(int)ServiceInstallTupleFields.ErrorControl].AsNumber();
95 set => this.Set((int)ServiceInstallTupleFields.ErrorControl, value); 116 set => this.Set((int)ServiceInstallTupleFields.ErrorControl, (int)value);
96 } 117 }
97 118
98 public string LoadOrderGroup 119 public string LoadOrderGroup
@@ -136,5 +157,17 @@ namespace WixToolset.Data.Tuples
136 get => (string)this.Fields[(int)ServiceInstallTupleFields.Description]?.Value; 157 get => (string)this.Fields[(int)ServiceInstallTupleFields.Description]?.Value;
137 set => this.Set((int)ServiceInstallTupleFields.Description, value); 158 set => this.Set((int)ServiceInstallTupleFields.Description, value);
138 } 159 }
160
161 public bool Interactive
162 {
163 get => this.Fields[(int)ServiceInstallTupleFields.Interactive].AsBool();
164 set => this.Set((int)ServiceInstallTupleFields.Interactive, value);
165 }
166
167 public bool Vital
168 {
169 get => this.Fields[(int)ServiceInstallTupleFields.Vital].AsBool();
170 set => this.Set((int)ServiceInstallTupleFields.Vital, value);
171 }
139 } 172 }
140} \ No newline at end of file 173} \ No newline at end of file
diff --git a/src/WixToolset.Data/Tuples/ShortcutTuple.cs b/src/WixToolset.Data/Tuples/ShortcutTuple.cs
index 0591e7f4..b7f13416 100644
--- a/src/WixToolset.Data/Tuples/ShortcutTuple.cs
+++ b/src/WixToolset.Data/Tuples/ShortcutTuple.cs
@@ -10,7 +10,6 @@ namespace WixToolset.Data
10 TupleDefinitionType.Shortcut, 10 TupleDefinitionType.Shortcut,
11 new[] 11 new[]
12 { 12 {
13 new IntermediateFieldDefinition(nameof(ShortcutTupleFields.Shortcut), IntermediateFieldType.String),
14 new IntermediateFieldDefinition(nameof(ShortcutTupleFields.Directory_), IntermediateFieldType.String), 13 new IntermediateFieldDefinition(nameof(ShortcutTupleFields.Directory_), IntermediateFieldType.String),
15 new IntermediateFieldDefinition(nameof(ShortcutTupleFields.Name), IntermediateFieldType.String), 14 new IntermediateFieldDefinition(nameof(ShortcutTupleFields.Name), IntermediateFieldType.String),
16 new IntermediateFieldDefinition(nameof(ShortcutTupleFields.Component_), IntermediateFieldType.String), 15 new IntermediateFieldDefinition(nameof(ShortcutTupleFields.Component_), IntermediateFieldType.String),
@@ -20,7 +19,7 @@ namespace WixToolset.Data
20 new IntermediateFieldDefinition(nameof(ShortcutTupleFields.Hotkey), IntermediateFieldType.Number), 19 new IntermediateFieldDefinition(nameof(ShortcutTupleFields.Hotkey), IntermediateFieldType.Number),
21 new IntermediateFieldDefinition(nameof(ShortcutTupleFields.Icon_), IntermediateFieldType.String), 20 new IntermediateFieldDefinition(nameof(ShortcutTupleFields.Icon_), IntermediateFieldType.String),
22 new IntermediateFieldDefinition(nameof(ShortcutTupleFields.IconIndex), IntermediateFieldType.Number), 21 new IntermediateFieldDefinition(nameof(ShortcutTupleFields.IconIndex), IntermediateFieldType.Number),
23 new IntermediateFieldDefinition(nameof(ShortcutTupleFields.ShowCmd), IntermediateFieldType.Number), 22 new IntermediateFieldDefinition(nameof(ShortcutTupleFields.Show), IntermediateFieldType.Number),
24 new IntermediateFieldDefinition(nameof(ShortcutTupleFields.WkDir), IntermediateFieldType.String), 23 new IntermediateFieldDefinition(nameof(ShortcutTupleFields.WkDir), IntermediateFieldType.String),
25 new IntermediateFieldDefinition(nameof(ShortcutTupleFields.DisplayResourceDLL), IntermediateFieldType.String), 24 new IntermediateFieldDefinition(nameof(ShortcutTupleFields.DisplayResourceDLL), IntermediateFieldType.String),
26 new IntermediateFieldDefinition(nameof(ShortcutTupleFields.DisplayResourceId), IntermediateFieldType.Number), 25 new IntermediateFieldDefinition(nameof(ShortcutTupleFields.DisplayResourceId), IntermediateFieldType.Number),
@@ -35,7 +34,6 @@ namespace WixToolset.Data.Tuples
35{ 34{
36 public enum ShortcutTupleFields 35 public enum ShortcutTupleFields
37 { 36 {
38 Shortcut,
39 Directory_, 37 Directory_,
40 Name, 38 Name,
41 Component_, 39 Component_,
@@ -45,7 +43,7 @@ namespace WixToolset.Data.Tuples
45 Hotkey, 43 Hotkey,
46 Icon_, 44 Icon_,
47 IconIndex, 45 IconIndex,
48 ShowCmd, 46 Show,
49 WkDir, 47 WkDir,
50 DisplayResourceDLL, 48 DisplayResourceDLL,
51 DisplayResourceId, 49 DisplayResourceId,
@@ -53,6 +51,13 @@ namespace WixToolset.Data.Tuples
53 DescriptionResourceId, 51 DescriptionResourceId,
54 } 52 }
55 53
54 public enum ShortcutShowType
55 {
56 Normal = 1,
57 Maximized = 3,
58 Minimized = 7
59 }
60
56 public class ShortcutTuple : IntermediateTuple 61 public class ShortcutTuple : IntermediateTuple
57 { 62 {
58 public ShortcutTuple() : base(TupleDefinitions.Shortcut, null, null) 63 public ShortcutTuple() : base(TupleDefinitions.Shortcut, null, null)
@@ -65,12 +70,6 @@ namespace WixToolset.Data.Tuples
65 70
66 public IntermediateField this[ShortcutTupleFields index] => this.Fields[(int)index]; 71 public IntermediateField this[ShortcutTupleFields index] => this.Fields[(int)index];
67 72
68 public string Shortcut
69 {
70 get => (string)this.Fields[(int)ShortcutTupleFields.Shortcut]?.Value;
71 set => this.Set((int)ShortcutTupleFields.Shortcut, value);
72 }
73
74 public string Directory_ 73 public string Directory_
75 { 74 {
76 get => (string)this.Fields[(int)ShortcutTupleFields.Directory_]?.Value; 75 get => (string)this.Fields[(int)ShortcutTupleFields.Directory_]?.Value;
@@ -107,9 +106,9 @@ namespace WixToolset.Data.Tuples
107 set => this.Set((int)ShortcutTupleFields.Description, value); 106 set => this.Set((int)ShortcutTupleFields.Description, value);
108 } 107 }
109 108
110 public int Hotkey 109 public int? Hotkey
111 { 110 {
112 get => (int)this.Fields[(int)ShortcutTupleFields.Hotkey]?.Value; 111 get => this.Fields[(int)ShortcutTupleFields.Hotkey].AsNullableNumber();
113 set => this.Set((int)ShortcutTupleFields.Hotkey, value); 112 set => this.Set((int)ShortcutTupleFields.Hotkey, value);
114 } 113 }
115 114
@@ -119,45 +118,45 @@ namespace WixToolset.Data.Tuples
119 set => this.Set((int)ShortcutTupleFields.Icon_, value); 118 set => this.Set((int)ShortcutTupleFields.Icon_, value);
120 } 119 }
121 120
122 public int IconIndex 121 public int? IconIndex
123 { 122 {
124 get => (int)this.Fields[(int)ShortcutTupleFields.IconIndex]?.Value; 123 get => this.Fields[(int)ShortcutTupleFields.IconIndex].AsNullableNumber();
125 set => this.Set((int)ShortcutTupleFields.IconIndex, value); 124 set => this.Set((int)ShortcutTupleFields.IconIndex, value);
126 } 125 }
127 126
128 public int ShowCmd 127 public ShortcutShowType? Show
129 { 128 {
130 get => (int)this.Fields[(int)ShortcutTupleFields.ShowCmd]?.Value; 129 get => (ShortcutShowType?)this.Fields[(int)ShortcutTupleFields.Show].AsNullableNumber();
131 set => this.Set((int)ShortcutTupleFields.ShowCmd, value); 130 set => this.Set((int)ShortcutTupleFields.Show, (int?)value);
132 } 131 }
133 132
134 public string WkDir 133 public string WorkingDirectory
135 { 134 {
136 get => (string)this.Fields[(int)ShortcutTupleFields.WkDir]?.Value; 135 get => (string)this.Fields[(int)ShortcutTupleFields.WkDir]?.Value;
137 set => this.Set((int)ShortcutTupleFields.WkDir, value); 136 set => this.Set((int)ShortcutTupleFields.WkDir, value);
138 } 137 }
139 138
140 public string DisplayResourceDLL 139 public string DisplayResourceDll
141 { 140 {
142 get => (string)this.Fields[(int)ShortcutTupleFields.DisplayResourceDLL]?.Value; 141 get => (string)this.Fields[(int)ShortcutTupleFields.DisplayResourceDLL]?.Value;
143 set => this.Set((int)ShortcutTupleFields.DisplayResourceDLL, value); 142 set => this.Set((int)ShortcutTupleFields.DisplayResourceDLL, value);
144 } 143 }
145 144
146 public int DisplayResourceId 145 public int? DisplayResourceId
147 { 146 {
148 get => (int)this.Fields[(int)ShortcutTupleFields.DisplayResourceId]?.Value; 147 get => this.Fields[(int)ShortcutTupleFields.DisplayResourceId].AsNullableNumber();
149 set => this.Set((int)ShortcutTupleFields.DisplayResourceId, value); 148 set => this.Set((int)ShortcutTupleFields.DisplayResourceId, value);
150 } 149 }
151 150
152 public string DescriptionResourceDLL 151 public string DescriptionResourceDll
153 { 152 {
154 get => (string)this.Fields[(int)ShortcutTupleFields.DescriptionResourceDLL]?.Value; 153 get => (string)this.Fields[(int)ShortcutTupleFields.DescriptionResourceDLL]?.Value;
155 set => this.Set((int)ShortcutTupleFields.DescriptionResourceDLL, value); 154 set => this.Set((int)ShortcutTupleFields.DescriptionResourceDLL, value);
156 } 155 }
157 156
158 public int DescriptionResourceId 157 public int? DescriptionResourceId
159 { 158 {
160 get => (int)this.Fields[(int)ShortcutTupleFields.DescriptionResourceId]?.Value; 159 get => this.Fields[(int)ShortcutTupleFields.DescriptionResourceId].AsNullableNumber();
161 set => this.Set((int)ShortcutTupleFields.DescriptionResourceId, value); 160 set => this.Set((int)ShortcutTupleFields.DescriptionResourceId, value);
162 } 161 }
163 } 162 }
diff --git a/src/WixToolset.Data/Tuples/TextStyleTuple.cs b/src/WixToolset.Data/Tuples/TextStyleTuple.cs
index 20ec878a..d39b40e9 100644
--- a/src/WixToolset.Data/Tuples/TextStyleTuple.cs
+++ b/src/WixToolset.Data/Tuples/TextStyleTuple.cs
@@ -14,7 +14,10 @@ namespace WixToolset.Data
14 new IntermediateFieldDefinition(nameof(TextStyleTupleFields.FaceName), IntermediateFieldType.String), 14 new IntermediateFieldDefinition(nameof(TextStyleTupleFields.FaceName), IntermediateFieldType.String),
15 new IntermediateFieldDefinition(nameof(TextStyleTupleFields.Size), IntermediateFieldType.Number), 15 new IntermediateFieldDefinition(nameof(TextStyleTupleFields.Size), IntermediateFieldType.Number),
16 new IntermediateFieldDefinition(nameof(TextStyleTupleFields.Color), IntermediateFieldType.Number), 16 new IntermediateFieldDefinition(nameof(TextStyleTupleFields.Color), IntermediateFieldType.Number),
17 new IntermediateFieldDefinition(nameof(TextStyleTupleFields.StyleBits), IntermediateFieldType.Number), 17 new IntermediateFieldDefinition(nameof(TextStyleTupleFields.Bold), IntermediateFieldType.Bool),
18 new IntermediateFieldDefinition(nameof(TextStyleTupleFields.Italic), IntermediateFieldType.Bool),
19 new IntermediateFieldDefinition(nameof(TextStyleTupleFields.Strike), IntermediateFieldType.Bool),
20 new IntermediateFieldDefinition(nameof(TextStyleTupleFields.Underline), IntermediateFieldType.Bool),
18 }, 21 },
19 typeof(TextStyleTuple)); 22 typeof(TextStyleTuple));
20 } 23 }
@@ -28,7 +31,10 @@ namespace WixToolset.Data.Tuples
28 FaceName, 31 FaceName,
29 Size, 32 Size,
30 Color, 33 Color,
31 StyleBits, 34 Bold,
35 Italic,
36 Strike,
37 Underline,
32 } 38 }
33 39
34 public class TextStyleTuple : IntermediateTuple 40 public class TextStyleTuple : IntermediateTuple
@@ -57,20 +63,38 @@ namespace WixToolset.Data.Tuples
57 63
58 public int Size 64 public int Size
59 { 65 {
60 get => (int)this.Fields[(int)TextStyleTupleFields.Size]?.Value; 66 get => this.Fields[(int)TextStyleTupleFields.Size].AsNumber();
61 set => this.Set((int)TextStyleTupleFields.Size, value); 67 set => this.Set((int)TextStyleTupleFields.Size, value);
62 } 68 }
63 69
64 public int Color 70 public int Color
65 { 71 {
66 get => (int)this.Fields[(int)TextStyleTupleFields.Color]?.Value; 72 get => (int)this.Fields[(int)TextStyleTupleFields.Color].AsNumber();
67 set => this.Set((int)TextStyleTupleFields.Color, value); 73 set => this.Set((int)TextStyleTupleFields.Color, value);
68 } 74 }
69 75
70 public int StyleBits 76 public bool Bold
71 { 77 {
72 get => (int)this.Fields[(int)TextStyleTupleFields.StyleBits]?.Value; 78 get => this.Fields[(int)TextStyleTupleFields.Bold].AsBool();
73 set => this.Set((int)TextStyleTupleFields.StyleBits, value); 79 set => this.Set((int)TextStyleTupleFields.Bold, value);
80 }
81
82 public bool Italic
83 {
84 get => this.Fields[(int)TextStyleTupleFields.Italic].AsBool();
85 set => this.Set((int)TextStyleTupleFields.Italic, value);
86 }
87
88 public bool Strike
89 {
90 get => this.Fields[(int)TextStyleTupleFields.Strike].AsBool();
91 set => this.Set((int)TextStyleTupleFields.Strike, value);
92 }
93
94 public bool Underline
95 {
96 get => this.Fields[(int)TextStyleTupleFields.Underline].AsBool();
97 set => this.Set((int)TextStyleTupleFields.Underline, value);
74 } 98 }
75 } 99 }
76} \ No newline at end of file 100} \ No newline at end of file
diff --git a/src/WixToolset.Data/Tuples/TupleDefinitions.cs b/src/WixToolset.Data/Tuples/TupleDefinitions.cs
index b9ab2042..173b4371 100644
--- a/src/WixToolset.Data/Tuples/TupleDefinitions.cs
+++ b/src/WixToolset.Data/Tuples/TupleDefinitions.cs
@@ -3,6 +3,7 @@
3namespace WixToolset.Data 3namespace WixToolset.Data
4{ 4{
5 using System; 5 using System;
6 using WixToolset.Data.Tuples;
6 7
7 public enum TupleDefinitionType 8 public enum TupleDefinitionType
8 { 9 {
@@ -130,7 +131,6 @@ namespace WixToolset.Data
130 Verb, 131 Verb,
131 WixAction, 132 WixAction,
132 WixApprovedExeForElevation, 133 WixApprovedExeForElevation,
133 WixBBControl,
134 WixBindUpdatedFiles, 134 WixBindUpdatedFiles,
135 WixBootstrapperApplication, 135 WixBootstrapperApplication,
136 WixBuildInfo, 136 WixBuildInfo,
@@ -161,7 +161,6 @@ namespace WixToolset.Data
161 WixComplexReference, 161 WixComplexReference,
162 WixComponentGroup, 162 WixComponentGroup,
163 WixComponentSearch, 163 WixComponentSearch,
164 WixControl,
165 WixCustomRow, 164 WixCustomRow,
166 WixCustomTable, 165 WixCustomTable,
167 WixDeltaPatchFile, 166 WixDeltaPatchFile,
@@ -594,9 +593,6 @@ namespace WixToolset.Data
594 case TupleDefinitionType.WixApprovedExeForElevation: 593 case TupleDefinitionType.WixApprovedExeForElevation:
595 return TupleDefinitions.WixApprovedExeForElevation; 594 return TupleDefinitions.WixApprovedExeForElevation;
596 595
597 case TupleDefinitionType.WixBBControl:
598 return TupleDefinitions.WixBBControl;
599
600 case TupleDefinitionType.WixBindUpdatedFiles: 596 case TupleDefinitionType.WixBindUpdatedFiles:
601 return TupleDefinitions.WixBindUpdatedFiles; 597 return TupleDefinitions.WixBindUpdatedFiles;
602 598
@@ -687,9 +683,6 @@ namespace WixToolset.Data
687 case TupleDefinitionType.WixComponentSearch: 683 case TupleDefinitionType.WixComponentSearch:
688 return TupleDefinitions.WixComponentSearch; 684 return TupleDefinitions.WixComponentSearch;
689 685
690 case TupleDefinitionType.WixControl:
691 return TupleDefinitions.WixControl;
692
693 case TupleDefinitionType.WixCustomRow: 686 case TupleDefinitionType.WixCustomRow:
694 return TupleDefinitions.WixCustomRow; 687 return TupleDefinitions.WixCustomRow;
695 688
diff --git a/src/WixToolset.Data/Tuples/UpgradeTuple.cs b/src/WixToolset.Data/Tuples/UpgradeTuple.cs
index 94fe1231..efb34733 100644
--- a/src/WixToolset.Data/Tuples/UpgradeTuple.cs
+++ b/src/WixToolset.Data/Tuples/UpgradeTuple.cs
@@ -14,7 +14,12 @@ namespace WixToolset.Data
14 new IntermediateFieldDefinition(nameof(UpgradeTupleFields.VersionMin), IntermediateFieldType.String), 14 new IntermediateFieldDefinition(nameof(UpgradeTupleFields.VersionMin), IntermediateFieldType.String),
15 new IntermediateFieldDefinition(nameof(UpgradeTupleFields.VersionMax), IntermediateFieldType.String), 15 new IntermediateFieldDefinition(nameof(UpgradeTupleFields.VersionMax), IntermediateFieldType.String),
16 new IntermediateFieldDefinition(nameof(UpgradeTupleFields.Language), IntermediateFieldType.String), 16 new IntermediateFieldDefinition(nameof(UpgradeTupleFields.Language), IntermediateFieldType.String),
17 new IntermediateFieldDefinition(nameof(UpgradeTupleFields.Attributes), IntermediateFieldType.Number), 17 new IntermediateFieldDefinition(nameof(UpgradeTupleFields.ExcludeLanguages), IntermediateFieldType.Bool),
18 new IntermediateFieldDefinition(nameof(UpgradeTupleFields.IgnoreRemoveFailures), IntermediateFieldType.Bool),
19 new IntermediateFieldDefinition(nameof(UpgradeTupleFields.MigrateFeatures), IntermediateFieldType.Bool),
20 new IntermediateFieldDefinition(nameof(UpgradeTupleFields.OnlyDetect), IntermediateFieldType.Bool),
21 new IntermediateFieldDefinition(nameof(UpgradeTupleFields.VersionMaxInclusive), IntermediateFieldType.Bool),
22 new IntermediateFieldDefinition(nameof(UpgradeTupleFields.VersionMinInclusive), IntermediateFieldType.Bool),
18 new IntermediateFieldDefinition(nameof(UpgradeTupleFields.Remove), IntermediateFieldType.String), 23 new IntermediateFieldDefinition(nameof(UpgradeTupleFields.Remove), IntermediateFieldType.String),
19 new IntermediateFieldDefinition(nameof(UpgradeTupleFields.ActionProperty), IntermediateFieldType.String), 24 new IntermediateFieldDefinition(nameof(UpgradeTupleFields.ActionProperty), IntermediateFieldType.String),
20 }, 25 },
@@ -30,7 +35,12 @@ namespace WixToolset.Data.Tuples
30 VersionMin, 35 VersionMin,
31 VersionMax, 36 VersionMax,
32 Language, 37 Language,
33 Attributes, 38 ExcludeLanguages,
39 IgnoreRemoveFailures,
40 MigrateFeatures,
41 OnlyDetect,
42 VersionMaxInclusive,
43 VersionMinInclusive,
34 Remove, 44 Remove,
35 ActionProperty, 45 ActionProperty,
36 } 46 }
@@ -71,10 +81,40 @@ namespace WixToolset.Data.Tuples
71 set => this.Set((int)UpgradeTupleFields.Language, value); 81 set => this.Set((int)UpgradeTupleFields.Language, value);
72 } 82 }
73 83
74 public int Attributes 84 public bool ExcludeLanguages
75 { 85 {
76 get => (int)this.Fields[(int)UpgradeTupleFields.Attributes]?.Value; 86 get => this.Fields[(int)UpgradeTupleFields.ExcludeLanguages].AsBool();
77 set => this.Set((int)UpgradeTupleFields.Attributes, value); 87 set => this.Set((int)UpgradeTupleFields.ExcludeLanguages, value);
88 }
89
90 public bool IgnoreRemoveFailures
91 {
92 get => this.Fields[(int)UpgradeTupleFields.IgnoreRemoveFailures].AsBool();
93 set => this.Set((int)UpgradeTupleFields.IgnoreRemoveFailures, value);
94 }
95
96 public bool MigrateFeatures
97 {
98 get => this.Fields[(int)UpgradeTupleFields.MigrateFeatures].AsBool();
99 set => this.Set((int)UpgradeTupleFields.MigrateFeatures, value);
100 }
101
102 public bool OnlyDetect
103 {
104 get => this.Fields[(int)UpgradeTupleFields.OnlyDetect].AsBool();
105 set => this.Set((int)UpgradeTupleFields.OnlyDetect, value);
106 }
107
108 public bool VersionMaxInclusive
109 {
110 get => this.Fields[(int)UpgradeTupleFields.VersionMaxInclusive].AsBool();
111 set => this.Set((int)UpgradeTupleFields.VersionMaxInclusive, value);
112 }
113
114 public bool VersionMinInclusive
115 {
116 get => this.Fields[(int)UpgradeTupleFields.VersionMinInclusive].AsBool();
117 set => this.Set((int)UpgradeTupleFields.VersionMinInclusive, value);
78 } 118 }
79 119
80 public string Remove 120 public string Remove
diff --git a/src/WixToolset.Data/Tuples/WixActionTuple.cs b/src/WixToolset.Data/Tuples/WixActionTuple.cs
index 53ea52de..d196e560 100644
--- a/src/WixToolset.Data/Tuples/WixActionTuple.cs
+++ b/src/WixToolset.Data/Tuples/WixActionTuple.cs
@@ -96,7 +96,7 @@ namespace WixToolset.Data.Tuples
96 96
97 public bool Overridable 97 public bool Overridable
98 { 98 {
99 get => (bool)this.Fields[(int)WixActionTupleFields.Overridable]?.Value; 99 get => this.Fields[(int)WixActionTupleFields.Overridable].AsBool();
100 set => this.Set((int)WixActionTupleFields.Overridable, value); 100 set => this.Set((int)WixActionTupleFields.Overridable, value);
101 } 101 }
102 } 102 }
diff --git a/src/WixToolset.Data/Tuples/WixBBControlTuple.cs b/src/WixToolset.Data/Tuples/WixBBControlTuple.cs
deleted file mode 100644
index 4d912c38..00000000
--- a/src/WixToolset.Data/Tuples/WixBBControlTuple.cs
+++ /dev/null
@@ -1,60 +0,0 @@
1// Copyright (c) .NET Foundation and contributors. All rights reserved. Licensed under the Microsoft Reciprocal License. See LICENSE.TXT file in the project root for full license information.
2
3namespace WixToolset.Data
4{
5 using WixToolset.Data.Tuples;
6
7 public static partial class TupleDefinitions
8 {
9 public static readonly IntermediateTupleDefinition WixBBControl = new IntermediateTupleDefinition(
10 TupleDefinitionType.WixBBControl,
11 new[]
12 {
13 new IntermediateFieldDefinition(nameof(WixBBControlTupleFields.Billboard_), IntermediateFieldType.String),
14 new IntermediateFieldDefinition(nameof(WixBBControlTupleFields.BBControl_), IntermediateFieldType.String),
15 new IntermediateFieldDefinition(nameof(WixBBControlTupleFields.SourceFile), IntermediateFieldType.Path),
16 },
17 typeof(WixBBControlTuple));
18 }
19}
20
21namespace WixToolset.Data.Tuples
22{
23 public enum WixBBControlTupleFields
24 {
25 Billboard_,
26 BBControl_,
27 SourceFile,
28 }
29
30 public class WixBBControlTuple : IntermediateTuple
31 {
32 public WixBBControlTuple() : base(TupleDefinitions.WixBBControl, null, null)
33 {
34 }
35
36 public WixBBControlTuple(SourceLineNumber sourceLineNumber, Identifier id = null) : base(TupleDefinitions.WixBBControl, sourceLineNumber, id)
37 {
38 }
39
40 public IntermediateField this[WixBBControlTupleFields index] => this.Fields[(int)index];
41
42 public string Billboard_
43 {
44 get => (string)this.Fields[(int)WixBBControlTupleFields.Billboard_]?.Value;
45 set => this.Set((int)WixBBControlTupleFields.Billboard_, value);
46 }
47
48 public string BBControl_
49 {
50 get => (string)this.Fields[(int)WixBBControlTupleFields.BBControl_]?.Value;
51 set => this.Set((int)WixBBControlTupleFields.BBControl_, value);
52 }
53
54 public string SourceFile
55 {
56 get => (string)this.Fields[(int)WixBBControlTupleFields.SourceFile]?.Value;
57 set => this.Set((int)WixBBControlTupleFields.SourceFile, value);
58 }
59 }
60} \ No newline at end of file
diff --git a/src/WixToolset.Data/Tuples/WixControlTuple.cs b/src/WixToolset.Data/Tuples/WixControlTuple.cs
deleted file mode 100644
index c86490fb..00000000
--- a/src/WixToolset.Data/Tuples/WixControlTuple.cs
+++ /dev/null
@@ -1,60 +0,0 @@
1// Copyright (c) .NET Foundation and contributors. All rights reserved. Licensed under the Microsoft Reciprocal License. See LICENSE.TXT file in the project root for full license information.
2
3namespace WixToolset.Data
4{
5 using WixToolset.Data.Tuples;
6
7 public static partial class TupleDefinitions
8 {
9 public static readonly IntermediateTupleDefinition WixControl = new IntermediateTupleDefinition(
10 TupleDefinitionType.WixControl,
11 new[]
12 {
13 new IntermediateFieldDefinition(nameof(WixControlTupleFields.Dialog_), IntermediateFieldType.String),
14 new IntermediateFieldDefinition(nameof(WixControlTupleFields.Control_), IntermediateFieldType.String),
15 new IntermediateFieldDefinition(nameof(WixControlTupleFields.SourceFile), IntermediateFieldType.Path),
16 },
17 typeof(WixControlTuple));
18 }
19}
20
21namespace WixToolset.Data.Tuples
22{
23 public enum WixControlTupleFields
24 {
25 Dialog_,
26 Control_,
27 SourceFile,
28 }
29
30 public class WixControlTuple : IntermediateTuple
31 {
32 public WixControlTuple() : base(TupleDefinitions.WixControl, null, null)
33 {
34 }
35
36 public WixControlTuple(SourceLineNumber sourceLineNumber, Identifier id = null) : base(TupleDefinitions.WixControl, sourceLineNumber, id)
37 {
38 }
39
40 public IntermediateField this[WixControlTupleFields index] => this.Fields[(int)index];
41
42 public string Dialog_
43 {
44 get => (string)this.Fields[(int)WixControlTupleFields.Dialog_]?.Value;
45 set => this.Set((int)WixControlTupleFields.Dialog_, value);
46 }
47
48 public string Control_
49 {
50 get => (string)this.Fields[(int)WixControlTupleFields.Control_]?.Value;
51 set => this.Set((int)WixControlTupleFields.Control_, value);
52 }
53
54 public string SourceFile
55 {
56 get => (string)this.Fields[(int)WixControlTupleFields.SourceFile]?.Value;
57 set => this.Set((int)WixControlTupleFields.SourceFile, value);
58 }
59 }
60} \ No newline at end of file
diff --git a/src/WixToolset.Data/Tuples/WixRelatedBundleTuple.cs b/src/WixToolset.Data/Tuples/WixRelatedBundleTuple.cs
index 491e9aa1..5151aa2b 100644
--- a/src/WixToolset.Data/Tuples/WixRelatedBundleTuple.cs
+++ b/src/WixToolset.Data/Tuples/WixRelatedBundleTuple.cs
@@ -10,7 +10,7 @@ namespace WixToolset.Data
10 TupleDefinitionType.WixRelatedBundle, 10 TupleDefinitionType.WixRelatedBundle,
11 new[] 11 new[]
12 { 12 {
13 new IntermediateFieldDefinition(nameof(WixRelatedBundleTupleFields.Id), IntermediateFieldType.String), 13 new IntermediateFieldDefinition(nameof(WixRelatedBundleTupleFields.BundleId), IntermediateFieldType.String),
14 new IntermediateFieldDefinition(nameof(WixRelatedBundleTupleFields.Action), IntermediateFieldType.Number), 14 new IntermediateFieldDefinition(nameof(WixRelatedBundleTupleFields.Action), IntermediateFieldType.Number),
15 }, 15 },
16 typeof(WixRelatedBundleTuple)); 16 typeof(WixRelatedBundleTuple));
@@ -21,10 +21,18 @@ namespace WixToolset.Data.Tuples
21{ 21{
22 public enum WixRelatedBundleTupleFields 22 public enum WixRelatedBundleTupleFields
23 { 23 {
24 Id, 24 BundleId,
25 Action, 25 Action,
26 } 26 }
27 27
28 public enum RelatedBundleActionType
29 {
30 Detect,
31 Upgrade,
32 Addon,
33 Patch
34 }
35
28 public class WixRelatedBundleTuple : IntermediateTuple 36 public class WixRelatedBundleTuple : IntermediateTuple
29 { 37 {
30 public WixRelatedBundleTuple() : base(TupleDefinitions.WixRelatedBundle, null, null) 38 public WixRelatedBundleTuple() : base(TupleDefinitions.WixRelatedBundle, null, null)
@@ -37,16 +45,16 @@ namespace WixToolset.Data.Tuples
37 45
38 public IntermediateField this[WixRelatedBundleTupleFields index] => this.Fields[(int)index]; 46 public IntermediateField this[WixRelatedBundleTupleFields index] => this.Fields[(int)index];
39 47
40 public string Id 48 public string BundleId
41 { 49 {
42 get => (string)this.Fields[(int)WixRelatedBundleTupleFields.Id]?.Value; 50 get => (string)this.Fields[(int)WixRelatedBundleTupleFields.BundleId]?.Value;
43 set => this.Set((int)WixRelatedBundleTupleFields.Id, value); 51 set => this.Set((int)WixRelatedBundleTupleFields.BundleId, value);
44 } 52 }
45 53
46 public int Action 54 public RelatedBundleActionType Action
47 { 55 {
48 get => (int)this.Fields[(int)WixRelatedBundleTupleFields.Action]?.Value; 56 get => (RelatedBundleActionType)this.Fields[(int)WixRelatedBundleTupleFields.Action].AsNumber();
49 set => this.Set((int)WixRelatedBundleTupleFields.Action, value); 57 set => this.Set((int)WixRelatedBundleTupleFields.Action, (int)value);
50 } 58 }
51 } 59 }
52} \ No newline at end of file 60} \ No newline at end of file
diff --git a/src/WixToolset.Data/WindowsInstaller/Rows/ComponentRow.cs b/src/WixToolset.Data/WindowsInstaller/Rows/ComponentRow.cs
index 50ef5313..001703ee 100644
--- a/src/WixToolset.Data/WindowsInstaller/Rows/ComponentRow.cs
+++ b/src/WixToolset.Data/WindowsInstaller/Rows/ComponentRow.cs
@@ -2,8 +2,6 @@
2 2
3namespace WixToolset.Data.WindowsInstaller.Rows 3namespace WixToolset.Data.WindowsInstaller.Rows
4{ 4{
5 using WixToolset.Data.Msi;
6
7 /// <summary> 5 /// <summary>
8 /// Specialization of a row for the Component table. 6 /// Specialization of a row for the Component table.
9 /// </summary> 7 /// </summary>
@@ -57,16 +55,16 @@ namespace WixToolset.Data.WindowsInstaller.Rows
57 /// <value>Local only attribute of the component.</value> 55 /// <value>Local only attribute of the component.</value>
58 public bool IsLocalOnly 56 public bool IsLocalOnly
59 { 57 {
60 get { return MsiInterop.MsidbComponentAttributesLocalOnly == ((int)this.Fields[3].Data & MsiInterop.MsidbComponentAttributesLocalOnly); } 58 get { return WindowsInstallerConstants.MsidbComponentAttributesLocalOnly == ((int)this.Fields[3].Data & WindowsInstallerConstants.MsidbComponentAttributesLocalOnly); }
61 set 59 set
62 { 60 {
63 if (value) 61 if (value)
64 { 62 {
65 this.Fields[3].Data = (int)this.Fields[3].Data | MsiInterop.MsidbComponentAttributesLocalOnly; 63 this.Fields[3].Data = (int)this.Fields[3].Data | WindowsInstallerConstants.MsidbComponentAttributesLocalOnly;
66 } 64 }
67 else 65 else
68 { 66 {
69 this.Fields[3].Data = (int)this.Fields[3].Data & ~MsiInterop.MsidbComponentAttributesLocalOnly; 67 this.Fields[3].Data = (int)this.Fields[3].Data & ~WindowsInstallerConstants.MsidbComponentAttributesLocalOnly;
70 } 68 }
71 } 69 }
72 } 70 }
@@ -77,16 +75,16 @@ namespace WixToolset.Data.WindowsInstaller.Rows
77 /// <value>Source only attribute of the component.</value> 75 /// <value>Source only attribute of the component.</value>
78 public bool IsSourceOnly 76 public bool IsSourceOnly
79 { 77 {
80 get { return MsiInterop.MsidbComponentAttributesSourceOnly == ((int)this.Fields[3].Data & MsiInterop.MsidbComponentAttributesSourceOnly); } 78 get { return WindowsInstallerConstants.MsidbComponentAttributesSourceOnly == ((int)this.Fields[3].Data & WindowsInstallerConstants.MsidbComponentAttributesSourceOnly); }
81 set 79 set
82 { 80 {
83 if (value) 81 if (value)
84 { 82 {
85 this.Fields[3].Data = (int)this.Fields[3].Data | MsiInterop.MsidbComponentAttributesSourceOnly; 83 this.Fields[3].Data = (int)this.Fields[3].Data | WindowsInstallerConstants.MsidbComponentAttributesSourceOnly;
86 } 84 }
87 else 85 else
88 { 86 {
89 this.Fields[3].Data = (int)this.Fields[3].Data & ~MsiInterop.MsidbComponentAttributesSourceOnly; 87 this.Fields[3].Data = (int)this.Fields[3].Data & ~WindowsInstallerConstants.MsidbComponentAttributesSourceOnly;
90 } 88 }
91 } 89 }
92 } 90 }
@@ -97,16 +95,16 @@ namespace WixToolset.Data.WindowsInstaller.Rows
97 /// <value>Optional attribute of the component.</value> 95 /// <value>Optional attribute of the component.</value>
98 public bool IsOptional 96 public bool IsOptional
99 { 97 {
100 get { return MsiInterop.MsidbComponentAttributesOptional == ((int)this.Fields[3].Data & MsiInterop.MsidbComponentAttributesOptional); } 98 get { return WindowsInstallerConstants.MsidbComponentAttributesOptional == ((int)this.Fields[3].Data & WindowsInstallerConstants.MsidbComponentAttributesOptional); }
101 set 99 set
102 { 100 {
103 if (value) 101 if (value)
104 { 102 {
105 this.Fields[3].Data = (int)this.Fields[3].Data | MsiInterop.MsidbComponentAttributesOptional; 103 this.Fields[3].Data = (int)this.Fields[3].Data | WindowsInstallerConstants.MsidbComponentAttributesOptional;
106 } 104 }
107 else 105 else
108 { 106 {
109 this.Fields[3].Data = (int)this.Fields[3].Data & ~MsiInterop.MsidbComponentAttributesOptional; 107 this.Fields[3].Data = (int)this.Fields[3].Data & ~WindowsInstallerConstants.MsidbComponentAttributesOptional;
110 } 108 }
111 } 109 }
112 } 110 }
@@ -117,16 +115,16 @@ namespace WixToolset.Data.WindowsInstaller.Rows
117 /// <value>Registry key path attribute of the component.</value> 115 /// <value>Registry key path attribute of the component.</value>
118 public bool IsRegistryKeyPath 116 public bool IsRegistryKeyPath
119 { 117 {
120 get { return MsiInterop.MsidbComponentAttributesRegistryKeyPath == ((int)this.Fields[3].Data & MsiInterop.MsidbComponentAttributesRegistryKeyPath); } 118 get { return WindowsInstallerConstants.MsidbComponentAttributesRegistryKeyPath == ((int)this.Fields[3].Data & WindowsInstallerConstants.MsidbComponentAttributesRegistryKeyPath); }
121 set 119 set
122 { 120 {
123 if (value) 121 if (value)
124 { 122 {
125 this.Fields[3].Data = (int)this.Fields[3].Data | MsiInterop.MsidbComponentAttributesRegistryKeyPath; 123 this.Fields[3].Data = (int)this.Fields[3].Data | WindowsInstallerConstants.MsidbComponentAttributesRegistryKeyPath;
126 } 124 }
127 else 125 else
128 { 126 {
129 this.Fields[3].Data = (int)this.Fields[3].Data & ~MsiInterop.MsidbComponentAttributesRegistryKeyPath; 127 this.Fields[3].Data = (int)this.Fields[3].Data & ~WindowsInstallerConstants.MsidbComponentAttributesRegistryKeyPath;
130 } 128 }
131 } 129 }
132 } 130 }
@@ -137,16 +135,16 @@ namespace WixToolset.Data.WindowsInstaller.Rows
137 /// <value>Shared dll ref countattribute of the component.</value> 135 /// <value>Shared dll ref countattribute of the component.</value>
138 public bool IsSharedDll 136 public bool IsSharedDll
139 { 137 {
140 get { return MsiInterop.MsidbComponentAttributesSharedDllRefCount == ((int)this.Fields[3].Data & MsiInterop.MsidbComponentAttributesSharedDllRefCount); } 138 get { return WindowsInstallerConstants.MsidbComponentAttributesSharedDllRefCount == ((int)this.Fields[3].Data & WindowsInstallerConstants.MsidbComponentAttributesSharedDllRefCount); }
141 set 139 set
142 { 140 {
143 if (value) 141 if (value)
144 { 142 {
145 this.Fields[3].Data = (int)this.Fields[3].Data | MsiInterop.MsidbComponentAttributesSharedDllRefCount; 143 this.Fields[3].Data = (int)this.Fields[3].Data | WindowsInstallerConstants.MsidbComponentAttributesSharedDllRefCount;
146 } 144 }
147 else 145 else
148 { 146 {
149 this.Fields[3].Data = (int)this.Fields[3].Data & ~MsiInterop.MsidbComponentAttributesSharedDllRefCount; 147 this.Fields[3].Data = (int)this.Fields[3].Data & ~WindowsInstallerConstants.MsidbComponentAttributesSharedDllRefCount;
150 } 148 }
151 } 149 }
152 } 150 }
@@ -157,16 +155,16 @@ namespace WixToolset.Data.WindowsInstaller.Rows
157 /// <value>Permanent attribute of the component.</value> 155 /// <value>Permanent attribute of the component.</value>
158 public bool IsPermanent 156 public bool IsPermanent
159 { 157 {
160 get { return MsiInterop.MsidbComponentAttributesPermanent == ((int)this.Fields[3].Data & MsiInterop.MsidbComponentAttributesPermanent); } 158 get { return WindowsInstallerConstants.MsidbComponentAttributesPermanent == ((int)this.Fields[3].Data & WindowsInstallerConstants.MsidbComponentAttributesPermanent); }
161 set 159 set
162 { 160 {
163 if (value) 161 if (value)
164 { 162 {
165 this.Fields[3].Data = (int)this.Fields[3].Data | MsiInterop.MsidbComponentAttributesPermanent; 163 this.Fields[3].Data = (int)this.Fields[3].Data | WindowsInstallerConstants.MsidbComponentAttributesPermanent;
166 } 164 }
167 else 165 else
168 { 166 {
169 this.Fields[3].Data = (int)this.Fields[3].Data & ~MsiInterop.MsidbComponentAttributesPermanent; 167 this.Fields[3].Data = (int)this.Fields[3].Data & ~WindowsInstallerConstants.MsidbComponentAttributesPermanent;
170 } 168 }
171 } 169 }
172 } 170 }
@@ -177,16 +175,16 @@ namespace WixToolset.Data.WindowsInstaller.Rows
177 /// <value>ODBC data source key path attribute of the component.</value> 175 /// <value>ODBC data source key path attribute of the component.</value>
178 public bool IsOdbcDataSourceKeyPath 176 public bool IsOdbcDataSourceKeyPath
179 { 177 {
180 get { return MsiInterop.MsidbComponentAttributesODBCDataSource == ((int)this.Fields[3].Data & MsiInterop.MsidbComponentAttributesODBCDataSource); } 178 get { return WindowsInstallerConstants.MsidbComponentAttributesODBCDataSource == ((int)this.Fields[3].Data & WindowsInstallerConstants.MsidbComponentAttributesODBCDataSource); }
181 set 179 set
182 { 180 {
183 if (value) 181 if (value)
184 { 182 {
185 this.Fields[3].Data = (int)this.Fields[3].Data | MsiInterop.MsidbComponentAttributesODBCDataSource; 183 this.Fields[3].Data = (int)this.Fields[3].Data | WindowsInstallerConstants.MsidbComponentAttributesODBCDataSource;
186 } 184 }
187 else 185 else
188 { 186 {
189 this.Fields[3].Data = (int)this.Fields[3].Data & ~MsiInterop.MsidbComponentAttributesODBCDataSource; 187 this.Fields[3].Data = (int)this.Fields[3].Data & ~WindowsInstallerConstants.MsidbComponentAttributesODBCDataSource;
190 } 188 }
191 } 189 }
192 } 190 }
@@ -197,16 +195,16 @@ namespace WixToolset.Data.WindowsInstaller.Rows
197 /// <value>64-bitness of the component.</value> 195 /// <value>64-bitness of the component.</value>
198 public bool Is64Bit 196 public bool Is64Bit
199 { 197 {
200 get { return MsiInterop.MsidbComponentAttributes64bit == ((int)this.Fields[3].Data & MsiInterop.MsidbComponentAttributes64bit); } 198 get { return WindowsInstallerConstants.MsidbComponentAttributes64bit == ((int)this.Fields[3].Data & WindowsInstallerConstants.MsidbComponentAttributes64bit); }
201 set 199 set
202 { 200 {
203 if (value) 201 if (value)
204 { 202 {
205 this.Fields[3].Data = (int)this.Fields[3].Data | MsiInterop.MsidbComponentAttributes64bit; 203 this.Fields[3].Data = (int)this.Fields[3].Data | WindowsInstallerConstants.MsidbComponentAttributes64bit;
206 } 204 }
207 else 205 else
208 { 206 {
209 this.Fields[3].Data = (int)this.Fields[3].Data & ~MsiInterop.MsidbComponentAttributes64bit; 207 this.Fields[3].Data = (int)this.Fields[3].Data & ~WindowsInstallerConstants.MsidbComponentAttributes64bit;
210 } 208 }
211 } 209 }
212 } 210 }
diff --git a/src/WixToolset.Data/WindowsInstaller/Rows/FileRow.cs b/src/WixToolset.Data/WindowsInstaller/Rows/FileRow.cs
index 673d2315..cd3660e4 100644
--- a/src/WixToolset.Data/WindowsInstaller/Rows/FileRow.cs
+++ b/src/WixToolset.Data/WindowsInstaller/Rows/FileRow.cs
@@ -5,7 +5,6 @@ namespace WixToolset.Data.WindowsInstaller.Rows
5 using System; 5 using System;
6 using System.Diagnostics; 6 using System.Diagnostics;
7 using System.Globalization; 7 using System.Globalization;
8 using WixToolset.Data.Msi;
9 8
10 /// <summary> 9 /// <summary>
11 /// Specialization of a row for the file table. 10 /// Specialization of a row for the file table.
@@ -174,8 +173,8 @@ namespace WixToolset.Data.WindowsInstaller.Rows
174 { 173 {
175 get 174 get
176 { 175 {
177 bool compressedFlag = (0 < (this.Attributes & MsiInterop.MsidbFileAttributesCompressed)); 176 bool compressedFlag = (0 < (this.Attributes & WindowsInstallerConstants.MsidbFileAttributesCompressed));
178 bool noncompressedFlag = (0 < (this.Attributes & MsiInterop.MsidbFileAttributesNoncompressed)); 177 bool noncompressedFlag = (0 < (this.Attributes & WindowsInstallerConstants.MsidbFileAttributesNoncompressed));
179 178
180 if (compressedFlag && noncompressedFlag) 179 if (compressedFlag && noncompressedFlag)
181 { 180 {
@@ -200,22 +199,22 @@ namespace WixToolset.Data.WindowsInstaller.Rows
200 if (YesNoType.Yes == value) 199 if (YesNoType.Yes == value)
201 { 200 {
202 // these are mutually exclusive 201 // these are mutually exclusive
203 this.Attributes |= MsiInterop.MsidbFileAttributesCompressed; 202 this.Attributes |= WindowsInstallerConstants.MsidbFileAttributesCompressed;
204 this.Attributes &= ~MsiInterop.MsidbFileAttributesNoncompressed; 203 this.Attributes &= ~WindowsInstallerConstants.MsidbFileAttributesNoncompressed;
205 } 204 }
206 else if (YesNoType.No == value) 205 else if (YesNoType.No == value)
207 { 206 {
208 // these are mutually exclusive 207 // these are mutually exclusive
209 this.Attributes |= MsiInterop.MsidbFileAttributesNoncompressed; 208 this.Attributes |= WindowsInstallerConstants.MsidbFileAttributesNoncompressed;
210 this.Attributes &= ~MsiInterop.MsidbFileAttributesCompressed; 209 this.Attributes &= ~WindowsInstallerConstants.MsidbFileAttributesCompressed;
211 } 210 }
212 else // not specified 211 else // not specified
213 { 212 {
214 Debug.Assert(YesNoType.NotSet == value); 213 Debug.Assert(YesNoType.NotSet == value);
215 214
216 // clear any compression bits 215 // clear any compression bits
217 this.Attributes &= ~MsiInterop.MsidbFileAttributesCompressed; 216 this.Attributes &= ~WindowsInstallerConstants.MsidbFileAttributesCompressed;
218 this.Attributes &= ~MsiInterop.MsidbFileAttributesNoncompressed; 217 this.Attributes &= ~WindowsInstallerConstants.MsidbFileAttributesNoncompressed;
219 } 218 }
220 } 219 }
221 } 220 }
diff --git a/src/WixToolset.Data/WindowsInstaller/WindowsInstallerConstants.cs b/src/WixToolset.Data/WindowsInstaller/WindowsInstallerConstants.cs
new file mode 100644
index 00000000..c60f2c0d
--- /dev/null
+++ b/src/WixToolset.Data/WindowsInstaller/WindowsInstallerConstants.cs
@@ -0,0 +1,259 @@
1// Copyright (c) .NET Foundation and contributors. All rights reserved. Licensed under the Microsoft Reciprocal License. See LICENSE.TXT file in the project root for full license information.
2
3namespace WixToolset.Data.WindowsInstaller
4{
5 public static class WindowsInstallerConstants
6 {
7 // Component.Attributes
8 public const int MsidbComponentAttributesLocalOnly = 0;
9 public const int MsidbComponentAttributesSourceOnly = 1;
10 public const int MsidbComponentAttributesOptional = 2;
11 public const int MsidbComponentAttributesRegistryKeyPath = 4;
12 public const int MsidbComponentAttributesSharedDllRefCount = 8;
13 public const int MsidbComponentAttributesPermanent = 16;
14 public const int MsidbComponentAttributesODBCDataSource = 32;
15 public const int MsidbComponentAttributesTransitive = 64;
16 public const int MsidbComponentAttributesNeverOverwrite = 128;
17 public const int MsidbComponentAttributes64bit = 256;
18 public const int MsidbComponentAttributesDisableRegistryReflection = 512;
19 public const int MsidbComponentAttributesUninstallOnSupersedence = 1024;
20 public const int MsidbComponentAttributesShared = 2048;
21
22 // BBControl.Attributes & Control.Attributes
23 public const int MsidbControlAttributesVisible = 0x00000001;
24 public const int MsidbControlAttributesEnabled = 0x00000002;
25 public const int MsidbControlAttributesSunken = 0x00000004;
26 public const int MsidbControlAttributesIndirect = 0x00000008;
27 public const int MsidbControlAttributesInteger = 0x00000010;
28 public const int MsidbControlAttributesRTLRO = 0x00000020;
29 public const int MsidbControlAttributesRightAligned = 0x00000040;
30 public const int MsidbControlAttributesLeftScroll = 0x00000080;
31 public const int MsidbControlAttributesBiDi = MsidbControlAttributesRTLRO | MsidbControlAttributesRightAligned | MsidbControlAttributesLeftScroll;
32
33 // Text controls
34 public const int MsidbControlAttributesTransparent = 0x00010000;
35 public const int MsidbControlAttributesNoPrefix = 0x00020000;
36 public const int MsidbControlAttributesNoWrap = 0x00040000;
37 public const int MsidbControlAttributesFormatSize = 0x00080000;
38 public const int MsidbControlAttributesUsersLanguage = 0x00100000;
39
40 // Edit controls
41 public const int MsidbControlAttributesMultiline = 0x00010000;
42 public const int MsidbControlAttributesPasswordInput = 0x00200000;
43
44 // ProgressBar controls
45 public const int MsidbControlAttributesProgress95 = 0x00010000;
46
47 // VolumeSelectCombo and DirectoryCombo controls
48 public const int MsidbControlAttributesRemovableVolume = 0x00010000;
49 public const int MsidbControlAttributesFixedVolume = 0x00020000;
50 public const int MsidbControlAttributesRemoteVolume = 0x00040000;
51 public const int MsidbControlAttributesCDROMVolume = 0x00080000;
52 public const int MsidbControlAttributesRAMDiskVolume = 0x00100000;
53 public const int MsidbControlAttributesFloppyVolume = 0x00200000;
54
55 // VolumeCostList controls
56 public const int MsidbControlShowRollbackCost = 0x00400000;
57
58 // ListBox and ComboBox controls
59 public const int MsidbControlAttributesSorted = 0x00010000;
60 public const int MsidbControlAttributesComboList = 0x00020000;
61
62 // picture button controls
63 public const int MsidbControlAttributesImageHandle = 0x00010000;
64 public const int MsidbControlAttributesPushLike = 0x00020000;
65 public const int MsidbControlAttributesBitmap = 0x00040000;
66 public const int MsidbControlAttributesIcon = 0x00080000;
67 public const int MsidbControlAttributesFixedSize = 0x00100000;
68 public const int MsidbControlAttributesIconSize16 = 0x00200000;
69 public const int MsidbControlAttributesIconSize32 = 0x00400000;
70 public const int MsidbControlAttributesIconSize48 = 0x00600000;
71 public const int MsidbControlAttributesElevationShield = 0x00800000;
72
73 // RadioButton controls
74 public const int MsidbControlAttributesHasBorder = 0x01000000;
75
76 // CustomAction.Type
77 // executable types
78 public const int MsidbCustomActionTypeDll = 0x00000001; // Target = entry point name
79 public const int MsidbCustomActionTypeExe = 0x00000002; // Target = command line args
80 public const int MsidbCustomActionTypeTextData = 0x00000003; // Target = text string to be formatted and set into property
81 public const int MsidbCustomActionTypeJScript = 0x00000005; // Target = entry point name; null if none to call
82 public const int MsidbCustomActionTypeVBScript = 0x00000006; // Target = entry point name; null if none to call
83 public const int MsidbCustomActionTypeInstall = 0x00000007; // Target = property list for nested engine initialization
84 public const int MsidbCustomActionTypeSourceBits = 0x00000030;
85 public const int MsidbCustomActionTypeTargetBits = 0x00000007;
86 public const int MsidbCustomActionTypeReturnBits = 0x000000C0;
87 public const int MsidbCustomActionTypeExecuteBits = 0x00000700;
88
89 // source of code
90 public const int MsidbCustomActionTypeBinaryData = 0x00000000; // Source = Binary.Name; data stored in stream
91 public const int MsidbCustomActionTypeSourceFile = 0x00000010; // Source = File.File; file part of installation
92 public const int MsidbCustomActionTypeDirectory = 0x00000020; // Source = Directory.Directory; folder containing existing file
93 public const int MsidbCustomActionTypeProperty = 0x00000030; // Source = Property.Property; full path to executable
94
95 // return processing; default is syncronous execution; process return code
96 public const int MsidbCustomActionTypeContinue = 0x00000040; // ignore action return status; continue running
97 public const int MsidbCustomActionTypeAsync = 0x00000080; // run asynchronously
98
99 // execution scheduling flags; default is execute whenever sequenced
100 public const int MsidbCustomActionTypeFirstSequence = 0x00000100; // skip if UI sequence already run
101 public const int MsidbCustomActionTypeOncePerProcess = 0x00000200; // skip if UI sequence already run in same process
102 public const int MsidbCustomActionTypeClientRepeat = 0x00000300; // run on client only if UI already run on client
103 public const int MsidbCustomActionTypeInScript = 0x00000400; // queue for execution within script
104 public const int MsidbCustomActionTypeRollback = 0x00000100; // in conjunction with InScript: queue in Rollback script
105 public const int MsidbCustomActionTypeCommit = 0x00000200; // in conjunction with InScript: run Commit ops from script on success
106
107 // security context flag; default to impersonate as user; valid only if InScript
108 public const int MsidbCustomActionTypeNoImpersonate = 0x00000800; // no impersonation; run in system context
109 public const int MsidbCustomActionTypeTSAware = 0x00004000; // impersonate for per-machine installs on TS machines
110 public const int MsidbCustomActionType64BitScript = 0x00001000; // script should run in 64bit process
111 public const int MsidbCustomActionTypeHideTarget = 0x00002000; // don't record the contents of the Target field in the log file.
112
113 public const int MsidbCustomActionTypePatchUninstall = 0x00008000; // run on patch uninstall
114
115 // Dialog.Attributes
116 public const int MsidbDialogAttributesVisible = 0x00000001;
117 public const int MsidbDialogAttributesModal = 0x00000002;
118 public const int MsidbDialogAttributesMinimize = 0x00000004;
119 public const int MsidbDialogAttributesSysModal = 0x00000008;
120 public const int MsidbDialogAttributesKeepModeless = 0x00000010;
121 public const int MsidbDialogAttributesTrackDiskSpace = 0x00000020;
122 public const int MsidbDialogAttributesUseCustomPalette = 0x00000040;
123 public const int MsidbDialogAttributesRTLRO = 0x00000080;
124 public const int MsidbDialogAttributesRightAligned = 0x00000100;
125 public const int MsidbDialogAttributesLeftScroll = 0x00000200;
126 public const int MsidbDialogAttributesBiDi = MsidbDialogAttributesRTLRO | MsidbDialogAttributesRightAligned | MsidbDialogAttributesLeftScroll;
127 public const int MsidbDialogAttributesError = 0x00010000;
128 public const int CommonControlAttributesInvert = MsidbControlAttributesVisible + MsidbControlAttributesEnabled;
129 public const int DialogAttributesInvert = MsidbDialogAttributesVisible + MsidbDialogAttributesModal + MsidbDialogAttributesMinimize;
130
131 // Feature.Attributes
132 public const int MsidbFeatureAttributesFavorLocal = 0;
133 public const int MsidbFeatureAttributesFavorSource = 1;
134 public const int MsidbFeatureAttributesFollowParent = 2;
135 public const int MsidbFeatureAttributesFavorAdvertise = 4;
136 public const int MsidbFeatureAttributesDisallowAdvertise = 8;
137 public const int MsidbFeatureAttributesUIDisallowAbsent = 16;
138 public const int MsidbFeatureAttributesNoUnsupportedAdvertise = 32;
139
140 // File.Attributes
141 public const int MsidbFileAttributesReadOnly = 1;
142 public const int MsidbFileAttributesHidden = 2;
143 public const int MsidbFileAttributesSystem = 4;
144 public const int MsidbFileAttributesVital = 512;
145 public const int MsidbFileAttributesChecksum = 1024;
146 public const int MsidbFileAttributesPatchAdded = 4096;
147 public const int MsidbFileAttributesNoncompressed = 8192;
148 public const int MsidbFileAttributesCompressed = 16384;
149
150 // IniFile.Action & RemoveIniFile.Action
151 public const int MsidbIniFileActionAddLine = 0;
152 public const int MsidbIniFileActionCreateLine = 1;
153 public const int MsidbIniFileActionRemoveLine = 2;
154 public const int MsidbIniFileActionAddTag = 3;
155 public const int MsidbIniFileActionRemoveTag = 4;
156
157 // MoveFile.Options
158 public const int MsidbMoveFileOptionsMove = 1;
159
160 // ServiceInstall.Attributes
161 public const int MsidbServiceInstallOwnProcess = 0x00000010;
162 public const int MsidbServiceInstallShareProcess = 0x00000020;
163 public const int MsidbServiceInstallInteractive = 0x00000100;
164 public const int MsidbServiceInstallAutoStart = 0x00000002;
165 public const int MsidbServiceInstallDemandStart = 0x00000003;
166 public const int MsidbServiceInstallDisabled = 0x00000004;
167 public const int MsidbServiceInstallErrorIgnore = 0x00000000;
168 public const int MsidbServiceInstallErrorNormal = 0x00000001;
169 public const int MsidbServiceInstallErrorCritical = 0x00000003;
170 public const int MsidbServiceInstallErrorControlVital = 0x00008000;
171
172 // ServiceConfig.Event
173 public const int MsidbServiceConfigEventInstall = 0x00000001;
174 public const int MsidbServiceConfigEventUninstall = 0x00000002;
175 public const int MsidbServiceConfigEventReinstall = 0x00000004;
176
177 // ServiceControl.Attributes
178 public const int MsidbServiceControlEventStart = 0x00000001;
179 public const int MsidbServiceControlEventStop = 0x00000002;
180 public const int MsidbServiceControlEventDelete = 0x00000008;
181 public const int MsidbServiceControlEventUninstallStart = 0x00000010;
182 public const int MsidbServiceControlEventUninstallStop = 0x00000020;
183 public const int MsidbServiceControlEventUninstallDelete = 0x00000080;
184
185 // TextStyle.StyleBits
186 public const int MsidbTextStyleStyleBitsBold = 1;
187 public const int MsidbTextStyleStyleBitsItalic = 2;
188 public const int MsidbTextStyleStyleBitsUnderline = 4;
189 public const int MsidbTextStyleStyleBitsStrike = 8;
190
191 // Upgrade.Attributes
192 public const int MsidbUpgradeAttributesMigrateFeatures = 0x00000001;
193 public const int MsidbUpgradeAttributesOnlyDetect = 0x00000002;
194 public const int MsidbUpgradeAttributesIgnoreRemoveFailure = 0x00000004;
195 public const int MsidbUpgradeAttributesVersionMinInclusive = 0x00000100;
196 public const int MsidbUpgradeAttributesVersionMaxInclusive = 0x00000200;
197 public const int MsidbUpgradeAttributesLanguagesExclusive = 0x00000400;
198
199 // Registry Hive Roots
200 public const int MsidbRegistryRootClassesRoot = 0;
201 public const int MsidbRegistryRootCurrentUser = 1;
202 public const int MsidbRegistryRootLocalMachine = 2;
203 public const int MsidbRegistryRootUsers = 3;
204
205 // Locator Types
206 public const int MsidbLocatorTypeDirectory = 0;
207 public const int MsidbLocatorTypeFileName = 1;
208 public const int MsidbLocatorTypeRawValue = 2;
209 public const int MsidbLocatorType64bit = 16;
210
211 public const int MsidbClassAttributesRelativePath = 1;
212
213 // RemoveFile.InstallMode
214 public const int MsidbRemoveFileInstallModeOnInstall = 0x00000001;
215 public const int MsidbRemoveFileInstallModeOnRemove = 0x00000002;
216 public const int MsidbRemoveFileInstallModeOnBoth = 0x00000003;
217
218 // ODBCDataSource.Registration
219 public const int MsidbODBCDataSourceRegistrationPerMachine = 0;
220 public const int MsidbODBCDataSourceRegistrationPerUser = 1;
221
222 // ModuleConfiguration.Format
223 public const int MsidbModuleConfigurationFormatText = 0;
224 public const int MsidbModuleConfigurationFormatKey = 1;
225 public const int MsidbModuleConfigurationFormatInteger = 2;
226 public const int MsidbModuleConfigurationFormatBitfield = 3;
227
228 // ModuleConfiguration.Attributes
229 public const int MsidbMsmConfigurableOptionKeyNoOrphan = 1;
230 public const int MsidbMsmConfigurableOptionNonNullable = 2;
231
232 // ' Windows API function ShowWindow constants - used in Shortcut table
233 public const int SWSHOWNORMAL = 0x00000001;
234 public const int SWSHOWMAXIMIZED = 0x00000003;
235 public const int SWSHOWMINNOACTIVE = 0x00000007;
236
237 public const int MsidbEmbeddedUI = 0x01;
238 public const int MsidbEmbeddedHandlesBasic = 0x02;
239
240 public const int INSTALLLOGMODE_FATALEXIT = 0x00001;
241 public const int INSTALLLOGMODE_ERROR = 0x00002;
242 public const int INSTALLLOGMODE_WARNING = 0x00004;
243 public const int INSTALLLOGMODE_USER = 0x00008;
244 public const int INSTALLLOGMODE_INFO = 0x00010;
245 public const int INSTALLLOGMODE_FILESINUSE = 0x00020;
246 public const int INSTALLLOGMODE_RESOLVESOURCE = 0x00040;
247 public const int INSTALLLOGMODE_OUTOFDISKSPACE = 0x00080;
248 public const int INSTALLLOGMODE_ACTIONSTART = 0x00100;
249 public const int INSTALLLOGMODE_ACTIONDATA = 0x00200;
250 public const int INSTALLLOGMODE_PROGRESS = 0x00400;
251 public const int INSTALLLOGMODE_COMMONDATA = 0x00800;
252 public const int INSTALLLOGMODE_INITIALIZE = 0x01000;
253 public const int INSTALLLOGMODE_TERMINATE = 0x02000;
254 public const int INSTALLLOGMODE_SHOWDIALOG = 0x04000;
255 public const int INSTALLLOGMODE_RMFILESINUSE = 0x02000000;
256 public const int INSTALLLOGMODE_INSTALLSTART = 0x04000000;
257 public const int INSTALLLOGMODE_INSTALLEND = 0x08000000;
258 }
259}
diff --git a/src/WixToolset.Data/WindowsInstallerStandard.cs b/src/WixToolset.Data/WindowsInstaller/WindowsInstallerStandard.cs
index b8d24b62..96fbe659 100644
--- a/src/WixToolset.Data/WindowsInstallerStandard.cs
+++ b/src/WixToolset.Data/WindowsInstaller/WindowsInstallerStandard.cs
@@ -1,11 +1,11 @@
1// Copyright (c) .NET Foundation and contributors. All rights reserved. Licensed under the Microsoft Reciprocal License. See LICENSE.TXT file in the project root for full license information. 1// Copyright (c) .NET Foundation and contributors. All rights reserved. Licensed under the Microsoft Reciprocal License. See LICENSE.TXT file in the project root for full license information.
2 2
3namespace WixToolset.Data 3namespace WixToolset.Data.WindowsInstaller
4{ 4{
5 using System.Collections.Generic; 5 using System.Collections.Generic;
6 using WixToolset.Data.Tuples; 6 using WixToolset.Data.Tuples;
7 7
8 public class WindowsInstallerStandard 8 public static class WindowsInstallerStandard
9 { 9 {
10 private static readonly HashSet<string> standardActionNames = new HashSet<string> 10 private static readonly HashSet<string> standardActionNames = new HashSet<string>
11 { 11 {
diff --git a/src/WixToolset.Data/WixToolset.Data.csproj b/src/WixToolset.Data/WixToolset.Data.csproj
index 45dc9de6..72bdaa0f 100644
--- a/src/WixToolset.Data/WixToolset.Data.csproj
+++ b/src/WixToolset.Data/WixToolset.Data.csproj
@@ -4,6 +4,7 @@
4<Project Sdk="Microsoft.NET.Sdk"> 4<Project Sdk="Microsoft.NET.Sdk">
5 <PropertyGroup> 5 <PropertyGroup>
6 <TargetFramework>netstandard2.0</TargetFramework> 6 <TargetFramework>netstandard2.0</TargetFramework>
7 <LangVersion>7.3</LangVersion>
7 <Title>WiX Toolset Data</Title> 8 <Title>WiX Toolset Data</Title>
8 <Description></Description> 9 <Description></Description>
9 <DebugType>embedded</DebugType> 10 <DebugType>embedded</DebugType>
@@ -11,7 +12,7 @@
11 </PropertyGroup> 12 </PropertyGroup>
12 13
13 <ItemGroup> 14 <ItemGroup>
14 <PackageReference Include="Microsoft.SourceLink.GitHub" Version="1.0.0-beta-63102-01" PrivateAssets="All"/> 15 <PackageReference Include="Microsoft.SourceLink.GitHub" Version="1.0.0-beta2-18618-05" PrivateAssets="All" />
15 <PackageReference Include="Nerdbank.GitVersioning" Version="2.1.65" PrivateAssets="all" /> 16 <PackageReference Include="Nerdbank.GitVersioning" Version="2.1.65" PrivateAssets="all" />
16 </ItemGroup> 17 </ItemGroup>
17</Project> 18</Project>
diff --git a/src/WixToolset.Data/Xsd/wix.xsd b/src/WixToolset.Data/Xsd/wix.xsd
deleted file mode 100644
index 94ff6742..00000000
--- a/src/WixToolset.Data/Xsd/wix.xsd
+++ /dev/null
@@ -1,13035 +0,0 @@
1<?xml version="1.0" encoding="utf-8"?>
2<!-- Copyright (c) .NET Foundation and contributors. All rights reserved. Licensed under the Microsoft Reciprocal License. See LICENSE.TXT file in the project root for full license information. -->
3
4
5<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
6 xmlns:xse=" http://wixtoolset.org/schemas/XmlSchemaExtension"
7 xmlns:html="http://www.w3.org/1999/xhtml"
8 targetNamespace="http://wixtoolset.org/schemas/v4/wxs"
9 xmlns="http://wixtoolset.org/schemas/v4/wxs">
10 <xs:annotation>
11 <xs:documentation>
12 Schema for describing Windows Installer database files (.msi/.msm/.pcp).
13 </xs:documentation>
14 <xs:appinfo>
15 <xse:main />
16 </xs:appinfo>
17 </xs:annotation>
18 <xs:import namespace="http://www.w3.org/1999/xhtml" />
19 <xs:element name="Wix">
20 <xs:annotation>
21 <xs:documentation>
22 This is the top-level container element for every wxs file. Among the possible children,
23 the Bundle, Product, Module, Patch, and PatchCreation elements are analogous to the main function in a C program.
24 There can only be one of these present when linking occurs. Product compiles into an msi file,
25 Module compiles into an msm file, PatchCreation compiles into a pcp file. The Fragment element
26 is an atomic unit which ultimately links into either a Product, Module, or PatchCreation. The
27 Fragment can either be completely included or excluded during linking.
28 </xs:documentation>
29 </xs:annotation>
30 <xs:complexType>
31 <xs:choice minOccurs="0">
32 <xs:sequence>
33 <xs:choice minOccurs="0">
34 <xs:element ref="Bundle" />
35 <xs:element ref="Product" />
36 <xs:element ref="Module" />
37 <xs:element ref="Patch" />
38 </xs:choice>
39 <xs:element ref="Fragment" minOccurs="0" maxOccurs="unbounded" />
40 </xs:sequence>
41 <xs:element ref="PatchCreation" />
42 </xs:choice>
43 <xs:attribute name="RequiredVersion" type="VersionType">
44 <xs:annotation>
45 <xs:documentation>Required version of the WiX toolset to compile this input file.</xs:documentation>
46 </xs:annotation>
47 </xs:attribute>
48 <xs:anyAttribute namespace="##other" processContents="lax">
49 <xs:annotation>
50 <xs:documentation>
51 Extensibility point in the WiX XML Schema. Schema extensions can register additional attributes at this point in the schema.
52 </xs:documentation>
53 </xs:annotation>
54 </xs:anyAttribute>
55 </xs:complexType>
56 </xs:element>
57 <xs:element name="Include">
58 <xs:annotation>
59 <xs:documentation>
60 This is the top-level container element for every wxi file.
61 </xs:documentation>
62 </xs:annotation>
63 <xs:complexType>
64 <xs:choice minOccurs="0" maxOccurs="unbounded">
65 <xs:any namespace="##any" processContents="lax" />
66 </xs:choice>
67 </xs:complexType>
68 </xs:element>
69 <xs:element name="Bundle">
70 <xs:annotation>
71 <xs:documentation>The root element for creating bundled packages.</xs:documentation>
72 </xs:annotation>
73 <xs:complexType>
74 <xs:choice minOccurs="0" maxOccurs="unbounded">
75 <xs:element ref="ApprovedExeForElevation" minOccurs="0" maxOccurs="unbounded" />
76 <xs:element ref="Log" minOccurs="0" maxOccurs="1" />
77 <xs:element ref="Catalog" minOccurs="0" maxOccurs="unbounded" />
78 <xs:element ref="BootstrapperApplication" minOccurs="0" maxOccurs="1" />
79 <xs:element ref="BootstrapperApplicationRef" minOccurs="0" maxOccurs="1" />
80 <xs:element ref="OptionalUpdateRegistration" minOccurs="0" maxOccurs="1" />
81 <xs:element ref="Chain" minOccurs="1" maxOccurs="1" />
82 <xs:element ref="Container" />
83 <xs:element ref="ContainerRef" />
84 <xs:element ref="PayloadGroup" />
85 <xs:element ref="PayloadGroupRef" />
86 <xs:element ref="RelatedBundle" />
87 <xs:element ref="Update" />
88 <xs:element ref="Variable" />
89 <xs:element ref="WixVariable" />
90 <xs:any namespace="##other" processContents="lax">
91 <xs:annotation>
92 <xs:documentation>
93 Extensibility point in the WiX XML Schema. Schema extensions can register additional
94 elements at this point in the schema.
95 </xs:documentation>
96 </xs:annotation>
97 </xs:any>
98 </xs:choice>
99 <xs:attribute name="AboutUrl" type="xs:string">
100 <xs:annotation>
101 <xs:documentation>
102 A URL for more information about the bundle to display in Programs and Features (also
103 known as Add/Remove Programs).
104 </xs:documentation>
105 </xs:annotation>
106 </xs:attribute>
107 <xs:attribute name="Copyright" type="xs:string">
108 <xs:annotation>
109 <xs:documentation>
110 The legal copyright found in the version resources of final bundle executable. If
111 this attribute is not provided the copyright will be set to "Copyright (c) [Bundle/@Manufacturer]. All rights reserved.".
112 </xs:documentation>
113 </xs:annotation>
114 </xs:attribute>
115 <xs:attribute name="Compressed" type="YesNoDefaultTypeUnion">
116 <xs:annotation>
117 <xs:documentation>Whether Packages and Payloads not assigned to a container should be added to the default attached container or if they should be external. The default is yes.</xs:documentation>
118 </xs:annotation>
119 </xs:attribute>
120 <xs:attribute name="DisableModify" type="YesNoButtonTypeUnion">
121 <xs:annotation>
122 <xs:documentation>
123 Determines whether the bundle can be modified via the Programs and Features (also known as
124 Add/Remove Programs). If the value is "button" then Programs and Features will show a single
125 "Uninstall/Change" button. If the value is "yes" then Programs and Features will only show
126 the "Uninstall" button". If the value is "no", the default, then a "Change" button is shown.
127 See the DisableRemove attribute for information how to not display the bundle in Programs
128 and Features.
129 </xs:documentation>
130 </xs:annotation>
131 </xs:attribute>
132 <xs:attribute name="DisableRemove" type="YesNoTypeUnion">
133 <xs:annotation>
134 <xs:documentation>
135 Determines whether the bundle can be removed via the Programs and Features (also
136 known as Add/Remove Programs). If the value is "yes" then the "Uninstall" button will
137 not be displayed. The default is "no" which ensures there is an "Uninstall" button to
138 remove the bundle. If the "DisableModify" attribute is also "yes" or "button" then the
139 bundle will not be displayed in Progams and Features and another mechanism (such as
140 registering as a related bundle addon) must be used to ensure the bundle can be removed.
141 </xs:documentation>
142 </xs:annotation>
143 </xs:attribute>
144 <xs:attribute name="DisableRepair" type="YesNoTypeUnion">
145 <xs:annotation>
146 <xs:appinfo>
147 <xse:deprecated />
148 </xs:appinfo>
149 </xs:annotation>
150 </xs:attribute>
151 <xs:attribute name="HelpTelephone" type="xs:string">
152 <xs:annotation>
153 <xs:documentation>
154 A telephone number for help to display in Programs and Features (also known as
155 Add/Remove Programs).
156 </xs:documentation>
157 </xs:annotation>
158 </xs:attribute>
159 <xs:attribute name="HelpUrl" type="xs:string">
160 <xs:annotation>
161 <xs:documentation>
162 A URL to the help for the bundle to display in Programs and Features (also known as
163 Add/Remove Programs).
164 </xs:documentation>
165 </xs:annotation>
166 </xs:attribute>
167 <xs:attribute name="IconSourceFile" type="xs:string">
168 <xs:annotation>
169 <xs:documentation>
170 Path to an icon that will replace the default icon in the final Bundle executable.
171 This icon will also be displayed in Programs and Features (also known as Add/Remove
172 Programs).
173 </xs:documentation>
174 </xs:annotation>
175 </xs:attribute>
176 <xs:attribute name="Manufacturer" type="xs:string">
177 <xs:annotation>
178 <xs:documentation>
179 The publisher of the bundle to display in Programs and Features (also known as
180 Add/Remove Programs).
181 </xs:documentation>
182 </xs:annotation>
183 </xs:attribute>
184 <xs:attribute name="Name" type="xs:string">
185 <xs:annotation>
186 <xs:documentation>
187 The name of the bundle to display in Programs and Features (also known as Add/Remove
188 Programs). This name can be accessed and overwritten by a BootstrapperApplication
189 using the WixBundleName bundle variable.
190 </xs:documentation>
191 </xs:annotation>
192 </xs:attribute>
193 <xs:attribute name="ParentName" type="xs:string">
194 <xs:annotation>
195 <xs:documentation>
196 The name of the parent bundle to display in Installed Updates (also known as Add/Remove
197 Programs). This name is used to nest or group bundles that will appear as updates.
198 If the parent name does not actually exist, a virtual parent is created automatically.
199 </xs:documentation>
200 </xs:annotation>
201 </xs:attribute>
202 <xs:attribute name="SplashScreenSourceFile" type="xs:string">
203 <xs:annotation>
204 <xs:documentation>Path to a bitmap that will be shown as the bootstrapper application is being loaded. If this attribute is not specified, no splash screen will be displayed.</xs:documentation>
205 </xs:annotation>
206 </xs:attribute>
207 <xs:attribute name="Tag" type="xs:string">
208 <xs:annotation>
209 <xs:documentation>Set this string to uniquely identify this bundle to its own BA, and to related bundles. The value of this string only matters to the BA, and its value has no direct effect on engine functionality.</xs:documentation>
210 </xs:annotation>
211 </xs:attribute>
212 <xs:attribute name="UpdateUrl" type="xs:string">
213 <xs:annotation>
214 <xs:documentation>
215 A URL for updates of the bundle to display in Programs and Features (also
216 known as Add/Remove Programs).
217 </xs:documentation>
218 </xs:annotation>
219 </xs:attribute>
220 <xs:attribute name="UpgradeCode" type="Guid" use="required">
221 <xs:annotation>
222 <xs:documentation>
223 Unique identifier for a family of bundles. If two bundles have the same UpgradeCode the
224 bundle with the highest version will be installed.
225 </xs:documentation>
226 </xs:annotation>
227 </xs:attribute>
228 <xs:attribute name="Version" type="xs:string" use="required">
229 <xs:annotation>
230 <xs:documentation>
231 The version of the bundle. Newer versions upgrade earlier versions of the bundles
232 with matching UpgradeCodes. If the bundle is registered in Programs and Features
233 then this attribute will be displayed in the Programs and Features user interface.
234 </xs:documentation>
235 </xs:annotation>
236 </xs:attribute>
237 <xs:attribute name="Condition" type="xs:string">
238 <xs:annotation>
239 <xs:documentation>
240 The condition of the bundle. If the condition is not met, the bundle will
241 refuse to run. Conditions are checked before the bootstrapper application is loaded
242 (before detect), and thus can only reference built-in variables such as
243 variables which indicate the version of the OS.
244 </xs:documentation>
245 </xs:annotation>
246 </xs:attribute>
247 <xs:anyAttribute namespace="##other" processContents="lax">
248 <xs:annotation>
249 <xs:documentation>
250 Extensibility point in the WiX XML Schema. Schema extensions can register additional
251 attributes at this point in the schema.
252 </xs:documentation>
253 </xs:annotation>
254 </xs:anyAttribute>
255 </xs:complexType>
256 </xs:element>
257 <xs:element name="ApprovedExeForElevation">
258 <xs:annotation>
259 <xs:documentation>Provides information about an .exe so that the BA can request the engine to run it elevated from any secure location.</xs:documentation>
260 <xs:appinfo>
261 <xse:parent namespace="http://schemas.microsoft.com/wix/2006/wi" ref="Bundle" />
262 </xs:appinfo>
263 </xs:annotation>
264 <xs:complexType>
265 <xs:attribute name="Id" type="xs:string" use="required">
266 <xs:annotation>
267 <xs:documentation>The identifier of the ApprovedExeForElevation element.</xs:documentation>
268 </xs:annotation>
269 </xs:attribute>
270 <xs:attribute name="Key" type="xs:string" use="required">
271 <xs:annotation>
272 <xs:documentation>
273 The key path.
274 For security purposes, the root key will be HKLM and Variables are not supported.
275 </xs:documentation>
276 </xs:annotation>
277 </xs:attribute>
278 <xs:attribute name="Value" type="xs:string">
279 <xs:annotation>
280 <xs:documentation>
281 The value name.
282 For security purposes, Variables are not supported.
283 </xs:documentation>
284 </xs:annotation>
285 </xs:attribute>
286 <xs:attribute name="Win64" type="YesNoTypeUnion">
287 <xs:annotation>
288 <xs:documentation>
289 Instructs the search to look in the 64-bit registry when the value is 'yes'.
290 When the value is 'no', the search looks in the 32-bit registry.
291 The default value is 'no'.
292 </xs:documentation>
293 </xs:annotation>
294 </xs:attribute>
295 </xs:complexType>
296 </xs:element>
297 <xs:element name="Log">
298 <xs:annotation>
299 <xs:documentation>Overrides the default log settings for a bundle.</xs:documentation>
300 <xs:appinfo>
301 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Bundle" />
302 </xs:appinfo>
303 </xs:annotation>
304 <xs:complexType>
305 <xs:attribute name="Disable" type="YesNoTypeUnion">
306 <xs:annotation>
307 <xs:documentation>
308 Disables the default logging in the Bundle. The end user can still generate a
309 log file by specifying the "-l" command-line argument when installing the
310 Bundle.
311 </xs:documentation>
312 </xs:annotation>
313 </xs:attribute>
314 <xs:attribute name="PathVariable" type="xs:string">
315 <xs:annotation>
316 <xs:documentation>
317 Name of a Variable that will hold the path to the log file. An empty value
318 will cause the variable to not be set. The default is "WixBundleLog".
319 </xs:documentation>
320 </xs:annotation>
321 </xs:attribute>
322 <xs:attribute name="Prefix" type="xs:string">
323 <xs:annotation>
324 <xs:documentation>
325 File name and optionally a relative path to use as the prefix for the log file. The
326 default is to use the Bundle/@Name or, if Bundle/@Name is not specified, the value
327 "Setup".
328 </xs:documentation>
329 </xs:annotation>
330 </xs:attribute>
331 <xs:attribute name="Extension" type="xs:string">
332 <xs:annotation>
333 <xs:documentation>The extension to use for the log. The default is ".log".</xs:documentation>
334 </xs:annotation>
335 </xs:attribute>
336 </xs:complexType>
337 </xs:element>
338 <xs:element name="Catalog">
339 <xs:annotation>
340 <xs:documentation>Specify one or more catalog files that will be used to verify the contents of the bundle.</xs:documentation>
341 <xs:appinfo>
342 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Bundle" />
343 </xs:appinfo>
344 </xs:annotation>
345 <xs:complexType>
346 <xs:attribute name="Id" type="xs:string">
347 <xs:annotation>
348 <xs:documentation>The identifier of the catalog element.</xs:documentation>
349 </xs:annotation>
350 </xs:attribute>
351 <xs:attribute name="SourceFile" type="xs:string">
352 <xs:annotation>
353 <xs:documentation>The catalog file</xs:documentation>
354 </xs:annotation>
355 </xs:attribute>
356 </xs:complexType>
357 </xs:element>
358 <xs:element name="BootstrapperApplication">
359 <xs:annotation>
360 <xs:documentation>Contains all the relevant information about the setup UI.</xs:documentation>
361 <xs:appinfo>
362 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Bundle" />
363 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
364 </xs:appinfo>
365 </xs:annotation>
366 <xs:complexType>
367 <xs:choice minOccurs="0" maxOccurs="unbounded">
368 <xs:element ref="Payload" />
369 <xs:element ref="PayloadGroupRef" />
370 <xs:any namespace="##other" processContents="lax">
371 <xs:annotation>
372 <xs:documentation>
373 Extensibility point in the WiX XML Schema. Schema extensions can register additional
374 elements at this point in the schema.
375 </xs:documentation>
376 </xs:annotation>
377 </xs:any>
378 </xs:choice>
379 <xs:attribute name="Id" type="xs:string">
380 <xs:annotation>
381 <xs:documentation>The identifier of the BootstrapperApplication element. Only required if you want to reference this element using a BootstrapperApplicationRef element.</xs:documentation>
382 </xs:annotation>
383 </xs:attribute>
384 <xs:attribute name="SourceFile" type="xs:string">
385 <xs:annotation>
386 <xs:documentation>The DLL with the bootstrapper application entry function.</xs:documentation>
387 </xs:annotation>
388 </xs:attribute>
389 <xs:attribute name="Name" type="xs:string">
390 <xs:annotation>
391 <xs:documentation>The relative destination path and file name for the bootstrapper application DLL. The default is the source file name. Use this attribute to rename the bootstrapper application DLL or extract it into a subfolder. The use of '..' directories is not allowed.</xs:documentation>
392 </xs:annotation>
393 </xs:attribute>
394 </xs:complexType>
395 </xs:element>
396 <xs:element name="BootstrapperApplicationRef">
397 <xs:annotation>
398 <xs:documentation>Used to reference a BootstrapperApplication element and optionally add additional payloads to the bootstrapper application.</xs:documentation>
399 <xs:appinfo>
400 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Bundle" />
401 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
402 </xs:appinfo>
403 </xs:annotation>
404 <xs:complexType>
405 <xs:choice minOccurs="0" maxOccurs="unbounded">
406 <xs:element ref="Payload" />
407 <xs:element ref="PayloadGroupRef" />
408 <xs:any namespace="##other" processContents="lax">
409 <xs:annotation>
410 <xs:documentation>
411 Extensibility point in the WiX XML Schema. Schema extensions can register additional
412 elements at this point in the schema.
413 </xs:documentation>
414 </xs:annotation>
415 </xs:any>
416 </xs:choice>
417 <xs:attribute name="Id" type="xs:string" use="required">
418 <xs:annotation>
419 <xs:documentation>The identifier of the BootstrapperApplication element to reference.</xs:documentation>
420 </xs:annotation>
421 </xs:attribute>
422 <xs:anyAttribute namespace="##other" processContents="lax">
423 <xs:annotation>
424 <xs:documentation>
425 Extensibility point in the WiX XML Schema. Schema extensions can register additional
426 attributes at this point in the schema.
427 </xs:documentation>
428 </xs:annotation>
429 </xs:anyAttribute>
430 </xs:complexType>
431 </xs:element>
432 <xs:element name="UX">
433 <xs:annotation>
434 <xs:documentation>This element has been deprecated. Use the BootstrapperApplication element instead.</xs:documentation>
435 <xs:appinfo>
436 <xse:deprecated ref="BootstrapperApplication" />
437 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Bundle" />
438 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
439 </xs:appinfo>
440 </xs:annotation>
441 <xs:complexType>
442 <xs:choice minOccurs="0" maxOccurs="unbounded">
443 <xs:element ref="Payload" />
444 <xs:element ref="PayloadGroupRef" />
445 </xs:choice>
446 <xs:attribute name="SourceFile" type="xs:string">
447 <xs:annotation>
448 <xs:documentation>See the BootstrapperApplication instead.</xs:documentation>
449 </xs:annotation>
450 </xs:attribute>
451 <xs:attribute name="Name" type="xs:string">
452 <xs:annotation>
453 <xs:documentation>See the BootstrapperApplication instead.</xs:documentation>
454 </xs:annotation>
455 </xs:attribute>
456 <xs:attribute name="SplashScreenSourceFile" type="xs:string">
457 <xs:annotation>
458 <xs:documentation>See the BootstrapperApplication instead.</xs:documentation>
459 </xs:annotation>
460 </xs:attribute>
461 </xs:complexType>
462 </xs:element>
463 <xs:element name="OptionalUpdateRegistration">
464 <xs:annotation>
465 <xs:documentation>Writes additional information to the Windows registry that can be used to detect the bundle.
466 This registration is intended primarily for update to an existing product.</xs:documentation>
467 <xs:appinfo>
468 <xse:remarks>
469 <html:p>The attributes are used to write the following registry values to the key:
470 <html:code>SOFTWARE\[Manufacturer]\Updates\[ProductFamily]\[Name]</html:code></html:p>
471 <html:ul>
472 <html:li>ThisVersionInstalled: Y</html:li>
473 <html:li>PackageName: &gt;bundle name&lt;</html:li>
474 <html:li>PackageVersion: &gt;bundle version&lt;</html:li>
475 <html:li>Publisher: [Manufacturer]</html:li>
476 <html:li>PublishingGroup: [Department]</html:li>
477 <html:li>ReleaseType: [Classification]</html:li>
478 <html:li>InstalledBy: [LogonUser]</html:li>
479 <html:li>InstalledDate: [Date]</html:li>
480 <html:li>InstallerName: &gt;installer name&lt;</html:li>
481 <html:li>InstallerVersion: &gt;installer version&lt;</html:li>
482 </html:ul>
483 </xse:remarks>
484 </xs:appinfo>
485 </xs:annotation>
486 <xs:complexType>
487 <xs:attribute name="Manufacturer" type="xs:string">
488 <xs:annotation>
489 <xs:documentation>The name of the manufacturer. The default is the Bundle/@Manufacturer attribute,
490 but may also be a short form, ex: Acme instead of Acme Corporation.
491 An error is generated at build time if neither attribute is specified.</xs:documentation>
492 </xs:annotation>
493 </xs:attribute>
494 <xs:attribute name="Department" type="xs:string">
495 <xs:annotation>
496 <xs:documentation>The name of the department or division publishing the update bundle.
497 The PublishingGroup registry value is not written if this attribute is not specified.</xs:documentation>
498 </xs:annotation>
499 </xs:attribute>
500 <xs:attribute name="ProductFamily" type="xs:string">
501 <xs:annotation>
502 <xs:documentation>The name of the family of products being updated. The default is the Bundle/@ParentName attribute.
503 The corresponding registry key is not created if neither attribute is specified.</xs:documentation>
504 </xs:annotation>
505 </xs:attribute>
506 <xs:attribute name="Name" type="xs:string">
507 <xs:annotation>
508 <xs:documentation>The name of the bundle. The default is the Bundle/@Name attribute,
509 but may also be a short form, ex: KB12345 instead of Update to Product (KB12345).
510 An error is generated at build time if neither attribute is specified.</xs:documentation>
511 </xs:annotation>
512 </xs:attribute>
513 <xs:attribute name="Classification" type="xs:string" default="Update">
514 <xs:annotation>
515 <xs:documentation>The release type of the update bundle, such as Update, Security Update, Service Pack, etc.
516 The default value is Update.</xs:documentation>
517 </xs:annotation>
518 </xs:attribute>
519 </xs:complexType>
520 </xs:element>
521 <xs:element name="Chain">
522 <xs:annotation>
523 <xs:documentation>Contains the chain of packages to install.</xs:documentation>
524 <xs:appinfo>
525 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Bundle" />
526 </xs:appinfo>
527 </xs:annotation>
528 <xs:complexType>
529 <xs:choice minOccurs="0" maxOccurs="unbounded">
530 <xs:element ref="MsiPackage" />
531 <xs:element ref="MspPackage" />
532 <xs:element ref="MsuPackage" />
533 <xs:element ref="ExePackage" />
534 <xs:element ref="RollbackBoundary" />
535 <xs:element ref="PackageGroupRef" />
536 </xs:choice>
537 <xs:attribute name="DisableRollback" type="YesNoTypeUnion">
538 <xs:annotation>
539 <xs:documentation>
540 Specifies whether the bundle will attempt to rollback packages
541 executed in the chain. If "yes" is specified then when a vital
542 package fails to install only that package will rollback and the
543 chain will stop with the error. The default is "no" which
544 indicates all packages executed during the chain will be
545 rolledback to their previous state when a vital package fails.
546 </xs:documentation>
547 </xs:annotation>
548 </xs:attribute>
549 <xs:attribute name="DisableSystemRestore" type="YesNoTypeUnion">
550 <xs:annotation>
551 <xs:documentation>
552 Specifies whether the bundle will attempt to create a system
553 restore point when executing the chain. If "yes" is specified then
554 a system restore point will not be created. The default is "no" which
555 indicates a system restore point will be created when the bundle is
556 installed, uninstalled, repaired, modified, etc. If the system restore
557 point cannot be created, the bundle will log the issue and continue.
558 </xs:documentation>
559 </xs:annotation>
560 </xs:attribute>
561 <xs:attribute name="ParallelCache" type="YesNoTypeUnion">
562 <xs:annotation>
563 <xs:documentation>
564 Specifies whether the bundle will start installing packages
565 while other packages are still being cached. If "yes",
566 packages will start executing when a rollback boundary is
567 encountered. The default is "no" which dictates all packages
568 must be cached before any packages will start to be installed.
569 </xs:documentation>
570 </xs:annotation>
571 </xs:attribute>
572 </xs:complexType>
573 </xs:element>
574 <xs:element name="MsiPackage">
575 <xs:annotation>
576 <xs:documentation>Describes a single msi package to install.</xs:documentation>
577 <xs:appinfo>
578 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Chain" />
579 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="PackageGroup" />
580 </xs:appinfo>
581 </xs:annotation>
582 <xs:complexType>
583 <xs:choice minOccurs="0" maxOccurs="unbounded">
584 <xs:element ref="MsiProperty" />
585 <xs:element ref="SlipstreamMsp" />
586 <xs:element ref="Payload" />
587 <xs:element ref="PayloadGroupRef" />
588 <xs:any namespace="##other" processContents="lax">
589 <xs:annotation>
590 <xs:documentation>
591 Extensibility point in the WiX XML Schema. Schema extensions can register additional
592 elements at this point in the schema. The extension's
593 <html:code><html:nobr>CompilerExtension.ParseElement()</html:nobr></html:code>
594 method will be called with the package identifier as the first value in
595 <html:code>contextValues</html:code>.
596 </xs:documentation>
597 </xs:annotation>
598 </xs:any>
599 </xs:choice>
600 <xs:attributeGroup ref="ChainPackageCommonAttributes" />
601 <xs:attribute name="DisplayInternalUI" type="YesNoTypeUnion">
602 <xs:annotation>
603 <xs:documentation>
604 Specifies whether the bundle will show the UI authored into the msi package. The default is "no"
605 which means all information is routed to the bootstrapper application to provide a unified installation
606 experience. If "yes" is specified the UI authored into the msi package will be displayed on top of
607 any bootstrapper application UI.
608 </xs:documentation>
609 </xs:annotation>
610 </xs:attribute>
611 <xs:attribute name="EnableFeatureSelection" type="YesNoTypeUnion">
612 <xs:annotation>
613 <xs:documentation>
614 Specifies whether the bundle will allow individual control over the installation state of Features inside
615 the msi package. Managing feature selection requires special care to ensure the install, modify, update and
616 uninstall behavior of the package is always correct. The default is "no".
617 </xs:documentation>
618 </xs:annotation>
619 </xs:attribute>
620 <xs:attribute name="ForcePerMachine" type="YesNoTypeUnion">
621 <xs:annotation>
622 <xs:documentation>
623 Override the automatic per-machine detection of MSI packages and force the package to be per-machine.
624 The default is "no", which allows the tools to detect the expected value.
625 </xs:documentation>
626 </xs:annotation>
627 </xs:attribute>
628 <xs:attribute name="SuppressLooseFilePayloadGeneration" type="YesNoTypeUnion">
629 <xs:annotation>
630 <xs:documentation>
631 This attribute has been deprecated. When the value is "yes", the Binder will not read the MSI package
632 to detect uncompressed files that would otherwise be automatically included in the Bundle as Payloads.
633 The resulting Bundle may not be able to install the MSI package correctly. The default is "no".
634 </xs:documentation>
635 </xs:annotation>
636 </xs:attribute>
637 <xs:attribute name="Visible" type="YesNoTypeUnion">
638 <xs:annotation>
639 <xs:documentation>
640 Specifies whether the MSI will be displayed in Programs and Features (also known as Add/Remove Programs). If "yes" is
641 specified the MSI package information will be displayed in Programs and Features. The default "no" indicates the MSI
642 will not be displayed.
643 </xs:documentation>
644 </xs:annotation>
645 </xs:attribute>
646 </xs:complexType>
647 </xs:element>
648 <xs:element name="MspPackage">
649 <xs:annotation>
650 <xs:documentation>Describes a single msp package to install.</xs:documentation>
651 <xs:appinfo>
652 <xse:seeAlso ref="SlipstreamMsp" />
653 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Chain" />
654 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="PackageGroup" />
655 </xs:appinfo>
656 </xs:annotation>
657 <xs:complexType>
658 <xs:choice minOccurs="0" maxOccurs="unbounded">
659 <xs:element ref="MsiProperty" />
660 <xs:element ref="Payload" />
661 <xs:element ref="PayloadGroupRef" />
662 <xs:any namespace="##other" processContents="lax">
663 <xs:annotation>
664 <xs:documentation>
665 Extensibility point in the WiX XML Schema. Schema extensions can register additional
666 elements at this point in the schema. The extension's
667 <html:code><html:nobr>CompilerExtension.ParseElement()</html:nobr></html:code>
668 method will be called with the package identifier as the first value in
669 <html:code>contextValues</html:code>.
670 </xs:documentation>
671 </xs:annotation>
672 </xs:any>
673 </xs:choice>
674 <xs:attributeGroup ref="ChainPackageCommonAttributes" />
675 <xs:attribute name="DisplayInternalUI" type="YesNoTypeUnion">
676 <xs:annotation>
677 <xs:documentation>
678 Specifies whether the bundle will show the UI authored into the msp package. The default is "no"
679 which means all information is routed to the bootstrapper application to provide a unified installation
680 experience. If "yes" is specified the UI authored into the msp package will be displayed on top of
681 any bootstrapper application UI.
682 </xs:documentation>
683 </xs:annotation>
684 </xs:attribute>
685 <xs:attribute name="PerMachine" type="YesNoDefaultTypeUnion">
686 <xs:annotation>
687 <xs:documentation>Indicates the package must be executed elevated. The default is "no".</xs:documentation>
688 </xs:annotation>
689 </xs:attribute>
690 <xs:attribute name="Slipstream" type="YesNoTypeUnion">
691 <xs:annotation>
692 <xs:documentation>
693 Specifies whether to automatically slipstream the patch for any target msi packages in the chain. The default is "no".
694 Even when the value is "no", you can still author the SlipstreamMsp element under MsiPackage elements as desired.
695 </xs:documentation>
696 </xs:annotation>
697 </xs:attribute>
698 </xs:complexType>
699 </xs:element>
700 <xs:element name="MsuPackage">
701 <xs:annotation>
702 <xs:documentation>Describes a single msu package to install.</xs:documentation>
703 <xs:appinfo>
704 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Chain" />
705 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="PackageGroup" />
706 </xs:appinfo>
707 </xs:annotation>
708 <xs:complexType>
709 <xs:choice minOccurs="0" maxOccurs="unbounded">
710 <xs:element ref="Payload" />
711 <xs:element ref="PayloadGroupRef" />
712 <xs:element ref="RemotePayload" />
713 <xs:any namespace="##other" processContents="lax">
714 <xs:annotation>
715 <xs:documentation>
716 Extensibility point in the WiX XML Schema. Schema extensions can register additional
717 elements at this point in the schema. The extension's
718 <html:code><html:nobr>CompilerExtension.ParseElement()</html:nobr></html:code>
719 method will be called with the package identifier as the first value in
720 <html:code>contextValues</html:code>.
721 </xs:documentation>
722 </xs:annotation>
723 </xs:any>
724 </xs:choice>
725 <xs:attributeGroup ref="ChainPackageCommonAttributes" />
726 <xs:attribute name="DetectCondition" type="xs:string">
727 <xs:annotation>
728 <xs:documentation>
729 A condition that determines if the package is present on the target system. This condition can use built-in
730 variables and variables returned by searches. This condition is necessary because Windows doesn't provide a
731 method to detect the presence of an MsuPackage. Burn uses this condition to determine how to treat this
732 package during a bundle action; for example, if this condition is false or omitted and the bundle is being
733 installed, Burn will install this package.
734 </xs:documentation>
735 </xs:annotation>
736 </xs:attribute>
737 <xs:attribute name="KB" type="xs:string">
738 <xs:annotation>
739 <xs:documentation>
740 The knowledge base identifier for the MSU. The KB attribute must be specified to enable the MSU package to
741 be uninstalled. Even then MSU uninstallation is only supported on Windows 7 and later. When the KB attribute
742 is specified, the Permanent attribute will the control whether the package is uninstalled.
743 </xs:documentation>
744 </xs:annotation>
745 </xs:attribute>
746 </xs:complexType>
747 </xs:element>
748 <xs:element name="ExePackage">
749 <xs:annotation>
750 <xs:documentation>Describes a single exe package to install.</xs:documentation>
751 <xs:appinfo>
752 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Chain" />
753 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="PackageGroup" />
754 </xs:appinfo>
755 </xs:annotation>
756 <xs:complexType>
757 <xs:choice minOccurs="0" maxOccurs="unbounded">
758 <xs:element ref="Payload" />
759 <xs:element ref="PayloadGroupRef" />
760 <xs:element ref="RemotePayload" />
761 <xs:element ref="ExitCode" />
762 <xs:element ref="CommandLine" />
763 <xs:any namespace="##other" processContents="lax">
764 <xs:annotation>
765 <xs:documentation>
766 Extensibility point in the WiX XML Schema. Schema extensions can register additional
767 elements at this point in the schema. The extension's
768 <html:code><html:nobr>CompilerExtension.ParseElement()</html:nobr></html:code>
769 method will be called with the package identifier as the first value in
770 <html:code>contextValues</html:code>.
771 </xs:documentation>
772 </xs:annotation>
773 </xs:any>
774 </xs:choice>
775 <xs:attributeGroup ref="ChainPackageCommonAttributes" />
776 <xs:attribute name="DetectCondition" type="xs:string">
777 <xs:annotation>
778 <xs:documentation>
779 A condition that determines if the package is present on the target system. This condition can use built-in
780 variables and variables returned by searches. This condition is necessary because Windows doesn't provide a
781 method to detect the presence of an ExePackage. Burn uses this condition to determine how to treat this
782 package during a bundle action; for example, if this condition is false or omitted and the bundle is being
783 installed, Burn will install this package.
784 </xs:documentation>
785 </xs:annotation>
786 </xs:attribute>
787 <xs:attribute name="InstallCommand" type="xs:string">
788 <xs:annotation>
789 <xs:documentation>The command-line arguments provided to the ExePackage during install. If this attribute is absent the executable will be launched with no command-line arguments.</xs:documentation>
790 </xs:annotation>
791 </xs:attribute>
792 <xs:attribute name="RepairCommand" type="xs:string">
793 <xs:annotation>
794 <xs:documentation>
795 The command-line arguments to specify to indicate a repair. If the executable package can be repaired but
796 does not require any special command-line arguments to do so then set the attribute's value to blank. To
797 indicate that the package does not support repair, omit this attribute.
798 </xs:documentation>
799 </xs:annotation>
800 </xs:attribute>
801 <xs:attribute name="UninstallCommand" type="xs:string">
802 <xs:annotation>
803 <xs:documentation>The command-line arguments provided to the ExePackage during uninstall. If this attribute is absent the executable will be launched with no command-line arguments. To prevent an ExePackage from being uninstalled set the Permanent attribute to "yes".</xs:documentation>
804 </xs:annotation>
805 </xs:attribute>
806 <xs:attribute name="PerMachine" type="YesNoDefaultTypeUnion">
807 <xs:annotation>
808 <xs:documentation>Indicates the package must be executed elevated. The default is "no".</xs:documentation>
809 </xs:annotation>
810 </xs:attribute>
811 <xs:attribute name="Protocol" type="BurnExeProtocolType">
812 <xs:annotation>
813 <xs:documentation>Indicates the communication protocol the package supports for extended progress and error reporting. The default is "none".</xs:documentation>
814 </xs:annotation>
815 </xs:attribute>
816 </xs:complexType>
817 </xs:element>
818 <xs:element name="RollbackBoundary">
819 <xs:annotation>
820 <xs:documentation>Describes a rollback boundary in the chain.</xs:documentation>
821 <xs:appinfo>
822 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Chain" />
823 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="PackageGroup" />
824 </xs:appinfo>
825 </xs:annotation>
826 <xs:complexType>
827 <xs:choice minOccurs="0" maxOccurs="unbounded">
828 <xs:any namespace="##other" processContents="lax">
829 <xs:annotation>
830 <xs:documentation>
831 Extensibility point in the WiX XML Schema. Schema extensions can register additional
832 elements at this point in the schema. The extension's
833 <html:code><html:nobr>CompilerExtension.ParseElement()</html:nobr></html:code>
834 method will be called with the rollback boundary identifier as the 'RollbackBoundaryId' key in
835 <html:code>contextValues</html:code>.
836 </xs:documentation>
837 </xs:annotation>
838 </xs:any>
839 </xs:choice>
840 <xs:attribute name="Id" type="xs:string">
841 <xs:annotation>
842 <xs:documentation>
843 Identifier for this rollback boundary, for ordering and cross-referencing. If this attribute is
844 not provided a stable identifier will be generated.
845 </xs:documentation>
846 </xs:annotation>
847 </xs:attribute>
848 <xs:attribute name="Vital" type="YesNoTypeUnion">
849 <xs:annotation>
850 <xs:documentation>
851 Specifies whether the rollback boundary aborts the chain. The default "yes" indicates that if
852 the rollback boundary is encountered then the chain will fail and rollback or stop. If "no"
853 is specified then the chain should continue successfuly at the next rollback boundary.
854 </xs:documentation>
855 </xs:annotation>
856 </xs:attribute>
857 <xs:attribute name="Transaction" type="YesNoTypeUnion">
858 <xs:annotation>
859 <xs:documentation>
860 Specifies whether the rollback boundary is wrapped in an MSI transaction. The default is "no"
861 </xs:documentation>
862 </xs:annotation>
863 </xs:attribute>
864 </xs:complexType>
865 </xs:element>
866 <xs:attributeGroup name="ChainPackageCommonAttributes">
867 <xs:attribute name="SourceFile" type="xs:string">
868 <xs:annotation>
869 <xs:documentation>
870 Location of the package to add to the bundle. The default value is the Name attribute, if provided.
871 At a minimum, the SourceFile or Name attribute must be specified.
872 </xs:documentation>
873 </xs:annotation>
874 </xs:attribute>
875 <xs:attribute name="Name" type="xs:string">
876 <xs:annotation>
877 <xs:documentation>
878 The destination path and file name for this chain payload. Use this attribute to rename the
879 chain entry point or extract it into a subfolder. The default value is the file name from the
880 SourceFile attribute, if provided. At a minimum, the Name or SourceFile attribute must be specified.
881 The use of '..' directories is not allowed.
882 </xs:documentation>
883 </xs:annotation>
884 </xs:attribute>
885 <xs:attribute name="DownloadUrl" type="xs:string">
886 <xs:annotation>
887 <xs:documentation>
888 <html:p>The URL to use to download the package. The following substitutions are supported:</html:p>
889 <html:ul>
890 <html:li>{0} is replaced by the package Id.</html:li>
891 <html:li>{1} is replaced by the payload Id.</html:li>
892 <html:li>{2} is replaced by the payload file name.</html:li>
893 </html:ul>
894 </xs:documentation>
895 </xs:annotation>
896 </xs:attribute>
897 <xs:attribute name="Id" type="xs:string">
898 <xs:annotation>
899 <xs:documentation>
900 Identifier for this package, for ordering and cross-referencing. The default is the Name attribute
901 modified to be suitable as an identifier (i.e. invalid characters are replaced with underscores).
902 </xs:documentation>
903 </xs:annotation>
904 </xs:attribute>
905 <xs:attribute name="After" type="xs:string">
906 <xs:annotation>
907 <xs:documentation>
908 The identifier of another package that this one should be installed after. By default the After
909 attribute is set to the previous sibling package in the Chain or PackageGroup element. If this
910 attribute is specified ensure that a cycle is not created explicitly or implicitly.
911 </xs:documentation>
912 </xs:annotation>
913 </xs:attribute>
914 <xs:attribute name="InstallSize" type="xs:string">
915 <xs:annotation>
916 <xs:documentation>
917 The size this package will take on disk in bytes after it is installed. By default, the binder will
918 calculate the install size by scanning the package (File table for MSIs, Payloads for EXEs)
919 and use the total for the install size of the package.
920 </xs:documentation>
921 </xs:annotation>
922 </xs:attribute>
923 <xs:attribute name="InstallCondition" type="xs:string">
924 <xs:annotation>
925 <xs:documentation>A condition to evaluate before installing the package. The package will only be installed if the condition evaluates to true. If the condition evaluates to false and the bundle is being installed, repaired, or modified, the package will be uninstalled.</xs:documentation>
926 </xs:annotation>
927 </xs:attribute>
928 <xs:attribute name="Cache" type="YesNoAlwaysTypeUnion">
929 <xs:annotation>
930 <xs:documentation>Whether to cache the package. The default is "yes".</xs:documentation>
931 </xs:annotation>
932 </xs:attribute>
933 <xs:attribute name="CacheId" type="xs:string">
934 <xs:annotation>
935 <xs:documentation>The identifier to use when caching the package.</xs:documentation>
936 </xs:annotation>
937 </xs:attribute>
938 <xs:attribute name="DisplayName" type="xs:string">
939 <xs:annotation>
940 <xs:documentation>
941 Specifies the display name to place in the bootstrapper application data manifest for the package. By default, ExePackages
942 use the ProductName field from the version information, MsiPackages use the ProductName property, and MspPackages use
943 the DisplayName patch metadata property. Other package types must use this attribute to define a display name in the
944 bootstrapper application data manifest.
945 </xs:documentation>
946 </xs:annotation>
947 </xs:attribute>
948 <xs:attribute name="Description" type="xs:string">
949 <xs:annotation>
950 <xs:documentation>
951 Specifies the description to place in the bootstrapper application data manifest for the package. By default, ExePackages
952 use the FileName field from the version information, MsiPackages use the ARPCOMMENTS property, and MspPackages use
953 the Description patch metadata property. Other package types must use this attribute to define a description in the
954 bootstrapper application data manifest.
955 </xs:documentation>
956 </xs:annotation>
957 </xs:attribute>
958 <xs:attribute name="LogPathVariable" type="xs:string">
959 <xs:annotation>
960 <xs:documentation>
961 Name of a Variable that will hold the path to the log file. An empty value will cause the variable to not
962 be set. The default is "WixBundleLog_[PackageId]" except for MSU packages which default to no logging.
963 </xs:documentation>
964 </xs:annotation>
965 </xs:attribute>
966 <xs:attribute name="RollbackLogPathVariable" type="xs:string">
967 <xs:annotation>
968 <xs:documentation>
969 Name of a Variable that will hold the path to the log file used during rollback. An empty value will cause
970 the variable to not be set. The default is "WixBundleRollbackLog_[PackageId]" except for MSU packages which
971 default to no logging.
972 </xs:documentation>
973 </xs:annotation>
974 </xs:attribute>
975 <xs:attribute name="Permanent" type="YesNoTypeUnion">
976 <xs:annotation>
977 <xs:documentation>
978 Specifies whether the package can be uninstalled. The default is "no".
979 </xs:documentation>
980 </xs:annotation>
981 </xs:attribute>
982 <xs:attribute name="Vital" type="YesNoTypeUnion">
983 <xs:annotation>
984 <xs:documentation>
985 Specifies whether the package must succeed for the chain to continue. The default "yes"
986 indicates that if the package fails then the chain will fail and rollback or stop. If
987 "no" is specified then the chain will continue even if the package reports failure.
988 </xs:documentation>
989 </xs:annotation>
990 </xs:attribute>
991 <xs:attribute name="Compressed" type="YesNoDefaultTypeUnion">
992 <xs:annotation>
993 <xs:documentation>Whether the package payload should be embedded in a container or left as an external payload.</xs:documentation>
994 </xs:annotation>
995 </xs:attribute>
996 <xs:attribute name="EnableSignatureVerification" type="YesNoTypeUnion">
997 <xs:annotation>
998 <xs:documentation>
999 By default, a Bundle will use the hash of a package to verify its contents. If this attribute is set to "yes"
1000 and the package is signed with an Authenticode signature the Bundle will verify the contents of the package using the
1001 signature instead. Beware that there are many real world issues with Windows verifying Authenticode signatures.
1002 Since the Authenticode signatures are no more secure than hashing the packages directly, the default is "no".
1003 </xs:documentation>
1004 </xs:annotation>
1005 </xs:attribute>
1006 <xs:anyAttribute namespace="##other" processContents="lax">
1007 <xs:annotation>
1008 <xs:documentation>
1009 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1010 attributes at this point in the schema. The extension's
1011 <html:code><html:nobr>CompilerExtension.ParseAttribute()</html:nobr></html:code>
1012 method will be called with the package identifier in
1013 <html:code><html:nobr>contextValues["PackageId"]</html:nobr></html:code>.
1014 </xs:documentation>
1015 </xs:annotation>
1016 </xs:anyAttribute>
1017 </xs:attributeGroup>
1018 <xs:element name="PackageGroup">
1019 <xs:annotation>
1020 <xs:documentation>Describes a package group to a bootstrapper.</xs:documentation>
1021 <xs:appinfo>
1022 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
1023 </xs:appinfo>
1024 </xs:annotation>
1025 <xs:complexType>
1026 <xs:choice minOccurs="0" maxOccurs="unbounded">
1027 <xs:element ref="MsiPackage" />
1028 <xs:element ref="MspPackage" />
1029 <xs:element ref="MsuPackage" />
1030 <xs:element ref="ExePackage" />
1031 <xs:element ref="RollbackBoundary" />
1032 <xs:element ref="PackageGroupRef" />
1033 </xs:choice>
1034 <xs:attribute name="Id" type="xs:string" use="required">
1035 <xs:annotation>
1036 <xs:documentation>Identifier for package group.</xs:documentation>
1037 </xs:annotation>
1038 </xs:attribute>
1039 </xs:complexType>
1040 </xs:element>
1041 <xs:element name="PackageGroupRef">
1042 <xs:annotation>
1043 <xs:documentation>Create a reference to PackageGroup element that exists inside a Bundle or Fragment element.</xs:documentation>
1044 <xs:appinfo>
1045 <xse:seeAlso ref="PackageGroup" />
1046 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Chain" />
1047 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Container" />
1048 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="PackageGroup" />
1049 </xs:appinfo>
1050 </xs:annotation>
1051 <xs:complexType>
1052 <xs:attribute name="Id" type="xs:string" use="required">
1053 <xs:annotation>
1054 <xs:documentation>The identifier of the PackageGroup element to reference.</xs:documentation>
1055 </xs:annotation>
1056 </xs:attribute>
1057 <xs:attribute name="After" type="xs:string">
1058 <xs:annotation>
1059 <xs:documentation>The identifier of a package that this group should be installed after.</xs:documentation>
1060 </xs:annotation>
1061 </xs:attribute>
1062 </xs:complexType>
1063 </xs:element>
1064 <xs:element name="MsiProperty">
1065 <xs:annotation>
1066 <xs:documentation>Allows an MSI property to be set based on the value of a burn engine expression.</xs:documentation>
1067 <xs:appinfo>
1068 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="MsiPackage" />
1069 </xs:appinfo>
1070 </xs:annotation>
1071 <xs:complexType>
1072 <xs:attribute name="Name" type="xs:string" use="required">
1073 <xs:annotation>
1074 <xs:documentation>The name of the MSI property to set. Burn controls the follow MSI properties so they cannot be set with MsiProperty: ACTION, ALLUSERS, REBOOT, REINSTALL, REINSTALLMODE</xs:documentation>
1075 </xs:annotation>
1076 </xs:attribute>
1077 <xs:attribute name="Value" type="xs:string" use="required">
1078 <xs:annotation>
1079 <xs:documentation>The value to set the property to. This string is evaluated by the burn engine and can be as simple as a burn engine variable reference or as complex as a full expression.</xs:documentation>
1080 </xs:annotation>
1081 </xs:attribute>
1082 </xs:complexType>
1083 </xs:element>
1084 <xs:element name="SlipstreamMsp">
1085 <xs:annotation>
1086 <xs:documentation>Specifies a patch included in the same bundle that is installed when the parent MSI package is installed.</xs:documentation>
1087 <xs:appinfo>
1088 <xse:seeAlso ref="MspPackage" />
1089 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="MsiPackage" />
1090 <xse:remarks>
1091 <html:p>You can also specify that any MspPackage elements in the chain are automatically slipstreamed by setting the Slipstream attribute of an MspPackage to "yes". This will reduce the amount of authoring you need to write and will determine which msi packages can slipstream patches when building a bundle.</html:p>
1092 </xse:remarks>
1093 </xs:appinfo>
1094 </xs:annotation>
1095 <xs:complexType>
1096 <xs:attribute name="Id" type="xs:string" use="required">
1097 <xs:annotation>
1098 <xs:documentation>The identifier for a MspPackage in the bundle.</xs:documentation>
1099 </xs:annotation>
1100 </xs:attribute>
1101 </xs:complexType>
1102 </xs:element>
1103 <xs:element name="Variable">
1104 <xs:annotation>
1105 <xs:documentation>Describes a burn engine variable to define.</xs:documentation>
1106 <xs:appinfo>
1107 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Bundle" />
1108 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
1109 </xs:appinfo>
1110 </xs:annotation>
1111 <xs:complexType>
1112 <xs:attribute name="Hidden" type="YesNoTypeUnion">
1113 <xs:annotation>
1114 <xs:documentation>Whether the value of the variable should be hidden.</xs:documentation>
1115 </xs:annotation>
1116 </xs:attribute>
1117 <xs:attribute name="Name" type="xs:string" use="required">
1118 <xs:annotation>
1119 <xs:documentation>The name for the variable.</xs:documentation>
1120 </xs:annotation>
1121 </xs:attribute>
1122 <xs:attribute name="Persisted" type="YesNoTypeUnion">
1123 <xs:annotation>
1124 <xs:documentation>Whether the variable should be persisted.</xs:documentation>
1125 </xs:annotation>
1126 </xs:attribute>
1127 <xs:attribute name="Value" type="xs:string">
1128 <xs:annotation>
1129 <xs:documentation>Starting value for the variable.</xs:documentation>
1130 </xs:annotation>
1131 </xs:attribute>
1132 <xs:attribute name="Type">
1133 <xs:annotation>
1134 <xs:documentation>Type of the variable, inferred from the value if not specified.</xs:documentation>
1135 </xs:annotation>
1136 <xs:simpleType>
1137 <xs:restriction base="xs:string">
1138 <xs:enumeration value="string" />
1139 <xs:enumeration value="numeric" />
1140 <xs:enumeration value="version" />
1141 </xs:restriction>
1142 </xs:simpleType>
1143 </xs:attribute>
1144 <xs:anyAttribute namespace="##other" processContents="lax">
1145 <xs:annotation>
1146 <xs:documentation>
1147 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1148 attributes at this point in the schema.
1149 </xs:documentation>
1150 </xs:annotation>
1151 </xs:anyAttribute>
1152 </xs:complexType>
1153 </xs:element>
1154 <xs:element name="Container">
1155 <xs:annotation>
1156 <xs:documentation>Representation of a file that contains one or more files.</xs:documentation>
1157 <xs:appinfo>
1158 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Bundle" />
1159 </xs:appinfo>
1160 </xs:annotation>
1161 <xs:complexType>
1162 <xs:choice minOccurs="0" maxOccurs="unbounded">
1163 <xs:element ref="PackageGroupRef" />
1164 </xs:choice>
1165 <xs:attribute name="DownloadUrl" type="xs:string">
1166 <xs:annotation>
1167 <xs:documentation>
1168 <html:p>The URL to use to download the container. This attribute is only valid when the container is detached. The
1169 following substitutions are supported:</html:p>
1170 <html:ul>
1171 <html:li>{0} is always null.</html:li>
1172 <html:li>{1} is replaced by the container Id.</html:li>
1173 <html:li>{2} is replaced by the container file name.</html:li>
1174 </html:ul>
1175 </xs:documentation>
1176 </xs:annotation>
1177 </xs:attribute>
1178 <xs:attribute name="Id" type="xs:string">
1179 <xs:annotation>
1180 <xs:documentation>The unique identifier for the container. If this attribute is not specified the Name attribute will be used.</xs:documentation>
1181 </xs:annotation>
1182 </xs:attribute>
1183 <xs:attribute name="Name" type="xs:string">
1184 <xs:annotation>
1185 <xs:documentation>The file name for this container. A relative path may be provided to place the container in a sub-folder of the bundle.</xs:documentation>
1186 </xs:annotation>
1187 </xs:attribute>
1188 <xs:attribute name="Type" type="BurnContainerType">
1189 <xs:annotation>
1190 <xs:documentation>
1191 Indicates whether the container is "attached" to the bundle executable or placed external to the bundle extecutable as "detached". If
1192 this attribute is not specified, the default is to create a detached container.
1193 </xs:documentation>
1194 </xs:annotation>
1195 </xs:attribute>
1196 </xs:complexType>
1197 </xs:element>
1198 <xs:element name="ContainerRef">
1199 <xs:annotation>
1200 <xs:documentation>Create a reference to an existing Container element.</xs:documentation>
1201 <xs:appinfo>
1202 <xse:seeAlso ref="Container" />
1203 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Bundle" />
1204 </xs:appinfo>
1205 </xs:annotation>
1206 <xs:complexType>
1207 <xs:attribute name="Id" type="xs:string" use="required">
1208 <xs:annotation>
1209 <xs:documentation>The identifier of Container element to reference.</xs:documentation>
1210 </xs:annotation>
1211 </xs:attribute>
1212 </xs:complexType>
1213 </xs:element>
1214 <xs:element name="ExitCode">
1215 <xs:annotation>
1216 <xs:documentation>Describes map of exit code returned from executable package to a bootstrapper behavior.</xs:documentation>
1217 <xs:appinfo>
1218 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="ExePackage" />
1219 </xs:appinfo>
1220 </xs:annotation>
1221 <xs:complexType>
1222 <xs:attribute name="Value" type="xs:integer">
1223 <xs:annotation>
1224 <xs:documentation>Exit code returned from executable package. If no value is provided it means all values not explicitly set default to this behavior.</xs:documentation>
1225 </xs:annotation>
1226 </xs:attribute>
1227 <xs:attribute name="Behavior" use="required">
1228 <xs:annotation>
1229 <xs:documentation>Choose one of the supported behaviors error codes: success, error, scheduleReboot, forceReboot.</xs:documentation>
1230 </xs:annotation>
1231 <xs:simpleType>
1232 <xs:restriction base="xs:string">
1233 <xs:enumeration value="success" />
1234 <xs:enumeration value="error" />
1235 <xs:enumeration value="scheduleReboot" />
1236 <xs:enumeration value="forceReboot" />
1237 </xs:restriction>
1238 </xs:simpleType>
1239 </xs:attribute>
1240 </xs:complexType>
1241 </xs:element>
1242 <xs:element name="CommandLine">
1243 <xs:annotation>
1244 <xs:documentation>Describes additional, conditional command-line arguments for an ExePackage.</xs:documentation>
1245 </xs:annotation>
1246 <xs:complexType>
1247 <xs:attribute name="InstallArgument" type="xs:string">
1248 <xs:annotation>
1249 <xs:documentation>Additional command-line arguments to apply during package installation if Condition is true.</xs:documentation>
1250 </xs:annotation>
1251 </xs:attribute>
1252 <xs:attribute name="UninstallArgument" type="xs:string">
1253 <xs:annotation>
1254 <xs:documentation>Additional command-line arguments to apply during package uninstallation if Condition is true.</xs:documentation>
1255 </xs:annotation>
1256 </xs:attribute>
1257 <xs:attribute name="RepairArgument" type="xs:string">
1258 <xs:annotation>
1259 <xs:documentation>Additional command-line arguments to apply during package repair if Condition is true.</xs:documentation>
1260 </xs:annotation>
1261 </xs:attribute>
1262 <xs:attribute name="Condition" type="xs:string">
1263 <xs:annotation>
1264 <xs:documentation>
1265 The condition that controls whether the command-line arguments specified in the
1266 InstallArgument, UninstallArgument, or RepairArgument attributes are appended to the
1267 command line passed to the ExePackage. Which attribute is used depends on the
1268 action being applied to the ExePackage. For example, when the ExePackage is
1269 being installed, the InstallArgument attribute value is appended to the command
1270 line when the ExePackage is executed.
1271 </xs:documentation>
1272 </xs:annotation>
1273 </xs:attribute>
1274 </xs:complexType>
1275 </xs:element>
1276 <xs:element name="Payload">
1277 <xs:annotation>
1278 <xs:documentation>Describes a payload to a bootstrapper.</xs:documentation>
1279 <xs:appinfo>
1280 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="BootstrapperApplication" />
1281 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="ExePackage" />
1282 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="MsiPackage" />
1283 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="MspPackage" />
1284 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="MsuPackage" />
1285 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="UX" />
1286 </xs:appinfo>
1287 </xs:annotation>
1288 <xs:complexType>
1289 <xs:attribute name="Id" type="xs:string">
1290 <xs:annotation>
1291 <xs:documentation>The identifier of Payload element.</xs:documentation>
1292 </xs:annotation>
1293 </xs:attribute>
1294 <xs:attribute name="Compressed" type="YesNoDefaultTypeUnion">
1295 <xs:annotation>
1296 <xs:documentation>Whether the payload should be embedded in a container or left as an external payload.</xs:documentation>
1297 </xs:annotation>
1298 </xs:attribute>
1299 <xs:attribute name="SourceFile" type="xs:string" use="required">
1300 <xs:annotation>
1301 <xs:documentation>Location of the source file.</xs:documentation>
1302 </xs:annotation>
1303 </xs:attribute>
1304 <xs:attribute name="Name" type="xs:string">
1305 <xs:annotation>
1306 <xs:documentation>The destination path and file name for this payload. The default is the source file name. The use of '..' directories is not allowed.</xs:documentation>
1307 </xs:annotation>
1308 </xs:attribute>
1309 <xs:attribute name="DownloadUrl" type="xs:string">
1310 <xs:annotation>
1311 <xs:documentation>
1312 <html:p>The URL to use to download the package. The following substitutions are supported:</html:p>
1313 <html:ul>
1314 <html:li>{0} is replaced by the package Id.</html:li>
1315 <html:li>{1} is replaced by the payload Id.</html:li>
1316 <html:li>{2} is replaced by the payload file name.</html:li>
1317 </html:ul>
1318 </xs:documentation>
1319 </xs:annotation>
1320 </xs:attribute>
1321 <xs:attribute name="EnableSignatureVerification" type="YesNoTypeUnion">
1322 <xs:annotation>
1323 <xs:documentation>
1324 By default, a Bundle will use the hash of a package to verify its contents. If this attribute is set to "yes"
1325 and the package is signed with an Authenticode signature the Bundle will verify the contents of the package using the
1326 signature instead. Beware that there are many real world issues with Windows verifying Authenticode signatures.
1327 Since the Authenticode signatures are no more secure than hashing the packages directly, the default is "no".
1328 </xs:documentation>
1329 </xs:annotation>
1330 </xs:attribute>
1331 </xs:complexType>
1332 </xs:element>
1333 <xs:element name="PayloadGroup">
1334 <xs:annotation>
1335 <xs:documentation>Describes a payload group to a bootstrapper. PayloadGroups referenced from within a Bundle are tied to the Bundle.
1336 PayloadGroups referenced from a Fragment are tied to the context of whatever references them such as an ExePackage or MsiPackage.
1337 It is possible to share a PayloadGroup between multiple Packages and/or a Bundle by creating multiple references to it.</xs:documentation>
1338 <xs:appinfo>
1339 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
1340 </xs:appinfo>
1341 </xs:annotation>
1342 <xs:complexType>
1343 <xs:choice minOccurs="0" maxOccurs="unbounded">
1344 <xs:element ref="Payload" />
1345 <xs:element ref="PayloadGroupRef" />
1346 </xs:choice>
1347 <xs:attribute name="Id" type="xs:string" use="required">
1348 <xs:annotation>
1349 <xs:documentation>Identifier for payload group.</xs:documentation>
1350 </xs:annotation>
1351 </xs:attribute>
1352 </xs:complexType>
1353 </xs:element>
1354 <xs:element name="PayloadGroupRef">
1355 <xs:annotation>
1356 <xs:documentation>Create a reference to PayloadGroup element that exists inside a Bundle or Fragment element.</xs:documentation>
1357 <xs:appinfo>
1358 <xse:seeAlso ref="PayloadGroup" />
1359 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="BootstrapperApplication" />
1360 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="UX" />
1361 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="PayloadGroup" />
1362 </xs:appinfo>
1363 </xs:annotation>
1364 <xs:complexType>
1365 <xs:attribute name="Id" type="xs:string" use="required">
1366 <xs:annotation>
1367 <xs:documentation>The identifier of the PayloadGroup element to reference.</xs:documentation>
1368 </xs:annotation>
1369 </xs:attribute>
1370 </xs:complexType>
1371 </xs:element>
1372 <xs:element name="RemotePayload">
1373 <xs:annotation>
1374 <xs:documentation>Describes information about a remote file payload that is not available at the time of building the bundle.
1375 The parent must specify DownloadUrl and must not specify SourceFile when using this element.</xs:documentation>
1376 <xs:appinfo>
1377 <xse:parent namespace="http://schemas.microsoft.com/wix/2006/wi" ref="ExePackage" />
1378 <xse:parent namespace="http://schemas.microsoft.com/wix/2006/wi" ref="MsuPackage" />
1379 </xs:appinfo>
1380 </xs:annotation>
1381 <xs:complexType>
1382 <xs:attribute name="CertificatePublicKey" type="HexType">
1383 <xs:annotation>
1384 <xs:documentation>Public key of the authenticode certificate used to sign the RemotePayload. Include this attribute if the remote file is signed.</xs:documentation>
1385 </xs:annotation>
1386 </xs:attribute>
1387 <xs:attribute name="CertificateThumbprint" type="HexType">
1388 <xs:annotation>
1389 <xs:documentation>Thumbprint of the authenticode certificate used to sign the RemotePayload. Include this attribute if the remote file is signed.</xs:documentation>
1390 </xs:annotation>
1391 </xs:attribute>
1392 <xs:attribute name="Description" type="xs:string" use="required">
1393 <xs:annotation>
1394 <xs:documentation>Description of the file from version resources.</xs:documentation>
1395 </xs:annotation>
1396 </xs:attribute>
1397 <xs:attribute name="Hash" type="HexType" use="required">
1398 <xs:annotation>
1399 <xs:documentation>SHA-1 hash of the RemotePayload. Include this attribute if the remote file is unsigned or SuppressSignatureVerification is set to Yes.</xs:documentation>
1400 </xs:annotation>
1401 </xs:attribute>
1402 <xs:attribute name="ProductName" type="xs:string" use="required">
1403 <xs:annotation>
1404 <xs:documentation>Product name of the file from version resouces.</xs:documentation>
1405 </xs:annotation>
1406 </xs:attribute>
1407 <xs:attribute name="Size" type="xs:integer" use="required">
1408 <xs:annotation>
1409 <xs:documentation>Size of the remote file in bytes.</xs:documentation>
1410 </xs:annotation>
1411 </xs:attribute>
1412 <xs:attribute name="Version" type="VersionType" use="required">
1413 <xs:annotation>
1414 <xs:documentation>Version of the remote file</xs:documentation>
1415 </xs:annotation>
1416 </xs:attribute>
1417 </xs:complexType>
1418 </xs:element>
1419 <xs:element name="RelatedBundle">
1420 <xs:annotation>
1421 <xs:documentation>Create a RelatedBundle element.</xs:documentation>
1422 <xs:appinfo>
1423 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Bundle" />
1424 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
1425 </xs:appinfo>
1426 </xs:annotation>
1427 <xs:complexType>
1428 <xs:attribute name="Id" type="Guid" use="required">
1429 <xs:annotation>
1430 <xs:documentation>The identifier of the RelatedBundle group.</xs:documentation>
1431 </xs:annotation>
1432 </xs:attribute>
1433 <xs:attribute name="Action" use="optional">
1434 <xs:annotation>
1435 <xs:documentation>The action to take on bundles related to this one. Detect is the default.</xs:documentation>
1436 </xs:annotation>
1437 <xs:simpleType>
1438 <xs:restriction base="xs:string">
1439 <xs:enumeration value="Detect" />
1440 <xs:enumeration value="Upgrade" />
1441 <xs:enumeration value="Addon" />
1442 <xs:enumeration value="Patch" />
1443 </xs:restriction>
1444 </xs:simpleType>
1445 </xs:attribute>
1446 </xs:complexType>
1447 </xs:element>
1448 <xs:element name="Update">
1449 <xs:annotation>
1450 <xs:documentation>Defines the update for a Bundle.</xs:documentation>
1451 <xs:appinfo>
1452 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Bundle" />
1453 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
1454 </xs:appinfo>
1455 </xs:annotation>
1456 <xs:complexType>
1457 <xs:attribute name="Location" type="xs:string" use="required">
1458 <xs:annotation>
1459 <xs:documentation>
1460 The absolute path or URL to check for an update bundle. Currently the engine provides this value
1461 in the IBootstrapperApplication::OnDetectUpdateBegin() and otherwise ignores the value. In the
1462 future the engine will be able to acquire an update bundle from the location and determine if it
1463 is newer than the current executing bundle.
1464 </xs:documentation>
1465 </xs:annotation>
1466 </xs:attribute>
1467 </xs:complexType>
1468 </xs:element>
1469 <xs:element name="Product">
1470 <xs:annotation>
1471 <xs:documentation>
1472 The Product element is analogous to the main function in a C program. When linking, only one Product section
1473 can be given to the linker to produce a successful result. Using this element creates an msi file.
1474 </xs:documentation>
1475 <xs:appinfo>
1476 <xse:remarks>
1477 <html:p>You can specify any valid Windows code page by integer like 1252, or by web name like Windows-1252. See <html:a href="~/overview/codepage.html">Code Pages</html:a> for more information.</html:p>
1478 </xse:remarks>
1479 </xs:appinfo>
1480 </xs:annotation>
1481 <xs:complexType>
1482 <xs:sequence>
1483 <xs:element ref="Package" />
1484 <xs:choice minOccurs="0" maxOccurs="unbounded">
1485 <xs:element ref="AppId" />
1486 <xs:element ref="Binary" />
1487 <xs:element ref="ComplianceCheck" />
1488 <xs:element ref="Component" />
1489 <xs:element ref="ComponentGroup" />
1490 <xs:element ref="Condition" />
1491 <xs:element ref="CustomAction" />
1492 <xs:element ref="CustomActionRef" />
1493 <xs:element ref="CustomTable" />
1494 <xs:element ref="Directory" />
1495 <xs:element ref="DirectoryRef" />
1496 <xs:element ref="EmbeddedChainer" />
1497 <xs:element ref="EmbeddedChainerRef" />
1498 <xs:element ref="EnsureTable" />
1499 <xs:element ref="Feature" />
1500 <xs:element ref="FeatureRef" />
1501 <xs:element ref="FeatureGroupRef" />
1502 <xs:element ref="Icon" />
1503 <xs:element ref="InstanceTransforms" />
1504 <xs:element ref="MajorUpgrade" />
1505 <xs:element ref="Media" />
1506 <xs:element ref="MediaTemplate" />
1507 <xs:element ref="PackageCertificates" />
1508 <xs:element ref="PatchCertificates" />
1509 <xs:element ref="Property" />
1510 <xs:element ref="PropertyRef" />
1511 <xs:element ref="SetDirectory" />
1512 <xs:element ref="SetProperty" />
1513 <xs:element ref="SFPCatalog" />
1514 <xs:element ref="SymbolPath" />
1515 <xs:element ref="UI" />
1516 <xs:element ref="UIRef" />
1517 <xs:element ref="Upgrade" />
1518 <xs:element ref="WixVariable" />
1519 <xs:sequence>
1520 <xs:element ref="InstallExecuteSequence" minOccurs="0" />
1521 <xs:element ref="InstallUISequence" minOccurs="0" />
1522 <xs:element ref="AdminExecuteSequence" minOccurs="0" />
1523 <xs:element ref="AdminUISequence" minOccurs="0" />
1524 <xs:element ref="AdvertiseExecuteSequence" minOccurs="0" />
1525 </xs:sequence>
1526 <xs:any namespace="##other" processContents="lax">
1527 <xs:annotation>
1528 <xs:documentation>
1529 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1530 elements at this point in the schema.
1531 </xs:documentation>
1532 </xs:annotation>
1533 </xs:any>
1534 </xs:choice>
1535 </xs:sequence>
1536 <xs:attribute name="Id" type="AutogenGuid" use="required">
1537 <xs:annotation>
1538 <xs:documentation>The product code GUID for the product.</xs:documentation>
1539 </xs:annotation>
1540 </xs:attribute>
1541 <xs:attribute name="Codepage" type="xs:string">
1542 <xs:annotation>
1543 <xs:documentation>The code page integer value or web name for the resulting MSI. See remarks for more information.</xs:documentation>
1544 </xs:annotation>
1545 </xs:attribute>
1546 <xs:attribute name="Language" type="LocalizableInteger" use="required">
1547 <xs:annotation>
1548 <xs:documentation>The decimal language ID (LCID) for the product.</xs:documentation>
1549 </xs:annotation>
1550 </xs:attribute>
1551 <xs:attribute name="Manufacturer" type="xs:string" use="required">
1552 <xs:annotation>
1553 <xs:documentation>The manufacturer of the product.</xs:documentation>
1554 </xs:annotation>
1555 </xs:attribute>
1556 <xs:attribute name="Name" type="xs:string" use="required">
1557 <xs:annotation>
1558 <xs:documentation>The descriptive name of the product.</xs:documentation>
1559 </xs:annotation>
1560 </xs:attribute>
1561 <xs:attribute name="UpgradeCode" type="Guid">
1562 <xs:annotation>
1563 <xs:documentation>The upgrade code GUID for the product.</xs:documentation>
1564 </xs:annotation>
1565 </xs:attribute>
1566 <xs:attribute name="Version" type="xs:string" use="required">
1567 <xs:annotation>
1568 <xs:documentation>The product's version string.</xs:documentation>
1569 </xs:annotation>
1570 </xs:attribute>
1571 <xs:anyAttribute namespace="##other" processContents="lax">
1572 <xs:annotation>
1573 <xs:documentation>
1574 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1575 attributes at this point in the schema.
1576 </xs:documentation>
1577 </xs:annotation>
1578 </xs:anyAttribute>
1579 </xs:complexType>
1580 </xs:element>
1581 <xs:element name="Module">
1582 <xs:annotation>
1583 <xs:documentation>
1584 The Module element is analogous to the main function in a C program. When linking, only
1585 one Module section can be given to the linker to produce a successful result. Using this
1586 element creates an msm file.
1587 </xs:documentation>
1588 <xs:appinfo>
1589 <xse:remarks>
1590 <html:p>You can specify any valid Windows code by by integer like 1252, or by web name like Windows-1252. See <html:a href="~/overview/codepage.html">Code Pages</html:a> for more information.</html:p>
1591 </xse:remarks>
1592 </xs:appinfo>
1593 </xs:annotation>
1594 <xs:complexType>
1595 <xs:sequence>
1596 <xs:element ref="Package" />
1597 <xs:choice minOccurs="0" maxOccurs="unbounded">
1598 <xs:element ref="AppId" />
1599 <xs:element ref="Binary" />
1600 <xs:element ref="Component" />
1601 <xs:element ref="ComponentGroupRef" />
1602 <xs:element ref="ComponentRef" />
1603 <xs:element ref="Configuration" />
1604 <xs:element ref="CustomAction" />
1605 <xs:element ref="CustomActionRef" />
1606 <xs:element ref="CustomTable" />
1607 <xs:element ref="Dependency" />
1608 <xs:element ref="Directory" />
1609 <xs:element ref="DirectoryRef" />
1610 <xs:element ref="EmbeddedChainer" />
1611 <xs:element ref="EmbeddedChainerRef" />
1612 <xs:element ref="EnsureTable" />
1613 <xs:element ref="Exclusion" />
1614 <xs:element ref="Icon" />
1615 <xs:element ref="IgnoreModularization" />
1616 <xs:element ref="IgnoreTable" />
1617 <xs:element ref="Property" />
1618 <xs:element ref="PropertyRef" />
1619 <xs:element ref="SetDirectory" />
1620 <xs:element ref="SetProperty" />
1621 <xs:element ref="SFPCatalog" />
1622 <xs:element ref="Substitution" />
1623 <xs:element ref="UI" />
1624 <xs:element ref="UIRef" />
1625 <xs:element ref="WixVariable" />
1626 <xs:sequence>
1627 <xs:element ref="InstallExecuteSequence" minOccurs="0" />
1628 <xs:element ref="InstallUISequence" minOccurs="0" />
1629 <xs:element ref="AdminExecuteSequence" minOccurs="0" />
1630 <xs:element ref="AdminUISequence" minOccurs="0" />
1631 <xs:element ref="AdvertiseExecuteSequence" minOccurs="0" />
1632 </xs:sequence>
1633 <xs:any namespace="##other" processContents="lax">
1634 <xs:annotation>
1635 <xs:documentation>
1636 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1637 elements at this point in the schema.
1638 </xs:documentation>
1639 </xs:annotation>
1640 </xs:any>
1641 </xs:choice>
1642 </xs:sequence>
1643 <xs:attribute name="Id" type="xs:string" use="required">
1644 <xs:annotation>
1645 <xs:documentation>The name of the merge module (not the file name).</xs:documentation>
1646 </xs:annotation>
1647 </xs:attribute>
1648 <xs:attribute name="Codepage" type="xs:string">
1649 <xs:annotation>
1650 <xs:documentation>The code page integer value or web name for the resulting MSM. See remarks for more information.</xs:documentation>
1651 </xs:annotation>
1652 </xs:attribute>
1653 <xs:attribute name="Guid" type="Guid">
1654 <xs:annotation>
1655 <xs:documentation>This attribute is deprecated. Use the Package/@Id attribute instead.</xs:documentation>
1656 </xs:annotation>
1657 </xs:attribute>
1658 <xs:attribute name="Language" type="LocalizableInteger" use="required">
1659 <xs:annotation>
1660 <xs:documentation>The decimal language ID (LCID) of the merge module.</xs:documentation>
1661 </xs:annotation>
1662 </xs:attribute>
1663 <xs:attribute name="Version" type="xs:string" use="required">
1664 <xs:annotation>
1665 <xs:documentation>The major and minor versions of the merge module.</xs:documentation>
1666 </xs:annotation>
1667 </xs:attribute>
1668 </xs:complexType>
1669 </xs:element>
1670 <xs:element name="Dependency">
1671 <xs:annotation>
1672 <xs:documentation>Declares a dependency on another merge module.</xs:documentation>
1673 </xs:annotation>
1674 <xs:complexType>
1675 <xs:attribute name="RequiredId" type="xs:string" use="required">
1676 <xs:annotation>
1677 <xs:documentation>Identifier of the merge module required by the merge module.</xs:documentation>
1678 </xs:annotation>
1679 </xs:attribute>
1680 <xs:attribute name="RequiredLanguage" type="xs:integer" use="required">
1681 <xs:annotation>
1682 <xs:documentation>Numeric language ID of the merge module in RequiredID.</xs:documentation>
1683 </xs:annotation>
1684 </xs:attribute>
1685 <xs:attribute name="RequiredVersion" type="xs:string">
1686 <xs:annotation>
1687 <xs:documentation>Version of the merge module in RequiredID.</xs:documentation>
1688 </xs:annotation>
1689 </xs:attribute>
1690 </xs:complexType>
1691 </xs:element>
1692 <xs:element name="Exclusion">
1693 <xs:annotation>
1694 <xs:documentation>Declares a merge module with which this merge module is incompatible.</xs:documentation>
1695 </xs:annotation>
1696 <xs:complexType>
1697 <xs:attribute name="ExcludedId" type="xs:string" use="required">
1698 <xs:annotation>
1699 <xs:documentation>Identifier of the merge module that is incompatible.</xs:documentation>
1700 </xs:annotation>
1701 </xs:attribute>
1702 <xs:attribute name="ExcludeExceptLanguage" type="xs:integer">
1703 <xs:annotation>
1704 <xs:documentation>Numeric language ID of the merge module in ExcludedID. All except this language will be excluded. Only one of ExcludeExceptLanguage and ExcludeLanguage may be specified.</xs:documentation>
1705 </xs:annotation>
1706 </xs:attribute>
1707 <xs:attribute name="ExcludeLanguage" type="xs:integer">
1708 <xs:annotation>
1709 <xs:documentation>Numeric language ID of the merge module in ExcludedID. The specified language will be excluded. Only one of ExcludeExceptLanguage and ExcludeLanguage may be specified.</xs:documentation>
1710 </xs:annotation>
1711 </xs:attribute>
1712 <xs:attribute name="ExcludedMinVersion" type="xs:string">
1713 <xs:annotation>
1714 <xs:documentation>Minimum version excluded from a range. If not set, all versions before max are excluded. If neither max nor min, no exclusion based on version.</xs:documentation>
1715 </xs:annotation>
1716 </xs:attribute>
1717 <xs:attribute name="ExcludedMaxVersion" type="xs:string">
1718 <xs:annotation>
1719 <xs:documentation>Maximum version excluded from a range. If not set, all versions after min are excluded. If neither max nor min, no exclusion based on version.</xs:documentation>
1720 </xs:annotation>
1721 </xs:attribute>
1722 </xs:complexType>
1723 </xs:element>
1724 <xs:element name="Configuration">
1725 <xs:annotation>
1726 <xs:documentation>Defines the configurable attributes of merge module.</xs:documentation>
1727 </xs:annotation>
1728 <xs:complexType>
1729 <xs:attribute name="Name" type="xs:string" use="required">
1730 <xs:annotation>
1731 <xs:documentation>Defines the name of the configurable item.</xs:documentation>
1732 </xs:annotation>
1733 </xs:attribute>
1734 <xs:attribute name="Format" use="required">
1735 <xs:annotation>
1736 <xs:documentation>Specifies the format of the data being changed.</xs:documentation>
1737 </xs:annotation>
1738 <xs:simpleType>
1739 <xs:restriction base="xs:string">
1740 <xs:enumeration value="Text" />
1741 <xs:enumeration value="Key" />
1742 <xs:enumeration value="Integer" />
1743 <xs:enumeration value="Bitfield" />
1744 </xs:restriction>
1745 </xs:simpleType>
1746 </xs:attribute>
1747 <xs:attribute name="Type" type="xs:string">
1748 <xs:annotation>
1749 <xs:documentation>Specifies the type of the data being changed.</xs:documentation>
1750 </xs:annotation>
1751 </xs:attribute>
1752 <xs:attribute name="ContextData" type="xs:string">
1753 <xs:annotation>
1754 <xs:documentation>Specifies a semantic context for the requested data.</xs:documentation>
1755 </xs:annotation>
1756 </xs:attribute>
1757 <xs:attribute name="DefaultValue" type="xs:string">
1758 <xs:annotation>
1759 <xs:documentation>Specifies a default value for the item in this record if the merge tool declines to provide a value.</xs:documentation>
1760 </xs:annotation>
1761 </xs:attribute>
1762 <xs:attribute name="KeyNoOrphan" type="YesNoTypeUnion">
1763 <xs:annotation>
1764 <xs:documentation>Does not merge rule according to rules in MSI SDK.</xs:documentation>
1765 </xs:annotation>
1766 </xs:attribute>
1767 <xs:attribute name="NonNullable" type="YesNoTypeUnion">
1768 <xs:annotation>
1769 <xs:documentation>If yes, null is not a valid entry.</xs:documentation>
1770 </xs:annotation>
1771 </xs:attribute>
1772 <xs:attribute name="DisplayName" type="xs:string">
1773 <xs:annotation>
1774 <xs:documentation>Display name for authoring.</xs:documentation>
1775 </xs:annotation>
1776 </xs:attribute>
1777 <xs:attribute name="Description" type="xs:string">
1778 <xs:annotation>
1779 <xs:documentation>Description for authoring.</xs:documentation>
1780 </xs:annotation>
1781 </xs:attribute>
1782 <xs:attribute name="HelpLocation" type="xs:string">
1783 <xs:annotation>
1784 <xs:documentation>Location of chm file for authoring.</xs:documentation>
1785 </xs:annotation>
1786 </xs:attribute>
1787 <xs:attribute name="HelpKeyword" type="xs:string">
1788 <xs:annotation>
1789 <xs:documentation>Keyword into chm file for authoring.</xs:documentation>
1790 </xs:annotation>
1791 </xs:attribute>
1792 </xs:complexType>
1793 </xs:element>
1794 <xs:element name="Substitution">
1795 <xs:annotation>
1796 <xs:documentation>Specifies the configurable fields of a module database and provides a template for the configuration of each field.</xs:documentation>
1797 </xs:annotation>
1798 <xs:complexType>
1799 <xs:attribute name="Table" type="xs:string" use="required">
1800 <xs:annotation>
1801 <xs:documentation>Specifies the name of the table being modified in the module database.</xs:documentation>
1802 </xs:annotation>
1803 </xs:attribute>
1804 <xs:attribute name="Row" type="xs:string" use="required">
1805 <xs:annotation>
1806 <xs:documentation>Specifies the primary keys of the target row in the table named in the Table column. If multiple keys, separated by semicolons.</xs:documentation>
1807 </xs:annotation>
1808 </xs:attribute>
1809 <xs:attribute name="Column" type="xs:string" use="required">
1810 <xs:annotation>
1811 <xs:documentation>Specifies the target column in the row named in the Row column.</xs:documentation>
1812 </xs:annotation>
1813 </xs:attribute>
1814 <xs:attribute name="Value" type="xs:string">
1815 <xs:annotation>
1816 <xs:documentation>Provides a formatting template for the data being substituted into the target field specified by Table, Row, and Column.</xs:documentation>
1817 </xs:annotation>
1818 </xs:attribute>
1819 </xs:complexType>
1820 </xs:element>
1821 <xs:element name="IgnoreTable">
1822 <xs:annotation>
1823 <xs:documentation>
1824 Specifies a table from the merge module that is not merged into an .msi file.
1825 If the table already exists in an .msi file, it is not modified by the merge.
1826 The specified table can therefore contain data that is unneeded after the merge.
1827 To minimize the size of the .msm file, it is recommended that developers remove
1828 unused tables from modules intended for redistribution rather than creating
1829 IgnoreTable elements for those tables.
1830 </xs:documentation>
1831 </xs:annotation>
1832 <xs:complexType>
1833 <xs:attribute name="Id" type="xs:string" use="required">
1834 <xs:annotation>
1835 <xs:documentation>
1836 The name of the table in the merge module that is not to be merged into the .msi file.
1837 </xs:documentation>
1838 </xs:annotation>
1839 </xs:attribute>
1840 </xs:complexType>
1841 </xs:element>
1842 <xs:element name="Fragment">
1843 <xs:annotation>
1844 <xs:documentation>
1845 The Fragment element is the building block of creating an installer database in WiX. Once defined,
1846 the Fragment becomes an immutable, atomic unit which can either be completely included or excluded
1847 from a product. The contents of a Fragment element can be linked into a product by utilizing one
1848 of the many *Ref elements. When linking in a Fragment, it will be necessary to link in all of its
1849 individual units. For instance, if a given Fragment contains two Component elements, you must link
1850 both under features using ComponentRef for each linked Component. Otherwise, you will get a linker
1851 warning and have a floating Component that does not appear under any Feature.
1852 </xs:documentation>
1853 </xs:annotation>
1854 <xs:complexType>
1855 <xs:choice minOccurs="0" maxOccurs="unbounded">
1856 <xs:element ref="AppId" />
1857 <xs:element ref="Binary" />
1858 <xs:element ref="BootstrapperApplication" />
1859 <xs:element ref="BootstrapperApplicationRef" />
1860 <xs:element ref="ComplianceCheck" />
1861 <xs:element ref="Component" />
1862 <xs:element ref="ComponentGroup" />
1863 <xs:element ref="Condition" />
1864 <xs:element ref="Container" />
1865 <xs:element ref="CustomAction" />
1866 <xs:element ref="CustomActionRef" />
1867 <xs:element ref="CustomTable" />
1868 <xs:element ref="Directory" />
1869 <xs:element ref="DirectoryRef" />
1870 <xs:element ref="EmbeddedChainer" />
1871 <xs:element ref="EmbeddedChainerRef" />
1872 <xs:element ref="EnsureTable" />
1873 <xs:element ref="Feature" />
1874 <xs:element ref="FeatureGroup" />
1875 <xs:element ref="FeatureRef" />
1876 <xs:element ref="Icon" />
1877 <xs:element ref="IgnoreModularization" />
1878 <xs:element ref="Media" />
1879 <xs:element ref="MediaTemplate" />
1880 <xs:element ref="PackageGroup" />
1881 <xs:element ref="PackageCertificates" />
1882 <xs:element ref="PatchCertificates" />
1883 <xs:element ref="PatchFamily" />
1884 <xs:element ref="PatchFamilyGroup"/>
1885 <xs:element ref="PayloadGroup" />
1886 <xs:element ref="Property" />
1887 <xs:element ref="PropertyRef" />
1888 <xs:element ref="RelatedBundle" />
1889 <xs:element ref="SetDirectory" />
1890 <xs:element ref="SetProperty" />
1891 <xs:element ref="SFPCatalog" />
1892 <xs:element ref="UI" />
1893 <xs:element ref="UIRef" />
1894 <xs:element ref="Upgrade" />
1895 <xs:element ref="Variable" />
1896 <xs:element ref="WixVariable" />
1897 <xs:sequence>
1898 <xs:element ref="InstallExecuteSequence" minOccurs="0" />
1899 <xs:element ref="InstallUISequence" minOccurs="0" />
1900 <xs:element ref="AdminExecuteSequence" minOccurs="0" />
1901 <xs:element ref="AdminUISequence" minOccurs="0" />
1902 <xs:element ref="AdvertiseExecuteSequence" minOccurs="0" />
1903 </xs:sequence>
1904 <xs:any namespace="##other" processContents="lax">
1905 <xs:annotation>
1906 <xs:documentation>
1907 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1908 elements at this point in the schema.
1909 </xs:documentation>
1910 </xs:annotation>
1911 </xs:any>
1912 </xs:choice>
1913 <xs:attribute name="Id" type="xs:string">
1914 <xs:annotation>
1915 <xs:documentation>
1916 Optional identifier for a Fragment. Should only be set by advanced users to tag sections.
1917 </xs:documentation>
1918 </xs:annotation>
1919 </xs:attribute>
1920 </xs:complexType>
1921 </xs:element>
1922 <xs:element name="Patch">
1923 <xs:annotation>
1924 <xs:documentation>
1925 The Patch element is analogous to the main function in a C program. When linking, only one Patch section
1926 can be given to the linker to produce a successful result. Using this element creates an MSP file.
1927 </xs:documentation>
1928 <xs:appinfo>
1929 <xse:remarks>
1930 <html:p>You can specify any valid Windows code by by integer like 1252, or by web name like Windows-1252. See <html:a href="~/overview/codepage.html">Code Pages</html:a> for more information.</html:p>
1931 <html:p>The ClientPatchId attribute allows you to specify an easily referenced identity that you can use in product authoring. This identity prefixes properties added by WiX to a patch transform, such as <html:i>ClientPatchId</html:i>.PatchCode and <html:i>ClientPatchId</html:i>.AllowRemoval. If the patch code GUID is auto-generated you could not reference any properties using this auto-generated prefix.</html:p>
1932 <html:p>For example, if you were planning to ship a patch referred to as "QFE1" and needed to write your own registry values for Add/Remove Programs in product authoring such as the UninstallString for this patch, you could author a RegistryValue with the name UninstallString and the value <html:code><html:nobr>[SystemFolder]msiexec.exe</html:nobr> /package [ProductCode] /uninstall [QFE1.PatchCode]</html:code>. In your patch authoring you would then set ClientPatchId to "QFE1" and WiX will add the QFE1.PatchCode property to the patch transform when the patch is created. If the Id attribute specified the patch code to be generated automatically, you could not reference the <html:i>prefix</html:i>.PatchCode property as shown above.</html:p>
1933 <html:p>The summary information is automatically populated from attribute values of the Patch element including the code page. If you want to override some of these summary information properties or use a different code page for the summary information itself, author the PatchInformation element.</html:p>
1934 </xse:remarks>
1935 </xs:appinfo>
1936 </xs:annotation>
1937 <xs:complexType>
1938 <xs:sequence>
1939 <xs:choice minOccurs="0" maxOccurs="unbounded">
1940 <xs:element ref="PatchInformation" minOccurs="0" maxOccurs="1">
1941 <xs:annotation>
1942 <xs:documentation>Optional element that allows overriding summary information properties.</xs:documentation>
1943 </xs:annotation>
1944 </xs:element>
1945 <xs:element ref="Media" minOccurs="1" maxOccurs="unbounded" />
1946 <xs:element ref="OptimizeCustomActions" minOccurs="0" maxOccurs="1">
1947 <xs:annotation>
1948 <xs:documentation>Indicates whether custom actions can be skipped when applying the patch.</xs:documentation>
1949 </xs:annotation>
1950 </xs:element>
1951 <xs:element ref="PatchFamily" minOccurs="1" maxOccurs="unbounded" />
1952 <xs:element ref="PatchFamilyRef" minOccurs="0" maxOccurs="unbounded" />
1953 <xs:element ref="PatchFamilyGroup" minOccurs="1" maxOccurs="unbounded"/>
1954 <xs:element ref="PatchFamilyGroupRef" minOccurs="0" maxOccurs="unbounded"/>
1955 <xs:element ref="PatchProperty" />
1956 <xs:element ref="TargetProductCodes" />
1957 <xs:any namespace="##other" processContents="lax">
1958 <xs:annotation>
1959 <xs:documentation>
1960 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1961 elements at this point in the schema.
1962 </xs:documentation>
1963 </xs:annotation>
1964 </xs:any>
1965 </xs:choice>
1966 </xs:sequence>
1967 <xs:attribute name="Id" type="AutogenGuid">
1968 <xs:annotation>
1969 <xs:documentation>Patch code for this patch.</xs:documentation>
1970 </xs:annotation>
1971 </xs:attribute>
1972 <xs:attribute name="Codepage" type="xs:string">
1973 <xs:annotation>
1974 <xs:documentation>The code page integer value or web name for the resulting MSP. See remarks for more information.</xs:documentation>
1975 </xs:annotation>
1976 </xs:attribute>
1977 <xs:attribute name="AllowRemoval" type="YesNoTypeUnion">
1978 <xs:annotation>
1979 <xs:documentation>Whether this is an uninstallable patch.</xs:documentation>
1980 </xs:annotation>
1981 </xs:attribute>
1982 <xs:attribute name="Classification" type="xs:string" use="required">
1983 <xs:annotation>
1984 <xs:documentation>Category of updates. Recommended values are Critical Update, Hotfix, Security Rollup, Security Update, Service Pack, Update, Update Rollup.</xs:documentation>
1985 </xs:annotation>
1986 </xs:attribute>
1987 <xs:attribute name="ClientPatchId" type="xs:string">
1988 <xs:annotation>
1989 <xs:documentation>An easily referenced identity unique to a patch that can be used in product authoring. See remarks for more information.</xs:documentation>
1990 </xs:annotation>
1991 </xs:attribute>
1992 <xs:attribute name="ApiPatchingSymbolNoImagehlpFlag" type="YesNoTypeUnion">
1993 <xs:annotation>
1994 <xs:documentation>Flag used when creating a binary file patch. Default is "no". Don't use imagehlp.dll.</xs:documentation>
1995 </xs:annotation>
1996 </xs:attribute>
1997 <xs:attribute name="ApiPatchingSymbolNoFailuresFlag" type="YesNoTypeUnion">
1998 <xs:annotation>
1999 <xs:documentation>Flag used when creating a binary file patch. Default is "no". Don't fail patch due to imagehlp failures.</xs:documentation>
2000 </xs:annotation>
2001 </xs:attribute>
2002 <xs:attribute name="ApiPatchingSymbolUndecoratedTooFlag" type="YesNoTypeUnion">
2003 <xs:annotation>
2004 <xs:documentation>Flag used when creating a binary file patch. Default is "no". After matching decorated symbols, try to match remaining by undecorated names.</xs:documentation>
2005 </xs:annotation>
2006 </xs:attribute>
2007 <xs:attribute name="Description" type="xs:string" use="required">
2008 <xs:annotation>
2009 <xs:documentation>Description of the patch.</xs:documentation>
2010 </xs:annotation>
2011 </xs:attribute>
2012 <xs:attribute name="DisplayName" type="xs:string" use="required">
2013 <xs:annotation>
2014 <xs:documentation>A title for the patch that is suitable for public display. In Add/Remove Programs from XP SP2 on.</xs:documentation>
2015 </xs:annotation>
2016 </xs:attribute>
2017 <xs:attribute name="Comments" type="xs:string">
2018 <xs:annotation>
2019 <xs:documentation>Optional comments for browsing.</xs:documentation>
2020 </xs:annotation>
2021 </xs:attribute>
2022 <xs:attribute name="Manufacturer" type="xs:string">
2023 <xs:annotation>
2024 <xs:documentation>Vendor releasing the package</xs:documentation>
2025 </xs:annotation>
2026 </xs:attribute>
2027 <xs:attribute name="MinorUpdateTargetRTM" type="YesNoTypeUnion">
2028 <xs:annotation>
2029 <xs:documentation>
2030 Indicates that the patch targets the RTM version of the product or the most recent major
2031 upgrade patch. Author this optional property in minor update patches that contain sequencing
2032 information to indicate that the patch removes all patches up to the RTM version of the
2033 product, or up to the most recent major upgrade patch. This property is available beginning
2034 with Windows Installer 3.1.
2035 </xs:documentation>
2036 </xs:annotation>
2037 </xs:attribute>
2038 <xs:attribute name="MoreInfoURL" type="xs:string">
2039 <xs:annotation>
2040 <xs:documentation>A URL that provides information specific to this patch. In Add/Remove Programs from XP SP2 on.</xs:documentation>
2041 </xs:annotation>
2042 </xs:attribute>
2043 <xs:attribute name="OptimizedInstallMode" type="YesNoTypeUnion">
2044 <xs:annotation>
2045 <xs:documentation>
2046 If this attribute is set to 'yes' in all the patches to be applied in a transaction, the
2047 application of the patch is optimized if possible. Available beginning with Windows Installer 3.1.
2048 </xs:documentation>
2049 </xs:annotation>
2050 </xs:attribute>
2051 <xs:attribute name="TargetProductName" type="xs:string">
2052 <xs:annotation>
2053 <xs:documentation>Name of the application or target product suite.</xs:documentation>
2054 </xs:annotation>
2055 </xs:attribute>
2056 <xs:attribute name="OptimizePatchSizeForLargeFiles" type="YesNoTypeUnion">
2057 <xs:annotation>
2058 <xs:documentation>When this attribute is set, patches for files greater than approximately 4 MB in size may be made smaller.</xs:documentation>
2059 </xs:annotation>
2060 </xs:attribute>
2061 </xs:complexType>
2062 </xs:element>
2063 <xs:element name="Validate">
2064 <xs:annotation>
2065 <xs:documentation>Sets information in the patch transform that determines if the transform applies to an installed product and what errors should be ignored when applying the patch transform.</xs:documentation>
2066 <xs:appinfo>
2067 <xse:remarks>
2068 <html:p>A transform contains the differences between the target product and the upgraded product. When a transform or a patch (which contains transforms) is applied, the following properties of the installed product are validated against the properties of the target product stored in a transform.</html:p>
2069 <html:ul>
2070 <html:li>ProductCode</html:li>
2071 <html:li>ProductLanguage</html:li>
2072 <html:li>ProductVersion</html:li>
2073 <html:li>UpgradeCode</html:li>
2074 </html:ul>
2075 <html:p>Windows Installer simply validates that the ProductCode, ProductLanguage, and UpgradeCode of an installed product are equivalent to those propeties of the target product used to create the transform; however, the ProductVersion can be validated with a greater range of comparisons.</html:p>
2076 <html:p>You can compare up to the first three fields of the ProductVersion. Changes to the fourth field are not validated and are useful for small updates. You can also choose how to compare the target ProductVersion used to create the transform with the installed ProductVersion. For example, while the default value of 'Equals' is recommended, if you wanted a minor upgrade patch to apply to the target ProductVersion and all older products with the same ProductCode, you would use 'LesserOrEqual'.</html:p>
2077 </xse:remarks>
2078 </xs:appinfo>
2079 </xs:annotation>
2080 <xs:complexType>
2081 <xs:attribute name="ProductId" type="YesNoTypeUnion" default="yes">
2082 <xs:annotation>
2083 <xs:documentation>Requires that the installed ProductCode match the target ProductCode used to create the transform. The default is 'yes'.</xs:documentation>
2084 </xs:annotation>
2085 </xs:attribute>
2086 <xs:attribute name="ProductLanguage" type="YesNoTypeUnion" default="no">
2087 <xs:annotation>
2088 <xs:documentation>Requires that the installed ProductLanguage match the target ProductLanguage used to create the transform. The default is 'no'.</xs:documentation>
2089 </xs:annotation>
2090 </xs:attribute>
2091 <xs:attribute name="ProductVersion" default="Update">
2092 <xs:annotation>
2093 <xs:documentation>Determines how many fields of the installed ProductVersion to compare. See remarks for more information. The default is 'Update'.</xs:documentation>
2094 </xs:annotation>
2095 <xs:simpleType>
2096 <xs:restriction base="xs:NMTOKEN">
2097 <xs:enumeration value="Major">
2098 <xs:annotation>
2099 <xs:documentation>Checks the major version.</xs:documentation>
2100 </xs:annotation>
2101 </xs:enumeration>
2102 <xs:enumeration value="Minor">
2103 <xs:annotation>
2104 <xs:documentation>Checks the major and minor versions.</xs:documentation>
2105 </xs:annotation>
2106 </xs:enumeration>
2107 <xs:enumeration value="Update">
2108 <xs:annotation>
2109 <xs:documentation>Checks the major, minor, and update versions.</xs:documentation>
2110 </xs:annotation>
2111 </xs:enumeration>
2112 </xs:restriction>
2113 </xs:simpleType>
2114 </xs:attribute>
2115 <xs:attribute name="ProductVersionOperator" default="Equal">
2116 <xs:annotation>
2117 <xs:documentation>Determines how the installed ProductVersion is compared to the target ProductVersion used to create the transform. See remarks for more information. The default is 'Equal'.</xs:documentation>
2118 </xs:annotation>
2119 <xs:simpleType>
2120 <xs:restriction base="xs:NMTOKEN">
2121 <xs:enumeration value="Lesser">
2122 <xs:annotation>
2123 <xs:documentation>Installed ProductVersion &lt; target ProductVersion.</xs:documentation>
2124 </xs:annotation>
2125 </xs:enumeration>
2126 <xs:enumeration value="LesserOrEqual">
2127 <xs:annotation>
2128 <xs:documentation>Installed ProductVersion &lt;= target ProductVersion.</xs:documentation>
2129 </xs:annotation>
2130 </xs:enumeration>
2131 <xs:enumeration value="Equal">
2132 <xs:annotation>
2133 <xs:documentation>Installed ProductVersion = target ProductVersion.</xs:documentation>
2134 </xs:annotation>
2135 </xs:enumeration>
2136 <xs:enumeration value="GreaterOrEqual">
2137 <xs:annotation>
2138 <xs:documentation>Installed ProductVersion &gt;= target ProductVersion.</xs:documentation>
2139 </xs:annotation>
2140 </xs:enumeration>
2141 <xs:enumeration value="Greater">
2142 <xs:annotation>
2143 <xs:documentation>Installed ProductVersion &gt; target ProductVersion.</xs:documentation>
2144 </xs:annotation>
2145 </xs:enumeration>
2146 </xs:restriction>
2147 </xs:simpleType>
2148 </xs:attribute>
2149 <xs:attribute name="UpgradeCode" type="YesNoTypeUnion" default="yes">
2150 <xs:annotation>
2151 <xs:documentation>Requires that the installed UpgradeCode match the target UpgradeCode used to create the transform. The default is 'yes'.</xs:documentation>
2152 </xs:annotation>
2153 </xs:attribute>
2154 <xs:attribute name="IgnoreAddExistingRow" type="YesNoTypeUnion" default="yes">
2155 <xs:annotation>
2156 <xs:documentation>Ignore errors when adding existing rows. The default is 'yes'.</xs:documentation>
2157 </xs:annotation>
2158 </xs:attribute>
2159 <xs:attribute name="IgnoreAddExistingTable" type="YesNoTypeUnion" default="yes">
2160 <xs:annotation>
2161 <xs:documentation>Ignore errors when adding existing tables. The default is 'yes'.</xs:documentation>
2162 </xs:annotation>
2163 </xs:attribute>
2164 <xs:attribute name="IgnoreDeleteMissingRow" type="YesNoTypeUnion" default="yes">
2165 <xs:annotation>
2166 <xs:documentation>Ignore errors when deleting missing rows. The default is 'yes'.</xs:documentation>
2167 </xs:annotation>
2168 </xs:attribute>
2169 <xs:attribute name="IgnoreDeleteMissingTable" type="YesNoTypeUnion" default="yes">
2170 <xs:annotation>
2171 <xs:documentation>Ignore errors when deleting missing tables. The default is 'yes'.</xs:documentation>
2172 </xs:annotation>
2173 </xs:attribute>
2174 <xs:attribute name="IgnoreUpdateMissingRow" type="YesNoTypeUnion" default="yes">
2175 <xs:annotation>
2176 <xs:documentation>Ignore errors when updating missing rows. The default is 'yes'.</xs:documentation>
2177 </xs:annotation>
2178 </xs:attribute>
2179 <xs:attribute name="IgnoreChangingCodePage" type="YesNoTypeUnion" default="no">
2180 <xs:annotation>
2181 <xs:documentation>Ignore errors when changing the database code page. The default is 'no'.</xs:documentation>
2182 </xs:annotation>
2183 </xs:attribute>
2184 </xs:complexType>
2185 </xs:element>
2186 <xs:element name="OptimizeCustomActions">
2187 <xs:annotation>
2188 <xs:documentation>Indicates whether custom actions can be skipped when applying the patch.</xs:documentation>
2189 <xs:appinfo>
2190 <xse:msiRef table="MsiPatchMetadata" href="http://msdn.microsoft.com/library/aa370344.aspx" />
2191 </xs:appinfo>
2192 </xs:annotation>
2193 <xs:complexType>
2194 <xs:attribute name="SkipAssignment" type="YesNoTypeUnion">
2195 <xs:annotation>
2196 <xs:documentation>Skip property (type 51) and directory (type 35) assignment custom actions.</xs:documentation>
2197 </xs:annotation>
2198 </xs:attribute>
2199 <xs:attribute name="SkipImmediate" type="YesNoTypeUnion">
2200 <xs:annotation>
2201 <xs:documentation>Skip immediate custom actions that are not property or directory assignment custom actions.</xs:documentation>
2202 </xs:annotation>
2203 </xs:attribute>
2204 <xs:attribute name="SkipDeferred" type="YesNoTypeUnion">
2205 <xs:annotation>
2206 <xs:documentation>Skip custom actions that run within the script.</xs:documentation>
2207 </xs:annotation>
2208 </xs:attribute>
2209 </xs:complexType>
2210 </xs:element>
2211 <xs:element name="PatchBaseline">
2212 <xs:annotation>
2213 <xs:documentation>Identifies a set of product versions.</xs:documentation>
2214 </xs:annotation>
2215 <xs:complexType>
2216 <xs:choice minOccurs="0">
2217 <xs:element ref="Validate" minOccurs="0" />
2218 </xs:choice>
2219 <xs:attribute name="Id" type="xs:string" use="required">
2220 <xs:annotation>
2221 <xs:documentation>Identifier for a set of product versions.</xs:documentation>
2222 </xs:annotation>
2223 </xs:attribute>
2224 </xs:complexType>
2225 </xs:element>
2226 <xs:element name="PatchFamily">
2227 <xs:annotation>
2228 <xs:documentation>Collection of items that should be kept from the differences between two products.</xs:documentation>
2229 </xs:annotation>
2230 <xs:complexType>
2231 <xs:sequence>
2232 <xs:choice minOccurs="0" maxOccurs="unbounded">
2233 <xs:element ref="All" minOccurs="0" />
2234 <xs:element ref="BinaryRef" minOccurs="0" maxOccurs="unbounded" />
2235 <xs:element ref="ComponentRef" minOccurs="0" maxOccurs="unbounded" />
2236 <xs:element ref="CustomActionRef" minOccurs="0" maxOccurs="unbounded" />
2237 <xs:element ref="DigitalCertificateRef" minOccurs="0" maxOccurs="unbounded" />
2238 <xs:element ref="DirectoryRef" minOccurs="0" maxOccurs="unbounded" />
2239 <xs:element ref="FeatureRef" minOccurs="0" maxOccurs="unbounded" />
2240 <xs:element ref="IconRef" minOccurs="0" maxOccurs="unbounded" />
2241 <xs:element ref="PropertyRef" minOccurs="0" maxOccurs="unbounded" />
2242 <xs:element ref="UIRef" minOccurs="0" maxOccurs="unbounded" />
2243 <xs:any namespace="##other" processContents="lax">
2244 <xs:annotation>
2245 <xs:documentation>
2246 Extensibility point in the WiX XML Schema. Schema extensions can register additional
2247 elements at this point in the schema.
2248 </xs:documentation>
2249 </xs:annotation>
2250 </xs:any>
2251 </xs:choice>
2252 </xs:sequence>
2253 <xs:attribute name="Id" type="xs:string" use="required">
2254 <xs:annotation>
2255 <xs:documentation>Identifier which indicates a sequence family to which this patch belongs.</xs:documentation>
2256 </xs:annotation>
2257 </xs:attribute>
2258 <xs:attribute name="ProductCode" type="Guid">
2259 <xs:annotation>
2260 <xs:documentation>
2261 Specifies the ProductCode of the product that this family applies to.
2262 </xs:documentation>
2263 </xs:annotation>
2264 </xs:attribute>
2265 <xs:attribute name="Version" type="xs:string" use="required">
2266 <xs:annotation>
2267 <xs:documentation>Used to populate the sequence column of the MsiPatchSequence table in the final MSP file. Specified in x.x.x.x format. See documentation for Sequence column of MsiPatchSequence table in MSI SDK.</xs:documentation>
2268 </xs:annotation>
2269 </xs:attribute>
2270 <xs:attribute name="Supersede" type="YesNoTypeUnion">
2271 <xs:annotation>
2272 <xs:documentation>
2273 Set this value to 'yes' to indicate that this patch will supersede all previous patches in this patch family.
2274 The default value is 'no'.
2275 </xs:documentation>
2276 </xs:annotation>
2277 </xs:attribute>
2278 </xs:complexType>
2279 </xs:element>
2280 <xs:element name="PatchFamilyGroup">
2281 <xs:annotation>
2282 <xs:documentation>
2283 Groups together multiple patch families to be used in other locations.
2284 </xs:documentation>
2285 <xs:appinfo>
2286 <xse:seeAlso ref="PatchFamilyGroupRef"/>
2287 </xs:appinfo>
2288 </xs:annotation>
2289 <xs:complexType>
2290 <xs:choice minOccurs="0" maxOccurs="unbounded">
2291 <xs:element ref="PatchFamily"/>
2292 <xs:element ref="PatchFamilyRef"/>
2293 <xs:element ref="PatchFamilyGroupRef"/>
2294 <xs:any namespace="##other" processContents="lax">
2295 <xs:annotation>
2296 <xs:documentation>
2297 Extensibility point in the WiX XML Schema. Schema extensions can register additional
2298 elements at this point in the schema.
2299 </xs:documentation>
2300 </xs:annotation>
2301 </xs:any>
2302 </xs:choice>
2303 <xs:attribute name="Id" type="xs:string" use="required">
2304 <xs:annotation>
2305 <xs:documentation>Identifier for the PatchFamilyGroup.</xs:documentation>
2306 </xs:annotation>
2307 </xs:attribute>
2308 <xs:anyAttribute namespace="##other" processContents="lax">
2309 <xs:annotation>
2310 <xs:documentation>
2311 Extensibility point in the WiX XML Schema. Schema extensions can register additional
2312 attributes at this point in the schema.
2313 </xs:documentation>
2314 </xs:annotation>
2315 </xs:anyAttribute>
2316 </xs:complexType>
2317</xs:element>
2318<xs:element name="PatchFamilyGroupRef">
2319 <xs:annotation>
2320 <xs:documentation>Create a reference to a PatchFamilyGroup in another Fragment.</xs:documentation>
2321 <xs:appinfo>
2322 <xse:seeAlso ref="PatchFamilyGroupRef"/>
2323 </xs:appinfo>
2324 </xs:annotation>
2325 <xs:complexType>
2326 <xs:attribute name="Id" type="xs:string" use="required">
2327 <xs:annotation>
2328 <xs:documentation>The identifier of the PatchFamilyGroup to reference.</xs:documentation>
2329 </xs:annotation>
2330 </xs:attribute>
2331 <xs:anyAttribute namespace="##other" processContents="lax">
2332 <xs:annotation>
2333 <xs:documentation>
2334 Extensibility point in the WiX XML Schema. Schema extensions can register additional
2335 attributes at this point in the schema.
2336 </xs:documentation>
2337 </xs:annotation>
2338 </xs:anyAttribute>
2339 </xs:complexType>
2340</xs:element>
2341 <xs:element name="PatchCreation">
2342 <xs:annotation>
2343 <xs:documentation>
2344 The PatchCreation element is analogous to the main function in a C program. When linking, only one PatchCreation section
2345 can be given to the linker to produce a successful result. Using this element creates a pcp file.
2346 </xs:documentation>
2347 <xs:appinfo>
2348 <xse:remarks>
2349 <html:p>You can specify any valid Windows code by by integer like 1252, or by web name like Windows-1252. See <html:a href="~/overview/codepage.html">Code Pages</html:a> for more information.</html:p>
2350 </xse:remarks>
2351 </xs:appinfo>
2352 </xs:annotation>
2353 <xs:complexType>
2354 <xs:sequence>
2355 <xs:element ref="PatchInformation" />
2356 <xs:element ref="PatchMetadata" minOccurs="0" />
2357 <xs:element ref="Family" maxOccurs="unbounded" />
2358 <xs:choice minOccurs="0" maxOccurs="unbounded">
2359 <xs:element ref="PatchProperty" />
2360 <xs:element ref="PatchSequence" />
2361 <xs:element ref="ReplacePatch" />
2362 <xs:element ref="TargetProductCode" />
2363 </xs:choice>
2364 </xs:sequence>
2365 <xs:attribute name="Id" type="Guid" use="required">
2366 <xs:annotation>
2367 <xs:documentation>PatchCreation identifier; this is the primary key for identifying patches.</xs:documentation>
2368 </xs:annotation>
2369 </xs:attribute>
2370 <xs:attribute name="AllowMajorVersionMismatches" type="YesNoTypeUnion">
2371 <xs:annotation>
2372 <xs:documentation>Use this to set whether the major versions between the upgrade and target images match. See <html:a href="http://msdn.microsoft.com/library/aa370890.aspx" target="_blank">AllowProductVersionMajorMismatches</html:a> for more information.</xs:documentation>
2373 </xs:annotation>
2374 </xs:attribute>
2375 <xs:attribute name="AllowProductCodeMismatches" type="YesNoTypeUnion">
2376 <xs:annotation>
2377 <xs:documentation>Use this to set whether the product code between the upgrade and target images match. See <html:a href="http://msdn.microsoft.com/library/aa370890.aspx" target="_blank">AllowProductCodeMismatches</html:a> for more information.</xs:documentation>
2378 </xs:annotation>
2379 </xs:attribute>
2380 <xs:attribute name="CleanWorkingFolder" type="YesNoTypeUnion">
2381 <xs:annotation>
2382 <xs:documentation>Use this to set whether Patchwiz should clean the temp folder when finished. See <html:a href="http://msdn.microsoft.com/library/aa370890.aspx" target="_blank">DontRemoveTempFolderWhenFinished</html:a> for more information. </xs:documentation>
2383 </xs:annotation>
2384 </xs:attribute>
2385 <xs:attribute name="Codepage" type="xs:string">
2386 <xs:annotation>
2387 <xs:documentation>The code page integer value or web name for the resulting PCP. See remarks for more information.</xs:documentation>
2388 </xs:annotation>
2389 </xs:attribute>
2390 <xs:attribute name="OutputPath" type="xs:string">
2391 <xs:annotation>
2392 <xs:documentation>The full path, including file name, of the patch package file that is to be generated. See <html:a href="http://msdn.microsoft.com/library/aa370890.aspx" target="_blank">PatchOutputPath</html:a> for more information.</xs:documentation>
2393 </xs:annotation>
2394 </xs:attribute>
2395 <xs:attribute name="SourceList" type="xs:string">
2396 <xs:annotation>
2397 <xs:documentation>Used to locate the .msp file for the patch if the cached copy is unavailable. See <html:a href="http://msdn.microsoft.com/library/aa370890.aspx" target="_blank">PatchSourceList</html:a> for more information.</xs:documentation>
2398 </xs:annotation>
2399 </xs:attribute>
2400 <xs:attribute name="SymbolFlags" type="xs:int">
2401 <xs:annotation>
2402 <xs:documentation>An 8-digit hex integer representing the combination of patch symbol usage flags to use when creating a binary file patch. See <html:a href="http://msdn.microsoft.com/library/aa370890.aspx" target="_blank">ApiPatchingSymbolFlags</html:a> for more information.</xs:documentation>
2403 </xs:annotation>
2404 </xs:attribute>
2405 <xs:attribute name="WholeFilesOnly" type="YesNoTypeUnion">
2406 <xs:annotation>
2407 <xs:documentation>Use this to set whether changing files should be included in their entirety. See <html:a href="http://msdn.microsoft.com/library/aa370890.aspx" target="_blank">IncludeWholeFilesOnly</html:a> for more information.</xs:documentation>
2408 </xs:annotation>
2409 </xs:attribute>
2410 </xs:complexType>
2411 </xs:element>
2412 <xs:element name="PatchInformation">
2413 <xs:annotation>
2414 <xs:documentation>Properties about the patch to be placed in the Summary Information Stream. These are visible from COM through the IStream interface, and these properties can be seen on the package in Explorer.</xs:documentation>
2415 <xs:appinfo>
2416 <xse:remarks>
2417 <html:p>You can specify any valid Windows code by by integer like 1252, or by web name like Windows-1252. See <html:a href="~/overview/codepage.html">Code Pages</html:a> for more information.</html:p>
2418 </xse:remarks>
2419 </xs:appinfo>
2420 </xs:annotation>
2421 <xs:complexType>
2422 <xs:attribute name="Description" type="xs:string">
2423 <xs:annotation>
2424 <xs:documentation>A short description of the patch that includes the name of the product.</xs:documentation>
2425 </xs:annotation>
2426 </xs:attribute>
2427 <xs:attribute name="Platforms" type="xs:string">
2428 <xs:annotation>
2429 <xs:appinfo>
2430 <xse:deprecated />
2431 </xs:appinfo>
2432 </xs:annotation>
2433 </xs:attribute>
2434 <xs:attribute name="Languages" type="xs:string">
2435 <xs:annotation>
2436 <xs:appinfo>
2437 <xse:deprecated />
2438 </xs:appinfo>
2439 </xs:annotation>
2440 </xs:attribute>
2441 <xs:attribute name="Manufacturer" type="xs:string">
2442 <xs:annotation>
2443 <xs:documentation>The name of the manufacturer of the patch package.</xs:documentation>
2444 </xs:annotation>
2445 </xs:attribute>
2446 <xs:attribute name="Keywords" type="xs:string">
2447 <xs:annotation>
2448 <xs:documentation>A semicolon-delimited list of network or URL locations for alternate sources of the patch. The default is "Installer,Patching,PCP,Database".</xs:documentation>
2449 </xs:annotation>
2450 </xs:attribute>
2451 <xs:attribute name="Comments" type="xs:string">
2452 <xs:annotation>
2453 <xs:documentation>General purpose of the patch package. For example, "This patch contains the logic and data required to install <html:i>&lt;product&gt;</html:i>."</xs:documentation>
2454 </xs:annotation>
2455 </xs:attribute>
2456 <xs:attribute name="ReadOnly" type="YesNoDefaultTypeUnion">
2457 <xs:annotation>
2458 <xs:documentation>
2459 The value of this attribute conveys whether the package should be opened as read-only.
2460 A database editing tool should not modify a read-only enforced database and should
2461 issue a warning at attempts to modify a read-only recommended database.
2462 </xs:documentation>
2463 </xs:annotation>
2464 </xs:attribute>
2465 <xs:attribute name="SummaryCodepage" type="xs:string">
2466 <xs:annotation>
2467 <xs:documentation>The code page integer value or web name for summary info strings only. The default is 1252. See remarks for more information.</xs:documentation>
2468 </xs:annotation>
2469 </xs:attribute>
2470 <xs:attribute name="ShortNames" type="YesNoTypeUnion">
2471 <xs:annotation>
2472 <xs:appinfo>
2473 <xse:deprecated />
2474 </xs:appinfo>
2475 </xs:annotation>
2476 </xs:attribute>
2477 <xs:attribute name="Compressed" type="YesNoTypeUnion">
2478 <xs:annotation>
2479 <xs:appinfo>
2480 <xse:deprecated />
2481 </xs:appinfo>
2482 </xs:annotation>
2483 </xs:attribute>
2484 <xs:attribute name="AdminImage" type="YesNoTypeUnion">
2485 <xs:annotation>
2486 <xs:appinfo>
2487 <xse:deprecated />
2488 </xs:appinfo>
2489 </xs:annotation>
2490 </xs:attribute>
2491 </xs:complexType>
2492 </xs:element>
2493 <xs:element name="PatchMetadata">
2494 <xs:annotation>
2495 <xs:documentation>Properties about the patch to be placed in the PatchMetadata table.</xs:documentation>
2496 <xs:appinfo>
2497 <xse:msiRef table="MsiPatchMetadata" href="http://msdn.microsoft.com/library/aa370344.aspx" />
2498 </xs:appinfo>
2499 </xs:annotation>
2500 <xs:complexType>
2501 <xs:sequence>
2502 <xs:choice minOccurs="0" maxOccurs="unbounded">
2503 <xs:element ref="CustomProperty" minOccurs="0">
2504 <xs:annotation>
2505 <xs:documentation>A custom property that extends the standard set.</xs:documentation>
2506 </xs:annotation>
2507 </xs:element>
2508 <xs:element ref="OptimizeCustomActions" minOccurs="0" maxOccurs="1">
2509 <xs:annotation>
2510 <xs:documentation>Indicates whether custom actions can be skipped when applying the patch.</xs:documentation>
2511 </xs:annotation>
2512 </xs:element>
2513 </xs:choice>
2514 </xs:sequence>
2515 <xs:attribute name="AllowRemoval" type="YesNoTypeUnion" use="required">
2516 <xs:annotation>
2517 <xs:documentation>Whether this is an uninstallable patch.</xs:documentation>
2518 </xs:annotation>
2519 </xs:attribute>
2520 <xs:attribute name="Classification" type="xs:string" use="required">
2521 <xs:annotation>
2522 <xs:documentation>Category of updates. Recommended values are Critical Update, Hotfix, Security Rollup, Security Update, Service Pack, Update, Update Rollup.</xs:documentation>
2523 </xs:annotation>
2524 </xs:attribute>
2525 <xs:attribute name="CreationTimeUTC" type="xs:string">
2526 <xs:annotation>
2527 <xs:documentation>Creation time of the .msp file in the form mm-dd-yy HH:MM (month-day-year hour:minute).</xs:documentation>
2528 </xs:annotation>
2529 </xs:attribute>
2530 <xs:attribute name="Description" type="xs:string" use="required">
2531 <xs:annotation>
2532 <xs:documentation>Description of the patch.</xs:documentation>
2533 </xs:annotation>
2534 </xs:attribute>
2535 <xs:attribute name="DisplayName" type="xs:string" use="required">
2536 <xs:annotation>
2537 <xs:documentation>A title for the patch that is suitable for public display. In Add/Remove Programs from XP SP2 on.</xs:documentation>
2538 </xs:annotation>
2539 </xs:attribute>
2540 <xs:attribute name="ManufacturerName" type="xs:string" use="required">
2541 <xs:annotation>
2542 <xs:documentation>Name of the manufacturer.</xs:documentation>
2543 </xs:annotation>
2544 </xs:attribute>
2545 <xs:attribute name="MinorUpdateTargetRTM" type="xs:string">
2546 <xs:annotation>
2547 <xs:documentation>
2548 Indicates that the patch targets the RTM version of the product or the most recent major
2549 upgrade patch. Author this optional property in minor update patches that contain sequencing
2550 information to indicate that the patch removes all patches up to the RTM version of the
2551 product, or up to the most recent major upgrade patch. This property is available beginning
2552 with Windows Installer 3.1.
2553 </xs:documentation>
2554 </xs:annotation>
2555 </xs:attribute>
2556 <xs:attribute name="MoreInfoURL" type="xs:string" use="required">
2557 <xs:annotation>
2558 <xs:documentation>A URL that provides information specific to this patch. In Add/Remove Programs from XP SP2 on.</xs:documentation>
2559 </xs:annotation>
2560 </xs:attribute>
2561 <xs:attribute name="OptimizedInstallMode" type="YesNoTypeUnion">
2562 <xs:annotation>
2563 <xs:documentation>
2564 If this attribute is set to 'yes' in all the patches to be applied in a transaction, the
2565 application of the patch is optimized if possible. Available beginning with Windows Installer 3.1.
2566 </xs:documentation>
2567 </xs:annotation>
2568 </xs:attribute>
2569 <xs:attribute name="TargetProductName" type="xs:string" use="required">
2570 <xs:annotation>
2571 <xs:documentation>Name of the application or target product suite.</xs:documentation>
2572 </xs:annotation>
2573 </xs:attribute>
2574 </xs:complexType>
2575 </xs:element>
2576 <xs:element name="CustomProperty">
2577 <xs:annotation>
2578 <xs:documentation>A custom property for the PatchMetadata table.</xs:documentation>
2579 </xs:annotation>
2580 <xs:complexType>
2581 <xs:attribute name="Company" type="xs:string" use="required">
2582 <xs:annotation>
2583 <xs:documentation>The name of the company.</xs:documentation>
2584 </xs:annotation>
2585 </xs:attribute>
2586 <xs:attribute name="Property" type="xs:string" use="required">
2587 <xs:annotation>
2588 <xs:documentation>The name of the metadata property.</xs:documentation>
2589 </xs:annotation>
2590 </xs:attribute>
2591 <xs:attribute name="Value" type="xs:string" use="required">
2592 <xs:annotation>
2593 <xs:documentation>Value of the metadata property.</xs:documentation>
2594 </xs:annotation>
2595 </xs:attribute>
2596 </xs:complexType>
2597 </xs:element>
2598 <xs:element name="ReplacePatch">
2599 <xs:annotation>
2600 <xs:documentation>A patch that is deprecated by this patch.</xs:documentation>
2601 </xs:annotation>
2602 <xs:complexType>
2603 <xs:attribute name="Id" type="Guid" use="required">
2604 <xs:annotation>
2605 <xs:documentation>Patch GUID to be unregistered if it exists on the machine targeted by this patch.</xs:documentation>
2606 </xs:annotation>
2607 </xs:attribute>
2608 </xs:complexType>
2609 </xs:element>
2610 <xs:element name="TargetProductCodes">
2611 <xs:annotation>
2612 <xs:documentation>
2613 The product codes for products that can accept the patch.
2614 </xs:documentation>
2615 </xs:annotation>
2616 <xs:complexType>
2617 <xs:choice maxOccurs="unbounded">
2618 <xs:element ref="TargetProductCode" />
2619 </xs:choice>
2620 <xs:attribute name="Replace" type="YesNoTypeUnion">
2621 <xs:annotation>
2622 <xs:documentation>Whether to replace the product codes that can accept the patch from the target packages with the child elements.</xs:documentation>
2623 </xs:annotation>
2624 </xs:attribute>
2625 </xs:complexType>
2626 </xs:element>
2627 <xs:element name="TargetProductCode">
2628 <xs:annotation>
2629 <xs:documentation>
2630 A product code for a product that can accept the patch.
2631 </xs:documentation>
2632 <xs:appinfo>
2633 <xse:remarks>
2634 <html:p>When using the PatchCreation element, if the Id attribute value is '*' or this element is not authored, the product codes of all products referenced by the TargetImages element are used.</html:p>
2635 <html:p>When using the Patch element, the Id attribute value must not be '*'. Use the TargetProductCodes/@Replace attribute instead.</html:p>
2636 </xse:remarks>
2637 </xs:appinfo>
2638 </xs:annotation>
2639 <xs:complexType>
2640 <xs:attribute name="Id" type="xs:string" use="required">
2641 <xs:annotation>
2642 <xs:documentation>
2643 The product code for a product that can accept the patch. This can be '*'. See remarks for more information.
2644 </xs:documentation>
2645 </xs:annotation>
2646 </xs:attribute>
2647 </xs:complexType>
2648 </xs:element>
2649 <xs:element name="PatchProperty">
2650 <xs:annotation>
2651 <xs:documentation>A property for this patch database.</xs:documentation>
2652 <xs:appinfo>
2653 <xse:msiRef table="MsiPatchMetadata" href="http://msdn.microsoft.com/library/aa370344.aspx" />
2654 <xse:remarks>
2655 <html:p>When authored under the Patch element, the PatchProperty defines entries in the MsiPatchMetadata table.</html:p>
2656 </xse:remarks>
2657 </xs:appinfo>
2658 </xs:annotation>
2659 <xs:complexType>
2660 <xs:attribute name="Company" type="xs:string">
2661 <xs:annotation>
2662 <xs:documentation>Name of the company for a custom metadata property.</xs:documentation>
2663 </xs:annotation>
2664 </xs:attribute>
2665 <xs:attribute name="Name" type="xs:string" use="required">
2666 <xs:annotation>
2667 <xs:documentation>Name of the patch property.</xs:documentation>
2668 </xs:annotation>
2669 </xs:attribute>
2670 <xs:attribute name="Value" type="xs:string" use="required">
2671 <xs:annotation>
2672 <xs:documentation>Value of the patch property.</xs:documentation>
2673 </xs:annotation>
2674 </xs:attribute>
2675 </xs:complexType>
2676 </xs:element>
2677 <xs:element name="PatchSequence">
2678 <xs:annotation>
2679 <xs:documentation>Sequence information for this patch database. Sequence information is generated automatically in most cases, and rarely needs to be set explicitly.</xs:documentation>
2680 <xs:appinfo>
2681 <xse:msiRef table="MsiPatchSequence" href="http://msdn.microsoft.com/library/aa370350.aspx" />
2682 </xs:appinfo>
2683 </xs:annotation>
2684 <xs:complexType>
2685 <xs:attribute name="PatchFamily" type="xs:string" use="required">
2686 <xs:annotation>
2687 <xs:documentation>Identifier which indicates a sequence family to which this patch belongs.</xs:documentation>
2688 </xs:annotation>
2689 </xs:attribute>
2690 <xs:attribute name="ProductCode" type="Guid">
2691 <xs:annotation>
2692 <xs:documentation>
2693 Specifies the ProductCode of the product that this family applies to.
2694 This attribute cannot the specified if the TargetImage attribute is specified.
2695 </xs:documentation>
2696 </xs:annotation>
2697 </xs:attribute>
2698 <xs:attribute name="Sequence" type="xs:string">
2699 <xs:annotation>
2700 <xs:documentation>Used to populate the sequence column of the MsiPatchSequence table in the final MSP file. Specified in x.x.x.x format. See documentation for Sequence column of MsiPatchSequence table in MSI SDK.</xs:documentation>
2701 </xs:annotation>
2702 </xs:attribute>
2703 <xs:attribute name="Supersede" type="YesNoTypeUnion">
2704 <xs:annotation>
2705 <xs:documentation>
2706 Set this value to 'yes' to indicate that this patch will supersede all previous patches in this patch family.
2707 The default value is 'no'.
2708 </xs:documentation>
2709 </xs:annotation>
2710 </xs:attribute>
2711 <xs:attribute name="Target" type="xs:string">
2712 <xs:annotation>
2713 <xs:appinfo>
2714 <xse:deprecated ref="TargetImage" />
2715 </xs:appinfo>
2716 </xs:annotation>
2717 </xs:attribute>
2718 <xs:attribute name="TargetImage" type="xs:string">
2719 <xs:annotation>
2720 <xs:documentation>
2721 Specifies the TargetImage that this family applies to.
2722 This attribute cannot the specified if the ProductCode attribute is specified.
2723 </xs:documentation>
2724 </xs:annotation>
2725 </xs:attribute>
2726 </xs:complexType>
2727 </xs:element>
2728 <xs:element name="Family">
2729 <xs:annotation>
2730 <xs:documentation>Group of one or more upgraded images of a product.</xs:documentation>
2731 </xs:annotation>
2732 <xs:complexType>
2733 <xs:sequence>
2734 <xs:element ref="UpgradeImage" maxOccurs="unbounded" />
2735 <xs:choice minOccurs="0" maxOccurs="unbounded">
2736 <xs:element ref="ExternalFile" />
2737 <xs:element ref="ProtectFile" />
2738 </xs:choice>
2739 </xs:sequence>
2740 <xs:attribute name="DiskId" type="DiskIdType">
2741 <xs:annotation>
2742 <xs:documentation>Entered into the DiskId field of the new Media table record.</xs:documentation>
2743 </xs:annotation>
2744 </xs:attribute>
2745 <xs:attribute name="DiskPrompt" type="xs:string">
2746 <xs:annotation>
2747 <xs:documentation>Value to display in the "[1]" of the DiskPrompt Property. Using this attribute will require you to define a DiskPrompt Property.</xs:documentation>
2748 </xs:annotation>
2749 </xs:attribute>
2750 <xs:attribute name="MediaSrcProp" type="xs:string">
2751 <xs:annotation>
2752 <xs:documentation>Entered into the Source field of the new Media table entry of the upgraded image.</xs:documentation>
2753 </xs:annotation>
2754 </xs:attribute>
2755 <xs:attribute name="Name" type="xs:string" use="required">
2756 <xs:annotation>
2757 <xs:documentation>Identifier for the family.</xs:documentation>
2758 </xs:annotation>
2759 </xs:attribute>
2760 <xs:attribute name="SequenceStart" type="xs:int">
2761 <xs:annotation>
2762 <xs:documentation>Sequence number for the starting file.</xs:documentation>
2763 </xs:annotation>
2764 </xs:attribute>
2765 <xs:attribute name="VolumeLabel" type="xs:string">
2766 <xs:annotation>
2767 <xs:documentation>Entered into the VolumeLabel field of the new Media table record.</xs:documentation>
2768 </xs:annotation>
2769 </xs:attribute>
2770 </xs:complexType>
2771 </xs:element>
2772 <xs:element name="UpgradeImage">
2773 <xs:annotation>
2774 <xs:documentation>Contains information about the upgraded images of the product.</xs:documentation>
2775 </xs:annotation>
2776 <xs:complexType>
2777 <xs:sequence>
2778 <xs:element ref="TargetImage" maxOccurs="unbounded" />
2779 <xs:choice minOccurs="0" maxOccurs="unbounded">
2780 <xs:element ref="SymbolPath" />
2781 <xs:element ref="UpgradeFile" />
2782 </xs:choice>
2783 </xs:sequence>
2784 <xs:attribute name="Id" type="xs:string" use="required">
2785 <xs:annotation>
2786 <xs:documentation>Identifier to connect target images with upgraded image.</xs:documentation>
2787 </xs:annotation>
2788 </xs:attribute>
2789 <xs:attribute name="SourceFile" type="xs:string">
2790 <xs:annotation>
2791 <xs:documentation>Full path to location of msi file for upgraded image.</xs:documentation>
2792 </xs:annotation>
2793 </xs:attribute>
2794 <xs:attribute name="src" type="xs:string">
2795 <xs:annotation>
2796 <xs:appinfo>
2797 <xse:deprecated ref="SourceFile" />
2798 </xs:appinfo>
2799 </xs:annotation>
2800 </xs:attribute>
2801 <xs:attribute name="SourcePatch" type="xs:string">
2802 <xs:annotation>
2803 <xs:documentation>Modified copy of the upgraded installation database that contains additional authoring specific to patching.</xs:documentation>
2804 </xs:annotation>
2805 </xs:attribute>
2806 <xs:attribute name="srcPatch" type="xs:string">
2807 <xs:annotation>
2808 <xs:appinfo>
2809 <xse:deprecated ref="SourcePatch" />
2810 </xs:appinfo>
2811 </xs:annotation>
2812 </xs:attribute>
2813 </xs:complexType>
2814 </xs:element>
2815 <xs:element name="TargetImage">
2816 <xs:annotation>
2817 <xs:documentation>Contains information about the target images of the product.</xs:documentation>
2818 </xs:annotation>
2819 <xs:complexType>
2820 <xs:choice minOccurs="0" maxOccurs="unbounded">
2821 <xs:element ref="SymbolPath" />
2822 <xs:element ref="TargetFile" />
2823 </xs:choice>
2824 <xs:attribute name="Id" type="xs:string" use="required">
2825 <xs:annotation>
2826 <xs:documentation>Identifier for the target image.</xs:documentation>
2827 </xs:annotation>
2828 </xs:attribute>
2829 <xs:attribute name="SourceFile" type="xs:string">
2830 <xs:annotation>
2831 <xs:documentation>Full path to the location of the msi file for the target image.</xs:documentation>
2832 </xs:annotation>
2833 </xs:attribute>
2834 <xs:attribute name="src" type="xs:string">
2835 <xs:annotation>
2836 <xs:appinfo>
2837 <xse:deprecated ref="SourceFile" />
2838 </xs:appinfo>
2839 </xs:annotation>
2840 </xs:attribute>
2841 <xs:attribute name="Order" type="xs:int" use="required">
2842 <xs:annotation>
2843 <xs:documentation>Relative order of the target image.</xs:documentation>
2844 </xs:annotation>
2845 </xs:attribute>
2846 <xs:attribute name="Validation" type="xs:string">
2847 <xs:annotation>
2848 <xs:documentation>Product checking to avoid applying irrelevant transforms.</xs:documentation>
2849 </xs:annotation>
2850 </xs:attribute>
2851 <xs:attribute name="IgnoreMissingFiles" type="YesNoTypeUnion">
2852 <xs:annotation>
2853 <xs:documentation>Files missing from the target image are ignored by the installer.</xs:documentation>
2854 </xs:annotation>
2855 </xs:attribute>
2856 </xs:complexType>
2857 </xs:element>
2858 <xs:element name="TargetFile">
2859 <xs:annotation>
2860 <xs:documentation>Information about specific files in a target image.</xs:documentation>
2861 </xs:annotation>
2862 <xs:complexType>
2863 <xs:sequence>
2864 <xs:element ref="SymbolPath" minOccurs="0" />
2865 <xs:choice minOccurs="0" maxOccurs="unbounded">
2866 <xs:element ref="IgnoreRange" />
2867 <xs:element ref="ProtectRange" />
2868 </xs:choice>
2869 </xs:sequence>
2870 <xs:attribute name="Id" type="xs:string" use="required">
2871 <xs:annotation>
2872 <xs:documentation>Foreign key into the File table.</xs:documentation>
2873 </xs:annotation>
2874 </xs:attribute>
2875 </xs:complexType>
2876 </xs:element>
2877 <xs:element name="IgnoreRange">
2878 <xs:annotation>
2879 <xs:documentation>Specifies part of a file that is to be ignored during patching.</xs:documentation>
2880 </xs:annotation>
2881 <xs:complexType>
2882 <xs:attribute name="Offset" type="xs:int" use="required">
2883 <xs:annotation>
2884 <xs:documentation>Offset of the start of the range.</xs:documentation>
2885 </xs:annotation>
2886 </xs:attribute>
2887 <xs:attribute name="Length" type="xs:int" use="required">
2888 <xs:annotation>
2889 <xs:documentation>Length of the range.</xs:documentation>
2890 </xs:annotation>
2891 </xs:attribute>
2892 </xs:complexType>
2893 </xs:element>
2894 <xs:element name="ProtectRange">
2895 <xs:annotation>
2896 <xs:documentation>Specifies part of a file that cannot be overwritten during patching.</xs:documentation>
2897 </xs:annotation>
2898 <xs:complexType>
2899 <xs:attribute name="Offset" type="xs:int" use="required">
2900 <xs:annotation>
2901 <xs:documentation>Offset of the start of the range.</xs:documentation>
2902 </xs:annotation>
2903 </xs:attribute>
2904 <xs:attribute name="Length" type="xs:int" use="required">
2905 <xs:annotation>
2906 <xs:documentation>Length of the range.</xs:documentation>
2907 </xs:annotation>
2908 </xs:attribute>
2909 </xs:complexType>
2910 </xs:element>
2911 <xs:element name="ProtectFile">
2912 <xs:annotation>
2913 <xs:documentation>Specifies a file to be protected.</xs:documentation>
2914 </xs:annotation>
2915 <xs:complexType>
2916 <xs:choice maxOccurs="unbounded">
2917 <xs:element ref="ProtectRange" />
2918 </xs:choice>
2919 <xs:attribute name="File" type="xs:string" use="required">
2920 <xs:annotation>
2921 <xs:documentation>Foreign key into the File table.</xs:documentation>
2922 </xs:annotation>
2923 </xs:attribute>
2924 </xs:complexType>
2925 </xs:element>
2926 <xs:element name="ExternalFile">
2927 <xs:annotation>
2928 <xs:documentation>Contains information about specific files that are not part of a regular target image.</xs:documentation>
2929 </xs:annotation>
2930 <xs:complexType>
2931 <xs:sequence>
2932 <xs:element ref="ProtectRange" maxOccurs="unbounded" />
2933 <xs:element ref="SymbolPath" maxOccurs="unbounded" />
2934 <xs:choice minOccurs="0" maxOccurs="unbounded">
2935 <xs:element ref="IgnoreRange" />
2936 </xs:choice>
2937 </xs:sequence>
2938 <xs:attribute name="File" type="xs:string" use="required">
2939 <xs:annotation>
2940 <xs:documentation>Foreign key into the File table.</xs:documentation>
2941 </xs:annotation>
2942 </xs:attribute>
2943 <xs:attribute name="Source" type="xs:string">
2944 <xs:annotation>
2945 <xs:documentation>Full path of the external file.</xs:documentation>
2946 </xs:annotation>
2947 </xs:attribute>
2948 <xs:attribute name="src" type="xs:string">
2949 <xs:annotation>
2950 <xs:appinfo>
2951 <xse:deprecated ref="Source" />
2952 </xs:appinfo>
2953 </xs:annotation>
2954 </xs:attribute>
2955 <xs:attribute name="Order" type="xs:int" use="required">
2956 <xs:annotation>
2957 <xs:documentation>Specifies the order of the external files to use when creating the patch.</xs:documentation>
2958 </xs:annotation>
2959 </xs:attribute>
2960 </xs:complexType>
2961 </xs:element>
2962 <xs:element name="UpgradeFile">
2963 <xs:annotation>
2964 <xs:documentation>Specifies files to either ignore or to specify optional data about a file.</xs:documentation>
2965 </xs:annotation>
2966 <xs:complexType>
2967 <xs:choice minOccurs="0" maxOccurs="unbounded">
2968 <xs:element ref="SymbolPath" />
2969 </xs:choice>
2970 <xs:attribute name="File" type="xs:string" use="required">
2971 <xs:annotation>
2972 <xs:documentation>Foreign key into the File table.</xs:documentation>
2973 </xs:annotation>
2974 </xs:attribute>
2975 <xs:attribute name="Ignore" type="YesNoTypeUnion" use="required">
2976 <xs:annotation>
2977 <xs:documentation>If yes, the file is ignored during patching, and the next two attributes are ignored.</xs:documentation>
2978 </xs:annotation>
2979 </xs:attribute>
2980 <xs:attribute name="AllowIgnoreOnError" type="YesNoTypeUnion">
2981 <xs:annotation>
2982 <xs:documentation>Specifies whether patching this file is vital.</xs:documentation>
2983 </xs:annotation>
2984 </xs:attribute>
2985 <xs:attribute name="WholeFile" type="YesNoTypeUnion">
2986 <xs:annotation>
2987 <xs:documentation>Whether the whole file should be installed, rather than creating a binary patch.</xs:documentation>
2988 </xs:annotation>
2989 </xs:attribute>
2990 </xs:complexType>
2991 </xs:element>
2992 <xs:element name="SymbolPath">
2993 <xs:annotation>
2994 <xs:documentation>A path to symbols.</xs:documentation>
2995 </xs:annotation>
2996 <xs:complexType>
2997 <xs:attribute name="Path" type="xs:string" use="required">
2998 <xs:annotation>
2999 <xs:documentation>The path.</xs:documentation>
3000 </xs:annotation>
3001 </xs:attribute>
3002 </xs:complexType>
3003 </xs:element>
3004 <xs:element name="Package">
3005 <xs:annotation>
3006 <xs:documentation>
3007 Properties about the package to be placed in the Summary Information Stream. These are
3008 visible from COM through the IStream interface, and these properties can be seen on the package in Explorer.
3009 </xs:documentation>
3010 <xs:appinfo>
3011 <xse:remarks>
3012 <html:p>You can specify any valid Windows code by by integer like 1252, or by web name like Windows-1252. See <html:a href="~/overview/codepage.html">Code Pages</html:a> for more information.</html:p>
3013 </xse:remarks>
3014 </xs:appinfo>
3015 </xs:annotation>
3016 <xs:complexType>
3017 <xs:attribute name="Id" type="AutogenGuid">
3018 <xs:annotation>
3019 <xs:documentation>
3020 The package code GUID for a product or merge module.
3021 When compiling a product, this attribute should not be set in order to allow the package
3022 code to be generated for each build.
3023 When compiling a merge module, this attribute must be set to the modularization guid.
3024 </xs:documentation>
3025 </xs:annotation>
3026 </xs:attribute>
3027 <xs:attribute name="AdminImage" type="YesNoTypeUnion">
3028 <xs:annotation>
3029 <xs:documentation>Set to 'yes' if the source is an admin image.</xs:documentation>
3030 </xs:annotation>
3031 </xs:attribute>
3032 <xs:attribute name="Comments" type="xs:string">
3033 <xs:annotation>
3034 <xs:documentation>Optional comments for browsing.</xs:documentation>
3035 </xs:annotation>
3036 </xs:attribute>
3037 <xs:attribute name="Compressed" type="YesNoTypeUnion">
3038 <xs:annotation>
3039 <xs:documentation>
3040 Set to 'yes' to have compressed files in the source.
3041 This attribute cannot be set for merge modules.
3042 </xs:documentation>
3043 </xs:annotation>
3044 </xs:attribute>
3045 <xs:attribute name="Description" type="xs:string">
3046 <xs:annotation>
3047 <xs:documentation>The product full name or description.</xs:documentation>
3048 </xs:annotation>
3049 </xs:attribute>
3050 <xs:attribute name="InstallPrivileges">
3051 <xs:annotation>
3052 <xs:documentation>Use this attribute to specify the priviliges required to install the package on Windows Vista and above.</xs:documentation>
3053 </xs:annotation>
3054 <xs:simpleType>
3055 <xs:restriction base="xs:NMTOKEN">
3056 <xs:enumeration value="limited">
3057 <xs:annotation>
3058 <xs:documentation>
3059 Set this value to declare that the package does not require elevated privileges to install.
3060 </xs:documentation>
3061 </xs:annotation>
3062 </xs:enumeration>
3063 <xs:enumeration value="elevated">
3064 <xs:annotation>
3065 <xs:documentation>
3066 Set this value to declare that the package requires elevated privileges to install.
3067 This is the default value.
3068 </xs:documentation>
3069 </xs:annotation>
3070 </xs:enumeration>
3071 </xs:restriction>
3072 </xs:simpleType>
3073 </xs:attribute>
3074 <xs:attribute name="InstallScope">
3075 <xs:annotation>
3076 <xs:documentation>Use this attribute to specify the installation scope of this package: per-machine or per-user.</xs:documentation>
3077 </xs:annotation>
3078 <xs:simpleType>
3079 <xs:restriction base="xs:NMTOKEN">
3080 <xs:enumeration value="perMachine">
3081 <xs:annotation>
3082 <xs:documentation>
3083 Set this value to declare that the package is a per-machine installation and requires elevated privileges to install.
3084 Sets the ALLUSERS property to 1.
3085 </xs:documentation>
3086 </xs:annotation>
3087 </xs:enumeration>
3088 <xs:enumeration value="perUser">
3089 <xs:annotation>
3090 <xs:documentation>
3091 Set this value to declare that the package is a per-user installation and does not require elevated privileges to install.
3092 Sets the package's InstallPrivileges attribute to "limited."
3093 </xs:documentation>
3094 </xs:annotation>
3095 </xs:enumeration>
3096 </xs:restriction>
3097 </xs:simpleType>
3098 </xs:attribute>
3099 <xs:attribute name="InstallerVersion" type="xs:integer">
3100 <xs:annotation>
3101 <xs:documentation>
3102 The minimum version of the Windows Installer required to install this package. Take the major version of the required Windows Installer
3103 and multiply by a 100 then add the minor version of the Windows Installer. For example, "200" would represent Windows Installer 2.0 and
3104 "405" would represent Windows Installer 4.5. For 64-bit Windows Installer packages, this property is set to 200 by default as
3105 Windows Installer 2.0 was the first version to support 64-bit packages.
3106 </xs:documentation>
3107 </xs:annotation>
3108 </xs:attribute>
3109 <xs:attribute name="Keywords" type="xs:string">
3110 <xs:annotation>
3111 <xs:documentation>Optional keywords for browsing.</xs:documentation>
3112 </xs:annotation>
3113 </xs:attribute>
3114 <xs:attribute name="Languages" type="xs:string">
3115 <xs:annotation>
3116 <xs:documentation>The list of language IDs (LCIDs) supported in the package.</xs:documentation>
3117 </xs:annotation>
3118 </xs:attribute>
3119 <xs:attribute name="Manufacturer" type="xs:string">
3120 <xs:annotation>
3121 <xs:documentation>The vendor releasing the package.</xs:documentation>
3122 </xs:annotation>
3123 </xs:attribute>
3124 <xs:attribute name="Platforms" type="xs:string">
3125 <xs:annotation>
3126 <xs:documentation>
3127 The list of platforms supported by the package. This attribute has been deprecated.
3128 Specify the -arch switch at the candle.exe command line or the InstallerPlatform
3129 property in a .wixproj MSBuild project.
3130 </xs:documentation>
3131 </xs:annotation>
3132 </xs:attribute>
3133 <xs:attribute name="Platform">
3134 <xs:annotation>
3135 <xs:documentation>
3136 The platform supported by the package. Use of this attribute is discouraged; instead,
3137 specify the -arch switch at the candle.exe command line or the InstallerPlatform
3138 property in a .wixproj MSBuild project.
3139 </xs:documentation>
3140 </xs:annotation>
3141 <xs:simpleType>
3142 <xs:restriction base="xs:NMTOKEN">
3143 <xs:enumeration value="x86">
3144 <xs:annotation>
3145 <xs:documentation>
3146 Set this value to declare that the package is an x86 package.
3147 </xs:documentation>
3148 </xs:annotation>
3149 </xs:enumeration>
3150 <xs:enumeration value="ia64">
3151 <xs:annotation>
3152 <xs:documentation>
3153 Set this value to declare that the package is an ia64 package.
3154 This value requires that the InstallerVersion property be set to 200 or greater.
3155 </xs:documentation>
3156 </xs:annotation>
3157 </xs:enumeration>
3158 <xs:enumeration value="x64">
3159 <xs:annotation>
3160 <xs:documentation>
3161 Set this value to declare that the package is an x64 package.
3162 This value requires that the InstallerVersion property be set to 200 or greater.
3163 </xs:documentation>
3164 </xs:annotation>
3165 </xs:enumeration>
3166 <xs:enumeration value="arm">
3167 <xs:annotation>
3168 <xs:documentation>
3169 Set this value to declare that the package is an arm package.
3170 This value requires that the InstallerVersion property be set to 500 or greater.
3171 </xs:documentation>
3172 </xs:annotation>
3173 </xs:enumeration>
3174 <xs:enumeration value="intel">
3175 <xs:annotation>
3176 <xs:documentation>
3177 This value has been deprecated. Use "x86" instead.
3178 </xs:documentation>
3179 </xs:annotation>
3180 </xs:enumeration>
3181 <xs:enumeration value="intel64">
3182 <xs:annotation>
3183 <xs:documentation>
3184 This value has been deprecated. Use "ia64" instead.
3185 </xs:documentation>
3186 </xs:annotation>
3187 </xs:enumeration>
3188 </xs:restriction>
3189 </xs:simpleType>
3190 </xs:attribute>
3191 <xs:attribute name="ReadOnly" type="YesNoDefaultTypeUnion">
3192 <xs:annotation>
3193 <xs:documentation>
3194 The value of this attribute conveys whether the package should be opened as read-only.
3195 A database editing tool should not modify a read-only enforced database and should
3196 issue a warning at attempts to modify a read-only recommended database.
3197 </xs:documentation>
3198 </xs:annotation>
3199 </xs:attribute>
3200 <xs:attribute name="ShortNames" type="YesNoTypeUnion">
3201 <xs:annotation>
3202 <xs:documentation>Set to 'yes' to have short filenames in the source.</xs:documentation>
3203 </xs:annotation>
3204 </xs:attribute>
3205 <xs:attribute name="SummaryCodepage" type="xs:string">
3206 <xs:annotation>
3207 <xs:documentation>The code page integer value or web name for summary info strings only. See remarks for more information.</xs:documentation>
3208 </xs:annotation>
3209 </xs:attribute>
3210 </xs:complexType>
3211 </xs:element>
3212 <xs:element name="AssemblyName">
3213 <xs:annotation>
3214 <xs:documentation>
3215 The MsiAssemblyName table specifies the schema for the elements of a strong assembly cache name for a .NET Framework or Win32 assembly.
3216 Consider using the Assembly attribute on File element to have the toolset populate these entries automatically.
3217 </xs:documentation>
3218 <xs:appinfo>
3219 <xse:msiRef table="MsiAssemblyName" href="http://msdn.microsoft.com/library/aa370062.aspx" />
3220 </xs:appinfo>
3221 </xs:annotation>
3222 <xs:complexType>
3223 <xs:attribute name="Id" use="required" type="xs:string">
3224 <xs:annotation>
3225 <xs:documentation>Name of the attribute associated with the value specified in the Value column.</xs:documentation>
3226 </xs:annotation>
3227 </xs:attribute>
3228 <xs:attribute name="Value" type="xs:string">
3229 <xs:annotation>
3230 <xs:documentation>Value associated with the name specified in the Name column.</xs:documentation>
3231 </xs:annotation>
3232 </xs:attribute>
3233 </xs:complexType>
3234 </xs:element>
3235 <xs:element name="PatchCertificates">
3236 <xs:annotation>
3237 <xs:documentation>
3238 Identifies the possible signer certificates used to digitally sign patches.
3239 </xs:documentation>
3240 <xs:appinfo>
3241 <xse:msiRef table="MsiPatchCertificate" href="http://msdn.microsoft.com/library/aa370342.aspx" />
3242 </xs:appinfo>
3243 </xs:annotation>
3244 <xs:complexType>
3245 <xs:choice maxOccurs="unbounded">
3246 <xs:element ref="DigitalCertificate" />
3247 </xs:choice>
3248 </xs:complexType>
3249 </xs:element>
3250 <xs:element name="PackageCertificates">
3251 <xs:annotation>
3252 <xs:documentation>
3253 Digital signatures that identify installation packages in a multi-product transaction.
3254 </xs:documentation>
3255 <xs:appinfo>
3256 <xse:msiRef table="MsiPackageCertificate" href="http://msdn.microsoft.com/library/cc542575.aspx" />
3257 </xs:appinfo>
3258 </xs:annotation>
3259 <xs:complexType>
3260 <xs:choice maxOccurs="unbounded">
3261 <xs:element ref="DigitalCertificate" />
3262 </xs:choice>
3263 </xs:complexType>
3264 </xs:element>
3265 <xs:element name="DigitalCertificate">
3266 <xs:annotation>
3267 <xs:documentation>
3268 Adds a digital certificate.
3269 </xs:documentation>
3270 <xs:appinfo>
3271 <xse:msiRef table="MsiDigitalCertificate" href="http://msdn.microsoft.com/library/aa370086.aspx" />
3272 </xs:appinfo>
3273 </xs:annotation>
3274 <xs:complexType>
3275 <xs:attribute name="Id" type="xs:string" use="required">
3276 <xs:annotation>
3277 <xs:documentation>Identifier for a certificate file.</xs:documentation>
3278 </xs:annotation>
3279 </xs:attribute>
3280 <xs:attribute name="SourceFile" type="xs:string" use="required">
3281 <xs:annotation>
3282 <xs:documentation>The path to the certificate file.</xs:documentation>
3283 </xs:annotation>
3284 </xs:attribute>
3285 </xs:complexType>
3286 </xs:element>
3287 <xs:element name="DigitalCertificateRef">
3288 <xs:annotation>
3289 <xs:documentation>
3290 Reference to a DigitalCertificate element. This will force the entire referenced Fragment's contents
3291 to be included in the installer database. This is only used for references when patching.
3292 </xs:documentation>
3293 </xs:annotation>
3294 <xs:complexType>
3295 <xs:attribute name="Id" type="xs:string" use="required" />
3296 <xs:anyAttribute namespace="##other" processContents="lax">
3297 <xs:annotation>
3298 <xs:documentation>
3299 Extensibility point in the WiX XML Schema. Schema extensions can register additional
3300 attributes at this point in the schema.
3301 </xs:documentation>
3302 </xs:annotation>
3303 </xs:anyAttribute>
3304 </xs:complexType>
3305 </xs:element>
3306 <xs:element name="DigitalSignature">
3307 <xs:annotation>
3308 <xs:documentation>
3309 Adds a digital signature.
3310 </xs:documentation>
3311 <xs:appinfo>
3312 <xse:msiRef table="MsiDigitalSignature" href="http://msdn.microsoft.com/library/aa370087.aspx" />
3313 </xs:appinfo>
3314 </xs:annotation>
3315 <xs:complexType>
3316 <xs:choice>
3317 <xs:element ref="DigitalCertificate" />
3318 </xs:choice>
3319 <xs:attribute name="SourceFile" type="xs:string">
3320 <xs:annotation>
3321 <xs:documentation>The path to signature's optional hash file.</xs:documentation>
3322 </xs:annotation>
3323 </xs:attribute>
3324 </xs:complexType>
3325 </xs:element>
3326 <xs:element name="SFPCatalog">
3327 <xs:annotation>
3328 <xs:documentation>
3329 Adds a system file protection update catalog file
3330 </xs:documentation>
3331 <xs:appinfo>
3332 <xse:msiRef table="SFPCatalog" href="http://msdn.microsoft.com/library/aa371833.aspx" />
3333 </xs:appinfo>
3334 </xs:annotation>
3335 <xs:complexType>
3336 <xs:choice minOccurs="0" maxOccurs="unbounded">
3337 <xs:element ref="SFPCatalog" minOccurs="0" maxOccurs="unbounded" />
3338 <xs:element ref="SFPFile" minOccurs="0" maxOccurs="unbounded">
3339 <xs:annotation>
3340 <xs:documentation>Primary Key to File Table.</xs:documentation>
3341 </xs:annotation>
3342 </xs:element>
3343 </xs:choice>
3344 <xs:attribute name="Name" type="xs:string">
3345 <xs:annotation>
3346 <xs:documentation>Filename for catalog file when installed.</xs:documentation>
3347 </xs:annotation>
3348 </xs:attribute>
3349 <xs:attribute name="Dependency" type="xs:string">
3350 <xs:annotation>
3351 <xs:documentation>Used to define dependency outside of the package.</xs:documentation>
3352 </xs:annotation>
3353 </xs:attribute>
3354 <xs:attribute name="SourceFile" type="xs:string">
3355 <xs:annotation>
3356 <xs:documentation>Path to catalog file in binary.</xs:documentation>
3357 </xs:annotation>
3358 </xs:attribute>
3359 </xs:complexType>
3360 </xs:element>
3361 <xs:element name="SFPFile">
3362 <xs:annotation>
3363 <xs:documentation>
3364 Provides a many-to-many mapping from the SFPCatalog table to the File table
3365 </xs:documentation>
3366 <xs:appinfo>
3367 <xse:msiRef table="FileSFPCatalog" href="http://msdn.microsoft.com/library/aa368591.aspx" />
3368 </xs:appinfo>
3369 </xs:annotation>
3370 <xs:complexType>
3371 <xs:attribute name="Id" use="required" type="xs:string">
3372 <xs:annotation>
3373 <xs:documentation>Primary Key to File Table.</xs:documentation>
3374 </xs:annotation>
3375 </xs:attribute>
3376 </xs:complexType>
3377 </xs:element>
3378 <xs:element name="IniFile">
3379 <xs:annotation>
3380 <xs:documentation>
3381 Adds or removes .ini file entries.
3382 </xs:documentation>
3383 <xs:appinfo>
3384 <xse:msiRef table="IniFile" href="http://msdn.microsoft.com/library/aa369282.aspx" />
3385 <xse:msiRef table="RemoveIniFile" href="http://msdn.microsoft.com/library/aa371204.aspx" />
3386 </xs:appinfo>
3387 </xs:annotation>
3388 <xs:complexType>
3389 <xs:attribute name="Id" use="required" type="xs:string">
3390 <xs:annotation>
3391 <xs:documentation>Identifier for ini file.</xs:documentation>
3392 </xs:annotation>
3393 </xs:attribute>
3394 <xs:attribute name="Action" use="required">
3395 <xs:annotation>
3396 <xs:documentation>The type of modification to be made.</xs:documentation>
3397 </xs:annotation>
3398 <xs:simpleType>
3399 <xs:restriction base="xs:NMTOKEN">
3400 <xs:enumeration value="addLine">
3401 <xs:annotation>
3402 <xs:documentation>Creates or updates an .ini entry.</xs:documentation>
3403 </xs:annotation>
3404 </xs:enumeration>
3405 <xs:enumeration value="addTag">
3406 <xs:annotation>
3407 <xs:documentation>Creates a new entry or appends a new comma-separated value to an existing entry.</xs:documentation>
3408 </xs:annotation>
3409 </xs:enumeration>
3410 <xs:enumeration value="createLine">
3411 <xs:annotation>
3412 <xs:documentation>Creates an .ini entry only if the entry does no already exist.</xs:documentation>
3413 </xs:annotation>
3414 </xs:enumeration>
3415 <xs:enumeration value="removeLine">
3416 <xs:annotation>
3417 <xs:documentation>Removes an .ini entry.</xs:documentation>
3418 </xs:annotation>
3419 </xs:enumeration>
3420 <xs:enumeration value="removeTag">
3421 <xs:annotation>
3422 <xs:documentation>Removes a tag from an .ini entry.</xs:documentation>
3423 </xs:annotation>
3424 </xs:enumeration>
3425 </xs:restriction>
3426 </xs:simpleType>
3427 </xs:attribute>
3428 <xs:attribute name="Directory" type="xs:string">
3429 <xs:annotation>
3430 <xs:documentation>Name of a property, the value of which is the full path of the folder containing the .ini file. Can be name of a directory in the Directory table, a property set by the AppSearch table, or any other property representing a full path.</xs:documentation>
3431 </xs:annotation>
3432 </xs:attribute>
3433 <xs:attribute name="Key" use="required" type="xs:string">
3434 <xs:annotation>
3435 <xs:documentation>The localizable .ini file key within the section.</xs:documentation>
3436 </xs:annotation>
3437 </xs:attribute>
3438 <xs:attribute name="Name" type="LongFileNameType" use="required">
3439 <xs:annotation>
3440 <xs:documentation>
3441 In prior versions of the WiX toolset, this attribute specified the short name.
3442 This attribute's value may now be either a short or long name.
3443 If a short name is specified, the ShortName attribute may not be specified.
3444 Also, if this value is a long name, the ShortName attribute may be omitted to
3445 allow WiX to attempt to generate a unique short name.
3446 However, if this name collides with another file or you wish to manually specify
3447 the short name, then the ShortName attribute may be specified.
3448 </xs:documentation>
3449 </xs:annotation>
3450 </xs:attribute>
3451 <xs:attribute name="Section" use="required" type="xs:string">
3452 <xs:annotation>
3453 <xs:documentation>The localizable .ini file section.</xs:documentation>
3454 </xs:annotation>
3455 </xs:attribute>
3456 <xs:attribute name="ShortName" type="ShortFileNameType">
3457 <xs:annotation>
3458 <xs:documentation>
3459 The short name of the in 8.3 format.
3460 This attribute should only be set if there is a conflict between generated short names
3461 or the user wants to manually specify the short name.
3462 </xs:documentation>
3463 </xs:annotation>
3464 </xs:attribute>
3465 <xs:attribute name="Value" type="xs:string">
3466 <xs:annotation>
3467 <xs:documentation>
3468 The localizable value to be written or deleted. This attribute must be set if
3469 the Action attribute's value is "addLine", "addTag", or "createLine".
3470 </xs:documentation>
3471 </xs:annotation>
3472 </xs:attribute>
3473 </xs:complexType>
3474 </xs:element>
3475 <xs:element name="ODBCDataSource">
3476 <xs:annotation>
3477 <xs:documentation>
3478 ODBCDataSource for a Component
3479 </xs:documentation>
3480 <xs:appinfo>
3481 <xse:msiRef table="ODBCDataSource" href="http://msdn.microsoft.com/library/aa370546.aspx" />
3482 </xs:appinfo>
3483 </xs:annotation>
3484 <xs:complexType>
3485 <xs:sequence>
3486 <xs:element ref="Property" minOccurs="0" maxOccurs="unbounded">
3487 <xs:annotation>
3488 <xs:documentation>Translates into ODBCSourceAttributes</xs:documentation>
3489 </xs:annotation>
3490 </xs:element>
3491 </xs:sequence>
3492 <xs:attribute name="Id" use="required" type="xs:string">
3493 <xs:annotation>
3494 <xs:documentation>Identifier of the data source.</xs:documentation>
3495 </xs:annotation>
3496 </xs:attribute>
3497 <xs:attribute name="Name" use="required" type="xs:string">
3498 <xs:annotation>
3499 <xs:documentation>Name for the data source.</xs:documentation>
3500 </xs:annotation>
3501 </xs:attribute>
3502 <xs:attribute name="DriverName" type="xs:string">
3503 <xs:annotation>
3504 <xs:documentation>Required if not found as child of ODBCDriver element</xs:documentation>
3505 </xs:annotation>
3506 </xs:attribute>
3507 <xs:attribute name="Registration" use="required">
3508 <xs:annotation>
3509 <xs:documentation>Scope for which the data source should be registered.</xs:documentation>
3510 </xs:annotation>
3511 <xs:simpleType>
3512 <xs:restriction base="xs:NMTOKEN">
3513 <xs:enumeration value="machine">
3514 <xs:annotation>
3515 <xs:documentation>
3516 Data source is registered per machine.
3517 </xs:documentation>
3518 </xs:annotation>
3519 </xs:enumeration>
3520 <xs:enumeration value="user">
3521 <xs:annotation>
3522 <xs:documentation>
3523 Data source is registered per user.
3524 </xs:documentation>
3525 </xs:annotation>
3526 </xs:enumeration>
3527 </xs:restriction>
3528 </xs:simpleType>
3529 </xs:attribute>
3530 <xs:attribute name="KeyPath" type="YesNoTypeUnion">
3531 <xs:annotation>
3532 <xs:documentation>Set 'yes' to force this file to be key path for parent Component</xs:documentation>
3533 </xs:annotation>
3534 </xs:attribute>
3535 </xs:complexType>
3536 </xs:element>
3537 <xs:element name="ODBCDriver">
3538 <xs:annotation>
3539 <xs:documentation>
3540 ODBCDriver for a Component
3541 </xs:documentation>
3542 <xs:appinfo>
3543 <xse:msiRef table="ODBCDriver" href="http://msdn.microsoft.com/library/aa370547.aspx" />
3544 </xs:appinfo>
3545 </xs:annotation>
3546 <xs:complexType>
3547 <xs:sequence>
3548 <xs:element ref="Property" minOccurs="0" maxOccurs="unbounded">
3549 <xs:annotation>
3550 <xs:documentation>Translates into ODBCSourceAttributes</xs:documentation>
3551 </xs:annotation>
3552 </xs:element>
3553 <xs:element ref="ODBCDataSource" minOccurs="0" maxOccurs="unbounded" />
3554 </xs:sequence>
3555 <xs:attribute name="Id" use="required" type="xs:string">
3556 <xs:annotation>
3557 <xs:documentation>Identifier for the driver.</xs:documentation>
3558 </xs:annotation>
3559 </xs:attribute>
3560 <xs:attribute name="Name" use="required" type="xs:string">
3561 <xs:annotation>
3562 <xs:documentation>Name for the driver.</xs:documentation>
3563 </xs:annotation>
3564 </xs:attribute>
3565 <xs:attribute name="File" type="xs:string">
3566 <xs:annotation>
3567 <xs:documentation>Required if not found as child of File element</xs:documentation>
3568 </xs:annotation>
3569 </xs:attribute>
3570 <xs:attribute name="SetupFile" type="xs:string">
3571 <xs:annotation>
3572 <xs:documentation>Required if not found as child of File element or different from File attribute above</xs:documentation>
3573 </xs:annotation>
3574 </xs:attribute>
3575 </xs:complexType>
3576 </xs:element>
3577 <xs:element name="ODBCTranslator">
3578 <xs:annotation>
3579 <xs:documentation>
3580 ODBCTranslator for a Component
3581 </xs:documentation>
3582 <xs:appinfo>
3583 <xse:msiRef table="ODBCTranslator" href="http://msdn.microsoft.com/library/aa370549.aspx" />
3584 </xs:appinfo>
3585 </xs:annotation>
3586 <xs:complexType>
3587 <xs:attribute name="Id" use="required" type="xs:string">
3588 <xs:annotation>
3589 <xs:documentation>Identifier for the translator.</xs:documentation>
3590 </xs:annotation>
3591 </xs:attribute>
3592 <xs:attribute name="Name" use="required" type="xs:string">
3593 <xs:annotation>
3594 <xs:documentation>Name for the translator.</xs:documentation>
3595 </xs:annotation>
3596 </xs:attribute>
3597 <xs:attribute name="File" type="xs:string">
3598 <xs:annotation>
3599 <xs:documentation>Required if not found as child of File element</xs:documentation>
3600 </xs:annotation>
3601 </xs:attribute>
3602 <xs:attribute name="SetupFile" type="xs:string">
3603 <xs:annotation>
3604 <xs:documentation>Required if not found as child of File element or different from File attribute above</xs:documentation>
3605 </xs:annotation>
3606 </xs:attribute>
3607 </xs:complexType>
3608 </xs:element>
3609 <xs:element name="FileSearch">
3610 <xs:annotation>
3611 <xs:appinfo>
3612 <xse:seeAlso ref="ComponentSearch" />
3613 <xse:seeAlso ref="DirectorySearch" />
3614 <xse:seeAlso ref="DirectorySearchRef" />
3615 <xse:seeAlso ref="FileSearchRef" />
3616 <xse:seeAlso ref="IniFileSearch" />
3617 <xse:seeAlso ref="RegistrySearch" />
3618 <xse:msiRef table="DrLocator" href="http://msdn.microsoft.com/library/aa368331.aspx" />
3619 <xse:msiRef table="Signature" href="http://msdn.microsoft.com/library/aa371853.aspx" />
3620 <xse:howtoRef href="files_and_registry/check_the_version_number.html">How To: Check the version number of a file during installation</xse:howtoRef>
3621 <xse:remarks>
3622 <html:a>When the parent DirectorySearch/@Depth attribute is greater than 0, the FileSearch/@Id attribute must be absent or the same as the parent DirectorySearch/@Id attribute value, unless the parent DirectorySearch/@AssignToProperty attribute value is 'yes'.</html:a>
3623 </xse:remarks>
3624 </xs:appinfo>
3625 <xs:documentation>Searches for file and assigns to fullpath value of parent Property</xs:documentation>
3626 </xs:annotation>
3627 <xs:complexType>
3628 <xs:attribute name="Id" type="xs:string">
3629 <xs:annotation>
3630 <xs:documentation>Unique identifier for the file search and external key into the Signature table. If this attribute value is not set then the parent element's @Id attribute is used.</xs:documentation>
3631 </xs:annotation>
3632 </xs:attribute>
3633 <xs:attribute name="Name" type="LongFileNameType">
3634 <xs:annotation>
3635 <xs:documentation>
3636 In prior versions of the WiX toolset, this attribute specified the short file name.
3637 This attribute's value may now be either a short or long file name.
3638 If a short file name is specified, the ShortName attribute may not be specified.
3639 If you wish to manually specify the short file name, then the ShortName
3640 attribute may be specified.
3641 </xs:documentation>
3642 </xs:annotation>
3643 </xs:attribute>
3644 <xs:attribute name="ShortName" type="ShortFileNameType">
3645 <xs:annotation>
3646 <xs:documentation>
3647 The short file name of the file in 8.3 format.
3648 There is a Windows Installer bug which prevents the FileSearch functionality from working
3649 if both a short and long file name are specified. Since the Name attribute allows either
3650 a short or long name to be specified, it is the only attribute related to file names which
3651 should be specified.
3652 </xs:documentation>
3653 </xs:annotation>
3654 </xs:attribute>
3655 <xs:attribute name="MinSize" type="xs:int">
3656 <xs:annotation>
3657 <xs:documentation>The minimum size of the file.</xs:documentation>
3658 </xs:annotation>
3659 </xs:attribute>
3660 <xs:attribute name="MaxSize" type="xs:int">
3661 <xs:annotation>
3662 <xs:documentation>The maximum size of the file.</xs:documentation>
3663 </xs:annotation>
3664 </xs:attribute>
3665 <xs:attribute name="MinVersion" type="xs:string">
3666 <xs:annotation>
3667 <xs:documentation>The minimum version of the file.</xs:documentation>
3668 </xs:annotation>
3669 </xs:attribute>
3670 <xs:attribute name="MaxVersion" type="xs:string">
3671 <xs:annotation>
3672 <xs:documentation>The maximum version of the file.</xs:documentation>
3673 </xs:annotation>
3674 </xs:attribute>
3675 <xs:attribute name="MinDate" type="xs:dateTime">
3676 <xs:annotation>
3677 <xs:documentation>The minimum modification date and time of the file. Formatted as YYYY-MM-DDTHH:mm:ss, where YYYY is the year, MM is month, DD is day, 'T' is literal, HH is hour, mm is minute and ss is second.</xs:documentation>
3678 </xs:annotation>
3679 </xs:attribute>
3680 <xs:attribute name="MaxDate" type="xs:dateTime">
3681 <xs:annotation>
3682 <xs:documentation>The maximum modification date and time of the file. Formatted as YYYY-MM-DDTHH:mm:ss, where YYYY is the year, MM is month, DD is day, 'T' is literal, HH is hour, mm is minute and ss is second.</xs:documentation>
3683 </xs:annotation>
3684 </xs:attribute>
3685 <xs:attribute name="Languages" type="xs:string">
3686 <xs:annotation>
3687 <xs:documentation>The languages supported by the file.</xs:documentation>
3688 </xs:annotation>
3689 </xs:attribute>
3690 </xs:complexType>
3691 </xs:element>
3692 <xs:element name="FileSearchRef">
3693 <xs:annotation>
3694 <xs:appinfo>
3695 <xse:seeAlso ref="FileSearch" />
3696 <xse:remarks>
3697 <html:p>A reference to another FileSearch element must reference the same Id and the same Parent Id. If any of these attribute values are different you must instead use a FileSearch element.</html:p>
3698 </xse:remarks>
3699 </xs:appinfo>
3700 <xs:documentation>References an existing FileSearch element.</xs:documentation>
3701 </xs:annotation>
3702 <xs:complexType>
3703 <xs:attribute name="Id" use="required" type="xs:string">
3704 <xs:annotation>
3705 <xs:documentation>Specify the Id to the FileSearch to reference.</xs:documentation>
3706 </xs:annotation>
3707 </xs:attribute>
3708 </xs:complexType>
3709 </xs:element>
3710 <xs:element name="DirectorySearch">
3711 <xs:annotation>
3712 <xs:appinfo>
3713 <xse:seeAlso ref="ComponentSearch" />
3714 <xse:seeAlso ref="IniFileSearch" />
3715 <xse:seeAlso ref="RegistrySearch" />
3716 <xse:msiRef table="DrLocator" href="http://msdn.microsoft.com/library/aa368331.aspx" />
3717 <xse:msiRef table="Signature" href="http://msdn.microsoft.com/library/aa371853.aspx" />
3718 <xse:howtoRef href="files_and_registry/check_the_version_number.html">How To: Check the version number of a file during installation</xse:howtoRef>
3719 <xse:howtoRef href="files_and_registry/directorysearchref.html">How To: Reference another DirectorySearch element</xse:howtoRef>
3720 <xse:howtoRef href="files_and_registry/parentdirectorysearch.html">How To: Get the parent directory of a file search</xse:howtoRef>
3721 <xse:remarks>
3722 <html:p>Use the AssignToProperty attribute to search for a file but set the outer property to the directory containing the file. When this attribute is set to 'yes', you may only nest a FileSearch element with a unique Id or define no child element.</html:p>
3723 <html:a>When the parent DirectorySearch/@Depth attribute is greater than 0, the FileSearch/@Id attribute must be absent or the same as the parent DirectorySearch/@Id attribute value, unless the parent DirectorySearch/@AssignToProperty attribute value is 'yes'.</html:a>
3724 </xse:remarks>
3725 </xs:appinfo>
3726 <xs:documentation>Searches for directory and assigns to value of parent Property.</xs:documentation>
3727 </xs:annotation>
3728 <xs:complexType>
3729 <xs:choice minOccurs="0">
3730 <xs:element ref="DirectorySearch" />
3731 <xs:element ref="DirectorySearchRef" />
3732 <xs:element ref="FileSearch" />
3733 <xs:element ref="FileSearchRef" />
3734 </xs:choice>
3735 <xs:attribute name="Id" use="required" type="xs:string">
3736 <xs:annotation>
3737 <xs:documentation>Unique identifier for the directory search.</xs:documentation>
3738 </xs:annotation>
3739 </xs:attribute>
3740 <xs:attribute name="Path" type="xs:string">
3741 <xs:annotation>
3742 <xs:documentation>Path on the user's system. Either absolute, or relative to containing directories.</xs:documentation>
3743 </xs:annotation>
3744 </xs:attribute>
3745 <xs:attribute name="Depth" type="xs:integer">
3746 <xs:annotation>
3747 <xs:documentation>
3748 Depth below the path that the installer searches for the file or directory specified by the search. See remarks for more information.
3749 </xs:documentation>
3750 </xs:annotation>
3751 </xs:attribute>
3752 <xs:attribute name="AssignToProperty" type="YesNoTypeUnion">
3753 <xs:annotation>
3754 <xs:documentation>Set the value of the outer Property to the result of this search. See remarks for more information.</xs:documentation>
3755 </xs:annotation>
3756 </xs:attribute>
3757 </xs:complexType>
3758 </xs:element>
3759 <xs:element name="DirectorySearchRef">
3760 <xs:annotation>
3761 <xs:appinfo>
3762 <xse:seeAlso ref="ComponentSearch" />
3763 <xse:seeAlso ref="IniFileSearch" />
3764 <xse:seeAlso ref="RegistrySearch" />
3765 <xse:howtoRef href="files_and_registry/directorysearchref.html">How To: Reference another DirectorySearch element</xse:howtoRef>
3766 <xse:remarks>
3767 <html:p>A reference to another DirectorySearch element must reference the same Id, the same Parent Id, and the same Path. If any of these attribute values are different you must instead use a DirectorySearch element.</html:p>
3768 </xse:remarks>
3769 </xs:appinfo>
3770 <xs:documentation>References an existing DirectorySearch element.</xs:documentation>
3771 </xs:annotation>
3772 <xs:complexType>
3773 <xs:choice minOccurs="0">
3774 <xs:element ref="DirectorySearch" />
3775 <xs:element ref="DirectorySearchRef" />
3776 <xs:element ref="FileSearch" />
3777 <xs:element ref="FileSearchRef" />
3778 </xs:choice>
3779 <xs:attribute name="Id" use="required" type="xs:string">
3780 <xs:annotation>
3781 <xs:documentation>Id of the search being referred to.</xs:documentation>
3782 </xs:annotation>
3783 </xs:attribute>
3784 <xs:attribute name="Parent" type="xs:string">
3785 <xs:annotation>
3786 <xs:documentation>This attribute is the signature of the parent directory of the file or directory in the Signature_ column. If this field is null, and the Path column does not expand to a full path, then all the fixed drives of the user's system are searched by using the Path. This field is a key into one of the following tables: the RegLocator, the IniLocator, the CompLocator, or the DrLocator tables.</xs:documentation>
3787 </xs:annotation>
3788 </xs:attribute>
3789 <xs:attribute name="Path" type="xs:string">
3790 <xs:annotation>
3791 <xs:documentation>Path on the user's system. Either absolute, or relative to containing directories.</xs:documentation>
3792 </xs:annotation>
3793 </xs:attribute>
3794 </xs:complexType>
3795 </xs:element>
3796 <xs:element name="ComponentSearch">
3797 <xs:annotation>
3798 <xs:appinfo>
3799 <xse:seeAlso ref="IniFileSearch" />
3800 <xse:seeAlso ref="RegistrySearch" />
3801 <xse:msiRef table="CompLocator" href="http://msdn.microsoft.com/library/aa368001.aspx" />
3802 <xse:msiRef table="Signature" href="http://msdn.microsoft.com/library/aa371853.aspx" />
3803 </xs:appinfo>
3804 <xs:documentation>Searches for file or directory and assigns to value of parent Property.</xs:documentation>
3805 </xs:annotation>
3806 <xs:complexType>
3807 <xs:choice minOccurs="0">
3808 <xs:element ref="DirectorySearch" />
3809 <xs:element ref="DirectorySearchRef" />
3810 <xs:element ref="FileSearch" />
3811 <xs:element ref="FileSearchRef" />
3812 </xs:choice>
3813 <xs:attribute name="Id" use="required" type="xs:string" />
3814 <xs:attribute name="Guid" type="Guid">
3815 <xs:annotation>
3816 <xs:documentation>The component ID of the component whose key path is to be used for the search.</xs:documentation>
3817 </xs:annotation>
3818 </xs:attribute>
3819 <xs:attribute name="Type">
3820 <xs:annotation>
3821 <xs:documentation>Must be file if last child is FileSearch element and must be directory if last child is DirectorySearch element.</xs:documentation>
3822 </xs:annotation>
3823 <xs:simpleType>
3824 <xs:restriction base="xs:NMTOKEN">
3825 <xs:enumeration value="directory">
3826 <xs:annotation>
3827 <xs:documentation>
3828 The key path of the component is a directory.
3829 </xs:documentation>
3830 </xs:annotation>
3831 </xs:enumeration>
3832 <xs:enumeration value="file">
3833 <xs:annotation>
3834 <xs:documentation>
3835 The key path of the component is a file. This is the default value.
3836 </xs:documentation>
3837 </xs:annotation>
3838 </xs:enumeration>
3839 </xs:restriction>
3840 </xs:simpleType>
3841 </xs:attribute>
3842 </xs:complexType>
3843 </xs:element>
3844 <xs:element name="IniFileSearch">
3845 <xs:annotation>
3846 <xs:appinfo>
3847 <xse:seeAlso ref="ComponentSearch" />
3848 <xse:seeAlso ref="RegistrySearch" />
3849 <xse:msiRef table="IniLocator" href="http://msdn.microsoft.com/library/aa369283.aspx" />
3850 <xse:msiRef table="Signature" href="http://msdn.microsoft.com/library/aa371853.aspx" />
3851 </xs:appinfo>
3852 <xs:documentation>Searches for file, directory or registry key and assigns to value of parent Property</xs:documentation>
3853 </xs:annotation>
3854 <xs:complexType>
3855 <xs:choice minOccurs="0">
3856 <xs:element ref="DirectorySearch" />
3857 <xs:element ref="DirectorySearchRef" />
3858 <xs:element ref="FileSearch" />
3859 <xs:element ref="FileSearchRef" />
3860 </xs:choice>
3861 <xs:attribute name="Id" use="required" type="xs:string">
3862 <xs:annotation>
3863 <xs:documentation>External key into the Signature table.</xs:documentation>
3864 </xs:annotation>
3865 </xs:attribute>
3866 <xs:attribute name="Field" type="xs:integer">
3867 <xs:annotation>
3868 <xs:documentation>The field in the .ini line. If field is Null or 0, the entire line is read.</xs:documentation>
3869 </xs:annotation>
3870 </xs:attribute>
3871 <xs:attribute name="Key" use="required" type="xs:string">
3872 <xs:annotation>
3873 <xs:documentation>The key value within the section.</xs:documentation>
3874 </xs:annotation>
3875 </xs:attribute>
3876 <xs:attribute name="Name" type="LongFileNameType" use="required">
3877 <xs:annotation>
3878 <xs:documentation>
3879 In prior versions of the WiX toolset, this attribute specified the short name.
3880 This attribute's value may now be either a short or long name.
3881 If a short name is specified, the ShortName attribute may not be specified.
3882 Also, if this value is a long name, the ShortName attribute may be omitted to
3883 allow WiX to attempt to generate a unique short name.
3884 However, if you wish to manually specify the short name, then the ShortName
3885 attribute may be specified.
3886 </xs:documentation>
3887 </xs:annotation>
3888 </xs:attribute>
3889 <xs:attribute name="Section" use="required" type="xs:string">
3890 <xs:annotation>
3891 <xs:documentation>The localizable .ini file section.</xs:documentation>
3892 </xs:annotation>
3893 </xs:attribute>
3894 <xs:attribute name="ShortName" type="ShortFileNameType">
3895 <xs:annotation>
3896 <xs:documentation>
3897 The short name of the file in 8.3 format.
3898 This attribute should only be set if the user wants to manually specify the short name.
3899 </xs:documentation>
3900 </xs:annotation>
3901 </xs:attribute>
3902 <xs:attribute name="Type">
3903 <xs:annotation>
3904 <xs:documentation>Must be file if last child is FileSearch element and must be directory if last child is DirectorySearch element.</xs:documentation>
3905 </xs:annotation>
3906 <xs:simpleType>
3907 <xs:restriction base="xs:NMTOKEN">
3908 <xs:enumeration value="directory">
3909 <xs:annotation>
3910 <xs:documentation>A directory location.</xs:documentation>
3911 </xs:annotation>
3912 </xs:enumeration>
3913 <xs:enumeration value="file">
3914 <xs:annotation>
3915 <xs:documentation>A file location. This is the default value.</xs:documentation>
3916 </xs:annotation>
3917 </xs:enumeration>
3918 <xs:enumeration value="raw">
3919 <xs:annotation>
3920 <xs:documentation>A raw .ini value.</xs:documentation>
3921 </xs:annotation>
3922 </xs:enumeration>
3923 </xs:restriction>
3924 </xs:simpleType>
3925 </xs:attribute>
3926 </xs:complexType>
3927 </xs:element>
3928 <xs:element name="RegistrySearch">
3929 <xs:annotation>
3930 <xs:appinfo>
3931 <xse:seeAlso ref="ComponentSearch" />
3932 <xse:seeAlso ref="IniFileSearch" />
3933 <xse:msiRef table="RegLocator" href="http://msdn.microsoft.com/library/aa371171.aspx" />
3934 <xse:msiRef table="Signature" href="http://msdn.microsoft.com/library/aa371853.aspx" />
3935 <xse:howtoRef href="files_and_registry/read_a_registry_entry.html">How To: Read a registry entry during installation</xse:howtoRef>
3936 <xse:remarks>
3937 <html:p>
3938 When the Type attribute value is 'directory' the registry value must specify the path to a directory excluding the file name.
3939 When the Type attribute value is 'file' the registry value must specify the path to a file including the file name;
3940 however, if there is no child FileSearch element the parent directory of the file is returned. The FileSearch element requires
3941 that you author the name of the file you are searching for. If you do not know the file name
3942 you must set the Type attribute to 'raw' to return the full file path including the file name.
3943 </html:p>
3944 </xse:remarks>
3945 </xs:appinfo>
3946 <xs:documentation>Searches for file, directory or registry key and assigns to value of parent Property</xs:documentation>
3947 </xs:annotation>
3948 <xs:complexType>
3949 <xs:choice minOccurs="0">
3950 <xs:element ref="DirectorySearch" />
3951 <xs:element ref="DirectorySearchRef" />
3952 <xs:element ref="FileSearch" />
3953 <xs:element ref="FileSearchRef" />
3954 </xs:choice>
3955 <xs:attribute name="Id" use="required" type="xs:string">
3956 <xs:annotation>
3957 <xs:documentation>Signature to be used for the file, directory or registry key being searched for.</xs:documentation>
3958 </xs:annotation>
3959 </xs:attribute>
3960 <xs:attribute name="Root" use="required">
3961 <xs:annotation>
3962 <xs:documentation>Root key for the registry value.</xs:documentation>
3963 </xs:annotation>
3964 <xs:simpleType>
3965 <xs:restriction base="xs:NMTOKEN">
3966 <xs:enumeration value="HKCR">
3967 <xs:annotation>
3968 <xs:documentation>
3969 HKEY_CLASSES_ROOT
3970 </xs:documentation>
3971 </xs:annotation>
3972 </xs:enumeration>
3973 <xs:enumeration value="HKCU">
3974 <xs:annotation>
3975 <xs:documentation>
3976 HKEY_CURRENT_USER
3977 </xs:documentation>
3978 </xs:annotation>
3979 </xs:enumeration>
3980 <xs:enumeration value="HKLM">
3981 <xs:annotation>
3982 <xs:documentation>
3983 HKEY_LOCAL_MACHINE
3984 </xs:documentation>
3985 </xs:annotation>
3986 </xs:enumeration>
3987 <xs:enumeration value="HKU">
3988 <xs:annotation>
3989 <xs:documentation>
3990 HKEY_USERS
3991 </xs:documentation>
3992 </xs:annotation>
3993 </xs:enumeration>
3994 </xs:restriction>
3995 </xs:simpleType>
3996 </xs:attribute>
3997 <xs:attribute name="Key" use="required" type="xs:string">
3998 <xs:annotation>
3999 <xs:documentation>Key for the registry value.</xs:documentation>
4000 </xs:annotation>
4001 </xs:attribute>
4002 <xs:attribute name="Name" type="xs:string">
4003 <xs:annotation>
4004 <xs:documentation>Registry value name. If this value is null, then the value from the key's unnamed or default value, if any, is retrieved.</xs:documentation>
4005 </xs:annotation>
4006 </xs:attribute>
4007 <xs:attribute name="Type" use="required">
4008 <xs:annotation>
4009 <xs:documentation>
4010 The value must be 'file' if the child is a FileSearch element, and must be 'directory' if child is a DirectorySearch element.
4011 </xs:documentation>
4012 </xs:annotation>
4013 <xs:simpleType>
4014 <xs:restriction base="xs:NMTOKEN">
4015 <xs:enumeration value="directory">
4016 <xs:annotation>
4017 <xs:documentation>
4018 The registry value contains the path to a directory.
4019 </xs:documentation>
4020 </xs:annotation>
4021 </xs:enumeration>
4022 <xs:enumeration value="file">
4023 <xs:annotation>
4024 <xs:documentation>
4025 The registry value contains the path to a file. To return the full file path you must add a FileSearch element as a child of this element; otherwise, the parent directory of the file path is returned.
4026 </xs:documentation>
4027 </xs:annotation>
4028 </xs:enumeration>
4029 <xs:enumeration value="raw">
4030 <xs:annotation>
4031 <xs:documentation>
4032 Sets the raw value from the registry value. Please note that this value will contain a prefix as follows:<html:br /><html:br /><html:dl><html:dt>DWORD</html:dt><html:dd>Starts with '#' optionally followed by '+' or '-'.</html:dd><html:dt>REG_BINARY</html:dt><html:dd>Starts with '#x' and the installer converts and saves each hexadecimal digit (nibble) as an ASCII character prefixed by '#x'.</html:dd><html:dt>REG_EXPAND_SZ</html:dt><html:dd>Starts with '#%'.</html:dd><html:dt>REG_MULTI_SZ</html:dt><html:dd>Starts with '[~]' and ends with '[~]'.</html:dd><html:dt>REG_SZ</html:dt><html:dd>No prefix, but if the first character of the registry value is '#', the installer escapes the character by prefixing it with another '#'.</html:dd></html:dl></xs:documentation>
4033 </xs:annotation>
4034 </xs:enumeration>
4035 </xs:restriction>
4036 </xs:simpleType>
4037 </xs:attribute>
4038 <xs:attribute name="Win64" type="YesNoTypeUnion">
4039 <xs:annotation>
4040 <xs:documentation>Instructs the search to look in the 64-bit registry when the value is 'yes'. When the value is 'no', the search looks in the 32-bit registry.
4041 The default value is based on the platform set by the -arch switch to candle.exe
4042 or the InstallerPlatform property in a .wixproj MSBuild project:
4043 For x86 and ARM, the default value is 'no'.
4044 For x64 and IA64, the default value is 'yes'.
4045 </xs:documentation>
4046 </xs:annotation>
4047 </xs:attribute>
4048 </xs:complexType>
4049 </xs:element>
4050 <xs:element name="RegistrySearchRef">
4051 <xs:annotation>
4052 <xs:appinfo>
4053 <xse:seeAlso ref="RegistrySearch" />
4054 </xs:appinfo>
4055 <xs:documentation>References an existing RegistrySearch element.</xs:documentation>
4056 </xs:annotation>
4057 <xs:complexType>
4058 <xs:attribute name="Id" type="xs:string" use="required">
4059 <xs:annotation>
4060 <xs:documentation>Specify the Id of the RegistrySearch to reference.</xs:documentation>
4061 </xs:annotation>
4062 </xs:attribute>
4063 </xs:complexType>
4064 </xs:element>
4065 <xs:element name="ComplianceDrive">
4066 <xs:annotation>
4067 <xs:documentation>Sets the parent of a nested DirectorySearch element to CCP_DRIVE.</xs:documentation>
4068 </xs:annotation>
4069 <xs:complexType>
4070 <xs:choice>
4071 <xs:element ref="DirectorySearch" />
4072 <xs:element ref="DirectorySearchRef" />
4073 </xs:choice>
4074 </xs:complexType>
4075 </xs:element>
4076 <xs:element name="ComplianceCheck">
4077 <xs:annotation>
4078 <xs:appinfo>
4079 <xse:seeAlso ref="Property" />
4080 <xse:msiRef table="CCPSearch" href="http://msdn.microsoft.com/library/aa367846.aspx" />
4081 <xse:msiRef table="Signature" href="http://msdn.microsoft.com/library/aa371853.aspx" />
4082 </xs:appinfo>
4083 <xs:documentation>Adds a row to the CCPSearch table.</xs:documentation>
4084 </xs:annotation>
4085 <xs:complexType>
4086 <xs:choice minOccurs="0" maxOccurs="unbounded">
4087 <xs:sequence>
4088 <xs:element ref="ComplianceDrive" minOccurs="0">
4089 <xs:annotation>
4090 <xs:documentation>Starts searches from the CCP_DRIVE.</xs:documentation>
4091 </xs:annotation>
4092 </xs:element>
4093 <xs:element ref="ComponentSearch" minOccurs="0" maxOccurs="unbounded" />
4094 <xs:element ref="RegistrySearch" minOccurs="0" maxOccurs="unbounded" />
4095 <xs:element ref="IniFileSearch" minOccurs="0" maxOccurs="unbounded" />
4096 <xs:element ref="DirectorySearch" minOccurs="0" maxOccurs="unbounded" />
4097 </xs:sequence>
4098 <xs:any namespace="##other" processContents="lax">
4099 <xs:annotation>
4100 <xs:documentation>
4101 Extensibility point in the WiX XML Schema. Schema extensions can register additional
4102 elements at this point in the schema.
4103 </xs:documentation>
4104 </xs:annotation>
4105 </xs:any>
4106 </xs:choice>
4107 <xs:anyAttribute namespace="##other" processContents="lax">
4108 <xs:annotation>
4109 <xs:documentation>
4110 Extensibility point in the WiX XML Schema. Schema extensions can register additional
4111 attributes at this point in the schema.
4112 </xs:documentation>
4113 </xs:annotation>
4114 </xs:anyAttribute>
4115 </xs:complexType>
4116 </xs:element>
4117 <xs:element name="Property">
4118 <xs:annotation>
4119 <xs:appinfo>
4120 <xse:seeAlso ref="PropertyRef" />
4121 <xse:msiRef table="Property" href="http://msdn.microsoft.com/library/aa370908.aspx" />
4122 <xse:howtoRef href="files_and_registry/check_the_version_number.html">How To: Check the version number of a file during installation</xse:howtoRef>
4123 </xs:appinfo>
4124 <xs:documentation>Property value for a Product or Module.</xs:documentation>
4125 </xs:annotation>
4126 <xs:complexType mixed="true">
4127 <xs:choice minOccurs="0" maxOccurs="unbounded">
4128 <xs:sequence>
4129 <xs:element ref="ComplianceDrive" minOccurs="0">
4130 <xs:annotation>
4131 <xs:documentation>Starts searches from the CCP_DRIVE.</xs:documentation>
4132 </xs:annotation>
4133 </xs:element>
4134 <xs:element ref="ComponentSearch" minOccurs="0" maxOccurs="unbounded" />
4135 <xs:element ref="RegistrySearch" minOccurs="0" maxOccurs="unbounded" />
4136 <xs:element ref="RegistrySearchRef" minOccurs="0" maxOccurs="unbounded" />
4137 <xs:element ref="IniFileSearch" minOccurs="0" maxOccurs="unbounded" />
4138 <xs:element ref="DirectorySearch" minOccurs="0" maxOccurs="unbounded" />
4139 <xs:element ref="DirectorySearchRef" minOccurs="0" maxOccurs="unbounded" />
4140 <xs:element ref="ProductSearch" minOccurs="0" maxOccurs="unbounded" />
4141 </xs:sequence>
4142 <xs:any namespace="##other" processContents="lax">
4143 <xs:annotation>
4144 <xs:documentation>
4145 Extensibility point in the WiX XML Schema. Schema extensions can register additional
4146 elements at this point in the schema.
4147 </xs:documentation>
4148 </xs:annotation>
4149 </xs:any>
4150 </xs:choice>
4151 <xs:attribute name="Id" type="xs:string" use="required">
4152 <xs:annotation>
4153 <xs:documentation>Unique identifier for Property.</xs:documentation>
4154 </xs:annotation>
4155 </xs:attribute>
4156 <xs:attribute name="Value" type="xs:string">
4157 <xs:annotation>
4158 <xs:documentation>Sets a default value for the property. The value will be overwritten if the Property is used for a search.</xs:documentation>
4159 </xs:annotation>
4160 </xs:attribute>
4161 <xs:attribute name="ComplianceCheck" type="YesNoTypeUnion">
4162 <xs:annotation>
4163 <xs:documentation>Adds a row to the CCPSearch table. This attribute is only valid when this Property contains a search element.</xs:documentation>
4164 </xs:annotation>
4165 </xs:attribute>
4166 <xs:attribute name="Admin" type="YesNoTypeUnion">
4167 <xs:annotation>
4168 <xs:documentation>Denotes that the Property is saved during <html:a href="http://msdn.microsoft.com/library/aa367541.aspx" target="_blank">admininistrative installation</html:a>. See the <html:a href="http://msdn.microsoft.com/library/aa367542.aspx" target="_blank">AdminProperties Property</html:a> for more information.</xs:documentation>
4169 </xs:annotation>
4170 </xs:attribute>
4171 <xs:attribute name="Secure" type="YesNoTypeUnion">
4172 <xs:annotation>
4173 <xs:documentation>Denotes that the Property can be passed to the server side when doing a managed installation with elevated privileges. See the <html:a href="http://msdn.microsoft.com/library/aa371571.aspx" target="_blank">SecureCustomProperties Property</html:a> for more information.</xs:documentation>
4174 </xs:annotation>
4175 </xs:attribute>
4176 <xs:attribute name="Hidden" type="YesNoTypeUnion">
4177 <xs:annotation>
4178 <xs:documentation>Denotes that the Property is not logged during installation. See the <html:a href="http://msdn.microsoft.com/library/aa370308.aspx" target="_blank">MsiHiddenProperties Property</html:a> for more information.</xs:documentation>
4179 </xs:annotation>
4180 </xs:attribute>
4181 <xs:attribute name="SuppressModularization" type="YesNoTypeUnion">
4182 <xs:annotation>
4183 <xs:documentation>
4184 Use to suppress modularization of this property identifier in merge modules.
4185 Using this functionality is strongly discouraged; it should only be
4186 necessary as a workaround of last resort in rare scenarios.
4187 </xs:documentation>
4188 </xs:annotation>
4189 </xs:attribute>
4190 <xs:anyAttribute namespace="##other" processContents="lax">
4191 <xs:annotation>
4192 <xs:documentation>
4193 Extensibility point in the WiX XML Schema. Schema extensions can register additional
4194 attributes at this point in the schema.
4195 </xs:documentation>
4196 </xs:annotation>
4197 </xs:anyAttribute>
4198 </xs:complexType>
4199 </xs:element>
4200 <xs:element name="PropertyRef">
4201 <xs:annotation>
4202 <xs:appinfo>
4203 <xse:seeAlso ref="Property" />
4204 <xse:howtoRef href="redistributables_and_install_checks/check_for_dotnet.html">How To: Check for .NET Framework versions</xse:howtoRef>
4205 </xs:appinfo>
4206 <xs:documentation>Reference to a Property value.</xs:documentation>
4207 </xs:annotation>
4208 <xs:complexType>
4209 <xs:attribute name="Id" type="xs:string" use="required">
4210 <xs:annotation>
4211 <xs:documentation>Identifier of Property to reference.</xs:documentation>
4212 </xs:annotation>
4213 </xs:attribute>
4214 <xs:anyAttribute namespace="##other" processContents="lax">
4215 <xs:annotation>
4216 <xs:documentation>
4217 Extensibility point in the WiX XML Schema. Schema extensions can register additional
4218 attributes at this point in the schema.
4219 </xs:documentation>
4220 </xs:annotation>
4221 </xs:anyAttribute>
4222 </xs:complexType>
4223 </xs:element>
4224 <xs:element name="Shortcut">
4225 <xs:annotation>
4226 <xs:documentation>
4227 Shortcut, default target is parent File, CreateFolder, or Component's Directory
4228 </xs:documentation>
4229 <xs:appinfo>
4230 <xse:msiRef table="Shortcut" href="http://msdn.microsoft.com/library/aa371847.aspx" />
4231 <xse:howtoRef href="files_and_registry/create_start_menu_shortcut.html">How To: Create a shortcut on the Start Menu</xse:howtoRef>
4232 </xs:appinfo>
4233 </xs:annotation>
4234 <xs:complexType>
4235 <xs:choice minOccurs="0" maxOccurs="unbounded">
4236 <xs:element ref="Icon" minOccurs="0" />
4237 <xs:element ref="ShortcutProperty" minOccurs="0" />
4238 </xs:choice>
4239 <xs:attribute name="Id" type="xs:string" use="required">
4240 <xs:annotation>
4241 <xs:documentation>Unique identifier for the shortcut. This value will serve as the primary key for the row.</xs:documentation>
4242 </xs:annotation>
4243 </xs:attribute>
4244 <xs:attribute name="Directory" type="xs:string">
4245 <xs:annotation>
4246 <xs:documentation>Identifier reference to Directory element where shortcut is to be created. When nested under a Component element, this attribute's value will default to the parent directory. Otherwise, this attribute is required.</xs:documentation>
4247 </xs:annotation>
4248 </xs:attribute>
4249 <xs:attribute name="Name" type="LongFileNameType" use="required">
4250 <xs:annotation>
4251 <xs:documentation>
4252 In prior versions of the WiX toolset, this attribute specified the short name.
4253 This attribute's value may now be either a short or long name.
4254 If a short name is specified, the ShortName attribute may not be specified.
4255 Also, if this value is a long name, the ShortName attribute may be omitted to
4256 allow WiX to attempt to generate a unique short name.
4257 However, if this name collides with another shortcut or you wish to manually specify
4258 the short name, then the ShortName attribute may be specified.
4259 </xs:documentation>
4260 </xs:annotation>
4261 </xs:attribute>
4262 <xs:attribute name="ShortName" type="ShortFileNameType">
4263 <xs:annotation>
4264 <xs:documentation>
4265 The short name of the shortcut in 8.3 format.
4266 This attribute should only be set if there is a conflict between generated short names
4267 or the user wants to manually specify the short name.
4268 </xs:documentation>
4269 </xs:annotation>
4270 </xs:attribute>
4271 <xs:attribute name="Target" type="xs:string">
4272 <xs:annotation>
4273 <xs:documentation>
4274 This attribute can only be set if this Shortcut element is nested under a Component element.
4275 When nested under a Component element, this attribute's value will default to the parent directory.
4276 This attribute's value is the target for a non-advertised shortcut.
4277 This attribute is not valid for advertised shortcuts.
4278 If you specify this value, its value should be a property identifier enclosed by square brackets ([ ]), that is expanded into the file or a folder pointed to by the shortcut.
4279 </xs:documentation>
4280 </xs:annotation>
4281 </xs:attribute>
4282 <xs:attribute name="Description" type="xs:string">
4283 <xs:annotation>
4284 <xs:documentation>The localizable description for the shortcut.</xs:documentation>
4285 </xs:annotation>
4286 </xs:attribute>
4287 <xs:attribute name="Arguments" type="xs:string">
4288 <xs:annotation>
4289 <xs:documentation>The command-line arguments for the shortcut. Note that the resolution of properties
4290 in the Arguments field is limited. A property formatted as [Property] in this field can only be resolved if the
4291 property already has the intended value when the component owning the shortcut is installed. For example, for the
4292 argument "[#MyDoc.doc]" to resolve to the correct value, the same process must be installing the file MyDoc.doc and
4293 the component that owns the shortcut.</xs:documentation>
4294 </xs:annotation>
4295 </xs:attribute>
4296 <xs:attribute name="Hotkey" type="xs:integer">
4297 <xs:annotation>
4298 <xs:documentation>The hotkey for the shortcut. The low-order byte contains the virtual-key code for
4299 the key, and the high-order byte contains modifier flags. This must be a non-negative number. Authors of
4300 installation packages are generally recommend not to set this option, because this can add duplicate hotkeys to a
4301 users desktop. In addition, the practice of assigning hotkeys to shortcuts can be problematic for users using hotkeys
4302 for accessibility.</xs:documentation>
4303 </xs:annotation>
4304 </xs:attribute>
4305 <xs:attribute name="Icon" type="xs:string">
4306 <xs:annotation>
4307 <xs:documentation>Identifier reference to Icon element. The Icon identifier should have the same extension
4308 as the file that it points at. For example, a shortcut to an executable (e.g. "my.exe") should reference an Icon with identifier
4309 like "MyIcon.exe"</xs:documentation>
4310 </xs:annotation>
4311 </xs:attribute>
4312 <xs:attribute name="IconIndex" type="xs:integer">
4313 <xs:annotation>
4314 <xs:documentation>Identifier reference to Icon element.</xs:documentation>
4315 </xs:annotation>
4316 </xs:attribute>
4317 <xs:attribute name="Show">
4318 <xs:simpleType>
4319 <xs:restriction base="xs:NMTOKEN">
4320 <xs:enumeration value="normal">
4321 <xs:annotation>
4322 <xs:documentation>
4323 The shortcut target will be displayed using the SW_SHOWNORMAL attribute.
4324 </xs:documentation>
4325 </xs:annotation>
4326 </xs:enumeration>
4327 <xs:enumeration value="minimized">
4328 <xs:annotation>
4329 <xs:documentation>
4330 The shortcut target will be displayed using the SW_SHOWMINNOACTIVE attribute.
4331 </xs:documentation>
4332 </xs:annotation>
4333 </xs:enumeration>
4334 <xs:enumeration value="maximized">
4335 <xs:annotation>
4336 <xs:documentation>
4337 The shortcut target will be displayed using the SW_SHOWMAXIMIZED attribute.
4338 </xs:documentation>
4339 </xs:annotation>
4340 </xs:enumeration>
4341 </xs:restriction>
4342 </xs:simpleType>
4343 </xs:attribute>
4344 <xs:attribute name="WorkingDirectory" type="xs:string">
4345 <xs:annotation>
4346 <xs:documentation>Directory identifier (or Property identifier that resolves to a directory) that resolves
4347 to the path of the working directory for the shortcut.</xs:documentation>
4348 </xs:annotation>
4349 </xs:attribute>
4350 <xs:attribute name="Advertise" type="YesNoTypeUnion">
4351 <xs:annotation>
4352 <xs:documentation>Specifies if the shortcut should be advertised or not. Note that advertised shortcuts
4353 always point at a particular application, identified by a ProductCode, and should not be shared between applications.
4354 Advertised shortcuts only work for the most recently installed application, and are removed when that application is
4355 removed. The default value is 'no'.</xs:documentation>
4356 </xs:annotation>
4357 </xs:attribute>
4358 <xs:attribute name="DisplayResourceDll" type="xs:string">
4359 <xs:annotation>
4360 <xs:documentation>
4361 The Formatted string providing the full path to the language neutral file containing the MUI Manifest. Generally
4362 authored using [#filekey] form. When this attribute is specified, the DisplayResourceId attribute must also
4363 be provided.
4364
4365 This attribute is only used on Windows Vista and above. If this attribute is not populated and the install
4366 is running on Vista and above, the value in the Name attribute is used. If this attribute is populated and
4367 the install is running on Vista and above, the value in the Name attribute is ignored.
4368 </xs:documentation>
4369 </xs:annotation>
4370 </xs:attribute>
4371 <xs:attribute name="DisplayResourceId" type="xs:integer">
4372 <xs:annotation>
4373 <xs:documentation>
4374 The display name index for the shortcut. This must be a non-negative number. When this attribute is specified, the
4375 DisplayResourceDll attribute must also be provided.
4376
4377 This attribute is only used on Windows Vista and above. If this attribute is not specified and the install
4378 is running on Vista and above, the value in the Name attribute is used. If this attribute is specified and
4379 the install is running on Vista and above, the value in the Name attribute is ignored.
4380 </xs:documentation>
4381 </xs:annotation>
4382 </xs:attribute>
4383 <xs:attribute name="DescriptionResourceDll" type="xs:string">
4384 <xs:annotation>
4385 <xs:documentation>
4386 The Formatted string providing the full path to the language neutral file containing the MUI Manifest. Generally
4387 authored using [#filekey] form. When this attribute is specified, the DescriptionResourceId attribute must also
4388 be provided.
4389
4390 This attribute is only used on Windows Vista and above. If this attribute is not specified and the install
4391 is running on Vista and above, the value in the Name attribute is used. If this attribute is provided and
4392 the install is running on Vista and above, the value in the Name attribute is ignored.
4393 </xs:documentation>
4394 </xs:annotation>
4395 </xs:attribute>
4396 <xs:attribute name="DescriptionResourceId" type="xs:integer">
4397 <xs:annotation>
4398 <xs:documentation>
4399 The description name index for the shortcut. This must be a non-negative number. When this attribute is specified,
4400 the DescriptionResourceDll attribute must also be populated.
4401
4402 This attribute is only used on Windows Vista and above. If this attribute is not specified and the install
4403 is running on Vista and above, the value in the Name attribute is used. If this attribute is populated and the
4404 install is running on Vista and above, the value in the Name attribute is ignored.
4405 </xs:documentation>
4406 </xs:annotation>
4407 </xs:attribute>
4408 </xs:complexType>
4409 </xs:element>
4410 <xs:element name="ShortcutProperty">
4411 <xs:annotation>
4412 <xs:appinfo>
4413 <xse:seeAlso ref="Shortcut" />
4414 <xse:msiRef table="MsiShortcutProperty" />
4415 </xs:appinfo>
4416 <xs:documentation>Property values for a shortcut. This element's functionality is available starting with MSI 5.0.</xs:documentation>
4417 </xs:annotation>
4418 <xs:complexType mixed="true">
4419 <xs:attribute name="Id" type="xs:string">
4420 <xs:annotation>
4421 <xs:documentation>Unique identifier for MsiShortcutProperty table. If omitted, a stable identifier will be generated from the parent shortcut identifier and Key value.</xs:documentation>
4422 </xs:annotation>
4423 </xs:attribute>
4424 <xs:attribute name="Key" type="xs:string" use="required">
4425 <xs:annotation>
4426 <xs:documentation>A formatted string identifying the property to be set.</xs:documentation>
4427 </xs:annotation>
4428 </xs:attribute>
4429 <xs:attribute name="Value" type="xs:string">
4430 <xs:annotation>
4431 <xs:documentation>A formatted string supplying the value of the property.</xs:documentation>
4432 </xs:annotation>
4433 </xs:attribute>
4434 </xs:complexType>
4435 </xs:element>
4436 <xs:element name="Permission">
4437 <xs:annotation>
4438 <xs:documentation>
4439 Sets ACLs on File, Registry, or CreateFolder. When under a Registry element, this cannot be used
4440 if the Action attribute's value is remove or removeKeyOnInstall. This element has no Id attribute.
4441 The table and key are taken from the parent element.
4442 </xs:documentation>
4443 <xs:appinfo>
4444 <xse:msiRef table="LockPermissions" href="http://msdn.microsoft.com/library/aa369774.aspx" />
4445 </xs:appinfo>
4446 </xs:annotation>
4447 <xs:complexType>
4448 <xs:attribute name="Domain" type="xs:string"></xs:attribute>
4449 <xs:attribute name="User" use="required" type="xs:string"></xs:attribute>
4450 <!-- Common ACLs -->
4451 <xs:attribute name="Read" type="YesNoTypeUnion"></xs:attribute>
4452 <xs:attribute name="Delete" type="YesNoTypeUnion"></xs:attribute>
4453 <xs:attribute name="ReadPermission" type="YesNoTypeUnion"></xs:attribute>
4454 <xs:attribute name="ChangePermission" type="YesNoTypeUnion"></xs:attribute>
4455 <xs:attribute name="TakeOwnership" type="YesNoTypeUnion"></xs:attribute>
4456 <xs:attribute name="SpecificRightsAll" type="YesNoTypeUnion">
4457 <xs:annotation>
4458 <xs:documentation>Bit mask for SPECIFIC_RIGHTS_ALL from WinNT.h (0x0000FFFF).</xs:documentation>
4459 </xs:annotation>
4460 </xs:attribute>
4461 <!-- Folder and File ACLs -->
4462 <xs:attribute name="ReadAttributes" type="YesNoTypeUnion"></xs:attribute>
4463 <xs:attribute name="WriteAttributes" type="YesNoTypeUnion"></xs:attribute>
4464 <xs:attribute name="ReadExtendedAttributes" type="YesNoTypeUnion"></xs:attribute>
4465 <xs:attribute name="WriteExtendedAttributes" type="YesNoTypeUnion"></xs:attribute>
4466 <xs:attribute name="Synchronize" type="YesNoTypeUnion"></xs:attribute>
4467 <!-- Folder only ACLs -->
4468 <xs:attribute name="CreateFile" type="YesNoTypeUnion">
4469 <xs:annotation>
4470 <xs:documentation>For a directory, the right to create a file in the directory. Only valid under a 'CreateFolder' parent.</xs:documentation>
4471 </xs:annotation>
4472 </xs:attribute>
4473 <xs:attribute name="CreateChild" type="YesNoTypeUnion">
4474 <xs:annotation>
4475 <xs:documentation>For a directory, the right to create a subdirectory. Only valid under a 'CreateFolder' parent.</xs:documentation>
4476 </xs:annotation>
4477 </xs:attribute>
4478 <xs:attribute name="DeleteChild" type="YesNoTypeUnion">
4479 <xs:annotation>
4480 <xs:documentation>For a directory, the right to delete a directory and all the files it contains, including read-only files. Only valid under a 'CreateFolder' parent.</xs:documentation>
4481 </xs:annotation>
4482 </xs:attribute>
4483 <xs:attribute name="Traverse" type="YesNoTypeUnion">
4484 <xs:annotation>
4485 <xs:documentation>For a directory, the right to traverse the directory. By default, users are assigned the BYPASS_TRAVERSE_CHECKING privilege, which ignores the FILE_TRAVERSE access right. Only valid under a 'CreateFolder' parent.</xs:documentation>
4486 </xs:annotation>
4487 </xs:attribute>
4488 <!-- File only ACLs -->
4489 <xs:attribute name="Append" type="YesNoTypeUnion"></xs:attribute>
4490 <xs:attribute name="Execute" type="YesNoTypeUnion"></xs:attribute>
4491 <xs:attribute name="FileAllRights" type="YesNoTypeUnion">
4492 <xs:annotation>
4493 <xs:documentation>Bit mask for FILE_ALL_ACCESS from WinNT.h (0x001F01FF).</xs:documentation>
4494 </xs:annotation>
4495 </xs:attribute>
4496 <!-- File and Registry ACLs -->
4497 <xs:attribute name="Write" type="YesNoTypeUnion"></xs:attribute>
4498 <!-- Registry only ACLs -->
4499 <xs:attribute name="CreateSubkeys" type="YesNoTypeUnion"></xs:attribute>
4500 <xs:attribute name="EnumerateSubkeys" type="YesNoTypeUnion"></xs:attribute>
4501 <xs:attribute name="Notify" type="YesNoTypeUnion"></xs:attribute>
4502 <xs:attribute name="CreateLink" type="YesNoTypeUnion"></xs:attribute>
4503 <!-- Generic ACLs, mapped by system to appropriate permissions -->
4504 <xs:attribute name="GenericAll" type="YesNoTypeUnion"></xs:attribute>
4505 <xs:attribute name="GenericExecute" type="YesNoTypeUnion"></xs:attribute>
4506 <xs:attribute name="GenericWrite" type="YesNoTypeUnion"></xs:attribute>
4507 <xs:attribute name="GenericRead" type="YesNoTypeUnion">
4508 <xs:annotation>
4509 <xs:documentation>specifying this will fail to grant read access</xs:documentation>
4510 </xs:annotation>
4511 </xs:attribute>
4512 </xs:complexType>
4513 </xs:element>
4514 <xs:element name="PermissionEx">
4515 <xs:annotation>
4516 <xs:documentation>
4517 Sets ACLs on File, Registry, or CreateFolder. When under a Registry element, this cannot be used
4518 if the Action attribute's value is remove or removeKeyOnInstall. This element is only available
4519 when installing with MSI 5.0. For downlevel support, see the PermissionEx element from the
4520 WixUtilExtension.
4521 </xs:documentation>
4522 <xs:appinfo>
4523 <xse:msiRef table="MsiLockPermissionsEx" href="http://msdn.microsoft.com/library/aa369774.aspx" />
4524 </xs:appinfo>
4525 </xs:annotation>
4526 <xs:complexType>
4527 <xs:sequence>
4528 <xs:element ref="Condition" minOccurs="0">
4529 <xs:annotation>
4530 <xs:documentation>
4531 Optional condition that controls whether the permissions are applied.
4532 </xs:documentation>
4533 </xs:annotation>
4534 </xs:element>
4535 </xs:sequence>
4536 <xs:attribute name="Id" type="xs:string">
4537 <xs:annotation>
4538 <xs:documentation>
4539 Primary key used to identify this particular entry. If this is not specified the parent element's Id attribute
4540 will be used instead.
4541 </xs:documentation>
4542 </xs:annotation>
4543 </xs:attribute>
4544 <xs:attribute name="Sddl" type="xs:string" use="required">
4545 <xs:annotation>
4546 <xs:documentation>
4547 Security descriptor to apply to parent object.
4548 </xs:documentation>
4549 </xs:annotation>
4550 </xs:attribute>
4551 </xs:complexType>
4552 </xs:element>
4553 <xs:element name="CopyFile">
4554 <xs:annotation>
4555 <xs:appinfo>
4556 <xse:seeAlso ref="RemoveFile" />
4557 <xse:msiRef table="DuplicateFile" href="http://msdn.microsoft.com/library/aa368335.aspx" />
4558 <xse:msiRef table="MoveFile" href="http://msdn.microsoft.com/library/aa370055.aspx" />
4559 </xs:appinfo>
4560 <xs:documentation>
4561 Copy or move an existing file on the target machine, or copy a file that is being installed, to another destination. When
4562 this element is nested under a File element, the parent file will be installed, then copied to the specified destination
4563 if the parent component of the file is selected for installation or removal. When this element is nested under
4564 a Component element and no FileId attribute is specified, the file to copy or move must already be on the target machine.
4565 When this element is nested under a Component element and the FileId attribute is specified, the specified file is installed,
4566 then copied to the specified destination if the parent component is selected for installation or removal (use
4567 this option to control the copy of a file in a different component by the parent component's installation state). If the
4568 specified destination directory is the same as the directory containing the original file and the name for the proposed source
4569 file is the same as the original, then no action takes place.
4570 </xs:documentation>
4571 </xs:annotation>
4572 <xs:complexType>
4573 <xs:attribute name="Id" type="xs:string" use="required">
4574 <xs:annotation>
4575 <xs:documentation>Primary key used to identify this particular entry.</xs:documentation>
4576 </xs:annotation>
4577 </xs:attribute>
4578 <xs:attribute name="FileId" type="xs:string">
4579 <xs:annotation>
4580 <xs:documentation>
4581 This attribute cannot be specified if the element is nested under a File element. Set this attribute's value to the identifier
4582 of a file from a different component to copy it based on the install state of the parent component.
4583 </xs:documentation>
4584 </xs:annotation>
4585 </xs:attribute>
4586 <xs:attribute name="SourceDirectory" type="xs:string">
4587 <xs:annotation>
4588 <xs:documentation>
4589 This attribute cannot be specified if the element is nested under a File element or the FileId attribute is specified. Set
4590 this value to the source directory from which to copy or move an existing file on the target machine. This Directory must
4591 exist in the installer database at creation time. This attribute cannot be specified in conjunction with SourceProperty.
4592 </xs:documentation>
4593 </xs:annotation>
4594 </xs:attribute>
4595 <xs:attribute name="SourceProperty" type="xs:string">
4596 <xs:annotation>
4597 <xs:documentation>
4598 This attribute cannot be specified if the element is nested under a File element or the FileId attribute is specified. Set
4599 this value to a property that will have a value that resolves to the full path of the source directory (or full path
4600 including file name if SourceName is not specified). The property does not have to exist in the installer database at
4601 creation time; it could be created at installation time by a custom action, on the command line, etc. This attribute
4602 cannot be specified in conjunction with SourceDirectory.
4603 </xs:documentation>
4604 </xs:annotation>
4605 </xs:attribute>
4606 <xs:attribute name="SourceName" type="WildCardLongFileNameType">
4607 <xs:annotation>
4608 <xs:documentation>
4609 This attribute cannot be specified if the element is nested under a File element or the FileId attribute is specified. Set
4610 this value to the localizable name of the file(s) to be copied or moved. All of the files that
4611 match the wild card will be removed from the specified directory. The value is a filename that may also
4612 contain the wild card characters "?" for any single character or "*" for zero or more occurrences of any character. If this
4613 attribute is not specified (and this element is not nested under a File element or specify a FileId attribute) then the
4614 SourceProperty attribute should be set to the name of a property that will resolve to the full path of the source filename.
4615 If the value of this attribute contains a "*" wildcard and the DestinationName attribute is specified, all moved or copied
4616 files retain the file names from their sources.
4617 </xs:documentation>
4618 </xs:annotation>
4619 </xs:attribute>
4620 <xs:attribute name="DestinationDirectory" type="xs:string">
4621 <xs:annotation>
4622 <xs:documentation>
4623 Set this value to the destination directory where an existing file on the target machine should be moved or copied to. This
4624 Directory must exist in the installer database at creation time. This attribute cannot be specified in conjunction with
4625 DestinationProperty.
4626 </xs:documentation>
4627 </xs:annotation>
4628 </xs:attribute>
4629 <xs:attribute name="DestinationProperty" type="xs:string">
4630 <xs:annotation>
4631 <xs:documentation>
4632 Set this value to a property that will have a value that resolves to the full path of the destination directory. The property
4633 does not have to exist in the installer database at creation time; it could be created at installation time by a custom
4634 action, on the command line, etc. This attribute cannot be specified in conjunction with DestinationDirectory.
4635 </xs:documentation>
4636 </xs:annotation>
4637 </xs:attribute>
4638 <xs:attribute name="DestinationName" type="LongFileNameType">
4639 <xs:annotation>
4640 <xs:documentation>
4641 In prior versions of the WiX toolset, this attribute specified the short file name.
4642 Now set this value to the localizable name to be given to the original file after it is moved or copied.
4643 If this attribute is not specified, then the destination file is given the same name as the source file.
4644 If a short file name is specified, the DestinationShortName attribute may not be specified.
4645 Also, if this value is a long file name, the DestinationShortName attribute may be omitted to
4646 allow WiX to attempt to generate a unique short file name.
4647 However, if this name collides with another file or you wish to manually specify
4648 the short file name, then the DestinationShortName attribute may be specified.
4649 </xs:documentation>
4650 </xs:annotation>
4651 </xs:attribute>
4652 <xs:attribute name="DestinationShortName" type="ShortFileNameType">
4653 <xs:annotation>
4654 <xs:documentation>
4655 The short file name of the file in 8.3 format.
4656 This attribute should only be set if there is a conflict between generated short file names
4657 or you wish to manually specify the short file name.
4658 </xs:documentation>
4659 </xs:annotation>
4660 </xs:attribute>
4661 <xs:attribute name="Delete" type="YesNoTypeUnion">
4662 <xs:annotation>
4663 <xs:documentation>
4664 This attribute cannot be specified if the element is nested under a File element or the FileId attribute is specified. In other
4665 cases, if the attribute is not specified, the default value is "no" and the file is copied, not moved. Set the value to "yes"
4666 in order to move the file (thus deleting the source file) instead of copying it.
4667 </xs:documentation>
4668 </xs:annotation>
4669 </xs:attribute>
4670 </xs:complexType>
4671 </xs:element>
4672 <xs:element name="File">
4673 <xs:annotation>
4674 <xs:documentation>
4675 File specification for File table, must be child node of Component.
4676 </xs:documentation>
4677 <xs:appinfo>
4678 <xse:msiRef table="File" href="http://msdn.microsoft.com/library/aa368596.aspx" />
4679 <xse:howtoRef href="files_and_registry/add_a_file.html">How To: Add a file to your installer</xse:howtoRef>
4680 </xs:appinfo>
4681 </xs:annotation>
4682 <xs:complexType>
4683 <xs:choice minOccurs="0" maxOccurs="unbounded">
4684 <xs:element ref="AssemblyName" />
4685 <xs:element ref="Permission">
4686 <xs:annotation>
4687 <xs:documentation>Used to configure the ACLs for this file.</xs:documentation>
4688 </xs:annotation>
4689 </xs:element>
4690 <xs:element ref="PermissionEx">
4691 <xs:annotation>
4692 <xs:documentation>Can also configure the ACLs for this file.</xs:documentation>
4693 </xs:annotation>
4694 </xs:element>
4695 <xs:element ref="CopyFile">
4696 <xs:annotation>
4697 <xs:documentation>Used to create a duplicate of this file elsewhere.</xs:documentation>
4698 </xs:annotation>
4699 </xs:element>
4700 <xs:element ref="Shortcut">
4701 <xs:annotation>
4702 <xs:documentation>Target of the shortcut will be set to this file.</xs:documentation>
4703 </xs:annotation>
4704 </xs:element>
4705 <xs:element ref="ODBCDriver" />
4706 <xs:element ref="ODBCTranslator" />
4707 <xs:element ref="SymbolPath" />
4708 <xs:element ref="Class" />
4709 <xs:element ref="AppId" />
4710 <xs:element ref="TypeLib" />
4711 <xs:any namespace="##other" processContents="lax">
4712 <xs:annotation>
4713 <xs:documentation>
4714 Extensibility point in the WiX XML Schema. Schema extensions can register additional
4715 elements at this point in the schema.
4716 </xs:documentation>
4717 </xs:annotation>
4718 </xs:any>
4719 </xs:choice>
4720 <xs:attribute name="Id" type="xs:string">
4721 <xs:annotation>
4722 <xs:documentation>
4723 The unique identifier for this File element. If you omit Id, it defaults to the file name portion of the Source attribute, if specified. May be referenced as a Property by specifying [#value].
4724 </xs:documentation>
4725 </xs:annotation>
4726 </xs:attribute>
4727 <xs:attribute name="CompanionFile" type="xs:string">
4728 <xs:annotation>
4729 <xs:documentation>Set this attribute to make this file a companion child of another file. The installation
4730 state of a companion file depends not on its own file versioning information, but on the versioning of its
4731 companion parent. A file that is the key path for its component can not be a companion file (that means
4732 this attribute cannot be set if KeyPath="yes" for this file). The Version attribute cannot be set along
4733 with this attribute since companion files are not installed based on their own version.</xs:documentation>
4734 </xs:annotation>
4735 </xs:attribute>
4736 <xs:attribute name="Name" type="LongFileNameType">
4737 <xs:annotation>
4738 <xs:documentation>
4739 In prior versions of the WiX toolset, this attribute specified the short file name.
4740 This attribute's value may now be either a short or long file name.
4741 If a short file name is specified, the ShortName attribute may not be specified.
4742 Also, if this value is a long file name, the ShortName attribute may be omitted to
4743 allow WiX to attempt to generate a unique short file name.
4744 However, if this name collides with another file or you wish to manually specify
4745 the short file name, then the ShortName attribute may be specified.
4746 Finally, if this attribute is omitted then its default value is the file name portion
4747 of the Source attribute, if one is specified, or the value of the Id attribute, if
4748 the Source attribute is omitted or doesn't contain a file name.
4749 </xs:documentation>
4750 </xs:annotation>
4751 </xs:attribute>
4752 <xs:attribute name="KeyPath" type="YesNoTypeUnion">
4753 <xs:annotation>
4754 <xs:documentation>Set to yes in order to force this file to be the key path for the parent component.</xs:documentation>
4755 </xs:annotation>
4756 </xs:attribute>
4757 <xs:attribute name="ShortName" type="ShortFileNameType">
4758 <xs:annotation>
4759 <xs:documentation>
4760 The short file name of the file in 8.3 format.
4761 This attribute should only be set if there is a conflict between generated short file names
4762 or the user wants to manually specify the short file name.
4763 </xs:documentation>
4764 </xs:annotation>
4765 </xs:attribute>
4766 <!-- 'Attributes' column integer value generated from XML attributes below -->
4767 <xs:attribute name="ReadOnly" type="YesNoTypeUnion">
4768 <xs:annotation>
4769 <xs:documentation>Set to yes in order to have the file's read-only attribute set when it is installed on the target machine.</xs:documentation>
4770 </xs:annotation>
4771 </xs:attribute>
4772 <xs:attribute name="Hidden" type="YesNoTypeUnion">
4773 <xs:annotation>
4774 <xs:documentation>Set to yes in order to have the file's hidden attribute set when it is installed on the target machine.</xs:documentation>
4775 </xs:annotation>
4776 </xs:attribute>
4777 <xs:attribute name="System" type="YesNoTypeUnion">
4778 <xs:annotation>
4779 <xs:documentation>Set to yes in order to have the file's system attribute set when it is installed on the target machine.</xs:documentation>
4780 </xs:annotation>
4781 </xs:attribute>
4782 <xs:attribute name="Vital" type="YesNoTypeUnion">
4783 <xs:annotation>
4784 <xs:documentation>If a file is vital, then installation cannot proceed unless the file is successfully installed. The user will have no option to ignore an error installing this file. If an error occurs, they can merely retry to install the file or abort the installation. The default is "yes," unless the -sfdvital switch (candle.exe) or SuppressFileDefaultVital property (.wixproj) is used.</xs:documentation>
4785 </xs:annotation>
4786 </xs:attribute>
4787 <xs:attribute name="Checksum" type="YesNoTypeUnion">
4788 <xs:annotation>
4789 <xs:documentation>This attribute should be set to "yes" for every executable file in the installation that has a valid checksum stored in the Portable Executable (PE) file header. Only those files that have this attribute set will be verified for valid checksum during a reinstall.</xs:documentation>
4790 </xs:annotation>
4791 </xs:attribute>
4792 <xs:attribute name="Compressed" type="YesNoDefaultTypeUnion">
4793 <xs:annotation>
4794 <xs:documentation>Sets the file's source type compression. A setting of "yes" or "no" will override the setting in the Word Count Summary Property.</xs:documentation>
4795 </xs:annotation>
4796 </xs:attribute>
4797 <xs:attribute name="BindPath" type="xs:string">
4798 <xs:annotation>
4799 <xs:documentation>A list of paths, separated by semicolons, that represent the paths to be searched to find the imported DLLs. The list is usually a list of properties, with each property enclosed inside square brackets. The value may be set to an empty string. Including this attribute will cause an entry to be generated for the file in the BindImage table.</xs:documentation>
4800 </xs:annotation>
4801 </xs:attribute>
4802 <xs:attribute name="SelfRegCost" type="xs:integer">
4803 <xs:annotation>
4804 <xs:documentation>The cost of registering the file in bytes. This must be a non-negative number. Including this attribute will cause an entry to be generated for the file in the SelfReg table.</xs:documentation>
4805 </xs:annotation>
4806 </xs:attribute>
4807 <xs:attribute name="TrueType" type="YesNoTypeUnion">
4808 <xs:annotation>
4809 <xs:documentation>Causes an entry to be generated for the file in the Font table with no FontTitle specified. This attribute is intended to be used to register the file as a TrueType font.</xs:documentation>
4810 </xs:annotation>
4811 </xs:attribute>
4812 <xs:attribute name="FontTitle" type="xs:string">
4813 <xs:annotation>
4814 <xs:documentation>Causes an entry to be generated for the file in the Font table with the specified FontTitle. This attribute is intended to be used to register the file as a non-TrueType font.</xs:documentation>
4815 </xs:annotation>
4816 </xs:attribute>
4817 <xs:attribute name="DefaultLanguage" type="xs:string">
4818 <xs:annotation>
4819 <xs:documentation>This is the default language of this file. The linker will replace this value from the value in the file if the suppress files option is not used.</xs:documentation>
4820 </xs:annotation>
4821 </xs:attribute>
4822 <xs:attribute name="DefaultSize" type="xs:integer">
4823 <xs:annotation>
4824 <xs:documentation>This is the default size of this file. The linker will replace this value from the value in the file if the suppress files option is not used.</xs:documentation>
4825 </xs:annotation>
4826 </xs:attribute>
4827 <xs:attribute name="DefaultVersion" type="xs:string">
4828 <xs:annotation>
4829 <xs:documentation>This is the default version of this file. The linker will replace this value from the value in the file if the suppress files option is not used.</xs:documentation>
4830 </xs:annotation>
4831 </xs:attribute>
4832 <!-- assembly information -->
4833 <xs:attribute name="Assembly">
4834 <xs:annotation>
4835 <xs:documentation>
4836 Specifies if this File is a Win32 Assembly or .NET Assembly that needs to be installed into the
4837 Global Assembly Cache (GAC). If the value is '.net' or 'win32', this file must also be the key path of the Component.
4838 </xs:documentation>
4839 </xs:annotation>
4840 <xs:simpleType>
4841 <xs:restriction base="xs:NMTOKEN">
4842 <xs:enumeration value=".net">
4843 <xs:annotation>
4844 <xs:documentation>
4845 The file is a .NET Framework assembly.
4846 </xs:documentation>
4847 </xs:annotation>
4848 </xs:enumeration>
4849 <xs:enumeration value="no">
4850 <xs:annotation>
4851 <xs:documentation>
4852 The file is not a .NET Framework or Win32 assembly. This is the default value.
4853 </xs:documentation>
4854 </xs:annotation>
4855 </xs:enumeration>
4856 <xs:enumeration value="win32">
4857 <xs:annotation>
4858 <xs:documentation>
4859 The file is a Win32 assembly.
4860 </xs:documentation>
4861 </xs:annotation>
4862 </xs:enumeration>
4863 </xs:restriction>
4864 </xs:simpleType>
4865 </xs:attribute>
4866 <xs:attribute name="AssemblyManifest" type="xs:string">
4867 <xs:annotation>
4868 <xs:documentation>
4869 Specifies the file identifier of the manifest file that describes this assembly.
4870 The manifest file should be in the same component as the assembly it describes.
4871 This attribute may only be specified if the Assembly attribute is set to '.net' or 'win32'.
4872 </xs:documentation>
4873 </xs:annotation>
4874 </xs:attribute>
4875 <xs:attribute name="AssemblyApplication" type="xs:string">
4876 <xs:annotation>
4877 <xs:documentation>
4878 Specifies the file identifier of the application file. This assembly will be isolated
4879 to the same directory as the application file.
4880 If this attribute is absent, the assembly will be installed to the Global Assembly Cache (GAC).
4881 This attribute may only be specified if the Assembly attribute is set to '.net' or 'win32'.
4882 </xs:documentation>
4883 </xs:annotation>
4884 </xs:attribute>
4885 <xs:attribute name="ProcessorArchitecture">
4886 <xs:annotation>
4887 <xs:documentation>Specifies the architecture for this assembly. This attribute should only be used on .NET Framework 2.0 or higher assemblies.</xs:documentation>
4888 </xs:annotation>
4889 <xs:simpleType>
4890 <xs:restriction base="xs:NMTOKEN">
4891 <xs:enumeration value="msil">
4892 <xs:annotation>
4893 <xs:documentation>
4894 The file is a .NET Framework assembly that is processor-neutral.
4895 </xs:documentation>
4896 </xs:annotation>
4897 </xs:enumeration>
4898 <xs:enumeration value="x86">
4899 <xs:annotation>
4900 <xs:documentation>
4901 The file is a .NET Framework assembly for the x86 processor.
4902 </xs:documentation>
4903 </xs:annotation>
4904 </xs:enumeration>
4905 <xs:enumeration value="x64">
4906 <xs:annotation>
4907 <xs:documentation>
4908 The file is a .NET Framework assembly for the x64 processor.
4909 </xs:documentation>
4910 </xs:annotation>
4911 </xs:enumeration>
4912 <xs:enumeration value="ia64">
4913 <xs:annotation>
4914 <xs:documentation>
4915 The file is a .NET Framework assembly for the ia64 processor.
4916 </xs:documentation>
4917 </xs:annotation>
4918 </xs:enumeration>
4919 </xs:restriction>
4920 </xs:simpleType>
4921 </xs:attribute>
4922 <xs:attribute name="DiskId" type="DiskIdType">
4923 <xs:annotation>
4924 <xs:documentation>
4925 The value of this attribute should correspond to the Id attribute of a Media
4926 element authored elsewhere. By creating this connection between a file and
4927 its media, you set the packaging options to the values specified in the Media
4928 element (values such as compression level, cab embedding, etc...). Specifying
4929 the DiskId attribute on the File element overrides the default DiskId attribute
4930 from the parent Component element. If no DiskId attribute is specified,
4931 the default is "1". This DiskId attribute is ignored when creating a merge module
4932 because merge modules do not have media.
4933 </xs:documentation>
4934 </xs:annotation>
4935 </xs:attribute>
4936 <xs:attribute name="Source" type="xs:string">
4937 <xs:annotation>
4938 <xs:documentation>Specifies the path to the File in the build process. Overrides default source path set by parent directories and Name attribute. This attribute must be set if no source information can be gathered from parent directories. For more information, see <html:a href="~/howtos/general/specifying_source_files.html">Specifying source files</html:a>.</xs:documentation>
4939 </xs:annotation>
4940 </xs:attribute>
4941 <xs:attribute name="src" type="xs:string">
4942 <xs:annotation>
4943 <xs:appinfo>
4944 <xse:deprecated ref="Source" />
4945 </xs:appinfo>
4946 </xs:annotation>
4947 </xs:attribute>
4948 <xs:attribute name="PatchGroup" type="xs:integer">
4949 <xs:annotation>
4950 <xs:documentation>
4951 This attribute must be set for patch-added files. Each patch should be assigned a different patch group number. Patch groups
4952 numbers must be greater 0 and should be assigned consecutively. For example, the first patch should use PatchGroup='1', the
4953 second patch will have PatchGroup='2', etc...
4954 </xs:documentation>
4955 </xs:annotation>
4956 </xs:attribute>
4957 <xs:attribute name="PatchIgnore" type="YesNoTypeUnion">
4958 <xs:annotation>
4959 <xs:documentation>Prevents the updating of the file that is in fact changed in the upgraded image relative to the target images.</xs:documentation>
4960 </xs:annotation>
4961 </xs:attribute>
4962 <xs:attribute name="PatchAllowIgnoreOnError" type="YesNoTypeUnion">
4963 <xs:annotation>
4964 <xs:documentation>Set to indicate that the patch is non-vital.</xs:documentation>
4965 </xs:annotation>
4966 </xs:attribute>
4967 <xs:attribute name="PatchWholeFile" type="YesNoTypeUnion">
4968 <xs:annotation>
4969 <xs:documentation>Set if the entire file should be installed rather than creating a binary patch.</xs:documentation>
4970 </xs:annotation>
4971 </xs:attribute>
4972 <xs:anyAttribute namespace="##other" processContents="lax">
4973 <xs:annotation>
4974 <xs:documentation>
4975 Extensibility point in the WiX XML Schema. Schema extensions can register additional
4976 attributes at this point in the schema.
4977 </xs:documentation>
4978 </xs:annotation>
4979 </xs:anyAttribute>
4980 </xs:complexType>
4981 </xs:element>
4982 <xs:element name="MultiStringValue">
4983 <xs:annotation>
4984 <xs:documentation>
4985 Use several of these elements to specify each registry value in a multiString registry value. This element
4986 cannot be used if the Value attribute is specified unless the Type attribute is set to 'multiString'. The
4987 values should go in the text area of the MultiStringValue element.
4988 </xs:documentation>
4989 <xs:appinfo>
4990 <xse:msiRef table="Registry" href="http://msdn.microsoft.com/library/aa371168.aspx" />
4991 </xs:appinfo>
4992 </xs:annotation>
4993 </xs:element>
4994 <xs:element name="RegistryKey">
4995 <xs:annotation>
4996 <xs:documentation>
4997 Used for organization of child RegistryValue elements or to create a registry key
4998 (and optionally remove it during uninstallation).
4999 </xs:documentation>
5000 <xs:appinfo>
5001 <xse:msiRef table="Registry" href="http://msdn.microsoft.com/library/aa371168.aspx" />
5002 <xse:howtoRef href="files_and_registry/read_a_registry_entry.html">How To: Read a registry entry during installation</xse:howtoRef>
5003 <xse:howtoRef href="files_and_registry/write_a_registry_entry.html">How To: Write a registry entry during installation</xse:howtoRef>
5004 </xs:appinfo>
5005 </xs:annotation>
5006 <xs:complexType>
5007 <xs:choice minOccurs="0" maxOccurs="unbounded">
5008 <xs:element ref="RegistryKey" />
5009 <xs:element ref="RegistryValue" />
5010 <xs:element ref="Permission" minOccurs="0" maxOccurs="unbounded">
5011 <xs:annotation>
5012 <xs:documentation>ACL permission</xs:documentation>
5013 </xs:annotation>
5014 </xs:element>
5015 <xs:element ref="PermissionEx">
5016 <xs:annotation>
5017 <xs:documentation>Can also configure the ACLs for this registry key.</xs:documentation>
5018 </xs:annotation>
5019 </xs:element>
5020 <xs:any namespace="##other" processContents="lax">
5021 <xs:annotation>
5022 <xs:documentation>
5023 Extensibility point in the WiX XML Schema. Schema extensions can register additional
5024 elements at this point in the schema.
5025 </xs:documentation>
5026 </xs:annotation>
5027 </xs:any>
5028 </xs:choice>
5029 <xs:attribute name="Id" type="xs:string">
5030 <xs:annotation>
5031 <xs:documentation>
5032 Primary key used to identify this particular entry. If this attribute is not specified, an identifier will be
5033 generated by hashing the parent Component identifier, Root, Key, and Name.
5034 </xs:documentation>
5035 </xs:annotation>
5036 </xs:attribute>
5037 <xs:attribute name="Action">
5038 <xs:annotation>
5039 <xs:documentation>
5040 The Action attribute has been deprecated. In most cases, you can simply omit @Action. If you need to force Windows Installer
5041 to create an empty key or recursively delete the key, use the ForceCreateOnInstall or ForceDeleteOnUninstall attributes instead.
5042 </xs:documentation>
5043 </xs:annotation>
5044 <xs:simpleType>
5045 <xs:restriction base="xs:NMTOKEN">
5046 <xs:enumeration value="create">
5047 <xs:annotation>
5048 <xs:documentation>
5049 Creates the key, if absent, when the parent component is installed.
5050 </xs:documentation>
5051 </xs:annotation>
5052 </xs:enumeration>
5053 <xs:enumeration value="createAndRemoveOnUninstall">
5054 <xs:annotation>
5055 <xs:documentation>
5056 Creates the key, if absent, when the parent component is installed then remove the key with all its values and subkeys when the parent component is uninstalled.
5057 Note that this value is useful only if your program creates additional values or subkeys under this key and you want an uninstall to remove them. MSI already
5058 removes all values and subkeys that it creates, so this option just adds additional overhead to uninstall.
5059 </xs:documentation>
5060 </xs:annotation>
5061 </xs:enumeration>
5062 <xs:enumeration value="none">
5063 <xs:annotation>
5064 <xs:documentation>
5065 Does nothing; this element is used merely in WiX authoring for organization and does nothing to the final output.
5066 This is the default value.
5067 </xs:documentation>
5068 </xs:annotation>
5069 </xs:enumeration>
5070 </xs:restriction>
5071 </xs:simpleType>
5072 </xs:attribute>
5073 <xs:attribute name="ForceCreateOnInstall" type="YesNoTypeUnion">
5074 <xs:annotation>
5075 <xs:documentation>
5076 Set this attribute to 'yes' to create an empty key, if absent, when the parent component is installed.
5077 This value is needed only to create an empty key with no subkeys or values. Windows Installer creates
5078 keys as needed to store subkeys and values. The default is "no".
5079 </xs:documentation>
5080 </xs:annotation>
5081 </xs:attribute>
5082 <xs:attribute name="ForceDeleteOnUninstall" type="YesNoTypeUnion">
5083 <xs:annotation>
5084 <xs:documentation>
5085 Set this attribute to 'yes' to remove the key with all its values and subkeys when the parent component is uninstalled.
5086 Note that this value is useful only if your program creates additional values or subkeys under this key and you want an uninstall to remove them. MSI already
5087 removes all values and subkeys that it creates, so this option just adds additional overhead to uninstall.
5088 The default is "no".
5089 </xs:documentation>
5090 </xs:annotation>
5091 </xs:attribute>
5092 <xs:attribute name="Key" type="xs:string">
5093 <xs:annotation>
5094 <xs:documentation>
5095 The localizable key for the registry value.
5096 If the parent element is a RegistryKey, this value may be omitted to use the
5097 path of the parent, or if its specified it will be appended to the path of the parent.
5098 </xs:documentation>
5099 </xs:annotation>
5100 </xs:attribute>
5101 <xs:attribute name="Root" type="RegistryRootType">
5102 <xs:annotation>
5103 <xs:documentation>
5104 The predefined root key for the registry value.
5105 </xs:documentation>
5106 </xs:annotation>
5107 </xs:attribute>
5108 </xs:complexType>
5109 </xs:element>
5110 <xs:element name="RegistryValue">
5111 <xs:annotation>
5112 <xs:documentation>
5113 Used to create a registry value. For multi-string values, this can be used to prepend or append values.
5114
5115 For legacy authoring: Use several of these elements to specify each registry value in a multiString registry value. This element
5116 cannot be used if the Value attribute is specified unless the Type attribute is set to 'multiString'. The
5117 values should go in the text area of the RegistryValue element.
5118 </xs:documentation>
5119 <xs:appinfo>
5120 <xse:msiRef table="Registry" href="http://msdn.microsoft.com/library/aa371168.aspx" />
5121 <xse:howtoRef href="files_and_registry/write_a_registry_entry.html">How To: Write a registry entry during installation</xse:howtoRef>
5122 </xs:appinfo>
5123 </xs:annotation>
5124 <xs:complexType mixed="true">
5125 <xs:choice minOccurs="0" maxOccurs="unbounded">
5126 <xs:element ref="Permission" />
5127 <xs:element ref="PermissionEx">
5128 <xs:annotation>
5129 <xs:documentation>Can also configure the ACLs for this registry value.</xs:documentation>
5130 </xs:annotation>
5131 </xs:element>
5132 <xs:element ref="MultiStringValue" />
5133 <xs:any namespace="##other" processContents="lax">
5134 <xs:annotation>
5135 <xs:documentation>
5136 Extensibility point in the WiX XML Schema. Schema extensions can register additional
5137 elements at this point in the schema.
5138 </xs:documentation>
5139 </xs:annotation>
5140 </xs:any>
5141 </xs:choice>
5142 <xs:attribute name="Id" type="xs:string">
5143 <xs:annotation>
5144 <xs:documentation>
5145 Primary key used to identify this particular entry. If this attribute is not specified, an identifier will be
5146 generated by hashing the parent Component identifier, Root, Key, and Name.
5147 </xs:documentation>
5148 </xs:annotation>
5149 </xs:attribute>
5150 <xs:attribute name="Root" type="RegistryRootType">
5151 <xs:annotation>
5152 <xs:documentation>
5153 The predefined root key for the registry value.
5154 </xs:documentation>
5155 </xs:annotation>
5156 </xs:attribute>
5157 <xs:attribute name="Key" type="xs:string">
5158 <xs:annotation>
5159 <xs:documentation>
5160 The localizable key for the registry value.
5161 If the parent element is a RegistryKey, this value may be omitted to use the
5162 path of the parent, or if its specified it will be appended to the path of the parent.
5163 </xs:documentation>
5164 </xs:annotation>
5165 </xs:attribute>
5166 <xs:attribute name="Name" type="xs:string">
5167 <xs:annotation>
5168 <xs:documentation>
5169 The localizable registry value name. If this attribute is not provided the default value for the registry key will
5170 be set instead. The Windows Installer allows several special values to be set for this attribute. You should not
5171 use them in WiX. Instead use appropriate values in the Action attribute to get the desired behavior.
5172 </xs:documentation>
5173 </xs:annotation>
5174 </xs:attribute>
5175 <xs:attribute name="Value" type="xs:string">
5176 <xs:annotation>
5177 <xs:documentation>
5178 Set this attribute to the localizable registry value. This value is formatted. The Windows Installer allows
5179 several special values to be set for this attribute. You should not use them in WiX. Instead use appropriate
5180 values in the Type attribute to get the desired behavior.
5181 </xs:documentation>
5182 </xs:annotation>
5183 </xs:attribute>
5184 <!-- unfortunately, this attribute cannot yet be set to required due to backwards-compatibility, once the Registry element is removed, this should be required -->
5185 <xs:attribute name="Type">
5186 <xs:annotation>
5187 <xs:documentation>
5188 Set this attribute to the type of the desired registry key. This attribute must be specified whenever the Value
5189 attribute or a child RegistryValue element is specified. This attribute
5190 should only be set when the value of the Action attribute does not include the word 'remove'.
5191 </xs:documentation>
5192 </xs:annotation>
5193 <xs:simpleType>
5194 <xs:restriction base="xs:NMTOKEN">
5195 <xs:enumeration value="string">
5196 <xs:annotation>
5197 <xs:documentation>
5198 The value is interpreted and stored as a string (REG_SZ).
5199 </xs:documentation>
5200 </xs:annotation>
5201 </xs:enumeration>
5202 <xs:enumeration value="integer">
5203 <xs:annotation>
5204 <xs:documentation>
5205 The value is interpreted and stored as an integer (REG_DWORD).
5206 </xs:documentation>
5207 </xs:annotation>
5208 </xs:enumeration>
5209 <xs:enumeration value="binary">
5210 <xs:annotation>
5211 <xs:documentation>
5212 The value is interpreted and stored as a hexadecimal value (REG_BINARY).
5213 </xs:documentation>
5214 </xs:annotation>
5215 </xs:enumeration>
5216 <xs:enumeration value="expandable">
5217 <xs:annotation>
5218 <xs:documentation>
5219 The value is interpreted and stored as an expandable string (REG_EXPAND_SZ).
5220 </xs:documentation>
5221 </xs:annotation>
5222 </xs:enumeration>
5223 <xs:enumeration value="multiString">
5224 <xs:annotation>
5225 <xs:documentation>
5226 The value is interpreted and stored as a multiple strings (REG_MULTI_SZ).
5227 Please note that this value will only result in a multi-string value if there is more than one registry value
5228 or the Action attribute's value is 'append' or 'prepend'. Otherwise a string value will be created.
5229 </xs:documentation>
5230 </xs:annotation>
5231 </xs:enumeration>
5232 </xs:restriction>
5233 </xs:simpleType>
5234 </xs:attribute>
5235 <xs:attribute name="Action">
5236 <xs:annotation>
5237 <xs:documentation>
5238 This is the action that will be taken for this registry value.
5239 </xs:documentation>
5240 </xs:annotation>
5241 <xs:simpleType>
5242 <xs:restriction base="xs:NMTOKEN">
5243 <xs:enumeration value="append">
5244 <xs:annotation>
5245 <xs:documentation>
5246 Appends the specified value(s) to a multiString registry value.
5247 </xs:documentation>
5248 </xs:annotation>
5249 </xs:enumeration>
5250 <xs:enumeration value="prepend">
5251 <xs:annotation>
5252 <xs:documentation>
5253 Prepends the specified value(s) to a multiString registry value.
5254 </xs:documentation>
5255 </xs:annotation>
5256 </xs:enumeration>
5257 <xs:enumeration value="write">
5258 <xs:annotation>
5259 <xs:documentation>
5260 Writes a registry value. This is the default value.
5261 </xs:documentation>
5262 </xs:annotation>
5263 </xs:enumeration>
5264 </xs:restriction>
5265 </xs:simpleType>
5266 </xs:attribute>
5267 <xs:attribute name="KeyPath" type="YesNoTypeUnion">
5268 <xs:annotation>
5269 <xs:documentation>
5270 Set this attribute to 'yes' to make this registry key the KeyPath of the parent component.
5271 Only one resource (registry, file, etc) can be the KeyPath of a component.
5272 </xs:documentation>
5273 </xs:annotation>
5274 </xs:attribute>
5275 </xs:complexType>
5276 </xs:element>
5277 <xs:element name="RemoveRegistryKey">
5278 <xs:annotation>
5279 <xs:documentation>
5280 Used for removing registry keys and all child keys either during install or uninstall.
5281 </xs:documentation>
5282 <xs:appinfo>
5283 <xse:msiRef table="Registry" href="http://msdn.microsoft.com/library/aa371168.aspx" />
5284 <xse:msiRef table="RemoveRegistry" href="http://msdn.microsoft.com/library/aa371208.aspx" />
5285 </xs:appinfo>
5286 </xs:annotation>
5287 <xs:complexType>
5288 <xs:attribute name="Id" type="xs:string">
5289 <xs:annotation>
5290 <xs:documentation>
5291 Primary key used to identify this particular entry. If this attribute is not specified, an identifier will be
5292 generated by hashing the parent Component identifier, Root, Key, and Name.
5293 </xs:documentation>
5294 </xs:annotation>
5295 </xs:attribute>
5296 <xs:attribute name="Action">
5297 <xs:annotation>
5298 <xs:documentation>
5299 This is the action that will be taken for this registry value.
5300 </xs:documentation>
5301 </xs:annotation>
5302 <xs:simpleType>
5303 <xs:restriction base="xs:NMTOKEN">
5304 <xs:enumeration value="removeOnInstall">
5305 <xs:annotation>
5306 <xs:documentation>
5307 Removes a key with all its values and subkeys when the parent component is installed.
5308 </xs:documentation>
5309 </xs:annotation>
5310 </xs:enumeration>
5311 <xs:enumeration value="removeOnUninstall">
5312 <xs:annotation>
5313 <xs:documentation>
5314 Removes a key with all its values and subkeys when the parent component is uninstalled.
5315 </xs:documentation>
5316 </xs:annotation>
5317 </xs:enumeration>
5318 </xs:restriction>
5319 </xs:simpleType>
5320 </xs:attribute>
5321 <xs:attribute name="Key" type="xs:string">
5322 <xs:annotation>
5323 <xs:documentation>
5324 The localizable key for the registry value.
5325 </xs:documentation>
5326 </xs:annotation>
5327 </xs:attribute>
5328 <xs:attribute name="Root" type="RegistryRootType">
5329 <xs:annotation>
5330 <xs:documentation>
5331 The predefined root key for the registry value.
5332 </xs:documentation>
5333 </xs:annotation>
5334 </xs:attribute>
5335 </xs:complexType>
5336 </xs:element>
5337 <xs:element name="RemoveRegistryValue">
5338 <xs:annotation>
5339 <xs:documentation>
5340 Used to remove a registry value during installation.
5341 There is no standard way to remove a single registry value during uninstall (but you can remove an entire key with RemoveRegistryKey).
5342 </xs:documentation>
5343 <xs:appinfo>
5344 <xse:msiRef table="RemoveRegistry" href="http://msdn.microsoft.com/library/aa371208.aspx" />
5345 </xs:appinfo>
5346 </xs:annotation>
5347 <xs:complexType>
5348 <xs:attribute name="Id" type="xs:string">
5349 <xs:annotation>
5350 <xs:documentation>
5351 Primary key used to identify this particular entry. If this attribute is not specified, an identifier will be
5352 generated by hashing the parent Component identifier, Root, Key, and Name.
5353 </xs:documentation>
5354 </xs:annotation>
5355 </xs:attribute>
5356 <xs:attribute name="Key" type="xs:string">
5357 <xs:annotation>
5358 <xs:documentation>
5359 The localizable key for the registry value.
5360 If the parent element is a RegistryKey, this value may be omitted to use the
5361 path of the parent, or if its specified it will be appended to the path of the parent.
5362 </xs:documentation>
5363 </xs:annotation>
5364 </xs:attribute>
5365 <xs:attribute name="Name" type="xs:string">
5366 <xs:annotation>
5367 <xs:documentation>
5368 The localizable registry value name. If this attribute is not provided the default value for the registry key will
5369 be set instead. The Windows Installer allows several special values to be set for this attribute. You should not
5370 use them in WiX. Instead use appropriate values in the Action attribute to get the desired behavior.
5371 </xs:documentation>
5372 </xs:annotation>
5373 </xs:attribute>
5374 <xs:attribute name="Root" type="RegistryRootType">
5375 <xs:annotation>
5376 <xs:documentation>
5377 The predefined root key for the registry value.
5378 </xs:documentation>
5379 </xs:annotation>
5380 </xs:attribute>
5381 </xs:complexType>
5382 </xs:element>
5383 <xs:element name="Registry">
5384 <xs:annotation>
5385 <xs:appinfo>
5386 <xse:msiRef table="Registry" href="http://msdn.microsoft.com/library/aa371168.aspx" />
5387 <xse:deprecated ref="RegistryValue" />
5388 </xs:appinfo>
5389 </xs:annotation>
5390 <xs:complexType>
5391 <xs:choice minOccurs="0" maxOccurs="unbounded">
5392 <xs:element ref="Permission" />
5393 <xs:element ref="PermissionEx">
5394 <xs:annotation>
5395 <xs:documentation>Can also configure the ACLs for this registry key.</xs:documentation>
5396 </xs:annotation>
5397 </xs:element>
5398 <xs:element ref="RegistryValue" />
5399 <xs:element ref="Registry" />
5400 <xs:any namespace="##other" processContents="lax">
5401 <xs:annotation>
5402 <xs:documentation>
5403 Extensibility point in the WiX XML Schema. Schema extensions can register additional
5404 elements at this point in the schema.
5405 </xs:documentation>
5406 </xs:annotation>
5407 </xs:any>
5408 </xs:choice>
5409 <xs:attribute name="Id" type="xs:string">
5410 <xs:annotation>
5411 <xs:documentation>
5412 Primary key used to identify this particular entry. If this attribute is not specified, an identifier will be
5413 generated by hashing the parent Component identifier, Root, Key, and Name.
5414 </xs:documentation>
5415 </xs:annotation>
5416 </xs:attribute>
5417 <xs:attribute name="Action">
5418 <xs:annotation>
5419 <xs:documentation>
5420 This is the action that will be taken for this registry key.
5421 </xs:documentation>
5422 </xs:annotation>
5423 <xs:simpleType>
5424 <xs:restriction base="xs:NMTOKEN">
5425 <xs:enumeration value="append">
5426 <xs:annotation>
5427 <xs:documentation>
5428 Appends the specified value(s) to a multiString registry key.
5429 </xs:documentation>
5430 </xs:annotation>
5431 </xs:enumeration>
5432 <xs:enumeration value="createKey">
5433 <xs:annotation>
5434 <xs:documentation>
5435 Creates the key, if absent, when the parent component is installed.
5436 </xs:documentation>
5437 </xs:annotation>
5438 </xs:enumeration>
5439 <xs:enumeration value="createKeyAndRemoveKeyOnUninstall">
5440 <xs:annotation>
5441 <xs:documentation>
5442 Creates the key, if absent, when the parent component is installed then remove the key with all its values and subkeys when the parent component is uninstalled.
5443 </xs:documentation>
5444 </xs:annotation>
5445 </xs:enumeration>
5446 <xs:enumeration value="prepend">
5447 <xs:annotation>
5448 <xs:documentation>
5449 Prepends the specified value(s) to a multiString registry key.
5450 </xs:documentation>
5451 </xs:annotation>
5452 </xs:enumeration>
5453 <xs:enumeration value="remove">
5454 <xs:annotation>
5455 <xs:documentation>
5456 Removes a registry name when the parent component is installed.
5457 </xs:documentation>
5458 </xs:annotation>
5459 </xs:enumeration>
5460 <xs:enumeration value="removeKeyOnInstall">
5461 <xs:annotation>
5462 <xs:documentation>
5463 Removes a key with all its values and subkeys when the parent component is installed.
5464 </xs:documentation>
5465 </xs:annotation>
5466 </xs:enumeration>
5467 <xs:enumeration value="removeKeyOnUninstall">
5468 <xs:annotation>
5469 <xs:documentation>
5470 Removes a key with all its values and subkeys when the parent component is uninstalled.
5471 </xs:documentation>
5472 </xs:annotation>
5473 </xs:enumeration>
5474 <xs:enumeration value="write">
5475 <xs:annotation>
5476 <xs:documentation>
5477 Writes a registry value.
5478 </xs:documentation>
5479 </xs:annotation>
5480 </xs:enumeration>
5481 </xs:restriction>
5482 </xs:simpleType>
5483 </xs:attribute>
5484 <xs:attribute name="Key" type="xs:string">
5485 <xs:annotation>
5486 <xs:documentation>The localizable key for the registry value.</xs:documentation>
5487 </xs:annotation>
5488 </xs:attribute>
5489 <xs:attribute name="KeyPath" type="YesNoTypeUnion">
5490 <xs:annotation>
5491 <xs:documentation>
5492 Set this attribute to 'yes' to make this registry key the KeyPath of the parent component. Only one resource (registry,
5493 file, etc) can be the KeyPath of a component.
5494 </xs:documentation>
5495 </xs:annotation>
5496 </xs:attribute>
5497 <xs:attribute name="Name" type="xs:string">
5498 <xs:annotation>
5499 <xs:documentation>
5500 The localizable registry value name. If this attribute is not provided the default value for the registry key will
5501 be set instead. The Windows Installer allows several special values to be set for this attribute. You should not
5502 use them in WiX. Instead use appropriate values in the Action attribute to get the desired behavior.
5503 </xs:documentation>
5504 </xs:annotation>
5505 </xs:attribute>
5506 <xs:attribute name="Root" type="RegistryRootType">
5507 <xs:annotation>
5508 <xs:documentation>
5509 The predefined root key for the registry value.
5510 </xs:documentation>
5511 </xs:annotation>
5512 </xs:attribute>
5513 <xs:attribute name="Type">
5514 <xs:annotation>
5515 <xs:documentation>
5516 Set this attribute to the type of the desired registry key. This attribute must be specified whenever the Value
5517 attribute or a child RegistryValue element is specified. This attribute
5518 should only be set when the value of the Action attribute does not include the word 'remove'.
5519 </xs:documentation>
5520 </xs:annotation>
5521 <xs:simpleType>
5522 <xs:restriction base="xs:NMTOKEN">
5523 <xs:enumeration value="string">
5524 <xs:annotation>
5525 <xs:documentation>
5526 The value is interpreted and stored as a string (REG_SZ).
5527 </xs:documentation>
5528 </xs:annotation>
5529 </xs:enumeration>
5530 <xs:enumeration value="integer">
5531 <xs:annotation>
5532 <xs:documentation>
5533 The value is interpreted and stored as an integer (REG_DWORD).
5534 </xs:documentation>
5535 </xs:annotation>
5536 </xs:enumeration>
5537 <xs:enumeration value="binary">
5538 <xs:annotation>
5539 <xs:documentation>
5540 The value is interpreted and stored as a hexadecimal value (REG_BINARY).
5541 </xs:documentation>
5542 </xs:annotation>
5543 </xs:enumeration>
5544 <xs:enumeration value="expandable">
5545 <xs:annotation>
5546 <xs:documentation>
5547 The value is interpreted and stored as an expandable string (REG_EXPAND_SZ).
5548 </xs:documentation>
5549 </xs:annotation>
5550 </xs:enumeration>
5551 <xs:enumeration value="multiString">
5552 <xs:annotation>
5553 <xs:documentation>
5554 The value is interpreted and stored as a multiple strings (REG_MULTI_SZ).
5555 Please note that this value will only result in a multi-string value if there is more than one registry value
5556 or the Action attribute's value is 'append' or 'prepend'. Otherwise a string value will be created.
5557 </xs:documentation>
5558 </xs:annotation>
5559 </xs:enumeration>
5560 </xs:restriction>
5561 </xs:simpleType>
5562 </xs:attribute>
5563 <xs:attribute name="Value" type="xs:string">
5564 <xs:annotation>
5565 <xs:documentation>
5566 Set this attribute to the localizable registry value. This value is formatted. The Windows Installer allows
5567 several special values to be set for this attribute. You should not use them in WiX. Instead use appropriate
5568 values in the Type attribute to get the desired behavior. This attribute cannot be specified if the Action
5569 attribute's value contains the word 'remove'.
5570 </xs:documentation>
5571 </xs:annotation>
5572 </xs:attribute>
5573 </xs:complexType>
5574 </xs:element>
5575 <xs:element name="RemoveFile">
5576 <xs:annotation>
5577 <xs:appinfo>
5578 <xse:seeAlso ref="CopyFile" />
5579 <xse:msiRef table="RemoveFile" href="http://msdn.microsoft.com/library/aa371201.aspx" />
5580 </xs:appinfo>
5581 <xs:documentation>
5582 Remove a file(s) if the parent component is selected for installation or removal. Multiple files can be removed
5583 by specifying a wildcard for the value of the Name attribute. By default, the source
5584 directory of the file is the directory of the parent component. This can be overridden by specifying the
5585 Directory attribute with a value corresponding to the Id of the source directory, or by specifying the Property
5586 attribute with a value corresponding to a property that will have a value that resolves to the full path
5587 to the source directory.
5588 </xs:documentation>
5589 </xs:annotation>
5590 <xs:complexType>
5591 <xs:attribute name="Id" type="xs:string" use="required">
5592 <xs:annotation>
5593 <xs:documentation>Primary key used to identify this particular entry.</xs:documentation>
5594 </xs:annotation>
5595 </xs:attribute>
5596 <xs:attribute name="Directory" type="xs:string">
5597 <xs:annotation>
5598 <xs:documentation>
5599 Overrides the directory of the parent component with a specific Directory. This Directory must exist in the
5600 installer database at creation time. This attribute cannot be specified in conjunction with the Property attribute.
5601 </xs:documentation>
5602 </xs:annotation>
5603 </xs:attribute>
5604 <xs:attribute name="Property" type="xs:string">
5605 <xs:annotation>
5606 <xs:documentation>
5607 Overrides the directory of the parent component with the value of the specified property. The property
5608 should have a value that resolves to the full path of the source directory. The property does not have
5609 to exist in the installer database at creation time; it could be created at installation time by a custom
5610 action, on the command line, etc. This attribute cannot be specified in conjunction with the Directory attribute.
5611 </xs:documentation>
5612 </xs:annotation>
5613 </xs:attribute>
5614 <xs:attribute name="Name" type="WildCardLongFileNameType" use="required">
5615 <xs:annotation>
5616 <xs:documentation>
5617 This value should be set to the localizable name of the file(s) to be removed. All of the files that
5618 match the wild card will be removed from the specified directory. The value is a filename that may also
5619 contain the wild card characters "?" for any single character or "*" for zero or more occurrences of any character.
5620 In prior versions of the WiX toolset, this attribute specified the short file name.
5621 This attribute's value may now be either a short or long file name.
5622 If a short file name is specified, the ShortName attribute may not be specified.
5623 Also, if this value is a long file name, the ShortName attribute may be omitted to
5624 allow WiX to attempt to generate a unique short file name.
5625 However, if you wish to manually specify the short file name, then the ShortName attribute may be specified.
5626 </xs:documentation>
5627 </xs:annotation>
5628 </xs:attribute>
5629 <xs:attribute name="ShortName" type="WildCardShortFileNameType">
5630 <xs:annotation>
5631 <xs:documentation>
5632 The short file name of the file in 8.3 format.
5633 This attribute should only be set if you want to manually specify the short file name.
5634 </xs:documentation>
5635 </xs:annotation>
5636 </xs:attribute>
5637 <xs:attribute name="On" type="InstallUninstallType" use="required">
5638 <xs:annotation>
5639 <xs:documentation>
5640 This value determines the time at which the file(s) may be removed. For 'install', the file will
5641 be removed only when the parent component is being installed (msiInstallStateLocal or
5642 msiInstallStateSource); for 'uninstall', the file will be removed only when the parent component
5643 is being removed (msiInstallStateAbsent); for 'both', the file will be removed in both cases.
5644 </xs:documentation>
5645 </xs:annotation>
5646 </xs:attribute>
5647 </xs:complexType>
5648 </xs:element>
5649 <xs:element name="RemoveFolder">
5650 <xs:annotation>
5651 <xs:appinfo>
5652 <xse:seeAlso ref="CreateFolder" />
5653 <xse:msiRef table="RemoveFile" href="http://msdn.microsoft.com/library/aa371201.aspx" />
5654 </xs:appinfo>
5655 <xs:documentation>
5656 Remove an empty folder if the parent component is selected for installation or removal. By default, the folder
5657 is the directory of the parent component. This can be overridden by specifying the Directory attribute
5658 with a value corresponding to the Id of the directory, or by specifying the Property attribute with a value
5659 corresponding to a property that will have a value that resolves to the full path of the folder.
5660 </xs:documentation>
5661 </xs:annotation>
5662 <xs:complexType>
5663 <xs:attribute name="Id" type="xs:string" use="required">
5664 <xs:annotation>
5665 <xs:documentation>Primary key used to identify this particular entry.</xs:documentation>
5666 </xs:annotation>
5667 </xs:attribute>
5668 <xs:attribute name="Directory" type="xs:string">
5669 <xs:annotation>
5670 <xs:documentation>
5671 Overrides the directory of the parent component with a specific Directory. This Directory must exist in the
5672 installer database at creation time. This attribute cannot be specified in conjunction with the Property attribute.
5673 </xs:documentation>
5674 </xs:annotation>
5675 </xs:attribute>
5676 <xs:attribute name="Property" type="xs:string">
5677 <xs:annotation>
5678 <xs:documentation>
5679 Overrides the directory of the parent component with the value of the specified property. The property
5680 should have a value that resolves to the full path of the source directory. The property does not have
5681 to exist in the installer database at creation time; it could be created at installation time by a custom
5682 action, on the command line, etc. This attribute cannot be specified in conjunction with the Directory attribute.
5683 </xs:documentation>
5684 </xs:annotation>
5685 </xs:attribute>
5686 <xs:attribute name="On" type="InstallUninstallType" use="required">
5687 <xs:annotation>
5688 <xs:documentation>
5689 This value determines the time at which the folder may be removed, based on the install/uninstall of the parent component.
5690 For 'install', the folder will be removed only when the parent component is being installed (msiInstallStateLocal or
5691 msiInstallStateSource); for 'uninstall', the folder will be removed only when the parent component
5692 is being removed (msiInstallStateAbsent); for 'both', the folder will be removed in both cases.
5693 </xs:documentation>
5694 </xs:annotation>
5695 </xs:attribute>
5696 </xs:complexType>
5697 </xs:element>
5698 <xs:element name="CreateFolder">
5699 <xs:annotation>
5700 <xs:appinfo>
5701 <xse:seeAlso ref="RemoveFolder" />
5702 <xse:msiRef table="CreateFolder" href="http://msdn.microsoft.com/library/aa368053.aspx" />
5703 </xs:appinfo>
5704 <xs:documentation>Create folder as part of parent Component.</xs:documentation>
5705 </xs:annotation>
5706 <xs:complexType>
5707 <xs:choice minOccurs="0" maxOccurs="unbounded">
5708 <xs:element ref="Shortcut" minOccurs="0" maxOccurs="unbounded">
5709 <xs:annotation>
5710 <xs:documentation>Non-advertised shortcut to this folder, Shortcut Target is preset to the folder</xs:documentation>
5711 </xs:annotation>
5712 </xs:element>
5713 <xs:element ref="Permission" minOccurs="0" maxOccurs="unbounded">
5714 <xs:annotation>
5715 <xs:documentation>ACL permission</xs:documentation>
5716 </xs:annotation>
5717 </xs:element>
5718 <xs:element ref="PermissionEx">
5719 <xs:annotation>
5720 <xs:documentation>Can also configure the ACLs for this folder.</xs:documentation>
5721 </xs:annotation>
5722 </xs:element>
5723 <xs:any namespace="##other" processContents="lax">
5724 <xs:annotation>
5725 <xs:documentation>
5726 Extensibility point in the WiX XML Schema. Schema extensions can register additional
5727 elements at this point in the schema.
5728 </xs:documentation>
5729 </xs:annotation>
5730 </xs:any>
5731 </xs:choice>
5732 <xs:attribute name="Directory" type="xs:string">
5733 <xs:annotation>
5734 <xs:documentation>Identifier of Directory to create. Defaults to Directory of parent Component.</xs:documentation>
5735 </xs:annotation>
5736 </xs:attribute>
5737 </xs:complexType>
5738 </xs:element>
5739 <xs:element name="AppData" type="xs:string">
5740 <xs:annotation>
5741 <xs:documentation>Optional way for defining AppData, generally used for complex CDATA.</xs:documentation>
5742 </xs:annotation>
5743 </xs:element>
5744 <xs:element name="Category">
5745 <xs:annotation>
5746 <xs:documentation>
5747 Qualified published component for parent Component
5748 </xs:documentation>
5749 <xs:appinfo>
5750 <xse:msiRef table="PublishComponent" href="http://msdn.microsoft.com/library/aa370921.aspx" />
5751 </xs:appinfo>
5752 </xs:annotation>
5753 <xs:complexType>
5754 <xs:sequence minOccurs="0" maxOccurs="unbounded">
5755 <xs:element ref="AppData" />
5756 </xs:sequence>
5757 <xs:attribute name="Id" use="required" type="Guid">
5758 <xs:annotation>
5759 <xs:documentation>A string GUID that represents the category of components being grouped together.</xs:documentation>
5760 </xs:annotation>
5761 </xs:attribute>
5762 <xs:attribute name="Qualifier" use="required" type="xs:string">
5763 <xs:annotation>
5764 <xs:documentation>A text string that qualifies the value in the Id attribute. A qualifier is used to distinguish multiple forms of the same Component, such as a Component that is implemented in multiple languages.</xs:documentation>
5765 </xs:annotation>
5766 </xs:attribute>
5767 <xs:attribute name="AppData" type="xs:string">
5768 <xs:annotation>
5769 <xs:documentation>An optional localizable text describing the category. The string is commonly parsed by the application and can be displayed to the user. It should describe the category.</xs:documentation>
5770 </xs:annotation>
5771 </xs:attribute>
5772 <xs:attribute name="Feature" type="xs:string">
5773 <xs:annotation>
5774 <xs:documentation>Feature that controls the advertisement of the category. Defaults to the primary Feature for the parent Component .</xs:documentation>
5775 </xs:annotation>
5776 </xs:attribute>
5777 </xs:complexType>
5778 </xs:element>
5779 <xs:element name="MIME">
5780 <xs:annotation>
5781 <xs:documentation>
5782 MIME content-type for an Extension
5783 </xs:documentation>
5784 <xs:appinfo>
5785 <xse:msiRef table="MIME" href="http://msdn.microsoft.com/library/aa370035.aspx" />
5786 </xs:appinfo>
5787 </xs:annotation>
5788 <xs:complexType>
5789 <xs:attribute name="Advertise" type="YesNoTypeUnion">
5790 <xs:annotation>
5791 <xs:documentation>Whether this MIME is to be advertised. The default is to match whatever the parent extension element uses. If the parent element is not advertised, then this element cannot be advertised either.</xs:documentation>
5792 </xs:annotation>
5793 </xs:attribute>
5794 <xs:attribute name="ContentType" type="xs:string" use="required">
5795 <xs:annotation>
5796 <xs:documentation>This is the identifier for the MIME content. It is commonly written in the form of type/format.</xs:documentation>
5797 </xs:annotation>
5798 </xs:attribute>
5799 <xs:attribute name="Class" type="Guid">
5800 <xs:annotation>
5801 <xs:documentation>Class ID for the COM server that is to be associated with the MIME content.</xs:documentation>
5802 </xs:annotation>
5803 </xs:attribute>
5804 <xs:attribute name="Default" type="YesNoTypeUnion">
5805 <xs:annotation>
5806 <xs:documentation>If 'yes', become the content type for the parent Extension. The default value is 'no'.</xs:documentation>
5807 </xs:annotation>
5808 </xs:attribute>
5809 </xs:complexType>
5810 </xs:element>
5811 <xs:element name="Verb">
5812 <xs:annotation>
5813 <xs:documentation>
5814 Verb definition for an Extension. When advertised, this element creates a row in the
5815 <html:a href="http://msdn.microsoft.com/library/aa372487.aspx" target="_blank">Verb table</html:a>.
5816 When not advertised, this element creates the appropriate rows in <html:a href="http://msdn.microsoft.com/library/aa371168.aspx" target="_blank">Registry table</html:a>.
5817 </xs:documentation>
5818 <xs:appinfo>
5819 <xse:msiRef table="Verb" href="http://msdn.microsoft.com/library/aa372487.aspx" />
5820 <xse:msiRef table="Registry" href="http://msdn.microsoft.com/library/aa371168.aspx" />
5821 </xs:appinfo>
5822 </xs:annotation>
5823 <xs:complexType>
5824 <xs:attribute name="Id" type="xs:string" use="required">
5825 <xs:annotation>
5826 <xs:documentation>The verb for the command.</xs:documentation>
5827 </xs:annotation>
5828 </xs:attribute>
5829 <xs:attribute name="Command" type="xs:string">
5830 <xs:annotation>
5831 <xs:documentation>The localized text displayed on the context menu.</xs:documentation>
5832 </xs:annotation>
5833 </xs:attribute>
5834 <xs:attribute name="Argument" type="xs:string">
5835 <xs:annotation>
5836 <xs:documentation>Value for the command arguments. Note that the resolution of properties in the
5837 Argument field is limited. A property formatted as [Property] in this field can only be resolved if the property
5838 already has the intended value when the component owning the verb is installed. For example, for the argument
5839 "[#MyDoc.doc]" to resolve to the correct value, the same process must be installing the file MyDoc.doc and the
5840 component that owns the verb.</xs:documentation>
5841 </xs:annotation>
5842 </xs:attribute>
5843 <xs:attribute name="Sequence" type="xs:integer">
5844 <xs:annotation>
5845 <xs:documentation>The sequence of the commands. Only verbs for which the Sequence is specified
5846 are used to prepare an ordered list for the default value of the shell key. The Verb with the lowest value in this
5847 column becomes the default verb. Used only for Advertised verbs.</xs:documentation>
5848 </xs:annotation>
5849 </xs:attribute>
5850 <xs:attribute name="Target" type="xs:string">
5851 <xs:annotation>
5852 <xs:appinfo>
5853 <xse:deprecated ref="TargetFile" />
5854 </xs:appinfo>
5855 </xs:annotation>
5856 </xs:attribute>
5857 <xs:attribute name="TargetFile" type="xs:string">
5858 <xs:annotation>
5859 <xs:documentation>
5860 Either this attribute or the TargetProperty attribute must be specified for a non-advertised verb.
5861 The value should be the identifier of the target file to be executed for the verb.
5862 </xs:documentation>
5863 </xs:annotation>
5864 </xs:attribute>
5865 <xs:attribute name="TargetProperty" type="xs:string">
5866 <xs:annotation>
5867 <xs:documentation>
5868 Either this attribute or the TargetFile attribute must be specified for a non-advertised verb.
5869 The value should be the identifier of the property which will resolve to the path to the target file to be executed for the verb.
5870 </xs:documentation>
5871 </xs:annotation>
5872 </xs:attribute>
5873 </xs:complexType>
5874 </xs:element>
5875 <xs:element name="Extension">
5876 <xs:annotation>
5877 <xs:documentation>
5878 Extension for a Component
5879 </xs:documentation>
5880 <xs:appinfo>
5881 <xse:msiRef table="MIME" href="http://msdn.microsoft.com/library/aa370035.aspx" />
5882 <xse:msiRef table="Verb" href="http://msdn.microsoft.com/library/aa372487.aspx" />
5883 <xse:msiRef table="Registry" href="http://msdn.microsoft.com/library/aa371168.aspx" />
5884 </xs:appinfo>
5885 </xs:annotation>
5886 <xs:complexType>
5887 <xs:choice minOccurs="0" maxOccurs="unbounded">
5888 <xs:annotation>
5889 <xs:documentation>MIME and Verbs can be associated with Extensions</xs:documentation>
5890 </xs:annotation>
5891 <xs:element ref="MIME" />
5892 <xs:element ref="Verb" />
5893 </xs:choice>
5894 <xs:attribute name="Id" type="xs:string" use="required">
5895 <xs:annotation>
5896 <xs:documentation>This is simply the file extension, like "doc" or "xml". Do not include the preceding period.</xs:documentation>
5897 </xs:annotation>
5898 </xs:attribute>
5899 <xs:attribute name="ContentType" type="xs:string">
5900 <xs:annotation>
5901 <xs:documentation>The MIME type that is to be written.</xs:documentation>
5902 </xs:annotation>
5903 </xs:attribute>
5904 <xs:attribute name="Advertise" type="YesNoTypeUnion">
5905 <xs:annotation>
5906 <xs:documentation>Whether this extension is to be advertised. The default is "no".</xs:documentation>
5907 </xs:annotation>
5908 </xs:attribute>
5909 <xs:anyAttribute namespace="##other" processContents="lax">
5910 <xs:annotation>
5911 <xs:documentation>
5912 Extensibility point in the WiX XML Schema. Schema extensions can register additional
5913 attributes at this point in the schema.
5914 </xs:documentation>
5915 </xs:annotation>
5916 </xs:anyAttribute>
5917 </xs:complexType>
5918 </xs:element>
5919 <xs:element name="TypeLib">
5920 <xs:annotation>
5921 <xs:documentation>
5922 Register a type library (TypeLib). Please note that in order to properly use this
5923 non-advertised, you will need use this element with Advertise='no' and also author the
5924 appropriate child Interface elements by extracting them from the type library itself.
5925 </xs:documentation>
5926 <xs:appinfo>
5927 <xse:msiRef table="TypeLib" href="http://msdn.microsoft.com/library/aa372092.aspx" />
5928 <xse:msiRef table="Registry" href="http://msdn.microsoft.com/library/aa371168.aspx" />
5929 </xs:appinfo>
5930 </xs:annotation>
5931 <xs:complexType>
5932 <xs:choice minOccurs="0" maxOccurs="unbounded">
5933 <xs:element ref="AppId" />
5934 <xs:element ref="Class" />
5935 <xs:element ref="Interface" />
5936 </xs:choice>
5937 <xs:attribute name="Id" type="Guid" use="required">
5938 <xs:annotation>
5939 <xs:documentation>The GUID that identifes the type library.</xs:documentation>
5940 </xs:annotation>
5941 </xs:attribute>
5942 <xs:attribute name="Advertise" type="YesNoTypeUnion">
5943 <xs:annotation>
5944 <xs:documentation>
5945 Value of 'yes' will create a row in the TypeLib table.
5946 Value of 'no' will create rows in the Registry table.
5947 The default value is 'no'.
5948 </xs:documentation>
5949 </xs:annotation>
5950 </xs:attribute>
5951 <xs:attribute name="Control" type="YesNoTypeUnion">
5952 <xs:annotation>
5953 <xs:documentation>
5954 Value of 'yes' means the type library describes controls, and should not be displayed in type browsers intended for nonvisual objects.
5955 This attribute can only be set if Advertise='no'.
5956 </xs:documentation>
5957 </xs:annotation>
5958 </xs:attribute>
5959 <xs:attribute name="Cost" type="xs:int">
5960 <xs:annotation>
5961 <xs:documentation>
5962 The cost associated with the registration of the type library in bytes. This attribute cannot be set if Advertise='no'.
5963 </xs:documentation>
5964 </xs:annotation>
5965 </xs:attribute>
5966 <xs:attribute name="Description" type="xs:string">
5967 <xs:annotation>
5968 <xs:documentation>The localizable description of the type library.</xs:documentation>
5969 </xs:annotation>
5970 </xs:attribute>
5971 <xs:attribute name="HasDiskImage" type="YesNoTypeUnion">
5972 <xs:annotation>
5973 <xs:documentation>
5974 Value of 'yes' means the type library exists in a persisted form on disk. This attribute can only be set if Advertise='no'.
5975 </xs:documentation>
5976 </xs:annotation>
5977 </xs:attribute>
5978 <xs:attribute name="HelpDirectory" type="xs:string">
5979 <xs:annotation>
5980 <xs:documentation>The identifier of the Directory element for the help directory.</xs:documentation>
5981 </xs:annotation>
5982 </xs:attribute>
5983 <xs:attribute name="Hidden" type="YesNoTypeUnion">
5984 <xs:annotation>
5985 <xs:documentation>
5986 Value of 'yes' means the type library should not be displayed to users, although its use is not restricted.
5987 Should be used by controls. Hosts should create a new type library that wraps the control with extended properties.
5988 This attribute can only be set if Advertise='no'.
5989 </xs:documentation>
5990 </xs:annotation>
5991 </xs:attribute>
5992 <xs:attribute name="Language" use="required" type="xs:integer">
5993 <xs:annotation>
5994 <xs:documentation>The language of the type library. This must be a non-negative integer.</xs:documentation>
5995 </xs:annotation>
5996 </xs:attribute>
5997 <xs:attribute name="MajorVersion" type="xs:integer">
5998 <xs:annotation>
5999 <xs:documentation>The major version of the type library. The value should be an integer from 0 - 255.</xs:documentation>
6000 </xs:annotation>
6001 </xs:attribute>
6002 <xs:attribute name="MinorVersion" type="xs:integer">
6003 <xs:annotation>
6004 <xs:documentation>The minor version of the type library. The value should be an integer from 0 - 255.</xs:documentation>
6005 </xs:annotation>
6006 </xs:attribute>
6007 <xs:attribute name="ResourceId" type="xs:integer">
6008 <xs:annotation>
6009 <xs:documentation>The resource id of a typelib. The value is appended to the end of the typelib path in the registry.</xs:documentation>
6010 </xs:annotation>
6011 </xs:attribute>
6012 <xs:attribute name="Restricted" type="YesNoTypeUnion">
6013 <xs:annotation>
6014 <xs:documentation>
6015 Value of 'yes' means the type library is restricted, and should not be displayed to users. This attribute can only be set if Advertise='no'.
6016 </xs:documentation>
6017 </xs:annotation>
6018 </xs:attribute>
6019 </xs:complexType>
6020 </xs:element>
6021 <xs:element name="ProgId">
6022 <xs:annotation>
6023 <xs:documentation>
6024 ProgId registration for parent Component. If ProgId has an associated Class, it must be a child of that element.
6025 </xs:documentation>
6026 <xs:appinfo>
6027 <xse:msiRef table="ProgId" href="http://msdn.microsoft.com/library/aa370879.aspx" />
6028 <xse:msiRef table="Class" href="http://msdn.microsoft.com/library/aa367861.aspx" />
6029 <xse:msiRef table="Registry" href="http://msdn.microsoft.com/library/aa371168.aspx" />
6030 <xse:msiRef table="Icon" href="http://msdn.microsoft.com/library/aa369210.aspx" />
6031 </xs:appinfo>
6032 </xs:annotation>
6033 <xs:complexType>
6034 <xs:sequence>
6035 <xs:element ref="ProgId" minOccurs="0" maxOccurs="unbounded">
6036 <xs:annotation>
6037 <xs:documentation>The version-independent ProgId must be the first child element of actual ProgId. Nesting other ProgId elements within the Version-independent ProgId will create COM+ aliases, see <html:a href="http://support.microsoft.com/kb/305745">http://support.microsoft.com/kb/305745</html:a> for more information.</xs:documentation>
6038 </xs:annotation>
6039 </xs:element>
6040 <xs:element ref="Extension" minOccurs="0" maxOccurs="unbounded">
6041 <xs:annotation>
6042 <xs:documentation>Extensions that refer to this ProgId</xs:documentation>
6043 </xs:annotation>
6044 </xs:element>
6045 </xs:sequence>
6046 <xs:attribute name="Id" type="xs:string" use="required" />
6047 <xs:attribute name="Description" type="xs:string" />
6048 <xs:attribute name="Icon" type="xs:string">
6049 <xs:annotation>
6050 <xs:documentation>For an advertised ProgId, the Id of an Icon element. For a non-advertised ProgId, this is the Id of a file containing an icon resource.</xs:documentation>
6051 </xs:annotation>
6052 </xs:attribute>
6053 <xs:attribute name="IconIndex" type="xs:integer" />
6054 <xs:attribute name="Advertise" type="YesNoTypeUnion" />
6055 <xs:attribute name="NoOpen" type="xs:string">
6056 <xs:annotation>
6057 <xs:documentation>Specifies that the associated ProgId should not be opened by users. The value is presented as a warning to users. An empty string is also valid for this attribute.</xs:documentation>
6058 </xs:annotation>
6059 </xs:attribute>
6060 </xs:complexType>
6061 </xs:element>
6062 <xs:element name="AppId">
6063 <xs:annotation>
6064 <xs:documentation>
6065 Application ID containing DCOM information for the associated application GUID.
6066 If this element is nested under a Fragment, Module, or Product element, it must be
6067 advertised.
6068 </xs:documentation>
6069 <xs:appinfo>
6070 <xse:msiRef table="AppId" href="http://msdn.microsoft.com/library/aa367566.aspx" />
6071 <xse:msiRef table="Registry" href="http://msdn.microsoft.com/library/aa371168.aspx" />
6072 <xse:remarks>
6073 When being used in unadvertised mode, the attributes in the AppId element correspond to registry keys
6074 as follows (values that can be specified in authoring are in bold):
6075 <html:dl><html:dt>Id</html:dt><html:dd><html:dl><html:dt>In General</html:dt><html:dd>
6076 [HKCR\AppID\{<html:b>Id</html:b>}]<html:br /></html:dd><html:dt>Specific Example</html:dt><html:dd>
6077 [HKCR\AppID\{<html:b>01234567-89AB-CDEF-0123-456789ABCDEF</html:b>}]<html:br /></html:dd></html:dl></html:dd><html:dt>ActivateAtStorage</html:dt><html:dd><html:dl><html:dt>In General</html:dt><html:dd>
6078 [HKCR\AppID\{<html:b>Id</html:b>}]<html:br />
6079 ActivateAtStorage="<html:b>ActivateAtStorage</html:b>"
6080 </html:dd><html:dt>Specific Example</html:dt><html:dd>
6081 [HKCR\AppID\{<html:b>01234567-89AB-CDEF-0123-456789ABCDEF</html:b>}]<html:br />
6082 ActivateAtStorage="<html:b>Y</html:b>"
6083 </html:dd></html:dl></html:dd><html:dt>Description</html:dt><html:dd><html:dl><html:dt>In General</html:dt><html:dd>
6084 [HKCR\AppID\{<html:b>Id</html:b>}]<html:br />
6085 @="<html:b>Description</html:b>"
6086 </html:dd><html:dt>Specific Example</html:dt><html:dd>
6087 [HKCR\AppID\{<html:b>01234567-89AB-CDEF-0123-456789ABCDEF</html:b>}]<html:br />
6088 @="<html:b>My AppId Description</html:b>"
6089 </html:dd></html:dl></html:dd><html:dt>DllSurrogate</html:dt><html:dd><html:dl><html:dt>In General</html:dt><html:dd>
6090 [HKCR\AppID\{<html:b>Id</html:b>}]<html:br />
6091 DllSurrogate="<html:b>DllSurrogate</html:b>"
6092 </html:dd><html:dt>Specific Example</html:dt><html:dd>
6093 [HKCR\AppID\{<html:b>01234567-89AB-CDEF-0123-456789ABCDEF</html:b>}]<html:br />
6094 DllSurrogate="<html:b>C:\surrogate.exe</html:b>"
6095 </html:dd></html:dl></html:dd><html:dt>LocalService</html:dt><html:dd><html:dl><html:dt>In General</html:dt><html:dd>
6096 [HKCR\AppID\{<html:b>Id</html:b>}]<html:br />
6097 LocalService="<html:b>LocalService</html:b>"
6098 </html:dd><html:dt>Specific Example</html:dt><html:dd>
6099 [HKCR\AppID\{<html:b>01234567-89AB-CDEF-0123-456789ABCDEF</html:b>}]<html:br />
6100 LocalService="<html:b>MyServiceName</html:b>"
6101 </html:dd></html:dl></html:dd><html:dt>RemoteServerName</html:dt><html:dd><html:dl><html:dt>In General</html:dt><html:dd>
6102 [HKCR\AppID\{<html:b>Id</html:b>}]<html:br />
6103 RemoteServerName="<html:b>RemoteServerName</html:b>"
6104 </html:dd><html:dt>Specific Example</html:dt><html:dd>
6105 [HKCR\AppID\{<html:b>01234567-89AB-CDEF-0123-456789ABCDEF</html:b>}]<html:br />
6106 RemoteServerName="<html:b>MyRemoteServer</html:b>"
6107 </html:dd></html:dl></html:dd><html:dt>RunAsInteractiveUser</html:dt><html:dd><html:dl><html:dt>In General</html:dt><html:dd>
6108 [HKCR\AppID\{<html:b>Id</html:b>}]<html:br />
6109 RunAs="<html:b>RunAsInteractiveUser</html:b>"
6110 </html:dd><html:dt>Specific Example</html:dt><html:dd>
6111 [HKCR\AppID\{<html:b>01234567-89AB-CDEF-0123-456789ABCDEF</html:b>}]<html:br />
6112 RunAs="<html:b>Interactive User</html:b>"
6113 </html:dd></html:dl></html:dd><html:dt>ServiceParameters</html:dt><html:dd><html:dl><html:dt>In General</html:dt><html:dd>
6114 [HKCR\AppID\{<html:b>Id</html:b>}]<html:br />
6115 ServiceParameters="<html:b>ServiceParameters</html:b>"
6116 </html:dd><html:dt>Specific Example</html:dt><html:dd>
6117 [HKCR\AppID\{<html:b>01234567-89AB-CDEF-0123-456789ABCDEF</html:b>}]<html:br />
6118 ServiceParameters="<html:b>-param</html:b>"
6119 </html:dd></html:dl></html:dd></html:dl></xse:remarks>
6120 </xs:appinfo>
6121 </xs:annotation>
6122 <xs:complexType>
6123 <xs:choice minOccurs="0" maxOccurs="unbounded">
6124 <xs:element ref="Class" />
6125 </xs:choice>
6126 <xs:attribute name="ActivateAtStorage" type="YesNoTypeUnion">
6127 <xs:annotation>
6128 <xs:documentation>
6129 Set this value to 'yes' to configure the client to activate on the same system as persistent storage.
6130 </xs:documentation>
6131 </xs:annotation>
6132 </xs:attribute>
6133 <xs:attribute name="Advertise" type="YesNoTypeUnion">
6134 <xs:annotation>
6135 <xs:documentation>
6136 Set this value to 'yes' in order to create a normal AppId table row. Set this value to 'no' in order to
6137 generate Registry rows that perform similar registration (without the often problematic Windows Installer
6138 advertising behavior).
6139 </xs:documentation>
6140 </xs:annotation>
6141 </xs:attribute>
6142 <xs:attribute name="Description" type="xs:string">
6143 <xs:annotation>
6144 <xs:documentation>
6145 Set this value to the description of the AppId. It can only be specified when the AppId is not being advertised.
6146 </xs:documentation>
6147 </xs:annotation>
6148 </xs:attribute>
6149 <xs:attribute name="DllSurrogate" type="xs:string">
6150 <xs:annotation>
6151 <xs:documentation>
6152 Set this value to specify that the class is a DLL that is to be activated in a surrogate EXE
6153 process, and the surrogate process to be used is the path of a surrogate EXE file specified by the value.
6154 </xs:documentation>
6155 </xs:annotation>
6156 </xs:attribute>
6157 <xs:attribute name="Id" type="Guid" use="required">
6158 <xs:annotation>
6159 <xs:documentation>
6160 Set this value to the AppID GUID that corresponds to the named executable.
6161 </xs:documentation>
6162 </xs:annotation>
6163 </xs:attribute>
6164 <xs:attribute name="LocalService" type="xs:string">
6165 <xs:annotation>
6166 <xs:documentation>
6167 Set this value to the name of a service to allow the object to be installed as a Win32 service.
6168 </xs:documentation>
6169 </xs:annotation>
6170 </xs:attribute>
6171 <xs:attribute name="RemoteServerName" type="xs:string">
6172 <xs:annotation>
6173 <xs:documentation>
6174 Set this value to the name of the remote server to configure the client to request the object
6175 be run at a particular machine whenever an activation function is called for which a COSERVERINFO
6176 structure is not specified.
6177 </xs:documentation>
6178 </xs:annotation>
6179 </xs:attribute>
6180 <xs:attribute name="RunAsInteractiveUser" type="YesNoTypeUnion">
6181 <xs:annotation>
6182 <xs:documentation>
6183 Set this value to 'yes' to configure a class to run under the identity of the user currently
6184 logged on and connected to the interactive desktop when activated by a remote client without
6185 being written as a Win32 service.
6186 </xs:documentation>
6187 </xs:annotation>
6188 </xs:attribute>
6189 <xs:attribute name="ServiceParameters" type="xs:string">
6190 <xs:annotation>
6191 <xs:documentation>
6192 Set this value to the parameters to be passed to a LocalService on invocation.
6193 </xs:documentation>
6194 </xs:annotation>
6195 </xs:attribute>
6196 </xs:complexType>
6197 </xs:element>
6198 <xs:element name="Class">
6199 <xs:annotation>
6200 <xs:documentation>COM Class registration for parent Component.</xs:documentation>
6201 <xs:appinfo>
6202 <xse:seeAlso ref="AppId" />
6203 <xse:msiRef table="Class" href="http://msdn.microsoft.com/library/aa367861.aspx" />
6204 <xse:msiRef table="ProgId" href="http://msdn.microsoft.com/library/aa370879.aspx" />
6205 <xse:msiRef table="Registry" href="http://msdn.microsoft.com/library/aa371168.aspx" />
6206 <xse:msiRef table="AppId" href="http://msdn.microsoft.com/library/aa367566.aspx" />
6207 <xse:remarks>
6208 When being used in unadvertised mode, the attributes in the Class element correspond to registry keys
6209 as follows (values that can be specified in authoring are in bold):
6210 <html:dl><html:dt>Id/Context/Server</html:dt><html:dd><html:dl><html:dt>In General</html:dt><html:dd>
6211 [HKCR\CLSID\{<html:b>Id</html:b>}\<html:b>Context1</html:b>]<html:br />
6212 @="[!<html:b>Server</html:b>]"<html:br />
6213 [HKCR\CLSID\{<html:b>Id</html:b>}\<html:b>Context2</html:b>]<html:br />
6214 @="[!<html:b>Server</html:b>]"
6215 </html:dd><html:dt>Specific Example</html:dt><html:dd>
6216 [HKCR\CLSID\{<html:b>01234567-89AB-CDEF-0123-456789ABCDEF</html:b>}\<html:b>LocalServer</html:b>]<html:br />
6217 @="[!<html:b>comserv.dll</html:b>]"<html:br />
6218 [HKCR\CLSID\{<html:b>01234567-89AB-CDEF-0123-456789ABCDEF</html:b>}\<html:b>LocalServer32</html:b>]<html:br />
6219 @="[!<html:b>comserv.dll</html:b>]"
6220 </html:dd></html:dl></html:dd><html:dt>Id/Context/ForeignServer</html:dt><html:dd><html:dl><html:dt>In General</html:dt><html:dd>
6221 [HKCR\CLSID\{<html:b>Id</html:b>}\<html:b>Context1</html:b>]<html:br />
6222 @="<html:b>ForeignServer</html:b>"<html:br />
6223 [HKCR\CLSID\{<html:b>Id</html:b>}\<html:b>Context2</html:b>]<html:br />
6224 @="<html:b>ForeignServer</html:b>"
6225 </html:dd><html:dt>Specific Example</html:dt><html:dd>
6226 [HKCR\CLSID\{<html:b>01234567-89AB-CDEF-0123-456789ABCDEF</html:b>}\<html:b>LocalServer</html:b>]<html:br />
6227 @="<html:b>mscoree.dll</html:b>"<html:br />
6228 [HKCR\CLSID\{<html:b>01234567-89AB-CDEF-0123-456789ABCDEF</html:b>}\<html:b>LocalServer32</html:b>]<html:br />
6229 @="<html:b>mscoree.dll</html:b>"
6230 </html:dd></html:dl></html:dd><html:dt>AppId</html:dt><html:dd><html:dl><html:dt>In General</html:dt><html:dd>
6231 [HKCR\CLSID\{<html:b>Id</html:b>}]<html:br />
6232 AppId="{<html:b>AppId</html:b>}"
6233 </html:dd><html:dt>Specific Example</html:dt><html:dd>
6234 [HKCR\CLSID\{<html:b>01234567-89AB-CDEF-0123-456789ABCDEF</html:b>}]<html:br />
6235 AppId="{<html:b>00000000-89AB-0000-0123-000000000000</html:b>}"
6236 </html:dd></html:dl></html:dd><html:dt>Argument</html:dt><html:dd><html:dl><html:dt>In General</html:dt><html:dd>
6237 [HKCR\CLSID\{<html:b>Id</html:b>}\<html:b>Context</html:b>]<html:br />
6238 @="[!<html:b>Server</html:b>] <html:b>Argument</html:b>"
6239 </html:dd><html:dt>Specific Example</html:dt><html:dd>
6240 [HKCR\CLSID\{<html:b>01234567-89AB-CDEF-0123-456789ABCDEF</html:b>}\<html:b>LocalServer32</html:b>]<html:br />
6241 @="[!<html:b>comserv.dll</html:b>] <html:b>/arg1 /arg2 /arg3</html:b>"<html:br /></html:dd></html:dl></html:dd><html:dt>Control</html:dt><html:dd><html:dl><html:dt>In General</html:dt><html:dd>
6242 Value "yes" specified:<html:br />
6243 [HKCR\CLSID\{<html:b>Id</html:b>}\Control]
6244 </html:dd><html:dt>Specific Example</html:dt><html:dd>
6245 [HKCR\CLSID\{<html:b>01234567-89AB-CDEF-0123-456789ABCDEF</html:b>}\Control]
6246 </html:dd></html:dl></html:dd><html:dt>Description</html:dt><html:dd><html:dl><html:dt>In General</html:dt><html:dd>
6247 [HKCR\CLSID\{<html:b>Id</html:b>}]<html:br />
6248 @="<html:b>Description</html:b>"
6249 </html:dd><html:dt>Specific Example</html:dt><html:dd>
6250 [HKCR\CLSID\{<html:b>01234567-89AB-CDEF-0123-456789ABCDEF</html:b>}]<html:br />
6251 @="<html:b>Description of Example COM Component</html:b>"
6252 </html:dd></html:dl></html:dd><html:dt>Handler</html:dt><html:dd><html:dl><html:dt>In General</html:dt><html:dd>
6253 Value "1" specified:<html:br />
6254 [HKCR\CLSID\{<html:b>Id</html:b>}\InprocHandler]<html:br />
6255 @="ole2.dll"<html:br />
6256 Value "2" specified:<html:br />
6257 [HKCR\CLSID\{<html:b>Id</html:b>}\InprocHandler32]<html:br />
6258 @="ole32.dll"<html:br />
6259 Value "3" specified:<html:br />
6260 [HKCR\CLSID\{<html:b>Id</html:b>}\InprocHandler]<html:br />
6261 @="ole2.dll"<html:br />
6262 [HKCR\CLSID\{<html:b>Id</html:b>}\InprocHandler32]<html:br />
6263 @="ole32.dll"<html:br />
6264 Other value specified:<html:br />
6265 [HKCR\CLSID\{<html:b>Id</html:b>}\InprocHandler32]<html:br />
6266 @="<html:b>Handler</html:b>"
6267 </html:dd><html:dt>Specific Example (for other value)</html:dt><html:dd>
6268 [HKCR\CLSID\{<html:b>01234567-89AB-CDEF-0123-456789ABCDEF</html:b>}\InprocHandler32]<html:br />
6269 @="<html:b>handler.dll</html:b>"
6270 </html:dd></html:dl></html:dd><html:dt>Icon/IconIndex</html:dt><html:dt>Insertable</html:dt><html:dd><html:dl><html:dt>In General</html:dt><html:dd>
6271 Value "no" specified:<html:br />
6272 [HKCR\CLSID\{<html:b>Id</html:b>}\NotInsertable]<html:br />
6273 Value "yes" specified:<html:br />
6274 [HKCR\CLSID\{<html:b>Id</html:b>}\Insertable]
6275 </html:dd><html:dt>Specific Example</html:dt><html:dd>
6276 [HKCR\CLSID\{<html:b>01234567-89AB-CDEF-0123-456789ABCDEF</html:b>}\Insertable]
6277 </html:dd></html:dl></html:dd><html:dt>Programmable</html:dt><html:dd><html:dl><html:dt>In General</html:dt><html:dd>
6278 Value "yes" specified:<html:br />
6279 [HKCR\CLSID\{<html:b>Id</html:b>}\Programmable]
6280 </html:dd><html:dt>Specific Example</html:dt><html:dd>
6281 [HKCR\CLSID\{<html:b>01234567-89AB-CDEF-0123-456789ABCDEF</html:b>}\Programmable]
6282 </html:dd></html:dl></html:dd><html:dt>RelativePath</html:dt><html:dd>Unsupported. Please contribute this back to WiX if you know.</html:dd><html:dt>SafeForInitializing</html:dt><html:dd><html:dl><html:dt>In General</html:dt><html:dd>
6283 Value "yes" specified:<html:br />
6284 [HKCR\CLSID\{<html:b>Id</html:b>}\Implemented Categories\{7DD95802-9882-11CF-9FA9-00AA006C42C4}]
6285 </html:dd><html:dt>Specific Example</html:dt><html:dd>
6286 [HKCR\CLSID\{<html:b>01234567-89AB-CDEF-0123-456789ABCDEF</html:b>}\Implemented Categories\{7DD95802-9882-11CF-9FA9-00AA006C42C4}]
6287 </html:dd></html:dl></html:dd><html:dt>SafeForScripting</html:dt><html:dd><html:dl><html:dt>In General</html:dt><html:dd>
6288 Value "yes" specified:<html:br />
6289 [HKCR\CLSID\{<html:b>Id</html:b>}\Implemented Categories\{7DD95801-9882-11CF-9FA9-00AA006C42C4}]
6290 </html:dd><html:dt>Specific Example</html:dt><html:dd>
6291 [HKCR\CLSID\{<html:b>01234567-89AB-CDEF-0123-456789ABCDEF</html:b>}\Implemented Categories\{7DD95801-9882-11CF-9FA9-00AA006C42C4}]
6292 </html:dd></html:dl></html:dd><html:dt>ThreadingModel</html:dt><html:dd><html:dl><html:dt>In General</html:dt><html:dd>
6293 [HKCR\CLSID\{<html:b>Id</html:b>}\<html:b>Context</html:b>]<html:br />
6294 ThreadingModel="<html:b>ThreadingModel</html:b>"
6295 </html:dd><html:dt>Specific Example</html:dt><html:dd>
6296 [HKCR\CLSID\{<html:b>01234567-89AB-CDEF-0123-456789ABCDEF</html:b>}\<html:b>LocalServer32</html:b>]<html:br />
6297 ThreadingModel="<html:b>Apartment</html:b>"
6298 </html:dd></html:dl></html:dd><html:dt>TypeLibId (from parent TypeLib/@Id)</html:dt><html:dd><html:dl><html:dt>In General</html:dt><html:dd>
6299 [HKCR\CLSID\{<html:b>Id</html:b>}\TypeLib]<html:br />
6300 @="{<html:b>TypeLibId</html:b>}"
6301 </html:dd><html:dt>Specific Example</html:dt><html:dd>
6302 [HKCR\CLSID\{<html:b>01234567-89AB-CDEF-0123-456789ABCDEF</html:b>}\TypeLib]<html:br />
6303 @="{<html:b>11111111-89AB-1111-0123-111111111111</html:b>}"
6304 </html:dd></html:dl></html:dd><html:dt>Version</html:dt><html:dd><html:dl><html:dt>In General</html:dt><html:dd>
6305 [HKCR\CLSID\{<html:b>Id</html:b>}\Version]<html:br />
6306 @="<html:b>Version</html:b>"
6307 </html:dd><html:dt>Specific Example</html:dt><html:dd>
6308 [HKCR\CLSID\{<html:b>01234567-89AB-CDEF-0123-456789ABCDEF</html:b>}\Version]<html:br />
6309 @="<html:b>1.0.0.0</html:b>"
6310 </html:dd></html:dl></html:dd></html:dl></xse:remarks>
6311 </xs:appinfo>
6312 </xs:annotation>
6313 <xs:complexType>
6314 <xs:choice minOccurs="0" maxOccurs="unbounded">
6315 <xs:element ref="ProgId">
6316 <xs:annotation>
6317 <xs:documentation>A ProgId associated with Class must be a child element of the Class element</xs:documentation>
6318 </xs:annotation>
6319 </xs:element>
6320 <xs:element ref="FileTypeMask" />
6321 <xs:element ref="Interface">
6322 <xs:annotation>
6323 <xs:documentation>These Interfaces will be registered with the parent Class and TypeLib (if present).</xs:documentation>
6324 </xs:annotation>
6325 </xs:element>
6326 </xs:choice>
6327 <xs:attribute name="Id" type="Guid" use="required">
6328 <xs:annotation>
6329 <xs:documentation>The Class identifier (CLSID) of a COM server.</xs:documentation>
6330 </xs:annotation>
6331 </xs:attribute>
6332 <xs:attribute name="Context">
6333 <xs:annotation>
6334 <xs:documentation>
6335 The server context(s) for this COM server. This attribute is optional for VB6 libraries that are marked "PublicNotCreateable".
6336 Class elements marked Advertised must specify at least one server context. It is most common for there to be a single value
6337 for the Context attribute.
6338 </xs:documentation>
6339 </xs:annotation>
6340 <xs:simpleType>
6341 <xs:list>
6342 <xs:simpleType>
6343 <xs:restriction base="xs:NMTOKEN">
6344 <xs:enumeration value="LocalServer">
6345 <xs:annotation>
6346 <xs:documentation>
6347 A 16-bit local server application.
6348 </xs:documentation>
6349 </xs:annotation>
6350 </xs:enumeration>
6351 <xs:enumeration value="LocalServer32">
6352 <xs:annotation>
6353 <xs:documentation>
6354 A 32-bit local server application.
6355 </xs:documentation>
6356 </xs:annotation>
6357 </xs:enumeration>
6358 <xs:enumeration value="InprocServer">
6359 <xs:annotation>
6360 <xs:documentation>
6361 A 16-bit in-process server DLL.
6362 </xs:documentation>
6363 </xs:annotation>
6364 </xs:enumeration>
6365 <xs:enumeration value="InprocServer32">
6366 <xs:annotation>
6367 <xs:documentation>
6368 A 32-bit in-process server DLL.
6369 </xs:documentation>
6370 </xs:annotation>
6371 </xs:enumeration>
6372 </xs:restriction>
6373 </xs:simpleType>
6374 </xs:list>
6375 </xs:simpleType>
6376 </xs:attribute>
6377 <xs:attribute name="Description" type="xs:string">
6378 <xs:annotation>
6379 <xs:documentation>Localized description associated with the Class ID and Program ID.</xs:documentation>
6380 </xs:annotation>
6381 </xs:attribute>
6382 <xs:attribute name="AppId" type="Guid">
6383 <xs:annotation>
6384 <xs:documentation>
6385 This attribute is only allowed when a Class is advertised. Using this attribute will reference an Application ID
6386 containing DCOM information for the associated application GUID. The value must correspond to an AppId/@Id of an
6387 AppId element nested under a Fragment, Module, or Product element. To associate an AppId with a non-advertised
6388 class, nest the class within a parent AppId element.
6389 </xs:documentation>
6390 </xs:annotation>
6391 </xs:attribute>
6392 <xs:attribute name="Icon" type="xs:string">
6393 <xs:annotation>
6394 <xs:documentation>
6395 The file providing the icon associated with this CLSID. Reference to an Icon element
6396 (should match the Id attribute of an Icon element).
6397 </xs:documentation>
6398 </xs:annotation>
6399 </xs:attribute>
6400 <xs:attribute name="IconIndex" type="xs:integer">
6401 <xs:annotation>
6402 <xs:documentation>Icon index into the icon file.</xs:documentation>
6403 </xs:annotation>
6404 </xs:attribute>
6405 <xs:attribute name="Handler" type="xs:string">
6406 <xs:annotation>
6407 <xs:documentation>
6408 The default inproc handler. May be optionally provided only for Context = LocalServer or
6409 LocalServer32. Value of "1" creates a 16-bit InprocHandler (appearing as the InprocHandler
6410 value). Value of "2" creates a 32-bit InprocHandler (appearing as the InprocHandler32 value).
6411 Value of "3" creates 16-bit as well as 32-bit InprocHandlers. A non-numeric value is treated
6412 as a system file that serves as the 32-bit InprocHandler (appearing as the InprocHandler32 value).
6413 </xs:documentation>
6414 </xs:annotation>
6415 </xs:attribute>
6416 <xs:attribute name="Argument" type="xs:string">
6417 <xs:annotation>
6418 <xs:documentation>
6419 This column is optional only when the Context column is set to "LocalServer"
6420 or "LocalServer32" server context. The text is registered as the argument against
6421 the OLE server and is used by OLE for invoking the server. Note that the resolution
6422 of properties in the Argument field is limited. A property formatted as [Property] in
6423 this field can only be resolved if the property already has the intended value when
6424 the component owning the class is installed. For example, for the argument "[#MyDoc.doc]"
6425 to resolve to the correct value, the same process must be installing the file MyDoc.doc and the
6426 component that owns the class.
6427 </xs:documentation>
6428 </xs:annotation>
6429 </xs:attribute>
6430 <xs:attribute name="RelativePath" type="YesNoTypeUnion">
6431 <xs:annotation>
6432 <xs:documentation>
6433 When the value is "yes", the bare file name can be used for COM servers. The installer
6434 registers the file name only instead of the complete path. This enables the server in
6435 the current directory to take precedence and allows multiple copies of the same component.
6436 </xs:documentation>
6437 </xs:annotation>
6438 </xs:attribute>
6439 <xs:attribute name="Advertise" type="YesNoTypeUnion">
6440 <xs:annotation>
6441 <xs:documentation>
6442 Set this value to "yes" in order to create a normal Class table row. Set this value to
6443 "no" in order to generate Registry rows that perform similar registration (without the
6444 often problematic Windows Installer advertising behavior).
6445 </xs:documentation>
6446 </xs:annotation>
6447 </xs:attribute>
6448 <!-- Following attributes are not advertised, but add the appropriate rows to the Registry table -->
6449 <xs:attribute name="ThreadingModel">
6450 <xs:annotation>
6451 <xs:documentation>
6452 Threading model for the CLSID.
6453 </xs:documentation>
6454 </xs:annotation>
6455 <xs:simpleType>
6456 <xs:restriction base="xs:NMTOKEN">
6457 <xs:enumeration value="apartment" />
6458 <xs:enumeration value="free" />
6459 <xs:enumeration value="both" />
6460 <xs:enumeration value="neutral" />
6461 <xs:enumeration value="single" />
6462 <xs:enumeration value="rental" />
6463 </xs:restriction>
6464 </xs:simpleType>
6465 </xs:attribute>
6466 <xs:attribute name="Version" type="xs:string">
6467 <xs:annotation>
6468 <xs:documentation>
6469 Version for the CLSID.
6470 </xs:documentation>
6471 </xs:annotation>
6472 </xs:attribute>
6473 <xs:attribute name="Insertable" type="YesNoTypeUnion">
6474 <xs:annotation>
6475 <xs:documentation>
6476 Specifies the CLSID may be insertable.
6477 </xs:documentation>
6478 </xs:annotation>
6479 </xs:attribute>
6480 <xs:attribute name="Programmable" type="YesNoTypeUnion">
6481 <xs:annotation>
6482 <xs:documentation>
6483 Specifies the CLSID may be programmable.
6484 </xs:documentation>
6485 </xs:annotation>
6486 </xs:attribute>
6487 <xs:attribute name="ForeignServer" type="xs:string">
6488 <xs:annotation>
6489 <xs:documentation>
6490 May only be specified if the value of the Advertise attribute is "no" and Server has not been specified. In addition, it may only
6491 be used when the Class element is directly under the Component element. The value can be
6492 that of an registry type (REG_SZ). This attribute should be used to specify foreign servers, such as mscoree.dll if needed.
6493 </xs:documentation>
6494 </xs:annotation>
6495 </xs:attribute>
6496 <xs:attribute name="Server" type="xs:string">
6497 <xs:annotation>
6498 <xs:documentation>
6499 May only be specified if the value of the Advertise attribute is "no" and the ForeignServer attribute is not specified. File Id of the
6500 COM server file. If this element is nested under a File element, this value defaults to
6501 the value of the parent File/@Id.
6502 </xs:documentation>
6503 </xs:annotation>
6504 </xs:attribute>
6505 <xs:attribute name="ShortPath" type="YesNoTypeUnion">
6506 <xs:annotation>
6507 <xs:documentation>
6508 Specifies whether or not to use the short path for the COM server. This can only apply when Advertise is set to 'no'. The default is 'no' meaning that it will use the long file name for the COM server.
6509 </xs:documentation>
6510 </xs:annotation>
6511 </xs:attribute>
6512 <xs:attribute name="SafeForScripting" type="YesNoTypeUnion">
6513 <xs:annotation>
6514 <xs:documentation>
6515 May only be specified if the value of the Advertise attribute is "no".
6516 </xs:documentation>
6517 </xs:annotation>
6518 </xs:attribute>
6519 <xs:attribute name="SafeForInitializing" type="YesNoTypeUnion">
6520 <xs:annotation>
6521 <xs:documentation>
6522 May only be specified if the value of the Advertise attribute is "no".
6523 </xs:documentation>
6524 </xs:annotation>
6525 </xs:attribute>
6526 <xs:attribute name="Control" type="YesNoTypeUnion">
6527 <xs:annotation>
6528 <xs:documentation>
6529 Set this attribute's value to 'yes' to identify an object as an ActiveX Control. The default value is 'no'.
6530 </xs:documentation>
6531 </xs:annotation>
6532 </xs:attribute>
6533 </xs:complexType>
6534 </xs:element>
6535 <xs:element name="Interface">
6536 <xs:annotation>
6537 <xs:documentation>COM Interface registration for parent TypeLib.</xs:documentation>
6538 <xs:appinfo>
6539 <xse:msiRef table="Registry" href="http://msdn.microsoft.com/library/aa371168.aspx" />
6540 </xs:appinfo>
6541 </xs:annotation>
6542 <xs:complexType>
6543 <xs:attribute name="Id" type="Guid" use="required">
6544 <xs:annotation>
6545 <xs:documentation>GUID identifier for COM Interface.</xs:documentation>
6546 </xs:annotation>
6547 </xs:attribute>
6548 <xs:attribute name="Name" type="xs:string" use="required">
6549 <xs:annotation>
6550 <xs:documentation>Name for COM Interface.</xs:documentation>
6551 </xs:annotation>
6552 </xs:attribute>
6553 <xs:attribute name="BaseInterface" type="Guid">
6554 <xs:annotation>
6555 <xs:documentation>Identifies the interface from which the current interface is derived.</xs:documentation>
6556 </xs:annotation>
6557 </xs:attribute>
6558 <xs:attribute name="ProxyStubClassId" type="Guid">
6559 <xs:annotation>
6560 <xs:documentation>GUID CLSID for proxy stub to COM Interface.</xs:documentation>
6561 </xs:annotation>
6562 </xs:attribute>
6563 <xs:attribute name="ProxyStubClassId32" type="Guid">
6564 <xs:annotation>
6565 <xs:documentation>GUID CLSID for 32-bit proxy stub to COM Interface.</xs:documentation>
6566 </xs:annotation>
6567 </xs:attribute>
6568 <xs:attribute name="NumMethods" type="xs:integer">
6569 <xs:annotation>
6570 <xs:documentation>Number of methods implemented on COM Interface.</xs:documentation>
6571 </xs:annotation>
6572 </xs:attribute>
6573 <xs:attribute name="Versioned" type="YesNoTypeUnion">
6574 <xs:annotation>
6575 <xs:documentation>Determines whether a Typelib version entry should be created with the other COM Interface registry keys. Default is 'yes'.</xs:documentation>
6576 </xs:annotation>
6577 </xs:attribute>
6578 </xs:complexType>
6579 </xs:element>
6580 <xs:element name="FileTypeMask">
6581 <xs:annotation>
6582 <xs:documentation>FileType data for class Id registration.</xs:documentation>
6583 </xs:annotation>
6584 <xs:complexType>
6585 <xs:attribute name="Offset" type="xs:integer" use="required">
6586 <xs:annotation>
6587 <xs:documentation>Offset into file. If positive, offset is from the beginning; if negative, offset is from the end.</xs:documentation>
6588 </xs:annotation>
6589 </xs:attribute>
6590 <xs:attribute name="Mask" type="HexType" use="required">
6591 <xs:annotation>
6592 <xs:documentation>Hex value that is AND'd against the bytes in the file at Offset.</xs:documentation>
6593 </xs:annotation>
6594 </xs:attribute>
6595 <xs:attribute name="Value" type="HexType" use="required">
6596 <xs:annotation>
6597 <xs:documentation>If the result of the AND'ing of Mask with the bytes in the file is Value, the file is a match for this File Type.</xs:documentation>
6598 </xs:annotation>
6599 </xs:attribute>
6600 </xs:complexType>
6601 </xs:element>
6602 <xs:element name="ServiceDependency">
6603 <xs:annotation>
6604 <xs:documentation>
6605 Service or group of services that must start before the parent service.
6606 </xs:documentation>
6607 <xs:appinfo>
6608 <xse:msiRef table="ServiceInstall" href="http://msdn.microsoft.com/library/aa371637.aspx" />
6609 </xs:appinfo>
6610 </xs:annotation>
6611 <xs:complexType>
6612 <xs:attribute name="Id" type="xs:string" use="required">
6613 <xs:annotation>
6614 <xs:documentation>
6615 The value of this attribute should be one of the following:
6616 <html:ol><html:li>The name (not the display name) of a previously installed service.</html:li><html:li>The name of a service group (in which case the Group attribute must be set to 'yes').</html:li></html:ol></xs:documentation>
6617 </xs:annotation>
6618 </xs:attribute>
6619 <xs:attribute name="Group" type="YesNoTypeUnion">
6620 <xs:annotation>
6621 <xs:documentation>
6622 Set to 'yes' to indicate that the value in the Id attribute is the name of a group of services.
6623 </xs:documentation>
6624 </xs:annotation>
6625 </xs:attribute>
6626 </xs:complexType>
6627 </xs:element>
6628 <xs:element name="ServiceInstall">
6629 <xs:annotation>
6630 <xs:documentation>
6631 Adds services for parent Component. Use the ServiceControl element to remove services.
6632 </xs:documentation>
6633 <xs:appinfo>
6634 <xse:msiRef table="ServiceInstall" href="http://msdn.microsoft.com/library/aa371637.aspx" />
6635 <xse:remarks>
6636 The service executable installed will point to the KeyPath for the Component.
6637 Therefore, you must ensure that the correct executable is either the first child
6638 File element under this Component or explicitly mark the appropriate File element
6639 as KeyPath='yes'.
6640 </xse:remarks>
6641 </xs:appinfo>
6642 </xs:annotation>
6643 <xs:complexType>
6644 <xs:choice minOccurs="0" maxOccurs="unbounded">
6645 <xs:element ref="PermissionEx">
6646 <xs:annotation>
6647 <xs:documentation>Configures the ACLs for this service.</xs:documentation>
6648 </xs:annotation>
6649 </xs:element>
6650 <xs:element ref="ServiceDependency">
6651 <xs:annotation>
6652 <xs:documentation>Ordered list of dependencies when installing services.</xs:documentation>
6653 </xs:annotation>
6654 </xs:element>
6655 <xs:element ref="ServiceConfig" />
6656 <xs:element ref="ServiceConfigFailureActions" />
6657 <xs:any namespace="##other" processContents="lax">
6658 <xs:annotation>
6659 <xs:documentation>
6660 Extensibility point in the WiX XML Schema. Schema extensions can register additional
6661 elements at this point in the schema.
6662 </xs:documentation>
6663 </xs:annotation>
6664 </xs:any>
6665 </xs:choice>
6666 <xs:attribute name="Id" type="xs:string">
6667 <xs:annotation>
6668 <xs:documentation>
6669 Unique identifier for this service configuration. This value will default to the Name attribute if not
6670 specified.
6671 </xs:documentation>
6672 </xs:annotation>
6673 </xs:attribute>
6674 <xs:attribute name="Name" type="xs:string" use="required">
6675 <xs:annotation>
6676 <xs:documentation>This column is the string that gives the service name to install.</xs:documentation>
6677 </xs:annotation>
6678 </xs:attribute>
6679 <xs:attribute name="DisplayName" type="xs:string">
6680 <xs:annotation>
6681 <xs:documentation>This column is the localizable string that user interface programs use to identify the service.</xs:documentation>
6682 </xs:annotation>
6683 </xs:attribute>
6684 <xs:attribute name="Type" use="required">
6685 <xs:annotation>
6686 <xs:documentation>The Windows Installer does not currently support kernelDriver or systemDriver.</xs:documentation>
6687 </xs:annotation>
6688 <xs:simpleType>
6689 <xs:restriction base="xs:NMTOKEN">
6690 <xs:enumeration value="ownProcess">
6691 <xs:annotation>
6692 <xs:documentation>
6693 A Win32 service that runs its own process.
6694 </xs:documentation>
6695 </xs:annotation>
6696 </xs:enumeration>
6697 <xs:enumeration value="shareProcess">
6698 <xs:annotation>
6699 <xs:documentation>
6700 A Win32 service that shares a process.
6701 </xs:documentation>
6702 </xs:annotation>
6703 </xs:enumeration>
6704 <xs:enumeration value="kernelDriver">
6705 <xs:annotation>
6706 <xs:documentation>
6707 A kernel driver service. This value is not currently supported by the Windows Installer.
6708 </xs:documentation>
6709 </xs:annotation>
6710 </xs:enumeration>
6711 <xs:enumeration value="systemDriver">
6712 <xs:annotation>
6713 <xs:documentation>
6714 A file system driver service. This value is not currently supported by the Windows Installer.
6715 </xs:documentation>
6716 </xs:annotation>
6717 </xs:enumeration>
6718 </xs:restriction>
6719 </xs:simpleType>
6720 </xs:attribute>
6721 <xs:attribute name="Interactive" type="YesNoTypeUnion">
6722 <xs:annotation>
6723 <xs:documentation>Whether or not the service interacts with the desktop.</xs:documentation>
6724 </xs:annotation>
6725 </xs:attribute>
6726 <xs:attribute name="Start" use="required">
6727 <xs:annotation>
6728 <xs:documentation>Determines when the service should be started. The Windows Installer does not support boot or system.</xs:documentation>
6729 </xs:annotation>
6730 <xs:simpleType>
6731 <xs:restriction base="xs:NMTOKEN">
6732 <xs:enumeration value="auto">
6733 <xs:annotation>
6734 <xs:documentation>
6735 The service will start during startup of the system.
6736 </xs:documentation>
6737 </xs:annotation>
6738 </xs:enumeration>
6739 <xs:enumeration value="demand">
6740 <xs:annotation>
6741 <xs:documentation>
6742 The service will start when the service control manager calls the StartService function.
6743 </xs:documentation>
6744 </xs:annotation>
6745 </xs:enumeration>
6746 <xs:enumeration value="disabled">
6747 <xs:annotation>
6748 <xs:documentation>
6749 The service can no longer be started.
6750 </xs:documentation>
6751 </xs:annotation>
6752 </xs:enumeration>
6753 <xs:enumeration value="boot">
6754 <xs:annotation>
6755 <xs:documentation>
6756 The service is a device driver that will be started by the operating system boot loader. This value is not currently supported by the Windows Installer.
6757 </xs:documentation>
6758 </xs:annotation>
6759 </xs:enumeration>
6760 <xs:enumeration value="system">
6761 <xs:annotation>
6762 <xs:documentation>
6763 The service is a device driver that will be started by the IoInitSystem function. This value is not currently supported by the Windows Installer.
6764 </xs:documentation>
6765 </xs:annotation>
6766 </xs:enumeration>
6767 </xs:restriction>
6768 </xs:simpleType>
6769 </xs:attribute>
6770 <xs:attribute name="ErrorControl" use="required">
6771 <xs:annotation>
6772 <xs:documentation>Determines what action should be taken on an error.</xs:documentation>
6773 </xs:annotation>
6774 <xs:simpleType>
6775 <xs:restriction base="xs:NMTOKEN">
6776 <xs:enumeration value="ignore">
6777 <xs:annotation>
6778 <xs:documentation>
6779 Logs the error and continues with the startup operation.
6780 </xs:documentation>
6781 </xs:annotation>
6782 </xs:enumeration>
6783 <xs:enumeration value="normal">
6784 <xs:annotation>
6785 <xs:documentation>
6786 Logs the error, displays a message box and continues the startup operation.
6787 </xs:documentation>
6788 </xs:annotation>
6789 </xs:enumeration>
6790 <xs:enumeration value="critical">
6791 <xs:annotation>
6792 <xs:documentation>
6793 Logs the error if it is possible and the system is restarted with the last configuration known to be good. If the last-known-good configuration is being started, the startup operation fails.
6794 </xs:documentation>
6795 </xs:annotation>
6796 </xs:enumeration>
6797 </xs:restriction>
6798 </xs:simpleType>
6799 </xs:attribute>
6800 <xs:attribute name="Vital" type="YesNoTypeUnion">
6801 <xs:annotation>
6802 <xs:documentation>The overall install should fail if this service fails to install.</xs:documentation>
6803 </xs:annotation>
6804 </xs:attribute>
6805 <xs:attribute name="LoadOrderGroup" type="xs:string">
6806 <xs:annotation>
6807 <xs:documentation>The load ordering group that this service should be a part of.</xs:documentation>
6808 </xs:annotation>
6809 </xs:attribute>
6810 <xs:attribute name="Account" type="xs:string">
6811 <xs:annotation>
6812 <xs:documentation>Fully qualified names must be used even for local accounts, e.g.: ".\LOCAL_ACCOUNT". Valid only when ServiceType is ownProcess.</xs:documentation>
6813 </xs:annotation>
6814 </xs:attribute>
6815 <xs:attribute name="Password" type="xs:string">
6816 <xs:annotation>
6817 <xs:documentation>The password for the account. Valid only when the account has a password.</xs:documentation>
6818 </xs:annotation>
6819 </xs:attribute>
6820 <xs:attribute name="Arguments" type="xs:string">
6821 <xs:annotation>
6822 <xs:documentation>Contains any command line arguments or properties required to run the service.</xs:documentation>
6823 </xs:annotation>
6824 </xs:attribute>
6825 <xs:attribute name="Description" type="xs:string">
6826 <xs:annotation>
6827 <xs:documentation>Sets the description of the service.</xs:documentation>
6828 </xs:annotation>
6829 </xs:attribute>
6830 <xs:attribute name="EraseDescription" type="YesNoTypeUnion">
6831 <xs:annotation>
6832 <xs:documentation>Determines whether the existing service description will be ignored. If 'yes', the service description will be null, even if the Description attribute is set.</xs:documentation>
6833 </xs:annotation>
6834 </xs:attribute>
6835 </xs:complexType>
6836 </xs:element>
6837 <xs:element name="ServiceArgument" type="xs:string">
6838 <xs:annotation>
6839 <xs:documentation>
6840 Argument used in ServiceControl parent
6841 </xs:documentation>
6842 <xs:appinfo>
6843 <xse:msiRef table="ServiceControl" href="http://msdn.microsoft.com/library/aa371634.aspx" />
6844 </xs:appinfo>
6845 </xs:annotation>
6846 </xs:element>
6847 <xs:element name="ServiceControl">
6848 <xs:annotation>
6849 <xs:documentation>
6850 Starts, stops, and removes services for parent Component. This element is used to control the state
6851 of a service installed by the MSI or MSM file by using the start, stop and remove attributes.
6852 For example, Start='install' Stop='both' Remove='uninstall' would mean: start the service on install,
6853 remove the service when the product is uninstalled, and stop the service both on install and uninstall.
6854 </xs:documentation>
6855 <xs:appinfo>
6856 <xse:msiRef table="ServiceControl" href="http://msdn.microsoft.com/library/aa371634.aspx" />
6857 </xs:appinfo>
6858 </xs:annotation>
6859 <xs:complexType>
6860 <xs:sequence>
6861 <xs:element ref="ServiceArgument" minOccurs="0" maxOccurs="unbounded">
6862 <xs:annotation>
6863 <xs:documentation>Ordered list of arguments used when modifying services.</xs:documentation>
6864 </xs:annotation>
6865 </xs:element>
6866 </xs:sequence>
6867 <xs:attribute name="Id" type="xs:string" use="required" />
6868 <xs:attribute name="Name" type="xs:string" use="required">
6869 <xs:annotation>
6870 <xs:documentation>Name of the service.</xs:documentation>
6871 </xs:annotation>
6872 </xs:attribute>
6873 <xs:attribute name="Start" type="InstallUninstallType">
6874 <xs:annotation>
6875 <xs:documentation>
6876 Specifies whether the service should be started by the StartServices action on install, uninstall or both.
6877 For 'install', the service will be started only when the parent component is being installed (msiInstallStateLocal or
6878 msiInstallStateSource); for 'uninstall', the service will be started only when the parent component
6879 is being removed (msiInstallStateAbsent); for 'both', the service will be started in both cases.
6880 </xs:documentation>
6881 </xs:annotation>
6882 </xs:attribute>
6883 <xs:attribute name="Stop" type="InstallUninstallType">
6884 <xs:annotation>
6885 <xs:documentation>
6886 Specifies whether the service should be stopped by the StopServices action on install, uninstall or both.
6887 For 'install', the service will be stopped only when the parent component is being installed (msiInstallStateLocal or
6888 msiInstallStateSource); for 'uninstall', the service will be stopped only when the parent component
6889 is being removed (msiInstallStateAbsent); for 'both', the service will be stopped in both cases.
6890 </xs:documentation>
6891 </xs:annotation>
6892 </xs:attribute>
6893 <xs:attribute name="Remove" type="InstallUninstallType">
6894 <xs:annotation>
6895 <xs:documentation>
6896 Specifies whether the service should be removed by the DeleteServices action on install, uninstall or both.
6897 For 'install', the service will be removed only when the parent component is being installed (msiInstallStateLocal or
6898 msiInstallStateSource); for 'uninstall', the service will be removed only when the parent component
6899 is being removed (msiInstallStateAbsent); for 'both', the service will be removed in both cases.
6900 </xs:documentation>
6901 </xs:annotation>
6902 </xs:attribute>
6903 <xs:attribute name="Wait" type="YesNoTypeUnion">
6904 <xs:annotation>
6905 <xs:documentation>Specifies whether or not to wait for the service to complete before continuing. The default is 'yes'.</xs:documentation>
6906 </xs:annotation>
6907 </xs:attribute>
6908 </xs:complexType>
6909 </xs:element>
6910 <xs:element name="RequiredPrivilege" type="xs:string">
6911 <xs:annotation>
6912 <xs:documentation>
6913 Privilege required by service configured by ServiceConfig parent. Valid values are a <html:a href="http://msdn.microsoft.com/en-us/library/bb530716.aspx">privilege constant</html:a> or a
6914 Formatted property that resolves to a privilege constant.
6915 </xs:documentation>
6916 <xs:appinfo>
6917 <xse:msiRef table="MsiServiceConfig" href="http://msdn.microsoft.com/en-us/library/windows/desktop/dd408038.aspx" />
6918 </xs:appinfo>
6919 </xs:annotation>
6920 </xs:element>
6921 <xs:element name="ServiceConfig">
6922 <xs:annotation>
6923 <xs:documentation>
6924 Configures a service being installed or one that already exists. This element's functionality is available starting with MSI 5.0.
6925 </xs:documentation>
6926 <xs:appinfo>
6927 <xse:msiRef table="MsiServiceConfig" href="http://msdn.microsoft.com/library/aa371637.aspx" />
6928 </xs:appinfo>
6929 </xs:annotation>
6930 <xs:complexType>
6931 <xs:choice minOccurs="0" maxOccurs="unbounded">
6932 <xs:element ref="RequiredPrivilege">
6933 <xs:annotation>
6934 <xs:documentation>List of privileges to apply to service.</xs:documentation>
6935 </xs:annotation>
6936 </xs:element>
6937 </xs:choice>
6938 <xs:attribute name="Id" type="xs:string">
6939 <xs:annotation>
6940 <xs:documentation>
6941 Unique identifier for this service configuration. This value will default to the ServiceName attribute if not
6942 specified.
6943 </xs:documentation>
6944 </xs:annotation>
6945 </xs:attribute>
6946 <xs:attribute name="DelayedAutoStart" type="xs:string">
6947 <xs:annotation>
6948 <xs:documentation>
6949 This attribute specifies whether an auto-start service should delay its start until after all other auto-start
6950 services. This attribute only affects auto-start services. Allowed values are "yes", "no" or a Formatted property that
6951 resolves to "1" (for "yes") or "0" (for "no"). If this attribute is not present the setting is not configured.
6952 </xs:documentation>
6953 </xs:annotation>
6954 </xs:attribute>
6955 <xs:attribute name="FailureActionsWhen" type="xs:string">
6956 <xs:annotation>
6957 <xs:documentation>
6958 This attribute specifies when failure actions should be applied. Allowed values are "failedToStop", "failedToStopOrReturnedError"
6959 or a Formatted property that resolves to "1" (for "failedToStopOrReturnedError") or "0" (for "failedToStop"). If this attribute
6960 is not present the setting is not configured.
6961 </xs:documentation>
6962 </xs:annotation>
6963 </xs:attribute>
6964 <xs:attribute name="PreShutdownDelay" type="xs:string">
6965 <xs:annotation>
6966 <xs:documentation>
6967 This attribute specifies time in milliseconds that the Service Control Manager (SCM) waits after notifying the service of a system
6968 shutdown. If this attribute is not present the default value, 3 minutes, is used.
6969 </xs:documentation>
6970 </xs:annotation>
6971 </xs:attribute>
6972 <xs:attribute name="OnInstall" type="YesNoTypeUnion">
6973 <xs:annotation>
6974 <xs:documentation>
6975 Specifies whether to configure the service when the parent Component is installed. This attribute may be combined with OnReinstall
6976 and OnUninstall.
6977 </xs:documentation>
6978 </xs:annotation>
6979 </xs:attribute>
6980 <xs:attribute name="OnReinstall" type="YesNoTypeUnion">
6981 <xs:annotation>
6982 <xs:documentation>
6983 Specifies whether to configure the service when the parent Component is reinstalled. This attribute may be combined with OnInstall
6984 and OnUninstall.
6985 </xs:documentation>
6986 </xs:annotation>
6987 </xs:attribute>
6988 <xs:attribute name="OnUninstall" type="YesNoTypeUnion">
6989 <xs:annotation>
6990 <xs:documentation>
6991 Specifies whether to configure the service when the parent Component is uninstalled. This attribute may be combined with OnInstall
6992 and OnReinstall.
6993 </xs:documentation>
6994 </xs:annotation>
6995 </xs:attribute>
6996 <xs:attribute name="ServiceName" type="xs:string">
6997 <xs:annotation>
6998 <xs:documentation>
6999 Specifies the name of the service to configure. This value will default to the ServiceInstall/@Name attribute when nested under
7000 a ServiceInstall element.
7001 </xs:documentation>
7002 </xs:annotation>
7003 </xs:attribute>
7004 <xs:attribute name="ServiceSid" type="xs:string">
7005 <xs:annotation>
7006 <xs:documentation>
7007 Specifies the service SID to apply to the service. Valid values are "none", "restricted", "unrestricted" or a Formatted property
7008 that resolves to "0" (for "none"), "3" (for "restricted") or "1" (for "unrestricted"). If this attribute is not present the
7009 setting is not configured.
7010 </xs:documentation>
7011 </xs:annotation>
7012 </xs:attribute>
7013 </xs:complexType>
7014 </xs:element>
7015 <xs:element name="Failure">
7016 <xs:annotation>
7017 <xs:documentation>Failure action for a ServiceConfigFailureActions element.</xs:documentation>
7018 </xs:annotation>
7019 <xs:complexType>
7020 <xs:attribute name="Action" type="xs:string" use="required">
7021 <xs:annotation>
7022 <xs:documentation>
7023 Specifies the action to take when the service fails. Valid values are "none", "restartComputer", "restartService", "runCommand" or a Formatted property
7024 that resolves to "0" (for "none"), "1" (for "restartService"), "2" (for "restartComputer") or "3" (for "runCommand").
7025 </xs:documentation>
7026 </xs:annotation>
7027 </xs:attribute>
7028 <xs:attribute name="Delay" type="xs:string" use="required">
7029 <xs:annotation>
7030 <xs:documentation>
7031 Specifies the time in milliseconds to wait before performing the value from the Action attribute.
7032 </xs:documentation>
7033 </xs:annotation>
7034 </xs:attribute>
7035 </xs:complexType>
7036 </xs:element>
7037 <xs:element name="ServiceConfigFailureActions">
7038 <xs:annotation>
7039 <xs:documentation>
7040 Configures the failure actions for a service being installed or one that already exists. This element's functionality is available starting with MSI 5.0.
7041 </xs:documentation>
7042 <xs:appinfo>
7043 <xse:msiRef table="MsiServiceConfigFailureActions" href="http://msdn.microsoft.com/en-us/library/dd408037.aspx" />
7044 </xs:appinfo>
7045 </xs:annotation>
7046 <xs:complexType>
7047 <xs:choice minOccurs="0" maxOccurs="unbounded">
7048 <xs:element ref="Failure">
7049 <xs:annotation>
7050 <xs:documentation>Ordered list of failure actions to apply to service.</xs:documentation>
7051 </xs:annotation>
7052 </xs:element>
7053 </xs:choice>
7054 <xs:attribute name="Id" type="xs:string">
7055 <xs:annotation>
7056 <xs:documentation>
7057 Unique identifier for this service configuration. This value will default to the ServiceName attribute if not
7058 specified.
7059 </xs:documentation>
7060 </xs:annotation>
7061 </xs:attribute>
7062 <xs:attribute name="Command" type="xs:string">
7063 <xs:annotation>
7064 <xs:documentation>
7065 This attribute specifies command to execute when a "runCommand" failure action hit. If an empty string is provided it clears
7066 the existing command. If this attribute is not present the setting is not changed.
7067 </xs:documentation>
7068 </xs:annotation>
7069 </xs:attribute>
7070 <xs:attribute name="OnInstall" type="YesNoTypeUnion">
7071 <xs:annotation>
7072 <xs:documentation>
7073 Specifies whether to configure the service when the parent Component is installed. This attribute may be combined with OnReinstall
7074 and OnUninstall.
7075 </xs:documentation>
7076 </xs:annotation>
7077 </xs:attribute>
7078 <xs:attribute name="OnReinstall" type="YesNoTypeUnion">
7079 <xs:annotation>
7080 <xs:documentation>
7081 Specifies whether to configure the service when the parent Component is reinstalled. This attribute may be combined with OnInstall
7082 and OnUninstall.
7083 </xs:documentation>
7084 </xs:annotation>
7085 </xs:attribute>
7086 <xs:attribute name="OnUninstall" type="YesNoTypeUnion">
7087 <xs:annotation>
7088 <xs:documentation>
7089 Specifies whether to configure the service when the parent Component is uninstalled. This attribute may be combined with OnInstall
7090 and OnReinstall.
7091 </xs:documentation>
7092 </xs:annotation>
7093 </xs:attribute>
7094 <xs:attribute name="RebootMessage" type="xs:string">
7095 <xs:annotation>
7096 <xs:documentation>
7097 Specifies the message to show for a reboot failure action. If an empty string is provided it clears any existing reboot message. If this
7098 attribute is not present the setting is not changed.
7099 </xs:documentation>
7100 </xs:annotation>
7101 </xs:attribute>
7102 <xs:attribute name="ResetPeriod" type="xs:string">
7103 <xs:annotation>
7104 <xs:documentation>
7105 Specifies the time in seconds to reset the failure count. If this attribute is not present the failure count will not be reset.
7106 </xs:documentation>
7107 </xs:annotation>
7108 </xs:attribute>
7109 <xs:attribute name="ServiceName" type="xs:string">
7110 <xs:annotation>
7111 <xs:documentation>
7112 Specifies the name of the service to configure. This value will default to the ServiceInstall/@Name attribute when nested under
7113 a ServiceInstall element.
7114 </xs:documentation>
7115 </xs:annotation>
7116 </xs:attribute>
7117 </xs:complexType>
7118 </xs:element>
7119 <xs:element name="Environment">
7120 <xs:annotation>
7121 <xs:documentation>
7122 Environment variables added or removed for the parent component.
7123 </xs:documentation>
7124 <xs:appinfo>
7125 <xse:msiRef table="Environment" href="http://msdn.microsoft.com/library/aa368369.aspx" />
7126 </xs:appinfo>
7127 </xs:annotation>
7128 <xs:complexType>
7129 <xs:attribute name="Id" type="xs:string" use="required">
7130 <xs:annotation>
7131 <xs:documentation>Unique identifier for environment entry.</xs:documentation>
7132 </xs:annotation>
7133 </xs:attribute>
7134 <xs:attribute name="Name" type="xs:string" use="required">
7135 <xs:annotation>
7136 <xs:documentation>Name of the environment variable.</xs:documentation>
7137 </xs:annotation>
7138 </xs:attribute>
7139 <xs:attribute name="Value" type="xs:string">
7140 <xs:annotation>
7141 <xs:documentation>
7142 The value to set into the environment variable.
7143 If this attribute is not set, the environment variable is removed during installation if it exists on the machine.
7144 </xs:documentation>
7145 </xs:annotation>
7146 </xs:attribute>
7147 <xs:attribute name="Separator" type="xs:string">
7148 <xs:annotation>
7149 <xs:documentation>Optional attribute to change the separator used between values. By default a semicolon is used.</xs:documentation>
7150 </xs:annotation>
7151 </xs:attribute>
7152 <xs:attribute name="Action">
7153 <xs:annotation>
7154 <xs:documentation>Specfies whether the environmental variable should be created, set or removed when the parent component is installed.</xs:documentation>
7155 </xs:annotation>
7156 <xs:simpleType>
7157 <xs:restriction base="xs:NMTOKEN">
7158 <xs:enumeration value="create">
7159 <xs:annotation>
7160 <xs:documentation>Creates the environment variable if it does not exist, then set it during installation. This has no effect on the value of the environment variable if it already exists.</xs:documentation>
7161 </xs:annotation>
7162 </xs:enumeration>
7163 <xs:enumeration value="set">
7164 <xs:annotation>
7165 <xs:documentation>Creates the environment variable if it does not exist, and then set it during installation. If the environment variable exists, set it during the installation.</xs:documentation>
7166 </xs:annotation>
7167 </xs:enumeration>
7168 <xs:enumeration value="remove">
7169 <xs:annotation>
7170 <xs:documentation>
7171 Removes the environment variable during an installation.
7172 The installer only removes an environment variable during an installation if the name and value
7173 of the variable match the entries in the Name and Value attributes.
7174 If you want to remove an environment variable, regardless of its value, do not set the Value attribute.
7175 </xs:documentation>
7176 </xs:annotation>
7177 </xs:enumeration>
7178 </xs:restriction>
7179 </xs:simpleType>
7180 </xs:attribute>
7181 <xs:attribute name="Part">
7182 <xs:simpleType>
7183 <xs:restriction base="xs:NMTOKEN">
7184 <xs:enumeration value="all">
7185 <xs:annotation>
7186 <xs:documentation>
7187 This value is the entire environmental variable. This is the default.
7188 </xs:documentation>
7189 </xs:annotation>
7190 </xs:enumeration>
7191 <xs:enumeration value="first">
7192 <xs:annotation>
7193 <xs:documentation>
7194 This value is prefixed.
7195 </xs:documentation>
7196 </xs:annotation>
7197 </xs:enumeration>
7198 <xs:enumeration value="last">
7199 <xs:annotation>
7200 <xs:documentation>
7201 This value is appended.
7202 </xs:documentation>
7203 </xs:annotation>
7204 </xs:enumeration>
7205 </xs:restriction>
7206 </xs:simpleType>
7207 </xs:attribute>
7208 <xs:attribute name="Permanent" type="YesNoTypeUnion">
7209 <xs:annotation>
7210 <xs:documentation>Specifies that the environment variable should not be removed on uninstall.</xs:documentation>
7211 </xs:annotation>
7212 </xs:attribute>
7213 <xs:attribute name="System" type="YesNoTypeUnion">
7214 <xs:annotation>
7215 <xs:documentation>
7216 Specifies that the environment variable should be added to the system environment space. The default
7217 is 'no' which indicates the environment variable is added to the user environment space.
7218 </xs:documentation>
7219 </xs:annotation>
7220 </xs:attribute>
7221 </xs:complexType>
7222 </xs:element>
7223 <xs:element name="Condition">
7224 <xs:annotation>
7225 <xs:documentation>
7226 Conditions for components, controls, features, and products. The condition is specified in the inner text of the element.
7227 </xs:documentation>
7228 <xs:appinfo>
7229 <xse:msiRef table="Component" href="http://msdn.microsoft.com/library/aa368007.aspx" />
7230 <xse:msiRef table="ControlCondition" href="http://msdn.microsoft.com/library/aa368035.aspx" />
7231 <xse:msiRef table="Condition" href="http://msdn.microsoft.com/library/aa368014.aspx" />
7232 <xse:msiRef table="LaunchCondition" href="http://msdn.microsoft.com/library/aa369752.aspx" />
7233 <xse:howtoRef href="redistributables_and_install_checks/block_install_on_os.html">How To: Block installation based on OS version</xse:howtoRef>
7234 <xse:howtoRef href="files_and_registry/check_the_version_number.html">How To: Check the version number of a file during installation</xse:howtoRef>
7235 </xs:appinfo>
7236 </xs:annotation>
7237 <xs:complexType>
7238 <xs:simpleContent>
7239 <xs:extension base="xs:string">
7240 <xs:annotation>
7241 <xs:documentation>
7242 Under a Component element, the condition becomes the condition of the component. Under a Control element,
7243 the condition becomes a ControlCondition entry. Under a Feature element, the condition becomes a Condition
7244 entry. Under a Fragment or Product element, the condition becomes a LaunchCondition entry.
7245 </xs:documentation>
7246 </xs:annotation>
7247 <xs:attribute name="Action">
7248 <xs:annotation>
7249 <xs:documentation>
7250 Used only under Control elements and is required. Allows specific actions to be applied to a control based
7251 on the result of this condition.
7252 </xs:documentation>
7253 </xs:annotation>
7254 <xs:simpleType>
7255 <xs:restriction base="xs:NMTOKEN">
7256 <xs:enumeration value="default">
7257 <xs:annotation>
7258 <xs:documentation>
7259 Set the Control as the default. Only used under Control elements.
7260 </xs:documentation>
7261 </xs:annotation>
7262 </xs:enumeration>
7263 <xs:enumeration value="enable">
7264 <xs:annotation>
7265 <xs:documentation>
7266 Enable the Control. Only used under Control elements.
7267 </xs:documentation>
7268 </xs:annotation>
7269 </xs:enumeration>
7270 <xs:enumeration value="disable">
7271 <xs:annotation>
7272 <xs:documentation>
7273 Disable the Control. Only used under Control elements.
7274 </xs:documentation>
7275 </xs:annotation>
7276 </xs:enumeration>
7277 <xs:enumeration value="hide">
7278 <xs:annotation>
7279 <xs:documentation>
7280 Hide the Control. Only used under Control elements.
7281 </xs:documentation>
7282 </xs:annotation>
7283 </xs:enumeration>
7284 <xs:enumeration value="show">
7285 <xs:annotation>
7286 <xs:documentation>
7287 Display the Control. Only used under Control elements.
7288 </xs:documentation>
7289 </xs:annotation>
7290 </xs:enumeration>
7291 </xs:restriction>
7292 </xs:simpleType>
7293 </xs:attribute>
7294 <xs:attribute name="Level" type="xs:integer">
7295 <xs:annotation>
7296 <xs:documentation>
7297 Used only under Feature elements and is required. Allows modifying the level of a Feature based on the
7298 result of this condition.
7299 </xs:documentation>
7300 </xs:annotation>
7301 </xs:attribute>
7302 <xs:attribute name="Message" type="xs:string">
7303 <xs:annotation>
7304 <xs:documentation>
7305 Used only under Fragment or Product elements and is required. Set the value to the text to display when the
7306 condition fails and the installation must be terminated.
7307 </xs:documentation>
7308 </xs:annotation>
7309 </xs:attribute>
7310 </xs:extension>
7311 </xs:simpleContent>
7312 </xs:complexType>
7313 </xs:element>
7314 <xs:element name="IsolateComponent">
7315 <xs:annotation>
7316 <xs:documentation>
7317 Shared Component to be privately replicated in folder of parent Component
7318 </xs:documentation>
7319 <xs:appinfo>
7320 <xse:msiRef table="IsolateComponent" href="http://msdn.microsoft.com/library/aa369730.aspx" />
7321 </xs:appinfo>
7322 </xs:annotation>
7323 <xs:complexType>
7324 <xs:attribute name="Shared" type="xs:string" use="required">
7325 <xs:annotation>
7326 <xs:documentation>Shared Component for this application Component.</xs:documentation>
7327 </xs:annotation>
7328 </xs:attribute>
7329 </xs:complexType>
7330 </xs:element>
7331 <xs:element name="ReserveCost">
7332 <xs:annotation>
7333 <xs:documentation>
7334 Disk cost to reserve in a folder for running locally and/or from source.
7335 </xs:documentation>
7336 <xs:appinfo>
7337 <xse:msiRef table="ReserveCost" href="http://msdn.microsoft.com/library/aa371226.aspx" />
7338 </xs:appinfo>
7339 </xs:annotation>
7340 <xs:complexType>
7341 <xs:attribute name="Id" type="xs:string" use="required">
7342 <xs:annotation>
7343 <xs:documentation>A primary key that uniquely identifies this ReserveCost entry.</xs:documentation>
7344 </xs:annotation>
7345 </xs:attribute>
7346 <xs:attribute name="Directory" type="xs:string">
7347 <xs:annotation>
7348 <xs:documentation>
7349 Adds the amount of disk space specified in RunFromSource or RunLocal to the volume cost of the device containing the directory.
7350 If this attribute is not set, it will default to the directory of parent component.
7351 </xs:documentation>
7352 </xs:annotation>
7353 </xs:attribute>
7354 <xs:attribute name="RunFromSource" type="xs:integer" use="required">
7355 <xs:annotation>
7356 <xs:documentation>The number of bytes of disk space to reserve if the component is installed to run from source.</xs:documentation>
7357 </xs:annotation>
7358 </xs:attribute>
7359 <xs:attribute name="RunLocal" type="xs:integer" use="required">
7360 <xs:annotation>
7361 <xs:documentation>The number of bytes of disk space to reserve if the component is installed to run locally.</xs:documentation>
7362 </xs:annotation>
7363 </xs:attribute>
7364 </xs:complexType>
7365 </xs:element>
7366 <xs:element name="Component">
7367 <xs:annotation>
7368 <xs:documentation>Component for parent Directory</xs:documentation>
7369 <xs:appinfo>
7370 <xse:seeAlso ref="ComponentRef" />
7371 <xse:seeAlso ref="Media" />
7372 <xse:msiRef table="Component" href="http://msdn.microsoft.com/library/aa368007.aspx" />
7373 <xse:msiRef table="Condition" href="http://msdn.microsoft.com/library/aa368014.aspx" />
7374 <xse:msiRef table="Directory" href="http://msdn.microsoft.com/library/aa368295.aspx" />
7375 <xse:howtoRef href="files_and_registry/add_a_file.html">How To: Add a file to your installer</xse:howtoRef>
7376 </xs:appinfo>
7377 </xs:annotation>
7378 <xs:complexType>
7379 <xs:choice minOccurs="0" maxOccurs="unbounded">
7380 <xs:element ref="AppId" />
7381 <xs:element ref="Category" />
7382 <xs:element ref="Class" />
7383 <xs:element ref="Condition" />
7384 <xs:element ref="CopyFile" />
7385 <xs:element ref="CreateFolder" />
7386 <xs:element ref="Environment" />
7387 <xs:element ref="Extension" />
7388 <xs:element ref="File" />
7389 <xs:element ref="IniFile" />
7390 <xs:element ref="Interface" />
7391 <xs:element ref="IsolateComponent" />
7392 <xs:element ref="ODBCDataSource" />
7393 <xs:element ref="ODBCDriver" />
7394 <xs:element ref="ODBCTranslator" />
7395 <xs:element ref="ProgId" />
7396 <xs:element ref="Registry" />
7397 <xs:element ref="RegistryKey" />
7398 <xs:element ref="RegistryValue" />
7399 <xs:element ref="RemoveFile" />
7400 <xs:element ref="RemoveFolder" />
7401 <xs:element ref="RemoveRegistryKey" />
7402 <xs:element ref="RemoveRegistryValue" />
7403 <xs:element ref="ReserveCost" />
7404 <xs:element ref="ServiceControl" />
7405 <xs:element ref="ServiceConfig" />
7406 <xs:element ref="ServiceConfigFailureActions" />
7407 <xs:element ref="ServiceInstall" />
7408 <xs:element ref="Shortcut" />
7409 <xs:element ref="SymbolPath" />
7410 <xs:element ref="TypeLib" />
7411 <xs:any namespace="##other" processContents="lax">
7412 <xs:annotation>
7413 <xs:documentation>
7414 Extensibility point in the WiX XML Schema. Schema extensions can register additional
7415 elements at this point in the schema.
7416 </xs:documentation>
7417 </xs:annotation>
7418 </xs:any>
7419 </xs:choice>
7420 <xs:attribute name="Id" type="xs:string">
7421 <xs:annotation>
7422 <xs:documentation>
7423 Component identifier; this is the primary key for identifying components. If omitted,
7424 the compiler defaults the identifier to the identifier of the resource that is the
7425 explicit keypath of the component (for example, a child File element with KeyPath
7426 attribute with value 'yes'.
7427 </xs:documentation>
7428 </xs:annotation>
7429 </xs:attribute>
7430 <xs:attribute name="ComPlusFlags" type="xs:integer">
7431 <xs:annotation>
7432 <xs:documentation>
7433 Set this attribute to create a ComPlus entry. The value should be the export flags used
7434 during the generation of the .msi file. For more information see the COM+ documentation
7435 in the Platform SDK.
7436 </xs:documentation>
7437 </xs:annotation>
7438 </xs:attribute>
7439 <xs:attribute name="DisableRegistryReflection" type="YesNoTypeUnion">
7440 <xs:annotation>
7441 <xs:documentation>
7442 Set this attribute to 'yes' in order to disable registry reflection on all existing and
7443 new registry keys affected by this component.
7444 When set to 'yes', the Windows Installer calls the RegDisableReflectionKey on each key
7445 being accessed by the component.
7446 This bit is available with Windows Installer version 4.0 and is ignored on 32-bit systems.
7447 </xs:documentation>
7448 </xs:annotation>
7449 </xs:attribute>
7450 <xs:attribute name="Directory" type="xs:string">
7451 <xs:annotation>
7452 <xs:documentation>
7453 Sets the Directory of the Component. If this element is nested under a Directory element,
7454 this value defaults to the value of the parent Directory/@Id.
7455 </xs:documentation>
7456 </xs:annotation>
7457 </xs:attribute>
7458 <xs:attribute name="DiskId" type="DiskIdType">
7459 <xs:annotation>
7460 <xs:documentation>
7461 This attribute provides a default DiskId attribute for all child File elements. Specifying
7462 the DiskId on a Component element will override any DiskId attributes set by parent Directory
7463 or DirectoryRef elements. See the File element's DiskId attribute for more information about
7464 the purpose of the DiskId.
7465 </xs:documentation>
7466 </xs:annotation>
7467 </xs:attribute>
7468 <xs:attribute name="Feature" type="xs:string">
7469 <xs:annotation>
7470 <xs:documentation>
7471 Identifies a feature to which this component belongs, as a shorthand for a child
7472 ComponentRef element of the Feature element. The value of this attribute should
7473 correspond to the Id attribute of a Feature element authored elsewhere. Note that
7474 a single component can belong to multiple features but this attribute allows you
7475 to specify only a single feature.
7476 </xs:documentation>
7477 </xs:annotation>
7478 </xs:attribute>
7479 <xs:attribute name="Guid" type="ComponentGuid">
7480 <xs:annotation>
7481 <xs:documentation>
7482 This value should be a guid that uniquely identifies this component's contents, language, platform, and version.
7483 If omitted, the default value is '*' which indicates that the linker should generate a stable guid.
7484 Generatable guids are supported only for components with a single file as the component's keypath
7485 or no files and a registry value as the keypath.
7486 It's also possible to set the value to an empty string to specify an unmanaged component.
7487 Unmanaged components are a security vulnerability because the component cannot be removed or repaired
7488 by Windows Installer (it is essentially an unpatchable, permanent component). Therefore, a guid should
7489 always be specified for any component which contains resources that may need to be patched in the future.
7490 </xs:documentation>
7491 </xs:annotation>
7492 </xs:attribute>
7493 <xs:attribute name="KeyPath" type="YesNoTypeUnion">
7494 <xs:annotation>
7495 <xs:documentation>
7496 If this attribute's value is set to 'yes', then the Directory of this Component is used
7497 as the KeyPath. To set a Registry value or File as the KeyPath of a component, set the
7498 KeyPath attribute to 'yes' on one of those child elements. If KeyPath is not set to 'yes' for the
7499 Component or for a child Registry value or File, WiX will look at the child elements under the
7500 Component in sequential order and try to automatically select one of them as a key path. Allowing
7501 WiX to automatically select a key path can be dangerous because adding or removing child elements
7502 under the Component can inadvertantly cause the key path to change, which can lead to
7503 installation problems.
7504 </xs:documentation>
7505 </xs:annotation>
7506 </xs:attribute>
7507 <xs:attribute name="Location">
7508 <xs:annotation>
7509 <xs:documentation>
7510 Optional value that specifies the location that the component can be run from.
7511 </xs:documentation>
7512 </xs:annotation>
7513 <xs:simpleType>
7514 <xs:restriction base="xs:NMTOKEN">
7515 <xs:enumeration value="local">
7516 <xs:annotation>
7517 <xs:documentation>
7518 Prevents the component from running from the source or the network (this is the default behavior if this attribute is not set).
7519 </xs:documentation>
7520 </xs:annotation>
7521 </xs:enumeration>
7522 <xs:enumeration value="source">
7523 <xs:annotation>
7524 <xs:documentation>
7525 Enforces that the component can only be run from the source (it cannot be run from the user's computer).
7526 </xs:documentation>
7527 </xs:annotation>
7528 </xs:enumeration>
7529 <xs:enumeration value="either">
7530 <xs:annotation>
7531 <xs:documentation>
7532 Allows the component to run from source or locally.
7533 </xs:documentation>
7534 </xs:annotation>
7535 </xs:enumeration>
7536 </xs:restriction>
7537 </xs:simpleType>
7538 </xs:attribute>
7539 <xs:attribute name="MultiInstance" type="YesNoTypeUnion">
7540 <xs:annotation>
7541 <xs:documentation>
7542 If this attribute is set to 'yes', a new Component/@Guid will be generated for each
7543 instance transform. Ensure that all of the resources contained in a multi-instance
7544 Component will be installed to different paths based on the instance Property; otherwise,
7545 the Component Rules will be violated.
7546 </xs:documentation>
7547 </xs:annotation>
7548 </xs:attribute>
7549 <xs:attribute name="NeverOverwrite" type="YesNoTypeUnion">
7550 <xs:annotation>
7551 <xs:documentation>
7552 If this attribute is set to 'yes', the installer does not install or reinstall the
7553 component if a key path file or a key path registry entry for the component already
7554 exists. The application does register itself as a client of the component. Use this
7555 flag only for components that are being registered by the Registry table. Do not use
7556 this flag for components registered by the AppId, Class, Extension, ProgId, MIME, and
7557 Verb tables.
7558 </xs:documentation>
7559 </xs:annotation>
7560 </xs:attribute>
7561 <xs:attribute name="Permanent" type="YesNoTypeUnion">
7562 <xs:annotation>
7563 <xs:documentation>
7564 If this attribute is set to 'yes', the installer does not remove the component during
7565 an uninstall. The installer registers an extra system client for the component in
7566 the Windows Installer registry settings (which basically just means that at least one
7567 product is always referencing this component). Note that this option differs from the
7568 behavior of not setting a guid because although the component is permanent, it is still
7569 patchable (because Windows Installer still tracks it), it's just not uninstallable.
7570 </xs:documentation>
7571 </xs:annotation>
7572 </xs:attribute>
7573 <xs:attribute name="Shared" type="YesNoTypeUnion">
7574 <xs:annotation>
7575 <xs:documentation>
7576 If this attribute's value is set to 'yes', enables advanced patching semantics for
7577 Components that are shared across multiple Products. Specifically, the Windows Installer
7578 will cache the shared files to improve patch uninstall. This functionality is available
7579 in Windows Installer 4.5 and later.
7580 </xs:documentation>
7581 </xs:annotation>
7582 </xs:attribute>
7583 <xs:attribute name="SharedDllRefCount" type="YesNoTypeUnion">
7584 <xs:annotation>
7585 <xs:documentation>
7586 If this attribute's value is set to 'yes', the installer increments the reference count
7587 in the shared DLL registry of the component's key file. If this bit is not set, the
7588 installer increments the reference count only if the reference count already exists.
7589 </xs:documentation>
7590 </xs:annotation>
7591 </xs:attribute>
7592 <xs:attribute name="Transitive" type="YesNoTypeUnion">
7593 <xs:annotation>
7594 <xs:documentation>
7595 If this attribute is set to 'yes', the installer reevaluates the value of the statement
7596 in the Condition upon a reinstall. If the value was previously False and has changed to
7597 True, the installer installs the component. If the value was previously True and has
7598 changed to False, the installer removes the component even if the component has other
7599 products as clients.
7600 </xs:documentation>
7601 </xs:annotation>
7602 </xs:attribute>
7603 <xs:attribute name="UninstallWhenSuperseded" type="YesNoTypeUnion">
7604 <xs:annotation>
7605 <xs:documentation>
7606 If this attribute is set to 'yes', the installer will uninstall the Component's files
7607 and registry keys when it is superseded by a patch. This functionality is available in
7608 Windows Installer 4.5 and later.
7609 </xs:documentation>
7610 </xs:annotation>
7611 </xs:attribute>
7612 <xs:attribute name="Win64" type="YesNoTypeUnion">
7613 <xs:annotation>
7614 <xs:documentation>
7615 Set this attribute to 'yes' to mark this as a 64-bit component. This attribute facilitates
7616 the installation of packages that include both 32-bit and 64-bit components. If this is a 64-bit
7617 component replacing a 32-bit component, set this attribute to 'yes' and assign a new GUID in the Guid attribute.
7618 The default value is based on the platform set by the -arch switch to candle.exe
7619 or the InstallerPlatform property in a .wixproj MSBuild project:
7620 For x86 and ARM, the default value is 'no'.
7621 For x64 and IA64, the default value is 'yes'.
7622 </xs:documentation>
7623 </xs:annotation>
7624 </xs:attribute>
7625 <xs:anyAttribute namespace="##other" processContents="lax">
7626 <xs:annotation>
7627 <xs:documentation>
7628 Extensibility point in the WiX XML Schema. Schema extensions can register additional
7629 attributes at this point in the schema.
7630 </xs:documentation>
7631 </xs:annotation>
7632 </xs:anyAttribute>
7633 </xs:complexType>
7634 </xs:element>
7635 <xs:element name="ComponentGroup">
7636 <xs:annotation>
7637 <xs:documentation>
7638 Groups together multiple components to be used in other locations.
7639 </xs:documentation>
7640 <xs:appinfo>
7641 <xse:seeAlso ref="ComponentGroupRef" />
7642 </xs:appinfo>
7643 </xs:annotation>
7644 <xs:complexType>
7645 <xs:choice minOccurs="0" maxOccurs="unbounded">
7646 <xs:element ref="Component" />
7647 <xs:element ref="ComponentGroupRef" />
7648 <xs:element ref="ComponentRef" />
7649 <xs:any namespace="##other" processContents="lax">
7650 <xs:annotation>
7651 <xs:documentation>
7652 Extensibility point in the WiX XML Schema. Schema extensions can register additional
7653 elements at this point in the schema.
7654 </xs:documentation>
7655 </xs:annotation>
7656 </xs:any>
7657 </xs:choice>
7658 <xs:attribute name="Id" type="xs:string" use="required">
7659 <xs:annotation>
7660 <xs:documentation>Identifier for the ComponentGroup.</xs:documentation>
7661 </xs:annotation>
7662 </xs:attribute>
7663 <xs:attribute name="Directory" type="xs:string">
7664 <xs:annotation>
7665 <xs:documentation>
7666 Sets the default directory identifier for child Component elements.
7667 </xs:documentation>
7668 </xs:annotation>
7669 </xs:attribute>
7670 <xs:attribute name="Source" type="xs:string">
7671 <xs:annotation>
7672 <xs:documentation>
7673 Used to set the default file system source for child Component elements. For more information, see
7674 <html:a href="~/howtos/general/specifying_source_files.html">Specifying source files</html:a>.
7675 </xs:documentation>
7676 </xs:annotation>
7677 </xs:attribute>
7678 <xs:anyAttribute namespace="##other" processContents="lax">
7679 <xs:annotation>
7680 <xs:documentation>
7681 Extensibility point in the WiX XML Schema. Schema extensions can register additional
7682 attributes at this point in the schema.
7683 </xs:documentation>
7684 </xs:annotation>
7685 </xs:anyAttribute>
7686 </xs:complexType>
7687 </xs:element>
7688 <xs:element name="ComponentGroupRef">
7689 <xs:annotation>
7690 <xs:documentation>Create a reference to a ComponentGroup in another Fragment.</xs:documentation>
7691 <xs:appinfo>
7692 <xse:seeAlso ref="ComponentGroup" />
7693 </xs:appinfo>
7694 </xs:annotation>
7695 <xs:complexType>
7696 <xs:attribute name="Id" type="xs:string" use="required">
7697 <xs:annotation>
7698 <xs:documentation>The identifier of the ComponentGroup to reference.</xs:documentation>
7699 </xs:annotation>
7700 </xs:attribute>
7701 <xs:attribute name="Primary" type="YesNoTypeUnion">
7702 <xs:annotation>
7703 <xs:documentation>
7704 Set this attribute to 'yes' in order to make the parent feature of this component
7705 the primary feature for this component. Components may belong to multiple features.
7706 By designating a feature as the primary feature of a component, you ensure that
7707 whenever a component is selected for install-on-demand (IOD), the primary feature
7708 will be the one to install it. This attribute should only be set if a component
7709 actually nests under multiple features. If a component nests under only one feature,
7710 that feature is the primary feature for the component. You cannot set more than one
7711 feature as the primary feature of a given component.
7712 </xs:documentation>
7713 </xs:annotation>
7714 </xs:attribute>
7715 <xs:anyAttribute namespace="##other" processContents="lax">
7716 <xs:annotation>
7717 <xs:documentation>
7718 Extensibility point in the WiX XML Schema. Schema extensions can register additional
7719 attributes at this point in the schema.
7720 </xs:documentation>
7721 </xs:annotation>
7722 </xs:anyAttribute>
7723 </xs:complexType>
7724 </xs:element>
7725 <xs:element name="All">
7726 <xs:annotation>
7727 <xs:documentation>Used only for PatchFamilies to include all changes between the baseline and upgraded packages in a patch.</xs:documentation>
7728 <xs:appinfo>
7729 <xse:remarks>
7730 <html:p>Warning: this is intended for testing purposes only. Shipping a patch with all changes negates the benefits of using patch families for including only specific changes.</html:p>
7731 <html:p>Because changing the ProductCode is not supported in a patch, the ProductCode property is automatically removed from the transform.</html:p>
7732 </xse:remarks>
7733 </xs:appinfo>
7734 </xs:annotation>
7735 </xs:element>
7736 <xs:element name="BinaryRef">
7737 <xs:annotation>
7738 <xs:documentation>Used only for PatchFamilies to include only a binary table entry in a patch.</xs:documentation>
7739 </xs:annotation>
7740 <xs:complexType>
7741 <xs:attribute name="Id" type="xs:string" use="required">
7742 <xs:annotation>
7743 <xs:documentation>The identifier of the Binary element to reference.</xs:documentation>
7744 </xs:annotation>
7745 </xs:attribute>
7746 <xs:anyAttribute namespace="##other" processContents="lax">
7747 <xs:annotation>
7748 <xs:documentation>
7749 Extensibility point in the WiX XML Schema. Schema extensions can register additional
7750 attributes at this point in the schema.
7751 </xs:documentation>
7752 </xs:annotation>
7753 </xs:anyAttribute>
7754 </xs:complexType>
7755 </xs:element>
7756 <xs:element name="IconRef">
7757 <xs:annotation>
7758 <xs:documentation>Used only for PatchFamilies to include only a icon table entry in a patch.</xs:documentation>
7759 </xs:annotation>
7760 <xs:complexType>
7761 <xs:attribute name="Id" type="xs:string" use="required">
7762 <xs:annotation>
7763 <xs:documentation>The identifier of the Icon element to reference.</xs:documentation>
7764 </xs:annotation>
7765 </xs:attribute>
7766 <xs:anyAttribute namespace="##other" processContents="lax">
7767 <xs:annotation>
7768 <xs:documentation>
7769 Extensibility point in the WiX XML Schema. Schema extensions can register additional
7770 attributes at this point in the schema.
7771 </xs:documentation>
7772 </xs:annotation>
7773 </xs:anyAttribute>
7774 </xs:complexType>
7775 </xs:element>
7776 <xs:element name="ComponentRef">
7777 <xs:annotation>
7778 <xs:documentation>Create a reference to a Feature element in another Fragment.</xs:documentation>
7779 <xs:appinfo>
7780 <xse:seeAlso ref="Component" />
7781 <xse:howtoRef href="files_and_registry/add_a_file.html">How To: Add a file to your installer</xse:howtoRef>
7782 </xs:appinfo>
7783 </xs:annotation>
7784 <xs:complexType>
7785 <xs:attribute name="Id" type="xs:string" use="required">
7786 <xs:annotation>
7787 <xs:documentation>The identifier of the Component element to reference.</xs:documentation>
7788 </xs:annotation>
7789 </xs:attribute>
7790 <xs:attribute name="Primary" type="YesNoTypeUnion">
7791 <xs:annotation>
7792 <xs:documentation>
7793 Set this attribute to 'yes' in order to make the parent feature of this component
7794 the primary feature for this component. Components may belong to multiple features.
7795 By designating a feature as the primary feature of a component, you ensure that
7796 whenever a component is selected for install-on-demand (IOD), the primary feature
7797 will be the one to install it. This attribute should only be set if a component
7798 actually nests under multiple features. If a component nests under only one feature,
7799 that feature is the primary feature for the component. You cannot set more than one
7800 feature as the primary feature of a given component.
7801 </xs:documentation>
7802 </xs:annotation>
7803 </xs:attribute>
7804 <xs:anyAttribute namespace="##other" processContents="lax">
7805 <xs:annotation>
7806 <xs:documentation>
7807 Extensibility point in the WiX XML Schema. Schema extensions can register additional
7808 attributes at this point in the schema.
7809 </xs:documentation>
7810 </xs:annotation>
7811 </xs:anyAttribute>
7812 </xs:complexType>
7813 </xs:element>
7814 <xs:element name="Merge">
7815 <xs:annotation>
7816 <xs:appinfo>
7817 <xse:seeAlso ref="MergeRef" />
7818 <xse:howtoRef href="redistributables_and_install_checks/install_vcredist.html">How To: Install the Visual C++ Redistributable with your installer</xse:howtoRef>
7819 </xs:appinfo>
7820 <xs:documentation>Merge directive to bring in a merge module that will be redirected to the parent directory.</xs:documentation>
7821 </xs:annotation>
7822 <xs:complexType>
7823 <xs:choice minOccurs="0" maxOccurs="unbounded">
7824 <xs:element ref="ConfigurationData">
7825 <xs:annotation>
7826 <xs:documentation>Data to use as input to a configurable merge module.</xs:documentation>
7827 </xs:annotation>
7828 </xs:element>
7829 </xs:choice>
7830 <xs:attribute name="Id" type="xs:string" use="required">
7831 <xs:annotation>
7832 <xs:documentation>The unique identifier for the Merge element in the source code. Referenced by the MergeRef/@Id.</xs:documentation>
7833 </xs:annotation>
7834 </xs:attribute>
7835 <xs:attribute name="DiskId" type="DiskIdType">
7836 <xs:annotation>
7837 <xs:documentation>The value of this attribute should correspond to the Id attribute of a
7838 Media element authored elsewhere. By creating this connection between the merge module and Media
7839 element, you set the packaging options to the values specified in the Media
7840 element (values such as compression level, cab embedding, etc...).</xs:documentation>
7841 </xs:annotation>
7842 </xs:attribute>
7843 <xs:attribute name="FileCompression" type="YesNoTypeUnion">
7844 <xs:annotation>
7845 <xs:documentation>Specifies if the files in the merge module should be compressed.</xs:documentation>
7846 </xs:annotation>
7847 </xs:attribute>
7848 <xs:attribute name="Language" type="LocalizableInteger" use="required">
7849 <xs:annotation>
7850 <xs:documentation>Specifies the decimal LCID or localization token for the language to merge the Module in as.</xs:documentation>
7851 </xs:annotation>
7852 </xs:attribute>
7853 <xs:attribute name="SourceFile" type="xs:string">
7854 <xs:annotation>
7855 <xs:documentation>Path to the source location of the merge module.</xs:documentation>
7856 </xs:annotation>
7857 </xs:attribute>
7858 <xs:attribute name="src" type="xs:string">
7859 <xs:annotation>
7860 <xs:appinfo>
7861 <xse:deprecated ref="SourceFile" />
7862 </xs:appinfo>
7863 </xs:annotation>
7864 </xs:attribute>
7865 </xs:complexType>
7866 </xs:element>
7867 <xs:element name="MergeRef">
7868 <xs:annotation>
7869 <xs:appinfo>
7870 <xse:seeAlso ref="Merge" />
7871 <xse:howtoRef href="redistributables_and_install_checks/install_vcredist.html">How To: Install the Visual C++ Redistributable with your installer</xse:howtoRef>
7872 </xs:appinfo>
7873 <xs:documentation>Merge reference to connect a Merge Module to parent Feature</xs:documentation>
7874 </xs:annotation>
7875 <xs:complexType>
7876 <xs:attribute name="Id" type="xs:string" use="required">
7877 <xs:annotation>
7878 <xs:documentation>The unique identifier for the Merge element to be referenced.</xs:documentation>
7879 </xs:annotation>
7880 </xs:attribute>
7881 <xs:attribute name="Primary" type="YesNoTypeUnion">
7882 <xs:annotation>
7883 <xs:documentation>Specifies whether the feature containing this MergeRef is the primary feature for advertising the merge module's components.</xs:documentation>
7884 </xs:annotation>
7885 </xs:attribute>
7886 <xs:anyAttribute namespace="##other" processContents="lax">
7887 <xs:annotation>
7888 <xs:documentation>
7889 Extensibility point in the WiX XML Schema. Schema extensions can register additional
7890 attributes at this point in the schema.
7891 </xs:documentation>
7892 </xs:annotation>
7893 </xs:anyAttribute>
7894 </xs:complexType>
7895 </xs:element>
7896 <xs:element name="ConfigurationData">
7897 <xs:annotation>
7898 <xs:documentation>Data to use as input to a configurable merge module.</xs:documentation>
7899 </xs:annotation>
7900 <xs:complexType>
7901 <xs:attribute name="Name" type="xs:string" use="required">
7902 <xs:annotation>
7903 <xs:documentation>Name of the item in the ModuleConfiguration table.</xs:documentation>
7904 </xs:annotation>
7905 </xs:attribute>
7906 <xs:attribute name="Value" type="xs:string" use="required">
7907 <xs:annotation>
7908 <xs:documentation>Value to be passed to configurable merge module.</xs:documentation>
7909 </xs:annotation>
7910 </xs:attribute>
7911 </xs:complexType>
7912 </xs:element>
7913 <xs:element name="Directory">
7914 <xs:annotation>
7915 <xs:documentation>Directory layout for the product. Also specifies the mappings between source and target directories.</xs:documentation>
7916 <xs:appinfo>
7917 <xse:seeAlso ref="DirectoryRef" />
7918 <xse:msiRef table="Directory" href="http://msdn.microsoft.com/library/aa368295.aspx" />
7919 <xse:howtoRef href="files_and_registry/add_a_file.html">How To: Add a file to your installer</xse:howtoRef>
7920 </xs:appinfo>
7921 </xs:annotation>
7922 <xs:complexType>
7923 <xs:choice minOccurs="0" maxOccurs="unbounded">
7924 <xs:element ref="Component" />
7925 <xs:element ref="Directory" />
7926 <xs:element ref="Merge" />
7927 <xs:element ref="SymbolPath" />
7928 <xs:any namespace="##other" processContents="lax">
7929 <xs:annotation>
7930 <xs:documentation>
7931 Extensibility point in the WiX XML Schema. Schema extensions can register additional
7932 elements at this point in the schema.
7933 </xs:documentation>
7934 </xs:annotation>
7935 </xs:any>
7936 </xs:choice>
7937 <xs:attribute name="Id" type="xs:string" use="required">
7938 <xs:annotation>
7939 <xs:documentation>This value is the unique identifier of the directory entry.</xs:documentation>
7940 </xs:annotation>
7941 </xs:attribute>
7942 <xs:attribute name="ComponentGuidGenerationSeed" type="Guid">
7943 <xs:annotation>
7944 <xs:documentation>
7945 The Component Guid Generation Seed is a guid that must be used when a Component with the generate guid directive ("*")
7946 is not rooted in a standard Windows Installer directory (for example, ProgramFilesFolder or CommonFilesFolder).
7947 It is recommended that this attribute be avoided and that developers install their Components under standard
7948 directories with unique names instead (for example, "ProgramFilesFolder\Company Name Product Name Version"). It is
7949 important to note that once a directory is assigned a Component Guid Generation Seed the value must not change until
7950 (and must be changed when) the path to that directory, including itself and all parent directories, changes.
7951 </xs:documentation>
7952 </xs:annotation>
7953 </xs:attribute>
7954 <xs:attribute name="DiskId" type="DiskIdType">
7955 <xs:annotation>
7956 <xs:documentation>
7957 Sets the default disk identifier for the files contained in this directory.
7958 This attribute's value may be overridden by a child Component, Directory,
7959 Merge or File element. See the File or Merge elements' DiskId attribute for
7960 more information.
7961 </xs:documentation>
7962 </xs:annotation>
7963 </xs:attribute>
7964 <xs:attribute name="FileSource" type="xs:string">
7965 <xs:annotation>
7966 <xs:documentation>Used to set the file system source for this directory's child elements. For more information, see <html:a href="~/howtos/general/specifying_source_files.html">Specifying source files</html:a>.</xs:documentation>
7967 </xs:annotation>
7968 </xs:attribute>
7969 <xs:attribute name="Name" type="xs:string">
7970 <xs:annotation>
7971 <xs:documentation>
7972 The name of the directory.
7973
7974 Do not specify this attribute if this directory represents
7975 the same directory as the parent (see the Windows Installer SDK's
7976 <html:a href="http://msdn.microsoft.com/library/Aa368295.aspx" target="_blank">Directory table</html:a>
7977 topic for more information about the "." operator).
7978
7979 This attribute's value may either a short or long directory name. If a short directory
7980 name is specified, the ShortName attribute may not be specified. If this value is a long
7981 directory name, the ShortName attribute may be omitted to
7982 allow WiX to attempt to generate a unique short directory name.
7983 However, if this name collides with another directory or you wish to manually specify
7984 the short directory name, then the ShortName attribute may be specified.
7985
7986 This Name attribute may also define multiple directories using the inline directory syntax.
7987 For example, "ProgramFilesFolder:\My Company\My Product\bin" would create a reference to a
7988 Directory element with Id="ProgramFilesFolder" then create directories named "My Company" then
7989 "My Product" then "bin" nested beneath each other. This syntax is a shortcut to defining
7990 each directory in an individual Directory element.
7991 </xs:documentation>
7992 </xs:annotation>
7993 </xs:attribute>
7994 <xs:attribute name="ShortName" type="ShortFileNameType">
7995 <xs:annotation>
7996 <xs:documentation>
7997 The short name of the directory in 8.3 format.
7998 This attribute should only be set if there is a conflict between generated short directory names
7999 or the user wants to manually specify the short directory name.
8000 </xs:documentation>
8001 </xs:annotation>
8002 </xs:attribute>
8003 <xs:attribute name="ShortSourceName" type="ShortFileNameType">
8004 <xs:annotation>
8005 <xs:documentation>
8006 The short name of the directory on the source media in 8.3 format.
8007 This attribute should only be set if there is a conflict between generated short directory names
8008 or the user wants to manually specify the short source directory name.
8009 </xs:documentation>
8010 </xs:annotation>
8011 </xs:attribute>
8012 <xs:attribute name="SourceName" type="LongFileNameType">
8013 <xs:annotation>
8014 <xs:documentation>
8015 The name of the directory on the source media.
8016 If this attribute is not specified, Windows Installer will default to the Name attribute.
8017
8018 In prior versions of the WiX toolset, this attribute specified the short source directory name.
8019 This attribute's value may now be either a short or long directory name.
8020 If a short directory name is specified, the ShortSourceName attribute may not be specified.
8021 If a long directory name is specified, the LongSource attribute may not be specified.
8022 Also, if this value is a long directory name, the ShortSourceName attribute may be omitted to
8023 allow WiX to attempt to generate a unique short directory name.
8024 However, if this name collides with another directory or you wish to manually specify
8025 the short directory name, then the ShortSourceName attribute may be specified.
8026 </xs:documentation>
8027 </xs:annotation>
8028 </xs:attribute>
8029 <xs:attribute name="src" type="xs:string">
8030 <xs:annotation>
8031 <xs:appinfo>
8032 <xse:deprecated ref="FileSource" />
8033 </xs:appinfo>
8034 </xs:annotation>
8035 </xs:attribute>
8036 <xs:anyAttribute namespace="##other" processContents="lax">
8037 <xs:annotation>
8038 <xs:documentation>
8039 Extensibility point in the WiX XML Schema. Schema extensions can register additional
8040 attributes at this point in the schema.
8041 </xs:documentation>
8042 </xs:annotation>
8043 </xs:anyAttribute>
8044 </xs:complexType>
8045 </xs:element>
8046 <xs:element name="DirectoryRef">
8047 <xs:annotation>
8048 <xs:documentation>Create a reference to a Directory element in another Fragment.</xs:documentation>
8049 <xs:appinfo>
8050 <xse:seeAlso ref="Directory" />
8051 <xse:howtoRef href="files_and_registry/add_a_file.html">How To: Add a file to your installer</xse:howtoRef>
8052 </xs:appinfo>
8053 </xs:annotation>
8054 <xs:complexType>
8055 <xs:choice minOccurs="0" maxOccurs="unbounded">
8056 <xs:element ref="Component" />
8057 <xs:element ref="Directory" />
8058 <xs:element ref="Merge" />
8059 <xs:any namespace="##other" processContents="lax">
8060 <xs:annotation>
8061 <xs:documentation>
8062 Extensibility point in the WiX XML Schema. Schema extensions can register additional
8063 elements at this point in the schema.
8064 </xs:documentation>
8065 </xs:annotation>
8066 </xs:any>
8067 </xs:choice>
8068 <xs:attribute name="Id" type="xs:string" use="required">
8069 <xs:annotation>
8070 <xs:documentation>The identifier of the Directory element to reference.</xs:documentation>
8071 </xs:annotation>
8072 </xs:attribute>
8073 <xs:attribute name="DiskId" type="DiskIdType">
8074 <xs:annotation>
8075 <xs:documentation>
8076 Sets the default disk identifier for the files contained in this directory.
8077 This attribute's value may be overridden by a child Component, Directory,
8078 Merge or File element. See the File or Merge elements' DiskId attribute for
8079 more information.
8080 </xs:documentation>
8081 </xs:annotation>
8082 </xs:attribute>
8083 <xs:attribute name="FileSource" type="xs:string">
8084 <xs:annotation>
8085 <xs:documentation>Used to set the file system source for this DirectoryRef's child elements. For more information, see <html:a href="~/howtos/general/specifying_source_files.html">Specifying source files</html:a>.</xs:documentation>
8086 </xs:annotation>
8087 </xs:attribute>
8088 <xs:attribute name="src" type="xs:string">
8089 <xs:annotation>
8090 <xs:appinfo>
8091 <xse:deprecated ref="FileSource" />
8092 </xs:appinfo>
8093 </xs:annotation>
8094 </xs:attribute>
8095 <xs:anyAttribute namespace="##other" processContents="lax">
8096 <xs:annotation>
8097 <xs:documentation>
8098 Extensibility point in the WiX XML Schema. Schema extensions can register additional
8099 attributes at this point in the schema.
8100 </xs:documentation>
8101 </xs:annotation>
8102 </xs:anyAttribute>
8103 </xs:complexType>
8104 </xs:element>
8105 <xs:element name="UpgradeVersion">
8106 <xs:annotation>
8107 <xs:appinfo>
8108 <xse:msiRef table="Upgrade" href="http://msdn.microsoft.com/library/aa372379.aspx" />
8109 </xs:appinfo>
8110 </xs:annotation>
8111 <xs:complexType>
8112 <xs:simpleContent>
8113 <xs:extension base="xs:string">
8114 <xs:attribute name="Minimum" type="xs:string">
8115 <xs:annotation>
8116 <xs:documentation>Specifies the lower bound on the range of product versions to be detected by FindRelatedProducts.</xs:documentation>
8117 </xs:annotation>
8118 </xs:attribute>
8119 <xs:attribute name="Maximum" type="xs:string">
8120 <xs:annotation>
8121 <xs:documentation>Specifies the upper boundary of the range of product versions detected by FindRelatedProducts.</xs:documentation>
8122 </xs:annotation>
8123 </xs:attribute>
8124 <xs:attribute name="Language" type="xs:string">
8125 <xs:annotation>
8126 <xs:documentation>Specifies the set of languages detected by FindRelatedProducts. Enter a list of numeric language identifiers (LANGID) separated by commas (,). Leave this value null to specify all languages. Set ExcludeLanguages to "yes" in order detect all languages, excluding the languages listed in this value.</xs:documentation>
8127 </xs:annotation>
8128 </xs:attribute>
8129 <xs:attribute name="RemoveFeatures" type="xs:string">
8130 <xs:annotation>
8131 <xs:documentation>The installer sets the REMOVE property to features specified in this column. The features to be removed can be determined at run time. The Formatted string entered in this field must evaluate to a comma-delimited list of feature names. For example: [Feature1],[Feature2],[Feature3]. No features are removed if the field contains formatted text that evaluates to an empty string. The installer sets REMOVE=ALL only if the Remove field is empty.</xs:documentation>
8132 </xs:annotation>
8133 </xs:attribute>
8134 <xs:attribute name="Property" type="xs:string" use="required">
8135 <xs:annotation>
8136 <xs:documentation>When the FindRelatedProducts action detects a related product installed on the system, it appends the product code to the property specified in this field. Windows Installer documentation for the <html:a href="http://msdn.microsoft.com/library/aa372379.aspx" target="_blank">Upgrade table</html:a> states that the property specified in this field must be a public property and must be added to the <html:a href="http://msdn.microsoft.com/library/aa371571.aspx" target="_blank">SecureCustomProperties</html:a> property. WiX automatically appends the property specified in this field to the SecureCustomProperties property when creating an MSI. Each UpgradeVersion must have a unique Property value. After the FindRelatedProducts action is run, the value of this property is a list of product codes, separated by semicolons (;), detected on the system.</xs:documentation>
8137 </xs:annotation>
8138 </xs:attribute>
8139 <xs:attribute name="MigrateFeatures" type="YesNoTypeUnion">
8140 <xs:annotation>
8141 <xs:documentation>Set to "yes" to migrate feature states from upgraded products by enabling the logic in the MigrateFeatureStates action.</xs:documentation>
8142 </xs:annotation>
8143 </xs:attribute>
8144 <xs:attribute name="OnlyDetect" type="YesNoTypeUnion">
8145 <xs:annotation>
8146 <xs:documentation>Set to "yes" to detect products and applications but do not uninstall.</xs:documentation>
8147 </xs:annotation>
8148 </xs:attribute>
8149 <xs:attribute name="IgnoreRemoveFailure" type="YesNoTypeUnion">
8150 <xs:annotation>
8151 <xs:documentation>Set to "yes" to continue installation upon failure to remove a product or application.</xs:documentation>
8152 </xs:annotation>
8153 </xs:attribute>
8154 <xs:attribute name="IncludeMinimum" type="YesNoTypeUnion">
8155 <xs:annotation>
8156 <xs:documentation>Set to "no" to make the range of versions detected exclude the value specified in Minimum. This attribute is "yes" by default.</xs:documentation>
8157 </xs:annotation>
8158 </xs:attribute>
8159 <xs:attribute name="IncludeMaximum" type="YesNoTypeUnion">
8160 <xs:annotation>
8161 <xs:documentation>Set to "yes" to make the range of versions detected include the value specified in Maximum.</xs:documentation>
8162 </xs:annotation>
8163 </xs:attribute>
8164 <xs:attribute name="ExcludeLanguages" type="YesNoTypeUnion">
8165 <xs:annotation>
8166 <xs:documentation>Set to "yes" to detect all languages, excluding the languages listed in the Language attribute.</xs:documentation>
8167 </xs:annotation>
8168 </xs:attribute>
8169 <xs:anyAttribute namespace="##other" processContents="lax">
8170 <xs:annotation>
8171 <xs:documentation>
8172 Extensibility point in the WiX XML Schema. Schema extensions can register additional
8173 attributes at this point in the schema.
8174 </xs:documentation>
8175 </xs:annotation>
8176 </xs:anyAttribute>
8177 </xs:extension>
8178 </xs:simpleContent>
8179 </xs:complexType>
8180 </xs:element>
8181 <xs:element name="Upgrade">
8182 <xs:annotation>
8183 <xs:documentation>
8184 Upgrade info for a particular UpgradeCode
8185 </xs:documentation>
8186 <xs:appinfo>
8187 <xse:msiRef table="Upgrade" href="http://msdn.microsoft.com/library/aa372379.aspx" />
8188 </xs:appinfo>
8189 </xs:annotation>
8190 <xs:complexType>
8191 <xs:choice minOccurs="0" maxOccurs="unbounded">
8192 <xs:element ref="UpgradeVersion" />
8193 <xs:element ref="Property">
8194 <xs:annotation>
8195 <xs:documentation>
8196 Nesting a Property element under an Upgrade element has been deprecated.
8197 Please nest Property elements in any of the other supported locations.
8198 </xs:documentation>
8199 </xs:annotation>
8200 </xs:element>
8201 </xs:choice>
8202 <xs:attribute name="Id" type="Guid" use="required">
8203 <xs:annotation>
8204 <xs:documentation>This value specifies the upgrade code for the products that are to be detected by the FindRelatedProducts action.</xs:documentation>
8205 </xs:annotation>
8206 </xs:attribute>
8207 </xs:complexType>
8208 </xs:element>
8209 <xs:element name="Feature">
8210 <xs:annotation>
8211 <xs:documentation>
8212 A feature for the Feature table. Features are the smallest installable unit. See msi.chm for more
8213 detailed information on the myriad installation options for a feature.
8214 </xs:documentation>
8215 <xs:appinfo>
8216 <xse:seeAlso ref="FeatureRef" />
8217 <xse:msiRef table="Feature" href="http://msdn.microsoft.com/library/aa368585.aspx" />
8218 <xse:howtoRef href="files_and_registry/add_a_file.html">How To: Add a file to your installer</xse:howtoRef>
8219 </xs:appinfo>
8220 </xs:annotation>
8221 <xs:complexType>
8222 <xs:choice minOccurs="0" maxOccurs="unbounded">
8223 <xs:element ref="Component" />
8224 <xs:element ref="ComponentGroupRef" />
8225 <xs:element ref="ComponentRef" />
8226 <xs:element ref="Condition" />
8227 <xs:element ref="Feature" />
8228 <xs:element ref="FeatureGroupRef" />
8229 <xs:element ref="FeatureRef" />
8230 <xs:element ref="MergeRef" />
8231 <xs:any namespace="##other" processContents="lax">
8232 <xs:annotation>
8233 <xs:documentation>
8234 Extensibility point in the WiX XML Schema. Schema extensions can register additional
8235 elements at this point in the schema.
8236 </xs:documentation>
8237 </xs:annotation>
8238 </xs:any>
8239 </xs:choice>
8240 <xs:attribute name="Id" type="xs:string" use="required">
8241 <xs:annotation>
8242 <xs:documentation>Unique identifier of the feature.</xs:documentation>
8243 </xs:annotation>
8244 </xs:attribute>
8245 <xs:attribute name="Absent">
8246 <xs:annotation>
8247 <xs:documentation>
8248 This attribute determines if a user will have the option to set a feature to absent in the user interface.
8249 </xs:documentation>
8250 </xs:annotation>
8251 <xs:simpleType>
8252 <xs:restriction base="xs:NMTOKEN">
8253 <xs:enumeration value="allow">
8254 <xs:annotation>
8255 <xs:documentation>
8256 Allows the user interface to display an option to change the feature state to Absent.
8257 </xs:documentation>
8258 </xs:annotation>
8259 </xs:enumeration>
8260 <xs:enumeration value="disallow">
8261 <xs:annotation>
8262 <xs:documentation>
8263 Prevents the user interface from displaying an option to change the feature state
8264 to Absent by setting the msidbFeatureAttributesUIDisallowAbsent attribute. This will force the feature
8265 to the installation state, whether or not the feature is visible in the UI.
8266 </xs:documentation>
8267 </xs:annotation>
8268 </xs:enumeration>
8269 </xs:restriction>
8270 </xs:simpleType>
8271 </xs:attribute>
8272 <xs:attribute name="AllowAdvertise">
8273 <xs:annotation>
8274 <xs:documentation>
8275 This attribute determines the possible advertise states for this feature.
8276 </xs:documentation>
8277 </xs:annotation>
8278 <xs:simpleType>
8279 <xs:restriction base="xs:NMTOKEN">
8280 <xs:enumeration value="no">
8281 <xs:annotation>
8282 <xs:documentation>
8283 Prevents this feature from being advertised by setting the msidbFeatureAttributesDisallowAdvertise attribute.
8284 </xs:documentation>
8285 </xs:annotation>
8286 </xs:enumeration>
8287 <xs:enumeration value="system">
8288 <xs:annotation>
8289 <xs:documentation>
8290 Prevents advertising for this feature if the operating system shell does not support Windows Installer
8291 descriptors by setting the msidbFeatureAttributesNoUnsupportedAdvertise attribute.
8292 </xs:documentation>
8293 </xs:annotation>
8294 </xs:enumeration>
8295 <xs:enumeration value="yes">
8296 <xs:annotation>
8297 <xs:documentation>
8298 Allows the feature to be advertised.
8299 </xs:documentation>
8300 </xs:annotation>
8301 </xs:enumeration>
8302 </xs:restriction>
8303 </xs:simpleType>
8304 </xs:attribute>
8305 <xs:attribute name="ConfigurableDirectory" type="xs:string">
8306 <xs:annotation>
8307 <xs:documentation>
8308 Specify the Id of a Directory that can be configured by the user at installation time. This identifier
8309 must be a public property and therefore completely uppercase.
8310 </xs:documentation>
8311 </xs:annotation>
8312 </xs:attribute>
8313 <xs:attribute name="Description" type="xs:string">
8314 <xs:annotation>
8315 <xs:documentation>
8316 Longer string of text describing the feature. This localizable string is displayed by the
8317 Text Control of the Selection Dialog.
8318 </xs:documentation>
8319 </xs:annotation>
8320 </xs:attribute>
8321 <xs:attribute name="Display" type="xs:string">
8322 <xs:annotation>
8323 <xs:documentation>
8324 Determines the initial display of this feature in the feature tree.
8325 This attribute's value should be one of the following:
8326 <html:dl><html:dt class="enumerationValue"><html:dfn>collapse</html:dfn></html:dt><html:dd>Initially shows the feature collapsed. This is the default value.</html:dd><html:dt class="enumerationValue"><html:dfn>expand</html:dfn></html:dt><html:dd>Initially shows the feature expanded.</html:dd><html:dt class="enumerationValue"><html:dfn>hidden</html:dfn></html:dt><html:dd>Prevents the feature from displaying in the user interface.</html:dd><html:dt class="enumerationValue"><html:dfn>&lt;an explicit integer value&gt;</html:dfn></html:dt><html:dd>
8327 For advanced users only, it is possible to directly set the integer value
8328 of the display value that will appear in the Feature row.
8329 </html:dd></html:dl></xs:documentation>
8330 </xs:annotation>
8331 </xs:attribute>
8332 <xs:attribute name="InstallDefault">
8333 <xs:annotation>
8334 <xs:documentation>
8335 This attribute determines the default install/run location of a feature. This attribute cannot be specified
8336 if the value of the FollowParent attribute is 'yes' since that would ask the installer to force this feature
8337 to follow the parent installation state and simultaneously favor a particular installation state just for this feature.
8338 </xs:documentation>
8339 </xs:annotation>
8340 <xs:simpleType>
8341 <xs:restriction base="xs:NMTOKEN">
8342 <xs:enumeration value="followParent">
8343 <xs:annotation>
8344 <xs:documentation>
8345 Forces the feature to follow the same installation state as its parent feature.
8346 </xs:documentation>
8347 </xs:annotation>
8348 </xs:enumeration>
8349 <xs:enumeration value="local">
8350 <xs:annotation>
8351 <xs:documentation>
8352 Favors installing this feature locally by setting the msidbFeatureAttributesFavorLocal attribute.
8353 </xs:documentation>
8354 </xs:annotation>
8355 </xs:enumeration>
8356 <xs:enumeration value="source">
8357 <xs:annotation>
8358 <xs:documentation>
8359 Favors running this feature from source by setting the msidbFeatureAttributesFavorSource attribute.
8360 </xs:documentation>
8361 </xs:annotation>
8362 </xs:enumeration>
8363 </xs:restriction>
8364 </xs:simpleType>
8365 </xs:attribute>
8366 <xs:attribute name="Level" type="xs:integer">
8367 <xs:annotation>
8368 <xs:documentation>
8369 Sets the install level of this feature. A value of 0 will disable the feature. Processing the
8370 Condition Table can modify the level value (this is set via the Condition child element). The
8371 default value is "1".
8372 </xs:documentation>
8373 </xs:annotation>
8374 </xs:attribute>
8375 <xs:attribute name="Title" type="xs:string">
8376 <xs:annotation>
8377 <xs:documentation>
8378 Short string of text identifying the feature. This string is listed as an item by the
8379 SelectionTree control of the Selection Dialog.
8380 </xs:documentation>
8381 </xs:annotation>
8382 </xs:attribute>
8383 <xs:attribute name="TypicalDefault">
8384 <xs:annotation>
8385 <xs:documentation>
8386 This attribute determines the default advertise state of the feature.
8387 </xs:documentation>
8388 </xs:annotation>
8389 <xs:simpleType>
8390 <xs:restriction base="xs:NMTOKEN">
8391 <xs:enumeration value="advertise">
8392 <xs:annotation>
8393 <xs:documentation>
8394 Sets the feature to be advertised by setting the msidbFeatureAttributesFavorAdvertise attribute.
8395 This value cannot be set if the value of the AllowAdvertise attribute is 'no' since that would ask the installer to
8396 disallow the advertised state for this feature while at the same time favoring it.
8397 </xs:documentation>
8398 </xs:annotation>
8399 </xs:enumeration>
8400 <xs:enumeration value="install">
8401 <xs:annotation>
8402 <xs:documentation>
8403 Sets the feature to the default non-advertised installation option.
8404 </xs:documentation>
8405 </xs:annotation>
8406 </xs:enumeration>
8407 </xs:restriction>
8408 </xs:simpleType>
8409 </xs:attribute>
8410 <xs:anyAttribute namespace="##other" processContents="lax">
8411 <xs:annotation>
8412 <xs:documentation>
8413 Extensibility point in the WiX XML Schema. Schema extensions can register additional
8414 attributes at this point in the schema.
8415 </xs:documentation>
8416 </xs:annotation>
8417 </xs:anyAttribute>
8418 </xs:complexType>
8419 </xs:element>
8420 <xs:element name="FeatureGroup">
8421 <xs:annotation>
8422 <xs:documentation>
8423 Groups together multiple components, features, and merges to be used in other locations.
8424 </xs:documentation>
8425 <xs:appinfo>
8426 <xse:seeAlso ref="FeatureGroupRef" />
8427 </xs:appinfo>
8428 </xs:annotation>
8429 <xs:complexType>
8430 <xs:choice minOccurs="0" maxOccurs="unbounded">
8431 <xs:element ref="Component" />
8432 <xs:element ref="ComponentGroupRef" />
8433 <xs:element ref="ComponentRef" />
8434 <xs:element ref="Feature" />
8435 <xs:element ref="FeatureGroupRef" />
8436 <xs:element ref="FeatureRef" />
8437 <xs:element ref="MergeRef" />
8438 <xs:any namespace="##other" processContents="lax">
8439 <xs:annotation>
8440 <xs:documentation>
8441 Extensibility point in the WiX XML Schema. Schema extensions can register additional
8442 elements at this point in the schema.
8443 </xs:documentation>
8444 </xs:annotation>
8445 </xs:any>
8446 </xs:choice>
8447 <xs:attribute name="Id" type="xs:string" use="required">
8448 <xs:annotation>
8449 <xs:documentation>Identifier for the FeatureGroup.</xs:documentation>
8450 </xs:annotation>
8451 </xs:attribute>
8452 <xs:anyAttribute namespace="##other" processContents="lax">
8453 <xs:annotation>
8454 <xs:documentation>
8455 Extensibility point in the WiX XML Schema. Schema extensions can register additional
8456 attributes at this point in the schema.
8457 </xs:documentation>
8458 </xs:annotation>
8459 </xs:anyAttribute>
8460 </xs:complexType>
8461 </xs:element>
8462 <xs:element name="FeatureGroupRef">
8463 <xs:annotation>
8464 <xs:documentation>Create a reference to a FeatureGroup in another Fragment.</xs:documentation>
8465 <xs:appinfo>
8466 <xse:seeAlso ref="FeatureGroup" />
8467 </xs:appinfo>
8468 </xs:annotation>
8469 <xs:complexType>
8470 <xs:attribute name="Id" type="xs:string" use="required">
8471 <xs:annotation>
8472 <xs:documentation>The identifier of the FeatureGroup to reference.</xs:documentation>
8473 </xs:annotation>
8474 </xs:attribute>
8475 <xs:attribute name="IgnoreParent" type="YesNoTypeUnion">
8476 <xs:annotation>
8477 <xs:documentation>
8478 Normally feature group references that end up nested under a parent element create a
8479 connection to that parent. This behavior is undesirable when trying to simply reference
8480 to a FeatureGroup in a different Fragment. Specify 'yes' to have this feature group
8481 reference not create a connection to its parent. The default is 'no'.
8482 </xs:documentation>
8483 </xs:annotation>
8484 </xs:attribute>
8485 <xs:attribute name="Primary" type="YesNoTypeUnion">
8486 <xs:annotation>
8487 <xs:documentation>
8488 Set this attribute to 'yes' in order to make the parent feature of this group
8489 the primary feature for any components and merges contained in the group.
8490 Features may belong to multiple features. By designating a feature as the
8491 primary feature of a component or merge, you ensure that whenever a component is
8492 selected for install-on-demand (IOD), the primary feature will be the one to install
8493 it. This attribute should only be set if a component actually nests under multiple
8494 features. If a component nests under only one feature, that feature is the primary
8495 feature for the component. You cannot set more than one feature as the primary
8496 feature of a given component.
8497 </xs:documentation>
8498 </xs:annotation>
8499 </xs:attribute>
8500 <xs:anyAttribute namespace="##other" processContents="lax">
8501 <xs:annotation>
8502 <xs:documentation>
8503 Extensibility point in the WiX XML Schema. Schema extensions can register additional
8504 attributes at this point in the schema.
8505 </xs:documentation>
8506 </xs:annotation>
8507 </xs:anyAttribute>
8508 </xs:complexType>
8509 </xs:element>
8510 <xs:element name="FeatureRef">
8511 <xs:annotation>
8512 <xs:documentation>Create a reference to a Feature element in another Fragment.</xs:documentation>
8513 <xs:appinfo>
8514 <xse:seeAlso ref="Feature" />
8515 </xs:appinfo>
8516 </xs:annotation>
8517 <xs:complexType>
8518 <xs:choice minOccurs="0" maxOccurs="unbounded">
8519 <xs:element ref="Component" />
8520 <xs:element ref="ComponentGroupRef" />
8521 <xs:element ref="ComponentRef" />
8522 <xs:element ref="Feature" />
8523 <xs:element ref="FeatureRef" />
8524 <xs:element ref="FeatureGroup" />
8525 <xs:element ref="FeatureGroupRef" />
8526 <xs:element ref="MergeRef" />
8527 <xs:any namespace="##other" processContents="lax">
8528 <xs:annotation>
8529 <xs:documentation>
8530 Extensibility point in the WiX XML Schema. Schema extensions can register additional
8531 elements at this point in the schema.
8532 </xs:documentation>
8533 </xs:annotation>
8534 </xs:any>
8535 </xs:choice>
8536 <xs:attribute name="Id" type="xs:string" use="required">
8537 <xs:annotation>
8538 <xs:documentation>The identifier of the Feature element to reference.</xs:documentation>
8539 </xs:annotation>
8540 </xs:attribute>
8541 <xs:attribute name="IgnoreParent" type="YesNoTypeUnion">
8542 <xs:annotation>
8543 <xs:documentation>
8544 Normally feature references that are nested under a parent element create a connection to that
8545 parent. This behavior is undesirable when trying to simply reference a Feature in a different
8546 Fragment. Specify 'yes' to have this feature reference not create a connection to its parent.
8547 The default is 'no'.
8548 </xs:documentation>
8549 </xs:annotation>
8550 </xs:attribute>
8551 <xs:anyAttribute namespace="##other" processContents="lax">
8552 <xs:annotation>
8553 <xs:documentation>
8554 Extensibility point in the WiX XML Schema. Schema extensions can register additional
8555 attributes at this point in the schema.
8556 </xs:documentation>
8557 </xs:annotation>
8558 </xs:anyAttribute>
8559 </xs:complexType>
8560 </xs:element>
8561 <xs:element name="Media">
8562 <xs:annotation>
8563 <xs:documentation>Media element describes a disk that makes up the source media for the installation.</xs:documentation>
8564 <xs:appinfo>
8565 <xse:msiRef table="Media" href="http://msdn.microsoft.com/library/aa369801.aspx" />
8566 </xs:appinfo>
8567 </xs:annotation>
8568 <xs:complexType>
8569 <xs:sequence>
8570 <xs:choice minOccurs="0" maxOccurs="unbounded">
8571 <xs:element ref="DigitalSignature" minOccurs="0" />
8572 <xs:element ref="PatchBaseline" minOccurs="0" maxOccurs="unbounded" />
8573 <xs:element ref="SymbolPath" />
8574 </xs:choice>
8575 </xs:sequence>
8576 <xs:attribute name="Id" type="DiskIdType" use="required">
8577 <xs:annotation>
8578 <xs:documentation>Disk identifier for Media table. This number must be equal to or greater than 1.</xs:documentation>
8579 </xs:annotation>
8580 </xs:attribute>
8581 <xs:attribute name="Cabinet" type="xs:string">
8582 <xs:annotation>
8583 <xs:documentation>The name of the cabinet if some or all of the files stored on the media are in a cabinet file. If no cabinets are used, this attribute must not be set.</xs:documentation>
8584 </xs:annotation>
8585 </xs:attribute>
8586 <xs:attribute name="CompressionLevel" type="CompressionLevelTypeUnion">
8587 <xs:annotation>
8588 <xs:documentation>
8589 Indicates the compression level for the Media's cabinet. This attribute can
8590 only be used in conjunction with the Cabinet attribute. The default is 'mszip'.
8591 </xs:documentation>
8592 </xs:annotation>
8593 </xs:attribute>
8594 <xs:attribute name="DiskPrompt" type="xs:string">
8595 <xs:annotation>
8596 <xs:documentation>The disk name, which is usually the visible text printed on the disk. This localizable text is used to prompt the user when this disk needs to be inserted. This value will be used in the "[1]" of the DiskPrompt Property. Using this attribute will require you to define a DiskPrompt Property.</xs:documentation>
8597 </xs:annotation>
8598 </xs:attribute>
8599 <xs:attribute name="EmbedCab" type="YesNoTypeUnion">
8600 <xs:annotation>
8601 <xs:documentation>Instructs the binder to embed the cabinet in the product if 'yes'. This attribute can only be specified in conjunction with the Cabinet attribute.</xs:documentation>
8602 </xs:annotation>
8603 </xs:attribute>
8604 <xs:attribute name="Layout" type="xs:string">
8605 <xs:annotation>
8606 <xs:documentation>
8607 This attribute specifies the root directory for the uncompressed files that
8608 are a part of this Media element. By default, the src will be the output
8609 directory for the final image. The default value ensures the binder generates
8610 an installable image. If a relative path is specified in the src attribute,
8611 the value will be appended to the image's output directory. If an absolute
8612 path is provided, that path will be used without modification. The latter two
8613 options are provided to ease the layout of an image onto multiple medias (CDs/DVDs).
8614 </xs:documentation>
8615 </xs:annotation>
8616 </xs:attribute>
8617 <xs:attribute name="src" type="xs:string">
8618 <xs:annotation>
8619 <xs:appinfo>
8620 <xse:deprecated ref="Layout" />
8621 </xs:appinfo>
8622 </xs:annotation>
8623 </xs:attribute>
8624 <xs:attribute name="VolumeLabel" type="xs:string">
8625 <xs:annotation>
8626 <xs:documentation>
8627 The label attributed to the volume. This is the volume label returned
8628 by the GetVolumeInformation function. If the SourceDir property refers
8629 to a removable (floppy or CD-ROM) volume, then this volume label is
8630 used to verify that the proper disk is in the drive before attempting
8631 to install files. The entry in this column must match the volume label
8632 of the physical media.
8633 </xs:documentation>
8634 </xs:annotation>
8635 </xs:attribute>
8636 <xs:attribute name="Source" type="xs:string">
8637 <xs:annotation>
8638 <xs:documentation>
8639 Optional property that identifies the source of the embedded cabinet.
8640 If a cabinet is specified for a patch, this property should be defined
8641 and unique to each patch so that the embedded cabinet containing patched
8642 and new files can be located in the patch package. If the cabinet is not
8643 embedded - this is not typical - the cabinet can be found in the directory
8644 referenced in this column. If empty, the external cabinet must be located
8645 in the SourceDir directory.
8646 </xs:documentation>
8647 </xs:annotation>
8648 </xs:attribute>
8649 </xs:complexType>
8650 </xs:element>
8651 <xs:element name="MediaTemplate">
8652 <xs:annotation>
8653 <xs:documentation>
8654 MediaTeplate element describes information to automatically assign files to cabinets.
8655 A maximumum number of cabinets created is 999.
8656 </xs:documentation>
8657 </xs:annotation>
8658 <xs:complexType>
8659 <xs:attribute name="CabinetTemplate" type="xs:string">
8660 <xs:annotation>
8661 <xs:documentation>
8662 Templated name of the cabinet if some or all of the files stored on the media are in
8663 a cabinet file. This name must begin with either a letter or an underscore, contain
8664 maximum of five characters and {0} in the cabinet name part and must end three character extension.
8665 The default is cab{0}.cab.
8666 </xs:documentation>
8667 </xs:annotation>
8668 </xs:attribute>
8669 <xs:attribute name="CompressionLevel">
8670 <xs:annotation>
8671 <xs:documentation>
8672 Indicates the compression level for the Media's cabinet. This attribute can
8673 only be used in conjunction with the Cabinet attribute. The default is 'mszip'.
8674 </xs:documentation>
8675 </xs:annotation>
8676 <xs:simpleType>
8677 <xs:restriction base="xs:NMTOKEN">
8678 <xs:enumeration value="high" />
8679 <xs:enumeration value="low" />
8680 <xs:enumeration value="medium" />
8681 <xs:enumeration value="mszip" />
8682 <xs:enumeration value="none" />
8683 </xs:restriction>
8684 </xs:simpleType>
8685 </xs:attribute>
8686 <xs:attribute name="DiskPrompt" type="xs:string">
8687 <xs:annotation>
8688 <xs:documentation>
8689 The disk name, which is usually the visible text printed on the disk. This localizable text is used
8690 to prompt the user when this disk needs to be inserted. This value will be used in the "[1]" of the
8691 DiskPrompt Property. Using this attribute will require you to define a DiskPrompt Property.
8692 </xs:documentation>
8693 </xs:annotation>
8694 </xs:attribute>
8695 <xs:attribute name="EmbedCab" type="YesNoTypeUnion">
8696 <xs:annotation>
8697 <xs:documentation>Instructs the binder to embed the cabinets in the product if 'yes'.</xs:documentation>
8698 </xs:annotation>
8699 </xs:attribute>
8700 <xs:attribute name="VolumeLabel" type="xs:string">
8701 <xs:annotation>
8702 <xs:documentation>
8703 The label attributed to the volume. This is the volume label returned
8704 by the GetVolumeInformation function. If the SourceDir property refers
8705 to a removable (floppy or CD-ROM) volume, then this volume label is
8706 used to verify that the proper disk is in the drive before attempting
8707 to install files. The entry in this column must match the volume label
8708 of the physical media.
8709 </xs:documentation>
8710 </xs:annotation>
8711 </xs:attribute>
8712 <xs:attribute name="MaximumUncompressedMediaSize" type="xs:int">
8713 <xs:annotation>
8714 <xs:documentation>
8715 Size of uncompressed files in each cabinet, in megabytes. WIX_MUMS environment variable
8716 can be used to override this value. Default value is 200 MB.
8717 </xs:documentation>
8718 </xs:annotation>
8719 </xs:attribute>
8720 <xs:attribute name="MaximumCabinetSizeForLargeFileSplitting" type="xs:int">
8721 <xs:annotation>
8722 <xs:documentation>
8723 Maximum size of cabinet files in megabytes for large files. This attribute is used for packaging
8724 files that are larger than MaximumUncompressedMediaSize into smaller cabinets. If cabinet size
8725 exceed this value, then setting this attribute will cause the file to be split into multiple
8726 cabinets of this maximum size. For simply controlling cabinet size without file splitting use
8727 MaximumUncompressedMediaSize attribute. Setting this attribute will disable smart cabbing feature
8728 for this Fragment / Product. Setting WIX_MCSLFS environment variable can be used to override this
8729 value. Minimum allowed value of this attribute is 20 MB. Maximum allowed value and the Default
8730 value of this attribute is 2048 MB (2 GB).
8731 </xs:documentation>
8732 </xs:annotation>
8733 </xs:attribute>
8734 </xs:complexType>
8735 </xs:element>
8736 <xs:element name="IgnoreModularization">
8737 <xs:annotation>
8738 <xs:documentation>
8739 This element has been deprecated.
8740 Use the Binary/@SuppressModularization, CustomAction/@SuppressModularization, or Property/@SuppressModularization attributes instead.
8741 </xs:documentation>
8742 </xs:annotation>
8743 <xs:complexType>
8744 <xs:attribute name="Name" use="required" type="xs:string">
8745 <xs:annotation>
8746 <xs:documentation>
8747 The name of the item to ignore modularization for.
8748 </xs:documentation>
8749 </xs:annotation>
8750 </xs:attribute>
8751 <xs:attribute name="Type">
8752 <xs:annotation>
8753 <xs:documentation>
8754 The type of the item to ignore modularization for.
8755 </xs:documentation>
8756 </xs:annotation>
8757 <xs:simpleType>
8758 <xs:restriction base="xs:NMTOKEN">
8759 <xs:enumeration value="Action" />
8760 <xs:enumeration value="Property" />
8761 <xs:enumeration value="Directory" />
8762 </xs:restriction>
8763 </xs:simpleType>
8764 </xs:attribute>
8765 </xs:complexType>
8766 </xs:element>
8767 <xs:element name="CustomAction">
8768 <xs:annotation>
8769 <xs:appinfo>
8770 <xse:seeAlso ref="Custom" />
8771 <xse:seeAlso ref="CustomActionRef" />
8772 <xse:msiRef table="CustomAction" href="http://msdn.microsoft.com/library/aa368062.aspx" />
8773 </xs:appinfo>
8774 <xs:documentation>
8775 Specifies a custom action to be added to the MSI CustomAction table. Various combinations of the attributes for this element
8776 correspond to different custom action types. For more information about custom actions see the
8777 <html:a href="http://msdn.microsoft.com/library/aa372048.aspx" target="_blank">
8778 Custom Action Types</html:a> topic on MSDN.
8779 </xs:documentation>
8780 </xs:annotation>
8781 <xs:complexType>
8782 <xs:simpleContent>
8783 <xs:extension base="xs:string">
8784 <xs:annotation>
8785 <xs:documentation>
8786 The text node is only valid if the Script attribute is specified. In that case, the text node contains the script to embed.
8787 </xs:documentation>
8788 </xs:annotation>
8789 <xs:attribute name="Id" type="xs:string" use="required">
8790 <xs:annotation>
8791 <xs:documentation>
8792 The identifier of the custom action.
8793 </xs:documentation>
8794 </xs:annotation>
8795 </xs:attribute>
8796 <!-- CustomAction Source specification, sets source Attribute bits -->
8797 <xs:attribute name="BinaryKey" type="xs:string">
8798 <xs:annotation>
8799 <xs:documentation>
8800 This attribute is a reference to a Binary element with matching Id attribute. That binary stream contains
8801 the custom action for use during install. The custom action will not be installed into a target directory. This attribute is
8802 typically used with the DllEntry attribute to specify the custom action DLL to use for a type 1 custom action, with the ExeCommand
8803 attribute to specify a type 17 custom action that runs an embedded executable, or with the VBScriptCall or JScriptCall attributes
8804 to specify a type 5 or 6 custom action.
8805 </xs:documentation>
8806 </xs:annotation>
8807 </xs:attribute>
8808 <xs:attribute name="FileKey" type="xs:string">
8809 <xs:annotation>
8810 <xs:documentation>
8811 This attribute specifies a reference to a File element with matching Id attribute that
8812 will execute the custom action code in the file after the file is installed. This
8813 attribute is typically used with the ExeCommand attribute to specify a type 18 custom action
8814 that runs an installed executable, with the DllEntry attribute to specify an installed custom
8815 action DLL to use for a type 17 custom action, or with the VBScriptCall or JScriptCall
8816 attributes to specify a type 21 or 22 custom action.
8817 </xs:documentation>
8818 </xs:annotation>
8819 </xs:attribute>
8820 <xs:attribute name="Property" type="xs:string">
8821 <xs:annotation>
8822 <xs:documentation>
8823 This attribute specifies a reference to a Property element with matching Id attribute that specifies the Property
8824 to be used or updated on execution of this custom action. This attribute is
8825 typically used with the Value attribute to create a type 51 custom action that parses
8826 the text in Value and places it into the specified Property. This attribute is also used with
8827 the ExeCommand attribute to create a type 50 custom action that uses the value of the
8828 given property to specify the path to the executable. Type 51 custom actions are often useful to
8829 pass values to a deferred custom action.
8830 See <html:a href="http://msdn.microsoft.com/library/aa370543.aspx" target="_blank">
8831 http://msdn.microsoft.com/library/aa370543.aspx</html:a>
8832 for more information.
8833 </xs:documentation>
8834 </xs:annotation>
8835 </xs:attribute>
8836 <xs:attribute name="Directory" type="xs:string">
8837 <xs:annotation>
8838 <xs:documentation>
8839 This attribute specifies a reference to a Directory element with matching Id attribute containing a directory path.
8840 This attribute is typically used with the ExeCommand attribute to specify the source executable for a type 34
8841 custom action, or with the Value attribute to specify a formatted string to place in the specified Directory
8842 table entry in a type 35 custom action.
8843 </xs:documentation>
8844 </xs:annotation>
8845 </xs:attribute>
8846 <!-- CustomAction Target specification, sets target Attribute bits -->
8847 <xs:attribute name="DllEntry" type="xs:string">
8848 <xs:annotation>
8849 <xs:documentation>
8850 This attribute specifies the name of a function in a custom action to execute.
8851 This attribute is used with the BinaryKey attribute to create a type 1 custom
8852 action, or with the FileKey attribute to create a type 17 custom action.
8853 </xs:documentation>
8854 </xs:annotation>
8855 </xs:attribute>
8856 <xs:attribute name="ExeCommand" type="xs:string">
8857 <xs:annotation>
8858 <xs:documentation>
8859 This attribute specifies the command line parameters to supply to an externally
8860 run executable. This attribute is typically used with the BinaryKey attribute for a type 2 custom action,
8861 the FileKey attribute for a type 18 custom action, the Property attribute for a type 50 custom action,
8862 or the Directory attribute for a type 34 custom action that specify the executable to run.
8863 </xs:documentation>
8864 </xs:annotation>
8865 </xs:attribute>
8866 <xs:attribute name="JScriptCall" type="xs:string">
8867 <xs:annotation>
8868 <xs:documentation>
8869 This attribute specifies the name of the JScript function to execute in a script. The script must be
8870 provided in a Binary element identified by the BinaryKey attribute described above. In other words, this
8871 attribute must be specified in conjunction with the BinaryKey attribute.
8872 </xs:documentation>
8873 </xs:annotation>
8874 </xs:attribute>
8875 <xs:attribute name="VBScriptCall" type="xs:string">
8876 <xs:annotation>
8877 <xs:documentation>
8878 This attribute specifies the name of the VBScript Subroutine to execute in a script. The script must be
8879 provided in a Binary element identified by the BinaryKey attribute described above. In other words, this
8880 attribute must be specified in conjunction with the BinaryKey attribute.
8881 </xs:documentation>
8882 </xs:annotation>
8883 </xs:attribute>
8884 <xs:attribute name="Script">
8885 <xs:annotation>
8886 <xs:documentation>
8887 Creates a type 37 or 38 custom action. The text of the element should contain the script to be embedded in the package.
8888 </xs:documentation>
8889 </xs:annotation>
8890 <xs:simpleType>
8891 <xs:restriction base="xs:NMTOKEN">
8892 <xs:enumeration value="jscript" />
8893 <xs:enumeration value="vbscript" />
8894 </xs:restriction>
8895 </xs:simpleType>
8896 </xs:attribute>
8897 <xs:attribute name="SuppressModularization" type="YesNoTypeUnion">
8898 <xs:annotation>
8899 <xs:documentation>
8900 Use to suppress modularization of this custom action name in merge modules.
8901 This should only be necessary for table-driven custom actions because the
8902 table name which they interact with cannot be modularized, so there can only
8903 be one instance of the table.
8904 </xs:documentation>
8905 </xs:annotation>
8906 </xs:attribute>
8907 <xs:attribute name="Value" type="xs:string">
8908 <xs:annotation>
8909 <xs:documentation>
8910 This attribute specifies a string value to use in the custom action. This attribute
8911 must be used with the Property attribute to set the property as part of a
8912 type 51 custom action or with the Directory attribute to set a directory path in that
8913 table in a type 35 custom action. The value can be a literal value or derived from a
8914 Property element using the <html:a href="http://msdn.microsoft.com/library/aa368609.aspx" target="_blank">Formatted</html:a>
8915 syntax.
8916 </xs:documentation>
8917 </xs:annotation>
8918 </xs:attribute>
8919 <xs:attribute name="Error" type="xs:string">
8920 <xs:annotation>
8921 <xs:documentation>
8922 This attribute specifies an index in the MSI Error table to use as an error message for a
8923 type 19 custom action that displays the error message and aborts a product's installation.
8924 </xs:documentation>
8925 </xs:annotation>
8926 </xs:attribute>
8927 <!-- Other CustomAction type attributes -->
8928 <xs:attribute name="Return">
8929 <xs:annotation>
8930 <xs:documentation>
8931 Set this attribute to set the return behavior of the custom action.
8932 </xs:documentation>
8933 </xs:annotation>
8934 <xs:simpleType>
8935 <xs:restriction base="xs:NMTOKEN">
8936 <xs:enumeration value="asyncNoWait">
8937 <xs:annotation>
8938 <xs:documentation>
8939 Indicates that the custom action will run asyncronously and execution may continue after the installer terminates.
8940 </xs:documentation>
8941 </xs:annotation>
8942 </xs:enumeration>
8943 <xs:enumeration value="asyncWait">
8944 <xs:annotation>
8945 <xs:documentation>
8946 Indicates that the custom action will run asynchronously but the installer will wait for the return code at sequence end.
8947 </xs:documentation>
8948 </xs:annotation>
8949 </xs:enumeration>
8950 <xs:enumeration value="check">
8951 <xs:annotation>
8952 <xs:documentation>
8953 Indicates that the custom action will run synchronously and the return code will be checked for success. This is the default.
8954 </xs:documentation>
8955 </xs:annotation>
8956 </xs:enumeration>
8957 <xs:enumeration value="ignore">
8958 <xs:annotation>
8959 <xs:documentation>
8960 Indicates that the custom action will run synchronously and the return code will not be checked.
8961 </xs:documentation>
8962 </xs:annotation>
8963 </xs:enumeration>
8964 </xs:restriction>
8965 </xs:simpleType>
8966 </xs:attribute>
8967 <xs:attribute name="Execute">
8968 <xs:annotation>
8969 <xs:documentation>
8970 This attribute indicates the scheduling of the custom action.
8971 </xs:documentation>
8972 </xs:annotation>
8973 <xs:simpleType>
8974 <xs:restriction base="xs:NMTOKEN">
8975 <xs:enumeration value="commit">
8976 <xs:annotation>
8977 <xs:documentation>
8978 Indicates that the custom action will run after successful completion of the installation script (at the end of the installation).
8979 </xs:documentation>
8980 </xs:annotation>
8981 </xs:enumeration>
8982 <xs:enumeration value="deferred">
8983 <xs:annotation>
8984 <xs:documentation>
8985 Indicates that the custom action runs in-script (possibly with elevated privileges).
8986 </xs:documentation>
8987 </xs:annotation>
8988 </xs:enumeration>
8989 <xs:enumeration value="firstSequence">
8990 <xs:annotation>
8991 <xs:documentation>
8992 Indicates that the custom action will only run in the first sequence that runs it.
8993 </xs:documentation>
8994 </xs:annotation>
8995 </xs:enumeration>
8996 <xs:enumeration value="immediate">
8997 <xs:annotation>
8998 <xs:documentation>
8999 Indicates that the custom action will run during normal processing time with user privileges. This is the default.
9000 </xs:documentation>
9001 </xs:annotation>
9002 </xs:enumeration>
9003 <xs:enumeration value="oncePerProcess">
9004 <xs:annotation>
9005 <xs:documentation>
9006 Indicates that the custom action will only run in the first sequence that runs it in the same process.
9007 </xs:documentation>
9008 </xs:annotation>
9009 </xs:enumeration>
9010 <xs:enumeration value="rollback">
9011 <xs:annotation>
9012 <xs:documentation>
9013 Indicates that a custom action will run in the rollback sequence when a failure
9014 occurs during installation, usually to undo changes made by a deferred custom action.
9015 </xs:documentation>
9016 </xs:annotation>
9017 </xs:enumeration>
9018 <xs:enumeration value="secondSequence">
9019 <xs:annotation>
9020 <xs:documentation>
9021 Indicates that a custom action should be run a second time if it was previously run in an earlier sequence.
9022 </xs:documentation>
9023 </xs:annotation>
9024 </xs:enumeration>
9025 </xs:restriction>
9026 </xs:simpleType>
9027 </xs:attribute>
9028 <xs:attribute name="Impersonate" type="YesNoTypeUnion">
9029 <xs:annotation>
9030 <xs:documentation>
9031 This attribute specifies whether the Windows Installer, which executes as LocalSystem,
9032 should impersonate the user context of the installing user when executing this custom action.
9033 Typically the value should be 'yes', except when the custom action needs elevated privileges
9034 to apply changes to the machine.
9035 </xs:documentation>
9036 </xs:annotation>
9037 </xs:attribute>
9038 <xs:attribute name="PatchUninstall" type="YesNoTypeUnion">
9039 <xs:annotation>
9040 <xs:documentation>
9041 This attribute specifies that the Windows Installer, execute the custom action only when
9042 a patch is being uninstalled. These custom actions should also be conditioned using the
9043 MSIPATCHREMOVE property to ensure proper down level (less than Windows Installer 4.5)
9044 behavior.
9045 </xs:documentation>
9046 </xs:annotation>
9047 </xs:attribute>
9048 <xs:attribute name="Win64" type="YesNoTypeUnion">
9049 <xs:annotation>
9050 <xs:documentation>
9051 Specifies that a script custom action targets a 64-bit platform. Valid only when used with
9052 the Script, VBScriptCall, and JScriptCall attributes.
9053 The default value is based on the platform set by the -arch switch to candle.exe
9054 or the InstallerPlatform property in a .wixproj MSBuild project:
9055 For x86 and ARM, the default value is 'no'.
9056 For x64 and IA64, the default value is 'yes'.
9057 </xs:documentation>
9058 </xs:annotation>
9059 </xs:attribute>
9060 <xs:attribute name="TerminalServerAware" type="YesNoTypeUnion">
9061 <xs:annotation>
9062 <xs:documentation>
9063 This attribute specifies controls whether the custom action will impersonate the
9064 installing user during per-machine installs on Terminal Server machines.
9065 Deferred execution custom actions that do not specify this attribute, or explicitly set it 'no',
9066 will run with no user impersonation on Terminal Server machines during
9067 per-machine installations. This attribute is only applicable when installing on the
9068 Windows Server 2003 family.
9069 </xs:documentation>
9070 </xs:annotation>
9071 </xs:attribute>
9072 <xs:attribute name="HideTarget" type="YesNoTypeUnion">
9073 <xs:annotation>
9074 <xs:documentation>Ensures the installer does not log the CustomActionData for the deferred custom action.</xs:documentation>
9075 </xs:annotation>
9076 </xs:attribute>
9077 <xs:anyAttribute namespace="##other" processContents="lax">
9078 <xs:annotation>
9079 <xs:documentation>
9080 Extensibility point in the WiX XML Schema. Schema extensions can register additional
9081 attributes at this point in the schema.
9082 </xs:documentation>
9083 </xs:annotation>
9084 </xs:anyAttribute>
9085 </xs:extension>
9086 </xs:simpleContent>
9087 </xs:complexType>
9088 </xs:element>
9089 <xs:element name="CustomActionRef">
9090 <xs:annotation>
9091 <xs:appinfo>
9092 <xse:seeAlso ref="CustomAction" />
9093 </xs:appinfo>
9094 <xs:documentation>
9095 This will cause the entire contents of the Fragment containing the referenced CustomAction to be
9096 included in the installer database.
9097 </xs:documentation>
9098 </xs:annotation>
9099 <xs:complexType>
9100 <xs:attribute name="Id" type="xs:string" use="required">
9101 <xs:annotation>
9102 <xs:documentation>The identifier of the CustomAction to reference.</xs:documentation>
9103 </xs:annotation>
9104 </xs:attribute>
9105 <xs:anyAttribute namespace="##other" processContents="lax">
9106 <xs:annotation>
9107 <xs:documentation>
9108 Extensibility point in the WiX XML Schema. Schema extensions can register additional
9109 attributes at this point in the schema.
9110 </xs:documentation>
9111 </xs:annotation>
9112 </xs:anyAttribute>
9113 </xs:complexType>
9114 </xs:element>
9115 <xs:element name="SetDirectory">
9116 <xs:annotation>
9117 <xs:appinfo>
9118 <xse:seeAlso ref="Custom" />
9119 <xse:seeAlso ref="CustomActionRef" />
9120 <xse:seeAlso ref="InstallUISequence" />
9121 <xse:seeAlso ref="InstallExecuteSequence" />
9122 <xse:msiRef table="CustomAction" href="http://msdn.microsoft.com/library/aa368062.aspx" />
9123 </xs:appinfo>
9124 <xs:documentation>
9125 Sets a Directory to a particular value. This is accomplished by creating a Type 51 custom action that is appropriately scheduled in
9126 the InstallUISequence and InstallExecuteSequence.
9127 </xs:documentation>
9128 </xs:annotation>
9129 <xs:complexType>
9130 <xs:simpleContent>
9131 <xs:extension base="xs:string">
9132 <xs:annotation>
9133 <xs:documentation>
9134 The condition that determines whether the Directory is set. If the condition evaluates to false, the SetDirectory is skipped.
9135 </xs:documentation>
9136 </xs:annotation>
9137 <xs:attribute name="Action" type="xs:string">
9138 <xs:annotation>
9139 <xs:documentation>
9140 By default the action is "Set" + Id attribute's value. This optional attribute can override the action name in the case
9141 where multiple SetDirectory elements target the same Id (probably with mutually exclusive conditions).
9142 </xs:documentation>
9143 </xs:annotation>
9144 </xs:attribute>
9145 <xs:attribute name="Id" type="xs:string">
9146 <xs:annotation>
9147 <xs:documentation>
9148 This attribute specifies a reference to a Directory element with matching Id attribute. The path of the Directory will be set to
9149 the Value attribute.
9150 </xs:documentation>
9151 </xs:annotation>
9152 </xs:attribute>
9153 <xs:attribute name="Sequence" type="SequenceType">
9154 <xs:annotation>
9155 <xs:documentation>
9156 Controls which sequences the Directory assignment is sequenced in.
9157 For 'execute', the assignment is scheduled in the InstallExecuteSequence.
9158 For 'ui', the assignment is scheduled in the InstallUISequence.
9159 For 'first', the assignment is scheduled in the InstallUISequence or the InstallExecuteSequence if the InstallUISequence is skipped at install time.
9160 For 'both', the assignment is scheduled in both the InstallUISequence and the InstallExecuteSequence.
9161 The default is 'both'.
9162 </xs:documentation>
9163 </xs:annotation>
9164 </xs:attribute>
9165 <xs:attribute name="Value" type="xs:string">
9166 <xs:annotation>
9167 <xs:documentation>
9168 This attribute specifies a string value to assign to the Directory. The value can be a literal value or derived from a
9169 Property element using the <html:a href="http://msdn.microsoft.com/library/aa368609.aspx" target="_blank">Formatted</html:a>
9170 syntax.
9171 </xs:documentation>
9172 </xs:annotation>
9173 </xs:attribute>
9174 <xs:anyAttribute namespace="##other" processContents="lax">
9175 <xs:annotation>
9176 <xs:documentation>
9177 Extensibility point in the WiX XML Schema. Schema extensions can register additional
9178 attributes at this point in the schema.
9179 </xs:documentation>
9180 </xs:annotation>
9181 </xs:anyAttribute>
9182 </xs:extension>
9183 </xs:simpleContent>
9184 </xs:complexType>
9185 </xs:element>
9186 <xs:element name="SetProperty">
9187 <xs:annotation>
9188 <xs:appinfo>
9189 <xse:seeAlso ref="Custom" />
9190 <xse:seeAlso ref="CustomActionRef" />
9191 <xse:seeAlso ref="InstallUISequence" />
9192 <xse:seeAlso ref="InstallExecuteSequence" />
9193 <xse:msiRef table="CustomAction" href="http://msdn.microsoft.com/library/aa368062.aspx" />
9194 </xs:appinfo>
9195 <xs:documentation>
9196 Sets a Property to a particular value. This is accomplished by creating a Type 51 custom action that is appropriately scheduled in
9197 the InstallUISequence and InstallExecuteSequence.
9198 </xs:documentation>
9199 </xs:annotation>
9200 <xs:complexType>
9201 <xs:simpleContent>
9202 <xs:extension base="xs:string">
9203 <xs:annotation>
9204 <xs:documentation>
9205 The condition that determines whether the Property is set. If the condition evaluates to false, the Set is skipped.
9206 </xs:documentation>
9207 </xs:annotation>
9208 <xs:attribute name="Action" type="xs:string">
9209 <xs:annotation>
9210 <xs:documentation>
9211 By default the action is "Set" + Id attribute's value. This optional attribute can override the action name in the case
9212 where multiple SetProperty elements target the same Id (probably with mutually exclusive conditions).
9213 </xs:documentation>
9214 </xs:annotation>
9215 </xs:attribute>
9216 <xs:attribute name="After" type="xs:string">
9217 <xs:annotation>
9218 <xs:documentation>The name of the standard or custom action after which this action should be performed. Mutually exclusive with the Before attribute. A Before or After attribute is required when setting a Property.</xs:documentation>
9219 </xs:annotation>
9220 </xs:attribute>
9221 <xs:attribute name="Before" type="xs:string">
9222 <xs:annotation>
9223 <xs:documentation>The name of the standard or custom action before which this action should be performed. Mutually exclusive with the After attribute. A Before or After attribute is required when setting a Property.</xs:documentation>
9224 </xs:annotation>
9225 </xs:attribute>
9226 <xs:attribute name="Id" type="xs:string">
9227 <xs:annotation>
9228 <xs:documentation>
9229 This attribute specifies the Property to set to the Value.
9230 </xs:documentation>
9231 </xs:annotation>
9232 </xs:attribute>
9233 <xs:attribute name="Sequence" type="SequenceType">
9234 <xs:annotation>
9235 <xs:documentation>
9236 Controls which sequences the Property assignment is sequenced in.
9237 For 'execute', the assignment is scheduled in the InstallExecuteSequence.
9238 For 'ui', the assignment is scheduled in the InstallUISequence.
9239 For 'first', the assignment is scheduled in the InstallUISequence or the InstallExecuteSequence if the InstallUISequence is skipped at install time.
9240 For 'both', the assignment is scheduled in both the InstallUISequence and the InstallExecuteSequence.
9241 The default is 'both'.
9242 </xs:documentation>
9243 </xs:annotation>
9244 </xs:attribute>
9245 <xs:attribute name="Value" type="xs:string">
9246 <xs:annotation>
9247 <xs:documentation>
9248 This attribute specifies a string value to assign to the Property. The value can be a literal value or derived from a
9249 Property element using the <html:a href="http://msdn.microsoft.com/library/aa368609.aspx" target="_blank">Formatted</html:a>
9250 syntax.
9251 </xs:documentation>
9252 </xs:annotation>
9253 </xs:attribute>
9254 <xs:anyAttribute namespace="##other" processContents="lax">
9255 <xs:annotation>
9256 <xs:documentation>
9257 Extensibility point in the WiX XML Schema. Schema extensions can register additional
9258 attributes at this point in the schema.
9259 </xs:documentation>
9260 </xs:annotation>
9261 </xs:anyAttribute>
9262 </xs:extension>
9263 </xs:simpleContent>
9264 </xs:complexType>
9265 </xs:element>
9266 <xs:element name="PatchFamilyRef">
9267 <xs:annotation>
9268 <xs:appinfo>
9269 <xse:seeAlso ref="PatchFamily" />
9270 </xs:appinfo>
9271 <xs:documentation>
9272 This will cause the entire contents of the Fragment containing the referenced PatchFamily to be
9273 used in the process of creating a patch.
9274 </xs:documentation>
9275 </xs:annotation>
9276 <xs:complexType>
9277 <xs:attribute name="Id" type="xs:string" use="required">
9278 <xs:annotation>
9279 <xs:documentation>The identifier of the PatchFamily to reference.</xs:documentation>
9280 </xs:annotation>
9281 </xs:attribute>
9282 <xs:attribute name="ProductCode" type="Guid">
9283 <xs:annotation>
9284 <xs:documentation>Specifies the ProductCode of the product that this family applies to.</xs:documentation>
9285 </xs:annotation>
9286 </xs:attribute>
9287 <xs:anyAttribute namespace="##other" processContents="lax">
9288 <xs:annotation>
9289 <xs:documentation>
9290 Extensibility point in the WiX XML Schema. Schema extensions can register additional
9291 attributes at this point in the schema.
9292 </xs:documentation>
9293 </xs:annotation>
9294 </xs:anyAttribute>
9295 </xs:complexType>
9296 </xs:element>
9297 <!-- - - - - - - - - - - Sequence Table Definitions - - - - - - - - - - - - - - -->
9298 <xs:element name="ValidateProductID" type="ActionSequenceType">
9299 <xs:annotation>
9300 <xs:appinfo>
9301 <xse:msiRef action="ValidateProductID" href="http://msdn.microsoft.com/library/aa372475.aspx" />
9302 </xs:appinfo>
9303 <xs:documentation>Sets the ProductID property to the full product identifier. This action must be sequenced before the user interface wizard in the InstallUISequence table and before the RegisterUser action in the InstallExecuteSequence table. If the product identifier has already been validated successfully, the ValidateProductID action does nothing. The ValidateProductID action always returns a success, whether or not the product identifier is valid, so that the product identifier can be entered on the command line the first time the product is run. The product identifier can be validated without having the user reenter this information by setting the PIDKEY property on the command line or by using a transform. The display of the dialog box requesting the user to enter the product identifier can then be made conditional upon the presence of the ProductID property, which is set when the PIDKEY property is validated. The condition for this action may be specified in the element's inner text.</xs:documentation>
9304 </xs:annotation>
9305 </xs:element>
9306 <xs:element name="CostInitialize" type="ActionSequenceType">
9307 <xs:annotation>
9308 <xs:appinfo>
9309 <xse:seeAlso ref="FileCost" />
9310 <xse:seeAlso ref="CostFinalize" />
9311 <xse:msiRef action="CostInitialize" href="http://msdn.microsoft.com/library/aa368048.aspx" />
9312 </xs:appinfo>
9313 <xs:documentation>Initiates the internal installation costing process. Any standard or custom actions that affect costing should be sequenced before the CostInitialize action. Call the FileCost action immediately following the CostInitialize action. Then call the CostFinalize action following the CostInitialize action to make all final cost calculations available to the installer through the Component table. The condition for this action may be specified in the element's inner text.</xs:documentation>
9314 </xs:annotation>
9315 </xs:element>
9316 <xs:element name="FileCost" type="ActionSequenceType">
9317 <xs:annotation>
9318 <xs:appinfo>
9319 <xse:seeAlso ref="CostInitialize" />
9320 <xse:seeAlso ref="CostFinalize" />
9321 <xse:msiRef action="FileCost" href="http://msdn.microsoft.com/library/aa368589.aspx" />
9322 </xs:appinfo>
9323 <xs:documentation>Initiates dynamic costing of standard installation actions. Any standard or custom actions that affect costing should sequenced before the CostInitialize action. Call the FileCost action immediately following the CostInitialize action. Then call the CostFinalize action following the FileCost action to make all final cost calculations available to the installer through the Component table. The CostInitialize action must be executed before the FileCost action. The installer then determines the disk-space cost of every file in the File table, on a per-component basis, taking both volume clustering and the presence of existing files that may need to be overwritten into account. All actions that consume or release disk space are also considered. If an existing file is found, a file version check is performed to determine whether the new file actually needs to be installed or not. If the existing file is of an equal or greater version number, the existing file is not overwritten and no disk-space cost is incurred. In all cases, the installer uses the results of version number checking to set the installation state of each file. The FileCost action initializes cost calculation with the installer. Actual dynamic costing does not occur until the CostFinalize action is executed. The condition for this action may be specified in the element's inner text.</xs:documentation>
9324 </xs:annotation>
9325 </xs:element>
9326 <xs:element name="IsolateComponents" type="ActionSequenceType">
9327 <xs:annotation>
9328 <xs:appinfo>
9329 <xse:seeAlso ref="IsolateComponent" />
9330 <xse:msiRef action="IsolateComponents" href="http://msdn.microsoft.com/library/aa369561.aspx" />
9331 </xs:appinfo>
9332 <xs:documentation>Installs a copy of a component (commonly a shared DLL) into a private location for use by a specific application (typically an .exe). This isolates the application from other copies of the component that may be installed to a shared location on the computer. The action refers to each record of the IsolatedComponent table and associates the files of the component listed in the Component_Shared field with the component listed in the Component_Application field. The installer installs the files of Component_Shared into the same directory as Component_Application. The installer generates a file in this directory, zero bytes in length, having the short filename name of the key file for Component_Application (typically this is the same file name as the .exe) appended with .local. The IsolatedComponent action does not affect the installation of Component_Application. Uninstalling Component_Application also removes the Component_Shared files and the .local file from the directory. The IsolateComponents action can be used only in the InstallUISequence table and the InstallExecuteSequence table. This action must come after the CostInitialize action and before the CostFinalize action. The condition for this action may be specified in the element's inner text.</xs:documentation>
9333 </xs:annotation>
9334 </xs:element>
9335 <xs:element name="CostFinalize" type="ActionSequenceType">
9336 <xs:annotation>
9337 <xs:appinfo>
9338 <xse:seeAlso ref="CostInitialize" />
9339 <xse:seeAlso ref="FileCost" />
9340 <xse:msiRef action="CostFinalize" href="http://msdn.microsoft.com/library/aa368048.aspx" />
9341 </xs:appinfo>
9342 <xs:documentation>Ends the internal installation costing process begun by the CostInitialize action. Any standard or custom actions that affect costing should be sequenced before the CostInitialize action. Call the FileCost action immediately following the CostInitialize action and then call the CostFinalize action to make all final cost calculations available to the installer through the Component table. The CostFinalize action must be executed before starting any user interface sequence which allows the user to view or modify Feature table selections or directories. The CostFinalize action queries the Condition table to determine which features are scheduled to be installed. Costing is done for each component in the Component table. The CostFinalize action also verifies that all the target directories are writable before allowing the installation to continue. The condition for this action may be specified in the element's inner text.</xs:documentation>
9343 </xs:annotation>
9344 </xs:element>
9345 <xs:element name="SetODBCFolders" type="ActionSequenceType">
9346 <xs:annotation>
9347 <xs:appinfo>
9348 <xse:msiRef action="SetODBCFolders" href="http://msdn.microsoft.com/library/aa371691.aspx" />
9349 </xs:appinfo>
9350 <xs:documentation>Checks for existing ODBC drivers and sets the target directory for each new driver to the location of an existing driver. The condition for this action may be specified in the element's inner text.</xs:documentation>
9351 </xs:annotation>
9352 </xs:element>
9353 <xs:element name="MigrateFeatureStates" type="ActionSequenceType">
9354 <xs:annotation>
9355 <xs:appinfo>
9356 <xse:msiRef action="MigrateFeatureStates" href="http://msdn.microsoft.com/library/aa370034.aspx" />
9357 </xs:appinfo>
9358 <xs:documentation>Used for upgrading or installing over an existing application. Reads feature states from existing application and sets these feature states for the pending installation. The condition for this action may be specified in the element's inner text.</xs:documentation>
9359 </xs:annotation>
9360 </xs:element>
9361 <xs:element name="ExecuteAction" type="ActionSequenceType">
9362 <xs:annotation>
9363 <xs:appinfo>
9364 <xse:msiRef action="ExecuteAction" href="http://msdn.microsoft.com/library/aa368565.aspx" />
9365 </xs:appinfo>
9366 <xs:documentation>Initiates the execution sequence. The condition for this action may be specified in the element's inner text.</xs:documentation>
9367 </xs:annotation>
9368 </xs:element>
9369 <xs:element name="InstallValidate" type="ActionSequenceType">
9370 <xs:annotation>
9371 <xs:appinfo>
9372 <xse:msiRef action="InstallValidate" href="http://msdn.microsoft.com/library/aa369546.aspx" />
9373 </xs:appinfo>
9374 <xs:documentation>Verifies that all costed volumes have enough space for the installation. The condition for this action may be specified in the element's inner text.</xs:documentation>
9375 </xs:annotation>
9376 </xs:element>
9377 <xs:element name="InstallInitialize" type="ActionSequenceType">
9378 <xs:annotation>
9379 <xs:appinfo>
9380 <xse:seeAlso ref="InstallFinalize" />
9381 <xse:msiRef action="InstallInitialize" href="http://msdn.microsoft.com/library/aa369535.aspx" />
9382 </xs:appinfo>
9383 <xs:documentation>Marks the beginning of a sequence of actions that change the system. The condition for this action may be specified in the element's inner text.</xs:documentation>
9384 </xs:annotation>
9385 </xs:element>
9386 <xs:element name="AllocateRegistrySpace" type="ActionSequenceType">
9387 <xs:annotation>
9388 <xs:appinfo>
9389 <xse:msiRef action="AllocateRegistrySpace" href="http://msdn.microsoft.com/library/aa367554.aspx" />
9390 </xs:appinfo>
9391 <xs:documentation>Ensures the needed amount of space exists in the registry. The condition for this action may be specified in the element's inner text.</xs:documentation>
9392 </xs:annotation>
9393 </xs:element>
9394 <xs:element name="ProcessComponents" type="ActionSequenceType">
9395 <xs:annotation>
9396 <xs:appinfo>
9397 <xse:msiRef action="ProcessComponents" href="http://msdn.microsoft.com/library/aa370853.aspx" />
9398 </xs:appinfo>
9399 <xs:documentation>Registers and unregisters components, their key paths, and the component clients. The condition for this action may be specified in the element's inner text.</xs:documentation>
9400 </xs:annotation>
9401 </xs:element>
9402 <xs:element name="UnpublishComponents" type="ActionSequenceType">
9403 <xs:annotation>
9404 <xs:appinfo>
9405 <xse:msiRef action="UnpublishComponents" href="http://msdn.microsoft.com/library/aa372106.aspx" />
9406 </xs:appinfo>
9407 <xs:documentation>Manages the unadvertisement of components listed in the PublishComponent table. The condition for this action may be specified in the element's inner text.</xs:documentation>
9408 </xs:annotation>
9409 </xs:element>
9410 <xs:element name="MsiUnpublishAssemblies" type="ActionSequenceType">
9411 <xs:annotation>
9412 <xs:appinfo>
9413 <xse:msiRef action="MsiUnpublishAssemblies" href="http://msdn.microsoft.com/library/aa370500.aspx" />
9414 </xs:appinfo>
9415 <xs:documentation>Manages the unadvertisement of CLR and Win32 assemblies that are being removed. The condition for this action may be specified in the element's inner text.</xs:documentation>
9416 </xs:annotation>
9417 </xs:element>
9418 <xs:element name="UnpublishFeatures" type="ActionSequenceType">
9419 <xs:annotation>
9420 <xs:appinfo>
9421 <xse:msiRef action="UnpublishFeatures" href="http://msdn.microsoft.com/library/aa372107.aspx" />
9422 </xs:appinfo>
9423 <xs:documentation>Removes selection-state and feature-component mapping information from the registry. The condition for this action may be specified in the element's inner text.</xs:documentation>
9424 </xs:annotation>
9425 </xs:element>
9426 <xs:element name="StopServices" type="ActionSequenceType">
9427 <xs:annotation>
9428 <xs:appinfo>
9429 <xse:msiRef action="StopServices" href="http://msdn.microsoft.com/library/aa372028.aspx" />
9430 </xs:appinfo>
9431 <xs:documentation>Stops system services. The condition for this action may be specified in the element's inner text.</xs:documentation>
9432 </xs:annotation>
9433 </xs:element>
9434 <xs:element name="DeleteServices" type="ActionSequenceType">
9435 <xs:annotation>
9436 <xs:appinfo>
9437 <xse:msiRef action="DeleteServices" href="http://msdn.microsoft.com/library/aa368270.aspx" />
9438 </xs:appinfo>
9439 <xs:documentation>Stops a service and removes its registration from the system. The condition for this action may be specified in the element's inner text.</xs:documentation>
9440 </xs:annotation>
9441 </xs:element>
9442 <xs:element name="UnregisterComPlus" type="ActionSequenceType">
9443 <xs:annotation>
9444 <xs:appinfo>
9445 <xse:msiRef action="UnregisterComPlus" href="http://msdn.microsoft.com/library/aa372109.aspx" />
9446 </xs:appinfo>
9447 <xs:documentation>Removes COM+ applications from the registry. The condition for this action may be specified in the element's inner text.</xs:documentation>
9448 </xs:annotation>
9449 </xs:element>
9450 <xs:element name="SelfUnregModules" type="ActionSequenceType">
9451 <xs:annotation>
9452 <xs:appinfo>
9453 <xse:msiRef action="SelfUnregModules" href="http://msdn.microsoft.com/library/aa371610.aspx" />
9454 </xs:appinfo>
9455 <xs:documentation>Unregisters all modules listed in the SelfReg table that are scheduled to be uninstalled. The condition for this action may be specified in the element's inner text.</xs:documentation>
9456 </xs:annotation>
9457 </xs:element>
9458 <xs:element name="UnregisterTypeLibraries" type="ActionSequenceType">
9459 <xs:annotation>
9460 <xs:appinfo>
9461 <xse:msiRef action="UnregisterTypeLibraries" href="http://msdn.microsoft.com/library/aa372357.aspx" />
9462 </xs:appinfo>
9463 <xs:documentation>Unregisters type libraries from the system. The condition for this action may be specified in the element's inner text.</xs:documentation>
9464 </xs:annotation>
9465 </xs:element>
9466 <xs:element name="RemoveODBC" type="ActionSequenceType">
9467 <xs:annotation>
9468 <xs:appinfo>
9469 <xse:msiRef action="RemoveODBC" href="http://msdn.microsoft.com/library/aa371206.aspx" />
9470 </xs:appinfo>
9471 <xs:documentation>Removes the data sources, translators, and drivers listed for removal during the installation. The condition for this action may be specified in the element's inner text.</xs:documentation>
9472 </xs:annotation>
9473 </xs:element>
9474 <xs:element name="UnregisterFonts" type="ActionSequenceType">
9475 <xs:annotation>
9476 <xs:appinfo>
9477 <xse:msiRef action="UnregisterFonts" href="http://msdn.microsoft.com/library/aa372112.aspx" />
9478 </xs:appinfo>
9479 <xs:documentation>Removes registration information about installed fonts from the system. The condition for this action may be specified in the element's inner text.</xs:documentation>
9480 </xs:annotation>
9481 </xs:element>
9482 <xs:element name="RemoveRegistryValues" type="ActionSequenceType">
9483 <xs:annotation>
9484 <xs:appinfo>
9485 <xse:msiRef action="RemoveRegistryValues" href="http://msdn.microsoft.com/library/aa371207.aspx" />
9486 </xs:appinfo>
9487 <xs:documentation>Removes a registry value that has been authored into the registry table if the associated component was installed locally or as run from source, and is now set to be uninstalled. The condition for this action may be specified in the element's inner text.</xs:documentation>
9488 </xs:annotation>
9489 </xs:element>
9490 <xs:element name="UnregisterClassInfo" type="ActionSequenceType">
9491 <xs:annotation>
9492 <xs:appinfo>
9493 <xse:msiRef action="UnregisterClassInfo" href="http://msdn.microsoft.com/library/aa372108.aspx" />
9494 </xs:appinfo>
9495 <xs:documentation>Manages the removal of COM class information from the system registry. The condition for this action may be specified in the element's inner text.</xs:documentation>
9496 </xs:annotation>
9497 </xs:element>
9498 <xs:element name="UnregisterExtensionInfo" type="ActionSequenceType">
9499 <xs:annotation>
9500 <xs:appinfo>
9501 <xse:msiRef action="UnregisterExtensionInfo" href="http://msdn.microsoft.com/library/aa372110.aspx" />
9502 </xs:appinfo>
9503 <xs:documentation>Manages the removal of extension-related information from the system registry. The condition for this action may be specified in the element's inner text.</xs:documentation>
9504 </xs:annotation>
9505 </xs:element>
9506 <xs:element name="UnregisterProgIdInfo" type="ActionSequenceType">
9507 <xs:annotation>
9508 <xs:appinfo>
9509 <xse:msiRef action="UnregisterProgIdInfo" href="http://msdn.microsoft.com/library/aa372114.aspx" />
9510 </xs:appinfo>
9511 <xs:documentation>Manages the unregistration of OLE ProgId information with the system. The condition for this action may be specified in the element's inner text.</xs:documentation>
9512 </xs:annotation>
9513 </xs:element>
9514 <xs:element name="UnregisterMIMEInfo" type="ActionSequenceType">
9515 <xs:annotation>
9516 <xs:appinfo>
9517 <xse:msiRef action="UnregisterMIMEInfo" href="http://msdn.microsoft.com/library/aa372113.aspx" />
9518 </xs:appinfo>
9519 <xs:documentation>Unregisters MIME-related registry information from the system. The condition for this action may be specified in the element's inner text.</xs:documentation>
9520 </xs:annotation>
9521 </xs:element>
9522 <xs:element name="RemoveIniValues" type="ActionSequenceType">
9523 <xs:annotation>
9524 <xs:appinfo>
9525 <xse:msiRef action="RemoveIniValues" href="http://msdn.microsoft.com/library/aa371205.aspx" />
9526 </xs:appinfo>
9527 <xs:documentation>Removes .ini file information specified for removal in the RemoveIniFile table if the component is set to be installed locally or run from source. The condition for this action may be specified in the element's inner text.</xs:documentation>
9528 </xs:annotation>
9529 </xs:element>
9530 <xs:element name="RemoveShortcuts" type="ActionSequenceType">
9531 <xs:annotation>
9532 <xs:appinfo>
9533 <xse:msiRef action="RemoveShortcuts" href="http://msdn.microsoft.com/library/aa371209.aspx" />
9534 </xs:appinfo>
9535 <xs:documentation>Manages the removal of an advertised shortcut whose feature is selected for uninstallation or a nonadvertised shortcut whose component is selected for uninstallation. The condition for this action may be specified in the element's inner text.</xs:documentation>
9536 </xs:annotation>
9537 </xs:element>
9538 <xs:element name="RemoveEnvironmentStrings" type="ActionSequenceType">
9539 <xs:annotation>
9540 <xs:appinfo>
9541 <xse:msiRef action="RemoveEnvironmentStrings" href="http://msdn.microsoft.com/library/aa371196.aspx" />
9542 </xs:appinfo>
9543 <xs:documentation>Modifies the values of environment variables. The condition for this action may be specified in the element's inner text.</xs:documentation>
9544 </xs:annotation>
9545 </xs:element>
9546 <xs:element name="RemoveDuplicateFiles" type="ActionSequenceType">
9547 <xs:annotation>
9548 <xs:appinfo>
9549 <xse:msiRef action="RemoveDuplicateFiles" href="http://msdn.microsoft.com/library/aa371195.aspx" />
9550 </xs:appinfo>
9551 <xs:documentation>Deletes files installed by the DuplicateFiles action. The condition for this action may be specified in the element's inner text.</xs:documentation>
9552 </xs:annotation>
9553 </xs:element>
9554 <xs:element name="RemoveFiles" type="ActionSequenceType">
9555 <xs:annotation>
9556 <xs:appinfo>
9557 <xse:msiRef action="RemoveFiles" href="http://msdn.microsoft.com/library/aa371199.aspx" />
9558 </xs:appinfo>
9559 <xs:documentation>Removes files previously installed by the InstallFiles action. The condition for this action may be specified in the element's inner text.</xs:documentation>
9560 </xs:annotation>
9561 </xs:element>
9562 <xs:element name="RemoveFolders" type="ActionSequenceType">
9563 <xs:annotation>
9564 <xs:appinfo>
9565 <xse:msiRef action="RemoveFolders" href="http://msdn.microsoft.com/library/aa371202.aspx" />
9566 </xs:appinfo>
9567 <xs:documentation>Removes any folders linked to components set to be removed or run from source. The condition for this action may be specified in the element's inner text.</xs:documentation>
9568 </xs:annotation>
9569 </xs:element>
9570 <xs:element name="CreateFolders" type="ActionSequenceType">
9571 <xs:annotation>
9572 <xs:appinfo>
9573 <xse:msiRef action="CreateFolders" href="http://msdn.microsoft.com/library/aa368052.aspx" />
9574 </xs:appinfo>
9575 <xs:documentation>Creates empty folders for components that are set to be installed. The condition for this action may be specified in the element's inner text.</xs:documentation>
9576 </xs:annotation>
9577 </xs:element>
9578 <xs:element name="MoveFiles" type="ActionSequenceType">
9579 <xs:annotation>
9580 <xs:appinfo>
9581 <xse:msiRef table="MoveFile" href="http://msdn.microsoft.com/library/aa370055.aspx" />
9582 <xse:msiRef action="MoveFiles" href="http://msdn.microsoft.com/library/aa370054.aspx" />
9583 </xs:appinfo>
9584 <xs:documentation>Locates existing files on the system and moves or copies those files to a new location. The condition for this action may be specified in the element's inner text.</xs:documentation>
9585 </xs:annotation>
9586 </xs:element>
9587 <xs:element name="InstallAdminPackage" type="ActionSequenceType">
9588 <xs:annotation>
9589 <xs:appinfo>
9590 <xse:msiRef action="InstallAdminPackage" href="http://msdn.microsoft.com/library/aa369287.aspx" />
9591 </xs:appinfo>
9592 <xs:documentation>Copies the product database to the administrative installation point. The condition for this action may be specified in the element's inner text.</xs:documentation>
9593 </xs:annotation>
9594 </xs:element>
9595 <xs:element name="InstallFiles" type="ActionSequenceType">
9596 <xs:annotation>
9597 <xs:appinfo>
9598 <xse:msiRef action="InstallFiles" href="http://msdn.microsoft.com/library/aa369503.aspx" />
9599 </xs:appinfo>
9600 <xs:documentation>Copies files specified in the File table from the source directory to the destination directory. The condition for this action may be specified in the element's inner text.</xs:documentation>
9601 </xs:annotation>
9602 </xs:element>
9603 <xs:element name="DuplicateFiles" type="ActionSequenceType">
9604 <xs:annotation>
9605 <xs:appinfo>
9606 <xse:msiRef action="DuplicateFiles" href="http://msdn.microsoft.com/library/aa368334.aspx" />
9607 </xs:appinfo>
9608 <xs:documentation>Duplicates files installed by the InstallFiles action. The condition for this action may be specified in the element's inner text.</xs:documentation>
9609 </xs:annotation>
9610 </xs:element>
9611 <xs:element name="PatchFiles" type="ActionSequenceType">
9612 <xs:annotation>
9613 <xs:appinfo>
9614 <xse:msiRef action="PatchFiles" href="http://msdn.microsoft.com/library/aa370577.aspx" />
9615 </xs:appinfo>
9616 <xs:documentation>Queries the Patch table to determine which patches are to be applied. The condition for this action may be specified in the element's inner text.</xs:documentation>
9617 </xs:annotation>
9618 </xs:element>
9619 <xs:element name="BindImage" type="ActionSequenceType">
9620 <xs:annotation>
9621 <xs:appinfo>
9622 <xse:msiRef table="BindImage" href="http://msdn.microsoft.com/library/aa367828.aspx" />
9623 <xse:msiRef action="BindImage" href="http://msdn.microsoft.com/library/aa367827.aspx" />
9624 </xs:appinfo>
9625 <xs:documentation>Binds each executable or DLL that must be bound to the DLLs imported by it. The condition for this action may be specified in the element's inner text.</xs:documentation>
9626 </xs:annotation>
9627 </xs:element>
9628 <xs:element name="CreateShortcuts" type="ActionSequenceType">
9629 <xs:annotation>
9630 <xs:appinfo>
9631 <xse:msiRef action="CreateShortcuts" href="http://msdn.microsoft.com/library/aa368054.aspx" />
9632 </xs:appinfo>
9633 <xs:documentation>Manages the creation of shortcuts. The condition for this action may be specified in the element's inner text.</xs:documentation>
9634 </xs:annotation>
9635 </xs:element>
9636 <xs:element name="RegisterClassInfo" type="ActionSequenceType">
9637 <xs:annotation>
9638 <xs:appinfo>
9639 <xse:msiRef action="RegisterClassInfo" href="http://msdn.microsoft.com/library/aa371154.aspx" />
9640 </xs:appinfo>
9641 <xs:documentation>Manages the registration of COM class information with the system. The condition for this action may be specified in the element's inner text.</xs:documentation>
9642 </xs:annotation>
9643 </xs:element>
9644 <xs:element name="RegisterExtensionInfo" type="ActionSequenceType">
9645 <xs:annotation>
9646 <xs:appinfo>
9647 <xse:msiRef action="RegisterExtensionInfo" href="http://msdn.microsoft.com/library/aa371156.aspx" />
9648 </xs:appinfo>
9649 <xs:documentation>Manages the registration of extension related information with the system. The condition for this action may be specified in the element's inner text.</xs:documentation>
9650 </xs:annotation>
9651 </xs:element>
9652 <xs:element name="RegisterProgIdInfo" type="ActionSequenceType">
9653 <xs:annotation>
9654 <xs:appinfo>
9655 <xse:msiRef action="RegisterProgIdInfo" href="http://msdn.microsoft.com/library/aa371164.aspx" />
9656 </xs:appinfo>
9657 <xs:documentation>Manages the registration of OLE ProgId information with the system. The condition for this action may be specified in the element's inner text.</xs:documentation>
9658 </xs:annotation>
9659 </xs:element>
9660 <xs:element name="RegisterMIMEInfo" type="ActionSequenceType">
9661 <xs:annotation>
9662 <xs:appinfo>
9663 <xse:msiRef action="RegisterMIMEInfo" href="http://msdn.microsoft.com/library/aa371160.aspx" />
9664 </xs:appinfo>
9665 <xs:documentation>Registers MIME-related registry information with the system. The condition for this action may be specified in the element's inner text.</xs:documentation>
9666 </xs:annotation>
9667 </xs:element>
9668 <xs:element name="WriteRegistryValues" type="ActionSequenceType">
9669 <xs:annotation>
9670 <xs:appinfo>
9671 <xse:msiRef action="WriteRegistryValues" href="http://msdn.microsoft.com/library/aa372891.aspx" />
9672 </xs:appinfo>
9673 <xs:documentation>Sets up an application's registry information. The condition for this action may be specified in the element's inner text.</xs:documentation>
9674 </xs:annotation>
9675 </xs:element>
9676 <xs:element name="WriteIniValues" type="ActionSequenceType">
9677 <xs:annotation>
9678 <xs:appinfo>
9679 <xse:msiRef action="WriteIniValues" href="http://msdn.microsoft.com/library/aa372884.aspx" />
9680 </xs:appinfo>
9681 <xs:documentation>Writes the .ini file information that the application needs written to its .ini files. The condition for this action may be specified in the element's inner text.</xs:documentation>
9682 </xs:annotation>
9683 </xs:element>
9684 <xs:element name="WriteEnvironmentStrings" type="ActionSequenceType">
9685 <xs:annotation>
9686 <xs:appinfo>
9687 <xse:msiRef action="WriteEnvironmentStrings" href="http://msdn.microsoft.com/library/aa372883.aspx" />
9688 </xs:appinfo>
9689 <xs:documentation>Modifies the values of environment variables. The condition for this action may be specified in the element's inner text.</xs:documentation>
9690 </xs:annotation>
9691 </xs:element>
9692 <xs:element name="RegisterFonts" type="ActionSequenceType">
9693 <xs:annotation>
9694 <xs:appinfo>
9695 <xse:msiRef action="RegisterFonts" href="http://msdn.microsoft.com/library/aa371158.aspx" />
9696 </xs:appinfo>
9697 <xs:documentation>Registers installed fonts with the system. The condition for this action may be specified in the element's inner text.</xs:documentation>
9698 </xs:annotation>
9699 </xs:element>
9700 <xs:element name="InstallODBC" type="ActionSequenceType">
9701 <xs:annotation>
9702 <xs:appinfo>
9703 <xse:msiRef action="InstallODBC" href="http://msdn.microsoft.com/library/aa369538.aspx" />
9704 </xs:appinfo>
9705 <xs:documentation>Installs the drivers, translators, and data sources in the ODBCDriver table, ODBCTranslator table, and ODBCDataSource table. The condition for this action may be specified in the element's inner text.</xs:documentation>
9706 </xs:annotation>
9707 </xs:element>
9708 <xs:element name="RegisterTypeLibraries" type="ActionSequenceType">
9709 <xs:annotation>
9710 <xs:appinfo>
9711 <xse:msiRef action="RegisterTypeLibraries" href="http://msdn.microsoft.com/library/aa371165.aspx" />
9712 </xs:appinfo>
9713 <xs:documentation>Registers type libraries with the system. The condition for this action may be specified in the element's inner text.</xs:documentation>
9714 </xs:annotation>
9715 </xs:element>
9716 <xs:element name="SelfRegModules" type="ActionSequenceType">
9717 <xs:annotation>
9718 <xs:appinfo>
9719 <xse:msiRef action="SelfRegModules" href="http://msdn.microsoft.com/library/aa371607.aspx" />
9720 </xs:appinfo>
9721 <xs:documentation>Processes all modules listed in the SelfReg table and registers all installed modules with the system. The condition for this action may be specified in the element's inner text.</xs:documentation>
9722 </xs:annotation>
9723 </xs:element>
9724 <xs:element name="RegisterComPlus" type="ActionSequenceType">
9725 <xs:annotation>
9726 <xs:appinfo>
9727 <xse:msiRef action="RegisterComPlus" href="http://msdn.microsoft.com/library/aa371155.aspx" />
9728 </xs:appinfo>
9729 <xs:documentation>Registers COM+ applications. The condition for this action may be specified in the element's inner text.</xs:documentation>
9730 </xs:annotation>
9731 </xs:element>
9732 <xs:element name="InstallServices" type="ActionSequenceType">
9733 <xs:annotation>
9734 <xs:appinfo>
9735 <xse:msiRef action="InstallServices" href="http://msdn.microsoft.com/library/aa369540.aspx" />
9736 </xs:appinfo>
9737 <xs:documentation>Registers a service for the system. The condition for this action may be specified in the element's inner text.</xs:documentation>
9738 </xs:annotation>
9739 </xs:element>
9740 <xs:element name="StartServices" type="ActionSequenceType">
9741 <xs:annotation>
9742 <xs:appinfo>
9743 <xse:msiRef action="StartServices" href="http://msdn.microsoft.com/library/aa372026.aspx" />
9744 </xs:appinfo>
9745 <xs:documentation>Starts system services. The condition for this action may be specified in the element's inner text.</xs:documentation>
9746 </xs:annotation>
9747 </xs:element>
9748 <xs:element name="RegisterUser" type="ActionSequenceType">
9749 <xs:annotation>
9750 <xs:appinfo>
9751 <xse:msiRef action="RegisterUser" href="http://msdn.microsoft.com/library/aa371166.aspx" />
9752 </xs:appinfo>
9753 <xs:documentation>Registers the user information with the installer to identify the user of a product. The condition for this action may be specified in the element's inner text.</xs:documentation>
9754 </xs:annotation>
9755 </xs:element>
9756 <xs:element name="RegisterProduct" type="ActionSequenceType">
9757 <xs:annotation>
9758 <xs:appinfo>
9759 <xse:msiRef action="RegisterProduct" href="http://msdn.microsoft.com/library/aa371162.aspx" />
9760 </xs:appinfo>
9761 <xs:documentation>Registers the product information with the installer. The condition for this action may be specified in the element's inner text.</xs:documentation>
9762 </xs:annotation>
9763 </xs:element>
9764 <xs:element name="PublishComponents" type="ActionSequenceType">
9765 <xs:annotation>
9766 <xs:appinfo>
9767 <xse:msiRef action="PublishComponents" href="http://msdn.microsoft.com/library/aa370918.aspx" />
9768 </xs:appinfo>
9769 <xs:documentation>Manages the advertisement of the components from the PublishComponent table. The condition for this action may be specified in the element's inner text.</xs:documentation>
9770 </xs:annotation>
9771 </xs:element>
9772 <xs:element name="MsiPublishAssemblies" type="ActionSequenceType">
9773 <xs:annotation>
9774 <xs:appinfo>
9775 <xse:msiRef action="MsiPublishAssemblies" href="http://msdn.microsoft.com/library/aa370359.aspx" />
9776 </xs:appinfo>
9777 <xs:documentation>Manages the advertisement of CLR and Win32 assemblies. The condition for this action may be specified in the element's inner text.</xs:documentation>
9778 </xs:annotation>
9779 </xs:element>
9780 <xs:element name="PublishFeatures" type="ActionSequenceType">
9781 <xs:annotation>
9782 <xs:appinfo>
9783 <xse:msiRef action="PublishFeatures" href="http://msdn.microsoft.com/library/aa370923.aspx" />
9784 </xs:appinfo>
9785 <xs:documentation>Writes each feature's state into the system registry. The condition for this action may be specified in the element's inner text.</xs:documentation>
9786 </xs:annotation>
9787 </xs:element>
9788 <xs:element name="PublishProduct" type="ActionSequenceType">
9789 <xs:annotation>
9790 <xs:appinfo>
9791 <xse:msiRef action="PublishProduct" href="http://msdn.microsoft.com/library/aa370932.aspx" />
9792 </xs:appinfo>
9793 <xs:documentation>Manages the advertisement of the product information with the system. The condition for this action may be specified in the element's inner text.</xs:documentation>
9794 </xs:annotation>
9795 </xs:element>
9796 <xs:element name="InstallFinalize" type="ActionSequenceType">
9797 <xs:annotation>
9798 <xs:appinfo>
9799 <xse:seeAlso ref="InstallInitialize" />
9800 <xse:msiRef action="InstallFinalize" href="http://msdn.microsoft.com/library/aa369505.aspx" />
9801 </xs:appinfo>
9802 <xs:documentation>Marks the end of a sequence of actions that change the system. The condition for this action may be specified in the element's inner text.</xs:documentation>
9803 </xs:annotation>
9804 </xs:element>
9805 <xs:element name="AppSearch" type="ActionModuleSequenceType">
9806 <xs:annotation>
9807 <xs:appinfo>
9808 <xse:seeAlso ref="ComponentSearch" />
9809 <xse:seeAlso ref="FileSearch" />
9810 <xse:seeAlso ref="IniFileSearch" />
9811 <xse:seeAlso ref="RegistrySearch" />
9812 <xse:msiRef table="AppSearch" href="http://msdn.microsoft.com/library/aa367579.aspx" />
9813 <xse:msiRef action="AppSearch" href="http://msdn.microsoft.com/library/aa367578.aspx" />
9814 </xs:appinfo>
9815 <xs:documentation>Uses file signatures to search for existing versions of products. The AppSearch action may use this information to determine where upgrades are to be installed. The AppSearch action can also be used to set a property to the existing value of an registry or .ini file entry. AppSearch should be authored into the InstallUISequence table and InstallExecuteSequence table. The installer prevents The AppSearch action from running in the InstallExecuteSequence sequence if the action has already run in InstallUISequence sequence. The AppSearch action searches for file signatures using the CompLocator table first, the RegLocator table next, then the IniLocator table, and finally the DrLocator table. The condition for this action may be specified in the element's inner text.</xs:documentation>
9816 </xs:annotation>
9817 </xs:element>
9818 <xs:element name="CCPSearch" type="ActionModuleSequenceType">
9819 <xs:annotation>
9820 <xs:appinfo>
9821 <xse:seeAlso ref="RMCCPSearch" />
9822 <xse:seeAlso ref="ComplianceCheck" />
9823 <xse:msiRef action="CCPSearch" href="http://msdn.microsoft.com/library/aa367845.aspx" />
9824 </xs:appinfo>
9825 <xs:documentation>Uses file signatures to validate that qualifying products are installed on a system before an upgrade installation is performed. The CCPSearch action should be authored into the InstallUISequence table and InstallExecuteSequence table. The installer prevents the CCPSearch action from running in the InstallExecuteSequence sequence if the action has already run in InstallUISequence sequence. The CCPSearch action must come before the RMCCPSearch action. The condition for this action may be specified in the element's inner text.</xs:documentation>
9826 </xs:annotation>
9827 </xs:element>
9828 <xs:element name="RMCCPSearch" type="ActionModuleSequenceType">
9829 <xs:annotation>
9830 <xs:appinfo>
9831 <xse:seeAlso ref="CCPSearch" />
9832 <xse:seeAlso ref="ComplianceCheck" />
9833 <xse:msiRef action="RMCCPSearch" href="http://msdn.microsoft.com/library/aa371364.aspx" />
9834 </xs:appinfo>
9835 <xs:documentation>Uses file signatures to validate that qualifying products are installed on a system before an upgrade installation is performed. The RMCCPSearch action should be authored into the InstallUISequence table and InstallExecuteSequence table. The installer prevents RMCCPSearch from running in the InstallExecuteSequence sequence if the action has already run in InstallUISequence sequence. The RMCCPSearch action requires the CCP_DRIVE property to be set to the root path on the removable volume that has the installation for any of the qualifying products. The condition for this action may be specified in the element's inner text.</xs:documentation>
9836 </xs:annotation>
9837 </xs:element>
9838 <xs:element name="LaunchConditions" type="ActionModuleSequenceType">
9839 <xs:annotation>
9840 <xs:appinfo>
9841 <xse:seeAlso ref="Condition" />
9842 <xse:msiRef action="LaunchConditions" href="http://msdn.microsoft.com/library/aa369751.aspx" />
9843 </xs:appinfo>
9844 <xs:documentation>Queries the LaunchCondition table and evaluates each conditional statement recorded there. If any of these conditional statements fail, an error message is displayed to the user and the installation is terminated. The LaunchConditions action is optional. This action is normally the first in the sequence, but the AppSearch Action may be sequenced before the LaunchConditions action. If there are launch conditions that do not apply to all installation modes, the appropriate installation mode property should be used in a conditional expression in the appropriate sequence table. The condition for this action may be specified in the element's inner text.</xs:documentation>
9845 </xs:annotation>
9846 </xs:element>
9847 <xs:element name="FindRelatedProducts" type="ActionModuleSequenceType">
9848 <xs:annotation>
9849 <xs:appinfo>
9850 <xse:seeAlso ref="Upgrade" />
9851 <xse:msiRef action="FindRelatedProducts" href="http://msdn.microsoft.com/library/aa368600.aspx" />
9852 </xs:appinfo>
9853 <xs:documentation>Runs through each record of the Upgrade table in sequence and compares the upgrade code, product version, and language in each row to products installed on the system. When FindRelatedProducts detects a correspondence between the upgrade information and an installed product, it appends the product code to the property specified in the ActionProperty column of the UpgradeTable. The FindRelatedProducts action only runs the first time the product is installed. The FindRelatedProducts action does not run during maintenance mode or uninstallation. FindRelatedProducts should be authored into the InstallUISequence table and InstallExecuteSequence tables. The installer prevents FindRelatedProducts from running in InstallExecuteSequence if the action has already run in InstallUISequence. The FindRelatedProducts action must come before the MigrateFeatureStates action and the RemoveExistingProducts action. The condition for this action may be specified in the element's inner text.</xs:documentation>
9854 </xs:annotation>
9855 </xs:element>
9856 <xs:element name="InstallExecute" type="ActionModuleSequenceType">
9857 <xs:annotation>
9858 <xs:appinfo>
9859 <xse:msiRef action="InstallExecute" href="http://msdn.microsoft.com/library/aa369502.aspx" />
9860 </xs:appinfo>
9861 <xs:documentation>Runs a script containing all operations spooled since either the start of the installation or the last InstallExecute action, or InstallExecuteAgain action. Special actions don't have a built-in sequence number and thus must appear relative to another action. The suggested way to do this is by using the Before or After attribute. InstallExecute and InstallExecuteAgain can optionally appear anywhere between InstallInitialize and InstallFinalize.</xs:documentation>
9862 </xs:annotation>
9863 </xs:element>
9864 <xs:element name="InstallExecuteAgain" type="ActionModuleSequenceType">
9865 <xs:annotation>
9866 <xs:appinfo>
9867 <xse:msiRef action="InstallExecuteAgain" href="http://msdn.microsoft.com/library/aa369497.aspx" />
9868 </xs:appinfo>
9869 <xs:documentation>Runs a script containing all operations spooled since either the start of the installation or the last InstallExecute action, or InstallExecuteAgain action. Should only be used after InstallExecute. Special actions don't have a built-in sequence number and thus must appear relative to another action. The suggested way to do this is by using the Before or After attribute. InstallExecute and InstallExecuteAgain can optionally appear anywhere between InstallInitialize and InstallFinalize.</xs:documentation>
9870 </xs:annotation>
9871 </xs:element>
9872 <xs:element name="DisableRollback" type="ActionModuleSequenceType">
9873 <xs:annotation>
9874 <xs:appinfo>
9875 <xse:msiRef action="DisableRollback" href="http://msdn.microsoft.com/library/aa368308.aspx" />
9876 </xs:appinfo>
9877 <xs:documentation>Disables rollback for the remainder of the installation. Special actions don't have a built-in sequence number and thus must appear relative to another action. The suggested way to do this is by using the Before or After attribute. InstallExecute and InstallExecuteAgain can optionally appear anywhere between InstallInitialize and InstallFinalize.</xs:documentation>
9878 </xs:annotation>
9879 </xs:element>
9880 <xs:element name="RemoveExistingProducts" type="ActionModuleSequenceType">
9881 <xs:annotation>
9882 <xs:appinfo>
9883 <xse:msiRef action="RemoveExistingProducts" href="http://msdn.microsoft.com/library/aa371197.aspx" />
9884 </xs:appinfo>
9885 <xs:documentation>Goes through the product codes listed in the ActionProperty column of the Upgrade table and removes the products in sequence. Special actions don't have a built-in sequence number and thus must appear relative to another action. The suggested way to do this is by using the Before or After attribute. InstallExecute and InstallExecuteAgain can optionally appear anywhere between InstallInitialize and InstallFinalize.</xs:documentation>
9886 </xs:annotation>
9887 </xs:element>
9888 <xs:element name="ScheduleReboot" type="ActionModuleSequenceType">
9889 <xs:annotation>
9890 <xs:appinfo>
9891 <xse:msiRef action="ScheduleReboot" href="http://msdn.microsoft.com/library/aa371527.aspx" />
9892 </xs:appinfo>
9893 <xs:documentation>Prompts the user to restart the system at the end of installation. Special actions don't have a built-in sequence number and thus must appear relative to another action. The suggested way to do this is by using the Before or After attribute. InstallExecute and InstallExecuteAgain can optionally appear anywhere between InstallInitialize and InstallFinalize.</xs:documentation>
9894 </xs:annotation>
9895 </xs:element>
9896 <xs:element name="ForceReboot" type="ActionModuleSequenceType">
9897 <xs:annotation>
9898 <xs:appinfo>
9899 <xse:msiRef action="ForceReboot" href="http://msdn.microsoft.com/library/aa368607.aspx" />
9900 </xs:appinfo>
9901 <xs:documentation>Prompts the user for a restart of the system during the installation. Special actions don't have a built-in sequence number and thus must appear relative to another action. The suggested way to do this is by using the Before or After attribute. InstallExecute and InstallExecuteAgain can optionally appear anywhere between InstallInitialize and InstallFinalize.</xs:documentation>
9902 </xs:annotation>
9903 </xs:element>
9904 <xs:element name="ResolveSource" type="ActionModuleSequenceType">
9905 <xs:annotation>
9906 <xs:appinfo>
9907 <xse:msiRef action="ResolveSource" href="http://msdn.microsoft.com/library/aa371232.aspx" />
9908 </xs:appinfo>
9909 <xs:documentation>Determines the location of the source and sets the SourceDir property if the source has not been resolved yet. Special actions don't have a built-in sequence number and thus must appear relative to another action. The suggested way to do this is by using the Before or After attribute. InstallExecute and InstallExecuteAgain can optionally appear anywhere between InstallInitialize and InstallFinalize.</xs:documentation>
9910 </xs:annotation>
9911 </xs:element>
9912 <!-- CustomActions and Dialogs of course aren't built in and must be specified relative to another action -->
9913 <xs:element name="Custom">
9914 <xs:annotation>
9915 <xs:appinfo>
9916 <xse:seeAlso ref="CustomAction" />
9917 </xs:appinfo>
9918 <xs:documentation>Use to sequence a custom action.</xs:documentation>
9919 </xs:annotation>
9920 <xs:complexType>
9921 <xs:simpleContent>
9922 <xs:extension base="xs:string">
9923 <xs:annotation>
9924 <xs:documentation>Text node specifies the condition of the action.</xs:documentation>
9925 </xs:annotation>
9926 <xs:attribute name="Action" type="xs:string" use="required">
9927 <xs:annotation>
9928 <xs:documentation>The action to which the Custom element applies.</xs:documentation>
9929 </xs:annotation>
9930 </xs:attribute>
9931 <xs:attribute name="OnExit" type="ExitType">
9932 <xs:annotation>
9933 <xs:documentation>Mutually exclusive with Before, After, and Sequence attributes</xs:documentation>
9934 </xs:annotation>
9935 </xs:attribute>
9936 <xs:attribute name="Before" type="xs:string">
9937 <xs:annotation>
9938 <xs:documentation>The name of the standard or custom action before which this action should be performed. Mutually exclusive with OnExit, After, and Sequence attributes</xs:documentation>
9939 </xs:annotation>
9940 </xs:attribute>
9941 <xs:attribute name="After" type="xs:string">
9942 <xs:annotation>
9943 <xs:documentation>The name of the standard or custom action after which this action should be performed. Mutually exclusive with Before, OnExit, and Sequence attributes</xs:documentation>
9944 </xs:annotation>
9945 </xs:attribute>
9946 <xs:attribute name="Overridable" type="YesNoTypeUnion">
9947 <xs:annotation>
9948 <xs:documentation>
9949 If "yes", the sequencing of this action may be overridden by sequencing elsewhere.
9950 </xs:documentation>
9951 </xs:annotation>
9952 </xs:attribute>
9953 <xs:attribute name="Sequence" type="xs:integer">
9954 <xs:annotation>
9955 <xs:documentation>The sequence number for this action. Mutually exclusive with Before, After, and OnExit attributes</xs:documentation>
9956 </xs:annotation>
9957 </xs:attribute>
9958 </xs:extension>
9959 </xs:simpleContent>
9960 </xs:complexType>
9961 </xs:element>
9962 <xs:element name="Show">
9963 <xs:complexType>
9964 <xs:simpleContent>
9965 <xs:extension base="xs:string">
9966 <xs:attribute name="Dialog" type="xs:string" use="required" />
9967 <xs:attribute name="OnExit" type="ExitType">
9968 <xs:annotation>
9969 <xs:documentation>mutually exclusive with Before, After, and Sequence attributes</xs:documentation>
9970 </xs:annotation>
9971 </xs:attribute>
9972 <xs:attribute name="Before" type="xs:string" />
9973 <xs:attribute name="After" type="xs:string" />
9974 <xs:attribute name="Overridable" type="YesNoTypeUnion">
9975 <xs:annotation>
9976 <xs:documentation>
9977 If "yes", the sequencing of this dialog may be overridden by sequencing elsewhere.
9978 </xs:documentation>
9979 </xs:annotation>
9980 </xs:attribute>
9981 <xs:attribute name="Sequence" type="xs:integer" />
9982 </xs:extension>
9983 </xs:simpleContent>
9984 </xs:complexType>
9985 </xs:element>
9986 <!-- standard sequence table compositions -->
9987 <xs:element name="InstallUISequence">
9988 <xs:annotation>
9989 <xs:appinfo>
9990 <xse:msiRef table="InstallUISequence" href="http://msdn.microsoft.com/library/aa369543.aspx" />
9991 </xs:appinfo>
9992 </xs:annotation>
9993 <xs:complexType>
9994 <xs:choice minOccurs="0" maxOccurs="unbounded">
9995 <xs:element ref="Custom" minOccurs="0" maxOccurs="unbounded">
9996 <xs:annotation>
9997 <xs:documentation>Use to sequence a custom action.</xs:documentation>
9998 </xs:annotation>
9999 </xs:element>
10000 <xs:element ref="Show" minOccurs="0" maxOccurs="unbounded">
10001 <xs:annotation>
10002 <xs:documentation>Displays a Dialog.</xs:documentation>
10003 </xs:annotation>
10004 </xs:element>
10005 <xs:element ref="ScheduleReboot" minOccurs="0">
10006 <xs:annotation>
10007 <xs:documentation>Prompts the user to restart the system at the end of installation. Not fixed sequence.</xs:documentation>
10008 </xs:annotation>
10009 </xs:element>
10010 <xs:element ref="LaunchConditions" minOccurs="0">
10011 <xs:annotation>
10012 <xs:documentation>Queries the LaunchCondition table and evaluates each conditional statement recorded there.</xs:documentation>
10013 </xs:annotation>
10014 </xs:element>
10015 <xs:element ref="FindRelatedProducts" minOccurs="0">
10016 <xs:annotation>
10017 <xs:documentation>Runs through each record of the Upgrade table in sequence and compares the upgrade code, product version, and language in each row to products installed on the system.</xs:documentation>
10018 </xs:annotation>
10019 </xs:element>
10020 <xs:element ref="AppSearch" minOccurs="0">
10021 <xs:annotation>
10022 <xs:documentation>Uses file signatures to search for existing versions of products.</xs:documentation>
10023 </xs:annotation>
10024 </xs:element>
10025 <xs:element ref="CCPSearch" minOccurs="0">
10026 <xs:annotation>
10027 <xs:documentation>Uses file signatures to validate that qualifying products are installed on a system before an upgrade installation is performed.</xs:documentation>
10028 </xs:annotation>
10029 </xs:element>
10030 <xs:element ref="RMCCPSearch" minOccurs="0">
10031 <xs:annotation>
10032 <xs:documentation>Uses file signatures to validate that qualifying products are installed on a system before an upgrade installation is performed.</xs:documentation>
10033 </xs:annotation>
10034 </xs:element>
10035 <xs:element ref="ValidateProductID">
10036 <xs:annotation>
10037 <xs:documentation>Sets the ProductID property to the full product identifier.</xs:documentation>
10038 </xs:annotation>
10039 </xs:element>
10040 <xs:element ref="CostInitialize">
10041 <xs:annotation>
10042 <xs:documentation>Initiates the internal installation costing process.</xs:documentation>
10043 </xs:annotation>
10044 </xs:element>
10045 <xs:element ref="FileCost">
10046 <xs:annotation>
10047 <xs:documentation>Initiates dynamic costing of standard installation actions.</xs:documentation>
10048 </xs:annotation>
10049 </xs:element>
10050 <xs:element ref="IsolateComponents">
10051 <xs:annotation>
10052 <xs:documentation>Installs a copy of a component (commonly a shared DLL) into a private location for use by a specific application (typically an .exe).</xs:documentation>
10053 </xs:annotation>
10054 </xs:element>
10055 <xs:element ref="ResolveSource" minOccurs="0">
10056 <xs:annotation>
10057 <xs:documentation>Determines the location of the source and sets the SourceDir property if the source has not been resolved yet.</xs:documentation>
10058 </xs:annotation>
10059 </xs:element>
10060 <xs:element ref="CostFinalize">
10061 <xs:annotation>
10062 <xs:documentation>Ends the internal installation costing process begun by the CostInitialize action.</xs:documentation>
10063 </xs:annotation>
10064 </xs:element>
10065 <xs:element ref="MigrateFeatureStates">
10066 <xs:annotation>
10067 <xs:documentation>Used for upgrading or installing over an existing application.</xs:documentation>
10068 </xs:annotation>
10069 </xs:element>
10070 <xs:element ref="ExecuteAction" minOccurs="0">
10071 <xs:annotation>
10072 <xs:documentation>Initiates the execution sequence.</xs:documentation>
10073 </xs:annotation>
10074 </xs:element>
10075 </xs:choice>
10076 </xs:complexType>
10077 </xs:element>
10078 <xs:element name="InstallExecuteSequence">
10079 <xs:annotation>
10080 <xs:appinfo>
10081 <xse:msiRef table="InstallExecuteSequence" href="http://msdn.microsoft.com/library/aa369500.aspx" />
10082 </xs:appinfo>
10083 </xs:annotation>
10084 <xs:complexType>
10085 <xs:choice minOccurs="0" maxOccurs="unbounded">
10086 <!-- used only to supply default op for child action elements -->
10087 <xs:element ref="Custom" minOccurs="0" maxOccurs="unbounded">
10088 <xs:annotation>
10089 <xs:documentation>Use to sequence a custom action.</xs:documentation>
10090 </xs:annotation>
10091 </xs:element>
10092 <xs:element ref="ScheduleReboot" minOccurs="0">
10093 <xs:annotation>
10094 <xs:documentation>Prompts the user to restart the system at the end of installation. Not fixed sequence.</xs:documentation>
10095 </xs:annotation>
10096 </xs:element>
10097 <xs:element ref="ForceReboot" minOccurs="0">
10098 <xs:annotation>
10099 <xs:documentation>Prompts the user for a restart of the system during the installation. Not fixed sequence.</xs:documentation>
10100 </xs:annotation>
10101 </xs:element>
10102 <xs:element ref="ResolveSource" minOccurs="0">
10103 <xs:annotation>
10104 <xs:documentation>Determines the location of the source and sets the SourceDir property if the source has not been resolved yet. Not fixed sequence.</xs:documentation>
10105 </xs:annotation>
10106 </xs:element>
10107 <xs:element ref="LaunchConditions" minOccurs="0">
10108 <xs:annotation>
10109 <xs:documentation>Queries the LaunchCondition table and evaluates each conditional statement recorded there.</xs:documentation>
10110 </xs:annotation>
10111 </xs:element>
10112 <xs:element ref="FindRelatedProducts" minOccurs="0">
10113 <xs:annotation>
10114 <xs:documentation>Runs through each record of the Upgrade table in sequence and compares the upgrade code, product version, and language in each row to products installed on the system.</xs:documentation>
10115 </xs:annotation>
10116 </xs:element>
10117 <xs:element ref="AppSearch" minOccurs="0">
10118 <xs:annotation>
10119 <xs:documentation>Uses file signatures to search for existing versions of products.</xs:documentation>
10120 </xs:annotation>
10121 </xs:element>
10122 <xs:element ref="CCPSearch">
10123 <xs:annotation>
10124 <xs:documentation>Uses file signatures to validate that qualifying products are installed on a system before an upgrade installation is performed.</xs:documentation>
10125 </xs:annotation>
10126 </xs:element>
10127 <xs:element ref="RMCCPSearch">
10128 <xs:annotation>
10129 <xs:documentation>Uses file signatures to validate that qualifying products are installed on a system before an upgrade installation is performed.</xs:documentation>
10130 </xs:annotation>
10131 </xs:element>
10132 <xs:element ref="ValidateProductID">
10133 <xs:annotation>
10134 <xs:documentation>Sets the ProductID property to the full product identifier.</xs:documentation>
10135 </xs:annotation>
10136 </xs:element>
10137 <xs:element ref="CostInitialize">
10138 <xs:annotation>
10139 <xs:documentation>Initiates the internal installation costing process.</xs:documentation>
10140 </xs:annotation>
10141 </xs:element>
10142 <xs:element ref="FileCost">
10143 <xs:annotation>
10144 <xs:documentation>Initiates dynamic costing of standard installation actions.</xs:documentation>
10145 </xs:annotation>
10146 </xs:element>
10147 <xs:element ref="IsolateComponents">
10148 <xs:annotation>
10149 <xs:documentation>Installs a copy of a component (commonly a shared DLL) into a private location for use by a specific application (typically an .exe).</xs:documentation>
10150 </xs:annotation>
10151 </xs:element>
10152 <xs:element ref="CostFinalize">
10153 <xs:annotation>
10154 <xs:documentation>Ends the internal installation costing process begun by the CostInitialize action.</xs:documentation>
10155 </xs:annotation>
10156 </xs:element>
10157 <xs:element ref="SetODBCFolders">
10158 <xs:annotation>
10159 <xs:documentation>Checks for existing ODBC drivers and sets the target directory for each new driver to the location of an existing driver.</xs:documentation>
10160 </xs:annotation>
10161 </xs:element>
10162 <xs:element ref="MigrateFeatureStates">
10163 <xs:annotation>
10164 <xs:documentation>Used for upgrading or installing over an existing application.</xs:documentation>
10165 </xs:annotation>
10166 </xs:element>
10167 <xs:element ref="InstallValidate">
10168 <xs:annotation>
10169 <xs:documentation>Verifies that all costed volumes have enough space for the installation.</xs:documentation>
10170 </xs:annotation>
10171 </xs:element>
10172 <xs:element ref="InstallInitialize">
10173 <xs:annotation>
10174 <xs:documentation>Marks the beginning of a sequence of actions that change the system.</xs:documentation>
10175 </xs:annotation>
10176 </xs:element>
10177 <xs:element ref="AllocateRegistrySpace" minOccurs="0">
10178 <xs:annotation>
10179 <xs:documentation>Ensures the needed amount of space exists in the registry.</xs:documentation>
10180 </xs:annotation>
10181 </xs:element>
10182 <xs:element ref="ProcessComponents">
10183 <xs:annotation>
10184 <xs:documentation>Registers and unregisters components, their key paths, and the component clients.</xs:documentation>
10185 </xs:annotation>
10186 </xs:element>
10187 <xs:element ref="UnpublishComponents" minOccurs="0">
10188 <xs:annotation>
10189 <xs:documentation>Manages the unadvertisement of components listed in the PublishComponent table.</xs:documentation>
10190 </xs:annotation>
10191 </xs:element>
10192 <xs:element ref="UnpublishFeatures" minOccurs="0">
10193 <xs:annotation>
10194 <xs:documentation>Removes selection-state and feature-component mapping information from the registry.</xs:documentation>
10195 </xs:annotation>
10196 </xs:element>
10197 <xs:element ref="StopServices">
10198 <xs:annotation>
10199 <xs:documentation>Stops system services.</xs:documentation>
10200 </xs:annotation>
10201 </xs:element>
10202 <xs:element ref="DeleteServices">
10203 <xs:annotation>
10204 <xs:documentation>Stops a service and removes its registration from the system.</xs:documentation>
10205 </xs:annotation>
10206 </xs:element>
10207 <xs:element ref="UnregisterComPlus">
10208 <xs:annotation>
10209 <xs:documentation>Removes COM+ applications from the registry.</xs:documentation>
10210 </xs:annotation>
10211 </xs:element>
10212 <xs:element ref="SelfUnregModules" minOccurs="0">
10213 <xs:annotation>
10214 <xs:documentation>Unregisters all modules listed in the SelfReg table that are scheduled to be uninstalled.</xs:documentation>
10215 </xs:annotation>
10216 </xs:element>
10217 <xs:element ref="UnregisterTypeLibraries" minOccurs="0">
10218 <xs:annotation>
10219 <xs:documentation>Unregisters type libraries from the system.</xs:documentation>
10220 </xs:annotation>
10221 </xs:element>
10222 <xs:element ref="RemoveODBC">
10223 <xs:annotation>
10224 <xs:documentation>Removes the data sources, translators, and drivers listed for removal during the installation.</xs:documentation>
10225 </xs:annotation>
10226 </xs:element>
10227 <xs:element ref="UnregisterFonts">
10228 <xs:annotation>
10229 <xs:documentation>Removes registration information about installed fonts from the system.</xs:documentation>
10230 </xs:annotation>
10231 </xs:element>
10232 <xs:element ref="RemoveRegistryValues" minOccurs="0">
10233 <xs:annotation>
10234 <xs:documentation>Removes a registry value that has been authored into the registry table if the associated component was installed locally or as run from source, and is now set to be uninstalled.</xs:documentation>
10235 </xs:annotation>
10236 </xs:element>
10237 <xs:element ref="UnregisterClassInfo" minOccurs="0">
10238 <xs:annotation>
10239 <xs:documentation>Manages the removal of COM class information from the system registry.</xs:documentation>
10240 </xs:annotation>
10241 </xs:element>
10242 <xs:element ref="UnregisterExtensionInfo">
10243 <xs:annotation>
10244 <xs:documentation>Manages the removal of extension-related information from the system registry.</xs:documentation>
10245 </xs:annotation>
10246 </xs:element>
10247 <xs:element ref="UnregisterProgIdInfo" minOccurs="0">
10248 <xs:annotation>
10249 <xs:documentation>Manages the unregistration of OLE ProgId information with the system.</xs:documentation>
10250 </xs:annotation>
10251 </xs:element>
10252 <xs:element ref="UnregisterMIMEInfo">
10253 <xs:annotation>
10254 <xs:documentation>Unregisters MIME-related registry information from the system.</xs:documentation>
10255 </xs:annotation>
10256 </xs:element>
10257 <xs:element ref="RemoveIniValues">
10258 <xs:annotation>
10259 <xs:documentation>Removes .ini file information specified for removal in the RemoveIniFile table if the component is set to be installed locally or run from source.</xs:documentation>
10260 </xs:annotation>
10261 </xs:element>
10262 <xs:element ref="RemoveShortcuts" minOccurs="0">
10263 <xs:annotation>
10264 <xs:documentation>Manages the removal of an advertised shortcut whose feature is selected for uninstallation or a nonadvertised shortcut whose component is selected for uninstallation.</xs:documentation>
10265 </xs:annotation>
10266 </xs:element>
10267 <xs:element ref="RemoveEnvironmentStrings">
10268 <xs:annotation>
10269 <xs:documentation>Modifies the values of environment variables.</xs:documentation>
10270 </xs:annotation>
10271 </xs:element>
10272 <xs:element ref="RemoveDuplicateFiles">
10273 <xs:annotation>
10274 <xs:documentation>Deletes files installed by the DuplicateFiles action.</xs:documentation>
10275 </xs:annotation>
10276 </xs:element>
10277 <xs:element ref="RemoveFiles" minOccurs="0">
10278 <xs:annotation>
10279 <xs:documentation>Removes files previously installed by the InstallFiles action.</xs:documentation>
10280 </xs:annotation>
10281 </xs:element>
10282 <xs:element ref="RemoveFolders" minOccurs="0">
10283 <xs:annotation>
10284 <xs:documentation>Removes any folders linked to components set to be removed or run from source.</xs:documentation>
10285 </xs:annotation>
10286 </xs:element>
10287 <xs:element ref="CreateFolders" minOccurs="0">
10288 <xs:annotation>
10289 <xs:documentation>Creates empty folders for components that are set to be installed.</xs:documentation>
10290 </xs:annotation>
10291 </xs:element>
10292 <xs:element ref="MoveFiles">
10293 <xs:annotation>
10294 <xs:documentation>Locates existing files on the system and moves or copies those files to a new location.</xs:documentation>
10295 </xs:annotation>
10296 </xs:element>
10297 <xs:element ref="InstallFiles" minOccurs="0">
10298 <xs:annotation>
10299 <xs:documentation>Copies files specified in the File table from the source directory to the destination directory.</xs:documentation>
10300 </xs:annotation>
10301 </xs:element>
10302 <xs:element ref="DuplicateFiles">
10303 <xs:annotation>
10304 <xs:documentation>Duplicates files installed by the InstallFiles action.</xs:documentation>
10305 </xs:annotation>
10306 </xs:element>
10307 <xs:element ref="PatchFiles">
10308 <xs:annotation>
10309 <xs:documentation>Queries the Patch table to determine which patches are to be applied.</xs:documentation>
10310 </xs:annotation>
10311 </xs:element>
10312 <xs:element ref="BindImage" minOccurs="0">
10313 <xs:annotation>
10314 <xs:documentation>Binds each executable or DLL that must be bound to the DLLs imported by it.</xs:documentation>
10315 </xs:annotation>
10316 </xs:element>
10317 <xs:element ref="CreateShortcuts" minOccurs="0">
10318 <xs:annotation>
10319 <xs:documentation>Manages the creation of shortcuts.</xs:documentation>
10320 </xs:annotation>
10321 </xs:element>
10322 <xs:element ref="RegisterClassInfo" minOccurs="0">
10323 <xs:annotation>
10324 <xs:documentation>Manages the registration of COM class information with the system.</xs:documentation>
10325 </xs:annotation>
10326 </xs:element>
10327 <xs:element ref="RegisterExtensionInfo">
10328 <xs:annotation>
10329 <xs:documentation>Manages the registration of extension related information with the system.</xs:documentation>
10330 </xs:annotation>
10331 </xs:element>
10332 <xs:element ref="RegisterProgIdInfo" minOccurs="0">
10333 <xs:annotation>
10334 <xs:documentation>Manages the registration of OLE ProgId information with the system.</xs:documentation>
10335 </xs:annotation>
10336 </xs:element>
10337 <xs:element ref="RegisterMIMEInfo">
10338 <xs:annotation>
10339 <xs:documentation>Registers MIME-related registry information with the system.</xs:documentation>
10340 </xs:annotation>
10341 </xs:element>
10342 <xs:element ref="WriteRegistryValues" minOccurs="0">
10343 <xs:annotation>
10344 <xs:documentation>Sets up an application's registry information.</xs:documentation>
10345 </xs:annotation>
10346 </xs:element>
10347 <xs:element ref="WriteIniValues">
10348 <xs:annotation>
10349 <xs:documentation>Writes the .ini file information that the application needs written to its .ini files.</xs:documentation>
10350 </xs:annotation>
10351 </xs:element>
10352 <xs:element ref="WriteEnvironmentStrings">
10353 <xs:annotation>
10354 <xs:documentation>Modifies the values of environment variables.</xs:documentation>
10355 </xs:annotation>
10356 </xs:element>
10357 <xs:element ref="RegisterFonts">
10358 <xs:annotation>
10359 <xs:documentation>Registers installed fonts with the system.</xs:documentation>
10360 </xs:annotation>
10361 </xs:element>
10362 <xs:element ref="InstallODBC">
10363 <xs:annotation>
10364 <xs:documentation>Installs the drivers, translators, and data sources in the ODBCDriver table, ODBCTranslator table, and ODBCDataSource table.</xs:documentation>
10365 </xs:annotation>
10366 </xs:element>
10367 <xs:element ref="RegisterTypeLibraries" minOccurs="0">
10368 <xs:annotation>
10369 <xs:documentation>Registers type libraries with the system.</xs:documentation>
10370 </xs:annotation>
10371 </xs:element>
10372 <xs:element ref="SelfRegModules" minOccurs="0">
10373 <xs:annotation>
10374 <xs:documentation>Processes all modules listed in the SelfReg table and registers all installed modules with the system.</xs:documentation>
10375 </xs:annotation>
10376 </xs:element>
10377 <xs:element ref="RegisterComPlus">
10378 <xs:annotation>
10379 <xs:documentation>Registers COM+ applications.</xs:documentation>
10380 </xs:annotation>
10381 </xs:element>
10382 <xs:element ref="InstallServices">
10383 <xs:annotation>
10384 <xs:documentation>Registers a service for the system.</xs:documentation>
10385 </xs:annotation>
10386 </xs:element>
10387 <xs:element ref="StartServices">
10388 <xs:annotation>
10389 <xs:documentation>Starts system services.</xs:documentation>
10390 </xs:annotation>
10391 </xs:element>
10392 <xs:element ref="RegisterUser" minOccurs="0">
10393 <xs:annotation>
10394 <xs:documentation>Registers the user information with the installer to identify the user of a product.</xs:documentation>
10395 </xs:annotation>
10396 </xs:element>
10397 <xs:element ref="RegisterProduct" minOccurs="0">
10398 <xs:annotation>
10399 <xs:documentation>Registers the product information with the installer.</xs:documentation>
10400 </xs:annotation>
10401 </xs:element>
10402 <xs:element ref="PublishComponents" minOccurs="0">
10403 <xs:annotation>
10404 <xs:documentation>Manages the advertisement of the components from the PublishComponent table.</xs:documentation>
10405 </xs:annotation>
10406 </xs:element>
10407 <xs:element ref="PublishFeatures" minOccurs="0">
10408 <xs:annotation>
10409 <xs:documentation>Writes each feature's state into the system registry.</xs:documentation>
10410 </xs:annotation>
10411 </xs:element>
10412 <xs:element ref="PublishProduct" minOccurs="0">
10413 <xs:annotation>
10414 <xs:documentation>Manages the advertisement of the product information with the system.</xs:documentation>
10415 </xs:annotation>
10416 </xs:element>
10417 <xs:element ref="InstallFinalize">
10418 <xs:annotation>
10419 <xs:documentation>Marks the end of a sequence of actions that change the system.</xs:documentation>
10420 </xs:annotation>
10421 </xs:element>
10422 <xs:element ref="RemoveExistingProducts">
10423 <xs:annotation>
10424 <xs:documentation>Goes through the product codes listed in the ActionProperty column of the Upgrade table and removes the products in sequence.</xs:documentation>
10425 </xs:annotation>
10426 </xs:element>
10427 <xs:element ref="DisableRollback" minOccurs="0">
10428 <xs:annotation>
10429 <xs:documentation>Disables rollback for the remainder of the installation.</xs:documentation>
10430 </xs:annotation>
10431 </xs:element>
10432 <!-- InstallExecute and InstallExecuteAgain can optionally appear anywhere between InstallInitialize and InstallFinalize -->
10433 <xs:element ref="InstallExecute" minOccurs="0">
10434 <xs:annotation>
10435 <xs:documentation>Runs a script containing all operations spooled since either the start of the installation or the last InstallExecute action, or InstallExecuteAgain action.</xs:documentation>
10436 </xs:annotation>
10437 </xs:element>
10438 <xs:element ref="InstallExecuteAgain" minOccurs="0">
10439 <xs:annotation>
10440 <xs:documentation>Runs a script containing all operations spooled since either the start of the installation or the last InstallExecute action, or InstallExecuteAgain action.</xs:documentation>
10441 </xs:annotation>
10442 </xs:element>
10443 <!-- Windows Installer 1.5 actions -->
10444 <xs:element ref="MsiPublishAssemblies">
10445 <xs:annotation>
10446 <xs:documentation>Manages the advertisement of CLR and Win32 assemblies.</xs:documentation>
10447 </xs:annotation>
10448 </xs:element>
10449 <xs:element ref="MsiUnpublishAssemblies">
10450 <xs:annotation>
10451 <xs:documentation>Manages the unadvertisement of CLR and Win32 assemblies that are being removed.</xs:documentation>
10452 </xs:annotation>
10453 </xs:element>
10454 </xs:choice>
10455 </xs:complexType>
10456 </xs:element>
10457 <xs:element name="AdminUISequence">
10458 <xs:annotation>
10459 <xs:appinfo>
10460 <xse:msiRef table="AdminUISequence" href="http://msdn.microsoft.com/library/aa367544.aspx" />
10461 </xs:appinfo>
10462 </xs:annotation>
10463 <xs:complexType>
10464 <xs:choice minOccurs="0" maxOccurs="unbounded">
10465 <xs:element ref="Custom" minOccurs="0" maxOccurs="unbounded">
10466 <xs:annotation>
10467 <xs:documentation>Use to sequence a custom action.</xs:documentation>
10468 </xs:annotation>
10469 </xs:element>
10470 <xs:element ref="Show" minOccurs="0" maxOccurs="unbounded" />
10471 <xs:element ref="CostInitialize">
10472 <xs:annotation>
10473 <xs:documentation>Initiates the internal installation costing process.</xs:documentation>
10474 </xs:annotation>
10475 </xs:element>
10476 <xs:element ref="FileCost">
10477 <xs:annotation>
10478 <xs:documentation>Initiates dynamic costing of standard installation actions.</xs:documentation>
10479 </xs:annotation>
10480 </xs:element>
10481 <xs:element ref="CostFinalize">
10482 <xs:annotation>
10483 <xs:documentation>Ends the internal installation costing process begun by the CostInitialize action.</xs:documentation>
10484 </xs:annotation>
10485 </xs:element>
10486 <xs:element ref="ExecuteAction">
10487 <xs:annotation>
10488 <xs:documentation>Initiates the execution sequence.</xs:documentation>
10489 </xs:annotation>
10490 </xs:element>
10491 <xs:element ref="InstallValidate">
10492 <xs:annotation>
10493 <xs:documentation>Verifies that all costed volumes have enough space for the installation.</xs:documentation>
10494 </xs:annotation>
10495 </xs:element>
10496 <xs:element ref="InstallInitialize">
10497 <xs:annotation>
10498 <xs:documentation>Marks the beginning of a sequence of actions that change the system.</xs:documentation>
10499 </xs:annotation>
10500 </xs:element>
10501 <xs:element ref="InstallAdminPackage">
10502 <xs:annotation>
10503 <xs:documentation>Copies the product database to the administrative installation point.</xs:documentation>
10504 </xs:annotation>
10505 </xs:element>
10506 <xs:element ref="InstallFiles">
10507 <xs:annotation>
10508 <xs:documentation>Copies files specified in the File table from the source directory to the destination directory.</xs:documentation>
10509 </xs:annotation>
10510 </xs:element>
10511 <xs:element ref="InstallFinalize">
10512 <xs:annotation>
10513 <xs:documentation>Marks the end of a sequence of actions that change the system.</xs:documentation>
10514 </xs:annotation>
10515 </xs:element>
10516 <xs:element ref="LaunchConditions">
10517 <xs:annotation>
10518 <xs:documentation>Queries the LaunchCondition table and evaluates each conditional statement recorded there.</xs:documentation>
10519 </xs:annotation>
10520 </xs:element>
10521 </xs:choice>
10522 </xs:complexType>
10523 </xs:element>
10524 <xs:element name="AdminExecuteSequence">
10525 <xs:annotation>
10526 <xs:appinfo>
10527 <xse:msiRef table="AdminExecuteSequence" href="http://msdn.microsoft.com/library/aa367540.aspx" />
10528 </xs:appinfo>
10529 </xs:annotation>
10530 <xs:complexType>
10531 <xs:choice minOccurs="0" maxOccurs="unbounded">
10532 <xs:element ref="Custom" minOccurs="0" maxOccurs="unbounded">
10533 <xs:annotation>
10534 <xs:documentation>Use to sequence a custom action.</xs:documentation>
10535 </xs:annotation>
10536 </xs:element>
10537 <xs:element ref="CostInitialize">
10538 <xs:annotation>
10539 <xs:documentation>Initiates the internal installation costing process.</xs:documentation>
10540 </xs:annotation>
10541 </xs:element>
10542 <xs:element ref="FileCost">
10543 <xs:annotation>
10544 <xs:documentation>Initiates dynamic costing of standard installation actions.</xs:documentation>
10545 </xs:annotation>
10546 </xs:element>
10547 <xs:element ref="CostFinalize">
10548 <xs:annotation>
10549 <xs:documentation>Ends the internal installation costing process begun by the CostInitialize action.</xs:documentation>
10550 </xs:annotation>
10551 </xs:element>
10552 <xs:element ref="InstallValidate">
10553 <xs:annotation>
10554 <xs:documentation>Verifies that all costed volumes have enough space for the installation.</xs:documentation>
10555 </xs:annotation>
10556 </xs:element>
10557 <xs:element ref="InstallInitialize">
10558 <xs:annotation>
10559 <xs:documentation>Marks the beginning of a sequence of actions that change the system.</xs:documentation>
10560 </xs:annotation>
10561 </xs:element>
10562 <xs:element ref="InstallAdminPackage">
10563 <xs:annotation>
10564 <xs:documentation>Copies the product database to the administrative installation point.</xs:documentation>
10565 </xs:annotation>
10566 </xs:element>
10567 <xs:element ref="InstallFiles">
10568 <xs:annotation>
10569 <xs:documentation>Copies files specified in the File table from the source directory to the destination directory.</xs:documentation>
10570 </xs:annotation>
10571 </xs:element>
10572 <xs:element ref="PatchFiles">
10573 <xs:annotation>
10574 <xs:documentation>Queries the Patch table to determine which patches are to be applied.</xs:documentation>
10575 </xs:annotation>
10576 </xs:element>
10577 <xs:element ref="InstallFinalize">
10578 <xs:annotation>
10579 <xs:documentation>Marks the end of a sequence of actions that change the system.</xs:documentation>
10580 </xs:annotation>
10581 </xs:element>
10582 <xs:element ref="LaunchConditions">
10583 <xs:annotation>
10584 <xs:documentation>Queries the LaunchCondition table and evaluates each conditional statement recorded there.</xs:documentation>
10585 </xs:annotation>
10586 </xs:element>
10587 <xs:element ref="ResolveSource" minOccurs="0">
10588 <xs:annotation>
10589 <xs:documentation>Determines the location of the source and sets the SourceDir property if the source has not been resolved yet.</xs:documentation>
10590 </xs:annotation>
10591 </xs:element>
10592 </xs:choice>
10593 </xs:complexType>
10594 </xs:element>
10595 <xs:element name="AdvertiseExecuteSequence">
10596 <xs:annotation>
10597 <xs:appinfo>
10598 <xse:msiRef table="AdvtExecuteSequence" href="http://msdn.microsoft.com/library/aa367551.aspx" />
10599 </xs:appinfo>
10600 </xs:annotation>
10601 <xs:complexType>
10602 <xs:choice minOccurs="0" maxOccurs="unbounded">
10603 <xs:element ref="CostInitialize">
10604 <xs:annotation>
10605 <xs:documentation>Initiates the internal installation costing process.</xs:documentation>
10606 </xs:annotation>
10607 </xs:element>
10608 <xs:element ref="CostFinalize">
10609 <xs:annotation>
10610 <xs:documentation>Ends the internal installation costing process begun by the CostInitialize action.</xs:documentation>
10611 </xs:annotation>
10612 </xs:element>
10613 <xs:element ref="Custom" minOccurs="0" maxOccurs="unbounded">
10614 <xs:annotation>
10615 <xs:documentation>Use to sequence a custom action. The only custom actions that are allowed in the AdvtExecuteSequence are type 19 (0x013) type 35 (0x023) and type 51 (0x033).</xs:documentation>
10616 </xs:annotation>
10617 </xs:element>
10618 <xs:element ref="InstallValidate">
10619 <xs:annotation>
10620 <xs:documentation>Verifies that all costed volumes have enough space for the installation.</xs:documentation>
10621 </xs:annotation>
10622 </xs:element>
10623 <xs:element ref="InstallInitialize">
10624 <xs:annotation>
10625 <xs:documentation>Marks the beginning of a sequence of actions that change the system.</xs:documentation>
10626 </xs:annotation>
10627 </xs:element>
10628 <xs:element ref="CreateShortcuts">
10629 <xs:annotation>
10630 <xs:documentation>Manages the creation of shortcuts.</xs:documentation>
10631 </xs:annotation>
10632 </xs:element>
10633 <xs:element ref="RegisterClassInfo">
10634 <xs:annotation>
10635 <xs:documentation>Manages the registration of COM class information with the system.</xs:documentation>
10636 </xs:annotation>
10637 </xs:element>
10638 <xs:element ref="RegisterExtensionInfo">
10639 <xs:annotation>
10640 <xs:documentation>Manages the registration of extension related information with the system.</xs:documentation>
10641 </xs:annotation>
10642 </xs:element>
10643 <xs:element ref="RegisterMIMEInfo">
10644 <xs:annotation>
10645 <xs:documentation>Registers MIME-related registry information with the system.</xs:documentation>
10646 </xs:annotation>
10647 </xs:element>
10648 <xs:element ref="RegisterProgIdInfo">
10649 <xs:annotation>
10650 <xs:documentation>Manages the registration of OLE ProgId information with the system.</xs:documentation>
10651 </xs:annotation>
10652 </xs:element>
10653 <xs:element ref="PublishComponents">
10654 <xs:annotation>
10655 <xs:documentation>Manages the advertisement of the components from the PublishComponent table.</xs:documentation>
10656 </xs:annotation>
10657 </xs:element>
10658 <xs:element ref="PublishFeatures">
10659 <xs:annotation>
10660 <xs:documentation>Writes each feature's state into the system registry.</xs:documentation>
10661 </xs:annotation>
10662 </xs:element>
10663 <xs:element ref="PublishProduct">
10664 <xs:annotation>
10665 <xs:documentation>Manages the advertisement of the product information with the system.</xs:documentation>
10666 </xs:annotation>
10667 </xs:element>
10668 <xs:element ref="InstallFinalize">
10669 <xs:annotation>
10670 <xs:documentation>Marks the end of a sequence of actions that change the system.</xs:documentation>
10671 </xs:annotation>
10672 </xs:element>
10673 <!-- Windows Installer 1.5 actions -->
10674 <xs:element ref="MsiPublishAssemblies">
10675 <xs:annotation>
10676 <xs:documentation>Manages the advertisement of CLR and Win32 assemblies.</xs:documentation>
10677 </xs:annotation>
10678 </xs:element>
10679 </xs:choice>
10680 </xs:complexType>
10681 </xs:element>
10682 <!-- - - - - - - - - - - Binary tables - - - - - - - - - - - - - -->
10683 <xs:element name="Binary">
10684 <xs:annotation>
10685 <xs:documentation>
10686 Binary data used for CustomAction elements and UI controls.
10687 </xs:documentation>
10688 <xs:appinfo>
10689 <xse:msiRef table="Binary" href="http://msdn.microsoft.com/library/aa367825.aspx" />
10690 </xs:appinfo>
10691 </xs:annotation>
10692 <xs:complexType>
10693 <xs:choice minOccurs="0" maxOccurs="unbounded">
10694 <xs:any namespace="##other" processContents="lax">
10695 <xs:annotation>
10696 <xs:documentation>
10697 Extensibility point in the WiX XML Schema. Schema extensions can register additional
10698 elements at this point in the schema.
10699 </xs:documentation>
10700 </xs:annotation>
10701 </xs:any>
10702 </xs:choice>
10703 <xs:attribute name="Id" type="xs:string" use="required">
10704 <xs:annotation>
10705 <xs:documentation>The Id cannot be longer than 55 characters. In order to prevent errors in cases where the Id is modularized, it should not be longer than 18 characters.</xs:documentation>
10706 </xs:annotation>
10707 </xs:attribute>
10708 <xs:attribute name="SourceFile" type="xs:string">
10709 <xs:annotation>
10710 <xs:documentation>Path to the binary file.</xs:documentation>
10711 </xs:annotation>
10712 </xs:attribute>
10713 <xs:attribute name="src" type="xs:string">
10714 <xs:annotation>
10715 <xs:appinfo>
10716 <xse:deprecated ref="SourceFile" />
10717 </xs:appinfo>
10718 </xs:annotation>
10719 </xs:attribute>
10720 <xs:attribute name="SuppressModularization" type="YesNoTypeUnion">
10721 <xs:annotation>
10722 <xs:documentation>
10723 Use to suppress modularization of this Binary identifier in merge modules.
10724 </xs:documentation>
10725 </xs:annotation>
10726 </xs:attribute>
10727 <xs:anyAttribute namespace="##other" processContents="lax">
10728 <xs:annotation>
10729 <xs:documentation>
10730 Extensibility point in the WiX XML Schema. Schema extensions can register additional
10731 attributes at this point in the schema.
10732 </xs:documentation>
10733 </xs:annotation>
10734 </xs:anyAttribute>
10735 </xs:complexType>
10736 </xs:element>
10737 <xs:element name="Icon">
10738 <xs:annotation>
10739 <xs:documentation>
10740 Icon used for Shortcut, ProgId, or Class elements (but not UI controls)
10741 </xs:documentation>
10742 <xs:appinfo>
10743 <xse:msiRef table="Icon" href="http://msdn.microsoft.com/library/aa369210.aspx" />
10744 <xse:howtoRef href="ui_and_localization/configure_arp_appearance.html">How To: Set your installer's icon in Add/Remove Programs</xse:howtoRef>
10745 <xse:howtoRef href="files_and_registry/create_start_menu_shortcut.html">How To: Create a shortcut on the Start Menu</xse:howtoRef>
10746 </xs:appinfo>
10747 </xs:annotation>
10748 <xs:complexType>
10749 <xs:attribute name="Id" type="xs:string" use="required">
10750 <xs:annotation>
10751 <xs:documentation>The Id cannot be longer than 55 characters. In order to prevent errors in cases where the Id is modularized, it should not be longer than 18 characters.</xs:documentation>
10752 </xs:annotation>
10753 </xs:attribute>
10754 <xs:attribute name="SourceFile" type="xs:string">
10755 <xs:annotation>
10756 <xs:documentation>Path to the icon file.</xs:documentation>
10757 </xs:annotation>
10758 </xs:attribute>
10759 <xs:attribute name="src" type="xs:string">
10760 <xs:annotation>
10761 <xs:appinfo>
10762 <xse:deprecated ref="SourceFile" />
10763 </xs:appinfo>
10764 </xs:annotation>
10765 </xs:attribute>
10766 </xs:complexType>
10767 </xs:element>
10768 <xs:element name="EmbeddedChainer">
10769 <xs:annotation>
10770 <xs:appinfo>
10771 <xse:msiRef table="MsiEmbeddedChainer " href="http://msdn.microsoft.com/library/bb736316.aspx" />
10772 <xse:seeAlso ref="Binary" />
10773 <xse:seeAlso ref="File" />
10774 <xse:seeAlso ref="Property" />
10775 <xse:seeAlso ref="EmbeddedChainerRef" />
10776 </xs:appinfo>
10777 </xs:annotation>
10778 <xs:complexType>
10779 <xs:simpleContent>
10780 <xs:extension base="xs:string">
10781 <xs:annotation>
10782 <xs:documentation>
10783 Element value is the condition. CDATA may be used to when a condition contains many XML characters
10784 that must be escaped. It is important to note that each EmbeddedChainer element must have a mutually exclusive condition
10785 to ensure that only one embedded chainer will execute at a time. If the conditions are not mutually exclusive the chainer
10786 that executes is undeterministic.
10787 </xs:documentation>
10788 </xs:annotation>
10789 <xs:attribute name="Id" type="xs:string" use="required">
10790 <xs:annotation>
10791 <xs:documentation>Unique identifier for embedded chainer.</xs:documentation>
10792 </xs:annotation>
10793 </xs:attribute>
10794 <xs:attribute name="CommandLine" type="xs:string">
10795 <xs:annotation>
10796 <xs:documentation>Value to append to the transaction handle and passed to the chainer executable.</xs:documentation>
10797 </xs:annotation>
10798 </xs:attribute>
10799 <xs:attribute name="BinarySource" type="xs:string">
10800 <xs:annotation>
10801 <xs:documentation>
10802 Reference to the Binary element that contains the chainer executable. Mutually exclusive with
10803 the FileSource and PropertySource attributes.
10804 </xs:documentation>
10805 </xs:annotation>
10806 </xs:attribute>
10807 <xs:attribute name="FileSource" type="xs:string">
10808 <xs:annotation>
10809 <xs:documentation>
10810 Reference to the File element that is the chainer executable. Mutually exclusive with
10811 the BinarySource and PropertySource attributes.
10812 </xs:documentation>
10813 </xs:annotation>
10814 </xs:attribute>
10815 <xs:attribute name="PropertySource" type="xs:string">
10816 <xs:annotation>
10817 <xs:documentation>
10818 Reference to a Property that resolves to the full path to the chainer executable. Mutually exclusive with
10819 the BinarySource and FileSource attributes.
10820 </xs:documentation>
10821 </xs:annotation>
10822 </xs:attribute>
10823 </xs:extension>
10824 </xs:simpleContent>
10825 </xs:complexType>
10826 </xs:element>
10827 <xs:element name="EmbeddedChainerRef">
10828 <xs:annotation>
10829 <xs:documentation>
10830 Reference to an EmbeddedChainer element. This will force the entire referenced Fragment's contents
10831 to be included in the installer database.
10832 </xs:documentation>
10833 <xs:appinfo>
10834 <xse:seeAlso ref="EmbeddedChainer" />
10835 </xs:appinfo>
10836 </xs:annotation>
10837 <xs:complexType>
10838 <xs:attribute name="Id" type="xs:string" use="required" />
10839 <xs:anyAttribute namespace="##other" processContents="lax">
10840 <xs:annotation>
10841 <xs:documentation>
10842 Extensibility point in the WiX XML Schema. Schema extensions can register additional
10843 attributes at this point in the schema.
10844 </xs:documentation>
10845 </xs:annotation>
10846 </xs:anyAttribute>
10847 </xs:complexType>
10848 </xs:element>
10849 <!-- - - - - - - - - - - UI Definitions - - - - - - - - - - - - - -->
10850 <xs:element name="EmbeddedUI">
10851 <xs:annotation>
10852 <xs:appinfo>
10853 <xse:msiRef table="MsiEmbeddedUI" href="http://msdn.microsoft.com/library/bb736317.aspx" />
10854 </xs:appinfo>
10855 <xs:documentation>Element value is the condition. Use CDATA if message contains delimiter characters.</xs:documentation>
10856 </xs:annotation>
10857 <xs:complexType mixed="true">
10858 <xs:sequence>
10859 <xs:element ref="EmbeddedUIResource" minOccurs="0" maxOccurs="unbounded">
10860 <xs:annotation>
10861 <xs:documentation>Specifies extra files to be extracted for use by the embedded UI, such as language resources.</xs:documentation>
10862 </xs:annotation>
10863 </xs:element>
10864 </xs:sequence>
10865 <xs:attribute name="Id" type="xs:string">
10866 <xs:annotation>
10867 <xs:documentation>
10868 Unique identifier for embedded UI.If this attribute is not specified the Name attribute or the file name
10869 portion of the SourceFile attribute will be used.
10870 </xs:documentation>
10871 </xs:annotation>
10872 </xs:attribute>
10873 <xs:attribute name="IgnoreFatalExit" type="YesNoTypeUnion">
10874 <xs:annotation>
10875 <xs:documentation>Embedded UI will not recieve any INSTALLLOGMODE_FATALEXIT messages.</xs:documentation>
10876 </xs:annotation>
10877 </xs:attribute>
10878 <xs:attribute name="IgnoreError" type="YesNoTypeUnion">
10879 <xs:annotation>
10880 <xs:documentation>Embedded UI will not recieve any INSTALLLOGMODE_ERROR messages.</xs:documentation>
10881 </xs:annotation>
10882 </xs:attribute>
10883 <xs:attribute name="IgnoreWarning" type="YesNoTypeUnion">
10884 <xs:annotation>
10885 <xs:documentation>Embedded UI will not recieve any INSTALLLOGMODE_WARNING messages.</xs:documentation>
10886 </xs:annotation>
10887 </xs:attribute>
10888 <xs:attribute name="IgnoreUser" type="YesNoTypeUnion">
10889 <xs:annotation>
10890 <xs:documentation>Embedded UI will not recieve any INSTALLLOGMODE_USER messages.</xs:documentation>
10891 </xs:annotation>
10892 </xs:attribute>
10893 <xs:attribute name="IgnoreInfo" type="YesNoTypeUnion">
10894 <xs:annotation>
10895 <xs:documentation>Embedded UI will not recieve any INSTALLLOGMODE_INFO messages.</xs:documentation>
10896 </xs:annotation>
10897 </xs:attribute>
10898 <xs:attribute name="IgnoreFilesInUse" type="YesNoTypeUnion">
10899 <xs:annotation>
10900 <xs:documentation>Embedded UI will not recieve any INSTALLLOGMODE_FILESINUSE messages.</xs:documentation>
10901 </xs:annotation>
10902 </xs:attribute>
10903 <xs:attribute name="IgnoreResolveSource" type="YesNoTypeUnion">
10904 <xs:annotation>
10905 <xs:documentation>Embedded UI will not recieve any INSTALLLOGMODE_RESOLVESOURCE messages.</xs:documentation>
10906 </xs:annotation>
10907 </xs:attribute>
10908 <xs:attribute name="IgnoreOutOfDiskSpace" type="YesNoTypeUnion">
10909 <xs:annotation>
10910 <xs:documentation>Embedded UI will not recieve any INSTALLLOGMODE_OUTOFDISKSPACE messages.</xs:documentation>
10911 </xs:annotation>
10912 </xs:attribute>
10913 <xs:attribute name="IgnoreActionStart" type="YesNoTypeUnion">
10914 <xs:annotation>
10915 <xs:documentation>Embedded UI will not recieve any INSTALLLOGMODE_ACTIONSTART messages.</xs:documentation>
10916 </xs:annotation>
10917 </xs:attribute>
10918 <xs:attribute name="IgnoreActionData" type="YesNoTypeUnion">
10919 <xs:annotation>
10920 <xs:documentation>Embedded UI will not recieve any INSTALLLOGMODE_ACTIONDATA messages.</xs:documentation>
10921 </xs:annotation>
10922 </xs:attribute>
10923 <xs:attribute name="IgnoreProgress" type="YesNoTypeUnion">
10924 <xs:annotation>
10925 <xs:documentation>Embedded UI will not recieve any INSTALLLOGMODE_PROGRESS messages.</xs:documentation>
10926 </xs:annotation>
10927 </xs:attribute>
10928 <xs:attribute name="IgnoreCommonData" type="YesNoTypeUnion">
10929 <xs:annotation>
10930 <xs:documentation>Embedded UI will not recieve any INSTALLLOGMODE_COMMONDATA messages.</xs:documentation>
10931 </xs:annotation>
10932 </xs:attribute>
10933 <xs:attribute name="IgnoreInitialize" type="YesNoTypeUnion">
10934 <xs:annotation>
10935 <xs:documentation>Embedded UI will not recieve any INSTALLLOGMODE_INITIALIZE messages.</xs:documentation>
10936 </xs:annotation>
10937 </xs:attribute>
10938 <xs:attribute name="IgnoreTerminate" type="YesNoTypeUnion">
10939 <xs:annotation>
10940 <xs:documentation>Embedded UI will not recieve any INSTALLLOGMODE_TERMINATE messages.</xs:documentation>
10941 </xs:annotation>
10942 </xs:attribute>
10943 <xs:attribute name="IgnoreShowDialog" type="YesNoTypeUnion">
10944 <xs:annotation>
10945 <xs:documentation>Embedded UI will not recieve any INSTALLLOGMODE_SHOWDIALOG messages.</xs:documentation>
10946 </xs:annotation>
10947 </xs:attribute>
10948 <xs:attribute name="IgnoreRMFilesInUse" type="YesNoTypeUnion">
10949 <xs:annotation>
10950 <xs:documentation>Embedded UI will not recieve any INSTALLLOGMODE_RMFILESINUSE messages.</xs:documentation>
10951 </xs:annotation>
10952 </xs:attribute>
10953 <xs:attribute name="IgnoreInstallStart" type="YesNoTypeUnion">
10954 <xs:annotation>
10955 <xs:documentation>Embedded UI will not recieve any INSTALLLOGMODE_INSTALLSTART messages.</xs:documentation>
10956 </xs:annotation>
10957 </xs:attribute>
10958 <xs:attribute name="IgnoreInstallEnd" type="YesNoTypeUnion">
10959 <xs:annotation>
10960 <xs:documentation>Embedded UI will not recieve any INSTALLLOGMODE_INSTALLEND messages.</xs:documentation>
10961 </xs:annotation>
10962 </xs:attribute>
10963 <xs:attribute name="Name" type="LongFileNameType">
10964 <xs:annotation>
10965 <xs:documentation>
10966 The name for the embedded UI DLL when it is extracted from the Product and executed. (Windows Installer
10967 does not support the typical short filename and long filename combination for embedded UI files as it
10968 does for other kinds of files.) If this attribute is not specified the file name portion of the SourceFile
10969 attribute will be used.
10970 </xs:documentation>
10971 </xs:annotation>
10972 </xs:attribute>
10973 <xs:attribute name="SourceFile" type="xs:string" use="required">
10974 <xs:annotation>
10975 <xs:documentation>
10976 Path to the binary file that is the embedded UI. This must be a DLL that exports the following
10977 three entry points: InitializeEmbeddedUI, EmbeddedUIHandler and ShutdownEmbeddedUI.
10978 </xs:documentation>
10979 </xs:annotation>
10980 </xs:attribute>
10981 <xs:attribute name="SupportBasicUI" type="YesNoTypeUnion">
10982 <xs:annotation>
10983 <xs:documentation>Set yes to allow the Windows Installer to display the embedded UI during basic UI level installation.</xs:documentation>
10984 </xs:annotation>
10985 </xs:attribute>
10986 </xs:complexType>
10987 </xs:element>
10988 <xs:element name="EmbeddedUIResource">
10989 <xs:annotation>
10990 <xs:documentation>
10991 Defines a resource for use by the embedded UI.
10992 </xs:documentation>
10993 <xs:appinfo>
10994 <xse:seeAlso ref="EmbeddedUI" />
10995 <xse:msiRef table="MsiEmbeddedUI" href="http://msdn.microsoft.com/library/bb736317.aspx" />
10996 </xs:appinfo>
10997 </xs:annotation>
10998 <xs:complexType>
10999 <xs:attribute name="Id" type="xs:string" use="required">
11000 <xs:annotation>
11001 <xs:documentation>Identifier for the embedded UI resource.</xs:documentation>
11002 </xs:annotation>
11003 </xs:attribute>
11004 <xs:attribute name="Name" type="LongFileNameType" use="required">
11005 <xs:annotation>
11006 <xs:documentation>
11007 The name for the resource when it is extracted from the Product for use by the embedded UI DLL. (Windows
11008 Installer does not support the typical short filename and long filename combination for embedded UI files
11009 as it does for other kinds of files.) If this attribute is not specified the Id attribute will be used.
11010 </xs:documentation>
11011 </xs:annotation>
11012 </xs:attribute>
11013 <xs:attribute name="SourceFile" type="xs:string" use="required">
11014 <xs:annotation>
11015 <xs:documentation>Path to the binary file that is the embedded UI resource.</xs:documentation>
11016 </xs:annotation>
11017 </xs:attribute>
11018 </xs:complexType>
11019 </xs:element>
11020 <xs:element name="Error">
11021 <xs:annotation>
11022 <xs:appinfo>
11023 <xse:msiRef table="Error" href="http://msdn.microsoft.com/library/aa368554.aspx" />
11024 </xs:appinfo>
11025 </xs:annotation>
11026 <xs:complexType>
11027 <xs:simpleContent>
11028 <xs:extension base="xs:string">
11029 <xs:annotation>
11030 <xs:documentation>Element value is Message, use CDATA if message contains delimiter characters</xs:documentation>
11031 </xs:annotation>
11032 <xs:attribute name="Id" type="xs:integer">
11033 <xs:annotation>
11034 <xs:documentation>Number of the error for which a message is being provided. See MSI SDK for error definitions.</xs:documentation>
11035 </xs:annotation>
11036 </xs:attribute>
11037 </xs:extension>
11038 </xs:simpleContent>
11039 </xs:complexType>
11040 </xs:element>
11041 <xs:element name="Publish">
11042 <xs:annotation>
11043 <xs:appinfo>
11044 <xse:msiRef table="ControlEvent" href="http://msdn.microsoft.com/library/aa368037.aspx" />
11045 </xs:appinfo>
11046 </xs:annotation>
11047 <xs:complexType>
11048 <xs:simpleContent>
11049 <xs:extension base="xs:string">
11050 <xs:annotation>
11051 <xs:documentation>The element value is the optional Condition expression.</xs:documentation>
11052 </xs:annotation>
11053 <xs:attribute name="Control" type="xs:string">
11054 <xs:annotation>
11055 <xs:documentation>
11056 The parent Control for this Publish element, should only be specified when this element is a child of the UI element.
11057 </xs:documentation>
11058 </xs:annotation>
11059 </xs:attribute>
11060 <xs:attribute name="Dialog" type="xs:string">
11061 <xs:annotation>
11062 <xs:documentation>
11063 The parent Dialog for this Publish element, should only be specified when this element is a child of the UI element.
11064 This attribute will create a reference to the specified Dialog, so an additional DialogRef is not necessary.
11065 </xs:documentation>
11066 </xs:annotation>
11067 </xs:attribute>
11068 <xs:attribute name="Event" type="xs:string">
11069 <xs:annotation>
11070 <xs:documentation>
11071 Set this attribute's value to one of the standard control events to trigger that event.
11072 Either this attribute or the Property attribute must be set, but not both at the same time.
11073 </xs:documentation>
11074 </xs:annotation>
11075 </xs:attribute>
11076 <xs:attribute name="Order" type="xs:string">
11077 <xs:annotation>
11078 <xs:documentation>
11079 This attribute should only need to be set if this element is nested under a UI element in order to
11080 control the order in which this publish event will be started.
11081 If this element is nested under a Control element, the default value will be one greater than any
11082 previous Publish element's order (the first element's default value is 1).
11083 If this element is nested under a UI element, the default value is always 1 (it does not get a
11084 default value based on any previous Publish elements).
11085 </xs:documentation>
11086 </xs:annotation>
11087 </xs:attribute>
11088 <xs:attribute name="Property" type="xs:string">
11089 <xs:annotation>
11090 <xs:documentation>
11091 Set this attribute's value to a property name to set that property.
11092 Either this attribute or the Event attribute must be set, but not both at the same time.
11093 </xs:documentation>
11094 </xs:annotation>
11095 </xs:attribute>
11096 <xs:attribute name="Value" type="xs:string">
11097 <xs:annotation>
11098 <xs:documentation>
11099 If the Property attribute is specified, set the value of this attribute to the new value for the property.
11100 To set a property to null, do not set this attribute (the ControlEvent Argument column will be set to '{}').
11101 Otherwise, this attribute's value should be the argument for the event specified in the Event attribute.
11102 If the event doesn't take an attribute, a common value to use is "0".
11103 </xs:documentation>
11104 </xs:annotation>
11105 </xs:attribute>
11106 </xs:extension>
11107 </xs:simpleContent>
11108 </xs:complexType>
11109 </xs:element>
11110 <xs:element name="Subscribe">
11111 <xs:annotation>
11112 <xs:documentation>
11113 Sets attributes for events in the EventMapping table
11114 </xs:documentation>
11115 <xs:appinfo>
11116 <xse:msiRef table="EventMapping" href="http://msdn.microsoft.com/library/aa368559.aspx" />
11117 </xs:appinfo>
11118 </xs:annotation>
11119 <xs:complexType>
11120 <xs:attribute name="Event" type="xs:string">
11121 <xs:annotation>
11122 <xs:documentation>must be one of the standard control events'</xs:documentation>
11123 </xs:annotation>
11124 </xs:attribute>
11125 <xs:attribute name="Attribute" type="xs:string">
11126 <xs:annotation>
11127 <xs:documentation>if not present can only handle enable, disable, hide, unhide events</xs:documentation>
11128 </xs:annotation>
11129 </xs:attribute>
11130 </xs:complexType>
11131 </xs:element>
11132 <xs:element name="Text">
11133 <xs:annotation>
11134 <xs:documentation>
11135 An alternative to using the Text attribute when the value contains special XML characters like &lt;, &gt;, or &amp;.
11136 </xs:documentation>
11137 </xs:annotation>
11138 <xs:complexType>
11139 <xs:simpleContent>
11140 <xs:extension base="xs:string">
11141 <xs:attribute name="SourceFile" type="xs:string">
11142 <xs:annotation>
11143 <xs:documentation>Instructs the text to be imported from a file instead of the element value during the binding process.</xs:documentation>
11144 </xs:annotation>
11145 </xs:attribute>
11146 <xs:attribute name="src" type="xs:string">
11147 <xs:annotation>
11148 <xs:appinfo>
11149 <xse:deprecated ref="SourceFile" />
11150 </xs:appinfo>
11151 </xs:annotation>
11152 </xs:attribute>
11153 </xs:extension>
11154 </xs:simpleContent>
11155 </xs:complexType>
11156 </xs:element>
11157 <xs:element name="Control">
11158 <xs:annotation>
11159 <xs:appinfo>
11160 <xse:msiRef table="Control" href="http://msdn.microsoft.com/library/aa368044.aspx" />
11161 <xse:msiRef table="ComboBox" href="http://msdn.microsoft.com/library/aa367872.aspx" />
11162 <xse:msiRef table="Dialog" href="http://msdn.microsoft.com/library/aa368286.aspx" />
11163 <xse:msiRef table="ListBox" href="http://msdn.microsoft.com/library/aa369762.aspx" />
11164 <xse:msiRef table="ListView" href="http://msdn.microsoft.com/library/aa369764.aspx" />
11165 <xse:msiRef table="RadioButton" href="http://msdn.microsoft.com/library/aa370962.aspx" />
11166 </xs:appinfo>
11167 <xs:documentation>Contains the controls that appear on each dialog.</xs:documentation>
11168 </xs:annotation>
11169 <xs:complexType>
11170 <xs:sequence>
11171 <xs:element ref="Text" minOccurs="0">
11172 <xs:annotation>
11173 <xs:documentation>alternative to Text attribute when CDATA is needed to escape XML delimiters</xs:documentation>
11174 </xs:annotation>
11175 </xs:element>
11176 <xs:element ref="ComboBox" minOccurs="0">
11177 <xs:annotation>
11178 <xs:documentation>ComboBox table with ListItem children</xs:documentation>
11179 </xs:annotation>
11180 </xs:element>
11181 <xs:element ref="ListBox" minOccurs="0">
11182 <xs:annotation>
11183 <xs:documentation>ListBox table with ListItem children</xs:documentation>
11184 </xs:annotation>
11185 </xs:element>
11186 <xs:element ref="ListView" minOccurs="0">
11187 <xs:annotation>
11188 <xs:documentation>ListView table with ListItem children</xs:documentation>
11189 </xs:annotation>
11190 </xs:element>
11191 <xs:element ref="RadioButtonGroup" minOccurs="0">
11192 <xs:annotation>
11193 <xs:documentation>RadioButton table with RadioButton children</xs:documentation>
11194 </xs:annotation>
11195 </xs:element>
11196 <xs:element ref="Property" minOccurs="0">
11197 <xs:annotation>
11198 <xs:documentation>Property table entry for the Property table column associated with this control</xs:documentation>
11199 </xs:annotation>
11200 </xs:element>
11201 <xs:element ref="Binary" minOccurs="0">
11202 <xs:annotation>
11203 <xs:documentation>Icon referenced in icon column of row</xs:documentation>
11204 </xs:annotation>
11205 </xs:element>
11206 <xs:choice minOccurs="0" maxOccurs="unbounded">
11207 <xs:annotation>
11208 <xs:documentation>child elements affecting operation of this control</xs:documentation>
11209 </xs:annotation>
11210 <xs:element ref="Condition">
11211 <xs:annotation>
11212 <xs:documentation>Condition to specify actions for this control based on the outcome of the condition.</xs:documentation>
11213 </xs:annotation>
11214 </xs:element>
11215 <xs:element ref="Publish" />
11216 <xs:element ref="Subscribe" />
11217 </xs:choice>
11218 </xs:sequence>
11219 <xs:attribute name="Id" use="required" type="xs:string">
11220 <xs:annotation>
11221 <xs:documentation>Combined with the Dialog Id to make up the primary key of the Control table.</xs:documentation>
11222 </xs:annotation>
11223 </xs:attribute>
11224 <xs:attribute name="Type" use="required" type="xs:string">
11225 <xs:annotation>
11226 <xs:documentation>The type of the control. Could be one of the following: Billboard, Bitmap, CheckBox, ComboBox, DirectoryCombo, DirectoryList, Edit, GroupBox, Hyperlink, Icon, Line, ListBox, ListView, MaskedEdit, PathEdit, ProgressBar, PushButton, RadioButtonGroup, ScrollableText, SelectionTree, Text, VolumeCostList, VolumeSelectCombo</xs:documentation>
11227 </xs:annotation>
11228 </xs:attribute>
11229 <xs:attribute name="X" use="required" type="LocalizableInteger">
11230 <xs:annotation>
11231 <xs:documentation>Horizontal coordinate of the upper-left corner of the rectangular boundary of the control. This must be a non-negative number.</xs:documentation>
11232 </xs:annotation>
11233 </xs:attribute>
11234 <xs:attribute name="Y" use="required" type="LocalizableInteger">
11235 <xs:annotation>
11236 <xs:documentation>Vertical coordinate of the upper-left corner of the rectangular boundary of the control. This must be a non-negative number.</xs:documentation>
11237 </xs:annotation>
11238 </xs:attribute>
11239 <xs:attribute name="Width" use="required" type="LocalizableInteger">
11240 <xs:annotation>
11241 <xs:documentation>Width of the rectangular boundary of the control. This must be a non-negative number.</xs:documentation>
11242 </xs:annotation>
11243 </xs:attribute>
11244 <xs:attribute name="Height" use="required" type="LocalizableInteger">
11245 <xs:annotation>
11246 <xs:documentation>Height of the rectangular boundary of the control. This must be a non-negative number.</xs:documentation>
11247 </xs:annotation>
11248 </xs:attribute>
11249 <xs:attribute name="Property" type="xs:string">
11250 <xs:annotation>
11251 <xs:documentation>The name of a defined property to be linked to this control. This column is required for active controls.</xs:documentation>
11252 </xs:annotation>
11253 </xs:attribute>
11254 <xs:attribute name="Text" type="xs:string">
11255 <xs:annotation>
11256 <xs:documentation>A localizable string used to set the initial text contained in a control. This attribute can contain a formatted string that is processed at install time to insert the values of properties using [PropertyName] syntax. Also supported are environment variables, file installation paths, and component installation directories; see <html:a href="http://msdn.microsoft.com/library/aa368609.aspx" target="_blank">Formatted</html:a> for details.</xs:documentation>
11257 </xs:annotation>
11258 </xs:attribute>
11259 <xs:attribute name="Help" type="xs:string">
11260 <xs:annotation>
11261 <xs:documentation>This attribute is reserved for future use. There is no need to use this until Windows Installer uses it for something.</xs:documentation>
11262 </xs:annotation>
11263 </xs:attribute>
11264 <xs:attribute name="ToolTip" type="xs:string">
11265 <xs:annotation>
11266 <xs:documentation>The string used for the Tooltip.</xs:documentation>
11267 </xs:annotation>
11268 </xs:attribute>
11269 <xs:attribute name="CheckBoxValue" type="xs:string">
11270 <xs:annotation>
11271 <xs:documentation>This attribute is only valid for CheckBox Controls. When set, the linked Property will be set to this value when the check box is checked.</xs:documentation>
11272 </xs:annotation>
11273 </xs:attribute>
11274 <xs:attribute name="CheckBoxPropertyRef" type="xs:string">
11275 <xs:annotation>
11276 <xs:documentation>This attribute is only valid for CheckBox controls. The value is the name of a Property that was already used as the Property for another CheckBox control. The Property attribute cannot be specified. The attribute exists to support multiple checkboxes on different dialogs being tied to the same property.</xs:documentation>
11277 </xs:annotation>
11278 </xs:attribute>
11279 <!-- Control ordering - order of declaration in Dialog determines tab ordering -->
11280 <xs:attribute name="TabSkip" type="YesNoTypeUnion">
11281 <xs:annotation>
11282 <xs:documentation>Set this attribute to "yes" to cause this Control to be skipped in the tab sequence.</xs:documentation>
11283 </xs:annotation>
11284 </xs:attribute>
11285 <xs:attribute name="Default" type="YesNoTypeUnion">
11286 <xs:annotation>
11287 <xs:documentation>Set this attribute to "yes" to cause this Control to be invoked by the return key.</xs:documentation>
11288 </xs:annotation>
11289 </xs:attribute>
11290 <xs:attribute name="Cancel" type="YesNoTypeUnion">
11291 <xs:annotation>
11292 <xs:documentation>Set this attribute to "yes" to cause this Control to be invoked by the escape key.</xs:documentation>
11293 </xs:annotation>
11294 </xs:attribute>
11295 <!-- common Control attributes -->
11296 <xs:attribute name="Hidden" type="YesNoTypeUnion">
11297 <xs:annotation>
11298 <xs:documentation>Set this attribute to "yes" to cause the Control to be hidden.</xs:documentation>
11299 </xs:annotation>
11300 </xs:attribute>
11301 <xs:attribute name="Disabled" type="YesNoTypeUnion">
11302 <xs:annotation>
11303 <xs:documentation>Set this attribute to "yes" to cause the Control to be disabled.</xs:documentation>
11304 </xs:annotation>
11305 </xs:attribute>
11306 <xs:attribute name="Sunken" type="YesNoTypeUnion">
11307 <xs:annotation>
11308 <xs:documentation>Set this attribute to "yes" to cause the Control to be sunken.</xs:documentation>
11309 </xs:annotation>
11310 </xs:attribute>
11311 <xs:attribute name="Indirect" type="YesNoTypeUnion">
11312 <xs:annotation>
11313 <xs:documentation>Specifies whether the value displayed or changed by this control is referenced indirectly. If this bit is set, the control displays or changes the value of the property that has the identifier listed in the Property column of the Control table.</xs:documentation>
11314 </xs:annotation>
11315 </xs:attribute>
11316 <xs:attribute name="Integer" type="YesNoTypeUnion">
11317 <xs:annotation>
11318 <xs:documentation>Set this attribute to "yes" to cause the linked Property value for the Control to be treated as an integer. Otherwise, the Property will be treated as a string.</xs:documentation>
11319 </xs:annotation>
11320 </xs:attribute>
11321 <xs:attribute name="RightToLeft" type="YesNoTypeUnion">
11322 <xs:annotation>
11323 <xs:documentation>Set this attribute to "yes" to cause the Control to display from right to left.</xs:documentation>
11324 </xs:annotation>
11325 </xs:attribute>
11326 <xs:attribute name="RightAligned" type="YesNoTypeUnion">
11327 <xs:annotation>
11328 <xs:documentation>Set this attribute to "yes" to cause the Control to be right aligned.</xs:documentation>
11329 </xs:annotation>
11330 </xs:attribute>
11331 <xs:attribute name="LeftScroll" type="YesNoTypeUnion">
11332 <xs:annotation>
11333 <xs:documentation>Set this attribute to "yes" to cause the scroll bar to display on the left side of the Control.</xs:documentation>
11334 </xs:annotation>
11335 </xs:attribute>
11336 <!-- attributes applied to specific Controls -->
11337 <xs:attribute name="Transparent" type="YesNoTypeUnion">
11338 <xs:annotation>
11339 <xs:documentation>This attribute is only valid for Text Controls.</xs:documentation>
11340 </xs:annotation>
11341 </xs:attribute>
11342 <xs:attribute name="NoPrefix" type="YesNoTypeUnion">
11343 <xs:annotation>
11344 <xs:documentation>This attribute is only valid for Text Controls.</xs:documentation>
11345 </xs:annotation>
11346 </xs:attribute>
11347 <xs:attribute name="NoWrap" type="YesNoTypeUnion">
11348 <xs:annotation>
11349 <xs:documentation>This attribute is only valid for Text Controls.</xs:documentation>
11350 </xs:annotation>
11351 </xs:attribute>
11352 <xs:attribute name="FormatSize" type="YesNoTypeUnion">
11353 <xs:annotation>
11354 <xs:documentation>This attribute is only valid for Text Controls.</xs:documentation>
11355 </xs:annotation>
11356 </xs:attribute>
11357 <xs:attribute name="UserLanguage" type="YesNoTypeUnion">
11358 <xs:annotation>
11359 <xs:documentation>This attribute is only valid for Text Controls.</xs:documentation>
11360 </xs:annotation>
11361 </xs:attribute>
11362 <xs:attribute name="Multiline" type="YesNoTypeUnion">
11363 <xs:annotation>
11364 <xs:documentation>This attribute is only valid for Edit Controls.</xs:documentation>
11365 </xs:annotation>
11366 </xs:attribute>
11367 <xs:attribute name="Password" type="YesNoTypeUnion">
11368 <xs:annotation>
11369 <xs:documentation>This attribute is only valid for Edit Controls.</xs:documentation>
11370 </xs:annotation>
11371 </xs:attribute>
11372 <xs:attribute name="ProgressBlocks" type="YesNoTypeUnion">
11373 <xs:annotation>
11374 <xs:documentation>This attribute is only valid for ProgressBar Controls.</xs:documentation>
11375 </xs:annotation>
11376 </xs:attribute>
11377 <xs:attribute name="Removable" type="YesNoTypeUnion">
11378 <xs:annotation>
11379 <xs:documentation>This attribute is only valid for Volume and Directory Controls.</xs:documentation>
11380 </xs:annotation>
11381 </xs:attribute>
11382 <xs:attribute name="Fixed" type="YesNoTypeUnion">
11383 <xs:annotation>
11384 <xs:documentation>This attribute is only valid for Volume and Directory Controls.</xs:documentation>
11385 </xs:annotation>
11386 </xs:attribute>
11387 <xs:attribute name="Remote" type="YesNoTypeUnion">
11388 <xs:annotation>
11389 <xs:documentation>This attribute is only valid for Volume and Directory Controls.</xs:documentation>
11390 </xs:annotation>
11391 </xs:attribute>
11392 <xs:attribute name="CDROM" type="YesNoTypeUnion">
11393 <xs:annotation>
11394 <xs:documentation>This attribute is only valid for Volume and Directory Controls.</xs:documentation>
11395 </xs:annotation>
11396 </xs:attribute>
11397 <xs:attribute name="RAMDisk" type="YesNoTypeUnion">
11398 <xs:annotation>
11399 <xs:documentation>This attribute is only valid for Volume and Directory Controls.</xs:documentation>
11400 </xs:annotation>
11401 </xs:attribute>
11402 <xs:attribute name="Floppy" type="YesNoTypeUnion">
11403 <xs:annotation>
11404 <xs:documentation>This attribute is only valid for Volume and Directory Controls.</xs:documentation>
11405 </xs:annotation>
11406 </xs:attribute>
11407 <xs:attribute name="ShowRollbackCost" type="YesNoTypeUnion">
11408 <xs:annotation>
11409 <xs:documentation>This attribute is only valid for VolumeCostList Controls.</xs:documentation>
11410 </xs:annotation>
11411 </xs:attribute>
11412 <xs:attribute name="Sorted" type="YesNoTypeUnion">
11413 <xs:annotation>
11414 <xs:documentation>This attribute is only valid for ListBox, ListView, and ComboBox Controls. Set
11415 the value of this attribute to "yes" to have entries appear in the order specified under the Control.
11416 If the attribute value is "no" or absent the entries in the control will appear in alphabetical order.
11417 </xs:documentation>
11418 </xs:annotation>
11419 </xs:attribute>
11420 <xs:attribute name="ComboList" type="YesNoTypeUnion">
11421 <xs:annotation>
11422 <xs:documentation>This attribute is only valid for ComboBox Controls.</xs:documentation>
11423 </xs:annotation>
11424 </xs:attribute>
11425 <xs:attribute name="Image" type="YesNoTypeUnion">
11426 <xs:annotation>
11427 <xs:documentation>This attribute is only valid for RadioButton, PushButton, and Icon Controls.</xs:documentation>
11428 </xs:annotation>
11429 </xs:attribute>
11430 <xs:attribute name="IconSize">
11431 <xs:annotation>
11432 <xs:documentation>This attribute is only valid for RadioButton, PushButton, and Icon Controls.</xs:documentation>
11433 </xs:annotation>
11434 <xs:simpleType>
11435 <xs:restriction base="xs:NMTOKEN">
11436 <xs:enumeration value="16" />
11437 <xs:enumeration value="32" />
11438 <xs:enumeration value="48" />
11439 </xs:restriction>
11440 </xs:simpleType>
11441 </xs:attribute>
11442 <xs:attribute name="FixedSize" type="YesNoTypeUnion">
11443 <xs:annotation>
11444 <xs:documentation>This attribute is only valid for RadioButton, PushButton, and Icon Controls.</xs:documentation>
11445 </xs:annotation>
11446 </xs:attribute>
11447 <xs:attribute name="Icon" type="YesNoTypeUnion">
11448 <xs:annotation>
11449 <xs:documentation>This attribute is only valid for RadioButton and PushButton Controls.</xs:documentation>
11450 </xs:annotation>
11451 </xs:attribute>
11452 <xs:attribute name="Bitmap" type="YesNoTypeUnion">
11453 <xs:annotation>
11454 <xs:documentation>This attribute is only valid for RadioButton and PushButton Controls.</xs:documentation>
11455 </xs:annotation>
11456 </xs:attribute>
11457 <xs:attribute name="PushLike" type="YesNoTypeUnion">
11458 <xs:annotation>
11459 <xs:documentation>This attribute is only valid for RadioButton and Checkbox Controls.</xs:documentation>
11460 </xs:annotation>
11461 </xs:attribute>
11462 <xs:attribute name="HasBorder" type="YesNoTypeUnion">
11463 <xs:annotation>
11464 <xs:documentation>This attribute is only valid for RadioButton Controls.</xs:documentation>
11465 </xs:annotation>
11466 </xs:attribute>
11467 <xs:attribute name="ElevationShield" type="YesNoTypeUnion">
11468 <xs:annotation>
11469 <xs:documentation>
11470 This attribute is only valid for PushButton controls.
11471 Set this attribute to "yes" to add the User Account Control (UAC) elevation icon (shield icon) to the PushButton control.
11472 If this attribute's value is "yes" and the installation is not yet running with elevated privileges,
11473 the pushbutton control is created using the User Account Control (UAC) elevation icon (shield icon).
11474 If this attribute's value is "yes" and the installation is already running with elevated privileges,
11475 the pushbutton control is created using the other icon attributes.
11476 Otherwise, the pushbutton control is created using the other icon attributes.
11477 </xs:documentation>
11478 </xs:annotation>
11479 </xs:attribute>
11480 </xs:complexType>
11481 </xs:element>
11482 <xs:element name="Billboard">
11483 <xs:annotation>
11484 <xs:documentation>
11485 Billboard to display during install of a Feature
11486 </xs:documentation>
11487 <xs:appinfo>
11488 <xse:msiRef table="Billboard" href="http://msdn.microsoft.com/library/aa367823.aspx" />
11489 <xse:msiRef table="BBControl" href="http://msdn.microsoft.com/library/aa367818.aspx" />
11490 </xs:appinfo>
11491 </xs:annotation>
11492 <xs:complexType>
11493 <xs:sequence>
11494 <xs:element ref="Control" minOccurs="0" maxOccurs="unbounded">
11495 <xs:annotation>
11496 <xs:documentation>Only controls of static type such as: Text, Bitmap, Icon, or custom control can be placed on a billboard.</xs:documentation>
11497 </xs:annotation>
11498 </xs:element>
11499 </xs:sequence>
11500 <xs:attribute name="Id" type="xs:string" use="required">
11501 <xs:annotation>
11502 <xs:documentation>Unique identifier for the Billboard.</xs:documentation>
11503 </xs:annotation>
11504 </xs:attribute>
11505 <xs:attribute name="Feature" type="xs:string">
11506 <xs:annotation>
11507 <xs:documentation>Feature whose state determines if the Billboard is shown.</xs:documentation>
11508 </xs:annotation>
11509 </xs:attribute>
11510 </xs:complexType>
11511 </xs:element>
11512 <xs:element name="BillboardAction">
11513 <xs:annotation>
11514 <xs:documentation>
11515 Billboard action during which child Billboards are displayed
11516 </xs:documentation>
11517 <xs:appinfo>
11518 <xse:msiRef table="Billboard" href="http://msdn.microsoft.com/library/aa367823.aspx" />
11519 <xse:msiRef table="BBControl" href="http://msdn.microsoft.com/library/aa367818.aspx" />
11520 </xs:appinfo>
11521 </xs:annotation>
11522 <xs:complexType>
11523 <xs:sequence>
11524 <xs:element ref="Billboard" maxOccurs="unbounded">
11525 <xs:annotation>
11526 <xs:documentation>Order of Billboard elements determines order of display</xs:documentation>
11527 </xs:annotation>
11528 </xs:element>
11529 </xs:sequence>
11530 <xs:attribute name="Id" type="xs:string" use="required">
11531 <xs:annotation>
11532 <xs:documentation>Action name that determines when the Billboard should be shown.</xs:documentation>
11533 </xs:annotation>
11534 </xs:attribute>
11535 </xs:complexType>
11536 </xs:element>
11537 <xs:element name="Dialog">
11538 <xs:annotation>
11539 <xs:appinfo>
11540 <xse:msiRef table="Control" href="http://msdn.microsoft.com/library/aa368044.aspx" />
11541 <xse:msiRef table="ComboBox" href="http://msdn.microsoft.com/library/aa367872.aspx" />
11542 <xse:msiRef table="Dialog" href="http://msdn.microsoft.com/library/aa368286.aspx" />
11543 <xse:msiRef table="ListBox" href="http://msdn.microsoft.com/library/aa369762.aspx" />
11544 <xse:msiRef table="ListView" href="http://msdn.microsoft.com/library/aa369764.aspx" />
11545 <xse:msiRef table="RadioButton" href="http://msdn.microsoft.com/library/aa370962.aspx" />
11546 </xs:appinfo>
11547 <xs:documentation>
11548 Defines a dialog box in the Dialog Table.
11549 </xs:documentation>
11550 </xs:annotation>
11551 <xs:complexType>
11552 <xs:sequence>
11553 <xs:element ref="Control" minOccurs="0" maxOccurs="unbounded">
11554 <xs:annotation>
11555 <xs:documentation>Control elements belonging to this dialog.</xs:documentation>
11556 </xs:annotation>
11557 </xs:element>
11558 </xs:sequence>
11559 <xs:attribute name="Id" type="xs:string" use="required">
11560 <xs:annotation>
11561 <xs:documentation>Unique identifier for the dialog.</xs:documentation>
11562 </xs:annotation>
11563 </xs:attribute>
11564 <xs:attribute name="X" type="xs:integer">
11565 <xs:annotation>
11566 <xs:documentation>Horizontal placement of the dialog box as a percentage of screen width. The default value is 50.</xs:documentation>
11567 </xs:annotation>
11568 </xs:attribute>
11569 <xs:attribute name="Y" type="xs:integer">
11570 <xs:annotation>
11571 <xs:documentation>Vertical placement of the dialog box as a percentage of screen height. The default value is 50.</xs:documentation>
11572 </xs:annotation>
11573 </xs:attribute>
11574 <xs:attribute name="Width" use="required" type="xs:integer">
11575 <xs:annotation>
11576 <xs:documentation>The width of the dialog box in dialog units.</xs:documentation>
11577 </xs:annotation>
11578 </xs:attribute>
11579 <xs:attribute name="Height" use="required" type="xs:integer">
11580 <xs:annotation>
11581 <xs:documentation>The height of the dialog box in dialog units.</xs:documentation>
11582 </xs:annotation>
11583 </xs:attribute>
11584 <xs:attribute name="Title" type="xs:string">
11585 <xs:annotation>
11586 <xs:documentation>The title of the dialog box.</xs:documentation>
11587 </xs:annotation>
11588 </xs:attribute>
11589 <!-- 'Attributes' column integer value generated from XML attributes below -->
11590 <xs:attribute name="Hidden" type="YesNoTypeUnion">
11591 <xs:annotation>
11592 <xs:documentation>Used to hide the dialog.</xs:documentation>
11593 </xs:annotation>
11594 </xs:attribute>
11595 <xs:attribute name="Modeless" type="YesNoTypeUnion">
11596 <xs:annotation>
11597 <xs:documentation>Used to set the dialog as modeless.</xs:documentation>
11598 </xs:annotation>
11599 </xs:attribute>
11600 <xs:attribute name="NoMinimize" type="YesNoTypeUnion">
11601 <xs:annotation>
11602 <xs:documentation>Used to specify if the dialog can be minimized.</xs:documentation>
11603 </xs:annotation>
11604 </xs:attribute>
11605 <xs:attribute name="SystemModal" type="YesNoTypeUnion">
11606 <xs:annotation>
11607 <xs:documentation>Used to set the dialog as system modal.</xs:documentation>
11608 </xs:annotation>
11609 </xs:attribute>
11610 <xs:attribute name="KeepModeless" type="YesNoTypeUnion">
11611 <xs:annotation>
11612 <xs:documentation>Keep modeless dialogs alive when this dialog is created through DoAction.</xs:documentation>
11613 </xs:annotation>
11614 </xs:attribute>
11615 <xs:attribute name="TrackDiskSpace" type="YesNoTypeUnion">
11616 <xs:annotation>
11617 <xs:documentation>Have the dialog periodically call the installer to check if available disk space has changed.</xs:documentation>
11618 </xs:annotation>
11619 </xs:attribute>
11620 <xs:attribute name="CustomPalette" type="YesNoTypeUnion">
11621 <xs:annotation>
11622 <xs:documentation>Used to specify if pictures in the dialog box are rendered with a custom palette.</xs:documentation>
11623 </xs:annotation>
11624 </xs:attribute>
11625 <xs:attribute name="RightToLeft" type="YesNoTypeUnion">
11626 <xs:annotation>
11627 <xs:documentation>Used to specify if the text in the dialog should be displayed in right to left reading order.</xs:documentation>
11628 </xs:annotation>
11629 </xs:attribute>
11630 <xs:attribute name="RightAligned" type="YesNoTypeUnion">
11631 <xs:annotation>
11632 <xs:documentation>Align text on the right.</xs:documentation>
11633 </xs:annotation>
11634 </xs:attribute>
11635 <xs:attribute name="LeftScroll" type="YesNoTypeUnion">
11636 <xs:annotation>
11637 <xs:documentation>Used to align the scroll bar on the left.</xs:documentation>
11638 </xs:annotation>
11639 </xs:attribute>
11640 <xs:attribute name="ErrorDialog" type="YesNoTypeUnion">
11641 <xs:annotation>
11642 <xs:documentation>Specifies this dialog as an error dialog.</xs:documentation>
11643 </xs:annotation>
11644 </xs:attribute>
11645 </xs:complexType>
11646 </xs:element>
11647 <xs:element name="DialogRef">
11648 <xs:annotation>
11649 <xs:appinfo>
11650 <xse:seeAlso ref="Dialog" />
11651 </xs:appinfo>
11652 <xs:documentation>
11653 Reference to a Dialog. This will cause the entire referenced section's contents
11654 to be included in the installer database.
11655 </xs:documentation>
11656 </xs:annotation>
11657 <xs:complexType>
11658 <xs:attribute name="Id" type="xs:string" use="required">
11659 <xs:annotation>
11660 <xs:documentation>The identifier of the Dialog to reference.</xs:documentation>
11661 </xs:annotation>
11662 </xs:attribute>
11663 </xs:complexType>
11664 </xs:element>
11665 <xs:element name="ProgressText">
11666 <xs:annotation>
11667 <xs:appinfo>
11668 <xse:msiRef table="ActionText" href="http://msdn.microsoft.com/library/aa367516.aspx" />
11669 </xs:appinfo>
11670 </xs:annotation>
11671 <xs:complexType>
11672 <xs:simpleContent>
11673 <xs:extension base="xs:string">
11674 <xs:annotation>
11675 <xs:documentation>Element value is progress message text for action</xs:documentation>
11676 </xs:annotation>
11677 <xs:attribute name="Action" type="xs:string" use="required" />
11678 <xs:attribute name="Template" type="xs:string">
11679 <xs:annotation>
11680 <xs:documentation>used to format ActionData messages from action processing</xs:documentation>
11681 </xs:annotation>
11682 </xs:attribute>
11683 </xs:extension>
11684 </xs:simpleContent>
11685 </xs:complexType>
11686 </xs:element>
11687 <xs:element name="TextStyle">
11688 <xs:annotation>
11689 <xs:appinfo>
11690 <xse:msiRef table="TextStyle" href="http://msdn.microsoft.com/library/aa372074.aspx" />
11691 </xs:appinfo>
11692 </xs:annotation>
11693 <xs:complexType>
11694 <xs:attribute name="Id" type="xs:string" use="required" />
11695 <xs:attribute name="FaceName" use="required" type="xs:string" />
11696 <xs:attribute name="Size" use="required" type="xs:string" />
11697 <xs:attribute name="Red" type="xs:integer">
11698 <xs:annotation>
11699 <xs:documentation>0 to 255</xs:documentation>
11700 </xs:annotation>
11701 </xs:attribute>
11702 <xs:attribute name="Green" type="xs:integer">
11703 <xs:annotation>
11704 <xs:documentation>0 to 255</xs:documentation>
11705 </xs:annotation>
11706 </xs:attribute>
11707 <xs:attribute name="Blue" type="xs:integer">
11708 <xs:annotation>
11709 <xs:documentation>0 to 255</xs:documentation>
11710 </xs:annotation>
11711 </xs:attribute>
11712 <xs:attribute name="Bold" type="YesNoTypeUnion" />
11713 <xs:attribute name="Italic" type="YesNoTypeUnion" />
11714 <xs:attribute name="Underline" type="YesNoTypeUnion" />
11715 <xs:attribute name="Strike" type="YesNoTypeUnion" />
11716 </xs:complexType>
11717 </xs:element>
11718 <xs:element name="ListItem">
11719 <xs:annotation>
11720 <xs:documentation>
11721 The value (and optional text) associated with an item in a ComboBox, ListBox, or ListView.
11722 </xs:documentation>
11723 <xs:appinfo>
11724 <xse:msiRef table="ComboBox" href="http://msdn.microsoft.com/library/aa367872.aspx" />
11725 <xse:msiRef table="ListBox" href="http://msdn.microsoft.com/library/aa369762.aspx" />
11726 <xse:msiRef table="ListView" href="http://msdn.microsoft.com/library/aa369764.aspx" />
11727 </xs:appinfo>
11728 </xs:annotation>
11729 <xs:complexType>
11730 <xs:attribute name="Value" type="xs:string" use="required">
11731 <xs:annotation>
11732 <xs:documentation>
11733 The value assigned to the associated ComboBox, ListBox, or ListView property if this item is selected.
11734 </xs:documentation>
11735 </xs:annotation>
11736 </xs:attribute>
11737 <xs:attribute name="Text" type="xs:string">
11738 <xs:annotation>
11739 <xs:documentation>
11740 The localizable, visible text to be assigned to the item.
11741 If not specified, this will default to the value of the Value attribute.
11742 </xs:documentation>
11743 </xs:annotation>
11744 </xs:attribute>
11745 <xs:attribute name="Icon" type="xs:string">
11746 <xs:annotation>
11747 <xs:documentation>
11748 The identifier of the Binary (not Icon) element containing the icon to associate with this item.
11749 This value is only valid when nested under a ListView element.
11750 </xs:documentation>
11751 </xs:annotation>
11752 </xs:attribute>
11753 </xs:complexType>
11754 </xs:element>
11755 <xs:element name="ListBox">
11756 <xs:annotation>
11757 <xs:documentation>
11758 Set of items for a particular ListBox control tied to an install Property
11759 </xs:documentation>
11760 <xs:appinfo>
11761 <xse:msiRef table="Control" href="http://msdn.microsoft.com/library/aa368044.aspx" />
11762 <xse:msiRef table="Dialog" href="http://msdn.microsoft.com/library/aa368286.aspx" />
11763 <xse:msiRef table="ListView" href="http://msdn.microsoft.com/library/aa369764.aspx" />
11764 </xs:appinfo>
11765 </xs:annotation>
11766 <xs:complexType>
11767 <xs:sequence>
11768 <xs:element ref="ListItem" minOccurs="0" maxOccurs="unbounded">
11769 <xs:annotation>
11770 <xs:documentation>entry for ListBox table</xs:documentation>
11771 </xs:annotation>
11772 </xs:element>
11773 </xs:sequence>
11774 <xs:attribute name="Property" use="required" type="xs:string">
11775 <xs:annotation>
11776 <xs:documentation>Property tied to this group</xs:documentation>
11777 </xs:annotation>
11778 </xs:attribute>
11779 </xs:complexType>
11780 </xs:element>
11781 <xs:element name="ComboBox">
11782 <xs:annotation>
11783 <xs:documentation>
11784 Set of items for a particular ComboBox control tied to an install Property
11785 </xs:documentation>
11786 <xs:appinfo>
11787 <xse:msiRef table="ComboBox" href="http://msdn.microsoft.com/library/aa367872.aspx" />
11788 <xse:msiRef table="Control" href="http://msdn.microsoft.com/library/aa368044.aspx" />
11789 <xse:msiRef table="Dialog" href="http://msdn.microsoft.com/library/aa368286.aspx" />
11790 </xs:appinfo>
11791 </xs:annotation>
11792 <xs:complexType>
11793 <xs:sequence>
11794 <xs:element ref="ListItem" minOccurs="0" maxOccurs="unbounded">
11795 <xs:annotation>
11796 <xs:documentation>entry for ComboBox table</xs:documentation>
11797 </xs:annotation>
11798 </xs:element>
11799 </xs:sequence>
11800 <xs:attribute name="Property" use="required" type="xs:string">
11801 <xs:annotation>
11802 <xs:documentation>Property tied to this group</xs:documentation>
11803 </xs:annotation>
11804 </xs:attribute>
11805 </xs:complexType>
11806 </xs:element>
11807 <xs:element name="ListView">
11808 <xs:annotation>
11809 <xs:documentation>
11810 Set of items for a particular ListView control tied to an install Property
11811 </xs:documentation>
11812 <xs:appinfo>
11813 <xse:msiRef table="ListView" href="http://msdn.microsoft.com/library/aa369764.aspx" />
11814 <xse:msiRef table="Control" href="http://msdn.microsoft.com/library/aa368044.aspx" />
11815 <xse:msiRef table="Dialog" href="http://msdn.microsoft.com/library/aa368286.aspx" />
11816 </xs:appinfo>
11817 </xs:annotation>
11818 <xs:complexType>
11819 <xs:sequence>
11820 <xs:element ref="ListItem" minOccurs="0" maxOccurs="unbounded">
11821 <xs:annotation>
11822 <xs:documentation>entry for ListView table</xs:documentation>
11823 </xs:annotation>
11824 </xs:element>
11825 </xs:sequence>
11826 <xs:attribute name="Property" use="required" type="xs:string">
11827 <xs:annotation>
11828 <xs:documentation>Property tied to this group</xs:documentation>
11829 </xs:annotation>
11830 </xs:attribute>
11831 </xs:complexType>
11832 </xs:element>
11833 <xs:element name="RadioButton">
11834 <xs:annotation>
11835 <xs:appinfo>
11836 <xse:seeAlso ref="RadioButtonGroup" />
11837 <xse:msiRef table="RadioButton" href="http://msdn.microsoft.com/library/aa370962.aspx" />
11838 <xse:msiRef table="Control" href="http://msdn.microsoft.com/library/aa368044.aspx" />
11839 <xse:msiRef table="Dialog" href="http://msdn.microsoft.com/library/aa368286.aspx" />
11840 </xs:appinfo>
11841 <xs:documentation>Text or Icon plus Value that is assigned to the Property of the parent Control (RadioButtonGroup).</xs:documentation>
11842 </xs:annotation>
11843 <xs:complexType>
11844 <xs:attribute name="Bitmap" type="xs:string">
11845 <xs:annotation>
11846 <xs:documentation>
11847 This attribute defines the bitmap displayed with the radio button. The value of the attribute creates a reference
11848 to a Binary element that represents the bitmap. This attribute is mutually exclusive with the Icon and Text
11849 attributes.
11850 </xs:documentation>
11851 </xs:annotation>
11852 </xs:attribute>
11853 <xs:attribute name="Height" use="required" type="LocalizableInteger" />
11854 <xs:attribute name="Help" type="xs:string" />
11855 <xs:attribute name="Icon" type="xs:string">
11856 <xs:annotation>
11857 <xs:documentation>
11858 This attribute defines the icon displayed with the radio button. The value of the attribute creates a reference
11859 to a Binary element that represents the icon. This attribute is mutually exclusive with the Bitmap and Text
11860 attributes.
11861 </xs:documentation>
11862 </xs:annotation>
11863 </xs:attribute>
11864 <xs:attribute name="Text" type="xs:string">
11865 <xs:annotation>
11866 <xs:documentation>Text displayed with the radio button. This attribute is mutually exclusive with the Bitmap and Icon attributes.</xs:documentation>
11867 </xs:annotation>
11868 </xs:attribute>
11869 <xs:attribute name="ToolTip" type="xs:string" />
11870 <xs:attribute name="Value" type="xs:string" use="required">
11871 <xs:annotation>
11872 <xs:documentation>Value assigned to the associated control Property when this radio button is selected.</xs:documentation>
11873 </xs:annotation>
11874 </xs:attribute>
11875 <xs:attribute name="Width" use="required" type="LocalizableInteger" />
11876 <xs:attribute name="X" use="required" type="LocalizableInteger" />
11877 <xs:attribute name="Y" use="required" type="LocalizableInteger" />
11878 </xs:complexType>
11879 </xs:element>
11880 <xs:element name="RadioButtonGroup">
11881 <xs:annotation>
11882 <xs:documentation>
11883 Set of radio buttons tied to the specified Property
11884 </xs:documentation>
11885 <xs:appinfo>
11886 <xse:msiRef table="RadioButton" href="http://msdn.microsoft.com/library/aa370962.aspx" />
11887 <xse:msiRef table="Control" href="http://msdn.microsoft.com/library/aa368044.aspx" />
11888 <xse:msiRef table="Dialog" href="http://msdn.microsoft.com/library/aa368286.aspx" />
11889 </xs:appinfo>
11890 </xs:annotation>
11891 <xs:complexType>
11892 <xs:sequence>
11893 <xs:element ref="RadioButton" maxOccurs="unbounded" />
11894 </xs:sequence>
11895 <xs:attribute name="Property" use="required" type="xs:string">
11896 <xs:annotation>
11897 <xs:documentation>Property tied to this group.</xs:documentation>
11898 </xs:annotation>
11899 </xs:attribute>
11900 </xs:complexType>
11901 </xs:element>
11902 <xs:element name="UIText">
11903 <xs:annotation>
11904 <xs:documentation>
11905 Text associated with certain controls
11906 </xs:documentation>
11907 <xs:appinfo>
11908 <xse:msiRef table="UIText" href="http://msdn.microsoft.com/library/aa372101.aspx" />
11909 </xs:appinfo>
11910 </xs:annotation>
11911 <xs:complexType>
11912 <xs:simpleContent>
11913 <xs:extension base="xs:string">
11914 <xs:annotation>
11915 <xs:documentation>Element value is text, may use CDATA if needed to escape XML delimiters</xs:documentation>
11916 </xs:annotation>
11917 <xs:attribute name="Id" use="required" type="xs:string" />
11918 </xs:extension>
11919 </xs:simpleContent>
11920 </xs:complexType>
11921 </xs:element>
11922 <xs:element name="UIRef">
11923 <xs:annotation>
11924 <xs:documentation>
11925 Reference to a UI element. This will force the entire referenced Fragment's contents
11926 to be included in the installer database.
11927 </xs:documentation>
11928 <xs:appinfo>
11929 <xse:seeAlso ref="UI" />
11930 </xs:appinfo>
11931 </xs:annotation>
11932 <xs:complexType>
11933 <xs:attribute name="Id" type="xs:string" use="required" />
11934 <xs:anyAttribute namespace="##other" processContents="lax">
11935 <xs:annotation>
11936 <xs:documentation>
11937 Extensibility point in the WiX XML Schema. Schema extensions can register additional
11938 attributes at this point in the schema.
11939 </xs:documentation>
11940 </xs:annotation>
11941 </xs:anyAttribute>
11942 </xs:complexType>
11943 </xs:element>
11944 <xs:element name="UI">
11945 <xs:annotation>
11946 <xs:documentation>
11947 Enclosing element to compartmentalize UI specifications.
11948 </xs:documentation>
11949 <xs:appinfo>
11950 <xse:seeAlso ref="UIRef" />
11951 </xs:appinfo>
11952 </xs:annotation>
11953 <xs:complexType>
11954 <xs:choice minOccurs="0" maxOccurs="unbounded">
11955 <xs:element ref="EmbeddedUI">
11956 <xs:annotation>
11957 <xs:documentation>Embedded UI definition with EmbeddedResource children.</xs:documentation>
11958 </xs:annotation>
11959 </xs:element>
11960 <xs:element ref="Error">
11961 <xs:annotation>
11962 <xs:documentation>Error text associated with install error</xs:documentation>
11963 </xs:annotation>
11964 </xs:element>
11965 <xs:element ref="ProgressText">
11966 <xs:annotation>
11967 <xs:documentation>ActionText entry associated with an action</xs:documentation>
11968 </xs:annotation>
11969 </xs:element>
11970 <xs:element ref="BillboardAction">
11971 <xs:annotation>
11972 <xs:documentation>Billboard table item with child Controls</xs:documentation>
11973 </xs:annotation>
11974 </xs:element>
11975 <xs:element ref="ComboBox">
11976 <xs:annotation>
11977 <xs:documentation>ComboBox table with ListItem children</xs:documentation>
11978 </xs:annotation>
11979 </xs:element>
11980 <xs:element ref="ListBox">
11981 <xs:annotation>
11982 <xs:documentation>ListBox table with ListItem children</xs:documentation>
11983 </xs:annotation>
11984 </xs:element>
11985 <xs:element ref="ListView">
11986 <xs:annotation>
11987 <xs:documentation>ListView table with ListItem children</xs:documentation>
11988 </xs:annotation>
11989 </xs:element>
11990 <xs:element ref="RadioButtonGroup">
11991 <xs:annotation>
11992 <xs:documentation>RadioButton table with RadioButton children</xs:documentation>
11993 </xs:annotation>
11994 </xs:element>
11995 <xs:element ref="TextStyle">
11996 <xs:annotation>
11997 <xs:documentation>TextStyle entry for use in control text</xs:documentation>
11998 </xs:annotation>
11999 </xs:element>
12000 <xs:element ref="UIText">
12001 <xs:annotation>
12002 <xs:documentation>values for UIText property, not installer Property</xs:documentation>
12003 </xs:annotation>
12004 </xs:element>
12005 <xs:element ref="Dialog">
12006 <xs:annotation>
12007 <xs:documentation>Dialog specification, called from Sequence</xs:documentation>
12008 </xs:annotation>
12009 </xs:element>
12010 <xs:element ref="DialogRef">
12011 <xs:annotation>
12012 <xs:documentation>Reference to a Dialog specification.</xs:documentation>
12013 </xs:annotation>
12014 </xs:element>
12015 <xs:element ref="Publish" />
12016 <!-- elements with identical behavior as under Product key, solely to allow grouping with other UI elements -->
12017 <xs:element ref="PropertyRef" />
12018 <xs:element ref="Property" />
12019 <xs:element ref="Binary" />
12020 <xs:sequence>
12021 <xs:element ref="AdminUISequence" minOccurs="0" />
12022 <xs:element ref="InstallUISequence" minOccurs="0" />
12023 </xs:sequence>
12024 <xs:element ref="UIRef" />
12025 </xs:choice>
12026 <xs:attribute name="Id" type="xs:string" />
12027 </xs:complexType>
12028 </xs:element>
12029 <!-- custom table elements -->
12030 <xs:element name="CustomTable">
12031 <xs:annotation>
12032 <xs:documentation>Defines a custom table for use from a custom action.</xs:documentation>
12033 </xs:annotation>
12034 <xs:complexType>
12035 <xs:sequence>
12036 <xs:element ref="Column" minOccurs="0" maxOccurs="unbounded">
12037 <xs:annotation>
12038 <xs:documentation>Column definition for the custom table.</xs:documentation>
12039 </xs:annotation>
12040 </xs:element>
12041 <xs:element ref="Row" minOccurs="0" maxOccurs="unbounded">
12042 <xs:annotation>
12043 <xs:documentation>Row definition for the custom table.</xs:documentation>
12044 </xs:annotation>
12045 </xs:element>
12046 </xs:sequence>
12047 <xs:attribute name="Id" type="xs:string" use="required">
12048 <xs:annotation>
12049 <xs:documentation>Identifier for the custom table.</xs:documentation>
12050 </xs:annotation>
12051 </xs:attribute>
12052 <xs:attribute name="BootstrapperApplicationData" type="YesNoType">
12053 <xs:annotation>
12054 <xs:documentation>Indicates the table data is transformed into the bootstrapper application data manifest.</xs:documentation>
12055 </xs:annotation>
12056 </xs:attribute>
12057 </xs:complexType>
12058 </xs:element>
12059 <xs:element name="Column">
12060 <xs:annotation>
12061 <xs:documentation>Column definition for a Custom Table</xs:documentation>
12062 </xs:annotation>
12063 <xs:complexType>
12064 <xs:attribute name="Id" type="xs:string" use="required">
12065 <xs:annotation>
12066 <xs:documentation>Identifier for the column.</xs:documentation>
12067 </xs:annotation>
12068 </xs:attribute>
12069 <xs:attribute name="PrimaryKey" type="YesNoTypeUnion">
12070 <xs:annotation>
12071 <xs:documentation>Whether this column is a primary key.</xs:documentation>
12072 </xs:annotation>
12073 </xs:attribute>
12074 <xs:attribute name="Type" use="required">
12075 <xs:annotation>
12076 <xs:documentation>The type of this column.</xs:documentation>
12077 </xs:annotation>
12078 <xs:simpleType>
12079 <xs:restriction base="xs:NMTOKEN">
12080 <xs:enumeration value="binary">
12081 <xs:annotation>
12082 <xs:documentation>
12083 Column contains a path to a file that will be inserted into the column as a binary object.
12084 If this value is set, the Category attribute must also be set with a value of 'Binary' to pass ICE validation.
12085 </xs:documentation>
12086 </xs:annotation>
12087 </xs:enumeration>
12088 <xs:enumeration value="int">
12089 <xs:annotation>
12090 <xs:documentation>
12091 Column contains an integer or datetime value (the MinValue and MaxValue attributes should also be set).
12092 </xs:documentation>
12093 </xs:annotation>
12094 </xs:enumeration>
12095 <xs:enumeration value="string">
12096 <xs:annotation>
12097 <xs:documentation>
12098 Column contains a non-localizable string value.
12099 </xs:documentation>
12100 </xs:annotation>
12101 </xs:enumeration>
12102 </xs:restriction>
12103 </xs:simpleType>
12104 </xs:attribute>
12105 <xs:attribute name="Width" type="xs:integer">
12106 <xs:annotation>
12107 <xs:documentation>Width of this column.</xs:documentation>
12108 </xs:annotation>
12109 </xs:attribute>
12110 <xs:attribute name="Nullable" type="YesNoTypeUnion">
12111 <xs:annotation>
12112 <xs:documentation>Whether this column can be left null.</xs:documentation>
12113 </xs:annotation>
12114 </xs:attribute>
12115 <xs:attribute name="Localizable" type="YesNoTypeUnion">
12116 <xs:annotation>
12117 <xs:documentation>Whether this column can be localized.</xs:documentation>
12118 </xs:annotation>
12119 </xs:attribute>
12120 <xs:attribute name="MinValue" type="xs:long">
12121 <xs:annotation>
12122 <xs:documentation>Minimum value for a numeric value, date or version in this column.</xs:documentation>
12123 </xs:annotation>
12124 </xs:attribute>
12125 <xs:attribute name="MaxValue" type="xs:long">
12126 <xs:annotation>
12127 <xs:documentation>Maximum value for a numeric value, date or version in this column.</xs:documentation>
12128 </xs:annotation>
12129 </xs:attribute>
12130 <xs:attribute name="KeyTable" type="xs:string">
12131 <xs:annotation>
12132 <xs:documentation>Table in which this column is an external key. Can be semicolon delimited.</xs:documentation>
12133 </xs:annotation>
12134 </xs:attribute>
12135 <xs:attribute name="KeyColumn" type="xs:integer">
12136 <xs:annotation>
12137 <xs:documentation>Column in the table in KeyTable attribute.</xs:documentation>
12138 </xs:annotation>
12139 </xs:attribute>
12140 <xs:attribute name="Category">
12141 <xs:annotation>
12142 <xs:documentation>
12143 Category of this column.
12144 This attribute must be specified with a value of 'Binary' if the Type attribute's value is 'binary'.
12145 </xs:documentation>
12146 </xs:annotation>
12147 <xs:simpleType>
12148 <xs:restriction base="xs:NMTOKEN">
12149 <xs:enumeration value="Text" />
12150 <xs:enumeration value="UpperCase" />
12151 <xs:enumeration value="LowerCase" />
12152 <xs:enumeration value="Integer" />
12153 <xs:enumeration value="DoubleInteger" />
12154 <xs:enumeration value="TimeDate" />
12155 <xs:enumeration value="Identifier" />
12156 <xs:enumeration value="Property" />
12157 <xs:enumeration value="Filename" />
12158 <xs:enumeration value="WildCardFilename" />
12159 <xs:enumeration value="Path" />
12160 <xs:enumeration value="Paths" />
12161 <xs:enumeration value="AnyPath" />
12162 <xs:enumeration value="DefaultDir" />
12163 <xs:enumeration value="RegPath" />
12164 <xs:enumeration value="Formatted" />
12165 <xs:enumeration value="FormattedSddl" />
12166 <xs:enumeration value="Template" />
12167 <xs:enumeration value="Condition" />
12168 <xs:enumeration value="Guid" />
12169 <xs:enumeration value="Version" />
12170 <xs:enumeration value="Language" />
12171 <xs:enumeration value="Binary" />
12172 <xs:enumeration value="CustomSource" />
12173 <xs:enumeration value="Cabinet" />
12174 <xs:enumeration value="Shortcut" />
12175 </xs:restriction>
12176 </xs:simpleType>
12177 </xs:attribute>
12178 <xs:attribute name="Set" type="xs:string">
12179 <xs:annotation>
12180 <xs:documentation>Semicolon delimited list of permissible values.</xs:documentation>
12181 </xs:annotation>
12182 </xs:attribute>
12183 <xs:attribute name="Description" type="xs:string">
12184 <xs:annotation>
12185 <xs:documentation>Description of this column.</xs:documentation>
12186 </xs:annotation>
12187 </xs:attribute>
12188 <xs:attribute name="Modularize">
12189 <xs:annotation>
12190 <xs:documentation>How this column should be modularized, if at all.</xs:documentation>
12191 </xs:annotation>
12192 <xs:simpleType>
12193 <xs:restriction base="xs:NMTOKEN">
12194 <xs:enumeration value="None">
12195 <xs:annotation>
12196 <xs:documentation>
12197 Column should not be modularized. This is the default value.
12198 </xs:documentation>
12199 </xs:annotation>
12200 </xs:enumeration>
12201 <xs:enumeration value="Column">
12202 <xs:annotation>
12203 <xs:documentation>
12204 Column should be modularized.
12205 </xs:documentation>
12206 </xs:annotation>
12207 </xs:enumeration>
12208 <xs:enumeration value="Condition">
12209 <xs:annotation>
12210 <xs:documentation>
12211 Column is a condition and should be modularized.
12212 </xs:documentation>
12213 </xs:annotation>
12214 </xs:enumeration>
12215 <xs:enumeration value="Icon">
12216 <xs:annotation>
12217 <xs:documentation>
12218 When the column is an primary or foreign key to the Icon table it should be modularized special.
12219 </xs:documentation>
12220 </xs:annotation>
12221 </xs:enumeration>
12222 <xs:enumeration value="Property">
12223 <xs:annotation>
12224 <xs:documentation>
12225 Any Properties in the column should be modularized.
12226 </xs:documentation>
12227 </xs:annotation>
12228 </xs:enumeration>
12229 <xs:enumeration value="SemicolonDelimited">
12230 <xs:annotation>
12231 <xs:documentation>
12232 Semi-colon list of keys, all of which need to be modularized.
12233 </xs:documentation>
12234 </xs:annotation>
12235 </xs:enumeration>
12236 </xs:restriction>
12237 </xs:simpleType>
12238 </xs:attribute>
12239 </xs:complexType>
12240 </xs:element>
12241 <xs:element name="Row">
12242 <xs:annotation>
12243 <xs:documentation>Row data for a Custom Table</xs:documentation>
12244 </xs:annotation>
12245 <xs:complexType>
12246 <xs:sequence>
12247 <xs:element ref="Data" maxOccurs="unbounded" />
12248 </xs:sequence>
12249 </xs:complexType>
12250 </xs:element>
12251 <xs:element name="Data">
12252 <xs:annotation>
12253 <xs:documentation>Used for a Custom Table. Specifies the data for the parent Row and specified Column.</xs:documentation>
12254 </xs:annotation>
12255 <xs:complexType>
12256 <xs:simpleContent>
12257 <xs:extension base="xs:string">
12258 <xs:annotation>
12259 <xs:documentation>A data value</xs:documentation>
12260 </xs:annotation>
12261 <xs:attribute name="Column" use="required" type="xs:string">
12262 <xs:annotation>
12263 <xs:documentation>Specifies in which column to insert this data.</xs:documentation>
12264 </xs:annotation>
12265 </xs:attribute>
12266 </xs:extension>
12267 </xs:simpleContent>
12268 </xs:complexType>
12269 </xs:element>
12270 <!-- EnsureTable element, for preserving empty tables -->
12271 <xs:element name="EnsureTable">
12272 <xs:annotation>
12273 <xs:documentation>
12274 Use this element to ensure that a table appears in the installer database, even if its empty.
12275 </xs:documentation>
12276 <xs:appinfo>
12277 <xse:remarks>
12278 This element is particularly useful for two problems that may occur while merging merge modules:
12279 <html:ol><html:li>
12280 The first likely problem is that in order to properly merge you need to have certain
12281 tables present prior to merging. Using this element is one way to ensure those tables
12282 are present prior to the merging.
12283 </html:li><html:li>
12284 The other common problem is that a merge module has incorrect validation information
12285 about some tables. By ensuring these tables prior to merging, you can avoid this
12286 problem because the correct validation information will go into the installer database
12287 before the merge module has a chance to set it incorrectly.
12288 </html:li></html:ol></xse:remarks>
12289 </xs:appinfo>
12290 </xs:annotation>
12291 <xs:complexType>
12292 <xs:attribute name="Id" use="required" type="xs:string">
12293 <xs:annotation>
12294 <xs:documentation>The name of the table.</xs:documentation>
12295 </xs:annotation>
12296 </xs:attribute>
12297 </xs:complexType>
12298 </xs:element>
12299 <xs:element name="WixVariable">
12300 <xs:annotation>
12301 <xs:documentation>
12302 This element exposes advanced WiX functionality. Use this element to declare WiX variables
12303 from directly within your authoring. WiX variables are not resolved until the final msi/msm/pcp
12304 file is actually generated. WiX variables do not persist into the msi/msm/pcp file, so they cannot
12305 be used when an MSI file is being installed; it's a WiX-only concept.
12306 </xs:documentation>
12307 </xs:annotation>
12308 <xs:complexType>
12309 <xs:attribute name="Id" type="xs:string" use="required">
12310 <xs:annotation>
12311 <xs:documentation>The name of the variable.</xs:documentation>
12312 </xs:annotation>
12313 </xs:attribute>
12314 <xs:attribute name="Overridable" type="YesNoTypeUnion">
12315 <xs:annotation>
12316 <xs:documentation>
12317 Set this value to 'yes' in order to make the variable's value overridable either by
12318 another WixVariable entry or via the command-line option -d&lt;name&gt;=&lt;value&gt;
12319 for light.exe. If the same variable is declared overridable in multiple places it
12320 will cause an error (since WiX won't know which value is correct). The default value
12321 is 'no'.
12322 </xs:documentation>
12323 </xs:annotation>
12324 </xs:attribute>
12325 <xs:attribute name="Value" type="xs:string" use="required">
12326 <xs:annotation>
12327 <xs:documentation>
12328 The value of the variable. The value cannot be an empty string because that would
12329 make it possible to accidentally set a column to null.
12330 </xs:documentation>
12331 </xs:annotation>
12332 </xs:attribute>
12333 </xs:complexType>
12334 </xs:element>
12335 <xs:element name="InstanceTransforms">
12336 <xs:annotation>
12337 <xs:documentation>
12338 Use this element to contain definitions for instance transforms.
12339 </xs:documentation>
12340 </xs:annotation>
12341 <xs:complexType>
12342 <xs:choice minOccurs="0" maxOccurs="unbounded">
12343 <xs:element ref="Instance" />
12344 </xs:choice>
12345 <xs:attribute name="Property" type="xs:string" use="required">
12346 <xs:annotation>
12347 <xs:documentation>The Id of the Property who's value should change for each instance.</xs:documentation>
12348 </xs:annotation>
12349 </xs:attribute>
12350 </xs:complexType>
12351 </xs:element>
12352 <xs:element name="Instance">
12353 <xs:annotation>
12354 <xs:documentation>
12355 Defines an instance transform for your product.
12356 </xs:documentation>
12357 </xs:annotation>
12358 <xs:complexType>
12359 <xs:attribute name="Id" type="xs:string" use="required">
12360 <xs:annotation>
12361 <xs:documentation>
12362 The identity of the instance transform. This value will define the name by which the instance
12363 should be referred to on the command line. In addition, the value of the this attribute will
12364 determine what the value of the property specified in Property attribute on InstanceTransforms
12365 will change to for each instance.
12366 </xs:documentation>
12367 </xs:annotation>
12368 </xs:attribute>
12369 <xs:attribute name="ProductCode" type="AutogenGuid" use="required">
12370 <xs:annotation>
12371 <xs:documentation>The ProductCode for this instance.</xs:documentation>
12372 </xs:annotation>
12373 </xs:attribute>
12374 <xs:attribute name="ProductName" type="xs:string">
12375 <xs:annotation>
12376 <xs:documentation>The ProductName for this instance.</xs:documentation>
12377 </xs:annotation>
12378 </xs:attribute>
12379 <xs:attribute name="UpgradeCode" type="Guid">
12380 <xs:annotation>
12381 <xs:documentation>The UpgradeCode for this instance.</xs:documentation>
12382 </xs:annotation>
12383 </xs:attribute>
12384 </xs:complexType>
12385 </xs:element>
12386 <xs:element name="MajorUpgrade">
12387 <xs:annotation>
12388 <xs:documentation>
12389 Simplifies authoring for major upgrades, including support for preventing downgrades.
12390
12391 The parent Product element must have valid UpgradeCode and Version attributes.
12392
12393 When the FindRelatedProducts action detects a related product installed on the system,
12394 it appends the product code to the property named WIX_UPGRADE_DETECTED. After the
12395 FindRelatedProducts action is run, the value of the WIX_UPGRADE_DETECTED property is a
12396 list of product codes, separated by semicolons (;), detected on the system.
12397 </xs:documentation>
12398 <xs:appinfo>
12399 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Product" />
12400 </xs:appinfo>
12401 </xs:annotation>
12402 <xs:complexType>
12403 <xs:attribute name="AllowDowngrades" type="YesNoTypeUnion">
12404 <xs:annotation>
12405 <xs:documentation>
12406 When set to no (the default), products with lower version numbers are blocked from
12407 installing when a product with a higher version is installed; the DowngradeErrorMessage
12408 attribute must also be specified.
12409
12410 When set to yes, any version can be installed over any other version.
12411 </xs:documentation>
12412 </xs:annotation>
12413 </xs:attribute>
12414 <xs:attribute name="AllowSameVersionUpgrades" type="YesNoTypeUnion">
12415 <xs:annotation>
12416 <xs:documentation>
12417 When set to no (the default), installing a product with the same version and upgrade code
12418 (but different product code) is allowed and treated by MSI as two products. When set to yes,
12419 WiX sets the msidbUpgradeAttributesVersionMaxInclusive attribute, which tells MSI to treat
12420 a product with the same version as a major upgrade.
12421
12422 This is useful when two product versions differ only in the fourth version field. MSI
12423 specifically ignores that field when comparing product versions, so two products that
12424 differ only in the fourth version field are the same product and need this attribute set to
12425 yes to be detected.
12426
12427 Note that because MSI ignores the fourth product version field, setting this attribute to
12428 yes also allows downgrades when the first three product version fields are identical.
12429 For example, product version 1.0.0.1 will "upgrade" 1.0.0.2998 because they're seen as the
12430 same version (1.0.0). That could reintroduce serious bugs so the safest choice is to change
12431 the first three version fields and omit this attribute to get the default of no.
12432
12433 This attribute cannot be "yes" when AllowDowngrades is also "yes" -- AllowDowngrades
12434 already allows two products with the same version number to upgrade each other.
12435 </xs:documentation>
12436 </xs:annotation>
12437 </xs:attribute>
12438 <xs:attribute name="Disallow" type="YesNoTypeUnion">
12439 <xs:annotation>
12440 <xs:documentation>
12441 When set to yes, products with higer version numbers are blocked from
12442 installing when a product with a lower version is installed; the UpgradeErrorMessage
12443 attribute must also be specified.
12444
12445 When set to no (the default), any version can be installed over any lower version.
12446 </xs:documentation>
12447 </xs:annotation>
12448 </xs:attribute>
12449 <xs:attribute name="DowngradeErrorMessage" type="xs:string">
12450 <xs:annotation>
12451 <xs:documentation>
12452 The message displayed if users try to install a product with a lower version number
12453 when a product with a higher version is installed. Used only when AllowDowngrades
12454 is no (the default).
12455 </xs:documentation>
12456 </xs:annotation>
12457 </xs:attribute>
12458 <xs:attribute name="DisallowUpgradeErrorMessage" type="xs:string">
12459 <xs:annotation>
12460 <xs:documentation>
12461 The message displayed if users try to install a product with a higer version number
12462 when a product with a lower version is installed. Used only when Disallow
12463 is yes.
12464 </xs:documentation>
12465 </xs:annotation>
12466 </xs:attribute>
12467 <xs:attribute name="MigrateFeatures" type="YesNoTypeUnion">
12468 <xs:annotation>
12469 <xs:documentation>
12470 When set to yes (the default), the MigrateFeatureStates standard action will set the
12471 feature states of the upgrade product to those of the installed product.
12472
12473 When set to no, the installed features have no effect on the upgrade installation.
12474 </xs:documentation>
12475 </xs:annotation>
12476 </xs:attribute>
12477 <xs:attribute name="IgnoreLanguage" type="YesNoTypeUnion">
12478 <xs:annotation>
12479 <xs:documentation>
12480 When set to yes, the Upgrade table rows will match any product with the same UpgradeCode.
12481
12482 When set to no (the default), the Upgrade table rows will match only products with the
12483 same UpgradeCode and ProductLanguage.
12484 </xs:documentation>
12485 </xs:annotation>
12486 </xs:attribute>
12487 <xs:attribute name="IgnoreRemoveFailure" type="YesNoTypeUnion">
12488 <xs:annotation>
12489 <xs:documentation>
12490 When set to yes, failures removing the installed product during the upgrade will be
12491 ignored.
12492
12493 When set to no (the default), failures removing the installed product during the upgrade
12494 will be considered a failure and, depending on the scheduling, roll back the upgrade.
12495 </xs:documentation>
12496 </xs:annotation>
12497 </xs:attribute>
12498 <xs:attribute name="RemoveFeatures" type="xs:string">
12499 <xs:annotation>
12500 <xs:documentation>
12501 A formatted string that contains the list of features to remove from the installed
12502 product. The default is to remove all features. Note that if you use formatted property
12503 values that evaluate to an empty string, no features will be removed; only omitting
12504 this attribute defaults to removing all features.
12505 </xs:documentation>
12506 </xs:annotation>
12507 </xs:attribute>
12508 <xs:attribute name="Schedule" default="afterInstallValidate">
12509 <xs:annotation>
12510 <xs:documentation>
12511 Determines the scheduling of the RemoveExistingProducts standard action, which is when
12512 the installed product is removed. The default is "afterInstallValidate" which removes
12513 the installed product entirely before installing the upgrade product. It's slowest but
12514 gives the most flexibility in changing components and features in the upgrade product.
12515
12516 For more information, see <html:a href="http://msdn.microsoft.com/en-us/library/aa371197.aspx" target="_blank">RemoveExistingProducts</html:a>.
12517 </xs:documentation>
12518 </xs:annotation>
12519 <xs:simpleType>
12520 <xs:restriction base="xs:NMTOKEN">
12521 <xs:enumeration value="afterInstallValidate">
12522 <xs:annotation>
12523 <xs:documentation>
12524 (Default) Schedules RemoveExistingProducts after the InstallValidate standard
12525 action. This scheduling removes the installed product entirely before installing
12526 the upgrade product. It's slowest but gives the most flexibility in changing
12527 components and features in the upgrade product. Note that if the installation
12528 of the upgrade product fails, the machine will have neither version installed.
12529 </xs:documentation>
12530 </xs:annotation>
12531 </xs:enumeration>
12532 <xs:enumeration value="afterInstallInitialize">
12533 <xs:annotation>
12534 <xs:documentation>
12535 Schedules RemoveExistingProducts after the InstallInitialize standard action.
12536 This is similar to the afterInstallValidate scheduling, but if the installation
12537 of the upgrade product fails, Windows Installer also rolls back the removal of
12538 the installed product -- in other words, reinstalls it.
12539 </xs:documentation>
12540 </xs:annotation>
12541 </xs:enumeration>
12542 <xs:enumeration value="afterInstallExecute">
12543 <xs:annotation>
12544 <xs:documentation>
12545 Schedules RemoveExistingProducts between the InstallExecute and InstallFinalize standard actions.
12546 This scheduling installs the upgrade product "on top of" the installed product then lets
12547 RemoveExistingProducts uninstall any components that don't also exist in the upgrade product.
12548 Note that this scheduling requires strict adherence to the component rules because it relies
12549 on component reference counts to be accurate during installation of the upgrade product and
12550 removal of the installed product. For more information, see
12551 <html:a href="http://www.joyofsetup.com/2008/12/30/paying-for-upgrades/" target="_blank">
12552 Bob Arnson's blog post "Paying for Upgrades"
12553 </html:a> for details. If installation of the upgrade product fails, Windows Installer
12554 also rolls back the removal of the installed product -- in other words, reinstalls it.
12555 </xs:documentation>
12556 </xs:annotation>
12557 </xs:enumeration>
12558 <xs:enumeration value="afterInstallExecuteAgain">
12559 <xs:annotation>
12560 <xs:documentation>
12561 Schedules RemoveExistingProducts between the InstallExecuteAgain and InstallFinalize standard actions.
12562 This is identical to the afterInstallExecute scheduling but after the InstallExecuteAgain standard
12563 action instead of InstallExecute.
12564 </xs:documentation>
12565 </xs:annotation>
12566 </xs:enumeration>
12567 <xs:enumeration value="afterInstallFinalize">
12568 <xs:annotation>
12569 <xs:documentation>
12570 Schedules RemoveExistingProducts after the InstallFinalize standard action. This is similar to the
12571 afterInstallExecute and afterInstallExecuteAgain schedulings but takes place outside the
12572 installation transaction so if installation of the upgrade product fails, Windows Installer does
12573 not roll back the removal of the installed product, so the machine will have both versions
12574 installed.
12575 </xs:documentation>
12576 </xs:annotation>
12577 </xs:enumeration>
12578 </xs:restriction>
12579 </xs:simpleType>
12580 </xs:attribute>
12581 </xs:complexType>
12582 </xs:element>
12583 <xs:element name="ProductSearch">
12584 <xs:annotation>
12585 <xs:appinfo>
12586 <xse:msiRef table="Upgrade" href="http://msdn.microsoft.com/library/aa372379.aspx" />
12587 </xs:appinfo>
12588 </xs:annotation>
12589 <xs:complexType>
12590 <xs:simpleContent>
12591 <xs:extension base="xs:string">
12592 <xs:attribute name="Minimum" type="xs:string">
12593 <xs:annotation>
12594 <xs:documentation>Specifies the lower bound on the range of product versions to be detected by FindRelatedProducts.</xs:documentation>
12595 </xs:annotation>
12596 </xs:attribute>
12597 <xs:attribute name="Maximum" type="xs:string">
12598 <xs:annotation>
12599 <xs:documentation>Specifies the upper boundary of the range of product versions detected by FindRelatedProducts.</xs:documentation>
12600 </xs:annotation>
12601 </xs:attribute>
12602 <xs:attribute name="Language" type="xs:string">
12603 <xs:annotation>
12604 <xs:documentation>Specifies the set of languages detected by FindRelatedProducts. Enter a list of numeric language identifiers (LANGID) separated by commas (,). Leave this value null to specify all languages. Set ExcludeLanguages to "yes" in order detect all languages, excluding the languages listed in this value.</xs:documentation>
12605 </xs:annotation>
12606 </xs:attribute>
12607 <xs:attribute name="IncludeMinimum" type="YesNoTypeUnion">
12608 <xs:annotation>
12609 <xs:documentation>Set to "no" to make the range of versions detected exclude the value specified in Minimum. This attribute is "yes" by default.</xs:documentation>
12610 </xs:annotation>
12611 </xs:attribute>
12612 <xs:attribute name="IncludeMaximum" type="YesNoTypeUnion">
12613 <xs:annotation>
12614 <xs:documentation>Set to "yes" to make the range of versions detected include the value specified in Maximum.</xs:documentation>
12615 </xs:annotation>
12616 </xs:attribute>
12617 <xs:attribute name="ExcludeLanguages" type="YesNoTypeUnion">
12618 <xs:annotation>
12619 <xs:documentation>Set to "yes" to detect all languages, excluding the languages listed in the Language attribute.</xs:documentation>
12620 </xs:annotation>
12621 </xs:attribute>
12622 <xs:attribute name="UpgradeCode" type="Guid" use="required">
12623 <xs:annotation>
12624 <xs:documentation>This value specifies the upgrade code for the products that are to be detected by the FindRelatedProducts action.</xs:documentation>
12625 </xs:annotation>
12626 </xs:attribute>
12627 <xs:anyAttribute namespace="##other" processContents="lax">
12628 <xs:annotation>
12629 <xs:documentation>
12630 Extensibility point in the WiX XML Schema. Schema extensions can register additional
12631 attributes at this point in the schema.
12632 </xs:documentation>
12633 </xs:annotation>
12634 </xs:anyAttribute>
12635 </xs:extension>
12636 </xs:simpleContent>
12637 </xs:complexType>
12638 </xs:element>
12639 <!-- - - - - - - - - - - Complex Type Definitions - - - - - - - - - - - -->
12640 <xs:complexType name="ActionModuleSequenceType">
12641 <xs:simpleContent>
12642 <xs:extension base="xs:string">
12643 <xs:annotation>
12644 <xs:documentation>Text node specifies the condition of the action.</xs:documentation>
12645 </xs:annotation>
12646 <xs:attribute name="After" type="xs:string">
12647 <xs:annotation>
12648 <xs:documentation>The name of an action that this action should come after.</xs:documentation>
12649 </xs:annotation>
12650 </xs:attribute>
12651 <xs:attribute name="Before" type="xs:string">
12652 <xs:annotation>
12653 <xs:documentation>The name of an action that this action should come before.</xs:documentation>
12654 </xs:annotation>
12655 </xs:attribute>
12656 <xs:attribute name="Overridable" type="YesNoTypeUnion">
12657 <xs:annotation>
12658 <xs:documentation>
12659 If "yes", the sequencing of this action may be overridden by sequencing elsewhere.
12660 </xs:documentation>
12661 </xs:annotation>
12662 </xs:attribute>
12663 <xs:attribute name="Sequence" type="xs:integer">
12664 <xs:annotation>
12665 <xs:documentation>A value used to indicate the position of this action in a sequence.</xs:documentation>
12666 </xs:annotation>
12667 </xs:attribute>
12668 <xs:attribute name="Suppress" type="YesNoTypeUnion">
12669 <xs:annotation>
12670 <xs:documentation>If yes, this action will not occur.</xs:documentation>
12671 </xs:annotation>
12672 </xs:attribute>
12673 </xs:extension>
12674 </xs:simpleContent>
12675 </xs:complexType>
12676 <xs:complexType name="ActionSequenceType">
12677 <xs:simpleContent>
12678 <xs:extension base="xs:string">
12679 <xs:attribute name="Sequence" type="xs:integer">
12680 <xs:annotation>
12681 <xs:documentation>A value used to indicate the position of this action in a sequence.</xs:documentation>
12682 </xs:annotation>
12683 </xs:attribute>
12684 <xs:attribute name="Suppress" type="YesNoTypeUnion">
12685 <xs:annotation>
12686 <xs:documentation>If yes, this action will not occur.</xs:documentation>
12687 </xs:annotation>
12688 </xs:attribute>
12689 </xs:extension>
12690 </xs:simpleContent>
12691 </xs:complexType>
12692 <!-- - - - - - - - - - - Simple Type Definitions - - - - - - - - - - - - -->
12693 <xs:simpleType name="Guid">
12694 <xs:annotation>
12695 <xs:documentation>Values of this type will look like: "01234567-89AB-CDEF-0123-456789ABCDEF" or "{01234567-89AB-CDEF-0123-456789ABCDEF}". Also allows "PUT-GUID-HERE" for use in examples.</xs:documentation>
12696 </xs:annotation>
12697 <xs:restriction base="xs:string">
12698 <xs:pattern value="[{(]?[0-9A-Fa-f]{8}\-?[0-9A-Fa-f]{4}\-?[0-9A-Fa-f]{4}\-?[0-9A-Fa-f]{4}\-?[0-9A-Fa-f]{12}[})]?|PUT\-GUID\-(\d+\-)?HERE|([!$])(\(var|\(loc|\(wix)\.[_A-Za-z][0-9A-Za-z_.]*\)" />
12699 </xs:restriction>
12700 </xs:simpleType>
12701 <xs:simpleType name="AutogenGuid">
12702 <xs:annotation>
12703 <xs:documentation>Values of this type will look like: "01234567-89AB-CDEF-0123-456789ABCDEF" or "{01234567-89AB-CDEF-0123-456789ABCDEF}". A GUID can be auto-generated by setting the value to "*". Also allows "PUT-GUID-HERE" for use in examples.</xs:documentation>
12704 </xs:annotation>
12705 <xs:restriction base="xs:string">
12706 <xs:pattern value="[{(]?[0-9A-Fa-f]{8}\-?[0-9A-Fa-f]{4}\-?[0-9A-Fa-f]{4}\-?[0-9A-Fa-f]{4}\-?[0-9A-Fa-f]{12}[})]?|[{(]?\?{8}\-\?{4}\-\?{4}\-\?{4}\-\?{12}[})]?|PUT\-GUID\-(\d+\-)?HERE|([!$])(\(var|\(loc|\(wix)\.[_A-Za-z][0-9A-Za-z_.]*\)|\*" />
12707 </xs:restriction>
12708 </xs:simpleType>
12709 <xs:simpleType name="BurnContainerType">
12710 <xs:annotation>
12711 <xs:documentation>Values of this type will either be "attached" or "detached".</xs:documentation>
12712 </xs:annotation>
12713 <xs:restriction base="xs:NMTOKEN">
12714 <xs:enumeration value="attached" />
12715 <xs:enumeration value="detached" />
12716 </xs:restriction>
12717 </xs:simpleType>
12718 <xs:simpleType name="BurnExeProtocolType">
12719 <xs:annotation>
12720 <xs:documentation>The list of communcation protocols with executable packages Burn supports.
12721 </xs:documentation>
12722 </xs:annotation>
12723 <xs:restriction base="xs:NMTOKEN">
12724 <xs:enumeration value="none">
12725 <xs:annotation>
12726 <xs:documentation>
12727 The executable package does not support a communication protocol.
12728 </xs:documentation>
12729 </xs:annotation>
12730 </xs:enumeration>
12731 <xs:enumeration value="burn">
12732 <xs:annotation>
12733 <xs:documentation>
12734 The executable package is another Burn bundle and supports the Burn communication protocol.
12735 </xs:documentation>
12736 </xs:annotation>
12737 </xs:enumeration>
12738 <xs:enumeration value="netfx4">
12739 <xs:annotation>
12740 <xs:documentation>
12741 The executable package implements the .NET Framework v4.0 communication protocol.
12742 </xs:documentation>
12743 </xs:annotation>
12744 </xs:enumeration>
12745 </xs:restriction>
12746 </xs:simpleType>
12747 <xs:simpleType name="ComponentGuid">
12748 <xs:annotation>
12749 <xs:documentation>Values of this type will look like: "01234567-89AB-CDEF-0123-456789ABCDEF" or "{01234567-89AB-CDEF-0123-456789ABCDEF}", but also allows "PUT-GUID-HERE" for use in examples. It's also possible to have an empty value "".</xs:documentation>
12750 </xs:annotation>
12751 <xs:restriction base="xs:string">
12752 <xs:pattern value="[{(]?[0-9A-Fa-f]{8}\-?[0-9A-Fa-f]{4}\-?[0-9A-Fa-f]{4}\-?[0-9A-Fa-f]{4}\-?[0-9A-Fa-f]{12}[})]?|PUT\-GUID\-(\d+\-)?HERE|([!$])(\(var|\(loc|\(wix)\.[_A-Za-z][0-9A-Za-z_.]*\)|\*|^$" />
12753 </xs:restriction>
12754 </xs:simpleType>
12755 <xs:simpleType name="LocalizableInteger">
12756 <xs:annotation>
12757 <xs:documentation>Values of this type must be an integer or the value can be a localization variable with the format !(loc.Variable) where "Variable" is the name of the variable.</xs:documentation>
12758 </xs:annotation>
12759 <xs:restriction base="xs:string">
12760 <xs:pattern value="[0-9][0-9]*|([!$])\((loc|bind)\.[_A-Za-z][0-9A-Za-z_.]+\)" />
12761 </xs:restriction>
12762 </xs:simpleType>
12763 <xs:simpleType name="ShortFileNameType">
12764 <xs:annotation>
12765 <xs:documentation>Values of this type will look like: "FileName.ext". Only one period is allowed. The following characters are not allowed: \ ? | &gt; : / * " + , ; = [ ] less-than, or whitespace. The name cannot be longer than 8 characters and the extension cannot exceed 3 characters. The value could also be a localization variable with the format !(loc.VARIABLE).</xs:documentation>
12766 </xs:annotation>
12767 <xs:restriction base="xs:string">
12768 <xs:pattern value="[^\\\?|&gt;&lt;:/\*&quot;\+,;=\[\]\. ]{1,8}(\.[^\\\?|&gt;&lt;:/\*&quot;\+,;=\[\]\. ]{0,3})?|([!$])\(loc\.[_A-Za-z][0-9A-Za-z_.]*\)" />
12769 </xs:restriction>
12770 </xs:simpleType>
12771 <xs:simpleType name="LongFileNameType">
12772 <xs:annotation>
12773 <xs:documentation>Values of this type will look like: "Long File Name.extension". Legal long names contain no more than 260 characters and must contain at least one non-period character. The following characters are not allowed: \ ? | &gt; : / * " or less-than. The name must be shorter than 260 characters. The value could also be a localization variable with the format !(loc.VARIABLE).</xs:documentation>
12774 </xs:annotation>
12775 <xs:restriction base="xs:string">
12776 <xs:pattern value="[^\\\?|&gt;&lt;:/\*&quot;]{1,259}|([!$])\(loc\.[_A-Za-z][0-9A-Za-z_.]*\)" />
12777 </xs:restriction>
12778 </xs:simpleType>
12779 <xs:simpleType name="VersionType">
12780 <xs:annotation>
12781 <xs:documentation>Values of this type will look like: "x.x.x.x" where x is an integer from 0 to 65534.</xs:documentation>
12782 </xs:annotation>
12783 <xs:restriction base="xs:string">
12784 <xs:pattern value="(\d{1,5}\.){3}\d{1,5}" />
12785 </xs:restriction>
12786 </xs:simpleType>
12787 <xs:simpleType name="WildCardShortFileNameType">
12788 <xs:annotation>
12789 <xs:documentation>Values of this type will look like: "File?.*". Only one period is allowed. The following characters are not allowed: \ | &gt; : / " + , ; = [ ] less-than, or whitespace. The name cannot be longer than 8 characters and the extension cannot exceed 3 characters. The value could also be a localization variable with the format !(loc.VARIABLE).</xs:documentation>
12790 </xs:annotation>
12791 <xs:restriction base="xs:string">
12792 <xs:pattern value="[^\\\|&gt;&lt;:/&quot;\+,;=\[\]\. ]{1,16}(\.[^\\\|&gt;&lt;:/&quot;\+,;=\[\]\. ]{0,6})?|([!$])\(loc\.[_A-Za-z][0-9A-Za-z_.]*\)" />
12793 </xs:restriction>
12794 </xs:simpleType>
12795 <xs:simpleType name="WildCardLongFileNameType">
12796 <xs:annotation>
12797 <xs:documentation>Values of this type will look like: "Long File N?me.extension*". Legal long names contain no more than 260 characters and must contain at least one non-period character. The following characters are not allowed: \ | &gt; : / " or less-than. The name must be shorter than 260 characters. The value could also be a localization variable with the format !(loc.VARIABLE).</xs:documentation>
12798 </xs:annotation>
12799 <xs:restriction base="xs:string">
12800 <xs:pattern value="[^\\\|&gt;&lt;:/&quot;]{1,259}|([!$])\(loc\.[_A-Za-z][0-9A-Za-z_.]*\)" />
12801 </xs:restriction>
12802 </xs:simpleType>
12803 <xs:simpleType name="HexType">
12804 <xs:annotation>
12805 <xs:documentation>This type supports any hexadecimal number. Both upper and lower case is acceptable for letters appearing in the number. This type also includes the empty string: "".</xs:documentation>
12806 </xs:annotation>
12807 <xs:restriction base="xs:string">
12808 <xs:pattern value="[0-9A-Fa-f]*" />
12809 </xs:restriction>
12810 </xs:simpleType>
12811 <xs:simpleType name="YesNoTypeUnion">
12812 <xs:annotation>
12813 <xs:documentation>Values of this type will either be "yes" or "no".</xs:documentation>
12814 </xs:annotation>
12815 <xs:union memberTypes="YesNoType PreprocessorVariables"/>
12816 </xs:simpleType>
12817 <xs:simpleType name="YesNoType">
12818 <xs:annotation>
12819 <xs:documentation>Values of this type will either be "yes" or "no".</xs:documentation>
12820 </xs:annotation>
12821 <xs:restriction base="xs:NMTOKEN">
12822 <xs:enumeration value="no" />
12823 <xs:enumeration value="yes" />
12824 </xs:restriction>
12825 </xs:simpleType>
12826 <xs:simpleType name="YesNoButtonTypeUnion">
12827 <xs:annotation>
12828 <xs:documentation>Values of this type will either be "button", "yes" or "no".</xs:documentation>
12829 </xs:annotation>
12830 <xs:union memberTypes="YesNoButtonType PreprocessorVariables"/>
12831 </xs:simpleType>
12832 <xs:simpleType name="YesNoButtonType">
12833 <xs:annotation>
12834 <xs:documentation>Values of this type will either be "button", "yes" or "no".</xs:documentation>
12835 </xs:annotation>
12836 <xs:restriction base="xs:NMTOKEN">
12837 <xs:enumeration value="no" />
12838 <xs:enumeration value="yes" />
12839 <xs:enumeration value="button" />
12840 </xs:restriction>
12841 </xs:simpleType>
12842 <xs:simpleType name="YesNoDefaultTypeUnion">
12843 <xs:annotation>
12844 <xs:documentation>Values of this type will either be "default", "yes", or "no".</xs:documentation>
12845 </xs:annotation>
12846 <xs:union memberTypes="YesNoDefaultType PreprocessorVariables"/>
12847 </xs:simpleType>
12848 <xs:simpleType name="YesNoDefaultType">
12849 <xs:annotation>
12850 <xs:documentation>Values of this type will either be "default", "yes", or "no".</xs:documentation>
12851 </xs:annotation>
12852 <xs:restriction base="xs:NMTOKEN">
12853 <xs:enumeration value="default" />
12854 <xs:enumeration value="no" />
12855 <xs:enumeration value="yes" />
12856 </xs:restriction>
12857 </xs:simpleType>
12858 <xs:simpleType name="YesNoAlwaysTypeUnion">
12859 <xs:annotation>
12860 <xs:documentation>Values of this type will either be "always", "yes", or "no".</xs:documentation>
12861 </xs:annotation>
12862 <xs:union memberTypes="YesNoAlwaysType PreprocessorVariables"/>
12863 </xs:simpleType>
12864 <xs:simpleType name="YesNoAlwaysType">
12865 <xs:annotation>
12866 <xs:documentation>Values of this type will either be "always", "yes", or "no".</xs:documentation>
12867 </xs:annotation>
12868 <xs:restriction base="xs:NMTOKEN">
12869 <xs:enumeration value="always" />
12870 <xs:enumeration value="no" />
12871 <xs:enumeration value="yes" />
12872 </xs:restriction>
12873 </xs:simpleType>
12874 <xs:simpleType name="RegistryRootType">
12875 <xs:annotation>
12876 <xs:documentation>Values of this type represent possible registry roots.</xs:documentation>
12877 </xs:annotation>
12878 <xs:restriction base="xs:NMTOKEN">
12879 <xs:enumeration value="HKMU">
12880 <xs:annotation>
12881 <xs:documentation>
12882 A per-user installation will make the operation occur under HKEY_CURRENT_USER.
12883 A per-machine installation will make the operation occur under HKEY_LOCAL_MACHINE.
12884 </xs:documentation>
12885 </xs:annotation>
12886 </xs:enumeration>
12887 <xs:enumeration value="HKCR">
12888 <xs:annotation>
12889 <xs:documentation>
12890 Operation occurs under HKEY_CLASSES_ROOT. When using Windows 2000 or later, the installer writes or removes the value
12891 from the HKCU\Software\Classes hive during per-user installations. When using Windows 2000 or later operating systems,
12892 the installer writes or removes the value from the HKLM\Software\Classes hive during per-machine installations.
12893 </xs:documentation>
12894 </xs:annotation>
12895 </xs:enumeration>
12896 <xs:enumeration value="HKCU">
12897 <xs:annotation>
12898 <xs:documentation>
12899 Operation occurs under HKEY_CURRENT_USER. It is recommended to set the KeyPath='yes' attribute when setting this value for writing values
12900 in order to ensure that the installer writes the necessary registry entries when there are multiple users on the same computer.
12901 </xs:documentation>
12902 </xs:annotation>
12903 </xs:enumeration>
12904 <xs:enumeration value="HKLM">
12905 <xs:annotation>
12906 <xs:documentation>
12907 Operation occurs under HKEY_LOCAL_MACHINE.
12908 </xs:documentation>
12909 </xs:annotation>
12910 </xs:enumeration>
12911 <xs:enumeration value="HKU">
12912 <xs:annotation>
12913 <xs:documentation>
12914 Operation occurs under HKEY_USERS.
12915 </xs:documentation>
12916 </xs:annotation>
12917 </xs:enumeration>
12918 </xs:restriction>
12919 </xs:simpleType>
12920 <xs:simpleType name="ExitType">
12921 <xs:annotation>
12922 <xs:documentation>Value indicates that this action is executed if the installer returns the associated exit type. Each exit type can be used with no more than one action.
12923 Multiple actions can have exit types assigned, but every action and exit type must be different. Exit types are typically used with dialog boxes.</xs:documentation>
12924 </xs:annotation>
12925 <xs:restriction base="xs:NMTOKEN">
12926 <xs:enumeration value="success" />
12927 <xs:enumeration value="cancel" />
12928 <xs:enumeration value="error" />
12929 <xs:enumeration value="suspend" />
12930 </xs:restriction>
12931 </xs:simpleType>
12932 <xs:simpleType name="InstallUninstallType">
12933 <xs:annotation>
12934 <xs:documentation>Specifies whether an action occur on install, uninstall or both.</xs:documentation>
12935 </xs:annotation>
12936 <xs:restriction base="xs:NMTOKEN">
12937 <xs:enumeration value="install">
12938 <xs:annotation>
12939 <xs:documentation>
12940 The action should happen during install (msiInstallStateLocal or msiInstallStateSource).
12941 </xs:documentation>
12942 </xs:annotation>
12943 </xs:enumeration>
12944 <xs:enumeration value="uninstall">
12945 <xs:annotation>
12946 <xs:documentation>
12947 The action should happen during uninstall (msiInstallStateAbsent).
12948 </xs:documentation>
12949 </xs:annotation>
12950 </xs:enumeration>
12951 <xs:enumeration value="both">
12952 <xs:annotation>
12953 <xs:documentation>
12954 The action should happen during both install and uninstall.
12955 </xs:documentation>
12956 </xs:annotation>
12957 </xs:enumeration>
12958 </xs:restriction>
12959 </xs:simpleType>
12960 <xs:simpleType name="SequenceType">
12961 <xs:annotation>
12962 <xs:documentation>
12963 Controls which sequences the item assignment is sequenced in.
12964 </xs:documentation>
12965 </xs:annotation>
12966 <xs:restriction base="xs:NMTOKEN">
12967 <xs:enumeration value="both">
12968 <xs:annotation>
12969 <xs:documentation>
12970 Schedules the assignment in the InstallUISequence and the InstallExecuteSequence.
12971 </xs:documentation>
12972 </xs:annotation>
12973 </xs:enumeration>
12974 <xs:enumeration value="first">
12975 <xs:annotation>
12976 <xs:documentation>
12977 Schedules the assignment to run in the InstallUISequence or the InstallExecuteSequence if the InstallUISequence is skipped.
12978 </xs:documentation>
12979 </xs:annotation>
12980 </xs:enumeration>
12981 <xs:enumeration value="execute">
12982 <xs:annotation>
12983 <xs:documentation>
12984 Schedules the assignment only in the the InstallExecuteSequence.
12985 </xs:documentation>
12986 </xs:annotation>
12987 </xs:enumeration>
12988 <xs:enumeration value="ui">
12989 <xs:annotation>
12990 <xs:documentation>
12991 Schedules the assignment only in the the InstallUISequence.
12992 </xs:documentation>
12993 </xs:annotation>
12994 </xs:enumeration>
12995 </xs:restriction>
12996 </xs:simpleType>
12997 <xs:simpleType name="CompressionLevelTypeUnion">
12998 <xs:annotation>
12999 <xs:documentation>
13000 Indicates the compression level for a cabinet.
13001 </xs:documentation>
13002 </xs:annotation>
13003 <xs:union memberTypes="CompressionLevelType PreprocessorVariables"/>
13004 </xs:simpleType>
13005 <xs:simpleType name="CompressionLevelType">
13006 <xs:annotation>
13007 <xs:documentation>
13008 Indicates the compression level for a cabinet.
13009 </xs:documentation>
13010 </xs:annotation>
13011 <xs:restriction base="xs:NMTOKEN">
13012 <xs:enumeration value="high" />
13013 <xs:enumeration value="low" />
13014 <xs:enumeration value="medium" />
13015 <xs:enumeration value="mszip" />
13016 <xs:enumeration value="none" />
13017 </xs:restriction>
13018 </xs:simpleType>
13019 <xs:simpleType name="PreprocessorVariables">
13020 <xs:annotation>
13021 <xs:documentation>A type that represents that 1 or more preprocessor variables (as they appear in sources on disk, before preprocessor has run).</xs:documentation>
13022 </xs:annotation>
13023 <xs:restriction base="xs:string">
13024 <xs:pattern value="(\$\(\w+\.(\w|[.])+\))+" />
13025 </xs:restriction>
13026 </xs:simpleType>
13027 <xs:simpleType name="DiskIdType">
13028 <xs:annotation>
13029 <xs:documentation>Values of this type must be an integer or the value of one or more preprocessor variables with the format $(var.Variable) where "Variable" is the name of the preprocessor variable.</xs:documentation>
13030 </xs:annotation>
13031 <xs:restriction base="xs:string">
13032 <xs:pattern value="((\d+)|(\$\(\w+\.(\w|[.])+\)))+" />
13033 </xs:restriction>
13034 </xs:simpleType>
13035</xs:schema>
diff --git a/src/WixToolset.Data/Xsd/wixloc.xsd b/src/WixToolset.Data/Xsd/wixloc.xsd
deleted file mode 100644
index 9f1814c4..00000000
--- a/src/WixToolset.Data/Xsd/wixloc.xsd
+++ /dev/null
@@ -1,134 +0,0 @@
1<?xml version="1.0" encoding="utf-8"?>
2<!-- Copyright (c) .NET Foundation and contributors. All rights reserved. Licensed under the Microsoft Reciprocal License. See LICENSE.TXT file in the project root for full license information. -->
3
4
5<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
6 xmlns:xse=" http://wixtoolset.org/schemas/XmlSchemaExtension"
7 xmlns:html="http://www.w3.org/1999/xhtml"
8 targetNamespace="http://wixtoolset.org/schemas/v4/wxl"
9 xmlns="http://wixtoolset.org/schemas/v4/wxl">
10 <xs:annotation>
11 <xs:documentation>
12 Schema for describing WiX Localization files (.wxl).
13 </xs:documentation>
14 </xs:annotation>
15
16 <xs:element name="WixLocalization">
17 <xs:annotation>
18 <xs:appinfo>
19 <xse:remarks>
20 <html:p>You can specify any valid Windows code page by integer like 1252, or by web name like Windows-1252 or iso-8859-1. See <a href="~/overview/codepage.html">Code Pages</a> for more information.</html:p>
21 </xse:remarks>
22 <xse:howtoRef href="ui_and_localization/build_a_localized_version.html">How To: Build a localized version of your installer</xse:howtoRef>
23 <xse:howtoRef href="ui_and_localization/make_installer_localizable.html">How To: Make your installer localizable</xse:howtoRef>
24 </xs:appinfo>
25 </xs:annotation>
26 <xs:complexType>
27 <xs:choice minOccurs="0" maxOccurs="unbounded">
28 <xs:element ref="String" />
29 <xs:element ref="UI" />
30 </xs:choice>
31 <xs:attribute name="Codepage" type="xs:string">
32 <xs:annotation>
33 <xs:documentation>The code page integer value or web name for the resulting database. You can also specify -1 which will not reset the database code page. See remarks for more information.</xs:documentation>
34 </xs:annotation>
35 </xs:attribute>
36 <xs:attribute name="Culture" type="xs:string">
37 <xs:annotation>
38 <xs:documentation>Culture of the localization strings.</xs:documentation>
39 </xs:annotation>
40 </xs:attribute>
41 <xs:attribute name="Language" type="xs:integer">
42 <xs:annotation>
43 <xs:documentation>The decimal language ID (LCID) for the culture.</xs:documentation>
44 </xs:annotation>
45 </xs:attribute>
46 </xs:complexType>
47 </xs:element>
48
49 <xs:element name="String">
50 <xs:annotation>
51 <xs:appinfo>
52 <xse:howtoRef href="ui_and_localization/build_a_localized_version.html">How To: Build a localized version of your installer</xse:howtoRef>
53 <xse:howtoRef href="ui_and_localization/make_installer_localizable.html">How To: Make your installer localizable</xse:howtoRef>
54 </xs:appinfo>
55 </xs:annotation>
56 <xs:complexType mixed="true">
57 <xs:attribute name="Id" type="xs:string" use="required">
58 <xs:annotation>
59 <xs:documentation>Identity of the resource.</xs:documentation>
60 </xs:annotation>
61 </xs:attribute>
62 <xs:attribute name="Overridable" type="LocalizationYesNoType">
63 <xs:annotation>
64 <xs:documentation>Determines if the localized string may be overridden.</xs:documentation>
65 </xs:annotation>
66 </xs:attribute>
67 <xs:attribute name="Localizable" type="LocalizationYesNoType">
68 <xs:annotation>
69 <xs:documentation>Indicates whether the string is localizable text or a non-localizable string that must be unique per locale. No WiX tools are affected by the value of this attribute; it used as documentation for localizers to ignore things like GUIDs or identifiers that look like text.</xs:documentation>
70 </xs:annotation>
71 </xs:attribute>
72 </xs:complexType>
73 </xs:element>
74
75 <xs:element name="UI">
76 <xs:annotation>
77 <xs:documentation>Allows a localization to override the position, size, and text of dialogs and controls. Override the text by specifying the replacement text in the inner text of the UI element.</xs:documentation>
78 </xs:annotation>
79 <xs:complexType mixed="true">
80 <xs:attribute name="Dialog" type="xs:string">
81 <xs:annotation>
82 <xs:documentation>Identifies the dialog to localize or the dialog that a control to localize is in.</xs:documentation>
83 </xs:annotation>
84 </xs:attribute>
85 <xs:attribute name="Control" type="xs:string">
86 <xs:annotation>
87 <xs:documentation>Combined with the Dialog attribute, identifies the control to localize.</xs:documentation>
88 </xs:annotation>
89 </xs:attribute>
90 <xs:attribute name="X" type="xs:integer">
91 <xs:annotation>
92 <xs:documentation>For a dialog, overrides the authored horizontal centering. For a control, overrides the authored horizontal coordinate of the upper-left corner of the rectangular boundary. This must be a non-negative number.</xs:documentation>
93 </xs:annotation>
94 </xs:attribute>
95 <xs:attribute name="Y" type="xs:integer">
96 <xs:annotation>
97 <xs:documentation>For a dialog, overrides the authored vertical centering. For a control, overrides the authored vertical coordinate of the upper-left corner of the rectangular boundary of the control. This must be a non-negative number.</xs:documentation>
98 </xs:annotation>
99 </xs:attribute>
100 <xs:attribute name="Width" type="xs:integer">
101 <xs:annotation>
102 <xs:documentation>For a dialog, overrides the authored width in dialog units. For a control, overrides the authored width of the rectangular boundary of the control. This must be a non-negative number.</xs:documentation>
103 </xs:annotation>
104 </xs:attribute>
105 <xs:attribute name="Height" type="xs:integer">
106 <xs:annotation>
107 <xs:documentation>For a dialog, overrides the authored height in dialog units. For a control, overrides the authored height of the rectangular boundary of the control. This must be a non-negative number.</xs:documentation>
108 </xs:annotation>
109 </xs:attribute>
110 <xs:attribute name="RightToLeft" type="LocalizationYesNoType">
111 <xs:annotation>
112 <xs:documentation>Set this attribute to "yes" to cause the Control to display from right to left. Not valid for a dialog.</xs:documentation>
113 </xs:annotation>
114 </xs:attribute>
115 <xs:attribute name="RightAligned" type="LocalizationYesNoType">
116 <xs:annotation>
117 <xs:documentation>Set this attribute to "yes" to cause the Control to be right aligned. Not valid for a dialog.</xs:documentation>
118 </xs:annotation>
119 </xs:attribute>
120 <xs:attribute name="LeftScroll" type="LocalizationYesNoType">
121 <xs:annotation>
122 <xs:documentation>Set this attribute to "yes" to cause the scroll bar to display on the left side of the Control. Not valid for a dialog.</xs:documentation>
123 </xs:annotation>
124 </xs:attribute>
125 </xs:complexType>
126 </xs:element>
127
128 <xs:simpleType name="LocalizationYesNoType">
129 <xs:restriction base="xs:NMTOKEN">
130 <xs:enumeration value="no" />
131 <xs:enumeration value="yes" />
132 </xs:restriction>
133 </xs:simpleType>
134</xs:schema>
diff --git a/src/test/WixToolsetTest.Data/SerializeFixture.cs b/src/test/WixToolsetTest.Data/SerializeFixture.cs
index ac2f5454..856bcda7 100644
--- a/src/test/WixToolsetTest.Data/SerializeFixture.cs
+++ b/src/test/WixToolsetTest.Data/SerializeFixture.cs
@@ -23,7 +23,7 @@ namespace WixToolsetTest.Data
23 { 23 {
24 ComponentId = new Guid(1, 0, 0, new byte[8]).ToString("B"), 24 ComponentId = new Guid(1, 0, 0, new byte[8]).ToString("B"),
25 Directory_ = "TestFolder", 25 Directory_ = "TestFolder",
26 Attributes = 2, 26 Location = ComponentLocation.Either,
27 }); 27 });
28 28
29 var intermediate = new Intermediate("TestIntermediate", new[] { section }, null, null); 29 var intermediate = new Intermediate("TestIntermediate", new[] { section }, null, null);
@@ -38,7 +38,7 @@ namespace WixToolsetTest.Data
38 Assert.Equal("TestComponent", tuple.Id.Id); 38 Assert.Equal("TestComponent", tuple.Id.Id);
39 Assert.Equal(AccessModifier.Public, tuple.Id.Access); 39 Assert.Equal(AccessModifier.Public, tuple.Id.Access);
40 Assert.Equal("TestFolder", tuple.Directory_); 40 Assert.Equal("TestFolder", tuple.Directory_);
41 Assert.Equal(2, tuple.Attributes); 41 Assert.Equal(ComponentLocation.Either, tuple.Location);
42 } 42 }
43 43
44 [Fact] 44 [Fact]
@@ -178,8 +178,8 @@ namespace WixToolsetTest.Data
178 178
179 var controls = new[] 179 var controls = new[]
180 { 180 {
181 new LocalizedControl("TestDlg1", "TestControl1", 10, 10, 100, 100, 0, null), 181 new LocalizedControl("TestDlg1", "TestControl1", 10, 10, 100, 100, false, false, false, null),
182 new LocalizedControl("TestDlg1", "TestControl2", 100, 90, 50, 70, 0, "localized"), 182 new LocalizedControl("TestDlg1", "TestControl2", 100, 90, 50, 70, false, false, false, "localized"),
183 }; 183 };
184 184
185 var localizations = new[] 185 var localizations = new[]
@@ -193,7 +193,7 @@ namespace WixToolsetTest.Data
193 { 193 {
194 ComponentId = new Guid(1, 0, 0, new byte[8]).ToString("B"), 194 ComponentId = new Guid(1, 0, 0, new byte[8]).ToString("B"),
195 Directory_ = "TestFolder", 195 Directory_ = "TestFolder",
196 Attributes = 2, 196 Location = ComponentLocation.Either,
197 }); 197 });
198 198
199 var intermediate = new Intermediate("TestIntermediate", new[] { section }, localizations.ToDictionary(l => l.Culture), null); 199 var intermediate = new Intermediate("TestIntermediate", new[] { section }, localizations.ToDictionary(l => l.Culture), null);
diff --git a/src/test/WixToolsetTest.Data/WixToolsetTest.Data.csproj b/src/test/WixToolsetTest.Data/WixToolsetTest.Data.csproj
index e81b4f6f..d35ba853 100644
--- a/src/test/WixToolsetTest.Data/WixToolsetTest.Data.csproj
+++ b/src/test/WixToolsetTest.Data/WixToolsetTest.Data.csproj
@@ -12,8 +12,8 @@
12 12
13 <ItemGroup> 13 <ItemGroup>
14 <PackageReference Include="Microsoft.NET.Test.Sdk" Version="15.8.0" /> 14 <PackageReference Include="Microsoft.NET.Test.Sdk" Version="15.8.0" />
15 <PackageReference Include="xunit" Version="2.4.0" /> 15 <PackageReference Include="xunit" Version="2.4.1" />
16 <PackageReference Include="xunit.runner.visualstudio" Version="2.4.0" /> 16 <PackageReference Include="xunit.runner.visualstudio" Version="2.4.1" PrivateAssets="All" />
17 </ItemGroup> 17 </ItemGroup>
18 18
19</Project> 19</Project>
generated by cgit v1.2.3-55-g6feb (git 2.39.1) at 2025-04-06 01:27:49 +0000