aboutsummaryrefslogtreecommitdiff
path: root/src/xsd/wix.xsd
diff options
context:
space:
mode:
Diffstat (limited to 'src/xsd/wix.xsd')
-rw-r--r--src/xsd/wix.xsd14645
1 files changed, 14645 insertions, 0 deletions
diff --git a/src/xsd/wix.xsd b/src/xsd/wix.xsd
new file mode 100644
index 00000000..fc0c66af
--- /dev/null
+++ b/src/xsd/wix.xsd
@@ -0,0 +1,14645 @@
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/.msp).
13 </xs:documentation>
14 <xs:appinfo>
15 <xse:main />
16 </xs:appinfo>
17 </xs:annotation>
18
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, Package, Module, Patch elements are analogous to the main function in a C program.
24 There can only be one of these present when linking occurs. Package compiles into an MSI file,
25 Module compiles into an MSM file, Patch compiles into an MSP file. The Fragment element is an atomic
26 unit which ultimately links into either a Package, Module. The Fragment can either be completely included or excluded during linking.
27 </xs:documentation>
28 </xs:annotation>
29 <xs:complexType>
30 <xs:choice minOccurs="0">
31 <xs:sequence>
32 <xs:choice minOccurs="0">
33 <xs:element ref="Bundle" />
34 <xs:element ref="Package" />
35 <xs:element ref="Module" />
36 <xs:element ref="Patch" />
37 <xs:element ref="PatchCreation" />
38 </xs:choice>
39 <xs:element ref="Fragment" minOccurs="0" maxOccurs="unbounded" />
40 </xs:sequence>
41 </xs:choice>
42 <xs:attribute name="RequiredVersion" type="WixVersionType">
43 <xs:annotation>
44 <xs:documentation>Required version of the WiX toolset to compile this input file.</xs:documentation>
45 </xs:annotation>
46 </xs:attribute>
47 <xs:anyAttribute namespace="##other" processContents="lax">
48 <xs:annotation>
49 <xs:documentation>
50 Extensibility point in the WiX XML Schema. Schema extensions can register additional attributes at this point in the schema.
51 </xs:documentation>
52 </xs:annotation>
53 </xs:anyAttribute>
54 </xs:complexType>
55 </xs:element>
56 <xs:element name="Include">
57 <xs:annotation>
58 <xs:documentation>
59 This is the top-level container element for every wxi file.
60 </xs:documentation>
61 </xs:annotation>
62 <xs:complexType>
63 <xs:choice minOccurs="0" maxOccurs="unbounded">
64 <xs:any namespace="##any" processContents="lax" />
65 </xs:choice>
66 </xs:complexType>
67 </xs:element>
68 <xs:element name="Bundle">
69 <xs:annotation>
70 <xs:documentation>The root element for creating bundled packages.</xs:documentation>
71 </xs:annotation>
72 <xs:complexType>
73 <xs:choice minOccurs="0" maxOccurs="unbounded">
74 <xs:element ref="ApprovedExeForElevation" />
75 <xs:element ref="BootstrapperApplication" />
76 <xs:element ref="BootstrapperApplicationRef" />
77 <xs:element ref="BootstrapperExtension" />
78 <xs:element ref="BootstrapperExtensionRef" />
79 <xs:element ref="BundleCustomData" />
80 <xs:element ref="BundleCustomDataRef" />
81 <xs:element ref="BundleExtension" />
82 <xs:element ref="BundleExtensionRef" />
83 <xs:element ref="OptionalUpdateRegistration" minOccurs="0" maxOccurs="1" />
84 <xs:element ref="Chain" minOccurs="1" maxOccurs="1" />
85 <xs:element ref="Container" />
86 <xs:element ref="ContainerRef" />
87 <xs:element ref="Log" minOccurs="0" maxOccurs="1" />
88 <xs:element ref="PayloadGroup" />
89 <xs:element ref="PayloadGroupRef" />
90 <xs:element ref="RelatedBundle" />
91 <xs:element ref="Requires" />
92 <xs:element ref="SetVariable" />
93 <xs:element ref="SetVariableRef" />
94 <xs:element ref="SoftwareTag" />
95 <xs:element ref="Update" minOccurs="0" maxOccurs="1" />
96 <xs:element ref="Variable" />
97 <xs:element ref="WixVariable" />
98 <xs:any namespace="##other" processContents="lax">
99 <xs:annotation>
100 <xs:documentation>
101 Extensibility point in the WiX XML Schema. Schema extensions can register additional
102 elements at this point in the schema.
103 </xs:documentation>
104 </xs:annotation>
105 </xs:any>
106 </xs:choice>
107 <xs:attribute name="AboutUrl" type="xs:string">
108 <xs:annotation>
109 <xs:documentation>
110 A URL for more information about the bundle to display in Programs and Features (also
111 known as Add/Remove Programs).
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="Condition" type="xs:string">
121 <xs:annotation>
122 <xs:documentation>
123 The condition of the bundle. If the condition is not met, the bundle will
124 refuse to run. Conditions are checked before the bootstrapper application is loaded
125 (before detect), and thus can only reference built-in variables such as
126 variables which indicate the version of the OS.
127 </xs:documentation>
128 </xs:annotation>
129 </xs:attribute>
130 <xs:attribute name="Copyright" type="xs:string">
131 <xs:annotation>
132 <xs:documentation>
133 The legal copyright found in the version resources of final bundle executable. If
134 this attribute is not provided the copyright will be set to "Copyright (c) [Bundle/@Manufacturer]. All rights reserved.".
135 </xs:documentation>
136 </xs:annotation>
137 </xs:attribute>
138 <xs:attribute name="DisableModify" type="YesNoButtonTypeUnion">
139 <xs:annotation>
140 <xs:documentation>
141 Determines whether the bundle can be modified via the Programs and Features (also known as
142 Add/Remove Programs). If the value is "button" then Programs and Features will show a single
143 "Uninstall/Change" button. If the value is "yes" then Programs and Features will only show
144 the "Uninstall" button". If the value is "no", the default, then a "Change" button is shown.
145 See the DisableRemove attribute for information how to not display the bundle in Programs
146 and Features.
147 </xs:documentation>
148 </xs:annotation>
149 </xs:attribute>
150 <xs:attribute name="DisableRemove" type="YesNoTypeUnion">
151 <xs:annotation>
152 <xs:documentation>
153 Determines whether the bundle can be removed via the Programs and Features (also
154 known as Add/Remove Programs). If the value is "yes" then the "Uninstall" button will
155 not be displayed. The default is "no" which ensures there is an "Uninstall" button to
156 remove the bundle. If the "DisableModify" attribute is also "yes" or "button" then the
157 bundle will not be displayed in Progams and Features and another mechanism (such as
158 registering as a related bundle addon) must be used to ensure the bundle can be removed.
159 </xs:documentation>
160 </xs:annotation>
161 </xs:attribute>
162 <xs:attribute name="HelpTelephone" type="xs:string">
163 <xs:annotation>
164 <xs:documentation>
165 A telephone number for help to display in Programs and Features (also known as
166 Add/Remove Programs).
167 </xs:documentation>
168 </xs:annotation>
169 </xs:attribute>
170 <xs:attribute name="HelpUrl" type="xs:string">
171 <xs:annotation>
172 <xs:documentation>
173 A URL to the help for the bundle to display in Programs and Features (also known as
174 Add/Remove Programs).
175 </xs:documentation>
176 </xs:annotation>
177 </xs:attribute>
178 <xs:attribute name="IconSourceFile" type="xs:string">
179 <xs:annotation>
180 <xs:documentation>
181 Path to an icon that will replace the default icon in the final Bundle executable.
182 This icon will also be displayed in Programs and Features (also known as Add/Remove
183 Programs).
184 </xs:documentation>
185 </xs:annotation>
186 </xs:attribute>
187 <xs:attribute name="InProgressName" type="xs:string">
188 <xs:annotation>
189 <xs:documentation>
190 Optional name to display in Add/Remove Programs while the bundle is being installed, uninstalled, repaired.
191 </xs:documentation>
192 </xs:annotation>
193 </xs:attribute>
194 <xs:attribute name="Manufacturer" type="xs:string">
195 <xs:annotation>
196 <xs:documentation>
197 The publisher of the bundle to display in Programs and Features (also known as
198 Add/Remove Programs).
199 </xs:documentation>
200 </xs:annotation>
201 </xs:attribute>
202 <xs:attribute name="Name" type="xs:string">
203 <xs:annotation>
204 <xs:documentation>
205 The name of the bundle to display in Programs and Features (also known as Add/Remove
206 Programs). This name can be accessed and overwritten by a BootstrapperApplication
207 using the WixBundleName bundle variable.
208 </xs:documentation>
209 </xs:annotation>
210 </xs:attribute>
211 <xs:attribute name="ParentName" type="xs:string">
212 <xs:annotation>
213 <xs:documentation>
214 The name of the parent bundle to display in Installed Updates (also known as Add/Remove
215 Programs). This name is used to nest or group bundles that will appear as updates.
216 If the parent name does not actually exist, a virtual parent is created automatically.
217 </xs:documentation>
218 </xs:annotation>
219 </xs:attribute>
220 <xs:attribute name="ProviderKey" type="xs:string">
221 <xs:annotation>
222 <xs:documentation>
223 Optional attribute to explicitly author the provider key for the entire bundle.
224 <html:p>
225 This provider key is designed to persist throughout compatible upgrades so that dependent bundles do not have to be reinstalled
226 and will not prevent your product from being upgraded. If this attribute is not authored, the value is the
227 automatically-generated bundle ID and will not automatically support upgrades.
228 </html:p>
229 <html:p>
230 Only a single provider key is supported for bundles. To author that your bundle provides additional features via
231 packages, author different provider keys for your packages.
232 </html:p>
233 </xs:documentation>
234 </xs:annotation>
235 </xs:attribute>
236 <xs:attribute name="SplashScreenSourceFile" type="xs:string">
237 <xs:annotation>
238 <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>
239 </xs:annotation>
240 </xs:attribute>
241 <xs:attribute name="Tag" type="xs:string">
242 <xs:annotation>
243 <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>
244 </xs:annotation>
245 </xs:attribute>
246 <xs:attribute name="UpdateUrl" type="xs:string">
247 <xs:annotation>
248 <xs:documentation>
249 A URL for updates of the bundle to display in Programs and Features (also
250 known as Add/Remove Programs).
251 </xs:documentation>
252 </xs:annotation>
253 </xs:attribute>
254 <xs:attribute name="UpgradeCode" type="Guid" use="required">
255 <xs:annotation>
256 <xs:documentation>
257 Unique identifier for a family of bundles. If two bundles have the same UpgradeCode the
258 bundle with the highest version will be installed.
259 </xs:documentation>
260 </xs:annotation>
261 </xs:attribute>
262 <xs:attribute name="Version" type="xs:string" use="required">
263 <xs:annotation>
264 <xs:documentation>
265 The version of the bundle. Newer versions upgrade earlier versions of the bundles
266 with matching UpgradeCodes. If the bundle is registered in Programs and Features
267 then this attribute will be displayed in the Programs and Features user interface.
268 </xs:documentation>
269 </xs:annotation>
270 </xs:attribute>
271 <xs:anyAttribute namespace="##other" processContents="lax">
272 <xs:annotation>
273 <xs:documentation>
274 Extensibility point in the WiX XML Schema. Schema extensions can register additional
275 attributes at this point in the schema.
276 </xs:documentation>
277 </xs:annotation>
278 </xs:anyAttribute>
279 </xs:complexType>
280 </xs:element>
281 <xs:element name="ApprovedExeForElevation">
282 <xs:annotation>
283 <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>
284 <xs:appinfo>
285 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Bundle" />
286 </xs:appinfo>
287 </xs:annotation>
288 <xs:complexType>
289 <xs:attribute name="Id" type="xs:string" use="required">
290 <xs:annotation>
291 <xs:documentation>The identifier of the ApprovedExeForElevation element.</xs:documentation>
292 </xs:annotation>
293 </xs:attribute>
294 <xs:attribute name="Key" type="xs:string" use="required">
295 <xs:annotation>
296 <xs:documentation>
297 The key path.
298 For security purposes, the root key will be HKLM and Variables are not supported.
299 </xs:documentation>
300 </xs:annotation>
301 </xs:attribute>
302 <xs:attribute name="Value" type="xs:string">
303 <xs:annotation>
304 <xs:documentation>
305 The value name.
306 For security purposes, Variables are not supported.
307 </xs:documentation>
308 </xs:annotation>
309 </xs:attribute>
310 <xs:attribute name="Bitness" type="BitnessTypeUnion">
311 <xs:annotation>
312 <xs:documentation>
313 Overrides the default registry to search. The value `always64` will force
314 the search to look in the 64-bit registry even when building for 32-bit.
315 Simliarly, the value `always32` will force the search to look in the 32-bit
316 registry even when building for 64-bit.
317 The default value is `default` where the search will look in the same registry
318 as the bitness of the package.
319 </xs:documentation>
320 </xs:annotation>
321 </xs:attribute>
322 </xs:complexType>
323 </xs:element>
324 <xs:element name="Log">
325 <xs:annotation>
326 <xs:documentation>Overrides the default log settings for a bundle.</xs:documentation>
327 <xs:appinfo>
328 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Bundle" />
329 </xs:appinfo>
330 </xs:annotation>
331 <xs:complexType>
332 <xs:attribute name="Disable" type="YesNoTypeUnion">
333 <xs:annotation>
334 <xs:documentation>
335 Disables the default logging in the Bundle. The end user can still generate a
336 log file by specifying the "-l" command-line argument when installing the
337 Bundle.
338 </xs:documentation>
339 </xs:annotation>
340 </xs:attribute>
341 <xs:attribute name="PathVariable" type="xs:string">
342 <xs:annotation>
343 <xs:documentation>
344 Name of a Variable that will hold the path to the log file. An empty value
345 will cause the variable to not be set. The default is "WixBundleLog".
346 </xs:documentation>
347 </xs:annotation>
348 </xs:attribute>
349 <xs:attribute name="Prefix" type="xs:string">
350 <xs:annotation>
351 <xs:documentation>
352 File name and optionally a relative path to use as the prefix for the log file. The
353 default is to use the Bundle/@Name or, if Bundle/@Name is not specified, the value
354 "Setup".
355 </xs:documentation>
356 </xs:annotation>
357 </xs:attribute>
358 <xs:attribute name="Extension" type="xs:string">
359 <xs:annotation>
360 <xs:documentation>The extension to use for the log. The default is ".log".</xs:documentation>
361 </xs:annotation>
362 </xs:attribute>
363 </xs:complexType>
364 </xs:element>
365 <xs:element name="BootstrapperApplicationDll">
366 <xs:annotation>
367 <xs:documentation>Describes the entry point to the bootstrapper application.</xs:documentation>
368 </xs:annotation>
369 <xs:complexType>
370 <xs:choice minOccurs="0" maxOccurs="unbounded">
371 <xs:any namespace="##other" processContents="lax">
372 <xs:annotation>
373 <xs:documentation>
374 Extensibility point in the WiX XML Schema. Schema extensions can register additional
375 elements at this point in the schema.
376 </xs:documentation>
377 </xs:annotation>
378 </xs:any>
379 </xs:choice>
380 <xs:attribute name="Id" type="xs:string">
381 <xs:annotation>
382 <xs:documentation>The identifier of BootstrapperApplicationDll element.</xs:documentation>
383 </xs:annotation>
384 </xs:attribute>
385 <xs:attribute name="SourceFile" type="xs:string">
386 <xs:annotation>
387 <xs:documentation>
388 Location of the source file.
389 The default value is the Name attribute, if provided.
390 At a minimum, the SourceFile or Name attribute must be specified.
391 </xs:documentation>
392 </xs:annotation>
393 </xs:attribute>
394 <xs:attribute name="Name" type="xs:string">
395 <xs:annotation>
396 <xs:documentation>
397 The destination path and file name for this payload.
398 The default is the source file name.
399 At a minimum, the Name or SourceFile attribute must be specified.
400 This must be a relative path ('\foo' or 'C:\foo' is not allowed).
401 </xs:documentation>
402 </xs:annotation>
403 </xs:attribute>
404 <xs:attribute name="DpiAwareness" default="perMonitorV2">
405 <xs:annotation>
406 <xs:documentation>The DPI awareness of the BootstrapperApplication. The default is 'perMonitorV2'. Microsoft High DPI documentation is at https://docs.microsoft.com/en-us/windows/win32/hidpi/high-dpi-desktop-application-development-on-windows.</xs:documentation>
407 </xs:annotation>
408 <xs:simpleType>
409 <xs:restriction base="xs:NMTOKEN">
410 <xs:enumeration value="gdiScaled">
411 <xs:annotation>
412 <xs:documentation>Corresponds to the .exe manifest element 'gdiScaling' with content of 'true'. Windows does not support combining this with other DPI awareness modes.</xs:documentation>
413 </xs:annotation>
414 </xs:enumeration>
415 <xs:enumeration value="perMonitor">
416 <xs:annotation>
417 <xs:documentation>Corresponds to the .exe manifest element 'dpiAware' with content of 'true/pm'.</xs:documentation>
418 </xs:annotation>
419 </xs:enumeration>
420 <xs:enumeration value="perMonitorV2">
421 <xs:annotation>
422 <xs:documentation>Corresponds to the .exe manifest element 'dpiAwareness' with content of 'PerMonitorV2, PerMonitor' and the manifest element 'dpiAware' with content of 'true/pm'.</xs:documentation>
423 </xs:annotation>
424 </xs:enumeration>
425 <xs:enumeration value="system">
426 <xs:annotation>
427 <xs:documentation>Corresponds to the .exe manifest element 'dpiAware' with content of 'true'.</xs:documentation>
428 </xs:annotation>
429 </xs:enumeration>
430 <xs:enumeration value="unaware" />
431 </xs:restriction>
432 </xs:simpleType>
433 </xs:attribute>
434 <xs:anyAttribute namespace="##other" processContents="lax">
435 <xs:annotation>
436 <xs:documentation>
437 Extensibility point in the WiX XML Schema. Schema extensions can register additional
438 attributes at this point in the schema.
439 </xs:documentation>
440 </xs:annotation>
441 </xs:anyAttribute>
442 </xs:complexType>
443 </xs:element>
444 <xs:element name="BootstrapperApplication">
445 <xs:annotation>
446 <xs:documentation>Contains all the relevant information about the setup UI.</xs:documentation>
447 </xs:annotation>
448 <xs:complexType>
449 <xs:choice minOccurs="0" maxOccurs="unbounded">
450 <xs:element ref="BootstrapperApplicationDll" minOccurs="0" maxOccurs="1" />
451 <xs:element ref="Payload" />
452 <xs:element ref="PayloadGroupRef" />
453 <xs:any namespace="##other" processContents="lax">
454 <xs:annotation>
455 <xs:documentation>
456 Extensibility point in the WiX XML Schema. Schema extensions can register additional
457 elements at this point in the schema.
458 </xs:documentation>
459 </xs:annotation>
460 </xs:any>
461 </xs:choice>
462 <xs:attribute name="Id" type="xs:string">
463 <xs:annotation>
464 <xs:documentation>The identifier of the BootstrapperApplication element. Only required if you want to reference this element using a BootstrapperApplicationRef element.</xs:documentation>
465 </xs:annotation>
466 </xs:attribute>
467 <xs:attribute name="Name" type="xs:string">
468 <xs:annotation>
469 <xs:documentation>
470 [WIX v5 and later]
471 The relative destination path and file name for the bootstrapper application executable.
472 The default is the source file name. Use this attribute to rename the bootstrapper application executable or extract it into a subfolder.
473 At a minimum, the Name or SourceFile attribute must be specified.
474 This must be a relative path ('\foo' or 'C:\foo' is not allowed).
475 </xs:documentation>
476 </xs:annotation>
477 </xs:attribute>
478 <xs:attribute name="SourceFile" type="xs:string">
479 <xs:annotation>
480 <xs:documentation>
481 [WIX v5 and later]
482 The path to the bootstrapper application executable.
483 If not provided, will use the Name attribute value.
484 At a minimum, the SourceFile or Name attribute must be specified.
485 </xs:documentation>
486 </xs:annotation>
487 </xs:attribute>
488 <xs:attribute name="Secondary" type="YesNoTypeUnion">
489 <xs:annotation>
490 <xs:documentation>
491 [WIX v5 and later]
492 Indicates whether the bootstrapper application is the secondary or fallback.
493 This bootstrapper application will only run if the primary bootstrapper application returns a non-zero exit code.
494 </xs:documentation>
495 </xs:annotation>
496 </xs:attribute>
497 <xs:anyAttribute namespace="##other" processContents="lax">
498 <xs:annotation>
499 <xs:documentation>
500 Extensibility point in the WiX XML Schema. Schema extensions can register additional
501 attributes at this point in the schema.
502 </xs:documentation>
503 </xs:annotation>
504 </xs:anyAttribute>
505 </xs:complexType>
506 </xs:element>
507 <xs:element name="BootstrapperApplicationRef">
508 <xs:annotation>
509 <xs:documentation>Used to reference a BootstrapperApplication element and optionally add additional payloads to the bootstrapper application.</xs:documentation>
510 </xs:annotation>
511 <xs:complexType>
512 <xs:choice minOccurs="0" maxOccurs="unbounded">
513 <xs:element ref="Payload" />
514 <xs:element ref="PayloadGroupRef" />
515 <xs:any namespace="##other" processContents="lax">
516 <xs:annotation>
517 <xs:documentation>
518 Extensibility point in the WiX XML Schema. Schema extensions can register additional
519 elements at this point in the schema.
520 </xs:documentation>
521 </xs:annotation>
522 </xs:any>
523 </xs:choice>
524 <xs:attribute name="Id" type="xs:string" use="required">
525 <xs:annotation>
526 <xs:documentation>The identifier of the BootstrapperApplication element to reference.</xs:documentation>
527 </xs:annotation>
528 </xs:attribute>
529 <xs:anyAttribute namespace="##other" processContents="lax">
530 <xs:annotation>
531 <xs:documentation>
532 Extensibility point in the WiX XML Schema. Schema extensions can register additional
533 attributes at this point in the schema.
534 </xs:documentation>
535 </xs:annotation>
536 </xs:anyAttribute>
537 </xs:complexType>
538 </xs:element>
539 <xs:element name="BundleCustomData">
540 <xs:annotation>
541 <xs:documentation>Defines a custom XML element for use in a bundle data manifest.</xs:documentation>
542 </xs:annotation>
543 <xs:complexType>
544 <xs:choice minOccurs="0" maxOccurs="unbounded">
545 <xs:element ref="BundleAttributeDefinition">
546 <xs:annotation>
547 <xs:documentation>Attribute definition for BundleCustomData. There must be at least one defined.</xs:documentation>
548 </xs:annotation>
549 </xs:element>
550 <xs:element ref="BundleElement">
551 <xs:annotation>
552 <xs:documentation>Instance data for BundleCustomData.</xs:documentation>
553 </xs:annotation>
554 </xs:element>
555 </xs:choice>
556 <xs:attribute name="Id" type="xs:string" use="required">
557 <xs:annotation>
558 <xs:documentation>
559 Identifier for the custom table.
560 Also used as the name of the XML element.
561 </xs:documentation>
562 </xs:annotation>
563 </xs:attribute>
564 <xs:attribute name="Type">
565 <xs:annotation>
566 <xs:documentation>
567 Indicates the custom data is transformed into the bootstrapper application data manifest or the bundle extension data manifest.
568 Defaults to BootstrapperExtension if ExtensionId is specified, otherwise BootstrapperApplication.
569 </xs:documentation>
570 </xs:annotation>
571 <xs:simpleType>
572 <xs:restriction base="xs:NMTOKEN">
573 <xs:enumeration value="BootstrapperApplication" />
574 <xs:enumeration value="BootstrapperExtension" />
575 <xs:enumeration value="BundleExtension" />
576 </xs:restriction>
577 </xs:simpleType>
578 </xs:attribute>
579 <xs:attribute name="ExtensionId" type="xs:string">
580 <xs:annotation>
581 <xs:documentation>
582 Identifier for the bootstrapper extension.
583 Required when Type is BootstrapperExtension, must not be specified otherwise.
584 </xs:documentation>
585 </xs:annotation>
586 </xs:attribute>
587 </xs:complexType>
588 </xs:element>
589 <xs:element name="BundleAttributeDefinition">
590 <xs:annotation>
591 <xs:documentation>Attribute definition for BundleCustomData.</xs:documentation>
592 </xs:annotation>
593 <xs:complexType>
594 <xs:attribute name="Id" type="xs:string" use="required">
595 <xs:annotation>
596 <xs:documentation>The name of the attribute.</xs:documentation>
597 </xs:annotation>
598 </xs:attribute>
599 </xs:complexType>
600 </xs:element>
601 <xs:element name="BundleElement">
602 <xs:annotation>
603 <xs:documentation>Instance data for BundleCustomData.</xs:documentation>
604 </xs:annotation>
605 <xs:complexType>
606 <xs:sequence>
607 <xs:element ref="BundleAttribute" maxOccurs="unbounded" />
608 </xs:sequence>
609 </xs:complexType>
610 </xs:element>
611 <xs:element name="BundleAttribute">
612 <xs:annotation>
613 <xs:documentation>Used for BundleCustomData. Specifies a BundleAttributeDefinition and its value for the parent BundleElement.</xs:documentation>
614 </xs:annotation>
615 <xs:complexType>
616 <xs:attribute name="Id" type="xs:string" use="required">
617 <xs:annotation>
618 <xs:documentation>Specifies the BundleAttributeDefinition associated with this value.</xs:documentation>
619 </xs:annotation>
620 </xs:attribute>
621 <xs:attribute name="Value" type="xs:string">
622 <xs:annotation>
623 <xs:documentation>An attribute's value.</xs:documentation>
624 </xs:annotation>
625 </xs:attribute>
626 </xs:complexType>
627 </xs:element>
628 <xs:element name="BundleCustomDataRef">
629 <xs:annotation>
630 <xs:documentation>Used to reference a BundleCustomData element and optionally add more data.</xs:documentation>
631 </xs:annotation>
632 <xs:complexType>
633 <xs:choice minOccurs="0" maxOccurs="unbounded">
634 <xs:element ref="BundleElement">
635 <xs:annotation>
636 <xs:documentation>Instance data for BundleCustomData.</xs:documentation>
637 </xs:annotation>
638 </xs:element>
639 </xs:choice>
640 <xs:attribute name="Id" type="xs:string" use="required">
641 <xs:annotation>
642 <xs:documentation>
643 The identifier of the BundleCustomData element to reference.
644 </xs:documentation>
645 </xs:annotation>
646 </xs:attribute>
647 </xs:complexType>
648 </xs:element>
649 <xs:element name="BootstrapperExtension">
650 <xs:annotation>
651 <xs:documentation>[WIX v5] An extension to the Burn engine. Currently requires a WiX compiler extension to do anything useful.</xs:documentation>
652 </xs:annotation>
653 <xs:complexType>
654 <xs:choice minOccurs="0" maxOccurs="unbounded">
655 <xs:element ref="Payload" />
656 <xs:element ref="PayloadGroupRef" />
657 <xs:any namespace="##other" processContents="lax">
658 <xs:annotation>
659 <xs:documentation>
660 Extensibility point in the WiX XML Schema. Schema extensions can register additional
661 elements at this point in the schema.
662 </xs:documentation>
663 </xs:annotation>
664 </xs:any>
665 </xs:choice>
666 <xs:attribute name="Id" type="xs:string">
667 <xs:annotation>
668 <xs:documentation>The identifier of the BootstrapperExtension element. Only required if you want to reference this element using a BootstrapperExtensionRef element.</xs:documentation>
669 </xs:annotation>
670 </xs:attribute>
671 <xs:attribute name="Name" type="xs:string">
672 <xs:annotation>
673 <xs:documentation>
674 The relative destination path and file name for the bundle extension DLL.
675 The default is the source file name. Use this attribute to rename the bundle extension DLL or extract it into a subfolder.
676 At a minimum, the Name or SourceFile attribute must be specified.
677 This must be a relative path ('\foo' or 'C:\foo' is not allowed).
678 </xs:documentation>
679 </xs:annotation>
680 </xs:attribute>
681 <xs:attribute name="SourceFile" type="xs:string">
682 <xs:annotation>
683 <xs:documentation>
684 The DLL with the bundle extension entry function.
685 The default value is the Name attribute, if provided.
686 At a minimum, the SourceFile or Name attribute must be specified.
687 </xs:documentation>
688 </xs:annotation>
689 </xs:attribute>
690 </xs:complexType>
691 </xs:element>
692 <xs:element name="BootstrapperExtensionRef">
693 <xs:annotation>
694 <xs:appinfo>
695 <xse:seeAlso ref="BootstrapperExtension" />
696 </xs:appinfo>
697 <xs:documentation>[WiX v5] Used to reference a BootstrapperExtension element.</xs:documentation>
698 </xs:annotation>
699 <xs:complexType>
700 <xs:choice minOccurs="0" maxOccurs="unbounded">
701 <xs:any namespace="##other" processContents="lax">
702 <xs:annotation>
703 <xs:documentation>
704 Extensibility point in the WiX XML Schema. Schema extensions can register additional
705 elements at this point in the schema.
706 </xs:documentation>
707 </xs:annotation>
708 </xs:any>
709 </xs:choice>
710 <xs:attribute name="Id" type="xs:string" use="required">
711 <xs:annotation>
712 <xs:documentation>The identifier of the BootstrapperExtension element to reference.</xs:documentation>
713 </xs:annotation>
714 </xs:attribute>
715 <xs:anyAttribute namespace="##other" processContents="lax">
716 <xs:annotation>
717 <xs:documentation>
718 Extensibility point in the WiX XML Schema. Schema extensions can register additional
719 attributes at this point in the schema.
720 </xs:documentation>
721 </xs:annotation>
722 </xs:anyAttribute>
723 </xs:complexType>
724 </xs:element>
725 <xs:element name="BundleExtension">
726 <xs:annotation>
727 <xs:documentation>[WIX v4 only]An extension to the Burn engine. Currently requires a WiX compiler extension to do anything useful.</xs:documentation>
728 </xs:annotation>
729 <xs:complexType>
730 <xs:choice minOccurs="0" maxOccurs="unbounded">
731 <xs:element ref="Payload" />
732 <xs:element ref="PayloadGroupRef" />
733 <xs:any namespace="##other" processContents="lax">
734 <xs:annotation>
735 <xs:documentation>
736 Extensibility point in the WiX XML Schema. Schema extensions can register additional
737 elements at this point in the schema.
738 </xs:documentation>
739 </xs:annotation>
740 </xs:any>
741 </xs:choice>
742 <xs:attribute name="Id" type="xs:string">
743 <xs:annotation>
744 <xs:documentation>The identifier of the BundleExtension element. Only required if you want to reference this element using a BundleExtensionRef element.</xs:documentation>
745 </xs:annotation>
746 </xs:attribute>
747 <xs:attribute name="Name" type="xs:string">
748 <xs:annotation>
749 <xs:documentation>
750 The relative destination path and file name for the bundle extension DLL.
751 The default is the source file name. Use this attribute to rename the bundle extension DLL or extract it into a subfolder.
752 At a minimum, the Name or SourceFile attribute must be specified.
753 This must be a relative path ('\foo' or 'C:\foo' is not allowed).
754 </xs:documentation>
755 </xs:annotation>
756 </xs:attribute>
757 <xs:attribute name="SourceFile" type="xs:string">
758 <xs:annotation>
759 <xs:documentation>
760 The DLL with the bundle extension entry function.
761 The default value is the Name attribute, if provided.
762 At a minimum, the SourceFile or Name attribute must be specified.
763 </xs:documentation>
764 </xs:annotation>
765 </xs:attribute>
766 </xs:complexType>
767 </xs:element>
768 <xs:element name="BundleExtensionRef">
769 <xs:annotation>
770 <xs:appinfo>
771 <xse:seeAlso ref="BundleExtension" />
772 </xs:appinfo>
773 <xs:documentation>[WiX v4 only] Used to reference a BundleExtension element.</xs:documentation>
774 </xs:annotation>
775 <xs:complexType>
776 <xs:choice minOccurs="0" maxOccurs="unbounded">
777 <xs:any namespace="##other" processContents="lax">
778 <xs:annotation>
779 <xs:documentation>
780 Extensibility point in the WiX XML Schema. Schema extensions can register additional
781 elements at this point in the schema.
782 </xs:documentation>
783 </xs:annotation>
784 </xs:any>
785 </xs:choice>
786 <xs:attribute name="Id" type="xs:string" use="required">
787 <xs:annotation>
788 <xs:documentation>The identifier of the BundleExtension element to reference.</xs:documentation>
789 </xs:annotation>
790 </xs:attribute>
791 <xs:anyAttribute namespace="##other" processContents="lax">
792 <xs:annotation>
793 <xs:documentation>
794 Extensibility point in the WiX XML Schema. Schema extensions can register additional
795 attributes at this point in the schema.
796 </xs:documentation>
797 </xs:annotation>
798 </xs:anyAttribute>
799 </xs:complexType>
800 </xs:element>
801 <xs:element name="OptionalUpdateRegistration">
802 <xs:annotation>
803 <xs:documentation>Writes additional information to the Windows registry that can be used to detect the bundle.
804 This registration is intended primarily for update to an existing product.</xs:documentation>
805 <xs:appinfo>
806 <xse:remarks>
807 <html:p>The attributes are used to write the following registry values to the key:
808 <html:code>SOFTWARE\[Manufacturer]\Updates\[ProductFamily]\[Name]</html:code></html:p>
809 <html:ul>
810 <html:li>ThisVersionInstalled: Y</html:li>
811 <html:li>PackageName: &gt;bundle name&lt;</html:li>
812 <html:li>PackageVersion: &gt;bundle version&lt;</html:li>
813 <html:li>Publisher: [Manufacturer]</html:li>
814 <html:li>PublishingGroup: [Department]</html:li>
815 <html:li>ReleaseType: [Classification]</html:li>
816 <html:li>InstalledBy: [LogonUser]</html:li>
817 <html:li>InstalledDate: [Date]</html:li>
818 <html:li>InstallerName: &gt;installer name&lt;</html:li>
819 <html:li>InstallerVersion: &gt;installer version&lt;</html:li>
820 </html:ul>
821 </xse:remarks>
822 </xs:appinfo>
823 </xs:annotation>
824 <xs:complexType>
825 <xs:attribute name="Manufacturer" type="xs:string">
826 <xs:annotation>
827 <xs:documentation>The name of the manufacturer. The default is the Bundle/@Manufacturer attribute,
828 but may also be a short form, ex: Acme instead of Acme Corporation.
829 An error is generated at build time if neither attribute is specified.</xs:documentation>
830 </xs:annotation>
831 </xs:attribute>
832 <xs:attribute name="Department" type="xs:string">
833 <xs:annotation>
834 <xs:documentation>The name of the department or division publishing the update bundle.
835 The PublishingGroup registry value is not written if this attribute is not specified.</xs:documentation>
836 </xs:annotation>
837 </xs:attribute>
838 <xs:attribute name="ProductFamily" type="xs:string">
839 <xs:annotation>
840 <xs:documentation>The name of the family of products being updated. The default is the Bundle/@ParentName attribute.
841 The corresponding registry key is not created if neither attribute is specified.</xs:documentation>
842 </xs:annotation>
843 </xs:attribute>
844 <xs:attribute name="Name" type="xs:string">
845 <xs:annotation>
846 <xs:documentation>The name of the bundle. The default is the Bundle/@Name attribute,
847 but may also be a short form, ex: KB12345 instead of Update to Product (KB12345).
848 An error is generated at build time if neither attribute is specified.</xs:documentation>
849 </xs:annotation>
850 </xs:attribute>
851 <xs:attribute name="Classification" type="xs:string" default="Update">
852 <xs:annotation>
853 <xs:documentation>The release type of the update bundle, such as Update, Security Update, Service Pack, etc.
854 The default value is Update.</xs:documentation>
855 </xs:annotation>
856 </xs:attribute>
857 </xs:complexType>
858 </xs:element>
859 <xs:element name="Chain">
860 <xs:annotation>
861 <xs:documentation>Contains the chain of packages to install.</xs:documentation>
862 <xs:appinfo>
863 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Bundle" />
864 </xs:appinfo>
865 </xs:annotation>
866 <xs:complexType>
867 <xs:choice minOccurs="0" maxOccurs="unbounded">
868 <xs:element ref="MsiPackage" />
869 <xs:element ref="MspPackage" />
870 <xs:element ref="MsuPackage" />
871 <xs:element ref="ExePackage" />
872 <xs:element ref="BundlePackage" />
873 <xs:element ref="RollbackBoundary" />
874 <xs:element ref="PackageGroupRef" />
875 </xs:choice>
876 <xs:attribute name="DisableRollback" type="YesNoTypeUnion">
877 <xs:annotation>
878 <xs:documentation>
879 Specifies whether the bundle will attempt to roll back packages
880 executed in the chain. If "yes" is specified then when a vital
881 package fails to install only that package will roll back and the
882 chain will stop with the error. The default is "no" which
883 indicates all packages executed during the chain will be
884 rolledback to their previous state when a vital package fails.
885 </xs:documentation>
886 </xs:annotation>
887 </xs:attribute>
888 <xs:attribute name="DisableSystemRestore" type="YesNoTypeUnion">
889 <xs:annotation>
890 <xs:documentation>
891 Specifies whether the bundle will attempt to create a system
892 restore point when executing the chain. If "yes" is specified then
893 a system restore point will not be created. The default is "no" which
894 indicates a system restore point will be created when the bundle is
895 installed, uninstalled, repaired, modified, etc. If the system restore
896 point cannot be created, the bundle will log the issue and continue.
897 </xs:documentation>
898 </xs:annotation>
899 </xs:attribute>
900 <xs:attribute name="ParallelCache" type="YesNoTypeUnion">
901 <xs:annotation>
902 <xs:documentation>
903 Specifies whether the bundle will start installing packages
904 while other packages are still being cached. If "yes",
905 packages will start executing when a rollback boundary is
906 encountered. The default is "no" which dictates all packages
907 must be cached before any packages will start to be installed.
908 </xs:documentation>
909 </xs:annotation>
910 </xs:attribute>
911 </xs:complexType>
912 </xs:element>
913 <xs:element name="MsiPackage">
914 <xs:annotation>
915 <xs:documentation>Describes a single msi package to install.</xs:documentation>
916 </xs:annotation>
917 <xs:complexType>
918 <xs:choice minOccurs="0" maxOccurs="unbounded">
919 <xs:element ref="MsiProperty" />
920 <xs:element ref="SlipstreamMsp" />
921 <xs:element ref="Payload" />
922 <xs:element ref="PayloadGroupRef" />
923 <xs:element ref="MsiPackagePayload" />
924 <xs:element ref="Provides" />
925 <xs:any namespace="##other" processContents="lax">
926 <xs:annotation>
927 <xs:documentation>
928 Extensibility point in the WiX XML Schema. Schema extensions can register additional
929 elements at this point in the schema. The extension's
930 <html:code>CompilerExtension.ParseElement()</html:code>
931 method will be called with the package identifier as the first value in
932 <html:code>contextValues</html:code>.
933 </xs:documentation>
934 </xs:annotation>
935 </xs:any>
936 </xs:choice>
937 <xs:attributeGroup ref="ChainPackageCommonAttributes" />
938 <xs:attributeGroup ref="ChainPackagePermanentAttribute" />
939 <xs:attribute name="RepairCondition" type="xs:string">
940 <xs:annotation>
941 <xs:documentation>
942 A condition that determines during Repair if the package will be repaired by default.
943 This condition can use built-in variables and variables returned by searches.
944 </xs:documentation>
945 </xs:annotation>
946 </xs:attribute>
947 <xs:attribute name="EnableFeatureSelection" type="YesNoTypeUnion">
948 <xs:annotation>
949 <xs:documentation>
950 Specifies whether the bundle will allow individual control over the installation state of Features inside
951 the msi package. Managing feature selection requires special care to ensure the install, modify, update and
952 uninstall behavior of the package is always correct. The default is "no".
953 </xs:documentation>
954 </xs:annotation>
955 </xs:attribute>
956 <xs:attribute name="ForcePerMachine" type="YesNoTypeUnion">
957 <xs:annotation>
958 <xs:documentation>
959 Override the automatic per-machine detection of MSI packages and force the package to be per-machine.
960 The default is "no", which allows the tools to detect the expected value.
961 </xs:documentation>
962 </xs:annotation>
963 </xs:attribute>
964 <xs:attribute name="Visible" type="YesNoTypeUnion">
965 <xs:annotation>
966 <xs:documentation>
967 Specifies whether the MSI will be displayed in Programs and Features (also known as Add/Remove Programs). If "yes" is
968 specified the MSI package information will be displayed in Programs and Features. The default "no" indicates the MSI
969 will not be displayed.
970 </xs:documentation>
971 </xs:annotation>
972 </xs:attribute>
973 </xs:complexType>
974 </xs:element>
975 <xs:element name="MspPackage">
976 <xs:annotation>
977 <xs:documentation>Describes a single msp package to install.</xs:documentation>
978 <xs:appinfo>
979 <xse:seeAlso ref="SlipstreamMsp" />
980 </xs:appinfo>
981 </xs:annotation>
982 <xs:complexType>
983 <xs:choice minOccurs="0" maxOccurs="unbounded">
984 <xs:element ref="MsiProperty" />
985 <xs:element ref="Payload" />
986 <xs:element ref="PayloadGroupRef" />
987 <xs:element ref="MspPackagePayload" />
988 <xs:element ref="Provides" />
989 <xs:any namespace="##other" processContents="lax">
990 <xs:annotation>
991 <xs:documentation>
992 Extensibility point in the WiX XML Schema. Schema extensions can register additional
993 elements at this point in the schema. The extension's
994 <html:code>CompilerExtension.ParseElement()</html:code>
995 method will be called with the package identifier as the first value in
996 <html:code>contextValues</html:code>.
997 </xs:documentation>
998 </xs:annotation>
999 </xs:any>
1000 </xs:choice>
1001 <xs:attributeGroup ref="ChainPackageCommonAttributes" />
1002 <xs:attributeGroup ref="ChainPackagePermanentAttribute" />
1003 <xs:attribute name="RepairCondition" type="xs:string">
1004 <xs:annotation>
1005 <xs:documentation>
1006 A condition that determines during Repair if the package will be repaired by default.
1007 This condition can use built-in variables and variables returned by searches.
1008 </xs:documentation>
1009 </xs:annotation>
1010 </xs:attribute>
1011 <xs:attribute name="PerMachine" type="YesNoDefaultTypeUnion">
1012 <xs:annotation>
1013 <xs:documentation>Indicates the package must be executed elevated. The default is "no".</xs:documentation>
1014 </xs:annotation>
1015 </xs:attribute>
1016 <xs:attribute name="Slipstream" type="YesNoTypeUnion">
1017 <xs:annotation>
1018 <xs:documentation>
1019 Specifies whether to automatically slipstream the patch for any target msi packages in the chain. The default is "no".
1020 Even when the value is "no", you can still author the SlipstreamMsp element under MsiPackage elements as desired.
1021 </xs:documentation>
1022 </xs:annotation>
1023 </xs:attribute>
1024 </xs:complexType>
1025 </xs:element>
1026 <xs:element name="MsuPackage">
1027 <xs:annotation>
1028 <xs:documentation>Describes a single msu package to install.</xs:documentation>
1029 </xs:annotation>
1030 <xs:complexType>
1031 <xs:choice minOccurs="0" maxOccurs="unbounded">
1032 <xs:element ref="Payload" />
1033 <xs:element ref="PayloadGroupRef" />
1034 <xs:element ref="MsuPackagePayload" />
1035 <xs:element ref="Provides" />
1036 <xs:any namespace="##other" processContents="lax">
1037 <xs:annotation>
1038 <xs:documentation>
1039 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1040 elements at this point in the schema. The extension's
1041 <html:code>CompilerExtension.ParseElement()</html:code>
1042 method will be called with the package identifier as the first value in
1043 <html:code>contextValues</html:code>.
1044 </xs:documentation>
1045 </xs:annotation>
1046 </xs:any>
1047 </xs:choice>
1048 <xs:attributeGroup ref="ChainPackageCommonAttributes" />
1049 <xs:attribute name="DetectCondition" type="xs:string">
1050 <xs:annotation>
1051 <xs:documentation>
1052 A condition that determines if the package is present on the target system. This condition can use built-in
1053 variables and variables returned by searches. This condition is necessary because Windows doesn't provide a
1054 method to detect the presence of an MsuPackage. Burn uses this condition to determine how to treat this
1055 package during a bundle action; for example, if this condition is false or omitted and the bundle is being
1056 installed, Burn will install this package.
1057 </xs:documentation>
1058 </xs:annotation>
1059 </xs:attribute>
1060 </xs:complexType>
1061 </xs:element>
1062 <xs:element name="ExePackage">
1063 <xs:annotation>
1064 <xs:documentation>Describes a single exe package to install.</xs:documentation>
1065 </xs:annotation>
1066 <xs:complexType>
1067 <xs:choice minOccurs="0" maxOccurs="unbounded">
1068 <xs:element ref="Payload" />
1069 <xs:element ref="PayloadGroupRef" />
1070 <xs:element ref="ExePackagePayload" />
1071 <xs:element ref="ExitCode" />
1072 <xs:element ref="CommandLine" />
1073 <xs:element ref="ArpEntry" />
1074 <xs:element ref="Provides" />
1075 <xs:any namespace="##other" processContents="lax">
1076 <xs:annotation>
1077 <xs:documentation>
1078 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1079 elements at this point in the schema. The extension's
1080 <html:code>CompilerExtension.ParseElement()</html:code>
1081 method will be called with the package identifier as the first value in
1082 <html:code>contextValues</html:code>.
1083 </xs:documentation>
1084 </xs:annotation>
1085 </xs:any>
1086 </xs:choice>
1087 <xs:attributeGroup ref="ChainPackageCommonAttributes" />
1088 <xs:attributeGroup ref="ChainPackagePermanentAttribute" />
1089 <xs:attribute name="DetectCondition" type="xs:string">
1090 <xs:annotation>
1091 <xs:documentation>
1092 A condition that determines if the package is present on the target system. This condition can use built-in
1093 variables and variables returned by searches. This condition is necessary because Windows doesn't provide a
1094 method to detect the presence of an ExePackage. Burn uses this condition to determine how to treat this
1095 package during a bundle action; for example, if this condition is false or omitted and the bundle is being
1096 installed, Burn will install this package.
1097 </xs:documentation>
1098 </xs:annotation>
1099 </xs:attribute>
1100 <xs:attribute name="RepairCondition" type="xs:string">
1101 <xs:annotation>
1102 <xs:documentation>
1103 A condition that determines during Repair if the package will be repaired by default.
1104 This condition can use built-in variables and variables returned by searches.
1105 This attribute may only be specified if RepairArguments is also specified.
1106 </xs:documentation>
1107 </xs:annotation>
1108 </xs:attribute>
1109 <xs:attribute name="InstallArguments" type="xs:string">
1110 <xs:annotation>
1111 <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>
1112 </xs:annotation>
1113 </xs:attribute>
1114 <xs:attribute name="RepairArguments" type="xs:string">
1115 <xs:annotation>
1116 <xs:documentation>
1117 The command-line arguments to specify to indicate a repair. If the executable package can be repaired but
1118 does not require any special command-line arguments to do so then set the attribute's value to blank. To
1119 indicate that the package does not support repair, omit this attribute.
1120 </xs:documentation>
1121 </xs:annotation>
1122 </xs:attribute>
1123 <xs:attribute name="UninstallArguments" type="xs:string">
1124 <xs:annotation>
1125 <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>
1126 </xs:annotation>
1127 </xs:attribute>
1128 <xs:attribute name="PerMachine" type="YesNoDefaultTypeUnion">
1129 <xs:annotation>
1130 <xs:documentation>Indicates the package must be executed elevated. The default is "no".</xs:documentation>
1131 </xs:annotation>
1132 </xs:attribute>
1133 <xs:attribute name="Bundle" type="YesNoTypeUnion">
1134 <xs:annotation>
1135 <xs:documentation>
1136 Indicates the package is a WiX bundle. The default is "no".
1137 If "yes", then the default Protocol value is "burn".
1138 The engine will prepend command line arguments such as "-norestart" for all operations,
1139 as well as avoid running this bundle as a related bundle.
1140 </xs:documentation>
1141 </xs:annotation>
1142 </xs:attribute>
1143 <xs:attribute name="Protocol" type="BurnExeProtocolType">
1144 <xs:annotation>
1145 <xs:documentation>Indicates the communication protocol the package supports for extended progress and error reporting. The default is "none".</xs:documentation>
1146 </xs:annotation>
1147 </xs:attribute>
1148 </xs:complexType>
1149 </xs:element>
1150 <xs:element name="BundlePackage">
1151 <xs:annotation>
1152 <xs:documentation>Describes a single bundle package to install.</xs:documentation>
1153 </xs:annotation>
1154 <xs:complexType>
1155 <xs:choice minOccurs="0" maxOccurs="unbounded">
1156 <xs:element ref="Payload" />
1157 <xs:element ref="PayloadGroupRef" />
1158 <xs:element ref="BundlePackagePayload" />
1159 <xs:element ref="ExitCode" />
1160 <xs:element ref="CommandLine" />
1161 <xs:element ref="Provides" />
1162 <xs:any namespace="##other" processContents="lax">
1163 <xs:annotation>
1164 <xs:documentation>
1165 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1166 elements at this point in the schema. The extension's
1167 <html:code>CompilerExtension.ParseElement()</html:code>
1168 method will be called with the package identifier as the first value in
1169 <html:code>contextValues</html:code>.
1170 </xs:documentation>
1171 </xs:annotation>
1172 </xs:any>
1173 </xs:choice>
1174 <xs:attributeGroup ref="ChainPackageCommonAttributes" />
1175 <xs:attributeGroup ref="ChainPackagePermanentAttribute" />
1176 <xs:attribute name="RepairCondition" type="xs:string">
1177 <xs:annotation>
1178 <xs:documentation>
1179 A condition that determines during Repair if the package will be repaired by default.
1180 This condition can use built-in variables and variables returned by searches.
1181 </xs:documentation>
1182 </xs:annotation>
1183 </xs:attribute>
1184 <xs:attribute name="InstallArguments" type="xs:string">
1185 <xs:annotation>
1186 <xs:documentation>
1187 The command-line arguments provided to the BundlePackage during install.
1188 </xs:documentation>
1189 </xs:annotation>
1190 </xs:attribute>
1191 <xs:attribute name="RepairArguments" type="xs:string">
1192 <xs:annotation>
1193 <xs:documentation>
1194 The command-line arguments provided to the BundlePackage during repair.
1195 "/repair" is added automatically.
1196 </xs:documentation>
1197 </xs:annotation>
1198 </xs:attribute>
1199 <xs:attribute name="UninstallArguments" type="xs:string">
1200 <xs:annotation>
1201 <xs:documentation>
1202 The command-line arguments provided to the BundlePackage during uninstall.
1203 "/uninstall" is added automatically.
1204 </xs:documentation>
1205 </xs:annotation>
1206 </xs:attribute>
1207 <xs:attribute name="Visible" type="YesNoTypeUnion">
1208 <xs:annotation>
1209 <xs:documentation>
1210 Specifies whether the bundle will be displayed in Programs and Features (also known as Add/Remove Programs).
1211 If "yes" is specified the bundle package information will be displayed in Programs and Features.
1212 "no" indicates the bundle will not be displayed.
1213 If not specified, the default is the value of the Permanent attribute.
1214 </xs:documentation>
1215 </xs:annotation>
1216 </xs:attribute>
1217 </xs:complexType>
1218 </xs:element>
1219 <xs:element name="RollbackBoundary">
1220 <xs:annotation>
1221 <xs:documentation>Describes a rollback boundary in the chain.</xs:documentation>
1222 </xs:annotation>
1223 <xs:complexType>
1224 <xs:choice minOccurs="0" maxOccurs="unbounded">
1225 <xs:any namespace="##other" processContents="lax">
1226 <xs:annotation>
1227 <xs:documentation>
1228 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1229 elements at this point in the schema. The extension's
1230 <html:code>CompilerExtension.ParseElement()</html:code>
1231 method will be called with the rollback boundary identifier as the 'RollbackBoundaryId' key in
1232 <html:code>contextValues</html:code>.
1233 </xs:documentation>
1234 </xs:annotation>
1235 </xs:any>
1236 </xs:choice>
1237 <xs:attribute name="Id" type="xs:string">
1238 <xs:annotation>
1239 <xs:documentation>
1240 Identifier for this rollback boundary, for ordering and cross-referencing. If this attribute is
1241 not provided a stable identifier will be generated.
1242 </xs:documentation>
1243 </xs:annotation>
1244 </xs:attribute>
1245 <xs:attribute name="Vital" type="YesNoTypeUnion">
1246 <xs:annotation>
1247 <xs:documentation>
1248 Specifies whether the rollback boundary aborts the chain. The default "yes" indicates that if
1249 the rollback boundary is encountered then the chain will fail and roll back or stop. If "no"
1250 is specified then the chain should continue successfuly at the next rollback boundary.
1251 </xs:documentation>
1252 </xs:annotation>
1253 </xs:attribute>
1254 <xs:attribute name="LogPathVariable" type="xs:string">
1255 <xs:annotation>
1256 <xs:documentation>
1257 Name of a Variable that will hold the path to the log file when the rollback boundary is a MSI package transaction.
1258 An empty value will cause the variable to not be set. The default is "WixBundleLog_[RollbackBoundaryId]".
1259 </xs:documentation>
1260 </xs:annotation>
1261 </xs:attribute>
1262 <xs:attribute name="Transaction" type="YesNoTypeUnion">
1263 <xs:annotation>
1264 <xs:documentation>
1265 Specifies whether the rollback boundary is wrapped in an MSI transaction. The default is "no".
1266 Only MsiPackages and MspPackages may be inside of a rollback boundary with Transaction set to "yes".
1267 </xs:documentation>
1268 </xs:annotation>
1269 </xs:attribute>
1270 </xs:complexType>
1271 </xs:element>
1272 <xs:attributeGroup name="ChainPackagePermanentAttribute">
1273 <xs:attribute name="Permanent" type="YesNoTypeUnion">
1274 <xs:annotation>
1275 <xs:documentation>
1276 Specifies whether the package can be uninstalled. The default is "no".
1277 </xs:documentation>
1278 </xs:annotation>
1279 </xs:attribute>
1280 </xs:attributeGroup>
1281 <xs:attributeGroup name="ChainPackageCommonAttributes">
1282 <xs:attribute name="SourceFile" type="xs:string">
1283 <xs:annotation>
1284 <xs:documentation>
1285 Location of the package to add to the bundle.
1286 The default value is the Name attribute, if provided.
1287 At a minimum, the SourceFile or Name attribute must be specified.
1288 Must not be specified if the package payload is given by the *PackagePayload element.
1289 </xs:documentation>
1290 </xs:annotation>
1291 </xs:attribute>
1292 <xs:attribute name="Name" type="xs:string">
1293 <xs:annotation>
1294 <xs:documentation>
1295 The destination path and file name for this chain payload. Use this attribute to rename the
1296 chain entry point or extract it into a subfolder. The default value is the file name from the
1297 SourceFile attribute, if provided. At a minimum, the Name or SourceFile attribute must be specified.
1298 This must be a relative path ('\foo' or 'C:\foo' is not allowed).
1299 Must not be specified if the package payload is given by the *PackagePayload element.
1300 </xs:documentation>
1301 </xs:annotation>
1302 </xs:attribute>
1303 <xs:attribute name="DownloadUrl" type="xs:string">
1304 <xs:annotation>
1305 <xs:documentation>
1306 <html:p>The URL to use to download the package. The following substitutions are supported:</html:p>
1307 <html:ul>
1308 <html:li>{0} is replaced by the package Id.</html:li>
1309 <html:li>{1} is replaced by the payload Id.</html:li>
1310 <html:li>{2} is replaced by the payload file name.</html:li>
1311 </html:ul>
1312 Must not be specified if the package payload is given by the *PackagePayload element.
1313 </xs:documentation>
1314 </xs:annotation>
1315 </xs:attribute>
1316 <xs:attribute name="Id" type="xs:string">
1317 <xs:annotation>
1318 <xs:documentation>
1319 Identifier for this package, for ordering and cross-referencing. The default is the Name attribute
1320 modified to be suitable as an identifier (i.e. invalid characters are replaced with underscores).
1321 </xs:documentation>
1322 </xs:annotation>
1323 </xs:attribute>
1324 <xs:attribute name="After" type="xs:string">
1325 <xs:annotation>
1326 <xs:documentation>
1327 The identifier of another package that this one should be installed after. By default the After
1328 attribute is set to the previous sibling package in the Chain or PackageGroup element. If this
1329 attribute is specified ensure that a cycle is not created explicitly or implicitly.
1330 </xs:documentation>
1331 </xs:annotation>
1332 </xs:attribute>
1333 <xs:attribute name="InstallSize" type="xs:string">
1334 <xs:annotation>
1335 <xs:documentation>
1336 The size this package will take on disk in bytes after it is installed. By default, the binder will
1337 calculate the install size by scanning the package (File table for MSIs, Payloads for EXEs)
1338 and use the total for the install size of the package.
1339 </xs:documentation>
1340 </xs:annotation>
1341 </xs:attribute>
1342 <xs:attribute name="InstallCondition" type="xs:string">
1343 <xs:annotation>
1344 <xs:documentation>
1345 A condition to evaluate before installing the package. The package will only be installed if the condition
1346 evaluates to true. If the condition evaluates to false and the bundle is being installed, repaired, or modified,
1347 the package will be uninstalled.
1348 </xs:documentation>
1349 </xs:annotation>
1350 </xs:attribute>
1351 <xs:attribute name="Cache" type="KeepRemoveForceTypeUnion">
1352 <xs:annotation>
1353 <xs:documentation>Whether to cache the package. The default is "keep".</xs:documentation>
1354 </xs:annotation>
1355 </xs:attribute>
1356 <xs:attribute name="CacheId" type="xs:string">
1357 <xs:annotation>
1358 <xs:documentation>The identifier to use when caching the package.</xs:documentation>
1359 </xs:annotation>
1360 </xs:attribute>
1361 <xs:attribute name="DisplayName" type="xs:string">
1362 <xs:annotation>
1363 <xs:documentation>
1364 Specifies the display name to place in the bootstrapper application data manifest for the package. By default, ExePackages
1365 use the ProductName field from the version information, MsiPackages use the ProductName property, and MspPackages use
1366 the DisplayName patch metadata property. Other package types must use this attribute to define a display name in the
1367 bootstrapper application data manifest.
1368 </xs:documentation>
1369 </xs:annotation>
1370 </xs:attribute>
1371 <xs:attribute name="Description" type="xs:string">
1372 <xs:annotation>
1373 <xs:documentation>
1374 Specifies the description to place in the bootstrapper application data manifest for the package. By default, ExePackages
1375 use the FileName field from the version information, MsiPackages use the ARPCOMMENTS property, and MspPackages use
1376 the Description patch metadata property. Other package types must use this attribute to define a description in the
1377 bootstrapper application data manifest.
1378 </xs:documentation>
1379 </xs:annotation>
1380 </xs:attribute>
1381 <xs:attribute name="LogPathVariable" type="xs:string">
1382 <xs:annotation>
1383 <xs:documentation>
1384 Name of a Variable that will hold the path to the log file. An empty value will cause the variable to not
1385 be set. The default is "WixBundleLog_[PackageId]" except for MSU packages which default to no logging.
1386 </xs:documentation>
1387 </xs:annotation>
1388 </xs:attribute>
1389 <xs:attribute name="RollbackLogPathVariable" type="xs:string">
1390 <xs:annotation>
1391 <xs:documentation>
1392 Name of a Variable that will hold the path to the log file used during rollback. An empty value will cause
1393 the variable to not be set. The default is "WixBundleRollbackLog_[PackageId]" except for MSU packages which
1394 default to no logging.
1395 </xs:documentation>
1396 </xs:annotation>
1397 </xs:attribute>
1398 <xs:attribute name="Vital" type="YesNoTypeUnion">
1399 <xs:annotation>
1400 <xs:documentation>
1401 Specifies whether the package must succeed for the chain to continue. The default "yes"
1402 indicates that if the package fails then the chain will fail and roll back or stop. If
1403 "no" is specified then the chain will continue even if the package reports failure.
1404 </xs:documentation>
1405 </xs:annotation>
1406 </xs:attribute>
1407 <xs:attribute name="Compressed" type="YesNoDefaultTypeUnion">
1408 <xs:annotation>
1409 <xs:documentation>
1410 Whether the package payload should be embedded in a container or left as an external payload.
1411 Must not be specified if the package payload is given by the *PackagePayload element.
1412 </xs:documentation>
1413 </xs:annotation>
1414 </xs:attribute>
1415 <xs:anyAttribute namespace="##other" processContents="lax">
1416 <xs:annotation>
1417 <xs:documentation>
1418 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1419 attributes at this point in the schema. The extension's
1420 <html:code>CompilerExtension.ParseAttribute()</html:code>
1421 method will be called with the package identifier in
1422 <html:code>contextValues["PackageId"]</html:code>.
1423 </xs:documentation>
1424 </xs:annotation>
1425 </xs:anyAttribute>
1426 </xs:attributeGroup>
1427 <xs:element name="PackageGroup">
1428 <xs:annotation>
1429 <xs:documentation>Describes a package group to a bootstrapper.</xs:documentation>
1430 <xs:appinfo>
1431 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
1432 </xs:appinfo>
1433 </xs:annotation>
1434 <xs:complexType>
1435 <xs:choice minOccurs="0" maxOccurs="unbounded">
1436 <xs:element ref="MsiPackage" />
1437 <xs:element ref="MspPackage" />
1438 <xs:element ref="MsuPackage" />
1439 <xs:element ref="ExePackage" />
1440 <xs:element ref="BundlePackage" />
1441 <xs:element ref="RollbackBoundary" />
1442 <xs:element ref="PackageGroupRef" />
1443 </xs:choice>
1444 <xs:attribute name="Id" type="xs:string" use="required">
1445 <xs:annotation>
1446 <xs:documentation>Identifier for package group.</xs:documentation>
1447 </xs:annotation>
1448 </xs:attribute>
1449 </xs:complexType>
1450 </xs:element>
1451 <xs:element name="PackageGroupRef">
1452 <xs:annotation>
1453 <xs:documentation>Create a reference to PackageGroup element that exists inside a Bundle or Fragment element.</xs:documentation>
1454 <xs:appinfo>
1455 <xse:seeAlso ref="PackageGroup" />
1456 </xs:appinfo>
1457 </xs:annotation>
1458 <xs:complexType>
1459 <xs:attribute name="Id" type="xs:string" use="required">
1460 <xs:annotation>
1461 <xs:documentation>The identifier of the PackageGroup element to reference.</xs:documentation>
1462 </xs:annotation>
1463 </xs:attribute>
1464 <xs:attribute name="After" type="xs:string">
1465 <xs:annotation>
1466 <xs:documentation>The identifier of a package that this group should be installed after.</xs:documentation>
1467 </xs:annotation>
1468 </xs:attribute>
1469 </xs:complexType>
1470 </xs:element>
1471 <xs:element name="MsiProperty">
1472 <xs:annotation>
1473 <xs:documentation>Allows an MSI property to be set based on the value of a burn engine expression.</xs:documentation>
1474 <xs:appinfo>
1475 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="MsiPackage" />
1476 </xs:appinfo>
1477 </xs:annotation>
1478 <xs:complexType>
1479 <xs:attribute name="Name" type="xs:string" use="required">
1480 <xs:annotation>
1481 <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>
1482 </xs:annotation>
1483 </xs:attribute>
1484 <xs:attribute name="Value" type="xs:string" use="required">
1485 <xs:annotation>
1486 <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>
1487 </xs:annotation>
1488 </xs:attribute>
1489 <xs:attribute name="Condition" type="xs:string">
1490 <xs:annotation>
1491 <xs:documentation>Condition to determine whether to pass the MSI Property. If this evaluates to false, the MSI Property is not passed along.</xs:documentation>
1492 </xs:annotation>
1493 </xs:attribute>
1494 </xs:complexType>
1495 </xs:element>
1496 <xs:element name="SlipstreamMsp">
1497 <xs:annotation>
1498 <xs:documentation>Specifies a patch included in the same bundle that is installed when the parent MSI package is installed.</xs:documentation>
1499 <xs:appinfo>
1500 <xse:seeAlso ref="MspPackage" />
1501 <xse:remarks>
1502 <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>
1503 </xse:remarks>
1504 </xs:appinfo>
1505 </xs:annotation>
1506 <xs:complexType>
1507 <xs:attribute name="Id" type="xs:string" use="required">
1508 <xs:annotation>
1509 <xs:documentation>The identifier for a MspPackage in the bundle.</xs:documentation>
1510 </xs:annotation>
1511 </xs:attribute>
1512 </xs:complexType>
1513 </xs:element>
1514 <xs:element name="Variable">
1515 <xs:annotation>
1516 <xs:documentation>Describes a burn engine variable to define.</xs:documentation>
1517 </xs:annotation>
1518 <xs:complexType>
1519 <xs:attribute name="Hidden" type="YesNoTypeUnion">
1520 <xs:annotation>
1521 <xs:documentation>Whether the value of the variable should be hidden.</xs:documentation>
1522 </xs:annotation>
1523 </xs:attribute>
1524 <xs:attribute name="Name" type="xs:string" use="required">
1525 <xs:annotation>
1526 <xs:documentation>The name for the variable.</xs:documentation>
1527 </xs:annotation>
1528 </xs:attribute>
1529 <xs:attribute name="Persisted" type="YesNoTypeUnion">
1530 <xs:annotation>
1531 <xs:documentation>Whether the variable should be persisted.</xs:documentation>
1532 </xs:annotation>
1533 </xs:attribute>
1534 <xs:attribute name="Value" type="xs:string">
1535 <xs:annotation>
1536 <xs:documentation>Starting value for the variable.</xs:documentation>
1537 </xs:annotation>
1538 </xs:attribute>
1539 <xs:attribute name="Type" type="VariableType">
1540 <xs:annotation>
1541 <xs:documentation>Type of the variable, inferred from the value if not specified.</xs:documentation>
1542 </xs:annotation>
1543 </xs:attribute>
1544 <xs:anyAttribute namespace="##other" processContents="lax">
1545 <xs:annotation>
1546 <xs:documentation>
1547 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1548 attributes at this point in the schema.
1549 </xs:documentation>
1550 </xs:annotation>
1551 </xs:anyAttribute>
1552 </xs:complexType>
1553 </xs:element>
1554 <xs:attributeGroup name="SearchCommonAttributes">
1555 <xs:attribute name="Id" type="xs:string">
1556 <xs:annotation>
1557 <xs:documentation>Id of the search for ordering and dependency.</xs:documentation>
1558 </xs:annotation>
1559 </xs:attribute>
1560 <xs:attribute name="Variable" type="xs:string" use="required">
1561 <xs:annotation>
1562 <xs:documentation>Name of the variable in which to place the result of the search.</xs:documentation>
1563 </xs:annotation>
1564 </xs:attribute>
1565 <xs:attribute name="Condition" type="xs:string">
1566 <xs:annotation>
1567 <xs:documentation>Condition for evaluating the search. If this evaluates to false, the search is not executed at all.</xs:documentation>
1568 </xs:annotation>
1569 </xs:attribute>
1570 <xs:attribute name="After" type="xs:string">
1571 <xs:annotation>
1572 <xs:documentation>Id of the search that this one should come after.</xs:documentation>
1573 </xs:annotation>
1574 </xs:attribute>
1575 </xs:attributeGroup>
1576 <xs:element name="SetVariable">
1577 <xs:annotation>
1578 <xs:documentation>Schedules a "search" that sets a variable to the given value.</xs:documentation>
1579 </xs:annotation>
1580 <xs:complexType>
1581 <xs:attributeGroup ref="SearchCommonAttributes" />
1582 <xs:attribute name="Value" type="xs:string">
1583 <xs:annotation>
1584 <xs:documentation>
1585 New value for the variable. This string gets formatted, then converted to the specified type, then assigned to the variable.
1586 Leaving Value and Type unspecified will clear the variable.
1587 </xs:documentation>
1588 </xs:annotation>
1589 </xs:attribute>
1590 <xs:attribute name="Type" type="VariableType">
1591 <xs:annotation>
1592 <xs:documentation>Type of the variable, inferred from the value if not specified.</xs:documentation>
1593 </xs:annotation>
1594 </xs:attribute>
1595 <xs:anyAttribute namespace="##other" processContents="lax">
1596 <xs:annotation>
1597 <xs:documentation>
1598 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1599 attributes at this point in the schema.
1600 </xs:documentation>
1601 </xs:annotation>
1602 </xs:anyAttribute>
1603 </xs:complexType>
1604 </xs:element>
1605 <xs:element name="SetVariableRef">
1606 <xs:annotation>
1607 <xs:appinfo>
1608 <xse:seeAlso ref="SetVariable" />
1609 </xs:appinfo>
1610 <xs:documentation>Used to reference a SetVariable element.</xs:documentation>
1611 </xs:annotation>
1612 <xs:complexType>
1613 <xs:choice minOccurs="0" maxOccurs="unbounded">
1614 <xs:any namespace="##other" processContents="lax">
1615 <xs:annotation>
1616 <xs:documentation>
1617 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1618 elements at this point in the schema.
1619 </xs:documentation>
1620 </xs:annotation>
1621 </xs:any>
1622 </xs:choice>
1623 <xs:attribute name="Id" type="xs:string" use="required">
1624 <xs:annotation>
1625 <xs:documentation>The identifier of the SetVariable element to reference.</xs:documentation>
1626 </xs:annotation>
1627 </xs:attribute>
1628 <xs:anyAttribute namespace="##other" processContents="lax">
1629 <xs:annotation>
1630 <xs:documentation>
1631 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1632 attributes at this point in the schema.
1633 </xs:documentation>
1634 </xs:annotation>
1635 </xs:anyAttribute>
1636 </xs:complexType>
1637 </xs:element>
1638 <xs:element name="Container">
1639 <xs:annotation>
1640 <xs:documentation>Representation of a file that contains one or more files.</xs:documentation>
1641 </xs:annotation>
1642 <xs:complexType>
1643 <xs:choice minOccurs="0" maxOccurs="unbounded">
1644 <xs:element ref="PackageGroupRef" />
1645 </xs:choice>
1646 <xs:attribute name="DownloadUrl" type="xs:string">
1647 <xs:annotation>
1648 <xs:documentation>
1649 <html:p>The URL to use to download the container. This attribute is only valid when the container is detached. The
1650 following substitutions are supported:</html:p>
1651 <html:ul>
1652 <html:li>{0} is always null.</html:li>
1653 <html:li>{1} is replaced by the container Id.</html:li>
1654 <html:li>{2} is replaced by the container file name.</html:li>
1655 </html:ul>
1656 </xs:documentation>
1657 </xs:annotation>
1658 </xs:attribute>
1659 <xs:attribute name="Id" type="xs:string">
1660 <xs:annotation>
1661 <xs:documentation>The unique identifier for the container. If this attribute is not specified the Name attribute will be used.</xs:documentation>
1662 </xs:annotation>
1663 </xs:attribute>
1664 <xs:attribute name="Name" type="xs:string">
1665 <xs:annotation>
1666 <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>
1667 </xs:annotation>
1668 </xs:attribute>
1669 <xs:attribute name="Type" type="BurnContainerType">
1670 <xs:annotation>
1671 <xs:documentation>
1672 Indicates whether the container is "attached" to the bundle executable or placed external to the bundle extecutable as "detached". If
1673 this attribute is not specified, the default is to create a detached container.
1674 </xs:documentation>
1675 </xs:annotation>
1676 </xs:attribute>
1677 </xs:complexType>
1678 </xs:element>
1679 <xs:element name="ContainerRef">
1680 <xs:annotation>
1681 <xs:documentation>Create a reference to an existing Container element.</xs:documentation>
1682 <xs:appinfo>
1683 <xse:seeAlso ref="Container" />
1684 </xs:appinfo>
1685 </xs:annotation>
1686 <xs:complexType>
1687 <xs:attribute name="Id" type="xs:string" use="required">
1688 <xs:annotation>
1689 <xs:documentation>The identifier of Container element to reference.</xs:documentation>
1690 </xs:annotation>
1691 </xs:attribute>
1692 </xs:complexType>
1693 </xs:element>
1694 <xs:element name="ArpEntry">
1695 <xs:annotation>
1696 <xs:documentation>
1697 Information about the Add/Remove Programs entry that is installed by the package.
1698 ArpEntry may not be specified with DetectCondition or UninstallArguments.
1699 </xs:documentation>
1700 </xs:annotation>
1701 <xs:complexType>
1702 <xs:attribute name="Id" type="xs:string" use="required">
1703 <xs:annotation>
1704 <xs:documentation>
1705 The id of the ARP entry.
1706 </xs:documentation>
1707 </xs:annotation>
1708 </xs:attribute>
1709 <xs:attribute name="Win64" type="YesNoTypeUnion" use="required">
1710 <xs:annotation>
1711 <xs:documentation>
1712 Whether the ARP entry is 64-bit.
1713 </xs:documentation>
1714 </xs:annotation>
1715 </xs:attribute>
1716 <xs:attribute name="Version" type="xs:string" use="required">
1717 <xs:annotation>
1718 <xs:documentation>
1719 The DisplayVersion value of the ARP entry that is installed by this package.
1720 Older or missing versions cause this package to be detected as absent.
1721 Newer versions cause this package to be detected as obsolete.
1722 </xs:documentation>
1723 </xs:annotation>
1724 </xs:attribute>
1725 <xs:attribute name="AdditionalUninstallArguments" type="xs:string">
1726 <xs:annotation>
1727 <xs:documentation>
1728 Additional arguments for the uninstall command line.
1729 </xs:documentation>
1730 </xs:annotation>
1731 </xs:attribute>
1732 <xs:attribute name="UseUninstallString" type="YesNoTypeUnion">
1733 <xs:annotation>
1734 <xs:documentation>
1735 If yes, use the `UninstallString` value instead of the default `QuietUninstallString`.
1736 </xs:documentation>
1737 </xs:annotation>
1738 </xs:attribute>
1739 </xs:complexType>
1740 </xs:element>
1741 <xs:element name="ExitCode">
1742 <xs:annotation>
1743 <xs:documentation>Describes map of exit code returned from executable package to a bootstrapper behavior.</xs:documentation>
1744 </xs:annotation>
1745 <xs:complexType>
1746 <xs:attribute name="Value" type="NegativeInteger">
1747 <xs:annotation>
1748 <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>
1749 </xs:annotation>
1750 </xs:attribute>
1751 <xs:attribute name="Behavior" use="required">
1752 <xs:annotation>
1753 <xs:documentation>Choose one of the supported behaviors error codes: success, error, scheduleReboot, forceReboot, errorScheduleReboot, errorForceReboot.</xs:documentation>
1754 </xs:annotation>
1755 <xs:simpleType>
1756 <xs:restriction base="xs:string">
1757 <xs:enumeration value="success">
1758 <xs:annotation>
1759 <xs:documentation>The process completed successfully.</xs:documentation>
1760 </xs:annotation>
1761 </xs:enumeration>
1762 <xs:enumeration value="error">
1763 <xs:annotation>
1764 <xs:documentation>The process failed.</xs:documentation>
1765 </xs:annotation>
1766 </xs:enumeration>
1767 <xs:enumeration value="scheduleReboot">
1768 <xs:annotation>
1769 <xs:documentation>The process completed successfully and requires the machine to be restarted.</xs:documentation>
1770 </xs:annotation>
1771 </xs:enumeration>
1772 <xs:enumeration value="forceReboot">
1773 <xs:annotation>
1774 <xs:documentation>The process completed successfully and initiated a restart.</xs:documentation>
1775 </xs:annotation>
1776 </xs:enumeration>
1777 <xs:enumeration value="errorScheduleReboot">
1778 <xs:annotation>
1779 <xs:documentation>The process failed and requires the machine to be restarted.</xs:documentation>
1780 </xs:annotation>
1781 </xs:enumeration>
1782 <xs:enumeration value="errorForceReboot">
1783 <xs:annotation>
1784 <xs:documentation>The process failed and initiated a restart.</xs:documentation>
1785 </xs:annotation>
1786 </xs:enumeration>
1787 </xs:restriction>
1788 </xs:simpleType>
1789 </xs:attribute>
1790 </xs:complexType>
1791 </xs:element>
1792 <xs:element name="CommandLine">
1793 <xs:annotation>
1794 <xs:documentation>Describes additional, conditional command-line arguments for an ExePackage or BundlePackage.</xs:documentation>
1795 </xs:annotation>
1796 <xs:complexType>
1797 <xs:attribute name="InstallArgument" type="xs:string">
1798 <xs:annotation>
1799 <xs:documentation>Additional command-line arguments to apply during package installation if Condition is true.</xs:documentation>
1800 </xs:annotation>
1801 </xs:attribute>
1802 <xs:attribute name="UninstallArgument" type="xs:string">
1803 <xs:annotation>
1804 <xs:documentation>Additional command-line arguments to apply during package uninstallation if Condition is true.</xs:documentation>
1805 </xs:annotation>
1806 </xs:attribute>
1807 <xs:attribute name="RepairArgument" type="xs:string">
1808 <xs:annotation>
1809 <xs:documentation>Additional command-line arguments to apply during package repair if Condition is true.</xs:documentation>
1810 </xs:annotation>
1811 </xs:attribute>
1812 <xs:attribute name="Condition" type="xs:string">
1813 <xs:annotation>
1814 <xs:documentation>
1815 The condition that controls whether the command-line arguments specified in the
1816 InstallArgument, UninstallArgument, or RepairArgument attributes are appended to the
1817 command line passed to the package. Which attribute is used depends on the
1818 action being applied to the package. For example, when the package is
1819 being installed, the InstallArgument attribute value is appended to the command
1820 line when the package is executed.
1821 </xs:documentation>
1822 </xs:annotation>
1823 </xs:attribute>
1824 </xs:complexType>
1825 </xs:element>
1826 <xs:element name="Payload">
1827 <xs:annotation>
1828 <xs:documentation>Describes a payload to a bootstrapper.</xs:documentation>
1829 </xs:annotation>
1830 <xs:complexType>
1831 <xs:attribute name="Id" type="xs:string">
1832 <xs:annotation>
1833 <xs:documentation>The identifier of Payload element.</xs:documentation>
1834 </xs:annotation>
1835 </xs:attribute>
1836 <xs:attribute name="CertificatePublicKey" type="xs:string">
1837 <xs:annotation>
1838 <xs:documentation>Optional public key of the certificate used to sign the payload. It is not recommended to use this attribute and rely on the Hash alone.</xs:documentation>
1839 </xs:annotation>
1840 </xs:attribute>
1841 <xs:attribute name="CertificateThumbprint" type="xs:string">
1842 <xs:annotation>
1843 <xs:documentation>Optional thumbprint of the certificate used to sign the payload. It is not recommended to use this attribute and rely on the Hash alone.</xs:documentation>
1844 </xs:annotation>
1845 </xs:attribute>
1846 <xs:attribute name="Compressed" type="YesNoDefaultTypeUnion">
1847 <xs:annotation>
1848 <xs:documentation>Whether the payload should be embedded in a container or left as an external payload.</xs:documentation>
1849 </xs:annotation>
1850 </xs:attribute>
1851 <xs:attribute name="Hash" type="xs:string">
1852 <xs:annotation>
1853 <xs:documentation>Optional SHA256 hash of the payload. Must be provided if the SourceFile attribute is not used.</xs:documentation>
1854 </xs:annotation>
1855 </xs:attribute>
1856 <xs:attribute name="Size" type="Integer">
1857 <xs:annotation>
1858 <xs:documentation>Optional size of the payload in bytes. Required if Hash is specified, otherwise must not be specified.</xs:documentation>
1859 </xs:annotation>
1860 </xs:attribute>
1861 <xs:attribute name="SourceFile" type="xs:string">
1862 <xs:annotation>
1863 <xs:documentation>
1864 Location of the source file.
1865 The default value is the Name attribute, if provided.
1866 At a minimum, the SourceFile or Name attribute must be specified.
1867 </xs:documentation>
1868 </xs:annotation>
1869 </xs:attribute>
1870 <xs:attribute name="Name" type="xs:string">
1871 <xs:annotation>
1872 <xs:documentation>
1873 The destination path and file name for this payload.
1874 The default is the source file name.
1875 At a minimum, the Name or SourceFile attribute must be specified.
1876 This must be a relative path ('\foo' or 'C:\foo' is not allowed).
1877 </xs:documentation>
1878 </xs:annotation>
1879 </xs:attribute>
1880 <xs:attribute name="DownloadUrl" type="xs:string">
1881 <xs:annotation>
1882 <xs:documentation>
1883 <html:p>The URL to use to download the package. The following substitutions are supported:</html:p>
1884 <html:ul>
1885 <html:li>{0} is replaced by the package Id.</html:li>
1886 <html:li>{1} is replaced by the payload Id.</html:li>
1887 <html:li>{2} is replaced by the payload file name.</html:li>
1888 </html:ul>
1889 </xs:documentation>
1890 </xs:annotation>
1891 </xs:attribute>
1892 <xs:anyAttribute namespace="##other" processContents="lax">
1893 <xs:annotation>
1894 <xs:documentation>
1895 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1896 attributes at this point in the schema.
1897 </xs:documentation>
1898 </xs:annotation>
1899 </xs:anyAttribute>
1900 </xs:complexType>
1901 </xs:element>
1902 <xs:element name="PayloadGroup">
1903 <xs:annotation>
1904 <xs:documentation>
1905 Describes a payload group to a bootstrapper. PayloadGroups referenced from within a Bundle are tied to the Bundle.
1906 PayloadGroups referenced from a Fragment are tied to the context of whatever references them such as an ExePackage or MsiPackage.
1907 It is possible to share a PayloadGroup between multiple Packages and/or a Bundle by creating multiple references to it.
1908 </xs:documentation>
1909 </xs:annotation>
1910 <xs:complexType>
1911 <xs:choice minOccurs="0" maxOccurs="unbounded">
1912 <xs:element ref="BundlePackagePayload" />
1913 <xs:element ref="ExePackagePayload" />
1914 <xs:element ref="MsiPackagePayload" />
1915 <xs:element ref="MspPackagePayload" />
1916 <xs:element ref="MsuPackagePayload" />
1917 <xs:element ref="Payload" />
1918 <xs:element ref="PayloadGroupRef" />
1919 </xs:choice>
1920 <xs:attribute name="Id" type="xs:string" use="required">
1921 <xs:annotation>
1922 <xs:documentation>Identifier for payload group.</xs:documentation>
1923 </xs:annotation>
1924 </xs:attribute>
1925 </xs:complexType>
1926 </xs:element>
1927 <xs:element name="PayloadGroupRef">
1928 <xs:annotation>
1929 <xs:documentation>Create a reference to PayloadGroup element that exists inside a Bundle or Fragment element.</xs:documentation>
1930 <xs:appinfo>
1931 <xse:seeAlso ref="PayloadGroup" />
1932 </xs:appinfo>
1933 </xs:annotation>
1934 <xs:complexType>
1935 <xs:attribute name="Id" type="xs:string" use="required">
1936 <xs:annotation>
1937 <xs:documentation>The identifier of the PayloadGroup element to reference.</xs:documentation>
1938 </xs:annotation>
1939 </xs:attribute>
1940 </xs:complexType>
1941 </xs:element>
1942 <xs:element name="BundlePackagePayload">
1943 <xs:annotation>
1944 <xs:documentation>
1945 Describes information about the BundlePackage payload.
1946 Cannot be specified if the owning BundlePackage specified any of SourceFile, Name, DownloadUrl, or Compressed.
1947 </xs:documentation>
1948 </xs:annotation>
1949 <xs:complexType>
1950 <xs:choice minOccurs="0" maxOccurs="unbounded">
1951 <xs:element ref="RemoteBundle" minOccurs="0" maxOccurs="1" />
1952 <xs:any namespace="##other" processContents="lax">
1953 <xs:annotation>
1954 <xs:documentation>
1955 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1956 elements at this point in the schema.
1957 </xs:documentation>
1958 </xs:annotation>
1959 </xs:any>
1960 </xs:choice>
1961 <xs:attribute name="PayloadGeneration">
1962 <xs:annotation>
1963 <xs:documentation>
1964 Choose one of the supported payload generation types: none, externalWithoutDownloadUrl, external, all.
1965 </xs:documentation>
1966 </xs:annotation>
1967 <xs:simpleType>
1968 <xs:restriction base="xs:string">
1969 <xs:enumeration value="none">
1970 <xs:annotation>
1971 <xs:documentation>
1972 None of the bundle's payloads or containers are automatically included as payloads for the package.
1973 </xs:documentation>
1974 </xs:annotation>
1975 </xs:enumeration>
1976 <xs:enumeration value="externalWithoutDownloadUrl">
1977 <xs:annotation>
1978 <xs:documentation>
1979 All detached containers from the bundle that have no download url are included as payloads for the package,
1980 as well as all external payloads from the bundle that have no download url.
1981 </xs:documentation>
1982 </xs:annotation>
1983 </xs:enumeration>
1984 <xs:enumeration value="external">
1985 <xs:annotation>
1986 <xs:documentation>
1987 All detached containers from the bundle are included as payloads for the package,
1988 as well as all external payloads from the bundle.
1989 </xs:documentation>
1990 </xs:annotation>
1991 </xs:enumeration>
1992 <xs:enumeration value="all">
1993 <xs:annotation>
1994 <xs:documentation>
1995 All detached containers from the bundle are included as payloads for the package,
1996 as well as all other payloads that are not compressed into the detached containers.
1997 This option normally requires extra work to use since it requires all attached containers to have been extracted.
1998 </xs:documentation>
1999 </xs:annotation>
2000 </xs:enumeration>
2001 </xs:restriction>
2002 </xs:simpleType>
2003 </xs:attribute>
2004 <xs:attributeGroup ref="ChainPackagePayloadCommonAttributes" />
2005 <xs:attributeGroup ref="RemotePackagePayloadCommonAttributes" />
2006 </xs:complexType>
2007 </xs:element>
2008 <xs:element name="ExePackagePayload">
2009 <xs:annotation>
2010 <xs:documentation>
2011 Describes information about the ExePackage payload.
2012 Cannot be specified if the owning ExePackage specified any of SourceFile, Name, DownloadUrl, or Compressed.
2013 </xs:documentation>
2014 </xs:annotation>
2015 <xs:complexType>
2016 <xs:attributeGroup ref="ChainPackagePayloadCommonAttributes" />
2017 <xs:attributeGroup ref="RemotePackagePayloadCommonAttributes" />
2018 </xs:complexType>
2019 </xs:element>
2020 <xs:element name="MsiPackagePayload">
2021 <xs:annotation>
2022 <xs:documentation>
2023 Describes information about the MsiPackage payload.
2024 Cannot be specified if the owning MsiPackage specified any of SourceFile, Name, DownloadUrl, or Compressed.
2025 </xs:documentation>
2026 </xs:annotation>
2027 <xs:complexType>
2028 <xs:attributeGroup ref="ChainPackagePayloadCommonAttributes" />
2029 <xs:attributeGroup ref="LocalPackagePayloadCommonAttributes" />
2030 </xs:complexType>
2031 </xs:element>
2032 <xs:element name="MspPackagePayload">
2033 <xs:annotation>
2034 <xs:documentation>
2035 Describes information about the MspPackage payload.
2036 Cannot be specified if the owning MspPackage specified any of SourceFile, Name, DownloadUrl, or Compressed.
2037 </xs:documentation>
2038 </xs:annotation>
2039 <xs:complexType>
2040 <xs:attributeGroup ref="ChainPackagePayloadCommonAttributes" />
2041 <xs:attributeGroup ref="LocalPackagePayloadCommonAttributes" />
2042 </xs:complexType>
2043 </xs:element>
2044 <xs:element name="MsuPackagePayload">
2045 <xs:annotation>
2046 <xs:documentation>
2047 Describes information about the MsuPackage payload.
2048 Cannot be specified if the owning MsuPackage specified any of SourceFile, Name, DownloadUrl, or Compressed.
2049 </xs:documentation>
2050 </xs:annotation>
2051 <xs:complexType>
2052 <xs:attributeGroup ref="ChainPackagePayloadCommonAttributes" />
2053 <xs:attributeGroup ref="RemotePackagePayloadCommonAttributes" />
2054 </xs:complexType>
2055 </xs:element>
2056 <xs:attributeGroup name="ChainPackagePayloadCommonAttributes">
2057 <xs:attribute name="Id" type="xs:string">
2058 <xs:annotation>
2059 <xs:documentation>The identifier of the package payload element.</xs:documentation>
2060 </xs:annotation>
2061 </xs:attribute>
2062 <xs:attribute name="DownloadUrl" type="xs:string">
2063 <xs:annotation>
2064 <xs:documentation>
2065 <html:p>The URL to use to download the package. The following substitutions are supported:</html:p>
2066 <html:ul>
2067 <html:li>{0} is replaced by the package Id.</html:li>
2068 <html:li>{1} is replaced by the payload Id.</html:li>
2069 <html:li>{2} is replaced by the payload file name.</html:li>
2070 </html:ul>
2071 </xs:documentation>
2072 </xs:annotation>
2073 </xs:attribute>
2074 <xs:attribute name="Compressed" type="YesNoDefaultTypeUnion">
2075 <xs:annotation>
2076 <xs:documentation>Whether the package payload should be embedded in a container or left as an external payload.</xs:documentation>
2077 </xs:annotation>
2078 </xs:attribute>
2079 <xs:attribute name="Name" type="xs:string">
2080 <xs:annotation>
2081 <xs:documentation>
2082 The destination path and file name for this chain payload.
2083 Use this attribute to rename the chain entry point or extract it into a subfolder.
2084 The default value is the file name from the SourceFile attribute.
2085 At a minimum, the Name or SourceFile attribute must be specified.
2086 This must be a relative path ('\foo' or 'C:\foo' is not allowed).
2087 </xs:documentation>
2088 </xs:annotation>
2089 </xs:attribute>
2090 <xs:anyAttribute namespace="##other" processContents="lax" />
2091 </xs:attributeGroup>
2092 <xs:attributeGroup name="LocalPackagePayloadCommonAttributes">
2093 <xs:attribute name="SourceFile" type="xs:string">
2094 <xs:annotation>
2095 <xs:documentation>
2096 Location of the package to add to the bundle.
2097 The default value is the Name attribute, if provided.
2098 At a minimum, the SourceFile or Name attribute must be specified.
2099 </xs:documentation>
2100 </xs:annotation>
2101 </xs:attribute>
2102 </xs:attributeGroup>
2103 <xs:attributeGroup name="RemotePackagePayloadCommonAttributes">
2104 <xs:attribute name="SourceFile" type="xs:string">
2105 <xs:annotation>
2106 <xs:documentation>
2107 Location of the package to add to the bundle.
2108 The default value is the Name attribute, if provided.
2109 If Hash is specified, must not be specified.
2110 </xs:documentation>
2111 </xs:annotation>
2112 </xs:attribute>
2113 <xs:attribute name="CertificatePublicKey" type="xs:string">
2114 <xs:annotation>
2115 <xs:documentation>Optional public key of the certificate used to sign the payload. It is not recommended to use this attribute and rely on the Hash alone.</xs:documentation>
2116 </xs:annotation>
2117 </xs:attribute>
2118 <xs:attribute name="CertificateThumbprint" type="xs:string">
2119 <xs:annotation>
2120 <xs:documentation>Optional thumbprint of the certificate used to sign the payload. It is not recommended to use this attribute and rely on the Hash alone.</xs:documentation>
2121 </xs:annotation>
2122 </xs:attribute>
2123 <xs:attribute name="Description" type="xs:string">
2124 <xs:annotation>
2125 <xs:documentation>
2126 Description of the file from version resources.
2127 If Hash is not specified, must not be specified.
2128 </xs:documentation>
2129 </xs:annotation>
2130 </xs:attribute>
2131 <xs:attribute name="Hash" type="HexType">
2132 <xs:annotation>
2133 <xs:documentation>
2134 SHA-512 hash of the RemotePayload.
2135 If SourceFile is specified, must not be specified.
2136 If specified then Name, DownloadUrl, and Size are required.
2137 </xs:documentation>
2138 </xs:annotation>
2139 </xs:attribute>
2140 <xs:attribute name="ProductName" type="xs:string">
2141 <xs:annotation>
2142 <xs:documentation>
2143 Product name of the file from version resouces.
2144 If Hash is not specified, must not be specified.
2145 </xs:documentation>
2146 </xs:annotation>
2147 </xs:attribute>
2148 <xs:attribute name="Size" type="Integer">
2149 <xs:annotation>
2150 <xs:documentation>
2151 Size of the remote file in bytes.
2152 Required if Hash is specified, otherwise must not be specified.
2153 </xs:documentation>
2154 </xs:annotation>
2155 </xs:attribute>
2156 <xs:attribute name="Version" type="WixVersionType">
2157 <xs:annotation>
2158 <xs:documentation>
2159 Version of the remote file.
2160 If Hash is not specified, must not be specified.
2161 </xs:documentation>
2162 </xs:annotation>
2163 </xs:attribute>
2164 </xs:attributeGroup>
2165 <xs:element name="RemoteBundle">
2166 <xs:annotation>
2167 <xs:documentation>
2168 Describes information about the referenced Bundle.
2169 </xs:documentation>
2170 </xs:annotation>
2171 <xs:complexType>
2172 <xs:choice minOccurs="0" maxOccurs="unbounded">
2173 <xs:element ref="RemoteRelatedBundle" />
2174 <xs:any namespace="##other" processContents="lax">
2175 <xs:annotation>
2176 <xs:documentation>
2177 Extensibility point in the WiX XML Schema. Schema extensions can register additional
2178 elements at this point in the schema.
2179 </xs:documentation>
2180 </xs:annotation>
2181 </xs:any>
2182 </xs:choice>
2183 <xs:attribute name="BundleId" type="Guid" use="required">
2184 <xs:annotation>
2185 <xs:documentation>
2186 The id of the bundle.
2187 </xs:documentation>
2188 </xs:annotation>
2189 </xs:attribute>
2190 <xs:attribute name="DisplayName" type="xs:string">
2191 <xs:annotation>
2192 <xs:documentation>
2193 The display name of the bundle.
2194 </xs:documentation>
2195 </xs:annotation>
2196 </xs:attribute>
2197 <xs:attribute name="EngineVersion" type="xs:string">
2198 <xs:annotation>
2199 <xs:documentation>
2200 The version of the bundle's engine.
2201 </xs:documentation>
2202 </xs:annotation>
2203 </xs:attribute>
2204 <xs:attribute name="InstallSize" type="xs:string">
2205 <xs:annotation>
2206 <xs:documentation>
2207 The size this bundle will take on disk in bytes after it is installed.
2208 </xs:documentation>
2209 </xs:annotation>
2210 </xs:attribute>
2211 <xs:attribute name="ManifestNamespace" type="xs:string" use="required">
2212 <xs:annotation>
2213 <xs:documentation>
2214 The namespace of the bundle's manifest.
2215 </xs:documentation>
2216 </xs:annotation>
2217 </xs:attribute>
2218 <xs:attribute name="PerMachine" type="YesNoTypeUnion" use="required">
2219 <xs:annotation>
2220 <xs:documentation>
2221 Whether the bundle is per-machine.
2222 </xs:documentation>
2223 </xs:annotation>
2224 </xs:attribute>
2225 <xs:attribute name="ProtocolVersion" type="Integer" use="required">
2226 <xs:annotation>
2227 <xs:documentation>
2228 The protocol version of the related bundle.
2229 </xs:documentation>
2230 </xs:annotation>
2231 </xs:attribute>
2232 <xs:attribute name="ProviderKey" type="xs:string" use="required">
2233 <xs:annotation>
2234 <xs:documentation>
2235 The provider key of the bundle.
2236 </xs:documentation>
2237 </xs:annotation>
2238 </xs:attribute>
2239 <xs:attribute name="UpgradeCode" type="Guid" use="required">
2240 <xs:annotation>
2241 <xs:documentation>
2242 An upgrade code of the bundle.
2243 </xs:documentation>
2244 </xs:annotation>
2245 </xs:attribute>
2246 <xs:attribute name="Version" type="xs:string" use="required">
2247 <xs:annotation>
2248 <xs:documentation>
2249 The version of the bundle.
2250 </xs:documentation>
2251 </xs:annotation>
2252 </xs:attribute>
2253 <xs:attribute name="Win64" type="YesNoTypeUnion" use="required">
2254 <xs:annotation>
2255 <xs:documentation>
2256 Whether the bundle is 64-bit.
2257 </xs:documentation>
2258 </xs:annotation>
2259 </xs:attribute>
2260 <xs:anyAttribute namespace="##other" processContents="lax">
2261 <xs:annotation>
2262 <xs:documentation>
2263 Extensibility point in the WiX XML Schema. Schema extensions can register additional
2264 attributes at this point in the schema.
2265 </xs:documentation>
2266 </xs:annotation>
2267 </xs:anyAttribute>
2268 </xs:complexType>
2269 </xs:element>
2270 <xs:element name="RemoteRelatedBundle">
2271 <xs:annotation>
2272 <xs:documentation>
2273 Defines a related bundle for the parent RemoteBundle.
2274 </xs:documentation>
2275 </xs:annotation>
2276 <xs:complexType>
2277 <xs:choice minOccurs="0" maxOccurs="unbounded">
2278 <xs:any namespace="##other" processContents="lax">
2279 <xs:annotation>
2280 <xs:documentation>
2281 Extensibility point in the WiX XML Schema. Schema extensions can register additional
2282 elements at this point in the schema.
2283 </xs:documentation>
2284 </xs:annotation>
2285 </xs:any>
2286 </xs:choice>
2287 <xs:attribute name="Id" type="Guid" use="required">
2288 <xs:annotation>
2289 <xs:documentation>The identifier of the RelatedBundle group.</xs:documentation>
2290 </xs:annotation>
2291 </xs:attribute>
2292 <xs:attribute name="Action" use="required">
2293 <xs:annotation>
2294 <xs:documentation>The action to take on bundles related to this one.</xs:documentation>
2295 </xs:annotation>
2296 <xs:simpleType>
2297 <xs:restriction base="xs:string">
2298 <xs:enumeration value="detect" />
2299 <xs:enumeration value="upgrade" />
2300 <xs:enumeration value="addon" />
2301 <xs:enumeration value="patch" />
2302 </xs:restriction>
2303 </xs:simpleType>
2304 </xs:attribute>
2305 <xs:anyAttribute namespace="##other" processContents="lax">
2306 <xs:annotation>
2307 <xs:documentation>
2308 Extensibility point in the WiX XML Schema. Schema extensions can register additional
2309 attributes at this point in the schema.
2310 </xs:documentation>
2311 </xs:annotation>
2312 </xs:anyAttribute>
2313 </xs:complexType>
2314 </xs:element>
2315 <xs:element name="RelatedBundle">
2316 <xs:annotation>
2317 <xs:documentation>Defines a related bundle for the parent Bundle.</xs:documentation>
2318 </xs:annotation>
2319 <xs:complexType>
2320 <xs:choice minOccurs="0" maxOccurs="unbounded">
2321 <xs:any namespace="##other" processContents="lax">
2322 <xs:annotation>
2323 <xs:documentation>
2324 Extensibility point in the WiX XML Schema. Schema extensions can register additional
2325 elements at this point in the schema.
2326 </xs:documentation>
2327 </xs:annotation>
2328 </xs:any>
2329 </xs:choice>
2330 <xs:attribute name="Id" type="Guid" use="required">
2331 <xs:annotation>
2332 <xs:documentation>The identifier of the RelatedBundle group.</xs:documentation>
2333 </xs:annotation>
2334 </xs:attribute>
2335 <xs:attribute name="Action" use="optional">
2336 <xs:annotation>
2337 <xs:documentation>The action to take on bundles related to this one. Detect is the default.</xs:documentation>
2338 </xs:annotation>
2339 <xs:simpleType>
2340 <xs:restriction base="xs:string">
2341 <xs:enumeration value="detect" />
2342 <xs:enumeration value="upgrade" />
2343 <xs:enumeration value="addon" />
2344 <xs:enumeration value="patch" />
2345 </xs:restriction>
2346 </xs:simpleType>
2347 </xs:attribute>
2348 <xs:anyAttribute namespace="##other" processContents="lax">
2349 <xs:annotation>
2350 <xs:documentation>
2351 Extensibility point in the WiX XML Schema. Schema extensions can register additional
2352 attributes at this point in the schema.
2353 </xs:documentation>
2354 </xs:annotation>
2355 </xs:anyAttribute>
2356 </xs:complexType>
2357 </xs:element>
2358 <xs:element name="Update">
2359 <xs:annotation>
2360 <xs:documentation>Defines the update for a Bundle.</xs:documentation>
2361 </xs:annotation>
2362 <xs:complexType>
2363 <xs:attribute name="Location" type="xs:string" use="required">
2364 <xs:annotation>
2365 <xs:documentation>
2366 The absolute path or URL to check for an update bundle. Currently the engine provides this value
2367 in the IBootstrapperApplication::OnDetectUpdateBegin() and otherwise ignores the value. In the
2368 future the engine will be able to acquire an update bundle from the location and determine if it
2369 is newer than the current executing bundle.
2370 </xs:documentation>
2371 </xs:annotation>
2372 </xs:attribute>
2373 </xs:complexType>
2374 </xs:element>
2375 <xs:element name="Package">
2376 <xs:annotation>
2377 <xs:documentation>
2378 The Package element is analogous to the main function in a C program. When linking, only one Package section
2379 can be given to the build to produce a successful result. Using this element creates an MSI file which often
2380 referred to as a Product.
2381 </xs:documentation>
2382 <xs:appinfo>
2383 <xse:remarks>
2384 <html:p>You can specify any valid Windows code page by integer like 1252, or by web name like Windows-1252. See [Code pages](../../tools/codepage.md) for more information.</html:p>
2385 </xse:remarks>
2386 </xs:appinfo>
2387 </xs:annotation>
2388 <xs:complexType>
2389 <xs:choice minOccurs="0" maxOccurs="unbounded">
2390 <xs:element ref="AdminExecuteSequence" />
2391 <xs:element ref="AdminUISequence" />
2392 <xs:element ref="AdvertiseExecuteSequence" />
2393 <xs:element ref="AppId" />
2394 <xs:element ref="Binary" />
2395 <xs:element ref="ComplianceCheck" />
2396 <xs:element ref="Component" />
2397 <xs:element ref="ComponentRef" />
2398 <xs:element ref="ComponentGroup" />
2399 <xs:element ref="ComponentGroupRef" />
2400 <xs:element ref="CustomAction" />
2401 <xs:element ref="CustomActionRef" />
2402 <xs:element ref="CustomTable" />
2403 <xs:element ref="CustomTableRef" />
2404 <xs:element ref="Directory" />
2405 <xs:element ref="DirectoryRef" />
2406 <xs:element ref="EmbeddedChainer" />
2407 <xs:element ref="EmbeddedChainerRef" />
2408 <xs:element ref="EnsureTable" />
2409 <xs:element ref="Feature" />
2410 <xs:element ref="FeatureRef" />
2411 <xs:element ref="FeatureGroupRef" />
2412 <xs:element ref="File" />
2413 <xs:element ref="Files" />
2414 <xs:element ref="Icon" />
2415 <xs:element ref="InstallExecuteSequence" />
2416 <xs:element ref="InstallUISequence" />
2417 <xs:element ref="InstanceTransforms" />
2418 <xs:element ref="Launch" />
2419 <xs:element ref="MajorUpgrade" />
2420 <xs:element ref="Media" />
2421 <xs:element ref="MediaTemplate" />
2422 <xs:element ref="PackageCertificates" />
2423 <xs:element ref="PatchCertificates" />
2424 <xs:element ref="Property" />
2425 <xs:element ref="PropertyRef" />
2426 <xs:element ref="Requires" />
2427 <xs:element ref="SetDirectory" />
2428 <xs:element ref="SetProperty" />
2429 <xs:element ref="SFPCatalog" />
2430 <xs:element ref="SoftwareTag" />
2431 <xs:element ref="StandardDirectory" />
2432 <xs:element ref="SummaryInformation" />
2433 <xs:element ref="SymbolPath" />
2434 <xs:element ref="UI" />
2435 <xs:element ref="UIRef" />
2436 <xs:element ref="Upgrade" />
2437 <xs:element ref="WixVariable" />
2438 <xs:any namespace="##other" processContents="lax">
2439 <xs:annotation>
2440 <xs:documentation>
2441 Extensibility point in the WiX XML Schema. Schema extensions can register additional
2442 elements at this point in the schema.
2443 </xs:documentation>
2444 </xs:annotation>
2445 </xs:any>
2446 </xs:choice>
2447 <xs:attribute name="Codepage" type="xs:string">
2448 <xs:annotation>
2449 <xs:documentation>
2450 The code page integer value or web name for the resulting MSI. See remarks for more information.
2451 The default codepage is 65001 (UTF-8).
2452 </xs:documentation>
2453 </xs:annotation>
2454 </xs:attribute>
2455 <xs:attribute name="Compressed" type="YesNoTypeUnion">
2456 <xs:annotation>
2457 <xs:documentation>Indicates whether the package files are compressed. Default is compressed packages.</xs:documentation>
2458 </xs:annotation>
2459 </xs:attribute>
2460 <xs:attribute name="InstallerVersion" type="Integer">
2461 <xs:annotation>
2462 <xs:documentation>
2463 The minimum version of the Windows Installer required to install this package. Take the major version of the required Windows Installer
2464 and multiply by a 100 then add the minor version of the Windows Installer. For example, "200" would represent Windows Installer 2.0 and
2465 "405" would represent Windows Installer 4.5. This value is defaulted to "500" which is the latest version of the Windows Installer and
2466 present in Windows 7 and later.
2467 </xs:documentation>
2468 </xs:annotation>
2469 </xs:attribute>
2470 <xs:attribute name="Language" type="LocalizableInteger">
2471 <xs:annotation>
2472 <xs:documentation>The decimal language ID (LCID) for the product. Sets the ProductLanguage property.</xs:documentation>
2473 </xs:annotation>
2474 </xs:attribute>
2475 <xs:attribute name="Manufacturer" type="xs:string" use="required">
2476 <xs:annotation>
2477 <xs:documentation>The manufacturer of the package. Sets the Manufacturer property.</xs:documentation>
2478 </xs:annotation>
2479 </xs:attribute>
2480 <xs:attribute name="Name" type="xs:string" use="required">
2481 <xs:annotation>
2482 <xs:documentation>The descriptive name of the product. Sets the ProductName property.</xs:documentation>
2483 </xs:annotation>
2484 </xs:attribute>
2485 <xs:attribute name="ProductCode" type="AutogenGuid">
2486 <xs:annotation>
2487 <xs:documentation>
2488 Optional ProductCode GUID for the package. By default, a new ProductCode property will be
2489 generated with every build enabling major upgrades.
2490 </xs:documentation>
2491 </xs:annotation>
2492 </xs:attribute>
2493 <xs:attribute name="Scope" type="PackageScopeTypeUnion">
2494 <xs:annotation>
2495 <xs:documentation>Use this attribute to specify the installation scope of this package: per-machine, per-user, or a choice of either. The default is per-machine.</xs:documentation>
2496 </xs:annotation>
2497 </xs:attribute>
2498 <xs:attribute name="ShortNames" type="YesNoTypeUnion">
2499 <xs:annotation>
2500 <xs:documentation>Indicates whether the package files are installed using 8.3 filenames. The default is no.</xs:documentation>
2501 </xs:annotation>
2502 </xs:attribute>
2503 <xs:attribute name="UpgradeCode" type="Guid">
2504 <xs:annotation>
2505 <xs:documentation>The upgrade code GUID for the package. Sets the UpgradeCode property.</xs:documentation>
2506 </xs:annotation>
2507 </xs:attribute>
2508 <xs:attribute name="UpgradeStrategy" type="UpgradeStrategyTypeUnion">
2509 <xs:annotation>
2510 <xs:documentation>
2511 _New in WiX v5: WiX v5 adds this attribute to the `Package` element._
2512 The upgrade strategy for the package. If "none," no major upgrade is expected.
2513 If "majorUpgrade," the UpgradeCode attribute is required and a major upgrade is expected.
2514 The default is "majorUpgrade."
2515 A default major upgrade is automatically provided if none is authored.
2516 </xs:documentation>
2517 </xs:annotation>
2518 </xs:attribute>
2519 <xs:attribute name="Version" type="xs:string" use="required">
2520 <xs:annotation>
2521 <xs:documentation>The product's version string. Sets the ProductVersion property.</xs:documentation>
2522 </xs:annotation>
2523 </xs:attribute>
2524 <xs:anyAttribute namespace="##other" processContents="lax">
2525 <xs:annotation>
2526 <xs:documentation>
2527 Extensibility point in the WiX XML Schema. Schema extensions can register additional
2528 attributes at this point in the schema.
2529 </xs:documentation>
2530 </xs:annotation>
2531 </xs:anyAttribute>
2532 </xs:complexType>
2533 </xs:element>
2534 <xs:element name="Module">
2535 <xs:annotation>
2536 <xs:documentation>
2537 The Module element is analogous to the main function in a C program. When linking, only
2538 one Module section can be given to the linker to produce a successful result. Using this
2539 element creates an msm file.
2540 </xs:documentation>
2541 </xs:annotation>
2542 <xs:complexType>
2543 <xs:choice minOccurs="0" maxOccurs="unbounded">
2544 <xs:element ref="AppId" />
2545 <xs:element ref="Binary" />
2546 <xs:element ref="Component" />
2547 <xs:element ref="ComponentGroupRef" />
2548 <xs:element ref="ComponentRef" />
2549 <xs:element ref="Configuration" />
2550 <xs:element ref="CustomAction" />
2551 <xs:element ref="CustomActionRef" />
2552 <xs:element ref="CustomTable" />
2553 <xs:element ref="CustomTableRef" />
2554 <xs:element ref="Dependency" />
2555 <xs:element ref="Directory" />
2556 <xs:element ref="DirectoryRef" />
2557 <xs:element ref="EmbeddedChainer" />
2558 <xs:element ref="EmbeddedChainerRef" />
2559 <xs:element ref="EnsureTable" />
2560 <xs:element ref="Exclusion" />
2561 <xs:element ref="File" />
2562 <xs:element ref="Files" />
2563 <xs:element ref="Icon" />
2564 <xs:element ref="IgnoreTable" />
2565 <xs:element ref="Property" />
2566 <xs:element ref="PropertyRef" />
2567 <xs:element ref="Requires" />
2568 <xs:element ref="SetDirectory" />
2569 <xs:element ref="SetProperty" />
2570 <xs:element ref="SFPCatalog" />
2571 <xs:element ref="StandardDirectory" />
2572 <xs:element ref="Substitution" />
2573 <xs:element ref="SummaryInformation" />
2574 <xs:element ref="UI" />
2575 <xs:element ref="UIRef" />
2576 <xs:element ref="WixVariable" />
2577 <xs:element ref="InstallExecuteSequence" />
2578 <xs:element ref="InstallUISequence" />
2579 <xs:element ref="AdminExecuteSequence" />
2580 <xs:element ref="AdminUISequence" />
2581 <xs:element ref="AdvertiseExecuteSequence" />
2582 <xs:any namespace="##other" processContents="lax">
2583 <xs:annotation>
2584 <xs:documentation>
2585 Extensibility point in the WiX XML Schema. Schema extensions can register additional
2586 elements at this point in the schema.
2587 </xs:documentation>
2588 </xs:annotation>
2589 </xs:any>
2590 </xs:choice>
2591 <xs:attribute name="Id" type="xs:string" use="required">
2592 <xs:annotation>
2593 <xs:documentation>The name of the merge module (not the file name).</xs:documentation>
2594 </xs:annotation>
2595 </xs:attribute>
2596 <xs:attribute name="Codepage" type="xs:string">
2597 <xs:annotation>
2598 <xs:documentation>
2599 The code page integer value or web name for the resulting MSM. You can specify any valid Windows
2600 code by by integer like 1252, or by web name like Windows-1252. See [Code pages](../../tools/codepage.md)
2601 for more information.
2602 </xs:documentation>
2603 </xs:annotation>
2604 </xs:attribute>
2605 <xs:attribute name="Guid" type="Guid">
2606 <xs:annotation>
2607 <xs:documentation>The GUID of the Merge Module that will be appended to primary keys in the database.</xs:documentation>
2608 </xs:annotation>
2609 </xs:attribute>
2610 <xs:attribute name="InstallerVersion" type="Integer">
2611 <xs:annotation>
2612 <xs:documentation>
2613 The minimum version of the Windows Installer required to install this package. Take the major version of the required Windows Installer
2614 and multiply by a 100 then add the minor version of the Windows Installer. For example, "200" would represent Windows Installer 2.0 and
2615 "405" would represent Windows Installer 4.5. This value is defaulted to "500" which is the latest version of the Windows Installer and
2616 present in Windows 7 and later.
2617 </xs:documentation>
2618 </xs:annotation>
2619 </xs:attribute>
2620 <xs:attribute name="Language" type="LocalizableInteger" use="required">
2621 <xs:annotation>
2622 <xs:documentation>The decimal language ID (LCID) of the merge module.</xs:documentation>
2623 </xs:annotation>
2624 </xs:attribute>
2625 <xs:attribute name="Version" type="xs:string" use="required">
2626 <xs:annotation>
2627 <xs:documentation>The major and minor versions of the merge module.</xs:documentation>
2628 </xs:annotation>
2629 </xs:attribute>
2630 </xs:complexType>
2631 </xs:element>
2632 <xs:element name="Dependency">
2633 <xs:annotation>
2634 <xs:documentation>Declares a dependency on another merge module.</xs:documentation>
2635 </xs:annotation>
2636 <xs:complexType>
2637 <xs:attribute name="RequiredId" type="xs:string" use="required">
2638 <xs:annotation>
2639 <xs:documentation>Identifier of the merge module required by the merge module.</xs:documentation>
2640 </xs:annotation>
2641 </xs:attribute>
2642 <xs:attribute name="RequiredLanguage" type="Integer" use="required">
2643 <xs:annotation>
2644 <xs:documentation>Numeric language ID of the merge module in RequiredID.</xs:documentation>
2645 </xs:annotation>
2646 </xs:attribute>
2647 <xs:attribute name="RequiredVersion" type="xs:string">
2648 <xs:annotation>
2649 <xs:documentation>Version of the merge module in RequiredID.</xs:documentation>
2650 </xs:annotation>
2651 </xs:attribute>
2652 </xs:complexType>
2653 </xs:element>
2654 <xs:element name="Exclusion">
2655 <xs:annotation>
2656 <xs:documentation>Declares a merge module with which this merge module is incompatible.</xs:documentation>
2657 </xs:annotation>
2658 <xs:complexType>
2659 <xs:attribute name="ExcludedId" type="xs:string" use="required">
2660 <xs:annotation>
2661 <xs:documentation>Identifier of the merge module that is incompatible.</xs:documentation>
2662 </xs:annotation>
2663 </xs:attribute>
2664 <xs:attribute name="ExcludeExceptLanguage" type="Integer">
2665 <xs:annotation>
2666 <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>
2667 </xs:annotation>
2668 </xs:attribute>
2669 <xs:attribute name="ExcludeLanguage" type="Integer">
2670 <xs:annotation>
2671 <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>
2672 </xs:annotation>
2673 </xs:attribute>
2674 <xs:attribute name="ExcludedMinVersion" type="xs:string">
2675 <xs:annotation>
2676 <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>
2677 </xs:annotation>
2678 </xs:attribute>
2679 <xs:attribute name="ExcludedMaxVersion" type="xs:string">
2680 <xs:annotation>
2681 <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>
2682 </xs:annotation>
2683 </xs:attribute>
2684 </xs:complexType>
2685 </xs:element>
2686 <xs:element name="Configuration">
2687 <xs:annotation>
2688 <xs:documentation>Defines the configurable attributes of merge module.</xs:documentation>
2689 </xs:annotation>
2690 <xs:complexType>
2691 <xs:attribute name="Name" type="xs:string" use="required">
2692 <xs:annotation>
2693 <xs:documentation>Defines the name of the configurable item.</xs:documentation>
2694 </xs:annotation>
2695 </xs:attribute>
2696 <xs:attribute name="Format" use="required">
2697 <xs:annotation>
2698 <xs:documentation>Specifies the format of the data being changed.</xs:documentation>
2699 </xs:annotation>
2700 <xs:simpleType>
2701 <xs:restriction base="xs:string">
2702 <xs:enumeration value="Text" />
2703 <xs:enumeration value="Key" />
2704 <xs:enumeration value="Integer" />
2705 <xs:enumeration value="Bitfield" />
2706 </xs:restriction>
2707 </xs:simpleType>
2708 </xs:attribute>
2709 <xs:attribute name="Type" type="xs:string">
2710 <xs:annotation>
2711 <xs:documentation>Specifies the type of the data being changed.</xs:documentation>
2712 </xs:annotation>
2713 </xs:attribute>
2714 <xs:attribute name="ContextData" type="xs:string">
2715 <xs:annotation>
2716 <xs:documentation>Specifies a semantic context for the requested data.</xs:documentation>
2717 </xs:annotation>
2718 </xs:attribute>
2719 <xs:attribute name="DefaultValue" type="xs:string">
2720 <xs:annotation>
2721 <xs:documentation>Specifies a default value for the item in this record if the merge tool declines to provide a value.</xs:documentation>
2722 </xs:annotation>
2723 </xs:attribute>
2724 <xs:attribute name="KeyNoOrphan" type="YesNoTypeUnion">
2725 <xs:annotation>
2726 <xs:documentation>Does not merge rule according to rules in MSI SDK.</xs:documentation>
2727 </xs:annotation>
2728 </xs:attribute>
2729 <xs:attribute name="NonNullable" type="YesNoTypeUnion">
2730 <xs:annotation>
2731 <xs:documentation>If yes, null is not a valid entry.</xs:documentation>
2732 </xs:annotation>
2733 </xs:attribute>
2734 <xs:attribute name="DisplayName" type="xs:string">
2735 <xs:annotation>
2736 <xs:documentation>Display name for authoring.</xs:documentation>
2737 </xs:annotation>
2738 </xs:attribute>
2739 <xs:attribute name="Description" type="xs:string">
2740 <xs:annotation>
2741 <xs:documentation>Description for authoring.</xs:documentation>
2742 </xs:annotation>
2743 </xs:attribute>
2744 <xs:attribute name="HelpLocation" type="xs:string">
2745 <xs:annotation>
2746 <xs:documentation>Location of chm file for authoring.</xs:documentation>
2747 </xs:annotation>
2748 </xs:attribute>
2749 <xs:attribute name="HelpKeyword" type="xs:string">
2750 <xs:annotation>
2751 <xs:documentation>Keyword into chm file for authoring.</xs:documentation>
2752 </xs:annotation>
2753 </xs:attribute>
2754 </xs:complexType>
2755 </xs:element>
2756 <xs:element name="Substitution">
2757 <xs:annotation>
2758 <xs:documentation>Specifies the configurable fields of a module database and provides a template for the configuration of each field.</xs:documentation>
2759 </xs:annotation>
2760 <xs:complexType>
2761 <xs:attribute name="Table" type="xs:string" use="required">
2762 <xs:annotation>
2763 <xs:documentation>Specifies the name of the table being modified in the module database.</xs:documentation>
2764 </xs:annotation>
2765 </xs:attribute>
2766 <xs:attribute name="Row" type="xs:string" use="required">
2767 <xs:annotation>
2768 <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>
2769 </xs:annotation>
2770 </xs:attribute>
2771 <xs:attribute name="Column" type="xs:string" use="required">
2772 <xs:annotation>
2773 <xs:documentation>Specifies the target column in the row named in the Row column.</xs:documentation>
2774 </xs:annotation>
2775 </xs:attribute>
2776 <xs:attribute name="Value" type="xs:string">
2777 <xs:annotation>
2778 <xs:documentation>Provides a formatting template for the data being substituted into the target field specified by Table, Row, and Column.</xs:documentation>
2779 </xs:annotation>
2780 </xs:attribute>
2781 </xs:complexType>
2782 </xs:element>
2783 <xs:element name="IgnoreTable">
2784 <xs:annotation>
2785 <xs:documentation>
2786 Specifies a table from the merge module that is not merged into an .msi file.
2787 If the table already exists in an .msi file, it is not modified by the merge.
2788 The specified table can therefore contain data that is unneeded after the merge.
2789 To minimize the size of the .msm file, it is recommended that developers remove
2790 unused tables from modules intended for redistribution rather than creating
2791 IgnoreTable elements for those tables.
2792 </xs:documentation>
2793 </xs:annotation>
2794 <xs:complexType>
2795 <xs:attribute name="Id" type="xs:string" use="required">
2796 <xs:annotation>
2797 <xs:documentation>
2798 The name of the table in the merge module that is not to be merged into the .msi file.
2799 </xs:documentation>
2800 </xs:annotation>
2801 </xs:attribute>
2802 </xs:complexType>
2803 </xs:element>
2804 <xs:element name="Fragment">
2805 <xs:annotation>
2806 <xs:documentation>
2807 The Fragment element is the building block of creating an installer database in WiX. Once defined,
2808 the Fragment becomes an immutable, atomic unit which can either be completely included or excluded
2809 from a product. The contents of a Fragment element can be linked into a product by utilizing one
2810 of the many *Ref elements. When linking in a Fragment, it will be necessary to link in all of its
2811 individual units. For instance, if a given Fragment contains two Component elements, you must link
2812 both under features using ComponentRef for each linked Component. Otherwise, you will get a linker
2813 warning and have a floating Component that does not appear under any Feature.
2814 </xs:documentation>
2815 </xs:annotation>
2816 <xs:complexType>
2817 <xs:choice minOccurs="0" maxOccurs="unbounded">
2818 <xs:element ref="AdminExecuteSequence" />
2819 <xs:element ref="AdminUISequence" />
2820 <xs:element ref="AdvertiseExecuteSequence" />
2821 <xs:element ref="AppId" />
2822 <xs:element ref="Binary" />
2823 <xs:element ref="BootstrapperApplication" />
2824 <xs:element ref="BootstrapperApplicationRef" />
2825 <xs:element ref="BootstrapperExtension" />
2826 <xs:element ref="BootstrapperExtensionRef" />
2827 <xs:element ref="BundleCustomData" />
2828 <xs:element ref="BundleCustomDataRef" />
2829 <xs:element ref="BundleExtension" />
2830 <xs:element ref="BundleExtensionRef" />
2831 <xs:element ref="ComplianceCheck" />
2832 <xs:element ref="Component" />
2833 <xs:element ref="ComponentGroup" />
2834 <xs:element ref="Container" />
2835 <xs:element ref="CustomAction" />
2836 <xs:element ref="CustomActionRef" />
2837 <xs:element ref="CustomTable" />
2838 <xs:element ref="CustomTableRef" />
2839 <xs:element ref="Directory" />
2840 <xs:element ref="DirectoryRef" />
2841 <xs:element ref="EmbeddedChainer" />
2842 <xs:element ref="EmbeddedChainerRef" />
2843 <xs:element ref="EnsureTable" />
2844 <xs:element ref="Feature" />
2845 <xs:element ref="FeatureGroup" />
2846 <xs:element ref="FeatureRef" />
2847 <xs:element ref="File" />
2848 <xs:element ref="Files" />
2849 <xs:element ref="Icon" />
2850 <xs:element ref="InstallExecuteSequence" />
2851 <xs:element ref="InstallUISequence" />
2852 <xs:element ref="Launch" />
2853 <xs:element ref="Media" />
2854 <xs:element ref="MediaTemplate" />
2855 <xs:element ref="PackageGroup" />
2856 <xs:element ref="PackageCertificates" />
2857 <xs:element ref="PatchCertificates" />
2858 <xs:element ref="PatchFamily" />
2859 <xs:element ref="PatchFamilyGroup"/>
2860 <xs:element ref="PatchFamilyGroupRef"/>
2861 <xs:element ref="PayloadGroup" />
2862 <xs:element ref="Property" />
2863 <xs:element ref="PropertyRef" />
2864 <xs:element ref="RelatedBundle" />
2865 <xs:element ref="Requires" />
2866 <xs:element ref="SetDirectory" />
2867 <xs:element ref="SetProperty" />
2868 <xs:element ref="SetVariable" />
2869 <xs:element ref="SetVariableRef" />
2870 <xs:element ref="SFPCatalog" />
2871 <xs:element ref="StandardDirectory" />
2872 <xs:element ref="UI" />
2873 <xs:element ref="UIRef" />
2874 <xs:element ref="Upgrade" />
2875 <xs:element ref="Variable" />
2876 <xs:element ref="WixVariable" />
2877 <xs:any namespace="##other" processContents="lax">
2878 <xs:annotation>
2879 <xs:documentation>
2880 Extensibility point in the WiX XML Schema. Schema extensions can register additional
2881 elements at this point in the schema.
2882 </xs:documentation>
2883 </xs:annotation>
2884 </xs:any>
2885 </xs:choice>
2886 <xs:attribute name="Id" type="xs:string">
2887 <xs:annotation>
2888 <xs:documentation>
2889 Optional identifier for a Fragment. Should only be set by advanced users to tag sections.
2890 </xs:documentation>
2891 </xs:annotation>
2892 </xs:attribute>
2893 </xs:complexType>
2894 </xs:element>
2895 <xs:element name="Patch">
2896 <xs:annotation>
2897 <xs:documentation>
2898 The Patch element is analogous to the main function in a C program. When linking, only one Patch section
2899 can be given to the linker to produce a successful result. Using this element creates an MSP file.
2900 </xs:documentation>
2901 <xs:appinfo>
2902 <xse:remarks>
2903 <html:p>You can specify any valid Windows code by by integer like 1252, or by web name like Windows-1252. See [Code pages](../../tools/codepage.md) for more information.</html:p>
2904 <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>
2905 <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>[SystemFolder]msiexec.exe /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>
2906 <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>
2907 </xse:remarks>
2908 </xs:appinfo>
2909 </xs:annotation>
2910 <xs:complexType>
2911 <xs:sequence>
2912 <xs:choice minOccurs="0" maxOccurs="unbounded">
2913 <xs:element ref="PatchInformation" minOccurs="0" maxOccurs="1">
2914 <xs:annotation>
2915 <xs:documentation>Optional element that allows overriding summary information properties.</xs:documentation>
2916 </xs:annotation>
2917 </xs:element>
2918 <xs:element ref="Media" minOccurs="1" maxOccurs="unbounded" />
2919 <xs:element ref="OptimizeCustomActions" minOccurs="0" maxOccurs="1">
2920 <xs:annotation>
2921 <xs:documentation>Indicates whether custom actions can be skipped when applying the patch.</xs:documentation>
2922 </xs:annotation>
2923 </xs:element>
2924 <xs:element ref="PatchFamily" minOccurs="1" maxOccurs="unbounded" />
2925 <xs:element ref="PatchFamilyRef" minOccurs="0" maxOccurs="unbounded" />
2926 <xs:element ref="PatchFamilyGroup" minOccurs="1" maxOccurs="unbounded"/>
2927 <xs:element ref="PatchFamilyGroupRef" minOccurs="0" maxOccurs="unbounded"/>
2928 <xs:element ref="PatchProperty" />
2929 <xs:element ref="TargetProductCodes" />
2930 <xs:any namespace="##other" processContents="lax">
2931 <xs:annotation>
2932 <xs:documentation>
2933 Extensibility point in the WiX XML Schema. Schema extensions can register additional
2934 elements at this point in the schema.
2935 </xs:documentation>
2936 </xs:annotation>
2937 </xs:any>
2938 </xs:choice>
2939 </xs:sequence>
2940 <xs:attribute name="Id" type="AutogenGuid">
2941 <xs:annotation>
2942 <xs:documentation>Patch code for this patch.</xs:documentation>
2943 </xs:annotation>
2944 </xs:attribute>
2945 <xs:attribute name="Codepage" type="xs:string">
2946 <xs:annotation>
2947 <xs:documentation>The code page integer value or web name for the resulting MSP. See remarks for more information.</xs:documentation>
2948 </xs:annotation>
2949 </xs:attribute>
2950 <xs:attribute name="AllowRemoval" type="YesNoTypeUnion">
2951 <xs:annotation>
2952 <xs:documentation>Whether this is an uninstallable patch.</xs:documentation>
2953 </xs:annotation>
2954 </xs:attribute>
2955 <xs:attribute name="Classification" type="xs:string" use="required">
2956 <xs:annotation>
2957 <xs:documentation>Category of updates. Recommended values are Critical Update, Hotfix, Security Rollup, Security Update, Service Pack, Update, Update Rollup.</xs:documentation>
2958 </xs:annotation>
2959 </xs:attribute>
2960 <xs:attribute name="ClientPatchId" type="xs:string">
2961 <xs:annotation>
2962 <xs:documentation>An easily referenced identity unique to a patch that can be used in product authoring. See remarks for more information.</xs:documentation>
2963 </xs:annotation>
2964 </xs:attribute>
2965 <xs:attribute name="ApiPatchingSymbolNoImagehlpFlag" type="YesNoTypeUnion">
2966 <xs:annotation>
2967 <xs:documentation>Flag used when creating a binary file patch. Default is "no". Don't use imagehlp.dll.</xs:documentation>
2968 </xs:annotation>
2969 </xs:attribute>
2970 <xs:attribute name="ApiPatchingSymbolNoFailuresFlag" type="YesNoTypeUnion">
2971 <xs:annotation>
2972 <xs:documentation>Flag used when creating a binary file patch. Default is "no". Don't fail patch due to imagehlp failures.</xs:documentation>
2973 </xs:annotation>
2974 </xs:attribute>
2975 <xs:attribute name="ApiPatchingSymbolUndecoratedTooFlag" type="YesNoTypeUnion">
2976 <xs:annotation>
2977 <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>
2978 </xs:annotation>
2979 </xs:attribute>
2980 <xs:attribute name="Description" type="xs:string" use="required">
2981 <xs:annotation>
2982 <xs:documentation>Description of the patch.</xs:documentation>
2983 </xs:annotation>
2984 </xs:attribute>
2985 <xs:attribute name="DisplayName" type="xs:string" use="required">
2986 <xs:annotation>
2987 <xs:documentation>A title for the patch that is suitable for public display. In Add/Remove Programs from XP SP2 on.</xs:documentation>
2988 </xs:annotation>
2989 </xs:attribute>
2990 <xs:attribute name="Comments" type="xs:string">
2991 <xs:annotation>
2992 <xs:documentation>Optional comments for browsing.</xs:documentation>
2993 </xs:annotation>
2994 </xs:attribute>
2995 <xs:attribute name="Manufacturer" type="xs:string">
2996 <xs:annotation>
2997 <xs:documentation>Vendor releasing the package</xs:documentation>
2998 </xs:annotation>
2999 </xs:attribute>
3000 <xs:attribute name="MinorUpdateTargetRTM" type="YesNoTypeUnion">
3001 <xs:annotation>
3002 <xs:documentation>
3003 Indicates that the patch targets the RTM version of the product or the most recent major
3004 upgrade patch. Author this optional property in minor update patches that contain sequencing
3005 information to indicate that the patch removes all patches up to the RTM version of the
3006 product, or up to the most recent major upgrade patch. This property is available beginning
3007 with Windows Installer 3.1.
3008 </xs:documentation>
3009 </xs:annotation>
3010 </xs:attribute>
3011 <xs:attribute name="MoreInfoURL" type="xs:string">
3012 <xs:annotation>
3013 <xs:documentation>A URL that provides information specific to this patch. In Add/Remove Programs from XP SP2 on.</xs:documentation>
3014 </xs:annotation>
3015 </xs:attribute>
3016 <xs:attribute name="OptimizedInstallMode" type="YesNoTypeUnion">
3017 <xs:annotation>
3018 <xs:documentation>
3019 If this attribute is set to 'yes' in all the patches to be applied in a transaction, the
3020 application of the patch is optimized if possible. Available beginning with Windows Installer 3.1.
3021 </xs:documentation>
3022 </xs:annotation>
3023 </xs:attribute>
3024 <xs:attribute name="TargetProductName" type="xs:string">
3025 <xs:annotation>
3026 <xs:documentation>Name of the application or target product suite.</xs:documentation>
3027 </xs:annotation>
3028 </xs:attribute>
3029 <xs:attribute name="OptimizePatchSizeForLargeFiles" type="YesNoTypeUnion">
3030 <xs:annotation>
3031 <xs:documentation>When this attribute is set, patches for files greater than approximately 4 MB in size may be made smaller.</xs:documentation>
3032 </xs:annotation>
3033 </xs:attribute>
3034 </xs:complexType>
3035 </xs:element>
3036 <xs:element name="Validate">
3037 <xs:annotation>
3038 <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>
3039 <xs:appinfo>
3040 <xse:remarks>
3041 <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>
3042 <html:ul>
3043 <html:li>ProductCode</html:li>
3044 <html:li>ProductLanguage</html:li>
3045 <html:li>ProductVersion</html:li>
3046 <html:li>UpgradeCode</html:li>
3047 </html:ul>
3048 <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>
3049 <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>
3050 </xse:remarks>
3051 </xs:appinfo>
3052 </xs:annotation>
3053 <xs:complexType>
3054 <xs:attribute name="ProductId" type="YesNoTypeUnion" default="yes">
3055 <xs:annotation>
3056 <xs:documentation>Requires that the installed ProductCode match the target ProductCode used to create the transform. The default is 'yes'.</xs:documentation>
3057 </xs:annotation>
3058 </xs:attribute>
3059 <xs:attribute name="ProductLanguage" type="YesNoTypeUnion" default="no">
3060 <xs:annotation>
3061 <xs:documentation>Requires that the installed ProductLanguage match the target ProductLanguage used to create the transform. The default is 'no'.</xs:documentation>
3062 </xs:annotation>
3063 </xs:attribute>
3064 <xs:attribute name="ProductVersion" default="Update">
3065 <xs:annotation>
3066 <xs:documentation>Determines how many fields of the installed ProductVersion to compare. See remarks for more information. The default is 'Update'.</xs:documentation>
3067 </xs:annotation>
3068 <xs:simpleType>
3069 <xs:restriction base="xs:NMTOKEN">
3070 <xs:enumeration value="Major">
3071 <xs:annotation>
3072 <xs:documentation>Checks the major version.</xs:documentation>
3073 </xs:annotation>
3074 </xs:enumeration>
3075 <xs:enumeration value="Minor">
3076 <xs:annotation>
3077 <xs:documentation>Checks the major and minor versions.</xs:documentation>
3078 </xs:annotation>
3079 </xs:enumeration>
3080 <xs:enumeration value="Update">
3081 <xs:annotation>
3082 <xs:documentation>Checks the major, minor, and update versions.</xs:documentation>
3083 </xs:annotation>
3084 </xs:enumeration>
3085 </xs:restriction>
3086 </xs:simpleType>
3087 </xs:attribute>
3088 <xs:attribute name="ProductVersionOperator" default="Equal">
3089 <xs:annotation>
3090 <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>
3091 </xs:annotation>
3092 <xs:simpleType>
3093 <xs:restriction base="xs:NMTOKEN">
3094 <xs:enumeration value="Lesser">
3095 <xs:annotation>
3096 <xs:documentation>Installed ProductVersion &lt; target ProductVersion.</xs:documentation>
3097 </xs:annotation>
3098 </xs:enumeration>
3099 <xs:enumeration value="LesserOrEqual">
3100 <xs:annotation>
3101 <xs:documentation>Installed ProductVersion &lt;= target ProductVersion.</xs:documentation>
3102 </xs:annotation>
3103 </xs:enumeration>
3104 <xs:enumeration value="Equal">
3105 <xs:annotation>
3106 <xs:documentation>Installed ProductVersion = target ProductVersion.</xs:documentation>
3107 </xs:annotation>
3108 </xs:enumeration>
3109 <xs:enumeration value="GreaterOrEqual">
3110 <xs:annotation>
3111 <xs:documentation>Installed ProductVersion &gt;= target ProductVersion.</xs:documentation>
3112 </xs:annotation>
3113 </xs:enumeration>
3114 <xs:enumeration value="Greater">
3115 <xs:annotation>
3116 <xs:documentation>Installed ProductVersion &gt; target ProductVersion.</xs:documentation>
3117 </xs:annotation>
3118 </xs:enumeration>
3119 </xs:restriction>
3120 </xs:simpleType>
3121 </xs:attribute>
3122 <xs:attribute name="UpgradeCode" type="YesNoTypeUnion" default="yes">
3123 <xs:annotation>
3124 <xs:documentation>Requires that the installed UpgradeCode match the target UpgradeCode used to create the transform. The default is 'yes'.</xs:documentation>
3125 </xs:annotation>
3126 </xs:attribute>
3127 <xs:attribute name="IgnoreAddExistingRow" type="YesNoTypeUnion" default="yes">
3128 <xs:annotation>
3129 <xs:documentation>Ignore errors when adding existing rows. The default is 'yes'.</xs:documentation>
3130 </xs:annotation>
3131 </xs:attribute>
3132 <xs:attribute name="IgnoreAddExistingTable" type="YesNoTypeUnion" default="yes">
3133 <xs:annotation>
3134 <xs:documentation>Ignore errors when adding existing tables. The default is 'yes'.</xs:documentation>
3135 </xs:annotation>
3136 </xs:attribute>
3137 <xs:attribute name="IgnoreDeleteMissingRow" type="YesNoTypeUnion" default="yes">
3138 <xs:annotation>
3139 <xs:documentation>Ignore errors when deleting missing rows. The default is 'yes'.</xs:documentation>
3140 </xs:annotation>
3141 </xs:attribute>
3142 <xs:attribute name="IgnoreDeleteMissingTable" type="YesNoTypeUnion" default="yes">
3143 <xs:annotation>
3144 <xs:documentation>Ignore errors when deleting missing tables. The default is 'yes'.</xs:documentation>
3145 </xs:annotation>
3146 </xs:attribute>
3147 <xs:attribute name="IgnoreUpdateMissingRow" type="YesNoTypeUnion" default="yes">
3148 <xs:annotation>
3149 <xs:documentation>Ignore errors when updating missing rows. The default is 'yes'.</xs:documentation>
3150 </xs:annotation>
3151 </xs:attribute>
3152 <xs:attribute name="IgnoreChangingCodePage" type="YesNoTypeUnion" default="no">
3153 <xs:annotation>
3154 <xs:documentation>Ignore errors when changing the database code page. The default is 'no'.</xs:documentation>
3155 </xs:annotation>
3156 </xs:attribute>
3157 </xs:complexType>
3158 </xs:element>
3159 <xs:element name="OptimizeCustomActions">
3160 <xs:annotation>
3161 <xs:documentation>Indicates whether custom actions can be skipped when applying the patch.</xs:documentation>
3162 <xs:appinfo>
3163 <xse:msiRef table="MsiPatchMetadata" href="http://msdn.microsoft.com/library/aa370344.aspx" />
3164 </xs:appinfo>
3165 </xs:annotation>
3166 <xs:complexType>
3167 <xs:attribute name="SkipAssignment" type="YesNoTypeUnion">
3168 <xs:annotation>
3169 <xs:documentation>Skip property (type 51) and directory (type 35) assignment custom actions.</xs:documentation>
3170 </xs:annotation>
3171 </xs:attribute>
3172 <xs:attribute name="SkipImmediate" type="YesNoTypeUnion">
3173 <xs:annotation>
3174 <xs:documentation>Skip immediate custom actions that are not property or directory assignment custom actions.</xs:documentation>
3175 </xs:annotation>
3176 </xs:attribute>
3177 <xs:attribute name="SkipDeferred" type="YesNoTypeUnion">
3178 <xs:annotation>
3179 <xs:documentation>Skip custom actions that run within the script.</xs:documentation>
3180 </xs:annotation>
3181 </xs:attribute>
3182 </xs:complexType>
3183 </xs:element>
3184 <xs:element name="PatchBaseline">
3185 <xs:annotation>
3186 <xs:documentation>Identifies a set of product versions.</xs:documentation>
3187 </xs:annotation>
3188 <xs:complexType>
3189 <xs:choice minOccurs="0">
3190 <xs:element ref="Validate" minOccurs="0" />
3191 </xs:choice>
3192 <xs:attribute name="Id" type="xs:string" use="required">
3193 <xs:annotation>
3194 <xs:documentation>Identifier for a set of product versions. It is recommended to use short identifiers like 'RTM' and 'SP1'. The identifier will been trimmed to less than 28 characters as required by the Windows Installer.</xs:documentation>
3195 </xs:annotation>
3196 </xs:attribute>
3197 <xs:attribute name="BaselineFile" type="xs:string" use="required">
3198 <xs:annotation>
3199 <xs:documentation>Path to baseline MSI for patch.</xs:documentation>
3200 </xs:annotation>
3201 </xs:attribute>
3202 <xs:attribute name="UpdateFile" type="xs:string" use="required">
3203 <xs:annotation>
3204 <xs:documentation>Path to updated MSI for patch.</xs:documentation>
3205 </xs:annotation>
3206 </xs:attribute>
3207 <xs:attribute name="DiskId" type="Integer">
3208 <xs:annotation>
3209 <xs:documentation>Optional id for cabinet to place patched files in.</xs:documentation>
3210 </xs:annotation>
3211 </xs:attribute>
3212 </xs:complexType>
3213 </xs:element>
3214 <xs:element name="PatchFamily">
3215 <xs:annotation>
3216 <xs:documentation>Collection of items that should be kept from the differences between two products.</xs:documentation>
3217 </xs:annotation>
3218 <xs:complexType>
3219 <xs:choice minOccurs="0" maxOccurs="unbounded">
3220 <xs:element ref="All" minOccurs="0" />
3221 <xs:element ref="BinaryRef" minOccurs="0" maxOccurs="unbounded" />
3222 <xs:element ref="ComponentRef" minOccurs="0" maxOccurs="unbounded" />
3223 <xs:element ref="CustomActionRef" minOccurs="0" maxOccurs="unbounded" />
3224 <xs:element ref="DigitalCertificateRef" minOccurs="0" maxOccurs="unbounded" />
3225 <xs:element ref="DirectoryRef" minOccurs="0" maxOccurs="unbounded" />
3226 <xs:element ref="FeatureRef" minOccurs="0" maxOccurs="unbounded" />
3227 <xs:element ref="IconRef" minOccurs="0" maxOccurs="unbounded" />
3228 <xs:element ref="PropertyRef" minOccurs="0" maxOccurs="unbounded" />
3229 <xs:element ref="SoftwareTagRef" minOccurs="0" maxOccurs="unbounded" />
3230 <xs:element ref="UIRef" minOccurs="0" maxOccurs="unbounded" />
3231 <xs:any namespace="##other" processContents="lax">
3232 <xs:annotation>
3233 <xs:documentation>
3234 Extensibility point in the WiX XML Schema. Schema extensions can register additional
3235 elements at this point in the schema.
3236 </xs:documentation>
3237 </xs:annotation>
3238 </xs:any>
3239 </xs:choice>
3240 <xs:attribute name="Id" type="xs:string" use="required">
3241 <xs:annotation>
3242 <xs:documentation>Identifier which indicates a sequence family to which this patch belongs.</xs:documentation>
3243 </xs:annotation>
3244 </xs:attribute>
3245 <xs:attribute name="ProductCode" type="Guid">
3246 <xs:annotation>
3247 <xs:documentation>
3248 Specifies the ProductCode of the product that this family applies to.
3249 </xs:documentation>
3250 </xs:annotation>
3251 </xs:attribute>
3252 <xs:attribute name="Version" type="xs:string" use="required">
3253 <xs:annotation>
3254 <xs:documentation>
3255 Used to populate the sequence column of the MsiPatchSequence table in the final MSP file.
3256 Specified in x.x.x.x format. See documentation for Sequence column of MsiPatchSequence table in MSI SDK.
3257 </xs:documentation>
3258 </xs:annotation>
3259 </xs:attribute>
3260 <xs:attribute name="Supersede" type="YesNoTypeUnion">
3261 <xs:annotation>
3262 <xs:documentation>
3263 Set this value to 'yes' to indicate that this patch will supersede all previous patches in this patch family.
3264 The default value is 'no'.
3265 </xs:documentation>
3266 </xs:annotation>
3267 </xs:attribute>
3268 <xs:anyAttribute namespace="##other" processContents="lax">
3269 <xs:annotation>
3270 <xs:documentation>
3271 Extensibility point in the WiX XML Schema. Schema extensions can register additional
3272 attributes at this point in the schema.
3273 </xs:documentation>
3274 </xs:annotation>
3275 </xs:anyAttribute>
3276 </xs:complexType>
3277 </xs:element>
3278 <xs:element name="PatchFamilyGroup">
3279 <xs:annotation>
3280 <xs:documentation>
3281 Groups together multiple patch families to be used in other locations.
3282 </xs:documentation>
3283 <xs:appinfo>
3284 <xse:seeAlso ref="PatchFamilyGroupRef"/>
3285 </xs:appinfo>
3286 </xs:annotation>
3287 <xs:complexType>
3288 <xs:choice minOccurs="0" maxOccurs="unbounded">
3289 <xs:element ref="PatchFamily"/>
3290 <xs:element ref="PatchFamilyRef"/>
3291 <xs:element ref="PatchFamilyGroupRef"/>
3292 <xs:any namespace="##other" processContents="lax">
3293 <xs:annotation>
3294 <xs:documentation>
3295 Extensibility point in the WiX XML Schema. Schema extensions can register additional
3296 elements at this point in the schema.
3297 </xs:documentation>
3298 </xs:annotation>
3299 </xs:any>
3300 </xs:choice>
3301 <xs:attribute name="Id" type="xs:string" use="required">
3302 <xs:annotation>
3303 <xs:documentation>Identifier for the PatchFamilyGroup.</xs:documentation>
3304 </xs:annotation>
3305 </xs:attribute>
3306 <xs:anyAttribute namespace="##other" processContents="lax">
3307 <xs:annotation>
3308 <xs:documentation>
3309 Extensibility point in the WiX XML Schema. Schema extensions can register additional
3310 attributes at this point in the schema.
3311 </xs:documentation>
3312 </xs:annotation>
3313 </xs:anyAttribute>
3314 </xs:complexType>
3315</xs:element>
3316<xs:element name="PatchFamilyGroupRef">
3317 <xs:annotation>
3318 <xs:documentation>Create a reference to a PatchFamilyGroup in another Fragment.</xs:documentation>
3319 <xs:appinfo>
3320 <xse:seeAlso ref="PatchFamilyGroup" />
3321 </xs:appinfo>
3322 </xs:annotation>
3323 <xs:complexType>
3324 <xs:attribute name="Id" type="xs:string" use="required">
3325 <xs:annotation>
3326 <xs:documentation>The identifier of the PatchFamilyGroup to reference.</xs:documentation>
3327 </xs:annotation>
3328 </xs:attribute>
3329 <xs:anyAttribute namespace="##other" processContents="lax">
3330 <xs:annotation>
3331 <xs:documentation>
3332 Extensibility point in the WiX XML Schema. Schema extensions can register additional
3333 attributes at this point in the schema.
3334 </xs:documentation>
3335 </xs:annotation>
3336 </xs:anyAttribute>
3337 </xs:complexType>
3338</xs:element>
3339 <xs:element name="PatchCreation">
3340 <xs:annotation>
3341 <xs:documentation>
3342 The PatchCreation element is analogous to the main function in a C program. When linking, only one PatchCreation section
3343 can be given to the linker to produce a successful result. Using this element creates a pcp file.
3344 </xs:documentation>
3345 <xs:appinfo>
3346 <xse:remarks>
3347 <html:p>You can specify any valid Windows code by by integer like 1252, or by web name like Windows-1252. See [Code pages](../../tools/codepage.md) for more information.</html:p>
3348 </xse:remarks>
3349 </xs:appinfo>
3350 </xs:annotation>
3351 <xs:complexType>
3352 <xs:sequence>
3353 <xs:element ref="PatchInformation" />
3354 <xs:element ref="PatchMetadata" minOccurs="0" />
3355 <xs:element ref="Family" maxOccurs="unbounded" />
3356 <xs:choice minOccurs="0" maxOccurs="unbounded">
3357 <xs:element ref="PatchProperty" />
3358 <xs:element ref="PatchSequence" />
3359 <xs:element ref="ReplacePatch" />
3360 <xs:element ref="TargetProductCode" />
3361 </xs:choice>
3362 </xs:sequence>
3363 <xs:attribute name="Id" type="Guid" use="required">
3364 <xs:annotation>
3365 <xs:documentation>PatchCreation identifier; this is the primary key for identifying patches.</xs:documentation>
3366 </xs:annotation>
3367 </xs:attribute>
3368 <xs:attribute name="AllowMajorVersionMismatches" type="YesNoTypeUnion">
3369 <xs:annotation>
3370 <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">AllowProductVersionMajorMismatches</html:a> for more information.</xs:documentation>
3371 </xs:annotation>
3372 </xs:attribute>
3373 <xs:attribute name="AllowProductCodeMismatches" type="YesNoTypeUnion">
3374 <xs:annotation>
3375 <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">AllowProductCodeMismatches</html:a> for more information.</xs:documentation>
3376 </xs:annotation>
3377 </xs:attribute>
3378 <xs:attribute name="CleanWorkingFolder" type="YesNoTypeUnion">
3379 <xs:annotation>
3380 <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">DontRemoveTempFolderWhenFinished</html:a> for more information. </xs:documentation>
3381 </xs:annotation>
3382 </xs:attribute>
3383 <xs:attribute name="Codepage" type="xs:string">
3384 <xs:annotation>
3385 <xs:documentation>The code page integer value or web name for the resulting PCP. See remarks for more information.</xs:documentation>
3386 </xs:annotation>
3387 </xs:attribute>
3388 <xs:attribute name="OutputPath" type="xs:string">
3389 <xs:annotation>
3390 <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">PatchOutputPath</html:a> for more information.</xs:documentation>
3391 </xs:annotation>
3392 </xs:attribute>
3393 <xs:attribute name="SourceList" type="xs:string">
3394 <xs:annotation>
3395 <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">PatchSourceList</html:a> for more information.</xs:documentation>
3396 </xs:annotation>
3397 </xs:attribute>
3398 <xs:attribute name="SymbolFlags" type="xs:int">
3399 <xs:annotation>
3400 <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">ApiPatchingSymbolFlags</html:a> for more information.</xs:documentation>
3401 </xs:annotation>
3402 </xs:attribute>
3403 <xs:attribute name="WholeFilesOnly" type="YesNoTypeUnion">
3404 <xs:annotation>
3405 <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">IncludeWholeFilesOnly</html:a> for more information.</xs:documentation>
3406 </xs:annotation>
3407 </xs:attribute>
3408 </xs:complexType>
3409 </xs:element>
3410 <xs:element name="PatchInformation">
3411 <xs:annotation>
3412 <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>
3413 <xs:appinfo>
3414 <xse:remarks>
3415 <html:p>You can specify any valid Windows code by by integer like 1252, or by web name like Windows-1252. See [Code pages](../../tools/codepage.md) for more information.</html:p>
3416 </xse:remarks>
3417 </xs:appinfo>
3418 </xs:annotation>
3419 <xs:complexType>
3420 <xs:attribute name="Description" type="xs:string">
3421 <xs:annotation>
3422 <xs:documentation>A short description of the patch that includes the name of the product.</xs:documentation>
3423 </xs:annotation>
3424 </xs:attribute>
3425 <xs:attribute name="Platforms" type="xs:string">
3426 <xs:annotation>
3427 <xs:appinfo>
3428 <xse:deprecated />
3429 </xs:appinfo>
3430 </xs:annotation>
3431 </xs:attribute>
3432 <xs:attribute name="Languages" type="xs:string">
3433 <xs:annotation>
3434 <xs:appinfo>
3435 <xse:deprecated />
3436 </xs:appinfo>
3437 </xs:annotation>
3438 </xs:attribute>
3439 <xs:attribute name="Manufacturer" type="xs:string">
3440 <xs:annotation>
3441 <xs:documentation>The name of the manufacturer of the patch package.</xs:documentation>
3442 </xs:annotation>
3443 </xs:attribute>
3444 <xs:attribute name="Keywords" type="xs:string">
3445 <xs:annotation>
3446 <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>
3447 </xs:annotation>
3448 </xs:attribute>
3449 <xs:attribute name="Comments" type="xs:string">
3450 <xs:annotation>
3451 <xs:documentation>General purpose of the patch package. For example, "This patch contains the logic and data required to install _product_."</xs:documentation>
3452 </xs:annotation>
3453 </xs:attribute>
3454 <xs:attribute name="ReadOnly" type="YesNoDefaultTypeUnion">
3455 <xs:annotation>
3456 <xs:documentation>
3457 The value of this attribute conveys whether the package should be opened as read-only.
3458 A database editing tool should not modify a read-only enforced database and should
3459 issue a warning at attempts to modify a read-only recommended database.
3460 </xs:documentation>
3461 </xs:annotation>
3462 </xs:attribute>
3463 <xs:attribute name="SummaryCodepage" type="xs:string">
3464 <xs:annotation>
3465 <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>
3466 </xs:annotation>
3467 </xs:attribute>
3468 <xs:attribute name="ShortNames" type="YesNoTypeUnion">
3469 <xs:annotation>
3470 <xs:appinfo>
3471 <xse:deprecated />
3472 </xs:appinfo>
3473 </xs:annotation>
3474 </xs:attribute>
3475 <xs:attribute name="Compressed" type="YesNoTypeUnion">
3476 <xs:annotation>
3477 <xs:appinfo>
3478 <xse:deprecated />
3479 </xs:appinfo>
3480 </xs:annotation>
3481 </xs:attribute>
3482 <xs:attribute name="AdminImage" type="YesNoTypeUnion">
3483 <xs:annotation>
3484 <xs:appinfo>
3485 <xse:deprecated />
3486 </xs:appinfo>
3487 </xs:annotation>
3488 </xs:attribute>
3489 </xs:complexType>
3490 </xs:element>
3491 <xs:element name="PatchMetadata">
3492 <xs:annotation>
3493 <xs:documentation>Properties about the patch to be placed in the PatchMetadata table.</xs:documentation>
3494 <xs:appinfo>
3495 <xse:msiRef table="MsiPatchMetadata" href="http://msdn.microsoft.com/library/aa370344.aspx" />
3496 </xs:appinfo>
3497 </xs:annotation>
3498 <xs:complexType>
3499 <xs:sequence>
3500 <xs:choice minOccurs="0" maxOccurs="unbounded">
3501 <xs:element ref="CustomProperty" minOccurs="0">
3502 <xs:annotation>
3503 <xs:documentation>A custom property that extends the standard set.</xs:documentation>
3504 </xs:annotation>
3505 </xs:element>
3506 <xs:element ref="OptimizeCustomActions" minOccurs="0" maxOccurs="1">
3507 <xs:annotation>
3508 <xs:documentation>Indicates whether custom actions can be skipped when applying the patch.</xs:documentation>
3509 </xs:annotation>
3510 </xs:element>
3511 </xs:choice>
3512 </xs:sequence>
3513 <xs:attribute name="AllowRemoval" type="YesNoTypeUnion" use="required">
3514 <xs:annotation>
3515 <xs:documentation>Whether this is an uninstallable patch.</xs:documentation>
3516 </xs:annotation>
3517 </xs:attribute>
3518 <xs:attribute name="Classification" type="xs:string" use="required">
3519 <xs:annotation>
3520 <xs:documentation>Category of updates. Recommended values are Critical Update, Hotfix, Security Rollup, Security Update, Service Pack, Update, Update Rollup.</xs:documentation>
3521 </xs:annotation>
3522 </xs:attribute>
3523 <xs:attribute name="CreationTimeUTC" type="xs:string">
3524 <xs:annotation>
3525 <xs:documentation>Creation time of the .msp file in the form mm-dd-yy HH:MM (month-day-year hour:minute).</xs:documentation>
3526 </xs:annotation>
3527 </xs:attribute>
3528 <xs:attribute name="Description" type="xs:string" use="required">
3529 <xs:annotation>
3530 <xs:documentation>Description of the patch.</xs:documentation>
3531 </xs:annotation>
3532 </xs:attribute>
3533 <xs:attribute name="DisplayName" type="xs:string" use="required">
3534 <xs:annotation>
3535 <xs:documentation>A title for the patch that is suitable for public display. In Add/Remove Programs from XP SP2 on.</xs:documentation>
3536 </xs:annotation>
3537 </xs:attribute>
3538 <xs:attribute name="ManufacturerName" type="xs:string" use="required">
3539 <xs:annotation>
3540 <xs:documentation>Name of the manufacturer.</xs:documentation>
3541 </xs:annotation>
3542 </xs:attribute>
3543 <xs:attribute name="MinorUpdateTargetRTM" type="xs:string">
3544 <xs:annotation>
3545 <xs:documentation>
3546 Indicates that the patch targets the RTM version of the product or the most recent major
3547 upgrade patch. Author this optional property in minor update patches that contain sequencing
3548 information to indicate that the patch removes all patches up to the RTM version of the
3549 product, or up to the most recent major upgrade patch. This property is available beginning
3550 with Windows Installer 3.1.
3551 </xs:documentation>
3552 </xs:annotation>
3553 </xs:attribute>
3554 <xs:attribute name="MoreInfoURL" type="xs:string" use="required">
3555 <xs:annotation>
3556 <xs:documentation>A URL that provides information specific to this patch. In Add/Remove Programs from XP SP2 on.</xs:documentation>
3557 </xs:annotation>
3558 </xs:attribute>
3559 <xs:attribute name="OptimizedInstallMode" type="YesNoTypeUnion">
3560 <xs:annotation>
3561 <xs:documentation>
3562 If this attribute is set to 'yes' in all the patches to be applied in a transaction, the
3563 application of the patch is optimized if possible. Available beginning with Windows Installer 3.1.
3564 </xs:documentation>
3565 </xs:annotation>
3566 </xs:attribute>
3567 <xs:attribute name="TargetProductName" type="xs:string" use="required">
3568 <xs:annotation>
3569 <xs:documentation>Name of the application or target product suite.</xs:documentation>
3570 </xs:annotation>
3571 </xs:attribute>
3572 </xs:complexType>
3573 </xs:element>
3574 <xs:element name="CustomProperty">
3575 <xs:annotation>
3576 <xs:documentation>A custom property for the PatchMetadata table.</xs:documentation>
3577 </xs:annotation>
3578 <xs:complexType>
3579 <xs:attribute name="Company" type="xs:string" use="required">
3580 <xs:annotation>
3581 <xs:documentation>The name of the company.</xs:documentation>
3582 </xs:annotation>
3583 </xs:attribute>
3584 <xs:attribute name="Property" type="xs:string" use="required">
3585 <xs:annotation>
3586 <xs:documentation>The name of the metadata property.</xs:documentation>
3587 </xs:annotation>
3588 </xs:attribute>
3589 <xs:attribute name="Value" type="xs:string" use="required">
3590 <xs:annotation>
3591 <xs:documentation>Value of the metadata property.</xs:documentation>
3592 </xs:annotation>
3593 </xs:attribute>
3594 </xs:complexType>
3595 </xs:element>
3596 <xs:element name="ReplacePatch">
3597 <xs:annotation>
3598 <xs:documentation>A patch that is deprecated by this patch.</xs:documentation>
3599 </xs:annotation>
3600 <xs:complexType>
3601 <xs:attribute name="Id" type="Guid" use="required">
3602 <xs:annotation>
3603 <xs:documentation>Patch GUID to be unregistered if it exists on the machine targeted by this patch.</xs:documentation>
3604 </xs:annotation>
3605 </xs:attribute>
3606 </xs:complexType>
3607 </xs:element>
3608 <xs:element name="TargetProductCodes">
3609 <xs:annotation>
3610 <xs:documentation>
3611 The product codes for products that can accept the patch.
3612 </xs:documentation>
3613 </xs:annotation>
3614 <xs:complexType>
3615 <xs:choice maxOccurs="unbounded">
3616 <xs:element ref="TargetProductCode" />
3617 </xs:choice>
3618 <xs:attribute name="Replace" type="YesNoTypeUnion">
3619 <xs:annotation>
3620 <xs:documentation>Whether to replace the product codes that can accept the patch from the target packages with the child elements.</xs:documentation>
3621 </xs:annotation>
3622 </xs:attribute>
3623 </xs:complexType>
3624 </xs:element>
3625 <xs:element name="TargetProductCode">
3626 <xs:annotation>
3627 <xs:documentation>
3628 A product code for a product that can accept the patch.
3629 </xs:documentation>
3630 <xs:appinfo>
3631 <xse:remarks>
3632 <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>
3633 <html:p>When using the Patch element, the Id attribute value must not be '*'. Use the TargetProductCodes/@Replace attribute instead.</html:p>
3634 </xse:remarks>
3635 </xs:appinfo>
3636 </xs:annotation>
3637 <xs:complexType>
3638 <xs:attribute name="Id" type="xs:string" use="required">
3639 <xs:annotation>
3640 <xs:documentation>
3641 The product code for a product that can accept the patch. This can be '*'. See remarks for more information.
3642 </xs:documentation>
3643 </xs:annotation>
3644 </xs:attribute>
3645 </xs:complexType>
3646 </xs:element>
3647 <xs:element name="PatchProperty">
3648 <xs:annotation>
3649 <xs:documentation>A property for this patch database.</xs:documentation>
3650 <xs:appinfo>
3651 <xse:msiRef table="MsiPatchMetadata" href="http://msdn.microsoft.com/library/aa370344.aspx" />
3652 <xse:remarks>
3653 <html:p>When authored under the Patch element, the PatchProperty defines entries in the MsiPatchMetadata table.</html:p>
3654 </xse:remarks>
3655 </xs:appinfo>
3656 </xs:annotation>
3657 <xs:complexType>
3658 <xs:attribute name="Company" type="xs:string">
3659 <xs:annotation>
3660 <xs:documentation>Name of the company for a custom metadata property.</xs:documentation>
3661 </xs:annotation>
3662 </xs:attribute>
3663 <xs:attribute name="Name" type="xs:string" use="required">
3664 <xs:annotation>
3665 <xs:documentation>Name of the patch property.</xs:documentation>
3666 </xs:annotation>
3667 </xs:attribute>
3668 <xs:attribute name="Value" type="xs:string" use="required">
3669 <xs:annotation>
3670 <xs:documentation>Value of the patch property.</xs:documentation>
3671 </xs:annotation>
3672 </xs:attribute>
3673 </xs:complexType>
3674 </xs:element>
3675 <xs:element name="PatchSequence">
3676 <xs:annotation>
3677 <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>
3678 <xs:appinfo>
3679 <xse:msiRef table="MsiPatchSequence" href="http://msdn.microsoft.com/library/aa370350.aspx" />
3680 </xs:appinfo>
3681 </xs:annotation>
3682 <xs:complexType>
3683 <xs:attribute name="PatchFamily" type="xs:string" use="required">
3684 <xs:annotation>
3685 <xs:documentation>Identifier which indicates a sequence family to which this patch belongs.</xs:documentation>
3686 </xs:annotation>
3687 </xs:attribute>
3688 <xs:attribute name="ProductCode" type="Guid">
3689 <xs:annotation>
3690 <xs:documentation>
3691 Specifies the ProductCode of the product that this family applies to.
3692 This attribute cannot the specified if the TargetImage attribute is specified.
3693 </xs:documentation>
3694 </xs:annotation>
3695 </xs:attribute>
3696 <xs:attribute name="Sequence" type="xs:string">
3697 <xs:annotation>
3698 <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>
3699 </xs:annotation>
3700 </xs:attribute>
3701 <xs:attribute name="Supersede" type="YesNoTypeUnion">
3702 <xs:annotation>
3703 <xs:documentation>
3704 Set this value to 'yes' to indicate that this patch will supersede all previous patches in this patch family.
3705 The default value is 'no'.
3706 </xs:documentation>
3707 </xs:annotation>
3708 </xs:attribute>
3709 <xs:attribute name="Target" type="xs:string">
3710 <xs:annotation>
3711 <xs:appinfo>
3712 <xse:deprecated ref="TargetImage" />
3713 </xs:appinfo>
3714 </xs:annotation>
3715 </xs:attribute>
3716 <xs:attribute name="TargetImage" type="xs:string">
3717 <xs:annotation>
3718 <xs:documentation>
3719 Specifies the TargetImage that this family applies to.
3720 This attribute cannot the specified if the ProductCode attribute is specified.
3721 </xs:documentation>
3722 </xs:annotation>
3723 </xs:attribute>
3724 </xs:complexType>
3725 </xs:element>
3726 <xs:element name="Family">
3727 <xs:annotation>
3728 <xs:documentation>Group of one or more upgraded images of a product.</xs:documentation>
3729 </xs:annotation>
3730 <xs:complexType>
3731 <xs:sequence>
3732 <xs:element ref="UpgradeImage" maxOccurs="unbounded" />
3733 <xs:choice minOccurs="0" maxOccurs="unbounded">
3734 <xs:element ref="ExternalFile" />
3735 <xs:element ref="ProtectFile" />
3736 </xs:choice>
3737 </xs:sequence>
3738 <xs:attribute name="DiskId" type="DiskIdType">
3739 <xs:annotation>
3740 <xs:documentation>Entered into the DiskId field of the new Media table record.</xs:documentation>
3741 </xs:annotation>
3742 </xs:attribute>
3743 <xs:attribute name="DiskPrompt" type="xs:string">
3744 <xs:annotation>
3745 <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>
3746 </xs:annotation>
3747 </xs:attribute>
3748 <xs:attribute name="MediaSrcProp" type="xs:string">
3749 <xs:annotation>
3750 <xs:documentation>Entered into the Source field of the new Media table entry of the upgraded image.</xs:documentation>
3751 </xs:annotation>
3752 </xs:attribute>
3753 <xs:attribute name="Name" type="xs:string" use="required">
3754 <xs:annotation>
3755 <xs:documentation>Identifier for the family.</xs:documentation>
3756 </xs:annotation>
3757 </xs:attribute>
3758 <xs:attribute name="SequenceStart" type="xs:int">
3759 <xs:annotation>
3760 <xs:documentation>Sequence number for the starting file.</xs:documentation>
3761 </xs:annotation>
3762 </xs:attribute>
3763 <xs:attribute name="VolumeLabel" type="xs:string">
3764 <xs:annotation>
3765 <xs:documentation>Entered into the VolumeLabel field of the new Media table record.</xs:documentation>
3766 </xs:annotation>
3767 </xs:attribute>
3768 </xs:complexType>
3769 </xs:element>
3770 <xs:element name="UpgradeImage">
3771 <xs:annotation>
3772 <xs:documentation>Contains information about the upgraded images of the product.</xs:documentation>
3773 </xs:annotation>
3774 <xs:complexType>
3775 <xs:sequence>
3776 <xs:element ref="TargetImage" maxOccurs="unbounded" />
3777 <xs:choice minOccurs="0" maxOccurs="unbounded">
3778 <xs:element ref="SymbolPath" />
3779 <xs:element ref="UpgradeFile" />
3780 </xs:choice>
3781 </xs:sequence>
3782 <xs:attribute name="Id" type="xs:string" use="required">
3783 <xs:annotation>
3784 <xs:documentation>Identifier to connect target images with upgraded image.</xs:documentation>
3785 </xs:annotation>
3786 </xs:attribute>
3787 <xs:attribute name="SourceFile" type="xs:string">
3788 <xs:annotation>
3789 <xs:documentation>Full path to location of msi file for upgraded image.</xs:documentation>
3790 </xs:annotation>
3791 </xs:attribute>
3792 <xs:attribute name="SourcePatch" type="xs:string">
3793 <xs:annotation>
3794 <xs:documentation>Modified copy of the upgraded installation database that contains additional authoring specific to patching.</xs:documentation>
3795 </xs:annotation>
3796 </xs:attribute>
3797 </xs:complexType>
3798 </xs:element>
3799 <xs:element name="TargetImage">
3800 <xs:annotation>
3801 <xs:documentation>Contains information about the target images of the product.</xs:documentation>
3802 </xs:annotation>
3803 <xs:complexType>
3804 <xs:choice minOccurs="0" maxOccurs="unbounded">
3805 <xs:element ref="SymbolPath" />
3806 <xs:element ref="TargetFile" />
3807 </xs:choice>
3808 <xs:attribute name="Id" type="xs:string" use="required">
3809 <xs:annotation>
3810 <xs:documentation>Identifier for the target image.</xs:documentation>
3811 </xs:annotation>
3812 </xs:attribute>
3813 <xs:attribute name="SourceFile" type="xs:string">
3814 <xs:annotation>
3815 <xs:documentation>Full path to the location of the msi file for the target image.</xs:documentation>
3816 </xs:annotation>
3817 </xs:attribute>
3818 <xs:attribute name="Order" type="xs:int" use="required">
3819 <xs:annotation>
3820 <xs:documentation>Relative order of the target image.</xs:documentation>
3821 </xs:annotation>
3822 </xs:attribute>
3823 <xs:attribute name="Validation" type="xs:string">
3824 <xs:annotation>
3825 <xs:documentation>Product checking to avoid applying irrelevant transforms.</xs:documentation>
3826 </xs:annotation>
3827 </xs:attribute>
3828 <xs:attribute name="IgnoreMissingFiles" type="YesNoTypeUnion">
3829 <xs:annotation>
3830 <xs:documentation>Files missing from the target image are ignored by the installer.</xs:documentation>
3831 </xs:annotation>
3832 </xs:attribute>
3833 </xs:complexType>
3834 </xs:element>
3835 <xs:element name="TargetFile">
3836 <xs:annotation>
3837 <xs:documentation>Information about specific files in a target image.</xs:documentation>
3838 </xs:annotation>
3839 <xs:complexType>
3840 <xs:sequence>
3841 <xs:element ref="SymbolPath" minOccurs="0" />
3842 <xs:choice minOccurs="0" maxOccurs="unbounded">
3843 <xs:element ref="IgnoreRange" />
3844 <xs:element ref="ProtectRange" />
3845 </xs:choice>
3846 </xs:sequence>
3847 <xs:attribute name="Id" type="xs:string" use="required">
3848 <xs:annotation>
3849 <xs:documentation>Foreign key into the File table.</xs:documentation>
3850 </xs:annotation>
3851 </xs:attribute>
3852 </xs:complexType>
3853 </xs:element>
3854 <xs:element name="IgnoreRange">
3855 <xs:annotation>
3856 <xs:documentation>Specifies part of a file that is to be ignored during patching.</xs:documentation>
3857 </xs:annotation>
3858 <xs:complexType>
3859 <xs:attribute name="Offset" type="xs:int" use="required">
3860 <xs:annotation>
3861 <xs:documentation>Offset of the start of the range.</xs:documentation>
3862 </xs:annotation>
3863 </xs:attribute>
3864 <xs:attribute name="Length" type="xs:int" use="required">
3865 <xs:annotation>
3866 <xs:documentation>Length of the range.</xs:documentation>
3867 </xs:annotation>
3868 </xs:attribute>
3869 </xs:complexType>
3870 </xs:element>
3871 <xs:element name="ProtectRange">
3872 <xs:annotation>
3873 <xs:documentation>Specifies part of a file that cannot be overwritten during patching.</xs:documentation>
3874 </xs:annotation>
3875 <xs:complexType>
3876 <xs:attribute name="Offset" type="xs:int" use="required">
3877 <xs:annotation>
3878 <xs:documentation>Offset of the start of the range.</xs:documentation>
3879 </xs:annotation>
3880 </xs:attribute>
3881 <xs:attribute name="Length" type="xs:int" use="required">
3882 <xs:annotation>
3883 <xs:documentation>Length of the range.</xs:documentation>
3884 </xs:annotation>
3885 </xs:attribute>
3886 </xs:complexType>
3887 </xs:element>
3888 <xs:element name="ProtectFile">
3889 <xs:annotation>
3890 <xs:documentation>Specifies a file to be protected.</xs:documentation>
3891 </xs:annotation>
3892 <xs:complexType>
3893 <xs:choice maxOccurs="unbounded">
3894 <xs:element ref="ProtectRange" />
3895 </xs:choice>
3896 <xs:attribute name="File" type="xs:string" use="required">
3897 <xs:annotation>
3898 <xs:documentation>Foreign key into the File table.</xs:documentation>
3899 </xs:annotation>
3900 </xs:attribute>
3901 </xs:complexType>
3902 </xs:element>
3903 <xs:element name="ExternalFile">
3904 <xs:annotation>
3905 <xs:documentation>Contains information about specific files that are not part of a regular target image.</xs:documentation>
3906 </xs:annotation>
3907 <xs:complexType>
3908 <xs:sequence>
3909 <xs:element ref="ProtectRange" maxOccurs="unbounded" />
3910 <xs:element ref="SymbolPath" maxOccurs="unbounded" />
3911 <xs:choice minOccurs="0" maxOccurs="unbounded">
3912 <xs:element ref="IgnoreRange" />
3913 </xs:choice>
3914 </xs:sequence>
3915 <xs:attribute name="File" type="xs:string" use="required">
3916 <xs:annotation>
3917 <xs:documentation>Foreign key into the File table.</xs:documentation>
3918 </xs:annotation>
3919 </xs:attribute>
3920 <xs:attribute name="Source" type="xs:string">
3921 <xs:annotation>
3922 <xs:documentation>Full path of the external file.</xs:documentation>
3923 </xs:annotation>
3924 </xs:attribute>
3925 <xs:attribute name="Order" type="xs:int" use="required">
3926 <xs:annotation>
3927 <xs:documentation>Specifies the order of the external files to use when creating the patch.</xs:documentation>
3928 </xs:annotation>
3929 </xs:attribute>
3930 </xs:complexType>
3931 </xs:element>
3932 <xs:element name="UpgradeFile">
3933 <xs:annotation>
3934 <xs:documentation>Specifies files to either ignore or to specify optional data about a file.</xs:documentation>
3935 </xs:annotation>
3936 <xs:complexType>
3937 <xs:choice minOccurs="0" maxOccurs="unbounded">
3938 <xs:element ref="SymbolPath" />
3939 </xs:choice>
3940 <xs:attribute name="File" type="xs:string" use="required">
3941 <xs:annotation>
3942 <xs:documentation>Foreign key into the File table.</xs:documentation>
3943 </xs:annotation>
3944 </xs:attribute>
3945 <xs:attribute name="Ignore" type="YesNoTypeUnion" use="required">
3946 <xs:annotation>
3947 <xs:documentation>If yes, the file is ignored during patching, and the next two attributes are ignored.</xs:documentation>
3948 </xs:annotation>
3949 </xs:attribute>
3950 <xs:attribute name="AllowIgnoreOnError" type="YesNoTypeUnion">
3951 <xs:annotation>
3952 <xs:documentation>Specifies whether patching this file is vital.</xs:documentation>
3953 </xs:annotation>
3954 </xs:attribute>
3955 <xs:attribute name="WholeFile" type="YesNoTypeUnion">
3956 <xs:annotation>
3957 <xs:documentation>Whether the whole file should be installed, rather than creating a binary patch.</xs:documentation>
3958 </xs:annotation>
3959 </xs:attribute>
3960 </xs:complexType>
3961 </xs:element>
3962 <xs:element name="SymbolPath">
3963 <xs:annotation>
3964 <xs:documentation>A path to symbols.</xs:documentation>
3965 </xs:annotation>
3966 <xs:complexType>
3967 <xs:attribute name="Path" type="xs:string" use="required">
3968 <xs:annotation>
3969 <xs:documentation>The path.</xs:documentation>
3970 </xs:annotation>
3971 </xs:attribute>
3972 </xs:complexType>
3973 </xs:element>
3974 <xs:element name="SummaryInformation">
3975 <xs:annotation>
3976 <xs:documentation>
3977 Properties about the package to be placed in the Summary Information Stream. These are
3978 visible from COM through the IStream interface, and these properties can be seen on the package in Explorer.
3979 </xs:documentation>
3980 <xs:appinfo>
3981 <xse:remarks>
3982 <html:p>You can specify any valid Windows code by by integer like 1252, or by web name like Windows-1252. See [Code pages](../../tools/codepage.md) for more information.</html:p>
3983 </xse:remarks>
3984 </xs:appinfo>
3985 </xs:annotation>
3986 <xs:complexType>
3987 <xs:attribute name="Codepage" type="xs:string">
3988 <xs:annotation>
3989 <xs:documentation>The code page integer value or web name for summary info strings only. See remarks for more information.</xs:documentation>
3990 </xs:annotation>
3991 </xs:attribute>
3992 <xs:attribute name="Comments" type="xs:string">
3993 <xs:annotation>
3994 <xs:documentation>Optional comments for browsing. _New in WiX v5: WiX v5 adds this attribute to the `SummaryInformation` element._</xs:documentation>
3995 </xs:annotation>
3996 </xs:attribute>
3997 <xs:attribute name="Description" type="xs:string">
3998 <xs:annotation>
3999 <xs:documentation>The product full name or description.</xs:documentation>
4000 </xs:annotation>
4001 </xs:attribute>
4002 <xs:attribute name="Keywords" type="xs:string">
4003 <xs:annotation>
4004 <xs:documentation>Optional keywords for browsing.</xs:documentation>
4005 </xs:annotation>
4006 </xs:attribute>
4007 <xs:attribute name="Manufacturer" type="xs:string">
4008 <xs:annotation>
4009 <xs:documentation>The vendor releasing the package. Defaults to the Package/@Manufacturer attribute's value.</xs:documentation>
4010 </xs:annotation>
4011 </xs:attribute>
4012 </xs:complexType>
4013 </xs:element>
4014 <xs:element name="AssemblyName">
4015 <xs:annotation>
4016 <xs:documentation>
4017 The MsiAssemblyName table specifies the schema for the elements of a strong assembly cache name for a .NET Framework or Win32 assembly.
4018 Consider using the Assembly attribute on File element to have the toolset populate these entries automatically.
4019 </xs:documentation>
4020 <xs:appinfo>
4021 <xse:msiRef table="MsiAssemblyName" href="http://msdn.microsoft.com/library/aa370062.aspx" />
4022 </xs:appinfo>
4023 </xs:annotation>
4024 <xs:complexType>
4025 <xs:attribute name="Id" use="required" type="xs:string">
4026 <xs:annotation>
4027 <xs:documentation>Name of the attribute associated with the value specified in the Value column.</xs:documentation>
4028 </xs:annotation>
4029 </xs:attribute>
4030 <xs:attribute name="Value" type="xs:string">
4031 <xs:annotation>
4032 <xs:documentation>Value associated with the name specified in the Name column.</xs:documentation>
4033 </xs:annotation>
4034 </xs:attribute>
4035 </xs:complexType>
4036 </xs:element>
4037 <xs:element name="PatchCertificates">
4038 <xs:annotation>
4039 <xs:documentation>
4040 Identifies the possible signer certificates used to digitally sign patches.
4041 </xs:documentation>
4042 <xs:appinfo>
4043 <xse:msiRef table="MsiPatchCertificate" href="http://msdn.microsoft.com/library/aa370342.aspx" />
4044 </xs:appinfo>
4045 </xs:annotation>
4046 <xs:complexType>
4047 <xs:choice maxOccurs="unbounded">
4048 <xs:element ref="DigitalCertificate" />
4049 </xs:choice>
4050 </xs:complexType>
4051 </xs:element>
4052 <xs:element name="PackageCertificates">
4053 <xs:annotation>
4054 <xs:documentation>
4055 Digital signatures that identify installation packages in a multi-product transaction.
4056 </xs:documentation>
4057 <xs:appinfo>
4058 <xse:msiRef table="MsiPackageCertificate" href="http://msdn.microsoft.com/library/cc542575.aspx" />
4059 </xs:appinfo>
4060 </xs:annotation>
4061 <xs:complexType>
4062 <xs:choice maxOccurs="unbounded">
4063 <xs:element ref="DigitalCertificate" />
4064 </xs:choice>
4065 </xs:complexType>
4066 </xs:element>
4067 <xs:element name="DigitalCertificate">
4068 <xs:annotation>
4069 <xs:documentation>
4070 Adds a digital certificate.
4071 </xs:documentation>
4072 <xs:appinfo>
4073 <xse:msiRef table="MsiDigitalCertificate" href="http://msdn.microsoft.com/library/aa370086.aspx" />
4074 </xs:appinfo>
4075 </xs:annotation>
4076 <xs:complexType>
4077 <xs:attribute name="Id" type="xs:string" use="required">
4078 <xs:annotation>
4079 <xs:documentation>Identifier for a certificate file.</xs:documentation>
4080 </xs:annotation>
4081 </xs:attribute>
4082 <xs:attribute name="SourceFile" type="xs:string" use="required">
4083 <xs:annotation>
4084 <xs:documentation>The path to the certificate file.</xs:documentation>
4085 </xs:annotation>
4086 </xs:attribute>
4087 </xs:complexType>
4088 </xs:element>
4089 <xs:element name="DigitalCertificateRef">
4090 <xs:annotation>
4091 <xs:documentation>
4092 Reference to a DigitalCertificate element. This will force the entire referenced Fragment's contents
4093 to be included in the installer database. This is only used for references when patching.
4094 </xs:documentation>
4095 </xs:annotation>
4096 <xs:complexType>
4097 <xs:attribute name="Id" type="xs:string" use="required" />
4098 <xs:anyAttribute namespace="##other" processContents="lax">
4099 <xs:annotation>
4100 <xs:documentation>
4101 Extensibility point in the WiX XML Schema. Schema extensions can register additional
4102 attributes at this point in the schema.
4103 </xs:documentation>
4104 </xs:annotation>
4105 </xs:anyAttribute>
4106 </xs:complexType>
4107 </xs:element>
4108 <xs:element name="DigitalSignature">
4109 <xs:annotation>
4110 <xs:documentation>
4111 Adds a digital signature.
4112 </xs:documentation>
4113 <xs:appinfo>
4114 <xse:msiRef table="MsiDigitalSignature" href="http://msdn.microsoft.com/library/aa370087.aspx" />
4115 </xs:appinfo>
4116 </xs:annotation>
4117 <xs:complexType>
4118 <xs:choice>
4119 <xs:element ref="DigitalCertificate" />
4120 </xs:choice>
4121 <xs:attribute name="SourceFile" type="xs:string">
4122 <xs:annotation>
4123 <xs:documentation>The path to signature's optional hash file.</xs:documentation>
4124 </xs:annotation>
4125 </xs:attribute>
4126 </xs:complexType>
4127 </xs:element>
4128 <xs:element name="SFPCatalog">
4129 <xs:annotation>
4130 <xs:documentation>
4131 Adds a system file protection update catalog file
4132 </xs:documentation>
4133 <xs:appinfo>
4134 <xse:msiRef table="SFPCatalog" href="http://msdn.microsoft.com/library/aa371833.aspx" />
4135 </xs:appinfo>
4136 </xs:annotation>
4137 <xs:complexType>
4138 <xs:choice minOccurs="0" maxOccurs="unbounded">
4139 <xs:element ref="SFPCatalog" minOccurs="0" maxOccurs="unbounded" />
4140 <xs:element ref="SFPFile" minOccurs="0" maxOccurs="unbounded">
4141 <xs:annotation>
4142 <xs:documentation>Primary Key to File Table.</xs:documentation>
4143 </xs:annotation>
4144 </xs:element>
4145 </xs:choice>
4146 <xs:attribute name="Name" type="xs:string">
4147 <xs:annotation>
4148 <xs:documentation>Filename for catalog file when installed.</xs:documentation>
4149 </xs:annotation>
4150 </xs:attribute>
4151 <xs:attribute name="Dependency" type="xs:string">
4152 <xs:annotation>
4153 <xs:documentation>Used to define dependency outside of the package.</xs:documentation>
4154 </xs:annotation>
4155 </xs:attribute>
4156 <xs:attribute name="SourceFile" type="xs:string">
4157 <xs:annotation>
4158 <xs:documentation>Path to catalog file in binary.</xs:documentation>
4159 </xs:annotation>
4160 </xs:attribute>
4161 </xs:complexType>
4162 </xs:element>
4163 <xs:element name="SFPFile">
4164 <xs:annotation>
4165 <xs:documentation>
4166 Provides a many-to-many mapping from the SFPCatalog table to the File table
4167 </xs:documentation>
4168 <xs:appinfo>
4169 <xse:msiRef table="FileSFPCatalog" href="http://msdn.microsoft.com/library/aa368591.aspx" />
4170 </xs:appinfo>
4171 </xs:annotation>
4172 <xs:complexType>
4173 <xs:attribute name="Id" use="required" type="xs:string">
4174 <xs:annotation>
4175 <xs:documentation>Primary Key to File Table.</xs:documentation>
4176 </xs:annotation>
4177 </xs:attribute>
4178 </xs:complexType>
4179 </xs:element>
4180 <xs:element name="IniFile">
4181 <xs:annotation>
4182 <xs:documentation>
4183 Adds or removes .ini file entries.
4184 </xs:documentation>
4185 <xs:appinfo>
4186 <xse:msiRef table="IniFile" href="https://learn.microsoft.com/en-us/windows/win32/msi/inifile-table" />
4187 <xse:msiRef table="RemoveIniFile" href="https://learn.microsoft.com/en-us/windows/win32/msi/removeinifile-table" />
4188 </xs:appinfo>
4189 </xs:annotation>
4190 <xs:complexType>
4191 <xs:attribute name="Id" type="xs:string">
4192 <xs:annotation>
4193 <xs:documentation>Identifier for ini file. If one is not specified a stable identifier will be generated.</xs:documentation>
4194 </xs:annotation>
4195 </xs:attribute>
4196 <xs:attribute name="Action" use="required">
4197 <xs:annotation>
4198 <xs:documentation>The type of modification to be made.</xs:documentation>
4199 </xs:annotation>
4200 <xs:simpleType>
4201 <xs:restriction base="xs:NMTOKEN">
4202 <xs:enumeration value="addLine">
4203 <xs:annotation>
4204 <xs:documentation>Creates or updates an .ini entry.</xs:documentation>
4205 </xs:annotation>
4206 </xs:enumeration>
4207 <xs:enumeration value="addTag">
4208 <xs:annotation>
4209 <xs:documentation>Creates a new entry or appends a new comma-separated value to an existing entry.</xs:documentation>
4210 </xs:annotation>
4211 </xs:enumeration>
4212 <xs:enumeration value="createLine">
4213 <xs:annotation>
4214 <xs:documentation>Creates an .ini entry only if the entry does no already exist.</xs:documentation>
4215 </xs:annotation>
4216 </xs:enumeration>
4217 <xs:enumeration value="removeLine">
4218 <xs:annotation>
4219 <xs:documentation>Removes an .ini entry.</xs:documentation>
4220 </xs:annotation>
4221 </xs:enumeration>
4222 <xs:enumeration value="removeTag">
4223 <xs:annotation>
4224 <xs:documentation>Removes a tag from an .ini entry.</xs:documentation>
4225 </xs:annotation>
4226 </xs:enumeration>
4227 </xs:restriction>
4228 </xs:simpleType>
4229 </xs:attribute>
4230 <xs:attribute name="Directory" type="xs:string">
4231 <xs:annotation>
4232 <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>
4233 </xs:annotation>
4234 </xs:attribute>
4235 <xs:attribute name="Key" use="required" type="xs:string">
4236 <xs:annotation>
4237 <xs:documentation>The localizable .ini file key within the section.</xs:documentation>
4238 </xs:annotation>
4239 </xs:attribute>
4240 <xs:attribute name="Name" type="LongFileNameType" use="required">
4241 <xs:annotation>
4242 <xs:documentation>
4243 In prior versions of the WiX toolset, this attribute specified the short name.
4244 This attribute's value may now be either a short or long name.
4245 If a short name is specified, the ShortName attribute may not be specified.
4246 Also, if this value is a long name, the ShortName attribute may be omitted to
4247 allow WiX to attempt to generate a unique short name.
4248 However, if this name collides with another file or you wish to manually specify
4249 the short name, then the ShortName attribute may be specified.
4250 </xs:documentation>
4251 </xs:annotation>
4252 </xs:attribute>
4253 <xs:attribute name="Section" use="required" type="xs:string">
4254 <xs:annotation>
4255 <xs:documentation>The localizable .ini file section.</xs:documentation>
4256 </xs:annotation>
4257 </xs:attribute>
4258 <xs:attribute name="ShortName" type="ShortFileNameType">
4259 <xs:annotation>
4260 <xs:documentation>
4261 The short name of the in 8.3 format.
4262 This attribute should only be set if there is a conflict between generated short names
4263 or the user wants to manually specify the short name.
4264 </xs:documentation>
4265 </xs:annotation>
4266 </xs:attribute>
4267 <xs:attribute name="Value" type="xs:string">
4268 <xs:annotation>
4269 <xs:documentation>
4270 The localizable value to be written or deleted. This attribute must be set if
4271 the Action attribute's value is "addLine", "addTag", or "createLine".
4272 </xs:documentation>
4273 </xs:annotation>
4274 </xs:attribute>
4275 </xs:complexType>
4276 </xs:element>
4277 <xs:element name="ODBCDataSource">
4278 <xs:annotation>
4279 <xs:documentation>
4280 ODBCDataSource for a Component
4281 </xs:documentation>
4282 <xs:appinfo>
4283 <xse:msiRef table="ODBCDataSource" href="http://msdn.microsoft.com/library/aa370546.aspx" />
4284 </xs:appinfo>
4285 </xs:annotation>
4286 <xs:complexType>
4287 <xs:choice minOccurs="0" maxOccurs="unbounded">
4288 <xs:element ref="Property">
4289 <xs:annotation>
4290 <xs:documentation>Translates into ODBCSourceAttributes</xs:documentation>
4291 </xs:annotation>
4292 </xs:element>
4293 </xs:choice>
4294 <xs:attribute name="Id" use="required" type="xs:string">
4295 <xs:annotation>
4296 <xs:documentation>Identifier of the data source.</xs:documentation>
4297 </xs:annotation>
4298 </xs:attribute>
4299 <xs:attribute name="Name" use="required" type="xs:string">
4300 <xs:annotation>
4301 <xs:documentation>Name for the data source.</xs:documentation>
4302 </xs:annotation>
4303 </xs:attribute>
4304 <xs:attribute name="DriverName" type="xs:string">
4305 <xs:annotation>
4306 <xs:documentation>Required if not found as child of ODBCDriver element</xs:documentation>
4307 </xs:annotation>
4308 </xs:attribute>
4309 <xs:attribute name="Registration" use="required">
4310 <xs:annotation>
4311 <xs:documentation>Scope for which the data source should be registered.</xs:documentation>
4312 </xs:annotation>
4313 <xs:simpleType>
4314 <xs:restriction base="xs:NMTOKEN">
4315 <xs:enumeration value="machine">
4316 <xs:annotation>
4317 <xs:documentation>
4318 Data source is registered per machine.
4319 </xs:documentation>
4320 </xs:annotation>
4321 </xs:enumeration>
4322 <xs:enumeration value="user">
4323 <xs:annotation>
4324 <xs:documentation>
4325 Data source is registered per user.
4326 </xs:documentation>
4327 </xs:annotation>
4328 </xs:enumeration>
4329 </xs:restriction>
4330 </xs:simpleType>
4331 </xs:attribute>
4332 <xs:attribute name="KeyPath" type="YesNoTypeUnion">
4333 <xs:annotation>
4334 <xs:documentation>Set 'yes' to force this file to be key path for parent Component</xs:documentation>
4335 </xs:annotation>
4336 </xs:attribute>
4337 </xs:complexType>
4338 </xs:element>
4339 <xs:element name="ODBCDriver">
4340 <xs:annotation>
4341 <xs:documentation>
4342 ODBCDriver for a Component
4343 </xs:documentation>
4344 <xs:appinfo>
4345 <xse:msiRef table="ODBCDriver" href="http://msdn.microsoft.com/library/aa370547.aspx" />
4346 </xs:appinfo>
4347 </xs:annotation>
4348 <xs:complexType>
4349 <xs:choice minOccurs="0" maxOccurs="unbounded">
4350 <xs:element ref="Property">
4351 <xs:annotation>
4352 <xs:documentation>Translates into ODBCSourceAttributes</xs:documentation>
4353 </xs:annotation>
4354 </xs:element>
4355 <xs:element ref="ODBCDataSource" />
4356 </xs:choice>
4357 <xs:attribute name="Id" use="required" type="xs:string">
4358 <xs:annotation>
4359 <xs:documentation>Identifier for the driver.</xs:documentation>
4360 </xs:annotation>
4361 </xs:attribute>
4362 <xs:attribute name="Name" use="required" type="xs:string">
4363 <xs:annotation>
4364 <xs:documentation>Name for the driver.</xs:documentation>
4365 </xs:annotation>
4366 </xs:attribute>
4367 <xs:attribute name="File" type="xs:string">
4368 <xs:annotation>
4369 <xs:documentation>Required if not found as child of File element</xs:documentation>
4370 </xs:annotation>
4371 </xs:attribute>
4372 <xs:attribute name="SetupFile" type="xs:string">
4373 <xs:annotation>
4374 <xs:documentation>Required if not found as child of File element or different from File attribute above</xs:documentation>
4375 </xs:annotation>
4376 </xs:attribute>
4377 </xs:complexType>
4378 </xs:element>
4379 <xs:element name="ODBCTranslator">
4380 <xs:annotation>
4381 <xs:documentation>
4382 ODBCTranslator for a Component
4383 </xs:documentation>
4384 <xs:appinfo>
4385 <xse:msiRef table="ODBCTranslator" href="http://msdn.microsoft.com/library/aa370549.aspx" />
4386 </xs:appinfo>
4387 </xs:annotation>
4388 <xs:complexType>
4389 <xs:attribute name="Id" use="required" type="xs:string">
4390 <xs:annotation>
4391 <xs:documentation>Identifier for the translator.</xs:documentation>
4392 </xs:annotation>
4393 </xs:attribute>
4394 <xs:attribute name="Name" use="required" type="xs:string">
4395 <xs:annotation>
4396 <xs:documentation>Name for the translator.</xs:documentation>
4397 </xs:annotation>
4398 </xs:attribute>
4399 <xs:attribute name="File" type="xs:string">
4400 <xs:annotation>
4401 <xs:documentation>Required if not found as child of File element</xs:documentation>
4402 </xs:annotation>
4403 </xs:attribute>
4404 <xs:attribute name="SetupFile" type="xs:string">
4405 <xs:annotation>
4406 <xs:documentation>Required if not found as child of File element or different from File attribute above</xs:documentation>
4407 </xs:annotation>
4408 </xs:attribute>
4409 </xs:complexType>
4410 </xs:element>
4411 <xs:element name="FileSearch">
4412 <xs:annotation>
4413 <xs:appinfo>
4414 <xse:seeAlso ref="ComponentSearch" />
4415 <xse:seeAlso ref="DirectorySearch" />
4416 <xse:seeAlso ref="DirectorySearchRef" />
4417 <xse:seeAlso ref="FileSearchRef" />
4418 <xse:seeAlso ref="IniFileSearch" />
4419 <xse:seeAlso ref="RegistrySearch" />
4420 <xse:msiRef table="DrLocator" href="http://msdn.microsoft.com/library/aa368331.aspx" />
4421 <xse:msiRef table="Signature" href="https://docs.microsoft.com/en-us/windows/win32/msi/signature-table" />
4422 <xse:howtoRef href="files_and_registry/check_the_version_number.html">How To: Check the version number of a file during installation</xse:howtoRef>
4423 <xse:remarks>
4424 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'.
4425 </xse:remarks>
4426 </xs:appinfo>
4427 <xs:documentation>Searches for file and assigns to fullpath value of parent Property</xs:documentation>
4428 </xs:annotation>
4429 <xs:complexType>
4430 <xs:attribute name="Id" type="xs:string">
4431 <xs:annotation>
4432 <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>
4433 </xs:annotation>
4434 </xs:attribute>
4435 <xs:attribute name="Name" type="LongFileNameType">
4436 <xs:annotation>
4437 <xs:documentation>
4438 In prior versions of the WiX toolset, this attribute specified the short file name.
4439 This attribute's value may now be either a short or long file name.
4440 If a short file name is specified, the ShortName attribute may not be specified.
4441 If you wish to manually specify the short file name, then the ShortName
4442 attribute may be specified.
4443 </xs:documentation>
4444 </xs:annotation>
4445 </xs:attribute>
4446 <xs:attribute name="ShortName" type="ShortFileNameType">
4447 <xs:annotation>
4448 <xs:documentation>
4449 The short file name of the file in 8.3 format.
4450 There is a Windows Installer bug which prevents the FileSearch functionality from working
4451 if both a short and long file name are specified. Since the Name attribute allows either
4452 a short or long name to be specified, it is the only attribute related to file names which
4453 should be specified.
4454 </xs:documentation>
4455 </xs:annotation>
4456 </xs:attribute>
4457 <xs:attribute name="MinSize" type="xs:int">
4458 <xs:annotation>
4459 <xs:documentation>The minimum size of the file.</xs:documentation>
4460 </xs:annotation>
4461 </xs:attribute>
4462 <xs:attribute name="MaxSize" type="xs:int">
4463 <xs:annotation>
4464 <xs:documentation>The maximum size of the file.</xs:documentation>
4465 </xs:annotation>
4466 </xs:attribute>
4467 <xs:attribute name="MinVersion" type="xs:string">
4468 <xs:annotation>
4469 <xs:documentation>The minimum version of the file.</xs:documentation>
4470 </xs:annotation>
4471 </xs:attribute>
4472 <xs:attribute name="MaxVersion" type="xs:string">
4473 <xs:annotation>
4474 <xs:documentation>The maximum version of the file.</xs:documentation>
4475 </xs:annotation>
4476 </xs:attribute>
4477 <xs:attribute name="MinDate" type="xs:dateTime">
4478 <xs:annotation>
4479 <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>
4480 </xs:annotation>
4481 </xs:attribute>
4482 <xs:attribute name="MaxDate" type="xs:dateTime">
4483 <xs:annotation>
4484 <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>
4485 </xs:annotation>
4486 </xs:attribute>
4487 <xs:attribute name="Languages" type="xs:string">
4488 <xs:annotation>
4489 <xs:documentation>The languages supported by the file.</xs:documentation>
4490 </xs:annotation>
4491 </xs:attribute>
4492 </xs:complexType>
4493 </xs:element>
4494 <xs:element name="FileSearchRef">
4495 <xs:annotation>
4496 <xs:appinfo>
4497 <xse:seeAlso ref="FileSearch" />
4498 <xse:remarks>
4499 <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>
4500 </xse:remarks>
4501 </xs:appinfo>
4502 <xs:documentation>References an existing FileSearch element.</xs:documentation>
4503 </xs:annotation>
4504 <xs:complexType>
4505 <xs:attribute name="Id" use="required" type="xs:string">
4506 <xs:annotation>
4507 <xs:documentation>Specify the Id to the FileSearch to reference.</xs:documentation>
4508 </xs:annotation>
4509 </xs:attribute>
4510 </xs:complexType>
4511 </xs:element>
4512 <xs:element name="DirectorySearch">
4513 <xs:annotation>
4514 <xs:appinfo>
4515 <xse:seeAlso ref="ComponentSearch" />
4516 <xse:seeAlso ref="IniFileSearch" />
4517 <xse:seeAlso ref="RegistrySearch" />
4518 <xse:msiRef table="DrLocator" href="http://msdn.microsoft.com/library/aa368331.aspx" />
4519 <xse:msiRef table="Signature" href="https://docs.microsoft.com/en-us/windows/win32/msi/signature-table" />
4520 <xse:howtoRef href="files_and_registry/check_the_version_number.html">How To: Check the version number of a file during installation</xse:howtoRef>
4521 <xse:howtoRef href="files_and_registry/directorysearchref.html">How To: Reference another DirectorySearch element</xse:howtoRef>
4522 <xse:howtoRef href="files_and_registry/parentdirectorysearch.html">How To: Get the parent directory of a file search</xse:howtoRef>
4523 <xse:remarks>
4524 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.
4525 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'.
4526 </xse:remarks>
4527 </xs:appinfo>
4528 <xs:documentation>Searches for directory and assigns to value of parent Property.</xs:documentation>
4529 </xs:annotation>
4530 <xs:complexType>
4531 <xs:choice minOccurs="0">
4532 <xs:element ref="DirectorySearch" />
4533 <xs:element ref="DirectorySearchRef" />
4534 <xs:element ref="FileSearch" />
4535 <xs:element ref="FileSearchRef" />
4536 </xs:choice>
4537 <xs:attribute name="Id" use="required" type="xs:string">
4538 <xs:annotation>
4539 <xs:documentation>Unique identifier for the directory search.</xs:documentation>
4540 </xs:annotation>
4541 </xs:attribute>
4542 <xs:attribute name="Path" type="xs:string">
4543 <xs:annotation>
4544 <xs:documentation>Path on the user's system. Either absolute, or relative to containing directories.</xs:documentation>
4545 </xs:annotation>
4546 </xs:attribute>
4547 <xs:attribute name="Depth" type="Integer">
4548 <xs:annotation>
4549 <xs:documentation>
4550 Depth below the path that the installer searches for the file or directory specified by the search. See remarks for more information.
4551 </xs:documentation>
4552 </xs:annotation>
4553 </xs:attribute>
4554 <xs:attribute name="AssignToProperty" type="YesNoTypeUnion">
4555 <xs:annotation>
4556 <xs:documentation>Set the value of the outer Property to the result of this search. See remarks for more information.</xs:documentation>
4557 </xs:annotation>
4558 </xs:attribute>
4559 </xs:complexType>
4560 </xs:element>
4561 <xs:element name="DirectorySearchRef">
4562 <xs:annotation>
4563 <xs:appinfo>
4564 <xse:seeAlso ref="ComponentSearch" />
4565 <xse:seeAlso ref="IniFileSearch" />
4566 <xse:seeAlso ref="RegistrySearch" />
4567 <xse:howtoRef href="files_and_registry/directorysearchref.html">How To: Reference another DirectorySearch element</xse:howtoRef>
4568 <xse:remarks>
4569 <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>
4570 </xse:remarks>
4571 </xs:appinfo>
4572 <xs:documentation>References an existing DirectorySearch element.</xs:documentation>
4573 </xs:annotation>
4574 <xs:complexType>
4575 <xs:choice minOccurs="0">
4576 <xs:element ref="DirectorySearch" />
4577 <xs:element ref="DirectorySearchRef" />
4578 <xs:element ref="FileSearch" />
4579 <xs:element ref="FileSearchRef" />
4580 </xs:choice>
4581 <xs:attribute name="Id" use="required" type="xs:string">
4582 <xs:annotation>
4583 <xs:documentation>Id of the search being referred to.</xs:documentation>
4584 </xs:annotation>
4585 </xs:attribute>
4586 <xs:attribute name="Parent" type="xs:string">
4587 <xs:annotation>
4588 <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>
4589 </xs:annotation>
4590 </xs:attribute>
4591 <xs:attribute name="Path" type="xs:string">
4592 <xs:annotation>
4593 <xs:documentation>Path on the user's system. Either absolute, or relative to containing directories.</xs:documentation>
4594 </xs:annotation>
4595 </xs:attribute>
4596 </xs:complexType>
4597 </xs:element>
4598 <xs:element name="ComponentSearch">
4599 <xs:annotation>
4600 <xs:appinfo>
4601 <xse:seeAlso ref="IniFileSearch" />
4602 <xse:seeAlso ref="RegistrySearch" />
4603 <xse:msiRef table="CompLocator" href="http://msdn.microsoft.com/library/aa368001.aspx" />
4604 <xse:msiRef table="Signature" href="https://docs.microsoft.com/en-us/windows/win32/msi/signature-table" />
4605 </xs:appinfo>
4606 <xs:documentation>Searches for file or directory and assigns to value of parent Property.</xs:documentation>
4607 </xs:annotation>
4608 <xs:complexType>
4609 <xs:choice minOccurs="0">
4610 <xs:element ref="DirectorySearch" />
4611 <xs:element ref="DirectorySearchRef" />
4612 <xs:element ref="FileSearch" />
4613 <xs:element ref="FileSearchRef" />
4614 </xs:choice>
4615 <xs:attribute name="Id" use="required" type="xs:string" />
4616 <xs:attribute name="Guid" type="Guid">
4617 <xs:annotation>
4618 <xs:documentation>The component ID of the component whose key path is to be used for the search.</xs:documentation>
4619 </xs:annotation>
4620 </xs:attribute>
4621 <xs:attribute name="Type">
4622 <xs:annotation>
4623 <xs:documentation>Must be file if last child is FileSearch element and must be directory if last child is DirectorySearch element.</xs:documentation>
4624 </xs:annotation>
4625 <xs:simpleType>
4626 <xs:restriction base="xs:NMTOKEN">
4627 <xs:enumeration value="directory">
4628 <xs:annotation>
4629 <xs:documentation>
4630 The key path of the component is a directory.
4631 </xs:documentation>
4632 </xs:annotation>
4633 </xs:enumeration>
4634 <xs:enumeration value="file">
4635 <xs:annotation>
4636 <xs:documentation>
4637 The key path of the component is a file. This is the default value.
4638 </xs:documentation>
4639 </xs:annotation>
4640 </xs:enumeration>
4641 </xs:restriction>
4642 </xs:simpleType>
4643 </xs:attribute>
4644 </xs:complexType>
4645 </xs:element>
4646 <xs:element name="IniFileSearch">
4647 <xs:annotation>
4648 <xs:appinfo>
4649 <xse:seeAlso ref="ComponentSearch" />
4650 <xse:seeAlso ref="RegistrySearch" />
4651 <xse:msiRef table="IniLocator" href="http://msdn.microsoft.com/library/aa369283.aspx" />
4652 <xse:msiRef table="Signature" href="https://docs.microsoft.com/en-us/windows/win32/msi/signature-table" />
4653 </xs:appinfo>
4654 <xs:documentation>Searches for file, directory or registry key and assigns to value of parent Property</xs:documentation>
4655 </xs:annotation>
4656 <xs:complexType>
4657 <xs:choice minOccurs="0">
4658 <xs:element ref="DirectorySearch" />
4659 <xs:element ref="DirectorySearchRef" />
4660 <xs:element ref="FileSearch" />
4661 <xs:element ref="FileSearchRef" />
4662 </xs:choice>
4663 <xs:attribute name="Id" use="required" type="xs:string">
4664 <xs:annotation>
4665 <xs:documentation>External key into the Signature table.</xs:documentation>
4666 </xs:annotation>
4667 </xs:attribute>
4668 <xs:attribute name="Field" type="Integer">
4669 <xs:annotation>
4670 <xs:documentation>The field in the .ini line. If field is Null or 0, the entire line is read.</xs:documentation>
4671 </xs:annotation>
4672 </xs:attribute>
4673 <xs:attribute name="Key" use="required" type="xs:string">
4674 <xs:annotation>
4675 <xs:documentation>The key value within the section.</xs:documentation>
4676 </xs:annotation>
4677 </xs:attribute>
4678 <xs:attribute name="Name" type="LongFileNameType" use="required">
4679 <xs:annotation>
4680 <xs:documentation>
4681 In prior versions of the WiX toolset, this attribute specified the short name.
4682 This attribute's value may now be either a short or long name.
4683 If a short name is specified, the ShortName attribute may not be specified.
4684 Also, if this value is a long name, the ShortName attribute may be omitted to
4685 allow WiX to attempt to generate a unique short name.
4686 However, if you wish to manually specify the short name, then the ShortName
4687 attribute may be specified.
4688 </xs:documentation>
4689 </xs:annotation>
4690 </xs:attribute>
4691 <xs:attribute name="Section" use="required" type="xs:string">
4692 <xs:annotation>
4693 <xs:documentation>The localizable .ini file section.</xs:documentation>
4694 </xs:annotation>
4695 </xs:attribute>
4696 <xs:attribute name="ShortName" type="ShortFileNameType">
4697 <xs:annotation>
4698 <xs:documentation>
4699 The short name of the file in 8.3 format.
4700 This attribute should only be set if the user wants to manually specify the short name.
4701 </xs:documentation>
4702 </xs:annotation>
4703 </xs:attribute>
4704 <xs:attribute name="Type">
4705 <xs:annotation>
4706 <xs:documentation>Must be file if last child is FileSearch element and must be directory if last child is DirectorySearch element.</xs:documentation>
4707 </xs:annotation>
4708 <xs:simpleType>
4709 <xs:restriction base="xs:NMTOKEN">
4710 <xs:enumeration value="directory">
4711 <xs:annotation>
4712 <xs:documentation>A directory location.</xs:documentation>
4713 </xs:annotation>
4714 </xs:enumeration>
4715 <xs:enumeration value="file">
4716 <xs:annotation>
4717 <xs:documentation>A file location. This is the default value.</xs:documentation>
4718 </xs:annotation>
4719 </xs:enumeration>
4720 <xs:enumeration value="raw">
4721 <xs:annotation>
4722 <xs:documentation>A raw .ini value.</xs:documentation>
4723 </xs:annotation>
4724 </xs:enumeration>
4725 </xs:restriction>
4726 </xs:simpleType>
4727 </xs:attribute>
4728 </xs:complexType>
4729 </xs:element>
4730 <xs:element name="RegistrySearch">
4731 <xs:annotation>
4732 <xs:appinfo>
4733 <xse:seeAlso ref="ComponentSearch" />
4734 <xse:seeAlso ref="IniFileSearch" />
4735 <xse:msiRef table="RegLocator" href="http://msdn.microsoft.com/library/aa371171.aspx" />
4736 <xse:msiRef table="Signature" href="https://docs.microsoft.com/en-us/windows/win32/msi/signature-table" />
4737 <xse:howtoRef href="files_and_registry/read_a_registry_entry.html">How To: Read a registry entry during installation</xse:howtoRef>
4738 <xse:remarks>
4739 <html:p>
4740 When the Type attribute value is 'directory' the registry value must specify the path to a directory excluding the file name.
4741 When the Type attribute value is 'file' the registry value must specify the path to a file including the file name;
4742 however, if there is no child FileSearch element the parent directory of the file is returned. The FileSearch element requires
4743 that you author the name of the file you are searching for. If you do not know the file name
4744 you must set the Type attribute to 'raw' to return the full file path including the file name.
4745 </html:p>
4746 </xse:remarks>
4747 </xs:appinfo>
4748 <xs:documentation>Searches for file, directory or registry key and assigns to value of parent Property</xs:documentation>
4749 </xs:annotation>
4750 <xs:complexType>
4751 <xs:choice minOccurs="0">
4752 <xs:element ref="DirectorySearch" />
4753 <xs:element ref="DirectorySearchRef" />
4754 <xs:element ref="FileSearch" />
4755 <xs:element ref="FileSearchRef" />
4756 </xs:choice>
4757 <xs:attribute name="Id" type="xs:string">
4758 <xs:annotation>
4759 <xs:documentation>Signature to be used for the file, directory or registry key being searched for. If omitted, WiX generates a suitable id.</xs:documentation>
4760 </xs:annotation>
4761 </xs:attribute>
4762 <xs:attribute name="Bitness" type="BitnessTypeUnion">
4763 <xs:annotation>
4764 <xs:documentation>
4765 Overrides the default registry to search. The value `always64` will force
4766 the search to look in the 64-bit registry even when building for 32-bit.
4767 Simliarly, the value `always32` will force the search to look in the 32-bit
4768 registry even when building for 64-bit.
4769 The default value is `default` where the search will look in the same registry
4770 as the bitness of the package.
4771 </xs:documentation>
4772 </xs:annotation>
4773 </xs:attribute>
4774 <xs:attribute name="Root" use="required">
4775 <xs:annotation>
4776 <xs:documentation>Root key for the registry value.</xs:documentation>
4777 </xs:annotation>
4778 <xs:simpleType>
4779 <xs:restriction base="xs:NMTOKEN">
4780 <xs:enumeration value="HKCR">
4781 <xs:annotation>
4782 <xs:documentation>
4783 HKEY_CLASSES_ROOT
4784 </xs:documentation>
4785 </xs:annotation>
4786 </xs:enumeration>
4787 <xs:enumeration value="HKCU">
4788 <xs:annotation>
4789 <xs:documentation>
4790 HKEY_CURRENT_USER
4791 </xs:documentation>
4792 </xs:annotation>
4793 </xs:enumeration>
4794 <xs:enumeration value="HKLM">
4795 <xs:annotation>
4796 <xs:documentation>
4797 HKEY_LOCAL_MACHINE
4798 </xs:documentation>
4799 </xs:annotation>
4800 </xs:enumeration>
4801 <xs:enumeration value="HKU">
4802 <xs:annotation>
4803 <xs:documentation>
4804 HKEY_USERS
4805 </xs:documentation>
4806 </xs:annotation>
4807 </xs:enumeration>
4808 </xs:restriction>
4809 </xs:simpleType>
4810 </xs:attribute>
4811 <xs:attribute name="Key" use="required" type="xs:string">
4812 <xs:annotation>
4813 <xs:documentation>Key for the registry value.</xs:documentation>
4814 </xs:annotation>
4815 </xs:attribute>
4816 <xs:attribute name="Name" type="xs:string">
4817 <xs:annotation>
4818 <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>
4819 </xs:annotation>
4820 </xs:attribute>
4821 <xs:attribute name="Type" use="required">
4822 <xs:annotation>
4823 <xs:documentation>
4824 The value must be 'file' if the child is a FileSearch element, and must be 'directory' if child is a DirectorySearch element.
4825 </xs:documentation>
4826 </xs:annotation>
4827 <xs:simpleType>
4828 <xs:restriction base="xs:NMTOKEN">
4829 <xs:enumeration value="directory">
4830 <xs:annotation>
4831 <xs:documentation>
4832 The registry value contains the path to a directory.
4833 </xs:documentation>
4834 </xs:annotation>
4835 </xs:enumeration>
4836 <xs:enumeration value="file">
4837 <xs:annotation>
4838 <xs:documentation>
4839 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.
4840 </xs:documentation>
4841 </xs:annotation>
4842 </xs:enumeration>
4843 <xs:enumeration value="raw">
4844 <xs:annotation>
4845 <xs:documentation>
4846 Sets the raw value from the registry value. Please note that this value will contain a prefix as follows:
4847
4848 - DWORD: Starts with `#` optionally followed by `+` or `-`.
4849 - REG_BINARY: Starts with `#x` and the installer converts and saves each hexadecimal digit (nibble) as an ASCII character prefixed by `#x`.
4850 - REG_EXPAND_SZ: Starts with `#%`.
4851 - REG_MULTI_SZ: Starts with `[~]` and ends with `[~]`.
4852 - REG_SZ: No prefix, but if the first character of the registry value is `#`, the installer escapes the character by prefixing it with another `#`.
4853 </xs:documentation>
4854 </xs:annotation>
4855 </xs:enumeration>
4856 </xs:restriction>
4857 </xs:simpleType>
4858 </xs:attribute>
4859 </xs:complexType>
4860 </xs:element>
4861 <xs:element name="RegistrySearchRef">
4862 <xs:annotation>
4863 <xs:appinfo>
4864 <xse:seeAlso ref="RegistrySearch" />
4865 </xs:appinfo>
4866 <xs:documentation>References an existing RegistrySearch element.</xs:documentation>
4867 </xs:annotation>
4868 <xs:complexType>
4869 <xs:attribute name="Id" type="xs:string" use="required">
4870 <xs:annotation>
4871 <xs:documentation>Specify the Id of the RegistrySearch to reference.</xs:documentation>
4872 </xs:annotation>
4873 </xs:attribute>
4874 </xs:complexType>
4875 </xs:element>
4876 <xs:element name="ComplianceDrive">
4877 <xs:annotation>
4878 <xs:documentation>Sets the parent of a nested DirectorySearch element to CCP_DRIVE.</xs:documentation>
4879 </xs:annotation>
4880 <xs:complexType>
4881 <xs:choice>
4882 <xs:element ref="DirectorySearch" />
4883 <xs:element ref="DirectorySearchRef" />
4884 </xs:choice>
4885 </xs:complexType>
4886 </xs:element>
4887 <xs:element name="ComplianceCheck">
4888 <xs:annotation>
4889 <xs:appinfo>
4890 <xse:seeAlso ref="Property" />
4891 <xse:msiRef table="CCPSearch" href="https://docs.microsoft.com/en-us/windows/win32/msi/ccpsearch-table" />
4892 <xse:msiRef table="Signature" href="https://docs.microsoft.com/en-us/windows/win32/msi/signature-table" />
4893 </xs:appinfo>
4894 <xs:documentation>Adds a row to the CCPSearch table.</xs:documentation>
4895 </xs:annotation>
4896 <xs:complexType>
4897 <xs:choice minOccurs="0" maxOccurs="unbounded">
4898 <xs:sequence>
4899 <xs:element ref="ComplianceDrive" minOccurs="0">
4900 <xs:annotation>
4901 <xs:documentation>Starts searches from the CCP_DRIVE.</xs:documentation>
4902 </xs:annotation>
4903 </xs:element>
4904 <xs:element ref="ComponentSearch" minOccurs="0" maxOccurs="unbounded" />
4905 <xs:element ref="RegistrySearch" minOccurs="0" maxOccurs="unbounded" />
4906 <xs:element ref="IniFileSearch" minOccurs="0" maxOccurs="unbounded" />
4907 <xs:element ref="DirectorySearch" minOccurs="0" maxOccurs="unbounded" />
4908 <xs:any namespace="##other" processContents="lax">
4909 <xs:annotation>
4910 <xs:documentation>
4911 Extensibility point in the WiX XML Schema. Schema extensions can register additional
4912 elements at this point in the schema.
4913 </xs:documentation>
4914 </xs:annotation>
4915 </xs:any>
4916 </xs:sequence>
4917 </xs:choice>
4918 <xs:anyAttribute namespace="##other" processContents="lax">
4919 <xs:annotation>
4920 <xs:documentation>
4921 Extensibility point in the WiX XML Schema. Schema extensions can register additional
4922 attributes at this point in the schema.
4923 </xs:documentation>
4924 </xs:annotation>
4925 </xs:anyAttribute>
4926 </xs:complexType>
4927 </xs:element>
4928 <xs:element name="Property">
4929 <xs:annotation>
4930 <xs:appinfo>
4931 <xse:seeAlso ref="PropertyRef" />
4932 <xse:msiRef table="Property" href="http://msdn.microsoft.com/library/aa370908.aspx" />
4933 <xse:howtoRef href="files_and_registry/check_the_version_number.html">How To: Check the version number of a file during installation</xse:howtoRef>
4934 </xs:appinfo>
4935 <xs:documentation>Property value for a Package or Module.</xs:documentation>
4936 </xs:annotation>
4937 <xs:complexType>
4938 <xs:choice minOccurs="0" maxOccurs="unbounded">
4939 <xs:element ref="ComplianceDrive" />
4940 <xs:element ref="ComponentSearch"/>
4941 <xs:element ref="RegistrySearch"/>
4942 <xs:element ref="RegistrySearchRef"/>
4943 <xs:element ref="IniFileSearch"/>
4944 <xs:element ref="DirectorySearch"/>
4945 <xs:element ref="DirectorySearchRef"/>
4946 <xs:element ref="ProductSearch"/>
4947 <xs:any namespace="##other" processContents="lax">
4948 <xs:annotation>
4949 <xs:documentation>
4950 Extensibility point in the WiX XML Schema. Schema extensions can register additional
4951 elements at this point in the schema.
4952 </xs:documentation>
4953 </xs:annotation>
4954 </xs:any>
4955 </xs:choice>
4956 <xs:attribute name="Id" type="xs:string" use="required">
4957 <xs:annotation>
4958 <xs:documentation>Unique identifier for Property.</xs:documentation>
4959 </xs:annotation>
4960 </xs:attribute>
4961 <xs:attribute name="Value" type="xs:string">
4962 <xs:annotation>
4963 <xs:documentation>Sets a default value for the property. The value will be overwritten if the Property is used for a search.</xs:documentation>
4964 </xs:annotation>
4965 </xs:attribute>
4966 <xs:attribute name="ComplianceCheck" type="YesNoTypeUnion">
4967 <xs:annotation>
4968 <xs:documentation>Adds a row to the CCPSearch table. This attribute is only valid when this Property contains a search element.</xs:documentation>
4969 </xs:annotation>
4970 </xs:attribute>
4971 <xs:attribute name="Admin" type="YesNoTypeUnion">
4972 <xs:annotation>
4973 <xs:documentation>
4974 Denotes that the property is saved during [administrative installations](https://learn.microsoft.com/en-us/windows/win32/msi/administrative-installation).
4975 Adds the property name to the [AdminProperties property](https://learn.microsoft.com/en-us/windows/win32/msi/adminproperties).
4976 </xs:documentation>
4977 </xs:annotation>
4978 </xs:attribute>
4979 <xs:attribute name="Secure" type="YesNoTypeUnion">
4980 <xs:annotation>
4981 <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="https://learn.microsoft.com/en-us/windows/win32/msi/securecustomproperties">SecureCustomProperties Property</html:a> for more information.</xs:documentation>
4982 </xs:annotation>
4983 </xs:attribute>
4984 <xs:attribute name="Hidden" type="YesNoTypeUnion">
4985 <xs:annotation>
4986 <xs:documentation>Denotes that the Property is not logged during installation. See the <html:a href="https://learn.microsoft.com/en-us/windows/win32/msi/msihiddenproperties">MsiHiddenProperties Property</html:a> for more information.</xs:documentation>
4987 </xs:annotation>
4988 </xs:attribute>
4989 <xs:attribute name="SuppressModularization" type="YesNoTypeUnion">
4990 <xs:annotation>
4991 <xs:documentation>
4992 Use to suppress modularization of this property identifier in merge modules.
4993 Using this functionality is strongly discouraged; it should only be
4994 necessary as a workaround of last resort in rare scenarios.
4995 </xs:documentation>
4996 </xs:annotation>
4997 </xs:attribute>
4998 <xs:anyAttribute namespace="##other" processContents="lax">
4999 <xs:annotation>
5000 <xs:documentation>
5001 Extensibility point in the WiX XML Schema. Schema extensions can register additional
5002 attributes at this point in the schema.
5003 </xs:documentation>
5004 </xs:annotation>
5005 </xs:anyAttribute>
5006 </xs:complexType>
5007 </xs:element>
5008 <xs:element name="PropertyRef">
5009 <xs:annotation>
5010 <xs:appinfo>
5011 <xse:seeAlso ref="Property" />
5012 <xse:howtoRef href="redistributables_and_install_checks/check_for_dotnet.html">How To: Check for .NET Framework versions</xse:howtoRef>
5013 </xs:appinfo>
5014 <xs:documentation>Reference to a Property value.</xs:documentation>
5015 </xs:annotation>
5016 <xs:complexType>
5017 <xs:choice minOccurs="0" maxOccurs="unbounded">
5018 <xs:any namespace="##other" processContents="lax">
5019 <xs:annotation>
5020 <xs:documentation>
5021 Extensibility point in the WiX XML Schema. Schema extensions can register additional
5022 elements at this point in the schema.
5023 </xs:documentation>
5024 </xs:annotation>
5025 </xs:any>
5026 </xs:choice>
5027 <xs:attribute name="Id" type="xs:string" use="required">
5028 <xs:annotation>
5029 <xs:documentation>Identifier of Property to reference.</xs:documentation>
5030 </xs:annotation>
5031 </xs:attribute>
5032 <xs:anyAttribute namespace="##other" processContents="lax">
5033 <xs:annotation>
5034 <xs:documentation>
5035 Extensibility point in the WiX XML Schema. Schema extensions can register additional
5036 attributes at this point in the schema.
5037 </xs:documentation>
5038 </xs:annotation>
5039 </xs:anyAttribute>
5040 </xs:complexType>
5041 </xs:element>
5042 <xs:element name="SoftwareTagRef">
5043 <xs:annotation>
5044 <xs:documentation>Reference to a SoftwareTag by Regid.</xs:documentation>
5045 </xs:annotation>
5046 <xs:complexType>
5047 <xs:choice minOccurs="0" maxOccurs="unbounded">
5048 <xs:any namespace="##other" processContents="lax">
5049 <xs:annotation>
5050 <xs:documentation>
5051 Extensibility point in the WiX XML Schema. Schema extensions can register additional
5052 elements at this point in the schema.
5053 </xs:documentation>
5054 </xs:annotation>
5055 </xs:any>
5056 </xs:choice>
5057 <xs:attribute name="Regid" type="xs:string" use="required">
5058 <xs:annotation>
5059 <xs:documentation>Regid of SoftwareTag to reference.</xs:documentation>
5060 </xs:annotation>
5061 </xs:attribute>
5062 <xs:anyAttribute namespace="##other" processContents="lax">
5063 <xs:annotation>
5064 <xs:documentation>
5065 Extensibility point in the WiX XML Schema. Schema extensions can register additional
5066 attributes at this point in the schema.
5067 </xs:documentation>
5068 </xs:annotation>
5069 </xs:anyAttribute>
5070 </xs:complexType>
5071 </xs:element>
5072 <xs:element name="Shortcut">
5073 <xs:annotation>
5074 <xs:documentation>
5075 Shortcut, default target is parent File, CreateFolder, or Component's Directory
5076 </xs:documentation>
5077 <xs:appinfo>
5078 <xse:msiRef table="Shortcut" href="http://msdn.microsoft.com/library/aa371847.aspx" />
5079 <xse:howtoRef href="files_and_registry/create_start_menu_shortcut.html">How To: Create a shortcut on the Start Menu</xse:howtoRef>
5080 </xs:appinfo>
5081 </xs:annotation>
5082 <xs:complexType>
5083 <xs:choice minOccurs="0" maxOccurs="unbounded">
5084 <xs:element ref="Icon" minOccurs="0" />
5085 <xs:element ref="ShortcutProperty" minOccurs="0" />
5086 </xs:choice>
5087 <xs:attribute name="Id" type="xs:string">
5088 <xs:annotation>
5089 <xs:documentation>Unique identifier for the shortcut. This value will serve as the primary key for the row.</xs:documentation>
5090 </xs:annotation>
5091 </xs:attribute>
5092 <xs:attribute name="Directory" type="xs:string">
5093 <xs:annotation>
5094 <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>
5095 </xs:annotation>
5096 </xs:attribute>
5097 <xs:attribute name="Name" type="LongFileNameType" use="required">
5098 <xs:annotation>
5099 <xs:documentation>
5100 If a short name is specified, the ShortName attribute may not be specified.
5101 If this value is a long name, the ShortName attribute may be omitted to
5102 allow WiX to attempt to generate a unique short name.
5103 However, if this name collides with another shortcut or you wish to manually specify
5104 the short name, then the ShortName attribute may be specified.
5105 </xs:documentation>
5106 </xs:annotation>
5107 </xs:attribute>
5108 <xs:attribute name="ShortName" type="ShortFileNameType">
5109 <xs:annotation>
5110 <xs:documentation>
5111 The short name of the shortcut in 8.3 format.
5112 This attribute should only be set if there is a conflict between generated short names
5113 or the user wants to manually specify the short name.
5114 </xs:documentation>
5115 </xs:annotation>
5116 </xs:attribute>
5117 <xs:attribute name="Target" type="xs:string">
5118 <xs:annotation>
5119 <xs:documentation>
5120 This attribute can only be set if this Shortcut element is nested under a Component element.
5121 When nested under a Component element, this attribute's value will default to the parent directory.
5122 This attribute's value is the target for a non-advertised shortcut.
5123 This attribute is not valid for advertised shortcuts.
5124 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.
5125 </xs:documentation>
5126 </xs:annotation>
5127 </xs:attribute>
5128 <xs:attribute name="Description" type="xs:string">
5129 <xs:annotation>
5130 <xs:documentation>The localizable description for the shortcut.</xs:documentation>
5131 </xs:annotation>
5132 </xs:attribute>
5133 <xs:attribute name="Arguments" type="xs:string">
5134 <xs:annotation>
5135 <xs:documentation>
5136 The command-line arguments for the shortcut. Note that the resolution of properties
5137 in the Arguments field is limited. A property formatted as [Property] in this field can only be resolved if the
5138 property already has the intended value when the component owning the shortcut is installed. For example, for the
5139 argument "[#MyDoc.doc]" to resolve to the correct value, the same process must be installing the file MyDoc.doc and
5140 the component that owns the shortcut.
5141 </xs:documentation>
5142 </xs:annotation>
5143 </xs:attribute>
5144 <xs:attribute name="Hotkey" type="Integer">
5145 <xs:annotation>
5146 <xs:documentation>
5147 The hotkey for the shortcut. The low-order byte contains the virtual-key code for
5148 the key, and the high-order byte contains modifier flags. This must be a non-negative number. Authors of
5149 installation packages are generally recommend not to set this option, because this can add duplicate hotkeys to a
5150 users desktop. In addition, the practice of assigning hotkeys to shortcuts can be problematic for users using hotkeys
5151 for accessibility.
5152 </xs:documentation>
5153 </xs:annotation>
5154 </xs:attribute>
5155 <xs:attribute name="Icon" type="xs:string">
5156 <xs:annotation>
5157 <xs:documentation>
5158 Identifier reference to Icon element. The Icon identifier should have the same extension
5159 as the file that it points at. For example, a shortcut to an executable (e.g. "my.exe") should reference an Icon with identifier
5160 like "MyIcon.exe"
5161 </xs:documentation>
5162 </xs:annotation>
5163 </xs:attribute>
5164 <xs:attribute name="IconIndex" type="Integer">
5165 <xs:annotation>
5166 <xs:documentation>Identifier reference to Icon element.</xs:documentation>
5167 </xs:annotation>
5168 </xs:attribute>
5169 <xs:attribute name="Show">
5170 <xs:simpleType>
5171 <xs:restriction base="xs:NMTOKEN">
5172 <xs:enumeration value="normal">
5173 <xs:annotation>
5174 <xs:documentation>
5175 The shortcut target will be displayed using the SW_SHOWNORMAL attribute.
5176 </xs:documentation>
5177 </xs:annotation>
5178 </xs:enumeration>
5179 <xs:enumeration value="minimized">
5180 <xs:annotation>
5181 <xs:documentation>
5182 The shortcut target will be displayed using the SW_SHOWMINNOACTIVE attribute.
5183 </xs:documentation>
5184 </xs:annotation>
5185 </xs:enumeration>
5186 <xs:enumeration value="maximized">
5187 <xs:annotation>
5188 <xs:documentation>
5189 The shortcut target will be displayed using the SW_SHOWMAXIMIZED attribute.
5190 </xs:documentation>
5191 </xs:annotation>
5192 </xs:enumeration>
5193 </xs:restriction>
5194 </xs:simpleType>
5195 </xs:attribute>
5196 <xs:attribute name="Subdirectory" type="xs:string">
5197 <xs:annotation>
5198 <xs:documentation>
5199 This attribute defines one or more directories below the directory referenced by the Directory attribute
5200 where the shortcut will be installed.
5201 </xs:documentation>
5202 </xs:annotation>
5203 </xs:attribute>
5204 <xs:attribute name="WorkingDirectory" type="xs:string">
5205 <xs:annotation>
5206 <xs:documentation>
5207 Directory identifier (or Property identifier that resolves to a directory) that resolves
5208 to the path of the working directory for the shortcut.
5209 </xs:documentation>
5210 </xs:annotation>
5211 </xs:attribute>
5212 <xs:attribute name="WorkingSubdirectory" type="xs:string">
5213 <xs:annotation>
5214 <xs:documentation>
5215 This attribute defines one or more directories below the directory referenced by the WorkingDirectory attribute
5216 for the shortcut's working directory.
5217 </xs:documentation>
5218 </xs:annotation>
5219 </xs:attribute>
5220 <xs:attribute name="Advertise" type="YesNoTypeUnion">
5221 <xs:annotation>
5222 <xs:documentation>
5223 Specifies if the shortcut should be advertised or not. Note that advertised shortcuts
5224 always point at a particular application, identified by a ProductCode, and should not be shared between applications.
5225 Advertised shortcuts only work for the most recently installed application, and are removed when that application is
5226 removed. The default value is 'no'.
5227 </xs:documentation>
5228 </xs:annotation>
5229 </xs:attribute>
5230 <xs:attribute name="DisplayResourceDll" type="xs:string">
5231 <xs:annotation>
5232 <xs:documentation>
5233 The Formatted string providing the full path to the language neutral file containing the MUI Manifest. Generally
5234 authored using [#filekey] form. When this attribute is specified, the DisplayResourceId attribute must also
5235 be provided.
5236
5237 This attribute is only used on Windows Vista and above. If this attribute is not populated and the install
5238 is running on Vista and above, the value in the Name attribute is used. If this attribute is populated and
5239 the install is running on Vista and above, the value in the Name attribute is ignored.
5240 </xs:documentation>
5241 </xs:annotation>
5242 </xs:attribute>
5243 <xs:attribute name="DisplayResourceId" type="Integer">
5244 <xs:annotation>
5245 <xs:documentation>
5246 The display name index for the shortcut. This must be a non-negative number. When this attribute is specified, the
5247 DisplayResourceDll attribute must also be provided.
5248
5249 This attribute is only used on Windows Vista and above. If this attribute is not specified and the install
5250 is running on Vista and above, the value in the Name attribute is used. If this attribute is specified and
5251 the install is running on Vista and above, the value in the Name attribute is ignored.
5252 </xs:documentation>
5253 </xs:annotation>
5254 </xs:attribute>
5255 <xs:attribute name="DescriptionResourceDll" type="xs:string">
5256 <xs:annotation>
5257 <xs:documentation>
5258 The Formatted string providing the full path to the language neutral file containing the MUI Manifest. Generally
5259 authored using [#filekey] form. When this attribute is specified, the DescriptionResourceId attribute must also
5260 be provided.
5261
5262 This attribute is only used on Windows Vista and above. If this attribute is not specified and the install
5263 is running on Vista and above, the value in the Name attribute is used. If this attribute is provided and
5264 the install is running on Vista and above, the value in the Name attribute is ignored.
5265 </xs:documentation>
5266 </xs:annotation>
5267 </xs:attribute>
5268 <xs:attribute name="DescriptionResourceId" type="Integer">
5269 <xs:annotation>
5270 <xs:documentation>
5271 The description name index for the shortcut. This must be a non-negative number. When this attribute is specified,
5272 the DescriptionResourceDll attribute must also be populated.
5273
5274 This attribute is only used on Windows Vista and above. If this attribute is not specified and the install
5275 is running on Vista and above, the value in the Name attribute is used. If this attribute is populated and the
5276 install is running on Vista and above, the value in the Name attribute is ignored.
5277 </xs:documentation>
5278 </xs:annotation>
5279 </xs:attribute>
5280 </xs:complexType>
5281 </xs:element>
5282 <xs:element name="ShortcutProperty">
5283 <xs:annotation>
5284 <xs:appinfo>
5285 <xse:seeAlso ref="Shortcut" />
5286 <xse:msiRef table="MsiShortcutProperty" />
5287 </xs:appinfo>
5288 <xs:documentation>Property values for a shortcut. This element's functionality is available starting with MSI 5.0.</xs:documentation>
5289 </xs:annotation>
5290 <xs:complexType>
5291 <xs:attribute name="Id" type="xs:string">
5292 <xs:annotation>
5293 <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>
5294 </xs:annotation>
5295 </xs:attribute>
5296 <xs:attribute name="Key" type="xs:string" use="required">
5297 <xs:annotation>
5298 <xs:documentation>A formatted string identifying the property to be set.</xs:documentation>
5299 </xs:annotation>
5300 </xs:attribute>
5301 <xs:attribute name="Value" type="xs:string">
5302 <xs:annotation>
5303 <xs:documentation>A formatted string supplying the value of the property.</xs:documentation>
5304 </xs:annotation>
5305 </xs:attribute>
5306 </xs:complexType>
5307 </xs:element>
5308 <xs:element name="Permission">
5309 <xs:annotation>
5310 <xs:documentation>
5311 Sets ACLs on File, Registry, or CreateFolder. When under a Registry element, this cannot be used
5312 if the Action attribute's value is remove or removeKeyOnInstall. This element has no Id attribute.
5313 The table and key are taken from the parent element.
5314 </xs:documentation>
5315 <xs:appinfo>
5316 <xse:msiRef table="LockPermissions" href="http://msdn.microsoft.com/library/aa369774.aspx" />
5317 </xs:appinfo>
5318 </xs:annotation>
5319 <xs:complexType>
5320 <xs:attribute name="Domain" type="xs:string"></xs:attribute>
5321 <xs:attribute name="User" use="required" type="xs:string"></xs:attribute>
5322 <!-- Common ACLs -->
5323 <xs:attribute name="Read" type="YesNoTypeUnion"></xs:attribute>
5324 <xs:attribute name="Delete" type="YesNoTypeUnion"></xs:attribute>
5325 <xs:attribute name="ReadPermission" type="YesNoTypeUnion"></xs:attribute>
5326 <xs:attribute name="ChangePermission" type="YesNoTypeUnion"></xs:attribute>
5327 <xs:attribute name="TakeOwnership" type="YesNoTypeUnion"></xs:attribute>
5328 <xs:attribute name="SpecificRightsAll" type="YesNoTypeUnion">
5329 <xs:annotation>
5330 <xs:documentation>Bit mask for SPECIFIC_RIGHTS_ALL from WinNT.h (0x0000FFFF).</xs:documentation>
5331 </xs:annotation>
5332 </xs:attribute>
5333 <!-- Folder and File ACLs -->
5334 <xs:attribute name="ReadAttributes" type="YesNoTypeUnion"></xs:attribute>
5335 <xs:attribute name="WriteAttributes" type="YesNoTypeUnion"></xs:attribute>
5336 <xs:attribute name="ReadExtendedAttributes" type="YesNoTypeUnion"></xs:attribute>
5337 <xs:attribute name="WriteExtendedAttributes" type="YesNoTypeUnion"></xs:attribute>
5338 <xs:attribute name="Synchronize" type="YesNoTypeUnion"></xs:attribute>
5339 <!-- Folder only ACLs -->
5340 <xs:attribute name="CreateFile" type="YesNoTypeUnion">
5341 <xs:annotation>
5342 <xs:documentation>For a directory, the right to create a file in the directory. Only valid under a 'CreateFolder' parent.</xs:documentation>
5343 </xs:annotation>
5344 </xs:attribute>
5345 <xs:attribute name="CreateChild" type="YesNoTypeUnion">
5346 <xs:annotation>
5347 <xs:documentation>For a directory, the right to create a subdirectory. Only valid under a 'CreateFolder' parent.</xs:documentation>
5348 </xs:annotation>
5349 </xs:attribute>
5350 <xs:attribute name="DeleteChild" type="YesNoTypeUnion">
5351 <xs:annotation>
5352 <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>
5353 </xs:annotation>
5354 </xs:attribute>
5355 <xs:attribute name="Traverse" type="YesNoTypeUnion">
5356 <xs:annotation>
5357 <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>
5358 </xs:annotation>
5359 </xs:attribute>
5360 <!-- File only ACLs -->
5361 <xs:attribute name="Append" type="YesNoTypeUnion"></xs:attribute>
5362 <xs:attribute name="Execute" type="YesNoTypeUnion"></xs:attribute>
5363 <xs:attribute name="FileAllRights" type="YesNoTypeUnion">
5364 <xs:annotation>
5365 <xs:documentation>Bit mask for FILE_ALL_ACCESS from WinNT.h (0x001F01FF).</xs:documentation>
5366 </xs:annotation>
5367 </xs:attribute>
5368 <!-- File and Registry ACLs -->
5369 <xs:attribute name="Write" type="YesNoTypeUnion"></xs:attribute>
5370 <!-- Registry only ACLs -->
5371 <xs:attribute name="CreateSubkeys" type="YesNoTypeUnion"></xs:attribute>
5372 <xs:attribute name="EnumerateSubkeys" type="YesNoTypeUnion"></xs:attribute>
5373 <xs:attribute name="Notify" type="YesNoTypeUnion"></xs:attribute>
5374 <xs:attribute name="CreateLink" type="YesNoTypeUnion"></xs:attribute>
5375 <!-- Generic ACLs, mapped by system to appropriate permissions -->
5376 <xs:attribute name="GenericAll" type="YesNoTypeUnion"></xs:attribute>
5377 <xs:attribute name="GenericExecute" type="YesNoTypeUnion"></xs:attribute>
5378 <xs:attribute name="GenericWrite" type="YesNoTypeUnion"></xs:attribute>
5379 <xs:attribute name="GenericRead" type="YesNoTypeUnion">
5380 <xs:annotation>
5381 <xs:documentation>specifying this will fail to grant read access</xs:documentation>
5382 </xs:annotation>
5383 </xs:attribute>
5384 </xs:complexType>
5385 </xs:element>
5386 <xs:element name="PermissionEx">
5387 <xs:annotation>
5388 <xs:documentation>
5389 Sets ACLs on File, Registry, or CreateFolder. When under a Registry element, this cannot be used
5390 if the Action attribute's value is remove or removeKeyOnInstall. This element is only available
5391 when installing with MSI 5.0. For downlevel support, see the PermissionEx element from the
5392 WixUtilExtension.
5393 </xs:documentation>
5394 <xs:appinfo>
5395 <xse:msiRef table="MsiLockPermissionsEx" href="http://msdn.microsoft.com/library/aa369774.aspx" />
5396 </xs:appinfo>
5397 </xs:annotation>
5398 <xs:complexType>
5399 <xs:attribute name="Id" type="xs:string">
5400 <xs:annotation>
5401 <xs:documentation>
5402 Primary key used to identify this particular entry. If this is not specified the parent element's Id attribute
5403 will be used instead.
5404 </xs:documentation>
5405 </xs:annotation>
5406 </xs:attribute>
5407 <xs:attribute name="Condition" type="xs:string">
5408 <xs:annotation>
5409 <xs:documentation>
5410 Optional condition that controls whether the permissions are applied.
5411 </xs:documentation>
5412 </xs:annotation>
5413 </xs:attribute>
5414 <xs:attribute name="Sddl" type="xs:string" use="required">
5415 <xs:annotation>
5416 <xs:documentation>
5417 Security descriptor to apply to parent object.
5418 </xs:documentation>
5419 </xs:annotation>
5420 </xs:attribute>
5421 </xs:complexType>
5422 </xs:element>
5423 <xs:element name="CopyFile">
5424 <xs:annotation>
5425 <xs:appinfo>
5426 <xse:seeAlso ref="RemoveFile" />
5427 <xse:msiRef table="DuplicateFile" href="http://msdn.microsoft.com/library/aa368335.aspx" />
5428 <xse:msiRef table="MoveFile" href="http://msdn.microsoft.com/library/aa370055.aspx" />
5429 </xs:appinfo>
5430 <xs:documentation>
5431 Copy or move an existing file on the target machine, or copy a file that is being installed, to another destination. When
5432 this element is nested under a File element, the parent file will be installed, then copied to the specified destination
5433 if the parent component of the file is selected for installation or removal. When this element is nested under
5434 a Component element and no FileId attribute is specified, the file to copy or move must already be on the target machine.
5435 When this element is nested under a Component element and the FileId attribute is specified, the specified file is installed,
5436 then copied to the specified destination if the parent component is selected for installation or removal (use
5437 this option to control the copy of a file in a different component by the parent component's installation state). If the
5438 specified destination directory is the same as the directory containing the original file and the name for the proposed source
5439 file is the same as the original, then no action takes place.
5440 </xs:documentation>
5441 </xs:annotation>
5442 <xs:complexType>
5443 <xs:attribute name="Id" type="xs:string" use="required">
5444 <xs:annotation>
5445 <xs:documentation>Primary key used to identify this particular entry.</xs:documentation>
5446 </xs:annotation>
5447 </xs:attribute>
5448 <xs:attribute name="FileId" type="xs:string">
5449 <xs:annotation>
5450 <xs:documentation>
5451 This attribute cannot be specified if the element is nested under a File element. Set this attribute's value to the identifier
5452 of a file from a different component to copy it based on the install state of the parent component.
5453 </xs:documentation>
5454 </xs:annotation>
5455 </xs:attribute>
5456 <xs:attribute name="SourceDirectory" type="xs:string">
5457 <xs:annotation>
5458 <xs:documentation>
5459 This attribute cannot be specified if the element is nested under a File element or the FileId attribute is specified. Set
5460 this value to the source directory from which to copy or move an existing file on the target machine. This Directory must
5461 exist in the installer database at creation time. This attribute cannot be specified in conjunction with SourceProperty.
5462 </xs:documentation>
5463 </xs:annotation>
5464 </xs:attribute>
5465 <xs:attribute name="SourceProperty" type="xs:string">
5466 <xs:annotation>
5467 <xs:documentation>
5468 This attribute cannot be specified if the element is nested under a File element or the FileId attribute is specified. Set
5469 this value to a property that will have a value that resolves to the full path of the source directory (or full path
5470 including file name if SourceName is not specified). The property does not have to exist in the installer database at
5471 creation time; it could be created at installation time by a custom action, on the command line, etc. This attribute
5472 cannot be specified in conjunction with SourceDirectory.
5473 </xs:documentation>
5474 </xs:annotation>
5475 </xs:attribute>
5476 <xs:attribute name="SourceName" type="WildCardLongFileNameType">
5477 <xs:annotation>
5478 <xs:documentation>
5479 This attribute cannot be specified if the element is nested under a File element or the FileId attribute is specified. Set
5480 this value to the localizable name of the file(s) to be copied or moved. All of the files that
5481 match the wild card will be removed from the specified directory. The value is a filename that may also
5482 contain the wild card characters "?" for any single character or "*" for zero or more occurrences of any character. If this
5483 attribute is not specified (and this element is not nested under a File element or specify a FileId attribute) then the
5484 SourceProperty attribute should be set to the name of a property that will resolve to the full path of the source filename.
5485 If the value of this attribute contains a "*" wildcard and the DestinationName attribute is specified, all moved or copied
5486 files retain the file names from their sources.
5487 </xs:documentation>
5488 </xs:annotation>
5489 </xs:attribute>
5490 <xs:attribute name="DestinationDirectory" type="xs:string">
5491 <xs:annotation>
5492 <xs:documentation>
5493 Set this value to the destination directory where an existing file on the target machine should be moved or copied to. This
5494 Directory must exist in the installer database at creation time. This attribute cannot be specified in conjunction with
5495 DestinationProperty.
5496 </xs:documentation>
5497 </xs:annotation>
5498 </xs:attribute>
5499 <xs:attribute name="DestinationProperty" type="xs:string">
5500 <xs:annotation>
5501 <xs:documentation>
5502 Set this value to a property that will have a value that resolves to the full path of the destination directory. The property
5503 does not have to exist in the installer database at creation time; it could be created at installation time by a custom
5504 action, on the command line, etc. This attribute cannot be specified in conjunction with DestinationDirectory.
5505 </xs:documentation>
5506 </xs:annotation>
5507 </xs:attribute>
5508 <xs:attribute name="DestinationName" type="LongFileNameType">
5509 <xs:annotation>
5510 <xs:documentation>
5511 In prior versions of the WiX toolset, this attribute specified the short file name.
5512 Now set this value to the localizable name to be given to the original file after it is moved or copied.
5513 If this attribute is not specified, then the destination file is given the same name as the source file.
5514 If a short file name is specified, the DestinationShortName attribute may not be specified.
5515 Also, if this value is a long file name, the DestinationShortName attribute may be omitted to
5516 allow WiX to attempt to generate a unique short file name.
5517 However, if this name collides with another file or you wish to manually specify
5518 the short file name, then the DestinationShortName attribute may be specified.
5519 </xs:documentation>
5520 </xs:annotation>
5521 </xs:attribute>
5522 <xs:attribute name="DestinationShortName" type="ShortFileNameType">
5523 <xs:annotation>
5524 <xs:documentation>
5525 The short file name of the file in 8.3 format.
5526 This attribute should only be set if there is a conflict between generated short file names
5527 or you wish to manually specify the short file name.
5528 </xs:documentation>
5529 </xs:annotation>
5530 </xs:attribute>
5531 <xs:attribute name="Delete" type="YesNoTypeUnion">
5532 <xs:annotation>
5533 <xs:documentation>
5534 This attribute cannot be specified if the element is nested under a File element or the FileId attribute is specified. In other
5535 cases, if the attribute is not specified, the default value is "no" and the file is copied, not moved. Set the value to "yes"
5536 in order to move the file (thus deleting the source file) instead of copying it.
5537 </xs:documentation>
5538 </xs:annotation>
5539 </xs:attribute>
5540 </xs:complexType>
5541 </xs:element>
5542 <xs:element name="File">
5543 <xs:annotation>
5544 <xs:documentation>
5545 Defines a file to be installed by the package.
5546 </xs:documentation>
5547 <xs:appinfo>
5548 <xse:msiRef table="File" href="https://learn.microsoft.com/en-us/windows/win32/msi/file-table" />
5549 <xse:howtoRef href="files_and_registry/add_a_file.html">How To: Add a file to your installer</xse:howtoRef>
5550 </xs:appinfo>
5551 </xs:annotation>
5552 <xs:complexType>
5553 <xs:choice minOccurs="0" maxOccurs="unbounded">
5554 <xs:element ref="AssemblyName" />
5555 <xs:element ref="Permission">
5556 <xs:annotation>
5557 <xs:documentation>Used to configure the ACLs for this file.</xs:documentation>
5558 </xs:annotation>
5559 </xs:element>
5560 <xs:element ref="PermissionEx">
5561 <xs:annotation>
5562 <xs:documentation>Can also configure the ACLs for this file.</xs:documentation>
5563 </xs:annotation>
5564 </xs:element>
5565 <xs:element ref="CopyFile">
5566 <xs:annotation>
5567 <xs:documentation>Used to create a duplicate of this file elsewhere.</xs:documentation>
5568 </xs:annotation>
5569 </xs:element>
5570 <xs:element ref="Shortcut">
5571 <xs:annotation>
5572 <xs:documentation>Target of the shortcut will be set to this file.</xs:documentation>
5573 </xs:annotation>
5574 </xs:element>
5575 <xs:element ref="ODBCDriver" />
5576 <xs:element ref="ODBCTranslator" />
5577 <xs:element ref="SymbolPath" />
5578 <xs:element ref="Class" />
5579 <xs:element ref="AppId" />
5580 <xs:element ref="TypeLib" />
5581 <xs:any namespace="##other" processContents="lax">
5582 <xs:annotation>
5583 <xs:documentation>
5584 Extensibility point in the WiX XML Schema. Schema extensions can register additional
5585 elements at this point in the schema.
5586 </xs:documentation>
5587 </xs:annotation>
5588 </xs:any>
5589 </xs:choice>
5590 <xs:attribute name="Id" type="xs:string">
5591 <xs:annotation>
5592 <xs:documentation>
5593 The unique identifier for this File element. If you omit Id, a stable identifier is generated for you.
5594 </xs:documentation>
5595 </xs:annotation>
5596 </xs:attribute>
5597 <xs:attribute name="Bitness" type="BitnessTypeUnion">
5598 <xs:annotation>
5599 <xs:documentation>
5600 [WiX v5] Only valid when the File element is not a child of the Component element.
5601 Overrides the default File bitness. Only a 64-bit File can install to 64-bit locations such
5602 as `ProgramFiles64Folder` and the 64-bit registry. The value `always64` will force the File
5603 bitness to be 64-bit and cannot be included in 32-bit packages.
5604 Simliarly, the value `always32` will force the File bitness to 32-bit and can be included in
5605 32-bit or 64-bit packages.
5606 The default value is `default` where the File will be installed using the
5607 same bitness as the package.
5608 </xs:documentation>
5609 </xs:annotation>
5610 </xs:attribute>
5611 <xs:attribute name="CompanionFile" type="xs:string">
5612 <xs:annotation>
5613 <xs:documentation>
5614 Set this attribute to make this file a companion child of another file. The installation
5615 state of a companion file depends not on its own file versioning information, but on the versioning of its
5616 companion parent. A file that is the key path for its component can not be a companion file (that means
5617 this attribute cannot be set if KeyPath="yes" for this file). The Version attribute cannot be set along
5618 with this attribute since companion files are not installed based on their own version.</xs:documentation>
5619 </xs:annotation>
5620 </xs:attribute>
5621 <xs:attribute name="Condition" type="xs:string">
5622 <xs:annotation>
5623 <xs:documentation>
5624 [WiX v5] Only valid when the File element is not a child of the Component element.
5625 The condition expression to be evaluated at install time. When false the File will not be installed.
5626 </xs:documentation>
5627 </xs:annotation>
5628 </xs:attribute>
5629 <xs:attribute name="Directory" type="xs:string">
5630 <xs:annotation>
5631 <xs:documentation>
5632 [WiX v5] Only valid when the File element is not a child of the Component element.
5633 This attribute specifies a reference to a Directory element with matching Id attribute containing a directory path.
5634 If not provided, the value will default to "INSTALLFOLDER".
5635 </xs:documentation>
5636 </xs:annotation>
5637 </xs:attribute>
5638 <xs:attribute name="Subdirectory" type="xs:string">
5639 <xs:annotation>
5640 <xs:documentation>
5641 [WiX v5] Only valid when the File element is not a child of the Component element.
5642 This attribute defines one or more directories below the directory referenced by the Directory attribute.
5643 </xs:documentation>
5644 </xs:annotation>
5645 </xs:attribute>
5646 <xs:attribute name="Name" type="LongFileNameType">
5647 <xs:annotation>
5648 <xs:documentation>
5649 Specifies the name of the installed file. If this attribute is omitted, then
5650 its default value is the file name portion of the Source attribute. If the
5651 Source attribute is omitted, you must specify a Name attribute. For more
5652 information, see [Specifying source files](../../tools/payloads.md).
5653 </xs:documentation>
5654 </xs:annotation>
5655 </xs:attribute>
5656 <xs:attribute name="KeyPath" type="YesNoTypeUnion">
5657 <xs:annotation>
5658 <xs:documentation>Set to yes in order to force this file to be the key path for the parent component.</xs:documentation>
5659 </xs:annotation>
5660 </xs:attribute>
5661 <xs:attribute name="ShortName" type="ShortFileNameType">
5662 <xs:annotation>
5663 <xs:documentation>
5664 The short file name of the file in 8.3 format.
5665 This attribute should only be set if there is a conflict between generated short file names
5666 or the user wants to manually specify the short file name.
5667 </xs:documentation>
5668 </xs:annotation>
5669 </xs:attribute>
5670 <xs:attribute name="ReadOnly" type="YesNoTypeUnion">
5671 <xs:annotation>
5672 <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>
5673 </xs:annotation>
5674 </xs:attribute>
5675 <xs:attribute name="Hidden" type="YesNoTypeUnion">
5676 <xs:annotation>
5677 <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>
5678 </xs:annotation>
5679 </xs:attribute>
5680 <xs:attribute name="System" type="YesNoTypeUnion">
5681 <xs:annotation>
5682 <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>
5683 </xs:annotation>
5684 </xs:attribute>
5685 <xs:attribute name="Vital" type="YesNoTypeUnion">
5686 <xs:annotation>
5687 <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>
5688 </xs:annotation>
5689 </xs:attribute>
5690 <xs:attribute name="Checksum" type="YesNoTypeUnion">
5691 <xs:annotation>
5692 <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>
5693 </xs:annotation>
5694 </xs:attribute>
5695 <xs:attribute name="Compressed" type="YesNoDefaultTypeUnion">
5696 <xs:annotation>
5697 <xs:documentation>Sets the file's source type compression. A setting of "yes"/"true", or "no"/"false" will override the setting in the Word Count Summary Property.</xs:documentation>
5698 </xs:annotation>
5699 </xs:attribute>
5700 <xs:attribute name="BindPath" type="xs:string">
5701 <xs:annotation>
5702 <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>
5703 </xs:annotation>
5704 </xs:attribute>
5705 <xs:attribute name="SelfRegCost" type="Integer">
5706 <xs:annotation>
5707 <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>
5708 </xs:annotation>
5709 </xs:attribute>
5710 <xs:attribute name="TrueType" type="YesNoTypeUnion">
5711 <xs:annotation>
5712 <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>
5713 </xs:annotation>
5714 </xs:attribute>
5715 <xs:attribute name="FontTitle" type="xs:string">
5716 <xs:annotation>
5717 <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>
5718 </xs:annotation>
5719 </xs:attribute>
5720 <xs:attribute name="DefaultLanguage" type="xs:string">
5721 <xs:annotation>
5722 <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>
5723 </xs:annotation>
5724 </xs:attribute>
5725 <xs:attribute name="DefaultSize" type="Integer">
5726 <xs:annotation>
5727 <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>
5728 </xs:annotation>
5729 </xs:attribute>
5730 <xs:attribute name="DefaultVersion" type="xs:string">
5731 <xs:annotation>
5732 <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>
5733 </xs:annotation>
5734 </xs:attribute>
5735 <xs:attribute name="Assembly">
5736 <xs:annotation>
5737 <xs:documentation>
5738 Specifies if this File is a Win32 Assembly or .NET Assembly that needs to be installed into the
5739 Global Assembly Cache (GAC). If the value is '.net' or 'win32', this file must also be the key path of the Component.
5740 </xs:documentation>
5741 </xs:annotation>
5742 <xs:simpleType>
5743 <xs:restriction base="xs:NMTOKEN">
5744 <xs:enumeration value=".net">
5745 <xs:annotation>
5746 <xs:documentation>
5747 The file is a .NET Framework assembly.
5748 </xs:documentation>
5749 </xs:annotation>
5750 </xs:enumeration>
5751 <xs:enumeration value="no">
5752 <xs:annotation>
5753 <xs:documentation>
5754 The file is not a .NET Framework or Win32 assembly. This is the default value.
5755 </xs:documentation>
5756 </xs:annotation>
5757 </xs:enumeration>
5758 <xs:enumeration value="win32">
5759 <xs:annotation>
5760 <xs:documentation>
5761 The file is a Win32 assembly.
5762 </xs:documentation>
5763 </xs:annotation>
5764 </xs:enumeration>
5765 </xs:restriction>
5766 </xs:simpleType>
5767 </xs:attribute>
5768 <xs:attribute name="AssemblyManifest" type="xs:string">
5769 <xs:annotation>
5770 <xs:documentation>
5771 Specifies the file identifier of the manifest file that describes this assembly.
5772 The manifest file should be in the same component as the assembly it describes.
5773 This attribute may only be specified if the Assembly attribute is set to '.net' or 'win32'.
5774 </xs:documentation>
5775 </xs:annotation>
5776 </xs:attribute>
5777 <xs:attribute name="AssemblyApplication" type="xs:string">
5778 <xs:annotation>
5779 <xs:documentation>
5780 Specifies the file identifier of the application file. This assembly will be isolated
5781 to the same directory as the application file.
5782 If this attribute is absent, the assembly will be installed to the Global Assembly Cache (GAC).
5783 This attribute may only be specified if the Assembly attribute is set to '.net' or 'win32'.
5784 </xs:documentation>
5785 </xs:annotation>
5786 </xs:attribute>
5787 <xs:attribute name="ProcessorArchitecture">
5788 <xs:annotation>
5789 <xs:documentation>Specifies the architecture for this assembly. This attribute should only be used on .NET Framework 2.0 or higher assemblies.</xs:documentation>
5790 </xs:annotation>
5791 <xs:simpleType>
5792 <xs:restriction base="xs:NMTOKEN">
5793 <xs:enumeration value="msil">
5794 <xs:annotation>
5795 <xs:documentation>
5796 The file is a .NET Framework assembly that is processor-neutral.
5797 </xs:documentation>
5798 </xs:annotation>
5799 </xs:enumeration>
5800 <xs:enumeration value="x86">
5801 <xs:annotation>
5802 <xs:documentation>
5803 The file is a .NET Framework assembly for the x86 processor.
5804 </xs:documentation>
5805 </xs:annotation>
5806 </xs:enumeration>
5807 <xs:enumeration value="x64">
5808 <xs:annotation>
5809 <xs:documentation>
5810 The file is a .NET Framework assembly for the x64 processor.
5811 </xs:documentation>
5812 </xs:annotation>
5813 </xs:enumeration>
5814 <xs:enumeration value="ia64">
5815 <xs:annotation>
5816 <xs:documentation>
5817 The file is a .NET Framework assembly for the ia64 processor.
5818 </xs:documentation>
5819 </xs:annotation>
5820 </xs:enumeration>
5821 </xs:restriction>
5822 </xs:simpleType>
5823 </xs:attribute>
5824 <xs:attribute name="DiskId" type="DiskIdType">
5825 <xs:annotation>
5826 <xs:documentation>
5827 The value of this attribute should correspond to the Id attribute of a Media
5828 element authored elsewhere. By creating this connection between a file and
5829 its media, you set the packaging options to the values specified in the Media
5830 element (values such as compression level, cab embedding, etc...). Specifying
5831 the DiskId attribute on the File element overrides the default DiskId attribute
5832 from the parent Component element. If no DiskId attribute is specified,
5833 the default is "1". This DiskId attribute is ignored when creating a merge module
5834 because merge modules do not have media.
5835 </xs:documentation>
5836 </xs:annotation>
5837 </xs:attribute>
5838 <xs:attribute name="Source" type="xs:string">
5839 <xs:annotation>
5840 <xs:documentation>
5841 Specifies the path to the file in the build process. Overrides default source
5842 path set by parent directories and Name attribute. This attribute must be set
5843 if no source information can be gathered from parent directories. For more
5844 information, see [Specifying source files](../../tools/payloads.md).
5845 </xs:documentation>
5846 </xs:annotation>
5847 </xs:attribute>
5848 <xs:attribute name="PatchGroup" type="Integer">
5849 <xs:annotation>
5850 <xs:documentation>
5851 This attribute must be set for patch-added files. Each patch should be assigned a different patch group number. Patch groups
5852 numbers must be greater 0 and should be assigned consecutively. For example, the first patch should use PatchGroup='1', the
5853 second patch will have PatchGroup='2', etc...
5854 </xs:documentation>
5855 </xs:annotation>
5856 </xs:attribute>
5857 <xs:attribute name="PatchIgnore" type="YesNoTypeUnion">
5858 <xs:annotation>
5859 <xs:documentation>Prevents the updating of the file that is in fact changed in the upgraded image relative to the target images.</xs:documentation>
5860 </xs:annotation>
5861 </xs:attribute>
5862 <xs:attribute name="PatchAllowIgnoreOnError" type="YesNoTypeUnion">
5863 <xs:annotation>
5864 <xs:documentation>Set to indicate that the patch is non-vital.</xs:documentation>
5865 </xs:annotation>
5866 </xs:attribute>
5867 <xs:attribute name="PatchWholeFile" type="YesNoTypeUnion">
5868 <xs:annotation>
5869 <xs:documentation>Set if the entire file should be installed rather than creating a binary patch.</xs:documentation>
5870 </xs:annotation>
5871 </xs:attribute>
5872 <xs:anyAttribute namespace="##other" processContents="lax">
5873 <xs:annotation>
5874 <xs:documentation>
5875 Extensibility point in the WiX XML Schema. Schema extensions can register additional
5876 attributes at this point in the schema.
5877 </xs:documentation>
5878 </xs:annotation>
5879 </xs:anyAttribute>
5880 </xs:complexType>
5881 </xs:element>
5882 <xs:element name="MultiString">
5883 <xs:annotation>
5884 <xs:documentation>
5885 Use several of these elements to specify each registry value in a multiString registry value. This element
5886 cannot be used if the Value attribute is specified unless the Type attribute is set to 'multiString'.
5887 </xs:documentation>
5888 <xs:appinfo>
5889 <xse:msiRef table="Registry" href="https://learn.microsoft.com/en-us/windows/win32/msi/registry-table" />
5890 </xs:appinfo>
5891 </xs:annotation>
5892 <xs:complexType>
5893 <xs:attribute name="Value" type="xs:string">
5894 <xs:annotation>
5895 <xs:documentation>
5896 The multi-string value.
5897 </xs:documentation>
5898 </xs:annotation>
5899 </xs:attribute>
5900 </xs:complexType>
5901 </xs:element>
5902 <xs:element name="MultiStringValue">
5903 <xs:annotation>
5904 <xs:documentation>
5905 Use several of these elements to specify each registry value in a multiString registry value. This element
5906 cannot be used if the Value attribute is specified unless the Type attribute is set to 'multiString'.
5907
5908 Consider using the MultiString element instead.
5909 </xs:documentation>
5910 <xs:appinfo>
5911 <xse:seeAlso ref="MultiString" />
5912 <xse:msiRef table="Registry" href="https://learn.microsoft.com/en-us/windows/win32/msi/registry-table" />
5913 </xs:appinfo>
5914 </xs:annotation>
5915 <xs:complexType>
5916 <xs:attribute name="Value" type="xs:string">
5917 <xs:annotation>
5918 <xs:documentation>The multi-string value.</xs:documentation>
5919 </xs:annotation>
5920 </xs:attribute>
5921 </xs:complexType>
5922 </xs:element>
5923 <xs:element name="RegistryKey">
5924 <xs:annotation>
5925 <xs:documentation>
5926 Used for organization of child RegistryValue elements or to create a registry key
5927 (and optionally remove it during uninstallation).
5928 </xs:documentation>
5929 <xs:appinfo>
5930 <xse:msiRef table="Registry" href="https://learn.microsoft.com/en-us/windows/win32/msi/registry-table" />
5931 <xse:howtoRef href="files_and_registry/read_a_registry_entry.html">How To: Read a registry entry during installation</xse:howtoRef>
5932 <xse:howtoRef href="files_and_registry/write_a_registry_entry.html">How To: Write a registry entry during installation</xse:howtoRef>
5933 </xs:appinfo>
5934 </xs:annotation>
5935 <xs:complexType>
5936 <xs:choice minOccurs="0" maxOccurs="unbounded">
5937 <xs:element ref="RegistryKey" />
5938 <xs:element ref="RegistryValue" />
5939 <xs:element ref="Permission" minOccurs="0" maxOccurs="unbounded">
5940 <xs:annotation>
5941 <xs:documentation>ACL permission</xs:documentation>
5942 </xs:annotation>
5943 </xs:element>
5944 <xs:element ref="PermissionEx">
5945 <xs:annotation>
5946 <xs:documentation>Can also configure the ACLs for this registry key.</xs:documentation>
5947 </xs:annotation>
5948 </xs:element>
5949 <xs:any namespace="##other" processContents="lax">
5950 <xs:annotation>
5951 <xs:documentation>
5952 Extensibility point in the WiX XML Schema. Schema extensions can register additional
5953 elements at this point in the schema.
5954 </xs:documentation>
5955 </xs:annotation>
5956 </xs:any>
5957 </xs:choice>
5958 <xs:attribute name="Id" type="xs:string">
5959 <xs:annotation>
5960 <xs:documentation>
5961 Primary key used to identify this particular entry. If this attribute is not specified, an identifier will be
5962 generated.
5963 </xs:documentation>
5964 </xs:annotation>
5965 </xs:attribute>
5966 <xs:attribute name="Action">
5967 <xs:annotation>
5968 <xs:documentation>
5969 The Action attribute has been deprecated. In most cases, you can simply omit @Action. If you need to force Windows Installer
5970 to create an empty key or recursively delete the key, use the ForceCreateOnInstall or ForceDeleteOnUninstall attributes instead.
5971 </xs:documentation>
5972 </xs:annotation>
5973 <xs:simpleType>
5974 <xs:restriction base="xs:NMTOKEN">
5975 <xs:enumeration value="create">
5976 <xs:annotation>
5977 <xs:documentation>
5978 Creates the key, if absent, when the parent component is installed.
5979 </xs:documentation>
5980 </xs:annotation>
5981 </xs:enumeration>
5982 <xs:enumeration value="createAndRemoveOnUninstall">
5983 <xs:annotation>
5984 <xs:documentation>
5985 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.
5986 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
5987 removes all values and subkeys that it creates, so this option just adds additional overhead to uninstall.
5988 </xs:documentation>
5989 </xs:annotation>
5990 </xs:enumeration>
5991 <xs:enumeration value="none">
5992 <xs:annotation>
5993 <xs:documentation>
5994 Does nothing; this element is used merely in WiX authoring for organization and does nothing to the final output.
5995 This is the default value.
5996 </xs:documentation>
5997 </xs:annotation>
5998 </xs:enumeration>
5999 </xs:restriction>
6000 </xs:simpleType>
6001 </xs:attribute>
6002 <xs:attribute name="ForceCreateOnInstall" type="YesNoTypeUnion">
6003 <xs:annotation>
6004 <xs:documentation>
6005 Set this attribute to 'yes' to create an empty key, if absent, when the parent component is installed.
6006 This value is needed only to create an empty key with no subkeys or values. Windows Installer creates
6007 keys as needed to store subkeys and values. The default is "no".
6008 </xs:documentation>
6009 </xs:annotation>
6010 </xs:attribute>
6011 <xs:attribute name="ForceDeleteOnUninstall" type="YesNoTypeUnion">
6012 <xs:annotation>
6013 <xs:documentation>
6014 Set this attribute to 'yes' to remove the key with all its values and subkeys when the parent component is uninstalled.
6015 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
6016 removes all values and subkeys that it creates, so this option just adds additional overhead to uninstall.
6017 The default is "no".
6018 </xs:documentation>
6019 </xs:annotation>
6020 </xs:attribute>
6021 <xs:attribute name="Key" type="xs:string">
6022 <xs:annotation>
6023 <xs:documentation>
6024 The localizable key for the registry value.
6025 If the parent element is a RegistryKey, this value may be omitted to use the
6026 path of the parent, or if its specified it will be appended to the path of the parent.
6027 </xs:documentation>
6028 </xs:annotation>
6029 </xs:attribute>
6030 <xs:attribute name="Root" type="RegistryRootType">
6031 <xs:annotation>
6032 <xs:documentation>
6033 The predefined root key for the registry value.
6034 </xs:documentation>
6035 </xs:annotation>
6036 </xs:attribute>
6037 <xs:anyAttribute namespace="##other" processContents="lax">
6038 <xs:annotation>
6039 <xs:documentation>
6040 Extensibility point in the WiX XML Schema. Schema extensions can register additional
6041 attributes at this point in the schema.
6042 </xs:documentation>
6043 </xs:annotation>
6044 </xs:anyAttribute>
6045 </xs:complexType>
6046 </xs:element>
6047 <xs:element name="RegistryValue">
6048 <xs:annotation>
6049 <xs:documentation>
6050 Used to create a registry value. For multi-string values, this can be used to prepend or append values.
6051
6052 For legacy authoring: Use several of these elements to specify each registry value in a multiString registry value. This element
6053 cannot be used if the Value attribute is specified unless the Type attribute is set to 'multiString'.
6054 </xs:documentation>
6055 <xs:appinfo>
6056 <xse:msiRef table="Registry" href="https://learn.microsoft.com/en-us/windows/win32/msi/registry-table" />
6057 <xse:howtoRef href="files_and_registry/write_a_registry_entry.html">How To: Write a registry entry during installation</xse:howtoRef>
6058 </xs:appinfo>
6059 </xs:annotation>
6060 <xs:complexType>
6061 <xs:choice minOccurs="0" maxOccurs="unbounded">
6062 <xs:element ref="Permission" />
6063 <xs:element ref="PermissionEx">
6064 <xs:annotation>
6065 <xs:documentation>Can also configure the ACLs for this registry value.</xs:documentation>
6066 </xs:annotation>
6067 </xs:element>
6068 <xs:element ref="MultiString" />
6069 <xs:element ref="MultiStringValue" />
6070 <xs:any namespace="##other" processContents="lax">
6071 <xs:annotation>
6072 <xs:documentation>
6073 Extensibility point in the WiX XML Schema. Schema extensions can register additional
6074 elements at this point in the schema.
6075 </xs:documentation>
6076 </xs:annotation>
6077 </xs:any>
6078 </xs:choice>
6079 <xs:attribute name="Id" type="xs:string">
6080 <xs:annotation>
6081 <xs:documentation>
6082 Primary key used to identify this particular entry. If this attribute is not specified, an identifier will be
6083 generated by hashing the parent Component identifier, Root, Key, and Name.
6084 </xs:documentation>
6085 </xs:annotation>
6086 </xs:attribute>
6087 <xs:attribute name="Root" type="RegistryRootType">
6088 <xs:annotation>
6089 <xs:documentation>
6090 The predefined root key for the registry value.
6091 </xs:documentation>
6092 </xs:annotation>
6093 </xs:attribute>
6094 <xs:attribute name="Key" type="xs:string">
6095 <xs:annotation>
6096 <xs:documentation>
6097 The localizable key for the registry value.
6098 If the parent element is a RegistryKey, this value may be omitted to use the
6099 path of the parent, or if its specified it will be appended to the path of the parent.
6100 </xs:documentation>
6101 </xs:annotation>
6102 </xs:attribute>
6103 <xs:attribute name="Name" type="xs:string">
6104 <xs:annotation>
6105 <xs:documentation>
6106 The localizable registry value name. If this attribute is not provided the default value for the registry key will
6107 be set instead. The Windows Installer allows several special values to be set for this attribute. You should not
6108 use them in WiX. Instead use appropriate values in the Action attribute to get the desired behavior.
6109 </xs:documentation>
6110 </xs:annotation>
6111 </xs:attribute>
6112 <xs:attribute name="Value" type="xs:string">
6113 <xs:annotation>
6114 <xs:documentation>
6115 Set this attribute to the localizable registry value. This value is formatted. The Windows Installer allows
6116 several special values to be set for this attribute. You should not use them in WiX. Instead use appropriate
6117 values in the Type attribute to get the desired behavior.
6118 </xs:documentation>
6119 </xs:annotation>
6120 </xs:attribute>
6121 <xs:attribute name="Type">
6122 <xs:annotation>
6123 <xs:documentation>
6124 Set this attribute to the type of the desired registry key. This attribute must be specified whenever the Value
6125 attribute or a child RegistryValue element is specified. This attribute
6126 should only be set when the value of the Action attribute does not include the word 'remove'.
6127 </xs:documentation>
6128 </xs:annotation>
6129 <xs:simpleType>
6130 <xs:restriction base="xs:NMTOKEN">
6131 <xs:enumeration value="string">
6132 <xs:annotation>
6133 <xs:documentation>
6134 The value is interpreted and stored as a string (REG_SZ).
6135 </xs:documentation>
6136 </xs:annotation>
6137 </xs:enumeration>
6138 <xs:enumeration value="integer">
6139 <xs:annotation>
6140 <xs:documentation>
6141 The value is interpreted and stored as an integer (REG_DWORD).
6142 </xs:documentation>
6143 </xs:annotation>
6144 </xs:enumeration>
6145 <xs:enumeration value="binary">
6146 <xs:annotation>
6147 <xs:documentation>
6148 The value is interpreted and stored as a hexadecimal value (REG_BINARY).
6149 </xs:documentation>
6150 </xs:annotation>
6151 </xs:enumeration>
6152 <xs:enumeration value="expandable">
6153 <xs:annotation>
6154 <xs:documentation>
6155 The value is interpreted and stored as an expandable string (REG_EXPAND_SZ).
6156 </xs:documentation>
6157 </xs:annotation>
6158 </xs:enumeration>
6159 <xs:enumeration value="multiString">
6160 <xs:annotation>
6161 <xs:documentation>
6162 The value is interpreted and stored as a multiple strings (REG_MULTI_SZ).
6163 Please note that this value will only result in a multi-string value if there is more than one registry value
6164 or the Action attribute's value is 'append' or 'prepend'. Otherwise a string value will be created.
6165 </xs:documentation>
6166 </xs:annotation>
6167 </xs:enumeration>
6168 </xs:restriction>
6169 </xs:simpleType>
6170 </xs:attribute>
6171 <xs:attribute name="Action">
6172 <xs:annotation>
6173 <xs:documentation>
6174 This is the action that will be taken for this registry value.
6175 </xs:documentation>
6176 </xs:annotation>
6177 <xs:simpleType>
6178 <xs:restriction base="xs:NMTOKEN">
6179 <xs:enumeration value="append">
6180 <xs:annotation>
6181 <xs:documentation>
6182 Appends the specified value(s) to a multiString registry value.
6183 </xs:documentation>
6184 </xs:annotation>
6185 </xs:enumeration>
6186 <xs:enumeration value="prepend">
6187 <xs:annotation>
6188 <xs:documentation>
6189 Prepends the specified value(s) to a multiString registry value.
6190 </xs:documentation>
6191 </xs:annotation>
6192 </xs:enumeration>
6193 <xs:enumeration value="write">
6194 <xs:annotation>
6195 <xs:documentation>
6196 Writes a registry value. This is the default value.
6197 </xs:documentation>
6198 </xs:annotation>
6199 </xs:enumeration>
6200 </xs:restriction>
6201 </xs:simpleType>
6202 </xs:attribute>
6203 <xs:attribute name="KeyPath" type="YesNoTypeUnion">
6204 <xs:annotation>
6205 <xs:documentation>
6206 Set this attribute to 'yes' to make this registry key the KeyPath of the parent component.
6207 Only one resource (registry, file, etc) can be the KeyPath of a component.
6208 </xs:documentation>
6209 </xs:annotation>
6210 </xs:attribute>
6211 <xs:anyAttribute namespace="##other" processContents="lax">
6212 <xs:annotation>
6213 <xs:documentation>
6214 Extensibility point in the WiX XML Schema. Schema extensions can register additional
6215 attributes at this point in the schema.
6216 </xs:documentation>
6217 </xs:annotation>
6218 </xs:anyAttribute>
6219 </xs:complexType>
6220 </xs:element>
6221 <xs:element name="RemoveRegistryKey">
6222 <xs:annotation>
6223 <xs:documentation>
6224 Used for removing registry keys and all child keys during install or uninstall.
6225 </xs:documentation>
6226 <xs:appinfo>
6227 <xse:msiRef table="Registry" href="https://learn.microsoft.com/en-us/windows/win32/msi/registry-table" />
6228 <xse:msiRef table="RemoveRegistry" href="http://msdn.microsoft.com/library/aa371208.aspx" />
6229 </xs:appinfo>
6230 </xs:annotation>
6231 <xs:complexType>
6232 <xs:attribute name="Id" type="xs:string">
6233 <xs:annotation>
6234 <xs:documentation>
6235 Primary key used to identify this particular entry. If this attribute is not specified, an identifier will be
6236 generated by hashing the parent Component identifier, Root, Key, and Name.
6237 </xs:documentation>
6238 </xs:annotation>
6239 </xs:attribute>
6240 <xs:attribute name="Action">
6241 <xs:annotation>
6242 <xs:documentation>
6243 This is the action that will be taken for this registry value.
6244 </xs:documentation>
6245 </xs:annotation>
6246 <xs:simpleType>
6247 <xs:restriction base="xs:NMTOKEN">
6248 <xs:enumeration value="removeOnInstall">
6249 <xs:annotation>
6250 <xs:documentation>
6251 Removes a key with all its values and subkeys when the parent component is installed.
6252 </xs:documentation>
6253 </xs:annotation>
6254 </xs:enumeration>
6255 <xs:enumeration value="removeOnUninstall">
6256 <xs:annotation>
6257 <xs:documentation>
6258 Removes a key with all its values and subkeys when the parent component is uninstalled.
6259 </xs:documentation>
6260 </xs:annotation>
6261 </xs:enumeration>
6262 </xs:restriction>
6263 </xs:simpleType>
6264 </xs:attribute>
6265 <xs:attribute name="Key" type="xs:string">
6266 <xs:annotation>
6267 <xs:documentation>
6268 The localizable key for the registry value.
6269 </xs:documentation>
6270 </xs:annotation>
6271 </xs:attribute>
6272 <xs:attribute name="Root" type="RegistryRootType">
6273 <xs:annotation>
6274 <xs:documentation>
6275 The predefined root key for the registry value.
6276 </xs:documentation>
6277 </xs:annotation>
6278 </xs:attribute>
6279 <xs:anyAttribute namespace="##other" processContents="lax">
6280 <xs:annotation>
6281 <xs:documentation>
6282 Extensibility point in the WiX XML Schema. Schema extensions can register additional attributes at this point in the schema.
6283 </xs:documentation>
6284 </xs:annotation>
6285 </xs:anyAttribute>
6286 </xs:complexType>
6287 </xs:element>
6288 <xs:element name="RemoveRegistryValue">
6289 <xs:annotation>
6290 <xs:documentation>
6291 Used to remove a registry value during installation.
6292 There is no standard way to remove a single registry value during uninstall (but you can remove an entire key with RemoveRegistryKey).
6293 </xs:documentation>
6294 <xs:appinfo>
6295 <xse:msiRef table="RemoveRegistry" href="https://docs.microsoft.com/en-us/windows/win32/msi/removeregistry-table" />
6296 </xs:appinfo>
6297 </xs:annotation>
6298 <xs:complexType>
6299 <xs:choice minOccurs="0" maxOccurs="unbounded">
6300 <xs:any namespace="##other" processContents="lax">
6301 <xs:annotation>
6302 <xs:documentation>
6303 Extensibility point in the WiX XML Schema. Schema extensions can register additional
6304 elements at this point in the schema.
6305 </xs:documentation>
6306 </xs:annotation>
6307 </xs:any>
6308 </xs:choice>
6309 <xs:attribute name="Id" type="xs:string">
6310 <xs:annotation>
6311 <xs:documentation>
6312 Primary key used to identify this particular entry. If this attribute is not specified, an identifier will be
6313 generated by hashing the parent Component identifier, Root, Key, and Name.
6314 </xs:documentation>
6315 </xs:annotation>
6316 </xs:attribute>
6317 <xs:attribute name="Key" type="xs:string">
6318 <xs:annotation>
6319 <xs:documentation>
6320 The localizable key for the registry value.
6321 </xs:documentation>
6322 </xs:annotation>
6323 </xs:attribute>
6324 <xs:attribute name="Name" type="xs:string">
6325 <xs:annotation>
6326 <xs:documentation>
6327 The localizable registry value name. If this attribute is not provided the default value for the registry key will
6328 be set instead. The Windows Installer allows several special values to be set for this attribute. You should not
6329 use them in WiX. Instead use appropriate values in the Action attribute to get the desired behavior.
6330 </xs:documentation>
6331 </xs:annotation>
6332 </xs:attribute>
6333 <xs:attribute name="Root" type="RegistryRootType">
6334 <xs:annotation>
6335 <xs:documentation>
6336 The predefined root key for the registry value.
6337 </xs:documentation>
6338 </xs:annotation>
6339 </xs:attribute>
6340 <xs:anyAttribute namespace="##other" processContents="lax">
6341 <xs:annotation>
6342 <xs:documentation>
6343 Extensibility point in the WiX XML Schema. Schema extensions can register additional attributes at this point in the schema.
6344 </xs:documentation>
6345 </xs:annotation>
6346 </xs:anyAttribute>
6347 </xs:complexType>
6348 </xs:element>
6349 <xs:element name="RemoveFile">
6350 <xs:annotation>
6351 <xs:appinfo>
6352 <xse:seeAlso ref="CopyFile" />
6353 <xse:msiRef table="RemoveFile" href="https://learn.microsoft.com/en-us/windows/win32/msi/removefile-table" />
6354 </xs:appinfo>
6355 <xs:documentation>
6356 Remove a file(s) if the parent component is selected for installation or removal. Multiple files can be removed
6357 by specifying a wildcard for the value of the Name attribute. By default, the source
6358 directory of the file is the directory of the parent component. This can be overridden by specifying the
6359 Directory attribute with a value corresponding to the Id of the source directory, or by specifying the Property
6360 attribute with a value corresponding to a property that will have a value that resolves to the full path
6361 to the source directory.
6362 </xs:documentation>
6363 </xs:annotation>
6364 <xs:complexType>
6365 <xs:choice minOccurs="0" maxOccurs="unbounded">
6366 <xs:any namespace="##other" processContents="lax">
6367 <xs:annotation>
6368 <xs:documentation>
6369 Extensibility point in the WiX XML Schema. Schema extensions can register additional
6370 elements at this point in the schema.
6371 </xs:documentation>
6372 </xs:annotation>
6373 </xs:any>
6374 </xs:choice>
6375 <xs:attribute name="Id" type="xs:string">
6376 <xs:annotation>
6377 <xs:documentation>Primary key used to identify this particular entry.</xs:documentation>
6378 </xs:annotation>
6379 </xs:attribute>
6380 <xs:attribute name="Directory" type="xs:string">
6381 <xs:annotation>
6382 <xs:documentation>
6383 Overrides the directory of the parent component with a specific Directory. This Directory must exist in the
6384 installer database at creation time. This attribute cannot be specified in conjunction with the Property attribute.
6385 </xs:documentation>
6386 </xs:annotation>
6387 </xs:attribute>
6388 <xs:attribute name="Property" type="xs:string">
6389 <xs:annotation>
6390 <xs:documentation>
6391 Overrides the directory of the parent component with the value of the specified property. The property
6392 should have a value that resolves to the full path of the source directory. The property does not have
6393 to exist in the installer database at creation time; it could be created at installation time by a custom
6394 action, on the command line, etc. This attribute cannot be specified in conjunction with the Directory attribute.
6395 </xs:documentation>
6396 </xs:annotation>
6397 </xs:attribute>
6398 <xs:attribute name="Name" type="WildCardLongFileNameType" use="required">
6399 <xs:annotation>
6400 <xs:documentation>
6401 This value should be set to the localizable name of the file(s) to be removed. All of the files that
6402 match the wild card will be removed from the specified directory. The value is a filename that may also
6403 contain the wild card characters "?" for any single character or "*" for zero or more occurrences of any character.
6404 In prior versions of the WiX toolset, this attribute specified the short file name.
6405 This attribute's value may now be either a short or long file name.
6406 If a short file name is specified, the ShortName attribute may not be specified.
6407 Also, if this value is a long file name, the ShortName attribute may be omitted to
6408 allow WiX to attempt to generate a unique short file name.
6409 However, if you wish to manually specify the short file name, then the ShortName attribute may be specified.
6410 </xs:documentation>
6411 </xs:annotation>
6412 </xs:attribute>
6413 <xs:attribute name="ShortName" type="WildCardShortFileNameType">
6414 <xs:annotation>
6415 <xs:documentation>
6416 The short file name of the file in 8.3 format.
6417 This attribute should only be set if you want to manually specify the short file name.
6418 </xs:documentation>
6419 </xs:annotation>
6420 </xs:attribute>
6421 <xs:attribute name="On" type="InstallUninstallType" use="required">
6422 <xs:annotation>
6423 <xs:documentation>
6424 This value determines the time at which the file(s) may be removed. For 'install', the file will
6425 be removed only when the parent component is being installed (msiInstallStateLocal or
6426 msiInstallStateSource); for 'uninstall', the file will be removed only when the parent component
6427 is being removed (msiInstallStateAbsent); for 'both', the file will be removed in both cases.
6428 </xs:documentation>
6429 </xs:annotation>
6430 </xs:attribute>
6431 <xs:attribute name="Subdirectory" type="xs:string">
6432 <xs:annotation>
6433 <xs:documentation>
6434 This attribute defines one or more directories below the directory referenced by the Directory attribute or parent
6435 Directory reference for the file to be removed.
6436 </xs:documentation>
6437 </xs:annotation>
6438 </xs:attribute>
6439 <xs:anyAttribute namespace="##other" processContents="lax">
6440 <xs:annotation>
6441 <xs:documentation>
6442 Extensibility point in the WiX XML Schema. Schema extensions can register additional attributes at this point in the schema.
6443 </xs:documentation>
6444 </xs:annotation>
6445 </xs:anyAttribute>
6446 </xs:complexType>
6447 </xs:element>
6448 <xs:element name="RemoveFolder">
6449 <xs:annotation>
6450 <xs:appinfo>
6451 <xse:seeAlso ref="CreateFolder" />
6452 <xse:msiRef table="RemoveFile" href="https://learn.microsoft.com/en-us/windows/win32/msi/removefile-table" />
6453 </xs:appinfo>
6454 <xs:documentation>
6455 Remove an empty folder if the parent component is selected for installation or removal. By default, the folder
6456 is the directory of the parent component. This can be overridden by specifying the Directory attribute
6457 with a value corresponding to the Id of the directory, or by specifying the Property attribute with a value
6458 corresponding to a property that will have a value that resolves to the full path of the folder.
6459 </xs:documentation>
6460 </xs:annotation>
6461 <xs:complexType>
6462 <xs:choice minOccurs="0" maxOccurs="unbounded">
6463 <xs:any namespace="##other" processContents="lax">
6464 <xs:annotation>
6465 <xs:documentation>
6466 Extensibility point in the WiX XML Schema. Schema extensions can register additional
6467 elements at this point in the schema.
6468 </xs:documentation>
6469 </xs:annotation>
6470 </xs:any>
6471 </xs:choice>
6472 <xs:attribute name="Id" type="xs:string">
6473 <xs:annotation>
6474 <xs:documentation>Primary key used to identify this particular entry.</xs:documentation>
6475 </xs:annotation>
6476 </xs:attribute>
6477 <xs:attribute name="Directory" type="xs:string">
6478 <xs:annotation>
6479 <xs:documentation>
6480 Overrides the directory of the parent component with a specific Directory. This Directory must exist in the
6481 installer database at creation time. This attribute cannot be specified in conjunction with the Property attribute.
6482 </xs:documentation>
6483 </xs:annotation>
6484 </xs:attribute>
6485 <xs:attribute name="Property" type="xs:string">
6486 <xs:annotation>
6487 <xs:documentation>
6488 Overrides the directory of the parent component with the value of the specified property. The property
6489 should have a value that resolves to the full path of the source directory. The property does not have
6490 to exist in the installer database at creation time; it could be created at installation time by a custom
6491 action, on the command line, etc. This attribute cannot be specified in conjunction with the Directory attribute.
6492 </xs:documentation>
6493 </xs:annotation>
6494 </xs:attribute>
6495 <xs:attribute name="On" type="InstallUninstallType" use="required">
6496 <xs:annotation>
6497 <xs:documentation>
6498 This value determines the time at which the folder may be removed, based on the install/uninstall of the parent component.
6499 For 'install', the folder will be removed only when the parent component is being installed (msiInstallStateLocal or
6500 msiInstallStateSource); for 'uninstall', the folder will be removed only when the parent component
6501 is being removed (msiInstallStateAbsent); for 'both', the folder will be removed in both cases.
6502 </xs:documentation>
6503 </xs:annotation>
6504 </xs:attribute>
6505 <xs:attribute name="Subdirectory" type="xs:string">
6506 <xs:annotation>
6507 <xs:documentation>
6508 This attribute defines one or more directories below the directory referenced by the Directory attribute or parent
6509 Directory reference for the folder to be removed.
6510 </xs:documentation>
6511 </xs:annotation>
6512 </xs:attribute>
6513 <xs:anyAttribute namespace="##other" processContents="lax">
6514 <xs:annotation>
6515 <xs:documentation>
6516 Extensibility point in the WiX XML Schema. Schema extensions can register additional attributes at this point in the schema.
6517 </xs:documentation>
6518 </xs:annotation>
6519 </xs:anyAttribute>
6520 </xs:complexType>
6521 </xs:element>
6522 <xs:element name="CreateFolder">
6523 <xs:annotation>
6524 <xs:appinfo>
6525 <xse:seeAlso ref="RemoveFolder" />
6526 <xse:msiRef table="CreateFolder" href="https://learn.microsoft.com/en-us/windows/win32/msi/createfolder-table" />
6527 </xs:appinfo>
6528 <xs:documentation>Create folder as part of parent Component.</xs:documentation>
6529 </xs:annotation>
6530 <xs:complexType>
6531 <xs:choice minOccurs="0" maxOccurs="unbounded">
6532 <xs:element ref="Shortcut" minOccurs="0" maxOccurs="unbounded">
6533 <xs:annotation>
6534 <xs:documentation>Non-advertised shortcut to this folder, Shortcut Target is preset to the folder</xs:documentation>
6535 </xs:annotation>
6536 </xs:element>
6537 <xs:element ref="Permission" minOccurs="0" maxOccurs="unbounded">
6538 <xs:annotation>
6539 <xs:documentation>ACL permission</xs:documentation>
6540 </xs:annotation>
6541 </xs:element>
6542 <xs:element ref="PermissionEx">
6543 <xs:annotation>
6544 <xs:documentation>Can also configure the ACLs for this folder.</xs:documentation>
6545 </xs:annotation>
6546 </xs:element>
6547 <xs:any namespace="##other" processContents="lax">
6548 <xs:annotation>
6549 <xs:documentation>
6550 Extensibility point in the WiX XML Schema. Schema extensions can register additional
6551 elements at this point in the schema.
6552 </xs:documentation>
6553 </xs:annotation>
6554 </xs:any>
6555 </xs:choice>
6556 <xs:attribute name="Directory" type="xs:string">
6557 <xs:annotation>
6558 <xs:documentation>Identifier of Directory to create. Defaults to Directory of parent Component.</xs:documentation>
6559 </xs:annotation>
6560 </xs:attribute>
6561 <xs:attribute name="Subdirectory" type="xs:string">
6562 <xs:annotation>
6563 <xs:documentation>
6564 This attribute defines one or more directories below the directory referenced by the Directory attribute or parent
6565 Directory reference for the directory to be created.
6566 </xs:documentation>
6567 </xs:annotation>
6568 </xs:attribute>
6569 <xs:anyAttribute namespace="##other" processContents="lax">
6570 <xs:annotation>
6571 <xs:documentation>
6572 Extensibility point in the WiX XML Schema. Schema extensions can register additional attributes at this point in the schema.
6573 </xs:documentation>
6574 </xs:annotation>
6575 </xs:anyAttribute>
6576 </xs:complexType>
6577 </xs:element>
6578 <xs:element name="Category">
6579 <xs:annotation>
6580 <xs:documentation>
6581 Qualified published component for parent Component
6582 </xs:documentation>
6583 <xs:appinfo>
6584 <xse:msiRef table="PublishComponent" href="https://learn.microsoft.com/en-us/windows/win32/msi/publishcomponent-table" />
6585 </xs:appinfo>
6586 </xs:annotation>
6587 <xs:complexType>
6588 <xs:choice minOccurs="0" maxOccurs="unbounded">
6589 <xs:any namespace="##other" processContents="lax">
6590 <xs:annotation>
6591 <xs:documentation>
6592 Extensibility point in the WiX XML Schema. Schema extensions can register additional
6593 elements at this point in the schema.
6594 </xs:documentation>
6595 </xs:annotation>
6596 </xs:any>
6597 </xs:choice>
6598 <xs:attribute name="Id" use="required" type="Guid">
6599 <xs:annotation>
6600 <xs:documentation>A string GUID that represents the category of components being grouped together.</xs:documentation>
6601 </xs:annotation>
6602 </xs:attribute>
6603 <xs:attribute name="Qualifier" use="required" type="xs:string">
6604 <xs:annotation>
6605 <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>
6606 </xs:annotation>
6607 </xs:attribute>
6608 <xs:attribute name="AppData" type="xs:string">
6609 <xs:annotation>
6610 <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>
6611 </xs:annotation>
6612 </xs:attribute>
6613 <xs:attribute name="Feature" type="xs:string">
6614 <xs:annotation>
6615 <xs:documentation>Feature that controls the advertisement of the category. Defaults to the primary Feature for the parent Component .</xs:documentation>
6616 </xs:annotation>
6617 </xs:attribute>
6618 <xs:anyAttribute namespace="##other" processContents="lax">
6619 <xs:annotation>
6620 <xs:documentation>
6621 Extensibility point in the WiX XML Schema. Schema extensions can register additional attributes at this point in the schema.
6622 </xs:documentation>
6623 </xs:annotation>
6624 </xs:anyAttribute>
6625 </xs:complexType>
6626 </xs:element>
6627 <xs:element name="MIME">
6628 <xs:annotation>
6629 <xs:documentation>
6630 MIME content-type for an Extension
6631 </xs:documentation>
6632 <xs:appinfo>
6633 <xse:msiRef table="MIME" href="http://msdn.microsoft.com/library/aa370035.aspx" />
6634 </xs:appinfo>
6635 </xs:annotation>
6636 <xs:complexType>
6637 <xs:attribute name="Advertise" type="YesNoTypeUnion">
6638 <xs:annotation>
6639 <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>
6640 </xs:annotation>
6641 </xs:attribute>
6642 <xs:attribute name="ContentType" type="xs:string" use="required">
6643 <xs:annotation>
6644 <xs:documentation>This is the identifier for the MIME content. It is commonly written in the form of type/format.</xs:documentation>
6645 </xs:annotation>
6646 </xs:attribute>
6647 <xs:attribute name="Class" type="Guid">
6648 <xs:annotation>
6649 <xs:documentation>Class ID for the COM server that is to be associated with the MIME content.</xs:documentation>
6650 </xs:annotation>
6651 </xs:attribute>
6652 <xs:attribute name="Default" type="YesNoTypeUnion">
6653 <xs:annotation>
6654 <xs:documentation>If 'yes', become the content type for the parent Extension. The default value is 'no'.</xs:documentation>
6655 </xs:annotation>
6656 </xs:attribute>
6657 </xs:complexType>
6658 </xs:element>
6659 <xs:element name="Verb">
6660 <xs:annotation>
6661 <xs:documentation>
6662 Verb definition for an Extension. When advertised, this element creates a row in the
6663 <html:a href="https://learn.microsoft.com/en-us/windows/win32/msi/verb-table">Verb table</html:a>.
6664 When not advertised, this element creates the appropriate rows in <html:a href="https://learn.microsoft.com/en-us/windows/win32/msi/registry-table">Registry table</html:a>.
6665 </xs:documentation>
6666 <xs:appinfo>
6667 <xse:msiRef table="Verb" href="https://learn.microsoft.com/en-us/windows/win32/msi/verb-table" />
6668 <xse:msiRef table="Registry" href="https://learn.microsoft.com/en-us/windows/win32/msi/registry-table" />
6669 </xs:appinfo>
6670 </xs:annotation>
6671 <xs:complexType>
6672 <xs:attribute name="Id" type="xs:string" use="required">
6673 <xs:annotation>
6674 <xs:documentation>The verb for the command.</xs:documentation>
6675 </xs:annotation>
6676 </xs:attribute>
6677 <xs:attribute name="Command" type="xs:string">
6678 <xs:annotation>
6679 <xs:documentation>The localized text displayed on the context menu.</xs:documentation>
6680 </xs:annotation>
6681 </xs:attribute>
6682 <xs:attribute name="Argument" type="xs:string">
6683 <xs:annotation>
6684 <xs:documentation>Value for the command arguments. Note that the resolution of properties in the
6685 Argument field is limited. A property formatted as [Property] in this field can only be resolved if the property
6686 already has the intended value when the component owning the verb is installed. For example, for the argument
6687 "[#MyDoc.doc]" to resolve to the correct value, the same process must be installing the file MyDoc.doc and the
6688 component that owns the verb.</xs:documentation>
6689 </xs:annotation>
6690 </xs:attribute>
6691 <xs:attribute name="Sequence" type="Integer">
6692 <xs:annotation>
6693 <xs:documentation>The sequence of the commands. Only verbs for which the Sequence is specified
6694 are used to prepare an ordered list for the default value of the shell key. The Verb with the lowest value in this
6695 column becomes the default verb. Used only for Advertised verbs.</xs:documentation>
6696 </xs:annotation>
6697 </xs:attribute>
6698 <xs:attribute name="TargetFile" type="xs:string">
6699 <xs:annotation>
6700 <xs:documentation>
6701 Either this attribute or the TargetProperty attribute must be specified for a non-advertised verb.
6702 The value should be the identifier of the target file to be executed for the verb.
6703 </xs:documentation>
6704 </xs:annotation>
6705 </xs:attribute>
6706 <xs:attribute name="TargetProperty" type="xs:string">
6707 <xs:annotation>
6708 <xs:documentation>
6709 Either this attribute or the TargetFile attribute must be specified for a non-advertised verb.
6710 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.
6711 </xs:documentation>
6712 </xs:annotation>
6713 </xs:attribute>
6714 </xs:complexType>
6715 </xs:element>
6716 <xs:element name="Extension">
6717 <xs:annotation>
6718 <xs:documentation>
6719 Extension for a Component
6720 </xs:documentation>
6721 <xs:appinfo>
6722 <xse:msiRef table="MIME" href="http://msdn.microsoft.com/library/aa370035.aspx" />
6723 <xse:msiRef table="Verb" href="https://learn.microsoft.com/en-us/windows/win32/msi/verb-table" />
6724 <xse:msiRef table="Registry" href="https://learn.microsoft.com/en-us/windows/win32/msi/registry-table" />
6725 </xs:appinfo>
6726 </xs:annotation>
6727 <xs:complexType>
6728 <xs:choice minOccurs="0" maxOccurs="unbounded">
6729 <xs:annotation>
6730 <xs:documentation>MIME and Verbs can be associated with Extensions</xs:documentation>
6731 </xs:annotation>
6732 <xs:element ref="MIME" />
6733 <xs:element ref="Verb" />
6734 </xs:choice>
6735 <xs:attribute name="Id" type="xs:string" use="required">
6736 <xs:annotation>
6737 <xs:documentation>This is simply the file extension, like "doc" or "xml". Do not include the preceding period.</xs:documentation>
6738 </xs:annotation>
6739 </xs:attribute>
6740 <xs:attribute name="ContentType" type="xs:string">
6741 <xs:annotation>
6742 <xs:documentation>The MIME type that is to be written.</xs:documentation>
6743 </xs:annotation>
6744 </xs:attribute>
6745 <xs:attribute name="Advertise" type="YesNoTypeUnion">
6746 <xs:annotation>
6747 <xs:documentation>Whether this extension is to be advertised. The default is "no".</xs:documentation>
6748 </xs:annotation>
6749 </xs:attribute>
6750 <xs:anyAttribute namespace="##other" processContents="lax">
6751 <xs:annotation>
6752 <xs:documentation>
6753 Extensibility point in the WiX XML Schema. Schema extensions can register additional
6754 attributes at this point in the schema.
6755 </xs:documentation>
6756 </xs:annotation>
6757 </xs:anyAttribute>
6758 </xs:complexType>
6759 </xs:element>
6760 <xs:element name="TypeLib">
6761 <xs:annotation>
6762 <xs:documentation>
6763 Register a type library (TypeLib). Please note that in order to properly use this
6764 non-advertised, you will need use this element with Advertise='no' and also author the
6765 appropriate child Interface elements by extracting them from the type library itself.
6766 </xs:documentation>
6767 <xs:appinfo>
6768 <xse:msiRef table="TypeLib" href="http://msdn.microsoft.com/library/aa372092.aspx" />
6769 <xse:msiRef table="Registry" href="https://learn.microsoft.com/en-us/windows/win32/msi/registry-table" />
6770 </xs:appinfo>
6771 </xs:annotation>
6772 <xs:complexType>
6773 <xs:choice minOccurs="0" maxOccurs="unbounded">
6774 <xs:element ref="AppId" />
6775 <xs:element ref="Class" />
6776 <xs:element ref="Interface" />
6777 </xs:choice>
6778 <xs:attribute name="Id" type="Guid" use="required">
6779 <xs:annotation>
6780 <xs:documentation>The GUID that identifes the type library.</xs:documentation>
6781 </xs:annotation>
6782 </xs:attribute>
6783 <xs:attribute name="Advertise" type="YesNoTypeUnion">
6784 <xs:annotation>
6785 <xs:documentation>
6786 Value of 'yes' will create a row in the TypeLib table.
6787 Value of 'no' will create rows in the Registry table.
6788 The default value is 'no'.
6789 </xs:documentation>
6790 </xs:annotation>
6791 </xs:attribute>
6792 <xs:attribute name="Control" type="YesNoTypeUnion">
6793 <xs:annotation>
6794 <xs:documentation>
6795 Value of 'yes' means the type library describes controls, and should not be displayed in type browsers intended for nonvisual objects.
6796 This attribute can only be set if Advertise='no'.
6797 </xs:documentation>
6798 </xs:annotation>
6799 </xs:attribute>
6800 <xs:attribute name="Cost" type="xs:int">
6801 <xs:annotation>
6802 <xs:documentation>
6803 The cost associated with the registration of the type library in bytes. This attribute cannot be set if Advertise='no'.
6804 </xs:documentation>
6805 </xs:annotation>
6806 </xs:attribute>
6807 <xs:attribute name="Description" type="xs:string">
6808 <xs:annotation>
6809 <xs:documentation>The localizable description of the type library.</xs:documentation>
6810 </xs:annotation>
6811 </xs:attribute>
6812 <xs:attribute name="HasDiskImage" type="YesNoTypeUnion">
6813 <xs:annotation>
6814 <xs:documentation>
6815 Value of 'yes' means the type library exists in a persisted form on disk. This attribute can only be set if Advertise='no'.
6816 </xs:documentation>
6817 </xs:annotation>
6818 </xs:attribute>
6819 <xs:attribute name="HelpDirectory" type="xs:string">
6820 <xs:annotation>
6821 <xs:documentation>The identifier of the Directory element for the help directory.</xs:documentation>
6822 </xs:annotation>
6823 </xs:attribute>
6824 <xs:attribute name="HelpSubirectory" type="xs:string">
6825 <xs:annotation>
6826 <xs:documentation>
6827 This attribute defines one or more directories below the directory referenced by the HelpDirectory attribute
6828 for the typelib's help directory.
6829 </xs:documentation>
6830 </xs:annotation>
6831 </xs:attribute>
6832 <xs:attribute name="Hidden" type="YesNoTypeUnion">
6833 <xs:annotation>
6834 <xs:documentation>
6835 Value of 'yes' means the type library should not be displayed to users, although its use is not restricted.
6836 Should be used by controls. Hosts should create a new type library that wraps the control with extended properties.
6837 This attribute can only be set if Advertise='no'.
6838 </xs:documentation>
6839 </xs:annotation>
6840 </xs:attribute>
6841 <xs:attribute name="Language" use="required" type="Integer">
6842 <xs:annotation>
6843 <xs:documentation>The language of the type library. This must be a non-negative integer.</xs:documentation>
6844 </xs:annotation>
6845 </xs:attribute>
6846 <xs:attribute name="MajorVersion" type="Integer">
6847 <xs:annotation>
6848 <xs:documentation>The major version of the type library. The value should be an integer from 0 - 255.</xs:documentation>
6849 </xs:annotation>
6850 </xs:attribute>
6851 <xs:attribute name="MinorVersion" type="Integer">
6852 <xs:annotation>
6853 <xs:documentation>The minor version of the type library. The value should be an integer from 0 - 255.</xs:documentation>
6854 </xs:annotation>
6855 </xs:attribute>
6856 <xs:attribute name="ResourceId" type="Integer">
6857 <xs:annotation>
6858 <xs:documentation>The resource id of a typelib. The value is appended to the end of the typelib path in the registry.</xs:documentation>
6859 </xs:annotation>
6860 </xs:attribute>
6861 <xs:attribute name="Restricted" type="YesNoTypeUnion">
6862 <xs:annotation>
6863 <xs:documentation>
6864 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'.
6865 </xs:documentation>
6866 </xs:annotation>
6867 </xs:attribute>
6868 </xs:complexType>
6869 </xs:element>
6870 <xs:element name="ProgId">
6871 <xs:annotation>
6872 <xs:documentation>
6873 ProgId registration for parent Component. If ProgId has an associated Class, it must be a child of that element.
6874 </xs:documentation>
6875 <xs:appinfo>
6876 <xse:msiRef table="ProgId" href="http://msdn.microsoft.com/library/aa370879.aspx" />
6877 <xse:msiRef table="Class" href="http://msdn.microsoft.com/library/aa367861.aspx" />
6878 <xse:msiRef table="Registry" href="https://learn.microsoft.com/en-us/windows/win32/msi/registry-table" />
6879 <xse:msiRef table="Icon" href="http://msdn.microsoft.com/library/aa369210.aspx" />
6880 </xs:appinfo>
6881 </xs:annotation>
6882 <xs:complexType>
6883 <xs:sequence>
6884 <xs:element ref="ProgId" minOccurs="0" maxOccurs="unbounded">
6885 <xs:annotation>
6886 <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>
6887 </xs:annotation>
6888 </xs:element>
6889 <xs:element ref="Extension" minOccurs="0" maxOccurs="unbounded">
6890 <xs:annotation>
6891 <xs:documentation>Extensions that refer to this ProgId</xs:documentation>
6892 </xs:annotation>
6893 </xs:element>
6894 </xs:sequence>
6895 <xs:attribute name="Id" type="xs:string" use="required" />
6896 <xs:attribute name="Description" type="xs:string" />
6897 <xs:attribute name="Icon" type="xs:string">
6898 <xs:annotation>
6899 <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>
6900 </xs:annotation>
6901 </xs:attribute>
6902 <xs:attribute name="IconIndex" type="Integer" />
6903 <xs:attribute name="Advertise" type="YesNoTypeUnion" />
6904 <xs:attribute name="NoOpen" type="xs:string">
6905 <xs:annotation>
6906 <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>
6907 </xs:annotation>
6908 </xs:attribute>
6909 </xs:complexType>
6910 </xs:element>
6911 <xs:element name="AppId">
6912 <xs:annotation>
6913 <xs:documentation>
6914 Application ID containing DCOM information for the associated application GUID.
6915 If this element is nested under a Fragment, Module, or Package element, it must be
6916 advertised.
6917 </xs:documentation>
6918 <xs:appinfo>
6919 <xse:msiRef table="AppId" href="http://msdn.microsoft.com/library/aa367566.aspx" />
6920 <xse:msiRef table="Registry" href="https://learn.microsoft.com/en-us/windows/win32/msi/registry-table" />
6921 <xse:remarks>
6922 When being used in unadvertised mode, the attributes in the AppId element correspond to registry values
6923 under the `[HKCR\AppID\{Id}]` key, as follows:
6924
6925 - `Id`: [HKCR\AppID\`Id`]
6926 - `ActivateAtStorage`: [HKCR\AppID\`Id`]/ActivateAtStorage="Y"
6927 - `Description`: [HKCR\AppID\`Id`]/@="My AppId Description"
6928 - `DllSurrogate`: [HKCR\AppID\`Id`]/DllSurrogate="C:\surrogate.exe"
6929 - `LocalService`: [HKCR\AppID\`Id`]/LocalService="MyServiceName"
6930 - `RemoteServerName`: [HKCR\AppID\`Id`]/RemoteServerName="MyRemoteServer"
6931 - `RunAsInteractiveUser`: [HKCR\AppID\`Id`]/RunAs="Interactive User"
6932 - `ServiceParameters`: [HKCR\AppID\`Id`]/ServiceParameters="-param"
6933 </xse:remarks>
6934 </xs:appinfo>
6935 </xs:annotation>
6936 <xs:complexType>
6937 <xs:choice minOccurs="0" maxOccurs="unbounded">
6938 <xs:element ref="Class" />
6939 </xs:choice>
6940 <xs:attribute name="ActivateAtStorage" type="YesNoTypeUnion">
6941 <xs:annotation>
6942 <xs:documentation>
6943 Set this value to 'yes' to configure the client to activate on the same system as persistent storage.
6944 </xs:documentation>
6945 </xs:annotation>
6946 </xs:attribute>
6947 <xs:attribute name="Advertise" type="YesNoTypeUnion">
6948 <xs:annotation>
6949 <xs:documentation>
6950 Set this value to 'yes' in order to create a normal AppId table row. Set this value to 'no' in order to
6951 generate Registry rows that perform similar registration (without the often problematic Windows Installer
6952 advertising behavior).
6953 </xs:documentation>
6954 </xs:annotation>
6955 </xs:attribute>
6956 <xs:attribute name="Description" type="xs:string">
6957 <xs:annotation>
6958 <xs:documentation>
6959 Set this value to the description of the AppId. It can only be specified when the AppId is not being advertised.
6960 </xs:documentation>
6961 </xs:annotation>
6962 </xs:attribute>
6963 <xs:attribute name="DllSurrogate" type="xs:string">
6964 <xs:annotation>
6965 <xs:documentation>
6966 Set this value to specify that the class is a DLL that is to be activated in a surrogate EXE
6967 process, and the surrogate process to be used is the path of a surrogate EXE file specified by the value.
6968 </xs:documentation>
6969 </xs:annotation>
6970 </xs:attribute>
6971 <xs:attribute name="Id" type="Guid" use="required">
6972 <xs:annotation>
6973 <xs:documentation>
6974 Set this value to the AppID GUID that corresponds to the named executable.
6975 </xs:documentation>
6976 </xs:annotation>
6977 </xs:attribute>
6978 <xs:attribute name="LocalService" type="xs:string">
6979 <xs:annotation>
6980 <xs:documentation>
6981 Set this value to the name of a service to allow the object to be installed as a Win32 service.
6982 </xs:documentation>
6983 </xs:annotation>
6984 </xs:attribute>
6985 <xs:attribute name="RemoteServerName" type="xs:string">
6986 <xs:annotation>
6987 <xs:documentation>
6988 Set this value to the name of the remote server to configure the client to request the object
6989 be run at a particular machine whenever an activation function is called for which a COSERVERINFO
6990 structure is not specified.
6991 </xs:documentation>
6992 </xs:annotation>
6993 </xs:attribute>
6994 <xs:attribute name="RunAsInteractiveUser" type="YesNoTypeUnion">
6995 <xs:annotation>
6996 <xs:documentation>
6997 Set this value to 'yes' to configure a class to run under the identity of the user currently
6998 logged on and connected to the interactive desktop when activated by a remote client without
6999 being written as a Win32 service.
7000 </xs:documentation>
7001 </xs:annotation>
7002 </xs:attribute>
7003 <xs:attribute name="ServiceParameters" type="xs:string">
7004 <xs:annotation>
7005 <xs:documentation>
7006 Set this value to the parameters to be passed to a LocalService on invocation.
7007 </xs:documentation>
7008 </xs:annotation>
7009 </xs:attribute>
7010 </xs:complexType>
7011 </xs:element>
7012 <xs:element name="Class">
7013 <xs:annotation>
7014 <xs:documentation>COM Class registration for parent Component.</xs:documentation>
7015 <xs:appinfo>
7016 <xse:seeAlso ref="AppId" />
7017 <xse:msiRef table="Class" href="http://msdn.microsoft.com/library/aa367861.aspx" />
7018 <xse:msiRef table="ProgId" href="http://msdn.microsoft.com/library/aa370879.aspx" />
7019 <xse:msiRef table="Registry" href="https://learn.microsoft.com/en-us/windows/win32/msi/registry-table" />
7020 <xse:msiRef table="AppId" href="http://msdn.microsoft.com/library/aa367566.aspx" />
7021 <xse:remarks>
7022 When being used in unadvertised mode, the attributes in the Class element correspond to registry
7023 values under the `[HKCR\CLSID\{'{'}Id{'}'}]` and `[HKCR\CLSID\{'{'}Id{'}'}\Context]` keys as follows:
7024
7025 - `Id, Context`: [HKCR\CLSID\{'{'}Id{'}'}\Context]
7026 - `Server`: [HKCR\CLSID\{01234567-89AB-CDEF-0123-456789ABCDEF}\LocalServer32]\@="[!comserv.dll]"
7027 - `ForeignServer`: [HKCR\CLSID\{01234567-89AB-CDEF-0123-456789ABCDEF}\LocalServer32]\@="mscoree.dll"
7028 - `AppId`: [HKCR\CLSID\{01234567-89AB-CDEF-0123-456789ABCDEF}]\AppId="{00000000-89AB-0000-0123-000000000000}"
7029 - `Argument`: [HKCR\CLSID\{01234567-89AB-CDEF-0123-456789ABCDEF}\LocalServer32]\@="[!comserv.dll] /arg1 /arg2 /arg3"
7030 - `Control`: [HKCR\CLSID\{01234567-89AB-CDEF-0123-456789ABCDEF}\Control]
7031 - `Description`: [HKCR\CLSID\{01234567-89AB-CDEF-0123-456789ABCDEF}]\@="Description of Example COM Component"
7032 - `Handler`: [HKCR\CLSID\{01234567-89AB-CDEF-0123-456789ABCDEF}\InprocHandler32]\@="handler.dll"
7033 - `Insertable`: [HKCR\CLSID\{01234567-89AB-CDEF-0123-456789ABCDEF}\Insertable]
7034 - `Insertable`: [HKCR\CLSID\{01234567-89AB-CDEF-0123-456789ABCDEF}\NotInsertable]
7035 - `Programmable`: [HKCR\CLSID\{01234567-89AB-CDEF-0123-456789ABCDEF}\Programmable]
7036 - `SafeForInitializing`: [HKCR\CLSID\{01234567-89AB-CDEF-0123-456789ABCDEF}\Implemented Categories\{7DD95801-9882-11CF-9FA9-00AA006C42C4}]
7037 - `ThreadingModel`: [HKCR\CLSID\{01234567-89AB-CDEF-0123-456789ABCDEF}\LocalServer32]\ThreadingModel="Apartment"
7038 - `TypeLibId`: [HKCR\CLSID\{01234567-89AB-CDEF-0123-456789ABCDEF}\TypeLib]\@="{11111111-89AB-1111-0123-111111111111}"
7039 - `Version`: [HKCR\CLSID\{01234567-89AB-CDEF-0123-456789ABCDEF}\Version]\@="1.0.0.0"
7040 </xse:remarks>
7041 </xs:appinfo>
7042 </xs:annotation>
7043 <xs:complexType>
7044 <xs:choice minOccurs="0" maxOccurs="unbounded">
7045 <xs:element ref="ProgId">
7046 <xs:annotation>
7047 <xs:documentation>A ProgId associated with Class must be a child element of the Class element</xs:documentation>
7048 </xs:annotation>
7049 </xs:element>
7050 <xs:element ref="FileTypeMask" />
7051 <xs:element ref="Interface">
7052 <xs:annotation>
7053 <xs:documentation>These Interfaces will be registered with the parent Class and TypeLib (if present).</xs:documentation>
7054 </xs:annotation>
7055 </xs:element>
7056 </xs:choice>
7057 <xs:attribute name="Id" type="Guid" use="required">
7058 <xs:annotation>
7059 <xs:documentation>The Class identifier (CLSID) of a COM server.</xs:documentation>
7060 </xs:annotation>
7061 </xs:attribute>
7062 <xs:attribute name="Context">
7063 <xs:annotation>
7064 <xs:documentation>
7065 The server context(s) for this COM server. This attribute is optional for VB6 libraries that are marked "PublicNotCreateable".
7066 Class elements marked Advertised must specify at least one server context. It is most common for there to be a single value
7067 for the Context attribute.
7068 </xs:documentation>
7069 </xs:annotation>
7070 <xs:simpleType>
7071 <xs:list>
7072 <xs:simpleType>
7073 <xs:restriction base="xs:NMTOKEN">
7074 <xs:enumeration value="LocalServer">
7075 <xs:annotation>
7076 <xs:documentation>
7077 A 16-bit local server application.
7078 </xs:documentation>
7079 </xs:annotation>
7080 </xs:enumeration>
7081 <xs:enumeration value="LocalServer32">
7082 <xs:annotation>
7083 <xs:documentation>
7084 A 32-bit local server application.
7085 </xs:documentation>
7086 </xs:annotation>
7087 </xs:enumeration>
7088 <xs:enumeration value="InprocServer">
7089 <xs:annotation>
7090 <xs:documentation>
7091 A 16-bit in-process server DLL.
7092 </xs:documentation>
7093 </xs:annotation>
7094 </xs:enumeration>
7095 <xs:enumeration value="InprocServer32">
7096 <xs:annotation>
7097 <xs:documentation>
7098 A 32-bit in-process server DLL.
7099 </xs:documentation>
7100 </xs:annotation>
7101 </xs:enumeration>
7102 </xs:restriction>
7103 </xs:simpleType>
7104 </xs:list>
7105 </xs:simpleType>
7106 </xs:attribute>
7107 <xs:attribute name="Description" type="xs:string">
7108 <xs:annotation>
7109 <xs:documentation>Localized description associated with the Class ID and Program ID.</xs:documentation>
7110 </xs:annotation>
7111 </xs:attribute>
7112 <xs:attribute name="AppId" type="Guid">
7113 <xs:annotation>
7114 <xs:documentation>
7115 This attribute is only allowed when a Class is advertised. Using this attribute will reference an Application ID
7116 containing DCOM information for the associated application GUID. The value must correspond to an AppId/@Id of an
7117 AppId element nested under a Fragment, Module, or Package element. To associate an AppId with a non-advertised
7118 class, nest the class within a parent AppId element.
7119 </xs:documentation>
7120 </xs:annotation>
7121 </xs:attribute>
7122 <xs:attribute name="Icon" type="xs:string">
7123 <xs:annotation>
7124 <xs:documentation>
7125 The file providing the icon associated with this CLSID. Reference to an Icon element
7126 (should match the Id attribute of an Icon element). This is currently not supported if the
7127 value of the Advertise attribute is "no".
7128 </xs:documentation>
7129 </xs:annotation>
7130 </xs:attribute>
7131 <xs:attribute name="IconIndex" type="Integer">
7132 <xs:annotation>
7133 <xs:documentation>Icon index into the icon file.</xs:documentation>
7134 </xs:annotation>
7135 </xs:attribute>
7136 <xs:attribute name="Handler" type="xs:string">
7137 <xs:annotation>
7138 <xs:documentation>
7139 The default inproc handler. May be optionally provided only for Context = LocalServer or
7140 LocalServer32. Value of "1" creates a 16-bit InprocHandler (appearing as the InprocHandler
7141 value). Value of "2" creates a 32-bit InprocHandler (appearing as the InprocHandler32 value).
7142 Value of "3" creates 16-bit as well as 32-bit InprocHandlers. A non-numeric value is treated
7143 as a system file that serves as the 32-bit InprocHandler (appearing as the InprocHandler32 value).
7144 </xs:documentation>
7145 </xs:annotation>
7146 </xs:attribute>
7147 <xs:attribute name="Argument" type="xs:string">
7148 <xs:annotation>
7149 <xs:documentation>
7150 This column is optional only when the Context column is set to "LocalServer"
7151 or "LocalServer32" server context. The text is registered as the argument against
7152 the OLE server and is used by OLE for invoking the server. Note that the resolution
7153 of properties in the Argument field is limited. A property formatted as [Property] in
7154 this field can only be resolved if the property already has the intended value when
7155 the component owning the class is installed. For example, for the argument "[#MyDoc.doc]"
7156 to resolve to the correct value, the same process must be installing the file MyDoc.doc and the
7157 component that owns the class.
7158 </xs:documentation>
7159 </xs:annotation>
7160 </xs:attribute>
7161 <xs:attribute name="RelativePath" type="YesNoTypeUnion">
7162 <xs:annotation>
7163 <xs:documentation>
7164 When the value is "yes", the bare file name can be used for COM servers. The installer
7165 registers the file name only instead of the complete path. This enables the server in
7166 the current directory to take precedence and allows multiple copies of the same component.
7167 </xs:documentation>
7168 </xs:annotation>
7169 </xs:attribute>
7170 <xs:attribute name="Advertise" type="YesNoTypeUnion">
7171 <xs:annotation>
7172 <xs:documentation>
7173 Set this value to "yes" in order to create a normal Class table row. Set this value to
7174 "no" in order to generate Registry rows that perform similar registration (without the
7175 often problematic Windows Installer advertising behavior).
7176 </xs:documentation>
7177 </xs:annotation>
7178 </xs:attribute>
7179 <!-- Following attributes are not advertised, but add the appropriate rows to the Registry table -->
7180 <xs:attribute name="ThreadingModel">
7181 <xs:annotation>
7182 <xs:documentation>
7183 Threading model for the CLSID.
7184 </xs:documentation>
7185 </xs:annotation>
7186 <xs:simpleType>
7187 <xs:restriction base="xs:NMTOKEN">
7188 <xs:enumeration value="apartment" />
7189 <xs:enumeration value="free" />
7190 <xs:enumeration value="both" />
7191 <xs:enumeration value="neutral" />
7192 <xs:enumeration value="single" />
7193 <xs:enumeration value="rental" />
7194 </xs:restriction>
7195 </xs:simpleType>
7196 </xs:attribute>
7197 <xs:attribute name="Version" type="xs:string">
7198 <xs:annotation>
7199 <xs:documentation>
7200 Version for the CLSID.
7201 </xs:documentation>
7202 </xs:annotation>
7203 </xs:attribute>
7204 <xs:attribute name="Insertable" type="YesNoTypeUnion">
7205 <xs:annotation>
7206 <xs:documentation>
7207 Specifies the CLSID may be insertable.
7208 </xs:documentation>
7209 </xs:annotation>
7210 </xs:attribute>
7211 <xs:attribute name="Programmable" type="YesNoTypeUnion">
7212 <xs:annotation>
7213 <xs:documentation>
7214 Specifies the CLSID may be programmable.
7215 </xs:documentation>
7216 </xs:annotation>
7217 </xs:attribute>
7218 <xs:attribute name="ForeignServer" type="xs:string">
7219 <xs:annotation>
7220 <xs:documentation>
7221 May only be specified if the value of the Advertise attribute is "no" and Server has not been specified. In addition, it may only
7222 be used when the Class element is directly under the Component element. The value can be
7223 that of an registry type (REG_SZ). This attribute should be used to specify foreign servers, such as mscoree.dll if needed.
7224 </xs:documentation>
7225 </xs:annotation>
7226 </xs:attribute>
7227 <xs:attribute name="Server" type="xs:string">
7228 <xs:annotation>
7229 <xs:documentation>
7230 May only be specified if the value of the Advertise attribute is "no" and the ForeignServer attribute is not specified. File Id of the
7231 COM server file. If this element is nested under a File element, this value defaults to
7232 the value of the parent File/@Id.
7233 </xs:documentation>
7234 </xs:annotation>
7235 </xs:attribute>
7236 <xs:attribute name="ShortPath" type="YesNoTypeUnion">
7237 <xs:annotation>
7238 <xs:documentation>
7239 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.
7240 </xs:documentation>
7241 </xs:annotation>
7242 </xs:attribute>
7243 <xs:attribute name="SafeForScripting" type="YesNoTypeUnion">
7244 <xs:annotation>
7245 <xs:documentation>
7246 May only be specified if the value of the Advertise attribute is "no".
7247 </xs:documentation>
7248 </xs:annotation>
7249 </xs:attribute>
7250 <xs:attribute name="SafeForInitializing" type="YesNoTypeUnion">
7251 <xs:annotation>
7252 <xs:documentation>
7253 May only be specified if the value of the Advertise attribute is "no".
7254 </xs:documentation>
7255 </xs:annotation>
7256 </xs:attribute>
7257 <xs:attribute name="Control" type="YesNoTypeUnion">
7258 <xs:annotation>
7259 <xs:documentation>
7260 Set this attribute's value to 'yes' to identify an object as an ActiveX Control. The default value is 'no'.
7261 </xs:documentation>
7262 </xs:annotation>
7263 </xs:attribute>
7264 </xs:complexType>
7265 </xs:element>
7266 <xs:element name="Interface">
7267 <xs:annotation>
7268 <xs:documentation>COM Interface registration for parent TypeLib.</xs:documentation>
7269 <xs:appinfo>
7270 <xse:msiRef table="Registry" href="https://learn.microsoft.com/en-us/windows/win32/msi/registry-table" />
7271 </xs:appinfo>
7272 </xs:annotation>
7273 <xs:complexType>
7274 <xs:attribute name="Id" type="Guid" use="required">
7275 <xs:annotation>
7276 <xs:documentation>GUID identifier for COM Interface.</xs:documentation>
7277 </xs:annotation>
7278 </xs:attribute>
7279 <xs:attribute name="Name" type="xs:string" use="required">
7280 <xs:annotation>
7281 <xs:documentation>Name for COM Interface.</xs:documentation>
7282 </xs:annotation>
7283 </xs:attribute>
7284 <xs:attribute name="BaseInterface" type="Guid">
7285 <xs:annotation>
7286 <xs:documentation>Identifies the interface from which the current interface is derived.</xs:documentation>
7287 </xs:annotation>
7288 </xs:attribute>
7289 <xs:attribute name="ProxyStubClassId" type="Guid">
7290 <xs:annotation>
7291 <xs:documentation>GUID CLSID for proxy stub to COM Interface.</xs:documentation>
7292 </xs:annotation>
7293 </xs:attribute>
7294 <xs:attribute name="ProxyStubClassId32" type="Guid">
7295 <xs:annotation>
7296 <xs:documentation>GUID CLSID for 32-bit proxy stub to COM Interface.</xs:documentation>
7297 </xs:annotation>
7298 </xs:attribute>
7299 <xs:attribute name="NumMethods" type="Integer">
7300 <xs:annotation>
7301 <xs:documentation>Number of methods implemented on COM Interface.</xs:documentation>
7302 </xs:annotation>
7303 </xs:attribute>
7304 <xs:attribute name="Versioned" type="YesNoTypeUnion">
7305 <xs:annotation>
7306 <xs:documentation>Determines whether a Typelib version entry should be created with the other COM Interface registry keys. Default is 'yes'.</xs:documentation>
7307 </xs:annotation>
7308 </xs:attribute>
7309 </xs:complexType>
7310 </xs:element>
7311 <xs:element name="FileTypeMask">
7312 <xs:annotation>
7313 <xs:documentation>FileType data for class Id registration.</xs:documentation>
7314 </xs:annotation>
7315 <xs:complexType>
7316 <xs:attribute name="Offset" type="Integer" use="required">
7317 <xs:annotation>
7318 <xs:documentation>Offset into file. If positive, offset is from the beginning; if negative, offset is from the end.</xs:documentation>
7319 </xs:annotation>
7320 </xs:attribute>
7321 <xs:attribute name="Mask" type="HexType" use="required">
7322 <xs:annotation>
7323 <xs:documentation>Hex value that is AND'd against the bytes in the file at Offset.</xs:documentation>
7324 </xs:annotation>
7325 </xs:attribute>
7326 <xs:attribute name="Value" type="HexType" use="required">
7327 <xs:annotation>
7328 <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>
7329 </xs:annotation>
7330 </xs:attribute>
7331 </xs:complexType>
7332 </xs:element>
7333 <xs:element name="ServiceDependency">
7334 <xs:annotation>
7335 <xs:documentation>
7336 Service or group of services that must start before the parent service.
7337 </xs:documentation>
7338 <xs:appinfo>
7339 <xse:msiRef table="ServiceInstall" href="https://docs.microsoft.com/en-us/windows/win32/msi/serviceinstall-table" />
7340 </xs:appinfo>
7341 </xs:annotation>
7342 <xs:complexType>
7343 <xs:attribute name="Id" type="xs:string" use="required">
7344 <xs:annotation>
7345 <xs:documentation>
7346 The name (not the display name) of a previously installed service or the name of a service group when the Group attribute is set to 'yes'.
7347 </xs:documentation>
7348 </xs:annotation>
7349 </xs:attribute>
7350 <xs:attribute name="Group" type="YesNoTypeUnion">
7351 <xs:annotation>
7352 <xs:documentation>
7353 Set to 'yes' to indicate that the value in the Id attribute is the name of a group of services. If 'no' or not set, the Id attribute refers to another service by name.
7354 </xs:documentation>
7355 </xs:annotation>
7356 </xs:attribute>
7357 </xs:complexType>
7358 </xs:element>
7359 <xs:element name="ServiceInstall">
7360 <xs:annotation>
7361 <xs:documentation>
7362 Adds services for parent Component. Use the ServiceControl element to remove services.
7363 </xs:documentation>
7364 <xs:appinfo>
7365 <xse:msiRef table="ServiceInstall" href="https://docs.microsoft.com/en-us/windows/win32/msi/serviceinstall-table" />
7366 <xse:remarks>
7367 The service executable installed will point to the KeyPath for the Component.
7368 Therefore, you must ensure that the correct executable is either the first child
7369 File element under this Component or explicitly mark the appropriate File element
7370 as KeyPath='yes'.
7371 </xse:remarks>
7372 </xs:appinfo>
7373 </xs:annotation>
7374 <xs:complexType>
7375 <xs:choice minOccurs="0" maxOccurs="unbounded">
7376 <xs:element ref="PermissionEx">
7377 <xs:annotation>
7378 <xs:documentation>Configures the ACLs for this service.</xs:documentation>
7379 </xs:annotation>
7380 </xs:element>
7381 <xs:element ref="ServiceDependency">
7382 <xs:annotation>
7383 <xs:documentation>Ordered list of dependencies when installing services.</xs:documentation>
7384 </xs:annotation>
7385 </xs:element>
7386 <xs:element ref="ServiceConfig" />
7387 <xs:element ref="ServiceConfigFailureActions" />
7388 <xs:any namespace="##other" processContents="lax">
7389 <xs:annotation>
7390 <xs:documentation>
7391 Extensibility point in the WiX XML Schema. Schema extensions can register additional
7392 elements at this point in the schema.
7393 </xs:documentation>
7394 </xs:annotation>
7395 </xs:any>
7396 </xs:choice>
7397 <xs:attribute name="Id" type="xs:string">
7398 <xs:annotation>
7399 <xs:documentation>
7400 Unique identifier for this service configuration. This value will default to the Name attribute if not
7401 specified.
7402 </xs:documentation>
7403 </xs:annotation>
7404 </xs:attribute>
7405 <xs:attribute name="Name" type="xs:string" use="required">
7406 <xs:annotation>
7407 <xs:documentation>This column is the string that gives the service name to install.</xs:documentation>
7408 </xs:annotation>
7409 </xs:attribute>
7410 <xs:attribute name="DisplayName" type="xs:string">
7411 <xs:annotation>
7412 <xs:documentation>This column is the localizable string that user interface programs use to identify the service.</xs:documentation>
7413 </xs:annotation>
7414 </xs:attribute>
7415 <xs:attribute name="Type" use="required">
7416 <xs:annotation>
7417 <xs:documentation>The Windows Installer does not currently support kernelDriver or systemDriver.</xs:documentation>
7418 </xs:annotation>
7419 <xs:simpleType>
7420 <xs:restriction base="xs:NMTOKEN">
7421 <xs:enumeration value="ownProcess">
7422 <xs:annotation>
7423 <xs:documentation>
7424 A Win32 service that runs its own process.
7425 </xs:documentation>
7426 </xs:annotation>
7427 </xs:enumeration>
7428 <xs:enumeration value="shareProcess">
7429 <xs:annotation>
7430 <xs:documentation>
7431 A Win32 service that shares a process.
7432 </xs:documentation>
7433 </xs:annotation>
7434 </xs:enumeration>
7435 <xs:enumeration value="kernelDriver">
7436 <xs:annotation>
7437 <xs:documentation>
7438 A kernel driver service. This value is not currently supported by the Windows Installer.
7439 </xs:documentation>
7440 </xs:annotation>
7441 </xs:enumeration>
7442 <xs:enumeration value="systemDriver">
7443 <xs:annotation>
7444 <xs:documentation>
7445 A file system driver service. This value is not currently supported by the Windows Installer.
7446 </xs:documentation>
7447 </xs:annotation>
7448 </xs:enumeration>
7449 </xs:restriction>
7450 </xs:simpleType>
7451 </xs:attribute>
7452 <xs:attribute name="Interactive" type="YesNoTypeUnion">
7453 <xs:annotation>
7454 <xs:documentation>Whether or not the service interacts with the desktop.</xs:documentation>
7455 </xs:annotation>
7456 </xs:attribute>
7457 <xs:attribute name="Start" use="required">
7458 <xs:annotation>
7459 <xs:documentation>Determines when the service should be started. The Windows Installer does not support boot or system.</xs:documentation>
7460 </xs:annotation>
7461 <xs:simpleType>
7462 <xs:restriction base="xs:NMTOKEN">
7463 <xs:enumeration value="auto">
7464 <xs:annotation>
7465 <xs:documentation>
7466 The service will start during startup of the system.
7467 </xs:documentation>
7468 </xs:annotation>
7469 </xs:enumeration>
7470 <xs:enumeration value="demand">
7471 <xs:annotation>
7472 <xs:documentation>
7473 The service will start when the service control manager calls the StartService function.
7474 </xs:documentation>
7475 </xs:annotation>
7476 </xs:enumeration>
7477 <xs:enumeration value="disabled">
7478 <xs:annotation>
7479 <xs:documentation>
7480 The service can no longer be started.
7481 </xs:documentation>
7482 </xs:annotation>
7483 </xs:enumeration>
7484 <xs:enumeration value="boot">
7485 <xs:annotation>
7486 <xs:documentation>
7487 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.
7488 </xs:documentation>
7489 </xs:annotation>
7490 </xs:enumeration>
7491 <xs:enumeration value="system">
7492 <xs:annotation>
7493 <xs:documentation>
7494 The service is a device driver that will be started by the IoInitSystem function. This value is not currently supported by the Windows Installer.
7495 </xs:documentation>
7496 </xs:annotation>
7497 </xs:enumeration>
7498 </xs:restriction>
7499 </xs:simpleType>
7500 </xs:attribute>
7501 <xs:attribute name="ErrorControl" use="required">
7502 <xs:annotation>
7503 <xs:documentation>Determines what action should be taken on an error.</xs:documentation>
7504 </xs:annotation>
7505 <xs:simpleType>
7506 <xs:restriction base="xs:NMTOKEN">
7507 <xs:enumeration value="ignore">
7508 <xs:annotation>
7509 <xs:documentation>
7510 Logs the error and continues with the startup operation.
7511 </xs:documentation>
7512 </xs:annotation>
7513 </xs:enumeration>
7514 <xs:enumeration value="normal">
7515 <xs:annotation>
7516 <xs:documentation>
7517 Logs the error, displays a message box and continues the startup operation.
7518 </xs:documentation>
7519 </xs:annotation>
7520 </xs:enumeration>
7521 <xs:enumeration value="critical">
7522 <xs:annotation>
7523 <xs:documentation>
7524 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.
7525 </xs:documentation>
7526 </xs:annotation>
7527 </xs:enumeration>
7528 </xs:restriction>
7529 </xs:simpleType>
7530 </xs:attribute>
7531 <xs:attribute name="Vital" type="YesNoTypeUnion">
7532 <xs:annotation>
7533 <xs:documentation>When set to 'yes' or left unspecified the overall install will fail if this service fails to install. A value of 'no' indicates failure to install the service will be ignored.</xs:documentation>
7534 </xs:annotation>
7535 </xs:attribute>
7536 <xs:attribute name="LoadOrderGroup" type="xs:string">
7537 <xs:annotation>
7538 <xs:documentation>The load ordering group that this service should be a part of.</xs:documentation>
7539 </xs:annotation>
7540 </xs:attribute>
7541 <xs:attribute name="Account" type="xs:string">
7542 <xs:annotation>
7543 <xs:documentation>Fully qualified names must be used even for local accounts, e.g.: ".\LOCAL_ACCOUNT". Valid only when ServiceType is ownProcess.</xs:documentation>
7544 </xs:annotation>
7545 </xs:attribute>
7546 <xs:attribute name="Password" type="xs:string">
7547 <xs:annotation>
7548 <xs:documentation>The password for the account. Valid only when the account has a password.</xs:documentation>
7549 </xs:annotation>
7550 </xs:attribute>
7551 <xs:attribute name="Arguments" type="xs:string">
7552 <xs:annotation>
7553 <xs:documentation>Contains any command line arguments or properties required to run the service.</xs:documentation>
7554 </xs:annotation>
7555 </xs:attribute>
7556 <xs:attribute name="Description" type="xs:string">
7557 <xs:annotation>
7558 <xs:documentation>Sets the description of the service.</xs:documentation>
7559 </xs:annotation>
7560 </xs:attribute>
7561 <xs:attribute name="EraseDescription" type="YesNoTypeUnion">
7562 <xs:annotation>
7563 <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>
7564 </xs:annotation>
7565 </xs:attribute>
7566 </xs:complexType>
7567 </xs:element>
7568 <xs:element name="ServiceArgument" type="xs:string">
7569 <xs:annotation>
7570 <xs:documentation>
7571 Argument used in ServiceControl parent
7572 </xs:documentation>
7573 <xs:appinfo>
7574 <xse:msiRef table="ServiceControl" href="http://msdn.microsoft.com/library/aa371634.aspx" />
7575 </xs:appinfo>
7576 </xs:annotation>
7577 </xs:element>
7578 <xs:element name="ServiceControl">
7579 <xs:annotation>
7580 <xs:documentation>
7581 Starts, stops, and removes services for parent Component. This element is used to control the state
7582 of a service installed by the MSI or MSM file by using the start, stop and remove attributes.
7583 For example, Start='install' Stop='both' Remove='uninstall' would mean: start the service on install,
7584 remove the service when the product is uninstalled, and stop the service both on install and uninstall.
7585 </xs:documentation>
7586 <xs:appinfo>
7587 <xse:msiRef table="ServiceControl" href="http://msdn.microsoft.com/library/aa371634.aspx" />
7588 </xs:appinfo>
7589 </xs:annotation>
7590 <xs:complexType>
7591 <xs:sequence>
7592 <xs:element ref="ServiceArgument" minOccurs="0" maxOccurs="unbounded">
7593 <xs:annotation>
7594 <xs:documentation>Ordered list of arguments used when modifying services.</xs:documentation>
7595 </xs:annotation>
7596 </xs:element>
7597 </xs:sequence>
7598 <xs:attribute name="Id" type="xs:string">
7599 <xs:annotation>
7600 <xs:documentation>
7601 Unique identifier for this service control. This value will default to the Name attribute if not
7602 specified.
7603 </xs:documentation>
7604 </xs:annotation>
7605 </xs:attribute>
7606 <xs:attribute name="Name" type="xs:string" use="required">
7607 <xs:annotation>
7608 <xs:documentation>Name of the service.</xs:documentation>
7609 </xs:annotation>
7610 </xs:attribute>
7611 <xs:attribute name="Start" type="InstallUninstallType">
7612 <xs:annotation>
7613 <xs:documentation>
7614 Specifies whether the service should be started by the StartServices action on install, uninstall or both.
7615 For 'install', the service will be started only when the parent component is being installed (msiInstallStateLocal or
7616 msiInstallStateSource); for 'uninstall', the service will be started only when the parent component
7617 is being removed (msiInstallStateAbsent); for 'both', the service will be started in both cases.
7618 </xs:documentation>
7619 </xs:annotation>
7620 </xs:attribute>
7621 <xs:attribute name="Stop" type="InstallUninstallType">
7622 <xs:annotation>
7623 <xs:documentation>
7624 Specifies whether the service should be stopped by the StopServices action on install, uninstall or both.
7625 For 'install', the service will be stopped only when the parent component is being installed (msiInstallStateLocal or
7626 msiInstallStateSource); for 'uninstall', the service will be stopped only when the parent component
7627 is being removed (msiInstallStateAbsent); for 'both', the service will be stopped in both cases.
7628 </xs:documentation>
7629 </xs:annotation>
7630 </xs:attribute>
7631 <xs:attribute name="Remove" type="InstallUninstallType">
7632 <xs:annotation>
7633 <xs:documentation>
7634 Specifies whether the service should be removed by the DeleteServices action on install, uninstall or both.
7635 For 'install', the service will be removed only when the parent component is being installed (msiInstallStateLocal or
7636 msiInstallStateSource); for 'uninstall', the service will be removed only when the parent component
7637 is being removed (msiInstallStateAbsent); for 'both', the service will be removed in both cases.
7638 </xs:documentation>
7639 </xs:annotation>
7640 </xs:attribute>
7641 <xs:attribute name="Wait" type="YesNoTypeUnion">
7642 <xs:annotation>
7643 <xs:documentation>Specifies whether or not to wait for the service to complete before continuing. The default is 'yes'.</xs:documentation>
7644 </xs:annotation>
7645 </xs:attribute>
7646 </xs:complexType>
7647 </xs:element>
7648 <xs:element name="RequiredPrivilege" type="xs:string">
7649 <xs:annotation>
7650 <xs:documentation>
7651 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
7652 Formatted property that resolves to a privilege constant.
7653 </xs:documentation>
7654 <xs:appinfo>
7655 <xse:msiRef table="MsiServiceConfig" href="https://learn.microsoft.com/en-us/windows/win32/msi/msiserviceconfig-table" />
7656 </xs:appinfo>
7657 </xs:annotation>
7658 </xs:element>
7659 <xs:element name="ServiceConfig">
7660 <xs:annotation>
7661 <xs:documentation>
7662 Configures a service being installed or one that already exists. This element's functionality is available starting with MSI 5.0. However, a
7663 [remark indicating the functionality does not work correctly](https://learn.microsoft.com/en-us/windows/win32/msi/msiconfigureservices-action) was added later.
7664 Consider using the [util:ServiceConfig element](../../schema/util/serviceconfig.md) instead.
7665 </xs:documentation>
7666 <xs:appinfo>
7667 <xse:msiRef table="MsiServiceConfig" href="https://learn.microsoft.com/en-us/windows/win32/msi/msiserviceconfig-table" />
7668 </xs:appinfo>
7669 </xs:annotation>
7670 <xs:complexType>
7671 <xs:choice minOccurs="0" maxOccurs="unbounded">
7672 <xs:element ref="RequiredPrivilege">
7673 <xs:annotation>
7674 <xs:documentation>List of privileges to apply to service.</xs:documentation>
7675 </xs:annotation>
7676 </xs:element>
7677 </xs:choice>
7678 <xs:attribute name="Id" type="xs:string">
7679 <xs:annotation>
7680 <xs:documentation>
7681 Unique identifier for this service configuration. This value will default to the ServiceName attribute if not
7682 specified.
7683 </xs:documentation>
7684 </xs:annotation>
7685 </xs:attribute>
7686 <xs:attribute name="DelayedAutoStart" type="xs:string">
7687 <xs:annotation>
7688 <xs:documentation>
7689 This attribute specifies whether an auto-start service should delay its start until after all other auto-start
7690 services. This attribute only affects auto-start services. Allowed values are "yes", "no" or a Formatted property that
7691 resolves to "1" (for "yes") or "0" (for "no"). If this attribute is not present the setting is not configured.
7692 </xs:documentation>
7693 </xs:annotation>
7694 </xs:attribute>
7695 <xs:attribute name="FailureActionsWhen" type="xs:string">
7696 <xs:annotation>
7697 <xs:documentation>
7698 This attribute specifies when failure actions should be applied. Allowed values are "failedToStop", "failedToStopOrReturnedError"
7699 or a Formatted property that resolves to "1" (for "failedToStopOrReturnedError") or "0" (for "failedToStop"). If this attribute
7700 is not present the setting is not configured.
7701 </xs:documentation>
7702 </xs:annotation>
7703 </xs:attribute>
7704 <xs:attribute name="PreShutdownDelay" type="xs:string">
7705 <xs:annotation>
7706 <xs:documentation>
7707 This attribute specifies time in milliseconds that the Service Control Manager (SCM) waits after notifying the service of a system
7708 shutdown. If this attribute is not present the default value, 3 minutes, is used.
7709 </xs:documentation>
7710 </xs:annotation>
7711 </xs:attribute>
7712 <xs:attribute name="OnInstall" type="YesNoTypeUnion">
7713 <xs:annotation>
7714 <xs:documentation>
7715 Specifies whether to configure the service when the parent Component is installed. This attribute may be combined with OnReinstall
7716 and OnUninstall.
7717 </xs:documentation>
7718 </xs:annotation>
7719 </xs:attribute>
7720 <xs:attribute name="OnReinstall" type="YesNoTypeUnion">
7721 <xs:annotation>
7722 <xs:documentation>
7723 Specifies whether to configure the service when the parent Component is reinstalled. This attribute may be combined with OnInstall
7724 and OnUninstall.
7725 </xs:documentation>
7726 </xs:annotation>
7727 </xs:attribute>
7728 <xs:attribute name="OnUninstall" type="YesNoTypeUnion">
7729 <xs:annotation>
7730 <xs:documentation>
7731 Specifies whether to configure the service when the parent Component is uninstalled. This attribute may be combined with OnInstall
7732 and OnReinstall.
7733 </xs:documentation>
7734 </xs:annotation>
7735 </xs:attribute>
7736 <xs:attribute name="ServiceName" type="xs:string">
7737 <xs:annotation>
7738 <xs:documentation>
7739 Specifies the name of the service to configure. This value will default to the ServiceInstall/@Name attribute when nested under
7740 a ServiceInstall element.
7741 </xs:documentation>
7742 </xs:annotation>
7743 </xs:attribute>
7744 <xs:attribute name="ServiceSid" type="xs:string">
7745 <xs:annotation>
7746 <xs:documentation>
7747 Specifies the service SID to apply to the service. Valid values are "none", "restricted", "unrestricted" or a Formatted property
7748 that resolves to "0" (for "none"), "3" (for "restricted") or "1" (for "unrestricted"). If this attribute is not present the
7749 setting is not configured.
7750 </xs:documentation>
7751 </xs:annotation>
7752 </xs:attribute>
7753 </xs:complexType>
7754 </xs:element>
7755 <xs:element name="Failure">
7756 <xs:annotation>
7757 <xs:documentation>Failure action for a ServiceConfigFailureActions element.</xs:documentation>
7758 </xs:annotation>
7759 <xs:complexType>
7760 <xs:attribute name="Action" type="xs:string" use="required">
7761 <xs:annotation>
7762 <xs:documentation>
7763 Specifies the action to take when the service fails. Valid values are "none", "restartComputer", "restartService", "runCommand" or a Formatted property
7764 that resolves to "0" (for "none"), "1" (for "restartService"), "2" (for "restartComputer") or "3" (for "runCommand").
7765 </xs:documentation>
7766 </xs:annotation>
7767 </xs:attribute>
7768 <xs:attribute name="Delay" type="xs:string" use="required">
7769 <xs:annotation>
7770 <xs:documentation>
7771 Specifies the time in milliseconds to wait before performing the value from the Action attribute.
7772 </xs:documentation>
7773 </xs:annotation>
7774 </xs:attribute>
7775 </xs:complexType>
7776 </xs:element>
7777 <xs:element name="ServiceConfigFailureActions">
7778 <xs:annotation>
7779 <xs:documentation>
7780 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.
7781 </xs:documentation>
7782 <xs:appinfo>
7783 <xse:msiRef table="MsiServiceConfigFailureActions" href="https://learn.microsoft.com/en-us/windows/win32/msi/msiserviceconfigfailureactions-table" />
7784 </xs:appinfo>
7785 </xs:annotation>
7786 <xs:complexType>
7787 <xs:choice minOccurs="0" maxOccurs="unbounded">
7788 <xs:element ref="Failure">
7789 <xs:annotation>
7790 <xs:documentation>Ordered list of failure actions to apply to service.</xs:documentation>
7791 </xs:annotation>
7792 </xs:element>
7793 </xs:choice>
7794 <xs:attribute name="Id" type="xs:string">
7795 <xs:annotation>
7796 <xs:documentation>
7797 Unique identifier for this service configuration. This value will default to the ServiceName attribute if not
7798 specified.
7799 </xs:documentation>
7800 </xs:annotation>
7801 </xs:attribute>
7802 <xs:attribute name="Command" type="xs:string">
7803 <xs:annotation>
7804 <xs:documentation>
7805 This attribute specifies command to execute when a "runCommand" failure action hit. If an empty string is provided it clears
7806 the existing command. If this attribute is not present the setting is not changed.
7807 </xs:documentation>
7808 </xs:annotation>
7809 </xs:attribute>
7810 <xs:attribute name="OnInstall" type="YesNoTypeUnion">
7811 <xs:annotation>
7812 <xs:documentation>
7813 Specifies whether to configure the service when the parent Component is installed. This attribute may be combined with OnReinstall
7814 and OnUninstall.
7815 </xs:documentation>
7816 </xs:annotation>
7817 </xs:attribute>
7818 <xs:attribute name="OnReinstall" type="YesNoTypeUnion">
7819 <xs:annotation>
7820 <xs:documentation>
7821 Specifies whether to configure the service when the parent Component is reinstalled. This attribute may be combined with OnInstall
7822 and OnUninstall.
7823 </xs:documentation>
7824 </xs:annotation>
7825 </xs:attribute>
7826 <xs:attribute name="OnUninstall" type="YesNoTypeUnion">
7827 <xs:annotation>
7828 <xs:documentation>
7829 Specifies whether to configure the service when the parent Component is uninstalled. This attribute may be combined with OnInstall
7830 and OnReinstall.
7831 </xs:documentation>
7832 </xs:annotation>
7833 </xs:attribute>
7834 <xs:attribute name="RebootMessage" type="xs:string">
7835 <xs:annotation>
7836 <xs:documentation>
7837 Specifies the message to show for a reboot failure action. If an empty string is provided it clears any existing reboot message. If this
7838 attribute is not present the setting is not changed.
7839 </xs:documentation>
7840 </xs:annotation>
7841 </xs:attribute>
7842 <xs:attribute name="ResetPeriod" type="Integer">
7843 <xs:annotation>
7844 <xs:documentation>
7845 Specifies the time in seconds to reset the failure count. If this attribute is not present the failure count will not be reset.
7846 </xs:documentation>
7847 </xs:annotation>
7848 </xs:attribute>
7849 <xs:attribute name="ServiceName" type="xs:string">
7850 <xs:annotation>
7851 <xs:documentation>
7852 Specifies the name of the service to configure. This value will default to the ServiceInstall/@Name attribute when nested under
7853 a ServiceInstall element.
7854 </xs:documentation>
7855 </xs:annotation>
7856 </xs:attribute>
7857 </xs:complexType>
7858 </xs:element>
7859 <xs:element name="Environment">
7860 <xs:annotation>
7861 <xs:documentation>
7862 Environment variables added or removed for the parent component.
7863 </xs:documentation>
7864 <xs:appinfo>
7865 <xse:msiRef table="Environment" href="http://msdn.microsoft.com/library/aa368369.aspx" />
7866 </xs:appinfo>
7867 </xs:annotation>
7868 <xs:complexType>
7869 <xs:attribute name="Id" type="xs:string">
7870 <xs:annotation>
7871 <xs:documentation>Unique identifier for environment entry.</xs:documentation>
7872 </xs:annotation>
7873 </xs:attribute>
7874 <xs:attribute name="Name" type="xs:string" use="required">
7875 <xs:annotation>
7876 <xs:documentation>Name of the environment variable.</xs:documentation>
7877 </xs:annotation>
7878 </xs:attribute>
7879 <xs:attribute name="Value" type="xs:string">
7880 <xs:annotation>
7881 <xs:documentation>
7882 The value to set into the environment variable.
7883 If this attribute is not set, the environment variable is removed during installation if it exists on the machine.
7884 </xs:documentation>
7885 </xs:annotation>
7886 </xs:attribute>
7887 <xs:attribute name="Separator" type="xs:string">
7888 <xs:annotation>
7889 <xs:documentation>Optional attribute to change the separator used between values. By default a semicolon is used.</xs:documentation>
7890 </xs:annotation>
7891 </xs:attribute>
7892 <xs:attribute name="Action">
7893 <xs:annotation>
7894 <xs:documentation>Specfies whether the environmental variable should be created, set or removed when the parent component is installed.</xs:documentation>
7895 </xs:annotation>
7896 <xs:simpleType>
7897 <xs:restriction base="xs:NMTOKEN">
7898 <xs:enumeration value="create">
7899 <xs:annotation>
7900 <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>
7901 </xs:annotation>
7902 </xs:enumeration>
7903 <xs:enumeration value="set">
7904 <xs:annotation>
7905 <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>
7906 </xs:annotation>
7907 </xs:enumeration>
7908 <xs:enumeration value="remove">
7909 <xs:annotation>
7910 <xs:documentation>
7911 Removes the environment variable during an installation.
7912 The installer only removes an environment variable during an installation if the name and value
7913 of the variable match the entries in the Name and Value attributes.
7914 If you want to remove an environment variable, regardless of its value, do not set the Value attribute.
7915 </xs:documentation>
7916 </xs:annotation>
7917 </xs:enumeration>
7918 </xs:restriction>
7919 </xs:simpleType>
7920 </xs:attribute>
7921 <xs:attribute name="Part">
7922 <xs:simpleType>
7923 <xs:restriction base="xs:NMTOKEN">
7924 <xs:enumeration value="all">
7925 <xs:annotation>
7926 <xs:documentation>
7927 This value is the entire environmental variable. This is the default.
7928 </xs:documentation>
7929 </xs:annotation>
7930 </xs:enumeration>
7931 <xs:enumeration value="first">
7932 <xs:annotation>
7933 <xs:documentation>
7934 This value is prefixed.
7935 </xs:documentation>
7936 </xs:annotation>
7937 </xs:enumeration>
7938 <xs:enumeration value="last">
7939 <xs:annotation>
7940 <xs:documentation>
7941 This value is appended.
7942 </xs:documentation>
7943 </xs:annotation>
7944 </xs:enumeration>
7945 </xs:restriction>
7946 </xs:simpleType>
7947 </xs:attribute>
7948 <xs:attribute name="Permanent" type="YesNoTypeUnion">
7949 <xs:annotation>
7950 <xs:documentation>Specifies that the environment variable should not be removed on uninstall.</xs:documentation>
7951 </xs:annotation>
7952 </xs:attribute>
7953 <xs:attribute name="System" type="YesNoTypeUnion">
7954 <xs:annotation>
7955 <xs:documentation>
7956 Specifies that the environment variable should be added to the system environment space. The default
7957 is 'no' which indicates the environment variable is added to the user environment space.
7958 </xs:documentation>
7959 </xs:annotation>
7960 </xs:attribute>
7961 </xs:complexType>
7962 </xs:element>
7963 <xs:element name="Launch">
7964 <xs:annotation>
7965 <xs:documentation>
7966 Launch conditions for MSI packages.
7967 </xs:documentation>
7968 <xs:appinfo>
7969 <xse:msiRef table="LaunchCondition" href="https://docs.microsoft.com/en-us/windows/win32/msi/launchcondition-table" />
7970 <xse:howtoRef href="redistributables_and_install_checks/block_install_on_os.html">How To: Block installation based on OS version</xse:howtoRef>
7971 <xse:howtoRef href="files_and_registry/check_the_version_number.html">How To: Check the version number of a file during installation</xse:howtoRef>
7972 </xs:appinfo>
7973 </xs:annotation>
7974 <xs:complexType>
7975 <xs:attribute name="Condition" type="xs:string" use="required">
7976 <xs:annotation>
7977 <xs:documentation>
7978 The condition expression to be evaluated at install time.
7979 </xs:documentation>
7980 </xs:annotation>
7981 </xs:attribute>
7982 <xs:attribute name="Message" type="xs:string" use="required">
7983 <xs:annotation>
7984 <xs:documentation>
7985 Set the value to the text to display when the condition fails and the installation must be terminated.
7986 </xs:documentation>
7987 </xs:annotation>
7988 </xs:attribute>
7989 </xs:complexType>
7990 </xs:element>
7991 <xs:element name="Level">
7992 <xs:annotation>
7993 <xs:documentation>
7994 Feature levels for MSI packages.
7995 </xs:documentation>
7996 <xs:appinfo>
7997 <xse:msiRef table="Condition" href="http://msdn.microsoft.com/library/aa368014.aspx" />
7998 </xs:appinfo>
7999 </xs:annotation>
8000 <xs:complexType>
8001 <xs:attribute name="Condition" type="xs:string" use="required">
8002 <xs:annotation>
8003 <xs:documentation>
8004 The condition expression to be evaluated at install time. When true the Feature level is set to the Value.
8005 </xs:documentation>
8006 </xs:annotation>
8007 </xs:attribute>
8008 <xs:attribute name="Value" type="Integer" use="required">
8009 <xs:annotation>
8010 <xs:documentation>
8011 Allows modifying the level of a Feature based on the result of the condition.
8012 </xs:documentation>
8013 </xs:annotation>
8014 </xs:attribute>
8015 </xs:complexType>
8016 </xs:element>
8017 <xs:element name="IsolateComponent">
8018 <xs:annotation>
8019 <xs:documentation>
8020 Shared Component to be privately replicated in folder of parent Component
8021 </xs:documentation>
8022 <xs:appinfo>
8023 <xse:msiRef table="IsolateComponent" href="http://msdn.microsoft.com/library/aa369730.aspx" />
8024 </xs:appinfo>
8025 </xs:annotation>
8026 <xs:complexType>
8027 <xs:attribute name="Shared" type="xs:string" use="required">
8028 <xs:annotation>
8029 <xs:documentation>Shared Component for this application Component.</xs:documentation>
8030 </xs:annotation>
8031 </xs:attribute>
8032 </xs:complexType>
8033 </xs:element>
8034 <xs:element name="ReserveCost">
8035 <xs:annotation>
8036 <xs:documentation>
8037 Disk cost to reserve in a folder for running locally and/or from source.
8038 </xs:documentation>
8039 <xs:appinfo>
8040 <xse:msiRef table="ReserveCost" href="http://msdn.microsoft.com/library/aa371226.aspx" />
8041 </xs:appinfo>
8042 </xs:annotation>
8043 <xs:complexType>
8044 <xs:attribute name="Id" type="xs:string" use="required">
8045 <xs:annotation>
8046 <xs:documentation>A primary key that uniquely identifies this ReserveCost entry.</xs:documentation>
8047 </xs:annotation>
8048 </xs:attribute>
8049 <xs:attribute name="Directory" type="xs:string">
8050 <xs:annotation>
8051 <xs:documentation>
8052 Adds the amount of disk space specified in RunFromSource or RunLocal to the volume cost of the device containing the directory.
8053 If this attribute is not set, it will default to the directory of parent component.
8054 </xs:documentation>
8055 </xs:annotation>
8056 </xs:attribute>
8057 <xs:attribute name="Subdirectory" type="xs:string">
8058 <xs:annotation>
8059 <xs:documentation>
8060 This attribute defines one or more directories below the directory referenced by the Directory attribute
8061 to add cost to.
8062 </xs:documentation>
8063 </xs:annotation>
8064 </xs:attribute>
8065 <xs:attribute name="RunFromSource" type="Integer" use="required">
8066 <xs:annotation>
8067 <xs:documentation>The number of bytes of disk space to reserve if the component is installed to run from source.</xs:documentation>
8068 </xs:annotation>
8069 </xs:attribute>
8070 <xs:attribute name="RunLocal" type="Integer" use="required">
8071 <xs:annotation>
8072 <xs:documentation>The number of bytes of disk space to reserve if the component is installed to run locally.</xs:documentation>
8073 </xs:annotation>
8074 </xs:attribute>
8075 </xs:complexType>
8076 </xs:element>
8077 <xs:element name="Component">
8078 <xs:annotation>
8079 <xs:documentation>Component for parent Directory</xs:documentation>
8080 <xs:appinfo>
8081 <xse:seeAlso ref="ComponentRef" />
8082 <xse:msiRef table="Component" href="http://msdn.microsoft.com/library/aa368007.aspx" />
8083 <xse:msiRef table="Condition" href="http://msdn.microsoft.com/library/aa368014.aspx" />
8084 <xse:msiRef table="Directory" href="http://msdn.microsoft.com/library/aa368295.aspx" />
8085 <xse:howtoRef href="files_and_registry/add_a_file.html">How To: Add a file to your installer</xse:howtoRef>
8086 </xs:appinfo>
8087 </xs:annotation>
8088 <xs:complexType>
8089 <xs:choice minOccurs="0" maxOccurs="unbounded">
8090 <xs:element ref="AppId" />
8091 <xs:element ref="Category" />
8092 <xs:element ref="Class" />
8093 <xs:element ref="CopyFile" />
8094 <xs:element ref="CreateFolder" />
8095 <xs:element ref="Environment" />
8096 <xs:element ref="Extension" />
8097 <xs:element ref="File" />
8098 <xs:element ref="IniFile" />
8099 <xs:element ref="Interface" />
8100 <xs:element ref="IsolateComponent" />
8101 <xs:element ref="ODBCDataSource" />
8102 <xs:element ref="ODBCDriver" />
8103 <xs:element ref="ODBCTranslator" />
8104 <xs:element ref="ProgId" />
8105 <xs:element ref="Provides" />
8106 <xs:element ref="RegistryKey" />
8107 <xs:element ref="RegistryValue" />
8108 <xs:element ref="RemoveFile" />
8109 <xs:element ref="RemoveFolder" />
8110 <xs:element ref="RemoveRegistryKey" />
8111 <xs:element ref="RemoveRegistryValue" />
8112 <xs:element ref="ReserveCost" />
8113 <xs:element ref="ServiceControl" />
8114 <xs:element ref="ServiceConfig" />
8115 <xs:element ref="ServiceConfigFailureActions" />
8116 <xs:element ref="ServiceInstall" />
8117 <xs:element ref="Shortcut" />
8118 <xs:element ref="SymbolPath" />
8119 <xs:element ref="TypeLib" />
8120 <xs:any namespace="##other" processContents="lax">
8121 <xs:annotation>
8122 <xs:documentation>
8123 Extensibility point in the WiX XML Schema. Schema extensions can register additional
8124 elements at this point in the schema.
8125 </xs:documentation>
8126 </xs:annotation>
8127 </xs:any>
8128 </xs:choice>
8129 <xs:attribute name="Id" type="xs:string">
8130 <xs:annotation>
8131 <xs:documentation>
8132 Component identifier; this is the primary key for identifying components. If omitted,
8133 the compiler defaults the identifier to the identifier of the resource that is the
8134 explicit or default keypath of the component (for example, a child File element).
8135 In WiX v4 and WiX v5, such a default identifier is private to the section where it is
8136 defined. To make it public (and therefore accessible from other sections and usable
8137 in references like ComponentRef), give the component an explicit value for Id.
8138 </xs:documentation>
8139 </xs:annotation>
8140 </xs:attribute>
8141 <xs:attribute name="ComPlusFlags" type="Integer">
8142 <xs:annotation>
8143 <xs:documentation>
8144 Set this attribute to create a ComPlus entry. The value should be the export flags used
8145 during the generation of the .msi file. For more information see the COM+ documentation
8146 in the Platform SDK.
8147 </xs:documentation>
8148 </xs:annotation>
8149 </xs:attribute>
8150 <xs:attribute name="Condition" type="xs:string">
8151 <xs:annotation>
8152 <xs:documentation>
8153 The condition expression to be evaluated at install time. When false the Component will not be installed.
8154 </xs:documentation>
8155 </xs:annotation>
8156 </xs:attribute>
8157 <xs:attribute name="DisableRegistryReflection" type="YesNoTypeUnion">
8158 <xs:annotation>
8159 <xs:documentation>
8160 Set this attribute to 'yes' in order to disable registry reflection on all existing and
8161 new registry keys affected by this component.
8162 When set to 'yes', the Windows Installer calls the RegDisableReflectionKey on each key
8163 being accessed by the component.
8164 This bit is available with Windows Installer version 4.0 and is ignored on 32-bit systems.
8165 </xs:documentation>
8166 </xs:annotation>
8167 </xs:attribute>
8168 <xs:attribute name="Directory" type="xs:string">
8169 <xs:annotation>
8170 <xs:documentation>
8171 Sets the Directory of the Component. If this element is nested under a Directory element,
8172 this value defaults to the value of the parent Directory/@Id.
8173 </xs:documentation>
8174 </xs:annotation>
8175 </xs:attribute>
8176 <xs:attribute name="DiskId" type="DiskIdType">
8177 <xs:annotation>
8178 <xs:documentation>
8179 This attribute provides a default DiskId attribute for all child File elements. Specifying
8180 the DiskId on a Component element will override any DiskId attributes set by parent Directory
8181 or DirectoryRef elements. See the File element's DiskId attribute for more information about
8182 the purpose of the DiskId.
8183 </xs:documentation>
8184 </xs:annotation>
8185 </xs:attribute>
8186 <xs:attribute name="Feature" type="xs:string">
8187 <xs:annotation>
8188 <xs:documentation>
8189 Identifies a feature to which this component belongs, as a shorthand for a child
8190 ComponentRef element of the Feature element. The value of this attribute should
8191 correspond to the Id attribute of a Feature element authored elsewhere. Note that
8192 a single component can belong to multiple features but this attribute allows you
8193 to specify only a single feature.
8194 </xs:documentation>
8195 </xs:annotation>
8196 </xs:attribute>
8197 <xs:attribute name="Guid" type="ComponentGuid">
8198 <xs:annotation>
8199 <xs:documentation>
8200 This value should be a guid that uniquely identifies this component's contents, language, platform, and version.
8201 If omitted, the default value is '*' which indicates that the linker should generate a stable guid.
8202 Generatable guids are supported only for components with a single file as the component's keypath
8203 or no files and a registry value as the keypath.
8204 It's also possible to set the value to an empty string to specify an unmanaged component.
8205 Unmanaged components are a security vulnerability because the component cannot be removed or repaired
8206 by Windows Installer (it is essentially an unpatchable, permanent component). Therefore, a guid should
8207 always be specified for any component which contains resources that may need to be patched in the future.
8208 </xs:documentation>
8209 </xs:annotation>
8210 </xs:attribute>
8211 <xs:attribute name="KeyPath" type="YesNoTypeUnion">
8212 <xs:annotation>
8213 <xs:documentation>
8214 If this attribute's value is set to 'yes', then the Directory of this Component is used
8215 as the KeyPath. To set a Registry value or File as the KeyPath of a component, set the
8216 KeyPath attribute to 'yes' on one of those child elements. If KeyPath is not set to 'yes' for the
8217 Component or for a child Registry value or File, WiX will look at the child elements under the
8218 Component in sequential order and try to automatically select one of them as a key path. Allowing
8219 WiX to automatically select a key path can be dangerous because adding or removing child elements
8220 under the Component can inadvertantly cause the key path to change, which can lead to
8221 installation problems.
8222 </xs:documentation>
8223 </xs:annotation>
8224 </xs:attribute>
8225 <xs:attribute name="Location">
8226 <xs:annotation>
8227 <xs:documentation>
8228 Optional value that specifies the location that the component can be run from.
8229 </xs:documentation>
8230 </xs:annotation>
8231 <xs:simpleType>
8232 <xs:restriction base="xs:NMTOKEN">
8233 <xs:enumeration value="local">
8234 <xs:annotation>
8235 <xs:documentation>
8236 Prevents the component from running from the source or the network (this is the default behavior if this attribute is not set).
8237 </xs:documentation>
8238 </xs:annotation>
8239 </xs:enumeration>
8240 <xs:enumeration value="source">
8241 <xs:annotation>
8242 <xs:documentation>
8243 Enforces that the component can only be run from the source (it cannot be run from the user's computer).
8244 </xs:documentation>
8245 </xs:annotation>
8246 </xs:enumeration>
8247 <xs:enumeration value="either">
8248 <xs:annotation>
8249 <xs:documentation>
8250 Allows the component to run from source or locally.
8251 </xs:documentation>
8252 </xs:annotation>
8253 </xs:enumeration>
8254 </xs:restriction>
8255 </xs:simpleType>
8256 </xs:attribute>
8257 <xs:attribute name="MultiInstance" type="YesNoTypeUnion">
8258 <xs:annotation>
8259 <xs:documentation>
8260 If this attribute is set to 'yes', a new Component/@Guid will be generated for each
8261 instance transform. Ensure that all of the resources contained in a multi-instance
8262 Component will be installed to different paths based on the instance Property; otherwise,
8263 the Component Rules will be violated.
8264 </xs:documentation>
8265 </xs:annotation>
8266 </xs:attribute>
8267 <xs:attribute name="NeverOverwrite" type="YesNoTypeUnion">
8268 <xs:annotation>
8269 <xs:documentation>
8270 If this attribute is set to 'yes', the installer does not install or reinstall the
8271 component if a key path file or a key path registry entry for the component already
8272 exists. The application does register itself as a client of the component. Use this
8273 flag only for components that are being registered by the Registry table. Do not use
8274 this flag for components registered by the AppId, Class, Extension, ProgId, MIME, and
8275 Verb tables.
8276 </xs:documentation>
8277 </xs:annotation>
8278 </xs:attribute>
8279 <xs:attribute name="Permanent" type="YesNoTypeUnion">
8280 <xs:annotation>
8281 <xs:documentation>
8282 If this attribute is set to 'yes', the installer does not remove the component during
8283 an uninstall. The installer registers an extra system client for the component in
8284 the Windows Installer registry settings (which basically just means that at least one
8285 product is always referencing this component). Note that this option differs from the
8286 behavior of not setting a guid because although the component is permanent, it is still
8287 patchable (because Windows Installer still tracks it), it's just not uninstallable.
8288 </xs:documentation>
8289 </xs:annotation>
8290 </xs:attribute>
8291 <xs:attribute name="Shared" type="YesNoTypeUnion">
8292 <xs:annotation>
8293 <xs:documentation>
8294 If this attribute's value is set to 'yes', enables advanced patching semantics for
8295 Components that are shared across multiple MSI packages. Specifically, the Windows Installer
8296 will cache the shared files to improve patch uninstall. This functionality is available
8297 in Windows Installer 4.5 and later.
8298 </xs:documentation>
8299 </xs:annotation>
8300 </xs:attribute>
8301 <xs:attribute name="SharedDllRefCount" type="YesNoTypeUnion">
8302 <xs:annotation>
8303 <xs:documentation>
8304 If this attribute's value is set to 'yes', the installer increments the reference count
8305 in the shared DLL registry of the component's key file. If this bit is not set, the
8306 installer increments the reference count only if the reference count already exists.
8307 </xs:documentation>
8308 </xs:annotation>
8309 </xs:attribute>
8310 <xs:attribute name="Subdirectory" type="xs:string">
8311 <xs:annotation>
8312 <xs:documentation>
8313 This attribute defines one or more directories below the directory referenced by the Directory attribute or parent
8314 Directory reference where the Component will be installed.
8315 </xs:documentation>
8316 </xs:annotation>
8317 </xs:attribute>
8318 <xs:attribute name="Transitive" type="YesNoTypeUnion">
8319 <xs:annotation>
8320 <xs:documentation>
8321 If this attribute is set to 'yes', the installer reevaluates the value of the statement
8322 in the Condition upon a reinstall. If the value was previously False and has changed to
8323 True, the installer installs the component. If the value was previously True and has
8324 changed to False, the installer removes the component even if the component has other
8325 products as clients.
8326 </xs:documentation>
8327 </xs:annotation>
8328 </xs:attribute>
8329 <xs:attribute name="UninstallWhenSuperseded" type="YesNoTypeUnion">
8330 <xs:annotation>
8331 <xs:documentation>
8332 If this attribute is set to 'yes', the installer will uninstall the Component's files
8333 and registry keys when it is superseded by a patch. This functionality is available in
8334 Windows Installer 4.5 and later.
8335 </xs:documentation>
8336 </xs:annotation>
8337 </xs:attribute>
8338 <xs:attribute name="Bitness" type="BitnessTypeUnion">
8339 <xs:annotation>
8340 <xs:documentation>
8341 Overrides the default Component bitness. Only 64-bit Components can install to 64-bit locations such
8342 as `ProgramFiles64Folder` and the 64-bit registry. The value `always64` will force the Component
8343 bitness to be 64-bit and cannot be included in 32-bit packages.
8344 Simliarly, the value `always32` will force the Component bitness to 32-bit and can be included in
8345 32-bit or 64-bit packages.
8346 The default value is `default` where the Component will be installed using the
8347 same bitness as the package.
8348 </xs:documentation>
8349 </xs:annotation>
8350 </xs:attribute>
8351 <xs:anyAttribute namespace="##other" processContents="lax">
8352 <xs:annotation>
8353 <xs:documentation>
8354 Extensibility point in the WiX XML Schema. Schema extensions can register additional
8355 attributes at this point in the schema.
8356 </xs:documentation>
8357 </xs:annotation>
8358 </xs:anyAttribute>
8359 </xs:complexType>
8360 </xs:element>
8361 <xs:element name="ComponentGroup">
8362 <xs:annotation>
8363 <xs:documentation>
8364 Groups together multiple components to be used in other locations.
8365 </xs:documentation>
8366 <xs:appinfo>
8367 <xse:seeAlso ref="ComponentGroupRef" />
8368 </xs:appinfo>
8369 </xs:annotation>
8370 <xs:complexType>
8371 <xs:choice minOccurs="0" maxOccurs="unbounded">
8372 <xs:element ref="Component" />
8373 <xs:element ref="ComponentGroupRef" />
8374 <xs:element ref="ComponentRef" />
8375 <xs:element ref="File" />
8376 <xs:element ref="Files" />
8377 <xs:any namespace="##other" processContents="lax">
8378 <xs:annotation>
8379 <xs:documentation>
8380 Extensibility point in the WiX XML Schema. Schema extensions can register additional
8381 elements at this point in the schema.
8382 </xs:documentation>
8383 </xs:annotation>
8384 </xs:any>
8385 </xs:choice>
8386 <xs:attribute name="Id" type="xs:string" use="required">
8387 <xs:annotation>
8388 <xs:documentation>Identifier for the ComponentGroup.</xs:documentation>
8389 </xs:annotation>
8390 </xs:attribute>
8391 <xs:attribute name="Directory" type="xs:string">
8392 <xs:annotation>
8393 <xs:documentation>
8394 Sets the default directory identifier for child Component elements.
8395 </xs:documentation>
8396 </xs:annotation>
8397 </xs:attribute>
8398 <xs:attribute name="Subdirectory" type="xs:string">
8399 <xs:annotation>
8400 <xs:documentation>
8401 This attribute defines one or more directories below the directory referenced by the Directory attribute or parent
8402 Directory reference where the contained Components will be installed.
8403 </xs:documentation>
8404 </xs:annotation>
8405 </xs:attribute>
8406 <xs:attribute name="Source" type="xs:string">
8407 <xs:annotation>
8408 <xs:documentation>
8409 Used to set the default file system source for child Component elements. For more information, see
8410 [Specifying source files](../../tools/payloads.md).
8411 </xs:documentation>
8412 </xs:annotation>
8413 </xs:attribute>
8414 <xs:anyAttribute namespace="##other" processContents="lax">
8415 <xs:annotation>
8416 <xs:documentation>
8417 Extensibility point in the WiX XML Schema. Schema extensions can register additional
8418 attributes at this point in the schema.
8419 </xs:documentation>
8420 </xs:annotation>
8421 </xs:anyAttribute>
8422 </xs:complexType>
8423 </xs:element>
8424 <xs:element name="ComponentGroupRef">
8425 <xs:annotation>
8426 <xs:documentation>
8427 Create a reference to a ComponentGroup in another Fragment.
8428 _New in WiX v5: Can be a child of the `Package` element._
8429 </xs:documentation>
8430 <xs:appinfo>
8431 <xse:seeAlso ref="ComponentGroup" />
8432 </xs:appinfo>
8433 </xs:annotation>
8434 <xs:complexType>
8435 <xs:attribute name="Id" type="xs:string" use="required">
8436 <xs:annotation>
8437 <xs:documentation>The identifier of the ComponentGroup to reference.</xs:documentation>
8438 </xs:annotation>
8439 </xs:attribute>
8440 <xs:attribute name="Primary" type="YesNoTypeUnion">
8441 <xs:annotation>
8442 <xs:documentation>
8443 Set this attribute to 'yes' in order to make the parent feature of this component
8444 the primary feature for this component. Components may belong to multiple features.
8445 By designating a feature as the primary feature of a component, you ensure that
8446 whenever a component is selected for install-on-demand (IOD), the primary feature
8447 will be the one to install it. This attribute should only be set if a component
8448 actually nests under multiple features. If a component nests under only one feature,
8449 that feature is the primary feature for the component. You cannot set more than one
8450 feature as the primary feature of a given component.
8451 </xs:documentation>
8452 </xs:annotation>
8453 </xs:attribute>
8454 <xs:anyAttribute namespace="##other" processContents="lax">
8455 <xs:annotation>
8456 <xs:documentation>
8457 Extensibility point in the WiX XML Schema. Schema extensions can register additional
8458 attributes at this point in the schema.
8459 </xs:documentation>
8460 </xs:annotation>
8461 </xs:anyAttribute>
8462 </xs:complexType>
8463 </xs:element>
8464 <xs:element name="All">
8465 <xs:annotation>
8466 <xs:documentation>Used only for PatchFamilies to include all changes between the baseline and upgraded packages in a patch.</xs:documentation>
8467 <xs:appinfo>
8468 <xse:remarks>
8469 <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>
8470 <html:p>Because changing the ProductCode is not supported in a patch, the ProductCode property is automatically removed from the transform.</html:p>
8471 </xse:remarks>
8472 </xs:appinfo>
8473 </xs:annotation>
8474 </xs:element>
8475 <xs:element name="BinaryRef">
8476 <xs:annotation>
8477 <xs:documentation>Used only for PatchFamilies to include only a binary table entry in a patch.</xs:documentation>
8478 </xs:annotation>
8479 <xs:complexType>
8480 <xs:attribute name="Id" type="xs:string" use="required">
8481 <xs:annotation>
8482 <xs:documentation>The identifier of the Binary element to reference.</xs:documentation>
8483 </xs:annotation>
8484 </xs:attribute>
8485 <xs:anyAttribute namespace="##other" processContents="lax">
8486 <xs:annotation>
8487 <xs:documentation>
8488 Extensibility point in the WiX XML Schema. Schema extensions can register additional
8489 attributes at this point in the schema.
8490 </xs:documentation>
8491 </xs:annotation>
8492 </xs:anyAttribute>
8493 </xs:complexType>
8494 </xs:element>
8495 <xs:element name="IconRef">
8496 <xs:annotation>
8497 <xs:documentation>Used only for PatchFamilies to include only a icon table entry in a patch.</xs:documentation>
8498 </xs:annotation>
8499 <xs:complexType>
8500 <xs:attribute name="Id" type="xs:string" use="required">
8501 <xs:annotation>
8502 <xs:documentation>The identifier of the Icon element to reference.</xs:documentation>
8503 </xs:annotation>
8504 </xs:attribute>
8505 <xs:anyAttribute namespace="##other" processContents="lax">
8506 <xs:annotation>
8507 <xs:documentation>
8508 Extensibility point in the WiX XML Schema. Schema extensions can register additional
8509 attributes at this point in the schema.
8510 </xs:documentation>
8511 </xs:annotation>
8512 </xs:anyAttribute>
8513 </xs:complexType>
8514 </xs:element>
8515 <xs:element name="ComponentRef">
8516 <xs:annotation>
8517 <xs:documentation>
8518 Create a reference to a Feature element in another Fragment.
8519 _New in WiX v5: Can be a child of the `Package` element._
8520 </xs:documentation>
8521 <xs:appinfo>
8522 <xse:seeAlso ref="Component" />
8523 <xse:howtoRef href="files_and_registry/add_a_file.html">How To: Add a file to your installer</xse:howtoRef>
8524 </xs:appinfo>
8525 </xs:annotation>
8526 <xs:complexType>
8527 <xs:attribute name="Id" type="xs:string" use="required">
8528 <xs:annotation>
8529 <xs:documentation>The identifier of the Component element to reference.</xs:documentation>
8530 </xs:annotation>
8531 </xs:attribute>
8532 <xs:attribute name="Primary" type="YesNoTypeUnion">
8533 <xs:annotation>
8534 <xs:documentation>
8535 Set this attribute to 'yes' in order to make the parent feature of this component
8536 the primary feature for this component. Components may belong to multiple features.
8537 By designating a feature as the primary feature of a component, you ensure that
8538 whenever a component is selected for install-on-demand (IOD), the primary feature
8539 will be the one to install it. This attribute should only be set if a component
8540 actually nests under multiple features. If a component nests under only one feature,
8541 that feature is the primary feature for the component. You cannot set more than one
8542 feature as the primary feature of a given component.
8543 </xs:documentation>
8544 </xs:annotation>
8545 </xs:attribute>
8546 <xs:anyAttribute namespace="##other" processContents="lax">
8547 <xs:annotation>
8548 <xs:documentation>
8549 Extensibility point in the WiX XML Schema. Schema extensions can register additional
8550 attributes at this point in the schema.
8551 </xs:documentation>
8552 </xs:annotation>
8553 </xs:anyAttribute>
8554 </xs:complexType>
8555 </xs:element>
8556 <xs:element name="Merge">
8557 <xs:annotation>
8558 <xs:appinfo>
8559 <xse:seeAlso ref="MergeRef" />
8560 <xse:howtoRef href="redistributables_and_install_checks/install_vcredist.html">How To: Install the Visual C++ Redistributable with your installer</xse:howtoRef>
8561 </xs:appinfo>
8562 <xs:documentation>Merge directive to bring in a merge module that will be redirected to the parent directory.</xs:documentation>
8563 </xs:annotation>
8564 <xs:complexType>
8565 <xs:choice minOccurs="0" maxOccurs="unbounded">
8566 <xs:element ref="ConfigurationData">
8567 <xs:annotation>
8568 <xs:documentation>Data to use as input to a configurable merge module.</xs:documentation>
8569 </xs:annotation>
8570 </xs:element>
8571 </xs:choice>
8572 <xs:attribute name="Id" type="xs:string" use="required">
8573 <xs:annotation>
8574 <xs:documentation>The unique identifier for the Merge element in the source code. Referenced by the MergeRef/@Id.</xs:documentation>
8575 </xs:annotation>
8576 </xs:attribute>
8577 <xs:attribute name="DiskId" type="DiskIdType">
8578 <xs:annotation>
8579 <xs:documentation>The value of this attribute should correspond to the Id attribute of a
8580 Media element authored elsewhere. By creating this connection between the merge module and Media
8581 element, you set the packaging options to the values specified in the Media
8582 element (values such as compression level, cab embedding, etc...).</xs:documentation>
8583 </xs:annotation>
8584 </xs:attribute>
8585 <xs:attribute name="FileCompression" type="YesNoTypeUnion">
8586 <xs:annotation>
8587 <xs:documentation>Specifies if the files in the merge module should be compressed.</xs:documentation>
8588 </xs:annotation>
8589 </xs:attribute>
8590 <xs:attribute name="Language" type="LocalizableInteger" use="required">
8591 <xs:annotation>
8592 <xs:documentation>Specifies the decimal LCID or localization token for the language to merge the Module in as.</xs:documentation>
8593 </xs:annotation>
8594 </xs:attribute>
8595 <xs:attribute name="SourceFile" type="xs:string">
8596 <xs:annotation>
8597 <xs:documentation>Path to the source location of the merge module.</xs:documentation>
8598 </xs:annotation>
8599 </xs:attribute>
8600 </xs:complexType>
8601 </xs:element>
8602 <xs:element name="MergeRef">
8603 <xs:annotation>
8604 <xs:appinfo>
8605 <xse:seeAlso ref="Merge" />
8606 <xse:howtoRef href="redistributables_and_install_checks/install_vcredist.html">How To: Install the Visual C++ Redistributable with your installer</xse:howtoRef>
8607 </xs:appinfo>
8608 <xs:documentation>Merge reference to connect a Merge Module to parent Feature</xs:documentation>
8609 </xs:annotation>
8610 <xs:complexType>
8611 <xs:attribute name="Id" type="xs:string" use="required">
8612 <xs:annotation>
8613 <xs:documentation>The unique identifier for the Merge element to be referenced.</xs:documentation>
8614 </xs:annotation>
8615 </xs:attribute>
8616 <xs:attribute name="Primary" type="YesNoTypeUnion">
8617 <xs:annotation>
8618 <xs:documentation>Specifies whether the feature containing this MergeRef is the primary feature for advertising the merge module's components.</xs:documentation>
8619 </xs:annotation>
8620 </xs:attribute>
8621 <xs:anyAttribute namespace="##other" processContents="lax">
8622 <xs:annotation>
8623 <xs:documentation>
8624 Extensibility point in the WiX XML Schema. Schema extensions can register additional
8625 attributes at this point in the schema.
8626 </xs:documentation>
8627 </xs:annotation>
8628 </xs:anyAttribute>
8629 </xs:complexType>
8630 </xs:element>
8631 <xs:element name="ConfigurationData">
8632 <xs:annotation>
8633 <xs:documentation>Data to use as input to a configurable merge module.</xs:documentation>
8634 </xs:annotation>
8635 <xs:complexType>
8636 <xs:attribute name="Name" type="xs:string" use="required">
8637 <xs:annotation>
8638 <xs:documentation>Name of the item in the ModuleConfiguration table.</xs:documentation>
8639 </xs:annotation>
8640 </xs:attribute>
8641 <xs:attribute name="Value" type="xs:string" use="required">
8642 <xs:annotation>
8643 <xs:documentation>Value to be passed to configurable merge module.</xs:documentation>
8644 </xs:annotation>
8645 </xs:attribute>
8646 </xs:complexType>
8647 </xs:element>
8648 <xs:element name="Directory">
8649 <xs:annotation>
8650 <xs:documentation>Directory layout for the product. Also specifies the mappings between source and target directories.</xs:documentation>
8651 <xs:appinfo>
8652 <xse:seeAlso ref="DirectoryRef" />
8653 <xse:msiRef table="Directory" href="http://msdn.microsoft.com/library/aa368295.aspx" />
8654 <xse:howtoRef href="files_and_registry/add_a_file.html">How To: Add a file to your installer</xse:howtoRef>
8655 </xs:appinfo>
8656 </xs:annotation>
8657 <xs:complexType>
8658 <xs:choice minOccurs="0" maxOccurs="unbounded">
8659 <xs:element ref="Component" />
8660 <xs:element ref="Directory" />
8661 <xs:element ref="File" />
8662 <xs:element ref="Files" />
8663 <xs:element ref="Merge" />
8664 <xs:element ref="SymbolPath" />
8665 <xs:any namespace="##other" processContents="lax">
8666 <xs:annotation>
8667 <xs:documentation>
8668 Extensibility point in the WiX XML Schema. Schema extensions can register additional
8669 elements at this point in the schema.
8670 </xs:documentation>
8671 </xs:annotation>
8672 </xs:any>
8673 </xs:choice>
8674 <xs:attribute name="Id" type="xs:string">
8675 <xs:annotation>
8676 <xs:documentation>
8677 An optional identifier for the directory. If one is not specified,
8678 a private identifier will be generated.
8679 </xs:documentation>
8680 </xs:annotation>
8681 </xs:attribute>
8682 <xs:attribute name="ComponentGuidGenerationSeed" type="Guid">
8683 <xs:annotation>
8684 <xs:documentation>
8685 The Component Guid Generation Seed is a guid that must be used when a Component with the generate guid directive ("*")
8686 is not rooted in a standard Windows Installer directory (for example, ProgramFilesFolder or CommonFilesFolder).
8687 It is recommended that this attribute be avoided and that developers install their Components under standard
8688 directories with unique names instead (for example, "ProgramFilesFolder\Company Name Product Name Version"). It is
8689 important to note that once a directory is assigned a Component Guid Generation Seed the value must not change until
8690 (and must be changed when) the path to that directory, including itself and all parent directories, changes.
8691 </xs:documentation>
8692 </xs:annotation>
8693 </xs:attribute>
8694 <xs:attribute name="DiskId" type="DiskIdType">
8695 <xs:annotation>
8696 <xs:documentation>
8697 Sets the default disk identifier for the files contained in this directory.
8698 This attribute's value may be overridden by a child Component, Directory,
8699 Merge or File element. See the File or Merge elements' DiskId attribute for
8700 more information.
8701 </xs:documentation>
8702 </xs:annotation>
8703 </xs:attribute>
8704 <xs:attribute name="FileSource" type="xs:string">
8705 <xs:annotation>
8706 <xs:documentation>Used to set the file system source for this directory's child elements.
8707 For more information, see [Specifying source files](../../tools/payloads.md).</xs:documentation>
8708 </xs:annotation>
8709 </xs:attribute>
8710 <xs:attribute name="Name" type="xs:string">
8711 <xs:annotation>
8712 <xs:documentation>
8713 The name of the directory.
8714
8715 Do not specify this attribute if this directory represents
8716 the same directory as the parent (see the Windows Installer SDK's
8717 <html:a href="http://msdn.microsoft.com/library/Aa368295.aspx">Directory table</html:a>
8718 topic for more information about the "." operator).
8719
8720 This attribute's value may either a short or long directory name. If a short directory
8721 name is specified, the ShortName attribute may not be specified. If this value is a long
8722 directory name, the ShortName attribute may be omitted to
8723 allow WiX to attempt to generate a unique short directory name.
8724 However, if this name collides with another directory or you wish to manually specify
8725 the short directory name, then the ShortName attribute may be specified.
8726 </xs:documentation>
8727 </xs:annotation>
8728 </xs:attribute>
8729 <xs:attribute name="ShortName" type="ShortFileNameType">
8730 <xs:annotation>
8731 <xs:documentation>
8732 The short name of the directory in 8.3 format.
8733 This attribute should only be set if there is a conflict between generated short directory names
8734 or the user wants to manually specify the short directory name.
8735 </xs:documentation>
8736 </xs:annotation>
8737 </xs:attribute>
8738 <xs:attribute name="ShortSourceName" type="ShortFileNameType">
8739 <xs:annotation>
8740 <xs:documentation>
8741 The short name of the directory on the source media in 8.3 format.
8742 This attribute should only be set if there is a conflict between generated short directory names
8743 or the user wants to manually specify the short source directory name.
8744 </xs:documentation>
8745 </xs:annotation>
8746 </xs:attribute>
8747 <xs:attribute name="SourceName" type="LongFileNameType">
8748 <xs:annotation>
8749 <xs:documentation>
8750 The name of the directory on the source media.
8751 If this attribute is not specified, Windows Installer will default to the Name attribute.
8752
8753 In prior versions of the WiX toolset, this attribute specified the short source directory name.
8754 This attribute's value may now be either a short or long directory name.
8755 If a short directory name is specified, the ShortSourceName attribute may not be specified.
8756 If a long directory name is specified, the LongSource attribute may not be specified.
8757 Also, if this value is a long directory name, the ShortSourceName attribute may be omitted to
8758 allow WiX to attempt to generate a unique short directory name.
8759 However, if this name collides with another directory or you wish to manually specify
8760 the short directory name, then the ShortSourceName attribute may be specified.
8761 </xs:documentation>
8762 </xs:annotation>
8763 </xs:attribute>
8764 <xs:anyAttribute namespace="##other" processContents="lax">
8765 <xs:annotation>
8766 <xs:documentation>
8767 Extensibility point in the WiX XML Schema. Schema extensions can register additional
8768 attributes at this point in the schema.
8769 </xs:documentation>
8770 </xs:annotation>
8771 </xs:anyAttribute>
8772 </xs:complexType>
8773 </xs:element>
8774 <xs:element name="DirectoryRef">
8775 <xs:annotation>
8776 <xs:documentation>Create a reference to a Directory element in another Fragment.</xs:documentation>
8777 <xs:appinfo>
8778 <xse:seeAlso ref="Directory" />
8779 <xse:howtoRef href="files_and_registry/add_a_file.html">How To: Add a file to your installer</xse:howtoRef>
8780 </xs:appinfo>
8781 </xs:annotation>
8782 <xs:complexType>
8783 <xs:choice minOccurs="0" maxOccurs="unbounded">
8784 <xs:element ref="Component" />
8785 <xs:element ref="Directory" />
8786 <xs:element ref="File" />
8787 <xs:element ref="Files" />
8788 <xs:element ref="Merge" />
8789 <xs:any namespace="##other" processContents="lax">
8790 <xs:annotation>
8791 <xs:documentation>
8792 Extensibility point in the WiX XML Schema. Schema extensions can register additional
8793 elements at this point in the schema.
8794 </xs:documentation>
8795 </xs:annotation>
8796 </xs:any>
8797 </xs:choice>
8798 <xs:attribute name="Id" type="xs:string" use="required">
8799 <xs:annotation>
8800 <xs:documentation>The identifier of the Directory element to reference.</xs:documentation>
8801 </xs:annotation>
8802 </xs:attribute>
8803 <xs:attribute name="DiskId" type="DiskIdType">
8804 <xs:annotation>
8805 <xs:documentation>
8806 Sets the default disk identifier for the files contained in this directory.
8807 This attribute's value may be overridden by a child Component, Directory,
8808 Merge or File element. See the File or Merge elements' DiskId attribute for
8809 more information.
8810 </xs:documentation>
8811 </xs:annotation>
8812 </xs:attribute>
8813 <xs:attribute name="FileSource" type="xs:string">
8814 <xs:annotation>
8815 <xs:documentation>Used to set the file system source for this DirectoryRef's child elements.
8816 For more information, see [Specifying source files](../../tools/payloads.md).</xs:documentation>
8817 </xs:annotation>
8818 </xs:attribute>
8819 <xs:anyAttribute namespace="##other" processContents="lax">
8820 <xs:annotation>
8821 <xs:documentation>
8822 Extensibility point in the WiX XML Schema. Schema extensions can register additional
8823 attributes at this point in the schema.
8824 </xs:documentation>
8825 </xs:annotation>
8826 </xs:anyAttribute>
8827 </xs:complexType>
8828 </xs:element>
8829 <xs:element name="SoftwareTag">
8830 <xs:annotation>
8831 <xs:documentation>
8832 This extension implements the ISO/IEC 19770-2:2015 specification. A SWID tag file
8833 will be generated an inserted into the Package or Bundle.
8834 </xs:documentation>
8835 </xs:annotation>
8836 <xs:complexType>
8837 <xs:attribute name="Name" type="xs:string">
8838 <xs:annotation>
8839 <xs:documentation>
8840 Name to use in the filename for the software id tag. By default the filename
8841 uses the Bundle/@Name or Package/@Name. If the bundle name or package name contains
8842 invalid filename characters such as ":" or "?", use this attribute to provide
8843 a valid filename.
8844 </xs:documentation>
8845 </xs:annotation>
8846 </xs:attribute>
8847 <xs:attribute name="Regid" type="xs:string" use="required">
8848 <xs:annotation>
8849 <xs:documentation>
8850 The regid for the software manufacturer. A regid is a URI simplified for the common
8851 case. Namely, if the scheme is "http://", it can be removed. Additionally, the domain
8852 should be minimized as much as possible (for example, remove "www." prefix if unnecessary).
8853
8854 For example, the WiX toolset regid is "wixtoolset.org".
8855 </xs:documentation>
8856 </xs:annotation>
8857 </xs:attribute>
8858 <xs:attribute name="InstallDirectory" type="xs:string">
8859 <xs:annotation>
8860 <xs:documentation>
8861 A reference to an existing Directory/@Id where the software is installed. The SWID tag file will be installed in a "swidtag" folder
8862 under that directory as per the specification. This attribute is required on a SoftwareTag element found under a Package element.
8863 </xs:documentation>
8864 </xs:annotation>
8865 </xs:attribute>
8866 <xs:attribute name="InstallPath" type="xs:string">
8867 <xs:annotation>
8868 <xs:documentation>
8869 The path where the software is installed. The SWID tag file will be installed in a "swidtag" folder.
8870 This is a formatted attribute so it is possible to use Variables as the InstallPath by setting
8871 the value to, for example, "[ProgramFilesFolder]CompanyName\Product Name". This attribute is required
8872 on a SoftwareTag element found under a Bundle element.
8873 </xs:documentation>
8874 </xs:annotation>
8875 </xs:attribute>
8876 <xs:attribute name="Feature" type="xs:string">
8877 <xs:annotation>
8878 <xs:documentation>
8879 Optional attribute to explicitly set the Feature when defining the software id tag
8880 in a Package. By default the software id tag will always be installed by a top-level hidden feature.
8881 It is recommended to <html:strong>not</html:strong> set this attribute.
8882 </xs:documentation>
8883 </xs:annotation>
8884 </xs:attribute>
8885 <xs:attribute name="Bitness" type="BitnessTypeUnion">
8886 <xs:annotation>
8887 <xs:documentation>
8888 This attribute facilitates the installation of packages that install both 32-bit and 64-bit files. Set this attribute to 'always32'
8889 force the software id tag to a 32-bit location (such as "ProgramFilesFolder") or 'always64' to force the tag to be installed to
8890 a 64-bit location (such as "ProgramFiles64Folder").
8891
8892 The default value is `default` where the tag will be installed to the directory that matches the
8893 same bitness as the package.
8894
8895 This attribute is only allowed on a SoftwareTag element found under a Package element.
8896 </xs:documentation>
8897 </xs:annotation>
8898 </xs:attribute>
8899 </xs:complexType>
8900 </xs:element>
8901 <xs:element name="StandardDirectory">
8902 <xs:annotation>
8903 <xs:documentation>References a standard Windows Installer directory, such as ProgramFilesFolder.</xs:documentation>
8904 <xs:appinfo>
8905 <xse:seeAlso ref="Directory" />
8906 <xse:howtoRef href="files_and_registry/add_a_file.html">How To: Add a file to your installer</xse:howtoRef>
8907 </xs:appinfo>
8908 </xs:annotation>
8909 <xs:complexType>
8910 <xs:choice minOccurs="0" maxOccurs="unbounded">
8911 <xs:element ref="Component" />
8912 <xs:element ref="Directory" />
8913 <xs:element ref="File" />
8914 <xs:element ref="Files" />
8915 <xs:element ref="Merge" />
8916 <xs:any namespace="##other" processContents="lax">
8917 <xs:annotation>
8918 <xs:documentation>
8919 Extensibility point in the WiX XML Schema. Schema extensions can register additional
8920 elements at this point in the schema.
8921 </xs:documentation>
8922 </xs:annotation>
8923 </xs:any>
8924 </xs:choice>
8925 <xs:attribute name="Id" type="StandardDirectoryTypeUnion" use="required">
8926 <xs:annotation>
8927 <xs:documentation>The identifier of the standard directory to include in the package.</xs:documentation>
8928 </xs:annotation>
8929 </xs:attribute>
8930 <xs:anyAttribute namespace="##other" processContents="lax">
8931 <xs:annotation>
8932 <xs:documentation>
8933 Extensibility point in the WiX XML Schema. Schema extensions can register additional
8934 attributes at this point in the schema.
8935 </xs:documentation>
8936 </xs:annotation>
8937 </xs:anyAttribute>
8938 </xs:complexType>
8939 </xs:element>
8940 <xs:element name="Files">
8941 <xs:annotation>
8942 <xs:documentation>
8943 Authoring to define the set of files to be harvested for inclusion in a package.
8944 </xs:documentation>
8945 </xs:annotation>
8946 <xs:complexType>
8947 <xs:choice minOccurs="0" maxOccurs="unbounded">
8948 <xs:element ref="Exclude" />
8949 <xs:any namespace="##other" processContents="lax">
8950 <xs:annotation>
8951 <xs:documentation>
8952 Extensibility point in the WiX XML Schema. Schema extensions can register additional
8953 elements at this point in the schema.
8954 </xs:documentation>
8955 </xs:annotation>
8956 </xs:any>
8957 </xs:choice>
8958 <xs:attribute name="Include" type="xs:string" use="required">
8959 <xs:annotation>
8960 <xs:documentation>
8961 A file-selection pattern that can include directory names, file names, and wildcards.
8962 If a pattern is not an absolute path (via a preprocessor variable, unnamed bind path,
8963 or named bind path), it is interpreted as relative to the directory containing the
8964 source file. Absolute paths via a named bind path are recommended.
8965
8966 Wildcards include typical `*.ext` globs and MSBuild-style `**` globs to indicate
8967 that directories should be recursed. Examples include:
8968
8969 | Pattern | Description |
8970 | ------- | ----------- |
8971 | `!(bindpath.ToBeHarvested)\**` | All files in the parent directory identified by the `ToBeHarvested` bind path and its subdirectories. |
8972 | `$(PayloadFiles)\bin\Release\**` | All files in the `bin\Release` subdirectory in the directory named by the `PayloadFiles` preprocessor variable and its subdirectories. |
8973 | `!(bindpath.arm64)\**.pdb` | All files with `.pdb` extension in the parent directory identified by the `arm64` bind path and its subdirectories. |
8974 | `**` | If an unnamed bind path was specified, all files in that directory and its subdirectories. If an unnamed bind path was _not_ specified, all files in directory of the source .wxs file and its subdirectories. |
8975 </xs:documentation>
8976 </xs:annotation>
8977 </xs:attribute>
8978 <xs:attribute name="Directory" type="xs:string">
8979 <xs:annotation>
8980 <xs:documentation>
8981 This attribute specifies a reference to a Directory element with matching Id attribute containing a directory path
8982 for the root of the harvested files.
8983 </xs:documentation>
8984 </xs:annotation>
8985 </xs:attribute>
8986 <xs:attribute name="Subdirectory" type="xs:string">
8987 <xs:annotation>
8988 <xs:documentation>
8989 This attribute defines one or more directories below the directory referenced by the Directory attribute.
8990 This attribute is optional but can only be specified when the Directory attribute is also specified.
8991 </xs:documentation>
8992 </xs:annotation>
8993 </xs:attribute>
8994 <xs:anyAttribute namespace="##other" processContents="lax">
8995 <xs:annotation>
8996 <xs:documentation>
8997 Extensibility point in the WiX XML Schema. Schema extensions can register additional
8998 attributes at this point in the schema.
8999 </xs:documentation>
9000 </xs:annotation>
9001 </xs:anyAttribute>
9002 </xs:complexType>
9003 </xs:element>
9004 <xs:element name="Exclude">
9005 <xs:annotation>
9006 <xs:documentation>
9007 Using wildcards, defines the files from a parent `Files` element that should be excluded from harvesting.
9008 </xs:documentation>
9009 </xs:annotation>
9010 <xs:complexType>
9011 <xs:choice minOccurs="0" maxOccurs="unbounded">
9012 <xs:any namespace="##other" processContents="lax">
9013 <xs:annotation>
9014 <xs:documentation>
9015 Extensibility point in the WiX XML Schema. Schema extensions can register additional
9016 elements at this point in the schema.
9017 </xs:documentation>
9018 </xs:annotation>
9019 </xs:any>
9020 </xs:choice>
9021 <xs:attribute name="Files" type="xs:string" use="required">
9022 <xs:annotation>
9023 <xs:documentation>
9024 Excludes files from the set of files harvested via the parent `Files` element.
9025 Inclusion and exclusion wildcards must match paths. For example, if you have a
9026 `Files` element with `Include="!(bindpath.ToBeHarvested)\**"` and want to
9027 exclude one of the files, use an `Exclude` element with a `Files` attribute
9028 like `!(bindpath.ToBeHarvested)\notatest.txt` to match the inclusion path.
9029 You can also use the `**` wildcard to match directories, such as
9030 `Files="**\pleasedontincludeme.dat"`.
9031
9032 The file-selection pattern can include directory names, file names, and wildcards.
9033 If a pattern is not an absolute path (via a preprocessor variable, unnamed bind path,
9034 or named bind path), it is interpreted as relative to the directory containing the
9035 source file. Absolute paths via a named bind path are recommended.
9036
9037 Wildcards include typical `*.ext` globs and MSBuild-style `**` globs to indicate
9038 that directories should be recursed. Examples include:
9039
9040 | Pattern | Description |
9041 | ------- | ----------- |
9042 | `!(bindpath.ToBeHarvested)\**` | All files in the parent directory identified by the `ToBeHarvested` bind path and its subdirectories. |
9043 | `$(PayloadFiles)\bin\Release\**` | All files in the `bin\Release` subdirectory in the directory named by the `PayloadFiles` preprocessor variable and its subdirectories. |
9044 | `!(bindpath.arm64)\**.pdb` | All files with `.pdb` extension in the parent directory identified by the `arm64` bind path and its subdirectories. |
9045 | `**` | If an unnamed bind path was specified, all files in that directory and its subdirectories. If an unnamed bind path was _not_ specified, all files in directory of the source .wxs file and its subdirectories. |
9046 </xs:documentation>
9047 </xs:annotation>
9048 </xs:attribute>
9049 <xs:anyAttribute namespace="##other" processContents="lax">
9050 <xs:annotation>
9051 <xs:documentation>
9052 Extensibility point in the WiX XML Schema. Schema extensions can register additional
9053 attributes at this point in the schema.
9054 </xs:documentation>
9055 </xs:annotation>
9056 </xs:anyAttribute>
9057 </xs:complexType>
9058 </xs:element>
9059 <xs:element name="UpgradeVersion">
9060 <xs:annotation>
9061 <xs:appinfo>
9062 <xse:msiRef table="Upgrade" href="https://learn.microsoft.com/en-us/windows/win32/msi/upgrade-table" />
9063 </xs:appinfo>
9064 </xs:annotation>
9065 <xs:complexType>
9066 <xs:attribute name="Minimum" type="xs:string">
9067 <xs:annotation>
9068 <xs:documentation>Specifies the lower bound on the range of product versions to be detected by FindRelatedProducts.</xs:documentation>
9069 </xs:annotation>
9070 </xs:attribute>
9071 <xs:attribute name="Maximum" type="xs:string">
9072 <xs:annotation>
9073 <xs:documentation>Specifies the upper boundary of the range of product versions detected by FindRelatedProducts.</xs:documentation>
9074 </xs:annotation>
9075 </xs:attribute>
9076 <xs:attribute name="Language" type="xs:string">
9077 <xs:annotation>
9078 <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>
9079 </xs:annotation>
9080 </xs:attribute>
9081 <xs:attribute name="RemoveFeatures" type="xs:string">
9082 <xs:annotation>
9083 <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>
9084 </xs:annotation>
9085 </xs:attribute>
9086 <xs:attribute name="Property" type="xs:string" use="required">
9087 <xs:annotation>
9088 <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="https://learn.microsoft.com/en-us/windows/win32/msi/upgrade-table">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">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>
9089 </xs:annotation>
9090 </xs:attribute>
9091 <xs:attribute name="MigrateFeatures" type="YesNoTypeUnion">
9092 <xs:annotation>
9093 <xs:documentation>Set to "yes" to migrate feature states from upgraded products by enabling the logic in the MigrateFeatureStates action.</xs:documentation>
9094 </xs:annotation>
9095 </xs:attribute>
9096 <xs:attribute name="OnlyDetect" type="YesNoTypeUnion">
9097 <xs:annotation>
9098 <xs:documentation>Set to "yes" to detect products and applications but do not uninstall.</xs:documentation>
9099 </xs:annotation>
9100 </xs:attribute>
9101 <xs:attribute name="IgnoreRemoveFailure" type="YesNoTypeUnion">
9102 <xs:annotation>
9103 <xs:documentation>Set to "yes" to continue installation upon failure to remove a product or application.</xs:documentation>
9104 </xs:annotation>
9105 </xs:attribute>
9106 <xs:attribute name="IncludeMinimum" type="YesNoTypeUnion">
9107 <xs:annotation>
9108 <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>
9109 </xs:annotation>
9110 </xs:attribute>
9111 <xs:attribute name="IncludeMaximum" type="YesNoTypeUnion">
9112 <xs:annotation>
9113 <xs:documentation>Set to "yes" to make the range of versions detected include the value specified in Maximum.</xs:documentation>
9114 </xs:annotation>
9115 </xs:attribute>
9116 <xs:attribute name="ExcludeLanguages" type="YesNoTypeUnion">
9117 <xs:annotation>
9118 <xs:documentation>Set to "yes" to detect all languages, excluding the languages listed in the Language attribute.</xs:documentation>
9119 </xs:annotation>
9120 </xs:attribute>
9121 <xs:anyAttribute namespace="##other" processContents="lax">
9122 <xs:annotation>
9123 <xs:documentation>
9124 Extensibility point in the WiX XML Schema. Schema extensions can register additional
9125 attributes at this point in the schema.
9126 </xs:documentation>
9127 </xs:annotation>
9128 </xs:anyAttribute>
9129 </xs:complexType>
9130 </xs:element>
9131 <xs:element name="Upgrade">
9132 <xs:annotation>
9133 <xs:documentation>
9134 Upgrade info for a particular UpgradeCode
9135 </xs:documentation>
9136 <xs:appinfo>
9137 <xse:msiRef table="Upgrade" href="https://learn.microsoft.com/en-us/windows/win32/msi/upgrade-table" />
9138 </xs:appinfo>
9139 </xs:annotation>
9140 <xs:complexType>
9141 <xs:choice minOccurs="0" maxOccurs="unbounded">
9142 <xs:element ref="UpgradeVersion" />
9143 <xs:element ref="Property">
9144 <xs:annotation>
9145 <xs:documentation>
9146 Nesting a Property element under an Upgrade element has been deprecated.
9147 Please nest Property elements in any of the other supported locations.
9148 </xs:documentation>
9149 </xs:annotation>
9150 </xs:element>
9151 </xs:choice>
9152 <xs:attribute name="Id" type="Guid" use="required">
9153 <xs:annotation>
9154 <xs:documentation>This value specifies the upgrade code for the products that are to be detected by the FindRelatedProducts action.</xs:documentation>
9155 </xs:annotation>
9156 </xs:attribute>
9157 </xs:complexType>
9158 </xs:element>
9159 <xs:element name="Feature">
9160 <xs:annotation>
9161 <xs:documentation>
9162 A feature for the Feature table. Features are the smallest installable unit. See msi.chm for more
9163 detailed information on the myriad installation options for a feature.
9164 </xs:documentation>
9165 <xs:appinfo>
9166 <xse:seeAlso ref="FeatureRef" />
9167 <xse:msiRef table="Feature" href="https://learn.microsoft.com/en-us/windows/win32/msi/feature-table" />
9168 <xse:howtoRef href="files_and_registry/add_a_file.html">How To: Add a file to your installer</xse:howtoRef>
9169 </xs:appinfo>
9170 </xs:annotation>
9171 <xs:complexType>
9172 <xs:choice minOccurs="0" maxOccurs="unbounded">
9173 <xs:element ref="Component" />
9174 <xs:element ref="ComponentGroupRef" />
9175 <xs:element ref="ComponentRef" />
9176 <xs:element ref="File" />
9177 <xs:element ref="Files" />
9178 <xs:element ref="Level" />
9179 <xs:element ref="Feature" />
9180 <xs:element ref="FeatureGroupRef" />
9181 <xs:element ref="FeatureRef" />
9182 <xs:element ref="MergeRef" />
9183 <xs:any namespace="##other" processContents="lax">
9184 <xs:annotation>
9185 <xs:documentation>
9186 Extensibility point in the WiX XML Schema. Schema extensions can register additional
9187 elements at this point in the schema.
9188 </xs:documentation>
9189 </xs:annotation>
9190 </xs:any>
9191 </xs:choice>
9192 <xs:attribute name="Id" type="xs:string" use="required">
9193 <xs:annotation>
9194 <xs:documentation>Unique identifier of the feature. The id must be shorter than 38 characters.</xs:documentation>
9195 </xs:annotation>
9196 </xs:attribute>
9197 <xs:attribute name="AllowAbsent" type="YesNoTypeUnion">
9198 <xs:annotation>
9199 <xs:documentation>
9200 This attribute determines if a user will have the option to set a feature to absent in the user interface.
9201 </xs:documentation>
9202 </xs:annotation>
9203 </xs:attribute>
9204 <xs:attribute name="AllowAdvertise" type="YesNoTypeUnion">
9205 <xs:annotation>
9206 <xs:documentation>
9207 This attribute determines the possible advertise states for this feature. The default is 'yes'.
9208 </xs:documentation>
9209 </xs:annotation>
9210 </xs:attribute>
9211 <xs:attribute name="ConfigurableDirectory" type="xs:string">
9212 <xs:annotation>
9213 <xs:documentation>
9214 Specify the Id of a Directory that can be configured by the user at installation time. This identifier
9215 must be a public property and therefore completely uppercase.
9216 </xs:documentation>
9217 </xs:annotation>
9218 </xs:attribute>
9219 <xs:attribute name="Description" type="xs:string">
9220 <xs:annotation>
9221 <xs:documentation>
9222 Longer string of text describing the feature. This localizable string is displayed by the
9223 Text Control of the Selection Dialog.
9224 </xs:documentation>
9225 </xs:annotation>
9226 </xs:attribute>
9227 <xs:attribute name="Display" type="xs:string">
9228 <xs:annotation>
9229 <xs:documentation>
9230 Determines the initial display of this feature in the feature tree.
9231 This attribute's value should be one of the following:
9232
9233 - `collapse`: Initially shows the feature collapsed. This is the default value.
9234 - `expand`: Initially shows the feature expanded.
9235 - `hidden`: Prevents the feature from displaying in the user interface.
9236 - an explicit integer value: For advanced users only, it is possible to directly set the integer value of the display value that will appear in the Feature row.
9237 </xs:documentation>
9238 </xs:annotation>
9239 </xs:attribute>
9240 <xs:attribute name="InstallDefault">
9241 <xs:annotation>
9242 <xs:documentation>
9243 This attribute determines the default install/run location of a feature. This attribute cannot be specified
9244 if the value of the FollowParent attribute is 'yes' since that would ask the installer to force this feature
9245 to follow the parent installation state and simultaneously favor a particular installation state just for this feature.
9246 </xs:documentation>
9247 </xs:annotation>
9248 <xs:simpleType>
9249 <xs:restriction base="xs:NMTOKEN">
9250 <xs:enumeration value="followParent">
9251 <xs:annotation>
9252 <xs:documentation>
9253 Forces the feature to follow the same installation state as its parent feature.
9254 </xs:documentation>
9255 </xs:annotation>
9256 </xs:enumeration>
9257 <xs:enumeration value="local">
9258 <xs:annotation>
9259 <xs:documentation>
9260 Favors installing this feature locally by setting the msidbFeatureAttributesFavorLocal attribute.
9261 </xs:documentation>
9262 </xs:annotation>
9263 </xs:enumeration>
9264 <xs:enumeration value="source">
9265 <xs:annotation>
9266 <xs:documentation>
9267 Favors running this feature from source by setting the msidbFeatureAttributesFavorSource attribute.
9268 </xs:documentation>
9269 </xs:annotation>
9270 </xs:enumeration>
9271 </xs:restriction>
9272 </xs:simpleType>
9273 </xs:attribute>
9274 <xs:attribute name="Level" type="Integer">
9275 <xs:annotation>
9276 <xs:documentation>
9277 Sets the install level of this feature. A value of 0 will disable the feature. This value
9278 can be modified at install time using the Level element as a child of the Feature.
9279 The default value is "1".
9280 </xs:documentation>
9281 </xs:annotation>
9282 </xs:attribute>
9283 <xs:attribute name="Title" type="xs:string">
9284 <xs:annotation>
9285 <xs:documentation>
9286 Short string of text identifying the feature. This string is listed as an item by the
9287 SelectionTree control of the Selection Dialog.
9288 </xs:documentation>
9289 </xs:annotation>
9290 </xs:attribute>
9291 <xs:attribute name="TypicalDefault">
9292 <xs:annotation>
9293 <xs:documentation>
9294 This attribute determines the default advertise state of the feature.
9295 </xs:documentation>
9296 </xs:annotation>
9297 <xs:simpleType>
9298 <xs:restriction base="xs:NMTOKEN">
9299 <xs:enumeration value="advertise">
9300 <xs:annotation>
9301 <xs:documentation>
9302 Sets the feature to be advertised by setting the msidbFeatureAttributesFavorAdvertise attribute.
9303 This value cannot be set if the value of the AllowAdvertise attribute is 'no' since that would ask the installer to
9304 disallow the advertised state for this feature while at the same time favoring it.
9305 </xs:documentation>
9306 </xs:annotation>
9307 </xs:enumeration>
9308 <xs:enumeration value="install">
9309 <xs:annotation>
9310 <xs:documentation>
9311 Sets the feature to the default non-advertised installation option.
9312 </xs:documentation>
9313 </xs:annotation>
9314 </xs:enumeration>
9315 </xs:restriction>
9316 </xs:simpleType>
9317 </xs:attribute>
9318 <xs:anyAttribute namespace="##other" processContents="lax">
9319 <xs:annotation>
9320 <xs:documentation>
9321 Extensibility point in the WiX XML Schema. Schema extensions can register additional
9322 attributes at this point in the schema.
9323 </xs:documentation>
9324 </xs:annotation>
9325 </xs:anyAttribute>
9326 </xs:complexType>
9327 </xs:element>
9328 <xs:element name="FeatureGroup">
9329 <xs:annotation>
9330 <xs:documentation>
9331 Groups together multiple components, features, and merges to be used in other locations.
9332 </xs:documentation>
9333 <xs:appinfo>
9334 <xse:seeAlso ref="FeatureGroupRef" />
9335 </xs:appinfo>
9336 </xs:annotation>
9337 <xs:complexType>
9338 <xs:choice minOccurs="0" maxOccurs="unbounded">
9339 <xs:element ref="Component" />
9340 <xs:element ref="ComponentGroupRef" />
9341 <xs:element ref="ComponentRef" />
9342 <xs:element ref="Feature" />
9343 <xs:element ref="FeatureGroupRef" />
9344 <xs:element ref="FeatureRef" />
9345 <xs:element ref="File" />
9346 <xs:element ref="Files" />
9347 <xs:element ref="MergeRef" />
9348 <xs:any namespace="##other" processContents="lax">
9349 <xs:annotation>
9350 <xs:documentation>
9351 Extensibility point in the WiX XML Schema. Schema extensions can register additional
9352 elements at this point in the schema.
9353 </xs:documentation>
9354 </xs:annotation>
9355 </xs:any>
9356 </xs:choice>
9357 <xs:attribute name="Id" type="xs:string" use="required">
9358 <xs:annotation>
9359 <xs:documentation>Identifier for the FeatureGroup.</xs:documentation>
9360 </xs:annotation>
9361 </xs:attribute>
9362 <xs:anyAttribute namespace="##other" processContents="lax">
9363 <xs:annotation>
9364 <xs:documentation>
9365 Extensibility point in the WiX XML Schema. Schema extensions can register additional
9366 attributes at this point in the schema.
9367 </xs:documentation>
9368 </xs:annotation>
9369 </xs:anyAttribute>
9370 </xs:complexType>
9371 </xs:element>
9372 <xs:element name="FeatureGroupRef">
9373 <xs:annotation>
9374 <xs:documentation>Create a reference to a FeatureGroup in another Fragment.</xs:documentation>
9375 <xs:appinfo>
9376 <xse:seeAlso ref="FeatureGroup" />
9377 </xs:appinfo>
9378 </xs:annotation>
9379 <xs:complexType>
9380 <xs:attribute name="Id" type="xs:string" use="required">
9381 <xs:annotation>
9382 <xs:documentation>The identifier of the FeatureGroup to reference.</xs:documentation>
9383 </xs:annotation>
9384 </xs:attribute>
9385 <xs:attribute name="IgnoreParent" type="YesNoTypeUnion">
9386 <xs:annotation>
9387 <xs:documentation>
9388 Normally feature group references that end up nested under a parent element create a
9389 connection to that parent. This behavior is undesirable when trying to simply reference
9390 to a FeatureGroup in a different Fragment. Specify 'yes' to have this feature group
9391 reference not create a connection to its parent. The default is 'no'.
9392 </xs:documentation>
9393 </xs:annotation>
9394 </xs:attribute>
9395 <xs:attribute name="Primary" type="YesNoTypeUnion">
9396 <xs:annotation>
9397 <xs:documentation>
9398 Set this attribute to 'yes' in order to make the parent feature of this group
9399 the primary feature for any components and merges contained in the group.
9400 Features may belong to multiple features. By designating a feature as the
9401 primary feature of a component or merge, you ensure that whenever a component is
9402 selected for install-on-demand (IOD), the primary feature will be the one to install
9403 it. This attribute should only be set if a component actually nests under multiple
9404 features. If a component nests under only one feature, that feature is the primary
9405 feature for the component. You cannot set more than one feature as the primary
9406 feature of a given component.
9407 </xs:documentation>
9408 </xs:annotation>
9409 </xs:attribute>
9410 <xs:anyAttribute namespace="##other" processContents="lax">
9411 <xs:annotation>
9412 <xs:documentation>
9413 Extensibility point in the WiX XML Schema. Schema extensions can register additional
9414 attributes at this point in the schema.
9415 </xs:documentation>
9416 </xs:annotation>
9417 </xs:anyAttribute>
9418 </xs:complexType>
9419 </xs:element>
9420 <xs:element name="FeatureRef">
9421 <xs:annotation>
9422 <xs:documentation>Create a reference to a Feature element in another Fragment.</xs:documentation>
9423 <xs:appinfo>
9424 <xse:seeAlso ref="Feature" />
9425 </xs:appinfo>
9426 </xs:annotation>
9427 <xs:complexType>
9428 <xs:choice minOccurs="0" maxOccurs="unbounded">
9429 <xs:element ref="Component" />
9430 <xs:element ref="ComponentGroupRef" />
9431 <xs:element ref="ComponentRef" />
9432 <xs:element ref="Feature" />
9433 <xs:element ref="FeatureRef" />
9434 <xs:element ref="FeatureGroup" />
9435 <xs:element ref="FeatureGroupRef" />
9436 <xs:element ref="File" />
9437 <xs:element ref="Files" />
9438 <xs:element ref="MergeRef" />
9439 <xs:any namespace="##other" processContents="lax">
9440 <xs:annotation>
9441 <xs:documentation>
9442 Extensibility point in the WiX XML Schema. Schema extensions can register additional
9443 elements at this point in the schema.
9444 </xs:documentation>
9445 </xs:annotation>
9446 </xs:any>
9447 </xs:choice>
9448 <xs:attribute name="Id" type="xs:string" use="required">
9449 <xs:annotation>
9450 <xs:documentation>The identifier of the Feature element to reference.</xs:documentation>
9451 </xs:annotation>
9452 </xs:attribute>
9453 <xs:attribute name="IgnoreParent" type="YesNoTypeUnion">
9454 <xs:annotation>
9455 <xs:documentation>
9456 Normally feature references that are nested under a parent element create a connection to that
9457 parent. This behavior is undesirable when trying to simply reference a Feature in a different
9458 Fragment. Specify 'yes' to have this feature reference not create a connection to its parent.
9459 The default is 'no'.
9460 </xs:documentation>
9461 </xs:annotation>
9462 </xs:attribute>
9463 <xs:anyAttribute namespace="##other" processContents="lax">
9464 <xs:annotation>
9465 <xs:documentation>
9466 Extensibility point in the WiX XML Schema. Schema extensions can register additional
9467 attributes at this point in the schema.
9468 </xs:documentation>
9469 </xs:annotation>
9470 </xs:anyAttribute>
9471 </xs:complexType>
9472 </xs:element>
9473 <xs:element name="Media">
9474 <xs:annotation>
9475 <xs:documentation>Media element describes a disk that makes up the source media for the installation.</xs:documentation>
9476 <xs:appinfo>
9477 <xse:msiRef table="Media" href="http://msdn.microsoft.com/library/aa369801.aspx" />
9478 </xs:appinfo>
9479 </xs:annotation>
9480 <xs:complexType>
9481 <xs:sequence>
9482 <xs:choice minOccurs="0" maxOccurs="unbounded">
9483 <xs:element ref="DigitalSignature" minOccurs="0" />
9484 <xs:element ref="PatchBaseline" minOccurs="0" maxOccurs="unbounded" />
9485 <xs:element ref="SymbolPath" />
9486 </xs:choice>
9487 </xs:sequence>
9488 <xs:attribute name="Id" type="DiskIdType" use="required">
9489 <xs:annotation>
9490 <xs:documentation>Disk identifier for Media table. This number must be equal to or greater than 1.</xs:documentation>
9491 </xs:annotation>
9492 </xs:attribute>
9493 <xs:attribute name="Cabinet" type="xs:string">
9494 <xs:annotation>
9495 <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>
9496 </xs:annotation>
9497 </xs:attribute>
9498 <xs:attribute name="CompressionLevel" type="CompressionLevelTypeUnion">
9499 <xs:annotation>
9500 <xs:documentation>
9501 Indicates the compression level for the Media's cabinet. This attribute can
9502 only be used in conjunction with the Cabinet attribute. The default is 'medium'.
9503 </xs:documentation>
9504 </xs:annotation>
9505 </xs:attribute>
9506 <xs:attribute name="DiskPrompt" type="xs:string">
9507 <xs:annotation>
9508 <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>
9509 </xs:annotation>
9510 </xs:attribute>
9511 <xs:attribute name="EmbedCab" type="YesNoTypeUnion">
9512 <xs:annotation>
9513 <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>
9514 </xs:annotation>
9515 </xs:attribute>
9516 <xs:attribute name="Layout" type="xs:string">
9517 <xs:annotation>
9518 <xs:documentation>
9519 This attribute specifies the root directory for the uncompressed files that
9520 are a part of this Media element. By default, the src will be the output
9521 directory for the final image. The default value ensures the binder generates
9522 an installable image. If a relative path is specified in the src attribute,
9523 the value will be appended to the image's output directory. If an absolute
9524 path is provided, that path will be used without modification. The latter two
9525 options are provided to ease the layout of an image onto multiple medias (CDs/DVDs).
9526 </xs:documentation>
9527 </xs:annotation>
9528 </xs:attribute>
9529 <xs:attribute name="VolumeLabel" type="xs:string">
9530 <xs:annotation>
9531 <xs:documentation>
9532 The label attributed to the volume. This is the volume label returned
9533 by the GetVolumeInformation function. If the SourceDir property refers
9534 to a removable (floppy or CD-ROM) volume, then this volume label is
9535 used to verify that the proper disk is in the drive before attempting
9536 to install files. The entry in this column must match the volume label
9537 of the physical media.
9538 </xs:documentation>
9539 </xs:annotation>
9540 </xs:attribute>
9541 <xs:attribute name="Source" type="xs:string">
9542 <xs:annotation>
9543 <xs:documentation>
9544 Optional property that identifies the source of the embedded cabinet.
9545 If a cabinet is specified for a patch, this property should be defined
9546 and unique to each patch so that the embedded cabinet containing patched
9547 and new files can be located in the patch package. If the cabinet is not
9548 embedded - this is not typical - the cabinet can be found in the directory
9549 referenced in this column. If empty, the external cabinet must be located
9550 in the SourceDir directory.
9551 </xs:documentation>
9552 </xs:annotation>
9553 </xs:attribute>
9554 </xs:complexType>
9555 </xs:element>
9556 <xs:element name="MediaTemplate">
9557 <xs:annotation>
9558 <xs:documentation>
9559 MediaTeplate element describes information to automatically assign files to cabinets.
9560 A maximumum number of cabinets created is 999.
9561 </xs:documentation>
9562 </xs:annotation>
9563 <xs:complexType>
9564 <xs:attribute name="CabinetTemplate" type="xs:string">
9565 <xs:annotation>
9566 <xs:documentation>
9567 Templated name of the cabinet if some or all of the files stored on the media are in
9568 a cabinet file. This name must begin with either a letter or an underscore, contain
9569 maximum of five characters and {0} in the cabinet name part and must end three character extension.
9570 The default is cab{0}.cab.
9571 </xs:documentation>
9572 </xs:annotation>
9573 </xs:attribute>
9574 <xs:attribute name="CompressionLevel" type="CompressionLevelTypeUnion">
9575 <xs:annotation>
9576 <xs:documentation>
9577 Indicates the compression level for the Media's cabinet. This attribute can
9578 only be used in conjunction with the Cabinet attribute. The default is 'medium'.
9579 </xs:documentation>
9580 </xs:annotation>
9581 </xs:attribute>
9582 <xs:attribute name="DiskPrompt" type="xs:string">
9583 <xs:annotation>
9584 <xs:documentation>
9585 The disk name, which is usually the visible text printed on the disk. This localizable text is used
9586 to prompt the user when this disk needs to be inserted. This value will be used in the "[1]" of the
9587 DiskPrompt Property. Using this attribute will require you to define a DiskPrompt Property.
9588 </xs:documentation>
9589 </xs:annotation>
9590 </xs:attribute>
9591 <xs:attribute name="EmbedCab" type="YesNoTypeUnion">
9592 <xs:annotation>
9593 <xs:documentation>Instructs the binder to embed the cabinets in the product if 'yes'.</xs:documentation>
9594 </xs:annotation>
9595 </xs:attribute>
9596 <xs:attribute name="VolumeLabel" type="xs:string">
9597 <xs:annotation>
9598 <xs:documentation>
9599 The label attributed to the volume. This is the volume label returned
9600 by the GetVolumeInformation function. If the SourceDir property refers
9601 to a removable (floppy or CD-ROM) volume, then this volume label is
9602 used to verify that the proper disk is in the drive before attempting
9603 to install files. The entry in this column must match the volume label
9604 of the physical media.
9605 </xs:documentation>
9606 </xs:annotation>
9607 </xs:attribute>
9608 <xs:attribute name="MaximumUncompressedMediaSize" type="xs:int">
9609 <xs:annotation>
9610 <xs:documentation>
9611 Size of uncompressed files in each cabinet, in megabytes. WIX_MUMS environment variable
9612 can be used to override this value. Default value is 200 MB.
9613 </xs:documentation>
9614 </xs:annotation>
9615 </xs:attribute>
9616 <xs:attribute name="MaximumCabinetSizeForLargeFileSplitting" type="xs:int">
9617 <xs:annotation>
9618 <xs:documentation>
9619 Maximum size of cabinet files in megabytes for large files. This attribute is used for packaging
9620 files that are larger than MaximumUncompressedMediaSize into smaller cabinets. If cabinet size
9621 exceed this value, then setting this attribute will cause the file to be split into multiple
9622 cabinets of this maximum size. For simply controlling cabinet size without file splitting use
9623 MaximumUncompressedMediaSize attribute. Setting this attribute will disable smart cabbing feature
9624 for this Fragment / Package. Setting WIX_MCSLFS environment variable can be used to override this
9625 value. Minimum allowed value of this attribute is 20 MB. Maximum allowed value and the Default
9626 value of this attribute is 2048 MB (2 GB).
9627 </xs:documentation>
9628 </xs:annotation>
9629 </xs:attribute>
9630 </xs:complexType>
9631 </xs:element>
9632 <xs:element name="CustomAction">
9633 <xs:annotation>
9634 <xs:appinfo>
9635 <xse:seeAlso ref="Custom" />
9636 <xse:seeAlso ref="CustomActionRef" />
9637 <xse:msiRef table="CustomAction" href="https://learn.microsoft.com/en-us/windows/win32/msi/customaction-table" />
9638 </xs:appinfo>
9639 <xs:documentation>
9640 Specifies a custom action to be added to the MSI CustomAction table. Various combinations of the attributes for this element
9641 correspond to different custom action types. For more information about custom actions see the
9642 <html:a href="https://learn.microsoft.com/en-us/windows/win32/msi/summary-list-of-all-custom-action-types">
9643 Custom Action Types</html:a> topic on MSDN.
9644 </xs:documentation>
9645 </xs:annotation>
9646 <xs:complexType>
9647 <xs:attribute name="Id" type="xs:string" use="required">
9648 <xs:annotation>
9649 <xs:documentation>
9650 The identifier of the custom action.
9651 </xs:documentation>
9652 </xs:annotation>
9653 </xs:attribute>
9654 <!-- CustomAction Source specification, sets source Attribute bits -->
9655 <xs:attribute name="BinaryRef" type="xs:string">
9656 <xs:annotation>
9657 <xs:documentation>
9658 This attribute is a reference to a Binary element with matching Id attribute. That binary stream contains
9659 the custom action for use during install. The custom action will not be installed into a target directory. This attribute is
9660 typically used with the DllEntry attribute to specify the custom action DLL to use for a type 1 custom action, with the ExeCommand
9661 attribute to specify a type 17 custom action that runs an embedded executable, or with the VBScriptCall or JScriptCall attributes
9662 to specify a type 5 or 6 custom action.
9663 </xs:documentation>
9664 </xs:annotation>
9665 </xs:attribute>
9666 <xs:attribute name="FileRef" type="xs:string">
9667 <xs:annotation>
9668 <xs:documentation>
9669 This attribute specifies a reference to a File element with matching Id attribute that
9670 will execute the custom action code in the file after the file is installed. This
9671 attribute is typically used with the ExeCommand attribute to specify a type 18 custom action
9672 that runs an installed executable, with the DllEntry attribute to specify an installed custom
9673 action DLL to use for a type 17 custom action, or with the VBScriptCall or JScriptCall
9674 attributes to specify a type 21 or 22 custom action.
9675 </xs:documentation>
9676 </xs:annotation>
9677 </xs:attribute>
9678 <xs:attribute name="Property" type="xs:string">
9679 <xs:annotation>
9680 <xs:documentation>
9681 This attribute specifies a reference to a Property element with matching Id attribute that specifies the Property
9682 to be used or updated on execution of this custom action. This attribute is
9683 typically used with the Value attribute to create a type 51 custom action that parses
9684 the text in Value and places it into the specified Property. This attribute is also used with
9685 the ExeCommand attribute to create a type 50 custom action that uses the value of the
9686 given property to specify the path to the executable. Type 51 custom actions are often useful to
9687 pass values to a deferred custom action.
9688 See <html:a href="https://learn.microsoft.com/en-us/windows/win32/msi/obtaining-context-information-for-deferred-execution-custom-actions">
9689 Obtaining Context Information for Deferred Execution Custom Actions</html:a> for more information.
9690 </xs:documentation>
9691 </xs:annotation>
9692 </xs:attribute>
9693 <xs:attribute name="Directory" type="xs:string">
9694 <xs:annotation>
9695 <xs:documentation>
9696 This attribute specifies a reference to a Directory element with matching Id attribute containing a directory path.
9697 This attribute is typically used with the ExeCommand attribute to specify the source executable for a type 34
9698 custom action, or with the Value attribute to specify a formatted string to place in the specified Directory
9699 table entry in a type 35 custom action.
9700 </xs:documentation>
9701 </xs:annotation>
9702 </xs:attribute>
9703 <xs:attribute name="Subdirectory" type="xs:string">
9704 <xs:annotation>
9705 <xs:documentation>
9706 This attribute defines one or more directories below the directory referenced by the Directory attribute.
9707 This attribute is optional but can only be specified when the Directory attribute is also specified.
9708 </xs:documentation>
9709 </xs:annotation>
9710 </xs:attribute>
9711 <!-- CustomAction Target specification, sets target Attribute bits -->
9712 <xs:attribute name="DllEntry" type="xs:string">
9713 <xs:annotation>
9714 <xs:documentation>
9715 This attribute specifies the name of a function in a custom action to execute.
9716 This attribute is used with the BinaryRef attribute to create a type 1 custom
9717 action, or with the FileRef attribute to create a type 17 custom action.
9718 </xs:documentation>
9719 </xs:annotation>
9720 </xs:attribute>
9721 <xs:attribute name="ExeCommand" type="xs:string">
9722 <xs:annotation>
9723 <xs:documentation>
9724 This attribute specifies the command line parameters to supply to an externally
9725 run executable. This attribute is typically used with the BinaryRef attribute for a type 2 custom action,
9726 the FileRef attribute for a type 18 custom action, the Property attribute for a type 50 custom action,
9727 or the Directory attribute for a type 34 custom action that specify the executable to run.
9728 </xs:documentation>
9729 </xs:annotation>
9730 </xs:attribute>
9731 <xs:attribute name="JScriptCall" type="xs:string">
9732 <xs:annotation>
9733 <xs:documentation>
9734 This attribute specifies the name of the JScript function to execute in a script. The script must be
9735 provided in a Binary element identified by the BinaryRef attribute described above. In other words, this
9736 attribute must be specified in conjunction with the BinaryRef attribute.
9737 </xs:documentation>
9738 </xs:annotation>
9739 </xs:attribute>
9740 <xs:attribute name="VBScriptCall" type="xs:string">
9741 <xs:annotation>
9742 <xs:documentation>
9743 This attribute specifies the name of the VBScript Subroutine to execute in a script. The script must be
9744 provided in a Binary element identified by the BinaryRef attribute described above. In other words, this
9745 attribute must be specified in conjunction with the BinaryRef attribute.
9746 </xs:documentation>
9747 </xs:annotation>
9748 </xs:attribute>
9749 <xs:attribute name="Script">
9750 <xs:annotation>
9751 <xs:documentation>
9752 Creates a type 37 or 38 custom action. Specify a path to the script to be embedded in the package in the
9753 `ScriptSourceFile` attribute.
9754 </xs:documentation>
9755 </xs:annotation>
9756 <xs:simpleType>
9757 <xs:restriction base="xs:NMTOKEN">
9758 <xs:enumeration value="jscript" />
9759 <xs:enumeration value="vbscript" />
9760 </xs:restriction>
9761 </xs:simpleType>
9762 </xs:attribute>
9763 <xs:attribute name="ScriptSourceFile" type="xs:string">
9764 <xs:annotation>
9765 <xs:documentation>
9766 Path to the external file containing the script code. Can be used only with the Script attribute.
9767 </xs:documentation>
9768 </xs:annotation>
9769 </xs:attribute>
9770 <xs:attribute name="SuppressModularization" type="YesNoTypeUnion">
9771 <xs:annotation>
9772 <xs:documentation>
9773 Use to suppress modularization of this custom action name in merge modules.
9774 This should only be necessary for table-driven custom actions because the
9775 table name which they interact with cannot be modularized, so there can only
9776 be one instance of the table.
9777 </xs:documentation>
9778 </xs:annotation>
9779 </xs:attribute>
9780 <xs:attribute name="Value" type="xs:string">
9781 <xs:annotation>
9782 <xs:documentation>
9783 This attribute specifies a string value to use in the custom action. This attribute
9784 must be used with the Property attribute to set the property as part of a
9785 type 51 custom action or with the Directory attribute to set a directory path in that
9786 table in a type 35 custom action. The value can be a literal value or derived from a
9787 Property element using the <html:a href="https://learn.microsoft.com/en-us/windows/win32/msi/formatted">Formatted</html:a>
9788 syntax.
9789 </xs:documentation>
9790 </xs:annotation>
9791 </xs:attribute>
9792 <xs:attribute name="Error" type="xs:string">
9793 <xs:annotation>
9794 <xs:documentation>
9795 This attribute specifies an index in the MSI Error table to use as an error message for a
9796 type 19 custom action that displays the error message and aborts a product's installation.
9797 </xs:documentation>
9798 </xs:annotation>
9799 </xs:attribute>
9800 <!-- Other CustomAction type attributes -->
9801 <xs:attribute name="Return">
9802 <xs:annotation>
9803 <xs:documentation>
9804 Set this attribute to set the return behavior of the custom action.
9805 </xs:documentation>
9806 </xs:annotation>
9807 <xs:simpleType>
9808 <xs:restriction base="xs:NMTOKEN">
9809 <xs:enumeration value="asyncNoWait">
9810 <xs:annotation>
9811 <xs:documentation>
9812 Indicates that the custom action will run asyncronously and execution may continue after the installer terminates.
9813 </xs:documentation>
9814 </xs:annotation>
9815 </xs:enumeration>
9816 <xs:enumeration value="asyncWait">
9817 <xs:annotation>
9818 <xs:documentation>
9819 Indicates that the custom action will run asynchronously but the installer will wait for the return code at sequence end.
9820 </xs:documentation>
9821 </xs:annotation>
9822 </xs:enumeration>
9823 <xs:enumeration value="check">
9824 <xs:annotation>
9825 <xs:documentation>
9826 Indicates that the custom action will run synchronously and the return code will be checked for success. This is the default.
9827 </xs:documentation>
9828 </xs:annotation>
9829 </xs:enumeration>
9830 <xs:enumeration value="ignore">
9831 <xs:annotation>
9832 <xs:documentation>
9833 Indicates that the custom action will run synchronously and the return code will not be checked.
9834 </xs:documentation>
9835 </xs:annotation>
9836 </xs:enumeration>
9837 </xs:restriction>
9838 </xs:simpleType>
9839 </xs:attribute>
9840 <xs:attribute name="Execute">
9841 <xs:annotation>
9842 <xs:documentation>
9843 This attribute indicates the scheduling of the custom action.
9844 </xs:documentation>
9845 </xs:annotation>
9846 <xs:simpleType>
9847 <xs:restriction base="xs:NMTOKEN">
9848 <xs:enumeration value="commit">
9849 <xs:annotation>
9850 <xs:documentation>
9851 Indicates that the custom action will run after successful completion of the installation script (at the end of the installation).
9852 </xs:documentation>
9853 </xs:annotation>
9854 </xs:enumeration>
9855 <xs:enumeration value="deferred">
9856 <xs:annotation>
9857 <xs:documentation>
9858 Indicates that the custom action runs in-script (possibly with elevated privileges).
9859 </xs:documentation>
9860 </xs:annotation>
9861 </xs:enumeration>
9862 <xs:enumeration value="firstSequence">
9863 <xs:annotation>
9864 <xs:documentation>
9865 Indicates that the custom action will only run in the first sequence that runs it.
9866 </xs:documentation>
9867 </xs:annotation>
9868 </xs:enumeration>
9869 <xs:enumeration value="immediate">
9870 <xs:annotation>
9871 <xs:documentation>
9872 Indicates that the custom action will run during normal processing time with user privileges. This is the default.
9873 </xs:documentation>
9874 </xs:annotation>
9875 </xs:enumeration>
9876 <xs:enumeration value="oncePerProcess">
9877 <xs:annotation>
9878 <xs:documentation>
9879 Indicates that the custom action will only run in the first sequence that runs it in the same process.
9880 </xs:documentation>
9881 </xs:annotation>
9882 </xs:enumeration>
9883 <xs:enumeration value="rollback">
9884 <xs:annotation>
9885 <xs:documentation>
9886 Indicates that a custom action will run in the rollback sequence when a failure
9887 occurs during installation, usually to undo changes made by a deferred custom action.
9888 </xs:documentation>
9889 </xs:annotation>
9890 </xs:enumeration>
9891 <xs:enumeration value="secondSequence">
9892 <xs:annotation>
9893 <xs:documentation>
9894 Indicates that a custom action should be run a second time if it was previously run in an earlier sequence.
9895 </xs:documentation>
9896 </xs:annotation>
9897 </xs:enumeration>
9898 </xs:restriction>
9899 </xs:simpleType>
9900 </xs:attribute>
9901 <xs:attribute name="Impersonate" type="YesNoTypeUnion">
9902 <xs:annotation>
9903 <xs:documentation>
9904 This attribute specifies whether the Windows Installer, which executes as LocalSystem,
9905 should impersonate the user context of the installing user when executing this custom action.
9906 Typically the value should be 'yes', except when the custom action needs elevated privileges
9907 to apply changes to the machine.
9908 </xs:documentation>
9909 </xs:annotation>
9910 </xs:attribute>
9911 <xs:attribute name="PatchUninstall" type="YesNoTypeUnion">
9912 <xs:annotation>
9913 <xs:documentation>
9914 This attribute specifies that the Windows Installer, execute the custom action only when
9915 a patch is being uninstalled. These custom actions should also be conditioned using the
9916 MSIPATCHREMOVE property to ensure proper down level (less than Windows Installer 4.5)
9917 behavior.
9918 </xs:documentation>
9919 </xs:annotation>
9920 </xs:attribute>
9921 <xs:attribute name="Bitness" type="BitnessTypeUnion">
9922 <xs:annotation>
9923 <xs:documentation>
9924 Valid only when used with the Script, VBScriptCall, and JScriptCall attributes.
9925 Overrides the default scripting host for script custom actions. The value `always64` will force the
9926 script to run in the 64-bit scripting host. Simliarly, the value `always32` will force the script
9927 to run in the 64-bit scripting host.
9928 The default value is `default` where the script will be run in the scripting host that matches the
9929 same bitness as the package.
9930 </xs:documentation>
9931 </xs:annotation>
9932 </xs:attribute>
9933 <xs:attribute name="TerminalServerAware" type="YesNoTypeUnion">
9934 <xs:annotation>
9935 <xs:documentation>
9936 This attribute specifies controls whether the custom action will impersonate the
9937 installing user during per-machine installs on Terminal Server machines.
9938 Deferred execution custom actions that do not specify this attribute, or explicitly set it 'no',
9939 will run with no user impersonation on Terminal Server machines during
9940 per-machine installations. This attribute is only applicable when installing on the
9941 Windows Server 2003 family.
9942 </xs:documentation>
9943 </xs:annotation>
9944 </xs:attribute>
9945 <xs:attribute name="HideTarget" type="YesNoTypeUnion">
9946 <xs:annotation>
9947 <xs:documentation>Ensures the installer does not log the CustomActionData for the deferred custom action.</xs:documentation>
9948 </xs:annotation>
9949 </xs:attribute>
9950 <xs:anyAttribute namespace="##other" processContents="lax">
9951 <xs:annotation>
9952 <xs:documentation>
9953 Extensibility point in the WiX XML Schema. Schema extensions can register additional
9954 attributes at this point in the schema.
9955 </xs:documentation>
9956 </xs:annotation>
9957 </xs:anyAttribute>
9958 </xs:complexType>
9959 </xs:element>
9960 <xs:element name="CustomActionRef">
9961 <xs:annotation>
9962 <xs:appinfo>
9963 <xse:seeAlso ref="CustomAction" />
9964 </xs:appinfo>
9965 <xs:documentation>
9966 This will cause the entire contents of the Fragment containing the referenced CustomAction to be
9967 included in the installer database.
9968 </xs:documentation>
9969 </xs:annotation>
9970 <xs:complexType>
9971 <xs:attribute name="Id" type="xs:string" use="required">
9972 <xs:annotation>
9973 <xs:documentation>The identifier of the CustomAction to reference.</xs:documentation>
9974 </xs:annotation>
9975 </xs:attribute>
9976 <xs:anyAttribute namespace="##other" processContents="lax">
9977 <xs:annotation>
9978 <xs:documentation>
9979 Extensibility point in the WiX XML Schema. Schema extensions can register additional
9980 attributes at this point in the schema.
9981 </xs:documentation>
9982 </xs:annotation>
9983 </xs:anyAttribute>
9984 </xs:complexType>
9985 </xs:element>
9986 <xs:element name="SetDirectory">
9987 <xs:annotation>
9988 <xs:appinfo>
9989 <xse:seeAlso ref="Custom" />
9990 <xse:seeAlso ref="CustomActionRef" />
9991 <xse:seeAlso ref="InstallUISequence" />
9992 <xse:seeAlso ref="InstallExecuteSequence" />
9993 <xse:msiRef table="CustomAction" href="https://learn.microsoft.com/en-us/windows/win32/msi/customaction-table" />
9994 </xs:appinfo>
9995 <xs:documentation>
9996 Sets a Directory to a particular value. This is accomplished by creating a Type 51 custom action that is appropriately scheduled in
9997 the InstallUISequence and InstallExecuteSequence.
9998 </xs:documentation>
9999 </xs:annotation>
10000 <xs:complexType>
10001 <xs:attribute name="Action" type="xs:string">
10002 <xs:annotation>
10003 <xs:documentation>
10004 By default the action is "Set" + Id attribute's value. This optional attribute can override the action name in the case
10005 where multiple SetDirectory elements target the same Id (probably with mutually exclusive conditions).
10006 </xs:documentation>
10007 </xs:annotation>
10008 </xs:attribute>
10009 <xs:attribute name="Condition" type="xs:string">
10010 <xs:annotation>
10011 <xs:documentation>
10012 The condition that determines whether the Directory is set. If the condition evaluates to false, the SetDirectory is skipped.
10013 </xs:documentation>
10014 </xs:annotation>
10015 </xs:attribute>
10016 <xs:attribute name="Id" type="xs:string">
10017 <xs:annotation>
10018 <xs:documentation>
10019 This attribute specifies a reference to a Directory element with matching Id attribute. The path of the Directory will be set to
10020 the Value attribute.
10021 </xs:documentation>
10022 </xs:annotation>
10023 </xs:attribute>
10024 <xs:attribute name="Sequence" type="SequenceType">
10025 <xs:annotation>
10026 <xs:documentation>
10027 Controls which sequences the Directory assignment is sequenced in.
10028 For 'execute', the assignment is scheduled in the InstallExecuteSequence.
10029 For 'ui', the assignment is scheduled in the InstallUISequence.
10030 For 'first', the assignment is scheduled in the InstallUISequence or the InstallExecuteSequence if the InstallUISequence is skipped at install time.
10031 For 'both', the assignment is scheduled in both the InstallUISequence and the InstallExecuteSequence.
10032 The default is 'both'.
10033 </xs:documentation>
10034 </xs:annotation>
10035 </xs:attribute>
10036 <xs:attribute name="Value" type="xs:string">
10037 <xs:annotation>
10038 <xs:documentation>
10039 This attribute specifies a string value to assign to the Directory. The value can be a literal value or derived from a
10040 Property element using the <html:a href="https://learn.microsoft.com/en-us/windows/win32/msi/formatted">Formatted</html:a>
10041 syntax.
10042 </xs:documentation>
10043 </xs:annotation>
10044 </xs:attribute>
10045 <xs:anyAttribute namespace="##other" processContents="lax">
10046 <xs:annotation>
10047 <xs:documentation>
10048 Extensibility point in the WiX XML Schema. Schema extensions can register additional
10049 attributes at this point in the schema.
10050 </xs:documentation>
10051 </xs:annotation>
10052 </xs:anyAttribute>
10053 </xs:complexType>
10054 </xs:element>
10055 <xs:element name="SetProperty">
10056 <xs:annotation>
10057 <xs:appinfo>
10058 <xse:seeAlso ref="Custom" />
10059 <xse:seeAlso ref="CustomActionRef" />
10060 <xse:seeAlso ref="InstallUISequence" />
10061 <xse:seeAlso ref="InstallExecuteSequence" />
10062 <xse:msiRef table="CustomAction" href="https://learn.microsoft.com/en-us/windows/win32/msi/customaction-table" />
10063 </xs:appinfo>
10064 <xs:documentation>
10065 Sets a Property to a particular value. This is accomplished by creating a Type 51 custom action that is appropriately scheduled in
10066 the InstallUISequence and InstallExecuteSequence.
10067 </xs:documentation>
10068 </xs:annotation>
10069 <xs:complexType>
10070 <xs:attribute name="Action" type="xs:string">
10071 <xs:annotation>
10072 <xs:documentation>
10073 By default the action is "Set" + Id attribute's value. This optional attribute can override the action name in the case
10074 where multiple SetProperty elements target the same Id (probably with mutually exclusive conditions).
10075 </xs:documentation>
10076 </xs:annotation>
10077 </xs:attribute>
10078 <xs:attribute name="After" type="xs:string">
10079 <xs:annotation>
10080 <xs:documentation>
10081 The name of the standard or custom action after which this action should be performed. Mutually exclusive with
10082 the Before attribute. A Before or After attribute is required when setting a Property.
10083 </xs:documentation>
10084 </xs:annotation>
10085 </xs:attribute>
10086 <xs:attribute name="Before" type="xs:string">
10087 <xs:annotation>
10088 <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>
10089 </xs:annotation>
10090 </xs:attribute>
10091 <xs:attribute name="Condition" type="xs:string">
10092 <xs:annotation>
10093 <xs:documentation>
10094 The condition that determines whether the Property is set. If the condition evaluates to false, the Set is skipped.
10095 </xs:documentation>
10096 </xs:annotation>
10097 </xs:attribute>
10098 <xs:attribute name="Id" type="xs:string">
10099 <xs:annotation>
10100 <xs:documentation>
10101 This attribute specifies the Property to set to the Value.
10102 </xs:documentation>
10103 </xs:annotation>
10104 </xs:attribute>
10105 <xs:attribute name="Sequence" type="SequenceType">
10106 <xs:annotation>
10107 <xs:documentation>
10108 Controls which sequences the Property assignment is sequenced in.
10109 For 'execute', the assignment is scheduled in the InstallExecuteSequence.
10110 For 'ui', the assignment is scheduled in the InstallUISequence.
10111 For 'first', the assignment is scheduled in the InstallUISequence or the InstallExecuteSequence if the InstallUISequence is skipped at install time.
10112 For 'both', the assignment is scheduled in both the InstallUISequence and the InstallExecuteSequence.
10113 The default is 'both'.
10114 </xs:documentation>
10115 </xs:annotation>
10116 </xs:attribute>
10117 <xs:attribute name="Value" type="xs:string">
10118 <xs:annotation>
10119 <xs:documentation>
10120 This attribute specifies a string value to assign to the Property. The value can be a literal value or derived from a
10121 Property element using the <html:a href="https://learn.microsoft.com/en-us/windows/win32/msi/formatted">Formatted</html:a>
10122 syntax.
10123 </xs:documentation>
10124 </xs:annotation>
10125 </xs:attribute>
10126 <xs:anyAttribute namespace="##other" processContents="lax">
10127 <xs:annotation>
10128 <xs:documentation>
10129 Extensibility point in the WiX XML Schema. Schema extensions can register additional
10130 attributes at this point in the schema.
10131 </xs:documentation>
10132 </xs:annotation>
10133 </xs:anyAttribute>
10134 </xs:complexType>
10135 </xs:element>
10136 <xs:element name="PatchFamilyRef">
10137 <xs:annotation>
10138 <xs:appinfo>
10139 <xse:seeAlso ref="PatchFamily" />
10140 </xs:appinfo>
10141 <xs:documentation>
10142 This will cause the entire contents of the Fragment containing the referenced PatchFamily to be
10143 used in the process of creating a patch.
10144 </xs:documentation>
10145 </xs:annotation>
10146 <xs:complexType>
10147 <xs:attribute name="Id" type="xs:string" use="required">
10148 <xs:annotation>
10149 <xs:documentation>The identifier of the PatchFamily to reference.</xs:documentation>
10150 </xs:annotation>
10151 </xs:attribute>
10152 <xs:attribute name="ProductCode" type="Guid">
10153 <xs:annotation>
10154 <xs:documentation>Specifies the ProductCode of the product that this family applies to.</xs:documentation>
10155 </xs:annotation>
10156 </xs:attribute>
10157 <xs:anyAttribute namespace="##other" processContents="lax">
10158 <xs:annotation>
10159 <xs:documentation>
10160 Extensibility point in the WiX XML Schema. Schema extensions can register additional
10161 attributes at this point in the schema.
10162 </xs:documentation>
10163 </xs:annotation>
10164 </xs:anyAttribute>
10165 </xs:complexType>
10166 </xs:element>
10167 <!-- - - - - - - - - - - Sequence Table Definitions - - - - - - - - - - - - - - -->
10168 <xs:element name="ValidateProductID" type="ActionSequenceType">
10169 <xs:annotation>
10170 <xs:appinfo>
10171 <xse:msiRef action="ValidateProductID" href="http://msdn.microsoft.com/library/aa372475.aspx" />
10172 </xs:appinfo>
10173 <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>
10174 </xs:annotation>
10175 </xs:element>
10176 <xs:element name="CostInitialize" type="ActionSequenceType">
10177 <xs:annotation>
10178 <xs:appinfo>
10179 <xse:seeAlso ref="FileCost" />
10180 <xse:seeAlso ref="CostFinalize" />
10181 <xse:msiRef action="CostInitialize" href="http://msdn.microsoft.com/library/aa368048.aspx" />
10182 </xs:appinfo>
10183 <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>
10184 </xs:annotation>
10185 </xs:element>
10186 <xs:element name="FileCost" type="ActionSequenceType">
10187 <xs:annotation>
10188 <xs:appinfo>
10189 <xse:seeAlso ref="CostInitialize" />
10190 <xse:seeAlso ref="CostFinalize" />
10191 <xse:msiRef action="FileCost" href="http://msdn.microsoft.com/library/aa368589.aspx" />
10192 </xs:appinfo>
10193 <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>
10194 </xs:annotation>
10195 </xs:element>
10196 <xs:element name="IsolateComponents" type="ActionSequenceType">
10197 <xs:annotation>
10198 <xs:appinfo>
10199 <xse:seeAlso ref="IsolateComponent" />
10200 <xse:msiRef action="IsolateComponents" href="http://msdn.microsoft.com/library/aa369561.aspx" />
10201 </xs:appinfo>
10202 <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>
10203 </xs:annotation>
10204 </xs:element>
10205 <xs:element name="CostFinalize" type="ActionSequenceType">
10206 <xs:annotation>
10207 <xs:appinfo>
10208 <xse:seeAlso ref="CostInitialize" />
10209 <xse:seeAlso ref="FileCost" />
10210 <xse:msiRef action="CostFinalize" href="http://msdn.microsoft.com/library/aa368048.aspx" />
10211 </xs:appinfo>
10212 <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>
10213 </xs:annotation>
10214 </xs:element>
10215 <xs:element name="SetODBCFolders" type="ActionSequenceType">
10216 <xs:annotation>
10217 <xs:appinfo>
10218 <xse:msiRef action="SetODBCFolders" href="http://msdn.microsoft.com/library/aa371691.aspx" />
10219 </xs:appinfo>
10220 <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>
10221 </xs:annotation>
10222 </xs:element>
10223 <xs:element name="MigrateFeatureStates" type="ActionSequenceType">
10224 <xs:annotation>
10225 <xs:appinfo>
10226 <xse:msiRef action="MigrateFeatureStates" href="http://msdn.microsoft.com/library/aa370034.aspx" />
10227 </xs:appinfo>
10228 <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>
10229 </xs:annotation>
10230 </xs:element>
10231 <xs:element name="ExecuteAction" type="ActionSequenceType">
10232 <xs:annotation>
10233 <xs:appinfo>
10234 <xse:msiRef action="ExecuteAction" href="http://msdn.microsoft.com/library/aa368565.aspx" />
10235 </xs:appinfo>
10236 <xs:documentation>Initiates the execution sequence. The condition for this action may be specified in the element's inner text.</xs:documentation>
10237 </xs:annotation>
10238 </xs:element>
10239 <xs:element name="InstallValidate" type="ActionSequenceType">
10240 <xs:annotation>
10241 <xs:appinfo>
10242 <xse:msiRef action="InstallValidate" href="http://msdn.microsoft.com/library/aa369546.aspx" />
10243 </xs:appinfo>
10244 <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>
10245 </xs:annotation>
10246 </xs:element>
10247 <xs:element name="InstallInitialize" type="ActionSequenceType">
10248 <xs:annotation>
10249 <xs:appinfo>
10250 <xse:seeAlso ref="InstallFinalize" />
10251 <xse:msiRef action="InstallInitialize" href="http://msdn.microsoft.com/library/aa369535.aspx" />
10252 </xs:appinfo>
10253 <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>
10254 </xs:annotation>
10255 </xs:element>
10256 <xs:element name="AllocateRegistrySpace" type="ActionSequenceType">
10257 <xs:annotation>
10258 <xs:appinfo>
10259 <xse:msiRef action="AllocateRegistrySpace" href="http://msdn.microsoft.com/library/aa367554.aspx" />
10260 </xs:appinfo>
10261 <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>
10262 </xs:annotation>
10263 </xs:element>
10264 <xs:element name="ProcessComponents" type="ActionSequenceType">
10265 <xs:annotation>
10266 <xs:appinfo>
10267 <xse:msiRef action="ProcessComponents" href="http://msdn.microsoft.com/library/aa370853.aspx" />
10268 </xs:appinfo>
10269 <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>
10270 </xs:annotation>
10271 </xs:element>
10272 <xs:element name="UnpublishComponents" type="ActionSequenceType">
10273 <xs:annotation>
10274 <xs:appinfo>
10275 <xse:msiRef action="UnpublishComponents" href="http://msdn.microsoft.com/library/aa372106.aspx" />
10276 </xs:appinfo>
10277 <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>
10278 </xs:annotation>
10279 </xs:element>
10280 <xs:element name="MsiUnpublishAssemblies" type="ActionSequenceType">
10281 <xs:annotation>
10282 <xs:appinfo>
10283 <xse:msiRef action="MsiUnpublishAssemblies" href="http://msdn.microsoft.com/library/aa370500.aspx" />
10284 </xs:appinfo>
10285 <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>
10286 </xs:annotation>
10287 </xs:element>
10288 <xs:element name="UnpublishFeatures" type="ActionSequenceType">
10289 <xs:annotation>
10290 <xs:appinfo>
10291 <xse:msiRef action="UnpublishFeatures" href="http://msdn.microsoft.com/library/aa372107.aspx" />
10292 </xs:appinfo>
10293 <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>
10294 </xs:annotation>
10295 </xs:element>
10296 <xs:element name="StopServices" type="ActionSequenceType">
10297 <xs:annotation>
10298 <xs:appinfo>
10299 <xse:msiRef action="StopServices" href="http://msdn.microsoft.com/library/aa372028.aspx" />
10300 </xs:appinfo>
10301 <xs:documentation>Stops system services. The condition for this action may be specified in the element's inner text.</xs:documentation>
10302 </xs:annotation>
10303 </xs:element>
10304 <xs:element name="DeleteServices" type="ActionSequenceType">
10305 <xs:annotation>
10306 <xs:appinfo>
10307 <xse:msiRef action="DeleteServices" href="http://msdn.microsoft.com/library/aa368270.aspx" />
10308 </xs:appinfo>
10309 <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>
10310 </xs:annotation>
10311 </xs:element>
10312 <xs:element name="UnregisterComPlus" type="ActionSequenceType">
10313 <xs:annotation>
10314 <xs:appinfo>
10315 <xse:msiRef action="UnregisterComPlus" href="http://msdn.microsoft.com/library/aa372109.aspx" />
10316 </xs:appinfo>
10317 <xs:documentation>Removes COM+ applications from the registry. The condition for this action may be specified in the element's inner text.</xs:documentation>
10318 </xs:annotation>
10319 </xs:element>
10320 <xs:element name="SelfUnregModules" type="ActionSequenceType">
10321 <xs:annotation>
10322 <xs:appinfo>
10323 <xse:msiRef action="SelfUnregModules" href="http://msdn.microsoft.com/library/aa371610.aspx" />
10324 </xs:appinfo>
10325 <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>
10326 </xs:annotation>
10327 </xs:element>
10328 <xs:element name="UnregisterTypeLibraries" type="ActionSequenceType">
10329 <xs:annotation>
10330 <xs:appinfo>
10331 <xse:msiRef action="UnregisterTypeLibraries" href="http://msdn.microsoft.com/library/aa372357.aspx" />
10332 </xs:appinfo>
10333 <xs:documentation>Unregisters type libraries from the system. The condition for this action may be specified in the element's inner text.</xs:documentation>
10334 </xs:annotation>
10335 </xs:element>
10336 <xs:element name="RemoveODBC" type="ActionSequenceType">
10337 <xs:annotation>
10338 <xs:appinfo>
10339 <xse:msiRef action="RemoveODBC" href="http://msdn.microsoft.com/library/aa371206.aspx" />
10340 </xs:appinfo>
10341 <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>
10342 </xs:annotation>
10343 </xs:element>
10344 <xs:element name="UnregisterFonts" type="ActionSequenceType">
10345 <xs:annotation>
10346 <xs:appinfo>
10347 <xse:msiRef action="UnregisterFonts" href="http://msdn.microsoft.com/library/aa372112.aspx" />
10348 </xs:appinfo>
10349 <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>
10350 </xs:annotation>
10351 </xs:element>
10352 <xs:element name="RemoveRegistryValues" type="ActionSequenceType">
10353 <xs:annotation>
10354 <xs:appinfo>
10355 <xse:msiRef action="RemoveRegistryValues" href="http://msdn.microsoft.com/library/aa371207.aspx" />
10356 </xs:appinfo>
10357 <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>
10358 </xs:annotation>
10359 </xs:element>
10360 <xs:element name="UnregisterClassInfo" type="ActionSequenceType">
10361 <xs:annotation>
10362 <xs:appinfo>
10363 <xse:msiRef action="UnregisterClassInfo" href="http://msdn.microsoft.com/library/aa372108.aspx" />
10364 </xs:appinfo>
10365 <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>
10366 </xs:annotation>
10367 </xs:element>
10368 <xs:element name="UnregisterExtensionInfo" type="ActionSequenceType">
10369 <xs:annotation>
10370 <xs:appinfo>
10371 <xse:msiRef action="UnregisterExtensionInfo" href="http://msdn.microsoft.com/library/aa372110.aspx" />
10372 </xs:appinfo>
10373 <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>
10374 </xs:annotation>
10375 </xs:element>
10376 <xs:element name="UnregisterProgIdInfo" type="ActionSequenceType">
10377 <xs:annotation>
10378 <xs:appinfo>
10379 <xse:msiRef action="UnregisterProgIdInfo" href="http://msdn.microsoft.com/library/aa372114.aspx" />
10380 </xs:appinfo>
10381 <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>
10382 </xs:annotation>
10383 </xs:element>
10384 <xs:element name="UnregisterMIMEInfo" type="ActionSequenceType">
10385 <xs:annotation>
10386 <xs:appinfo>
10387 <xse:msiRef action="UnregisterMIMEInfo" href="http://msdn.microsoft.com/library/aa372113.aspx" />
10388 </xs:appinfo>
10389 <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>
10390 </xs:annotation>
10391 </xs:element>
10392 <xs:element name="RemoveIniValues" type="ActionSequenceType">
10393 <xs:annotation>
10394 <xs:appinfo>
10395 <xse:msiRef action="RemoveIniValues" href="http://msdn.microsoft.com/library/aa371205.aspx" />
10396 </xs:appinfo>
10397 <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>
10398 </xs:annotation>
10399 </xs:element>
10400 <xs:element name="RemoveShortcuts" type="ActionSequenceType">
10401 <xs:annotation>
10402 <xs:appinfo>
10403 <xse:msiRef action="RemoveShortcuts" href="http://msdn.microsoft.com/library/aa371209.aspx" />
10404 </xs:appinfo>
10405 <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>
10406 </xs:annotation>
10407 </xs:element>
10408 <xs:element name="RemoveEnvironmentStrings" type="ActionSequenceType">
10409 <xs:annotation>
10410 <xs:appinfo>
10411 <xse:msiRef action="RemoveEnvironmentStrings" href="http://msdn.microsoft.com/library/aa371196.aspx" />
10412 </xs:appinfo>
10413 <xs:documentation>Modifies the values of environment variables. The condition for this action may be specified in the element's inner text.</xs:documentation>
10414 </xs:annotation>
10415 </xs:element>
10416 <xs:element name="RemoveDuplicateFiles" type="ActionSequenceType">
10417 <xs:annotation>
10418 <xs:appinfo>
10419 <xse:msiRef action="RemoveDuplicateFiles" href="http://msdn.microsoft.com/library/aa371195.aspx" />
10420 </xs:appinfo>
10421 <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>
10422 </xs:annotation>
10423 </xs:element>
10424 <xs:element name="RemoveFiles" type="ActionSequenceType">
10425 <xs:annotation>
10426 <xs:appinfo>
10427 <xse:msiRef action="RemoveFiles" href="http://msdn.microsoft.com/library/aa371199.aspx" />
10428 </xs:appinfo>
10429 <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>
10430 </xs:annotation>
10431 </xs:element>
10432 <xs:element name="RemoveFolders" type="ActionSequenceType">
10433 <xs:annotation>
10434 <xs:appinfo>
10435 <xse:msiRef action="RemoveFolders" href="http://msdn.microsoft.com/library/aa371202.aspx" />
10436 </xs:appinfo>
10437 <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>
10438 </xs:annotation>
10439 </xs:element>
10440 <xs:element name="CreateFolders" type="ActionSequenceType">
10441 <xs:annotation>
10442 <xs:appinfo>
10443 <xse:msiRef action="CreateFolders" href="http://msdn.microsoft.com/library/aa368052.aspx" />
10444 </xs:appinfo>
10445 <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>
10446 </xs:annotation>
10447 </xs:element>
10448 <xs:element name="MoveFiles" type="ActionSequenceType">
10449 <xs:annotation>
10450 <xs:appinfo>
10451 <xse:msiRef table="MoveFile" href="http://msdn.microsoft.com/library/aa370055.aspx" />
10452 <xse:msiRef action="MoveFiles" href="http://msdn.microsoft.com/library/aa370054.aspx" />
10453 </xs:appinfo>
10454 <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>
10455 </xs:annotation>
10456 </xs:element>
10457 <xs:element name="InstallAdminPackage" type="ActionSequenceType">
10458 <xs:annotation>
10459 <xs:appinfo>
10460 <xse:msiRef action="InstallAdminPackage" href="http://msdn.microsoft.com/library/aa369287.aspx" />
10461 </xs:appinfo>
10462 <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>
10463 </xs:annotation>
10464 </xs:element>
10465 <xs:element name="InstallFiles" type="ActionSequenceType">
10466 <xs:annotation>
10467 <xs:appinfo>
10468 <xse:msiRef action="InstallFiles" href="http://msdn.microsoft.com/library/aa369503.aspx" />
10469 </xs:appinfo>
10470 <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>
10471 </xs:annotation>
10472 </xs:element>
10473 <xs:element name="DuplicateFiles" type="ActionSequenceType">
10474 <xs:annotation>
10475 <xs:appinfo>
10476 <xse:msiRef action="DuplicateFiles" href="http://msdn.microsoft.com/library/aa368334.aspx" />
10477 </xs:appinfo>
10478 <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>
10479 </xs:annotation>
10480 </xs:element>
10481 <xs:element name="PatchFiles" type="ActionSequenceType">
10482 <xs:annotation>
10483 <xs:appinfo>
10484 <xse:msiRef action="PatchFiles" href="http://msdn.microsoft.com/library/aa370577.aspx" />
10485 </xs:appinfo>
10486 <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>
10487 </xs:annotation>
10488 </xs:element>
10489 <xs:element name="BindImage" type="ActionSequenceType">
10490 <xs:annotation>
10491 <xs:appinfo>
10492 <xse:msiRef table="BindImage" href="http://msdn.microsoft.com/library/aa367828.aspx" />
10493 <xse:msiRef action="BindImage" href="http://msdn.microsoft.com/library/aa367827.aspx" />
10494 </xs:appinfo>
10495 <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>
10496 </xs:annotation>
10497 </xs:element>
10498 <xs:element name="CreateShortcuts" type="ActionSequenceType">
10499 <xs:annotation>
10500 <xs:appinfo>
10501 <xse:msiRef action="CreateShortcuts" href="http://msdn.microsoft.com/library/aa368054.aspx" />
10502 </xs:appinfo>
10503 <xs:documentation>Manages the creation of shortcuts. The condition for this action may be specified in the element's inner text.</xs:documentation>
10504 </xs:annotation>
10505 </xs:element>
10506 <xs:element name="RegisterClassInfo" type="ActionSequenceType">
10507 <xs:annotation>
10508 <xs:appinfo>
10509 <xse:msiRef action="RegisterClassInfo" href="http://msdn.microsoft.com/library/aa371154.aspx" />
10510 </xs:appinfo>
10511 <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>
10512 </xs:annotation>
10513 </xs:element>
10514 <xs:element name="RegisterExtensionInfo" type="ActionSequenceType">
10515 <xs:annotation>
10516 <xs:appinfo>
10517 <xse:msiRef action="RegisterExtensionInfo" href="http://msdn.microsoft.com/library/aa371156.aspx" />
10518 </xs:appinfo>
10519 <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>
10520 </xs:annotation>
10521 </xs:element>
10522 <xs:element name="RegisterProgIdInfo" type="ActionSequenceType">
10523 <xs:annotation>
10524 <xs:appinfo>
10525 <xse:msiRef action="RegisterProgIdInfo" href="http://msdn.microsoft.com/library/aa371164.aspx" />
10526 </xs:appinfo>
10527 <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>
10528 </xs:annotation>
10529 </xs:element>
10530 <xs:element name="RegisterMIMEInfo" type="ActionSequenceType">
10531 <xs:annotation>
10532 <xs:appinfo>
10533 <xse:msiRef action="RegisterMIMEInfo" href="http://msdn.microsoft.com/library/aa371160.aspx" />
10534 </xs:appinfo>
10535 <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>
10536 </xs:annotation>
10537 </xs:element>
10538 <xs:element name="WriteRegistryValues" type="ActionSequenceType">
10539 <xs:annotation>
10540 <xs:appinfo>
10541 <xse:msiRef action="WriteRegistryValues" href="http://msdn.microsoft.com/library/aa372891.aspx" />
10542 </xs:appinfo>
10543 <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>
10544 </xs:annotation>
10545 </xs:element>
10546 <xs:element name="WriteIniValues" type="ActionSequenceType">
10547 <xs:annotation>
10548 <xs:appinfo>
10549 <xse:msiRef action="WriteIniValues" href="http://msdn.microsoft.com/library/aa372884.aspx" />
10550 </xs:appinfo>
10551 <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>
10552 </xs:annotation>
10553 </xs:element>
10554 <xs:element name="WriteEnvironmentStrings" type="ActionSequenceType">
10555 <xs:annotation>
10556 <xs:appinfo>
10557 <xse:msiRef action="WriteEnvironmentStrings" href="http://msdn.microsoft.com/library/aa372883.aspx" />
10558 </xs:appinfo>
10559 <xs:documentation>Modifies the values of environment variables. The condition for this action may be specified in the element's inner text.</xs:documentation>
10560 </xs:annotation>
10561 </xs:element>
10562 <xs:element name="RegisterFonts" type="ActionSequenceType">
10563 <xs:annotation>
10564 <xs:appinfo>
10565 <xse:msiRef action="RegisterFonts" href="http://msdn.microsoft.com/library/aa371158.aspx" />
10566 </xs:appinfo>
10567 <xs:documentation>Registers installed fonts with the system. The condition for this action may be specified in the element's inner text.</xs:documentation>
10568 </xs:annotation>
10569 </xs:element>
10570 <xs:element name="InstallODBC" type="ActionSequenceType">
10571 <xs:annotation>
10572 <xs:appinfo>
10573 <xse:msiRef action="InstallODBC" href="http://msdn.microsoft.com/library/aa369538.aspx" />
10574 </xs:appinfo>
10575 <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>
10576 </xs:annotation>
10577 </xs:element>
10578 <xs:element name="RegisterTypeLibraries" type="ActionSequenceType">
10579 <xs:annotation>
10580 <xs:appinfo>
10581 <xse:msiRef action="RegisterTypeLibraries" href="http://msdn.microsoft.com/library/aa371165.aspx" />
10582 </xs:appinfo>
10583 <xs:documentation>Registers type libraries with the system. The condition for this action may be specified in the element's inner text.</xs:documentation>
10584 </xs:annotation>
10585 </xs:element>
10586 <xs:element name="SelfRegModules" type="ActionSequenceType">
10587 <xs:annotation>
10588 <xs:appinfo>
10589 <xse:msiRef action="SelfRegModules" href="http://msdn.microsoft.com/library/aa371607.aspx" />
10590 </xs:appinfo>
10591 <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>
10592 </xs:annotation>
10593 </xs:element>
10594 <xs:element name="RegisterComPlus" type="ActionSequenceType">
10595 <xs:annotation>
10596 <xs:appinfo>
10597 <xse:msiRef action="RegisterComPlus" href="http://msdn.microsoft.com/library/aa371155.aspx" />
10598 </xs:appinfo>
10599 <xs:documentation>Registers COM+ applications. The condition for this action may be specified in the element's inner text.</xs:documentation>
10600 </xs:annotation>
10601 </xs:element>
10602 <xs:element name="InstallServices" type="ActionSequenceType">
10603 <xs:annotation>
10604 <xs:appinfo>
10605 <xse:msiRef action="InstallServices" href="http://msdn.microsoft.com/library/aa369540.aspx" />
10606 </xs:appinfo>
10607 <xs:documentation>Registers a service for the system. The condition for this action may be specified in the element's inner text.</xs:documentation>
10608 </xs:annotation>
10609 </xs:element>
10610 <xs:element name="StartServices" type="ActionSequenceType">
10611 <xs:annotation>
10612 <xs:appinfo>
10613 <xse:msiRef action="StartServices" href="http://msdn.microsoft.com/library/aa372026.aspx" />
10614 </xs:appinfo>
10615 <xs:documentation>Starts system services. The condition for this action may be specified in the element's inner text.</xs:documentation>
10616 </xs:annotation>
10617 </xs:element>
10618 <xs:element name="RegisterUser" type="ActionSequenceType">
10619 <xs:annotation>
10620 <xs:appinfo>
10621 <xse:msiRef action="RegisterUser" href="http://msdn.microsoft.com/library/aa371166.aspx" />
10622 </xs:appinfo>
10623 <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>
10624 </xs:annotation>
10625 </xs:element>
10626 <xs:element name="RegisterProduct" type="ActionSequenceType">
10627 <xs:annotation>
10628 <xs:appinfo>
10629 <xse:msiRef action="RegisterProduct" href="http://msdn.microsoft.com/library/aa371162.aspx" />
10630 </xs:appinfo>
10631 <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>
10632 </xs:annotation>
10633 </xs:element>
10634 <xs:element name="PublishComponents" type="ActionSequenceType">
10635 <xs:annotation>
10636 <xs:appinfo>
10637 <xse:msiRef action="PublishComponents" href="http://msdn.microsoft.com/library/aa370918.aspx" />
10638 </xs:appinfo>
10639 <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>
10640 </xs:annotation>
10641 </xs:element>
10642 <xs:element name="MsiPublishAssemblies" type="ActionSequenceType">
10643 <xs:annotation>
10644 <xs:appinfo>
10645 <xse:msiRef action="MsiPublishAssemblies" href="http://msdn.microsoft.com/library/aa370359.aspx" />
10646 </xs:appinfo>
10647 <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>
10648 </xs:annotation>
10649 </xs:element>
10650 <xs:element name="PublishFeatures" type="ActionSequenceType">
10651 <xs:annotation>
10652 <xs:appinfo>
10653 <xse:msiRef action="PublishFeatures" href="http://msdn.microsoft.com/library/aa370923.aspx" />
10654 </xs:appinfo>
10655 <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>
10656 </xs:annotation>
10657 </xs:element>
10658 <xs:element name="PublishProduct" type="ActionSequenceType">
10659 <xs:annotation>
10660 <xs:appinfo>
10661 <xse:msiRef action="PublishProduct" href="http://msdn.microsoft.com/library/aa370932.aspx" />
10662 </xs:appinfo>
10663 <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>
10664 </xs:annotation>
10665 </xs:element>
10666 <xs:element name="InstallFinalize" type="ActionSequenceType">
10667 <xs:annotation>
10668 <xs:appinfo>
10669 <xse:seeAlso ref="InstallInitialize" />
10670 <xse:msiRef action="InstallFinalize" href="http://msdn.microsoft.com/library/aa369505.aspx" />
10671 </xs:appinfo>
10672 <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>
10673 </xs:annotation>
10674 </xs:element>
10675 <xs:element name="AppSearch" type="ActionModuleSequenceType">
10676 <xs:annotation>
10677 <xs:appinfo>
10678 <xse:seeAlso ref="ComponentSearch" />
10679 <xse:seeAlso ref="FileSearch" />
10680 <xse:seeAlso ref="IniFileSearch" />
10681 <xse:seeAlso ref="RegistrySearch" />
10682 <xse:msiRef table="AppSearch" href="http://msdn.microsoft.com/library/aa367579.aspx" />
10683 <xse:msiRef action="AppSearch" href="http://msdn.microsoft.com/library/aa367578.aspx" />
10684 </xs:appinfo>
10685 <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>
10686 </xs:annotation>
10687 </xs:element>
10688 <xs:element name="CCPSearch" type="ActionModuleSequenceType">
10689 <xs:annotation>
10690 <xs:appinfo>
10691 <xse:seeAlso ref="RMCCPSearch" />
10692 <xse:seeAlso ref="ComplianceCheck" />
10693 <xse:msiRef action="CCPSearch" href="http://msdn.microsoft.com/library/aa367845.aspx" />
10694 </xs:appinfo>
10695 <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>
10696 </xs:annotation>
10697 </xs:element>
10698 <xs:element name="RMCCPSearch" type="ActionModuleSequenceType">
10699 <xs:annotation>
10700 <xs:appinfo>
10701 <xse:seeAlso ref="CCPSearch" />
10702 <xse:seeAlso ref="ComplianceCheck" />
10703 <xse:msiRef action="RMCCPSearch" href="http://msdn.microsoft.com/library/aa371364.aspx" />
10704 </xs:appinfo>
10705 <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>
10706 </xs:annotation>
10707 </xs:element>
10708 <xs:element name="LaunchConditions" type="ActionModuleSequenceType">
10709 <xs:annotation>
10710 <xs:appinfo>
10711 <xse:seeAlso ref="Launch" />
10712 <xse:msiRef action="LaunchConditions" href="http://msdn.microsoft.com/library/aa369751.aspx" />
10713 </xs:appinfo>
10714 <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>
10715 </xs:annotation>
10716 </xs:element>
10717 <xs:element name="FindRelatedProducts" type="ActionModuleSequenceType">
10718 <xs:annotation>
10719 <xs:appinfo>
10720 <xse:seeAlso ref="Upgrade" />
10721 <xse:msiRef action="FindRelatedProducts" href="http://msdn.microsoft.com/library/aa368600.aspx" />
10722 </xs:appinfo>
10723 <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>
10724 </xs:annotation>
10725 </xs:element>
10726 <xs:element name="InstallExecute" type="ActionModuleSequenceType">
10727 <xs:annotation>
10728 <xs:appinfo>
10729 <xse:msiRef action="InstallExecute" href="http://msdn.microsoft.com/library/aa369502.aspx" />
10730 </xs:appinfo>
10731 <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>
10732 </xs:annotation>
10733 </xs:element>
10734 <xs:element name="InstallExecuteAgain" type="ActionModuleSequenceType">
10735 <xs:annotation>
10736 <xs:appinfo>
10737 <xse:msiRef action="InstallExecuteAgain" href="http://msdn.microsoft.com/library/aa369497.aspx" />
10738 </xs:appinfo>
10739 <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>
10740 </xs:annotation>
10741 </xs:element>
10742 <xs:element name="DisableRollback" type="ActionModuleSequenceType">
10743 <xs:annotation>
10744 <xs:appinfo>
10745 <xse:msiRef action="DisableRollback" href="http://msdn.microsoft.com/library/aa368308.aspx" />
10746 </xs:appinfo>
10747 <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>
10748 </xs:annotation>
10749 </xs:element>
10750 <xs:element name="RemoveExistingProducts" type="ActionModuleSequenceType">
10751 <xs:annotation>
10752 <xs:appinfo>
10753 <xse:msiRef action="RemoveExistingProducts" href="http://msdn.microsoft.com/library/aa371197.aspx" />
10754 </xs:appinfo>
10755 <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>
10756 </xs:annotation>
10757 </xs:element>
10758 <xs:element name="ScheduleReboot" type="ActionModuleSequenceType">
10759 <xs:annotation>
10760 <xs:appinfo>
10761 <xse:msiRef action="ScheduleReboot" href="http://msdn.microsoft.com/library/aa371527.aspx" />
10762 </xs:appinfo>
10763 <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>
10764 </xs:annotation>
10765 </xs:element>
10766 <xs:element name="ForceReboot" type="ActionModuleSequenceType">
10767 <xs:annotation>
10768 <xs:appinfo>
10769 <xse:msiRef action="ForceReboot" href="http://msdn.microsoft.com/library/aa368607.aspx" />
10770 </xs:appinfo>
10771 <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>
10772 </xs:annotation>
10773 </xs:element>
10774 <xs:element name="ResolveSource" type="ActionModuleSequenceType">
10775 <xs:annotation>
10776 <xs:appinfo>
10777 <xse:msiRef action="ResolveSource" href="http://msdn.microsoft.com/library/aa371232.aspx" />
10778 </xs:appinfo>
10779 <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>
10780 </xs:annotation>
10781 </xs:element>
10782 <!-- CustomActions and Dialogs of course aren't built in and must be specified relative to another action -->
10783 <xs:element name="Custom">
10784 <xs:annotation>
10785 <xs:appinfo>
10786 <xse:seeAlso ref="CustomAction" />
10787 </xs:appinfo>
10788 <xs:documentation>Use to sequence a custom action.</xs:documentation>
10789 </xs:annotation>
10790 <xs:complexType>
10791 <xs:annotation>
10792 <xs:documentation>Text node specifies the condition of the action.</xs:documentation>
10793 </xs:annotation>
10794 <xs:attribute name="Action" type="xs:string" use="required">
10795 <xs:annotation>
10796 <xs:documentation>The CustomAction to which the Custom element applies.</xs:documentation>
10797 </xs:annotation>
10798 </xs:attribute>
10799 <xs:attribute name="Condition" type="xs:string">
10800 <xs:annotation>
10801 <xs:documentation>Optional condition that determines whether the action should be executed.</xs:documentation>
10802 </xs:annotation>
10803 </xs:attribute>
10804 <xs:attribute name="OnExit" type="ExitType">
10805 <xs:annotation>
10806 <xs:documentation>Mutually exclusive with Before, After, and Sequence attributes</xs:documentation>
10807 </xs:annotation>
10808 </xs:attribute>
10809 <xs:attribute name="Before" type="xs:string">
10810 <xs:annotation>
10811 <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>
10812 </xs:annotation>
10813 </xs:attribute>
10814 <xs:attribute name="After" type="xs:string">
10815 <xs:annotation>
10816 <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>
10817 </xs:annotation>
10818 </xs:attribute>
10819 <xs:attribute name="Overridable" type="YesNoTypeUnion">
10820 <xs:annotation>
10821 <xs:documentation>If "yes", the sequencing of this action may be overridden by sequencing elsewhere.</xs:documentation>
10822 </xs:annotation>
10823 </xs:attribute>
10824 <xs:attribute name="Sequence" type="Integer">
10825 <xs:annotation>
10826 <xs:documentation>The sequence number for this action. It is recommended to use one of the other mutually exclusive attributes: OnExit, After, and Before.</xs:documentation>
10827 </xs:annotation>
10828 </xs:attribute>
10829 </xs:complexType>
10830 </xs:element>
10831 <xs:element name="Show">
10832 <xs:complexType>
10833 <xs:attribute name="Dialog" type="xs:string" use="required">
10834 <xs:annotation>
10835 <xs:documentation>Reference to dialog to show.</xs:documentation>
10836 </xs:annotation>
10837 </xs:attribute>
10838 <xs:attribute name="Condition" type="xs:string">
10839 <xs:annotation>
10840 <xs:documentation>Optional condition that determines whether the dialog should be displayed.</xs:documentation>
10841 </xs:annotation>
10842 </xs:attribute>
10843 <xs:attribute name="OnExit" type="ExitType">
10844 <xs:annotation>
10845 <xs:documentation>Show the dialog Mutually exclusive with Before, After, and Sequence attributes.</xs:documentation>
10846 </xs:annotation>
10847 </xs:attribute>
10848 <xs:attribute name="Before" type="xs:string">
10849 <xs:annotation>
10850 <xs:documentation>Show the dialog before the specified action. Mutually exclusive with OnExit, After, and Sequence attributes.</xs:documentation>
10851 </xs:annotation>
10852 </xs:attribute>
10853 <xs:attribute name="After" type="xs:string">
10854 <xs:annotation>
10855 <xs:documentation>Show the dialog after the specified action. Mutually exclusive with OnExit, Before, and Sequence attributes.</xs:documentation>
10856 </xs:annotation>
10857 </xs:attribute>
10858 <xs:attribute name="Overridable" type="YesNoTypeUnion">
10859 <xs:annotation>
10860 <xs:documentation>
10861 If "yes", the sequencing of this dialog may be overridden by sequencing elsewhere. The default is "no".
10862 </xs:documentation>
10863 </xs:annotation>
10864 </xs:attribute>
10865 <xs:attribute name="Sequence" type="Integer">
10866 <xs:annotation>
10867 <xs:documentation>Show the dialog at the specified sequence. It is recommended to use one of the other mutually exclusive attributes: OnExit, After, and Before.</xs:documentation>
10868 </xs:annotation>
10869 </xs:attribute>
10870 </xs:complexType>
10871 </xs:element>
10872 <!-- standard sequence table compositions -->
10873 <xs:element name="InstallUISequence">
10874 <xs:annotation>
10875 <xs:appinfo>
10876 <xse:msiRef table="InstallUISequence" href="https://docs.microsoft.com/en-us/windows/win32/msi/installuisequence-table" />
10877 </xs:appinfo>
10878 </xs:annotation>
10879 <xs:complexType>
10880 <xs:choice minOccurs="0" maxOccurs="unbounded">
10881 <xs:element ref="Custom" minOccurs="0" maxOccurs="unbounded">
10882 <xs:annotation>
10883 <xs:documentation>Use to sequence a custom action.</xs:documentation>
10884 </xs:annotation>
10885 </xs:element>
10886 <xs:element ref="Show" minOccurs="0" maxOccurs="unbounded">
10887 <xs:annotation>
10888 <xs:documentation>Displays a Dialog.</xs:documentation>
10889 </xs:annotation>
10890 </xs:element>
10891 <xs:element ref="ScheduleReboot" minOccurs="0">
10892 <xs:annotation>
10893 <xs:documentation>Prompts the user to restart the system at the end of installation. Not fixed sequence.</xs:documentation>
10894 </xs:annotation>
10895 </xs:element>
10896 <xs:element ref="LaunchConditions" minOccurs="0">
10897 <xs:annotation>
10898 <xs:documentation>Queries the LaunchCondition table and evaluates each conditional statement recorded there.</xs:documentation>
10899 </xs:annotation>
10900 </xs:element>
10901 <xs:element ref="FindRelatedProducts" minOccurs="0">
10902 <xs:annotation>
10903 <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>
10904 </xs:annotation>
10905 </xs:element>
10906 <xs:element ref="AppSearch" minOccurs="0">
10907 <xs:annotation>
10908 <xs:documentation>Uses file signatures to search for existing versions of products.</xs:documentation>
10909 </xs:annotation>
10910 </xs:element>
10911 <xs:element ref="CCPSearch" minOccurs="0">
10912 <xs:annotation>
10913 <xs:documentation>Uses file signatures to validate that qualifying products are installed on a system before an upgrade installation is performed.</xs:documentation>
10914 </xs:annotation>
10915 </xs:element>
10916 <xs:element ref="RMCCPSearch" minOccurs="0">
10917 <xs:annotation>
10918 <xs:documentation>Uses file signatures to validate that qualifying products are installed on a system before an upgrade installation is performed.</xs:documentation>
10919 </xs:annotation>
10920 </xs:element>
10921 <xs:element ref="ValidateProductID">
10922 <xs:annotation>
10923 <xs:documentation>Sets the ProductID property to the full product identifier.</xs:documentation>
10924 </xs:annotation>
10925 </xs:element>
10926 <xs:element ref="CostInitialize">
10927 <xs:annotation>
10928 <xs:documentation>Initiates the internal installation costing process.</xs:documentation>
10929 </xs:annotation>
10930 </xs:element>
10931 <xs:element ref="FileCost">
10932 <xs:annotation>
10933 <xs:documentation>Initiates dynamic costing of standard installation actions.</xs:documentation>
10934 </xs:annotation>
10935 </xs:element>
10936 <xs:element ref="IsolateComponents">
10937 <xs:annotation>
10938 <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>
10939 </xs:annotation>
10940 </xs:element>
10941 <xs:element ref="ResolveSource" minOccurs="0">
10942 <xs:annotation>
10943 <xs:documentation>Determines the location of the source and sets the SourceDir property if the source has not been resolved yet.</xs:documentation>
10944 </xs:annotation>
10945 </xs:element>
10946 <xs:element ref="CostFinalize">
10947 <xs:annotation>
10948 <xs:documentation>Ends the internal installation costing process begun by the CostInitialize action.</xs:documentation>
10949 </xs:annotation>
10950 </xs:element>
10951 <xs:element ref="MigrateFeatureStates">
10952 <xs:annotation>
10953 <xs:documentation>Used for upgrading or installing over an existing application.</xs:documentation>
10954 </xs:annotation>
10955 </xs:element>
10956 <xs:element ref="ExecuteAction" minOccurs="0">
10957 <xs:annotation>
10958 <xs:documentation>Initiates the execution sequence.</xs:documentation>
10959 </xs:annotation>
10960 </xs:element>
10961 </xs:choice>
10962 </xs:complexType>
10963 </xs:element>
10964 <xs:element name="InstallExecuteSequence">
10965 <xs:annotation>
10966 <xs:appinfo>
10967 <xse:msiRef table="InstallExecuteSequence" href="https://docs.microsoft.com/en-us/windows/win32/msi/installexecutesequence-table" />
10968 </xs:appinfo>
10969 </xs:annotation>
10970 <xs:complexType>
10971 <xs:choice minOccurs="0" maxOccurs="unbounded">
10972 <xs:element ref="Custom" minOccurs="0" maxOccurs="unbounded">
10973 <xs:annotation>
10974 <xs:documentation>Use to sequence a custom action.</xs:documentation>
10975 </xs:annotation>
10976 </xs:element>
10977 <xs:element ref="ScheduleReboot" minOccurs="0">
10978 <xs:annotation>
10979 <xs:documentation>Prompts the user to restart the system at the end of installation. Not fixed sequence.</xs:documentation>
10980 </xs:annotation>
10981 </xs:element>
10982 <xs:element ref="ForceReboot" minOccurs="0">
10983 <xs:annotation>
10984 <xs:documentation>Prompts the user for a restart of the system during the installation. Not fixed sequence.</xs:documentation>
10985 </xs:annotation>
10986 </xs:element>
10987 <xs:element ref="ResolveSource" minOccurs="0">
10988 <xs:annotation>
10989 <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>
10990 </xs:annotation>
10991 </xs:element>
10992 <xs:element ref="LaunchConditions" minOccurs="0">
10993 <xs:annotation>
10994 <xs:documentation>Queries the LaunchCondition table and evaluates each conditional statement recorded there.</xs:documentation>
10995 </xs:annotation>
10996 </xs:element>
10997 <xs:element ref="FindRelatedProducts" minOccurs="0">
10998 <xs:annotation>
10999 <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>
11000 </xs:annotation>
11001 </xs:element>
11002 <xs:element ref="AppSearch" minOccurs="0">
11003 <xs:annotation>
11004 <xs:documentation>Uses file signatures to search for existing versions of products.</xs:documentation>
11005 </xs:annotation>
11006 </xs:element>
11007 <xs:element ref="CCPSearch">
11008 <xs:annotation>
11009 <xs:documentation>Uses file signatures to validate that qualifying products are installed on a system before an upgrade installation is performed.</xs:documentation>
11010 </xs:annotation>
11011 </xs:element>
11012 <xs:element ref="RMCCPSearch">
11013 <xs:annotation>
11014 <xs:documentation>Uses file signatures to validate that qualifying products are installed on a system before an upgrade installation is performed.</xs:documentation>
11015 </xs:annotation>
11016 </xs:element>
11017 <xs:element ref="ValidateProductID">
11018 <xs:annotation>
11019 <xs:documentation>Sets the ProductID property to the full product identifier.</xs:documentation>
11020 </xs:annotation>
11021 </xs:element>
11022 <xs:element ref="CostInitialize">
11023 <xs:annotation>
11024 <xs:documentation>Initiates the internal installation costing process.</xs:documentation>
11025 </xs:annotation>
11026 </xs:element>
11027 <xs:element ref="FileCost">
11028 <xs:annotation>
11029 <xs:documentation>Initiates dynamic costing of standard installation actions.</xs:documentation>
11030 </xs:annotation>
11031 </xs:element>
11032 <xs:element ref="IsolateComponents">
11033 <xs:annotation>
11034 <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>
11035 </xs:annotation>
11036 </xs:element>
11037 <xs:element ref="CostFinalize">
11038 <xs:annotation>
11039 <xs:documentation>Ends the internal installation costing process begun by the CostInitialize action.</xs:documentation>
11040 </xs:annotation>
11041 </xs:element>
11042 <xs:element ref="SetODBCFolders">
11043 <xs:annotation>
11044 <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>
11045 </xs:annotation>
11046 </xs:element>
11047 <xs:element ref="MigrateFeatureStates">
11048 <xs:annotation>
11049 <xs:documentation>Used for upgrading or installing over an existing application.</xs:documentation>
11050 </xs:annotation>
11051 </xs:element>
11052 <xs:element ref="InstallValidate">
11053 <xs:annotation>
11054 <xs:documentation>Verifies that all costed volumes have enough space for the installation.</xs:documentation>
11055 </xs:annotation>
11056 </xs:element>
11057 <xs:element ref="InstallInitialize">
11058 <xs:annotation>
11059 <xs:documentation>Marks the beginning of a sequence of actions that change the system.</xs:documentation>
11060 </xs:annotation>
11061 </xs:element>
11062 <xs:element ref="AllocateRegistrySpace" minOccurs="0">
11063 <xs:annotation>
11064 <xs:documentation>Ensures the needed amount of space exists in the registry.</xs:documentation>
11065 </xs:annotation>
11066 </xs:element>
11067 <xs:element ref="ProcessComponents">
11068 <xs:annotation>
11069 <xs:documentation>Registers and unregisters components, their key paths, and the component clients.</xs:documentation>
11070 </xs:annotation>
11071 </xs:element>
11072 <xs:element ref="UnpublishComponents" minOccurs="0">
11073 <xs:annotation>
11074 <xs:documentation>Manages the unadvertisement of components listed in the PublishComponent table.</xs:documentation>
11075 </xs:annotation>
11076 </xs:element>
11077 <xs:element ref="UnpublishFeatures" minOccurs="0">
11078 <xs:annotation>
11079 <xs:documentation>Removes selection-state and feature-component mapping information from the registry.</xs:documentation>
11080 </xs:annotation>
11081 </xs:element>
11082 <xs:element ref="StopServices">
11083 <xs:annotation>
11084 <xs:documentation>Stops system services.</xs:documentation>
11085 </xs:annotation>
11086 </xs:element>
11087 <xs:element ref="DeleteServices">
11088 <xs:annotation>
11089 <xs:documentation>Stops a service and removes its registration from the system.</xs:documentation>
11090 </xs:annotation>
11091 </xs:element>
11092 <xs:element ref="UnregisterComPlus">
11093 <xs:annotation>
11094 <xs:documentation>Removes COM+ applications from the registry.</xs:documentation>
11095 </xs:annotation>
11096 </xs:element>
11097 <xs:element ref="SelfUnregModules" minOccurs="0">
11098 <xs:annotation>
11099 <xs:documentation>Unregisters all modules listed in the SelfReg table that are scheduled to be uninstalled.</xs:documentation>
11100 </xs:annotation>
11101 </xs:element>
11102 <xs:element ref="UnregisterTypeLibraries" minOccurs="0">
11103 <xs:annotation>
11104 <xs:documentation>Unregisters type libraries from the system.</xs:documentation>
11105 </xs:annotation>
11106 </xs:element>
11107 <xs:element ref="RemoveODBC">
11108 <xs:annotation>
11109 <xs:documentation>Removes the data sources, translators, and drivers listed for removal during the installation.</xs:documentation>
11110 </xs:annotation>
11111 </xs:element>
11112 <xs:element ref="UnregisterFonts">
11113 <xs:annotation>
11114 <xs:documentation>Removes registration information about installed fonts from the system.</xs:documentation>
11115 </xs:annotation>
11116 </xs:element>
11117 <xs:element ref="RemoveRegistryValues" minOccurs="0">
11118 <xs:annotation>
11119 <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>
11120 </xs:annotation>
11121 </xs:element>
11122 <xs:element ref="UnregisterClassInfo" minOccurs="0">
11123 <xs:annotation>
11124 <xs:documentation>Manages the removal of COM class information from the system registry.</xs:documentation>
11125 </xs:annotation>
11126 </xs:element>
11127 <xs:element ref="UnregisterExtensionInfo">
11128 <xs:annotation>
11129 <xs:documentation>Manages the removal of extension-related information from the system registry.</xs:documentation>
11130 </xs:annotation>
11131 </xs:element>
11132 <xs:element ref="UnregisterProgIdInfo" minOccurs="0">
11133 <xs:annotation>
11134 <xs:documentation>Manages the unregistration of OLE ProgId information with the system.</xs:documentation>
11135 </xs:annotation>
11136 </xs:element>
11137 <xs:element ref="UnregisterMIMEInfo">
11138 <xs:annotation>
11139 <xs:documentation>Unregisters MIME-related registry information from the system.</xs:documentation>
11140 </xs:annotation>
11141 </xs:element>
11142 <xs:element ref="RemoveIniValues">
11143 <xs:annotation>
11144 <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>
11145 </xs:annotation>
11146 </xs:element>
11147 <xs:element ref="RemoveShortcuts" minOccurs="0">
11148 <xs:annotation>
11149 <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>
11150 </xs:annotation>
11151 </xs:element>
11152 <xs:element ref="RemoveEnvironmentStrings">
11153 <xs:annotation>
11154 <xs:documentation>Modifies the values of environment variables.</xs:documentation>
11155 </xs:annotation>
11156 </xs:element>
11157 <xs:element ref="RemoveDuplicateFiles">
11158 <xs:annotation>
11159 <xs:documentation>Deletes files installed by the DuplicateFiles action.</xs:documentation>
11160 </xs:annotation>
11161 </xs:element>
11162 <xs:element ref="RemoveFiles" minOccurs="0">
11163 <xs:annotation>
11164 <xs:documentation>Removes files previously installed by the InstallFiles action.</xs:documentation>
11165 </xs:annotation>
11166 </xs:element>
11167 <xs:element ref="RemoveFolders" minOccurs="0">
11168 <xs:annotation>
11169 <xs:documentation>Removes any folders linked to components set to be removed or run from source.</xs:documentation>
11170 </xs:annotation>
11171 </xs:element>
11172 <xs:element ref="CreateFolders" minOccurs="0">
11173 <xs:annotation>
11174 <xs:documentation>Creates empty folders for components that are set to be installed.</xs:documentation>
11175 </xs:annotation>
11176 </xs:element>
11177 <xs:element ref="MoveFiles">
11178 <xs:annotation>
11179 <xs:documentation>Locates existing files on the system and moves or copies those files to a new location.</xs:documentation>
11180 </xs:annotation>
11181 </xs:element>
11182 <xs:element ref="InstallFiles" minOccurs="0">
11183 <xs:annotation>
11184 <xs:documentation>Copies files specified in the File table from the source directory to the destination directory.</xs:documentation>
11185 </xs:annotation>
11186 </xs:element>
11187 <xs:element ref="DuplicateFiles">
11188 <xs:annotation>
11189 <xs:documentation>Duplicates files installed by the InstallFiles action.</xs:documentation>
11190 </xs:annotation>
11191 </xs:element>
11192 <xs:element ref="PatchFiles">
11193 <xs:annotation>
11194 <xs:documentation>Queries the Patch table to determine which patches are to be applied.</xs:documentation>
11195 </xs:annotation>
11196 </xs:element>
11197 <xs:element ref="BindImage" minOccurs="0">
11198 <xs:annotation>
11199 <xs:documentation>Binds each executable or DLL that must be bound to the DLLs imported by it.</xs:documentation>
11200 </xs:annotation>
11201 </xs:element>
11202 <xs:element ref="CreateShortcuts" minOccurs="0">
11203 <xs:annotation>
11204 <xs:documentation>Manages the creation of shortcuts.</xs:documentation>
11205 </xs:annotation>
11206 </xs:element>
11207 <xs:element ref="RegisterClassInfo" minOccurs="0">
11208 <xs:annotation>
11209 <xs:documentation>Manages the registration of COM class information with the system.</xs:documentation>
11210 </xs:annotation>
11211 </xs:element>
11212 <xs:element ref="RegisterExtensionInfo">
11213 <xs:annotation>
11214 <xs:documentation>Manages the registration of extension related information with the system.</xs:documentation>
11215 </xs:annotation>
11216 </xs:element>
11217 <xs:element ref="RegisterProgIdInfo" minOccurs="0">
11218 <xs:annotation>
11219 <xs:documentation>Manages the registration of OLE ProgId information with the system.</xs:documentation>
11220 </xs:annotation>
11221 </xs:element>
11222 <xs:element ref="RegisterMIMEInfo">
11223 <xs:annotation>
11224 <xs:documentation>Registers MIME-related registry information with the system.</xs:documentation>
11225 </xs:annotation>
11226 </xs:element>
11227 <xs:element ref="WriteRegistryValues" minOccurs="0">
11228 <xs:annotation>
11229 <xs:documentation>Sets up an application's registry information.</xs:documentation>
11230 </xs:annotation>
11231 </xs:element>
11232 <xs:element ref="WriteIniValues">
11233 <xs:annotation>
11234 <xs:documentation>Writes the .ini file information that the application needs written to its .ini files.</xs:documentation>
11235 </xs:annotation>
11236 </xs:element>
11237 <xs:element ref="WriteEnvironmentStrings">
11238 <xs:annotation>
11239 <xs:documentation>Modifies the values of environment variables.</xs:documentation>
11240 </xs:annotation>
11241 </xs:element>
11242 <xs:element ref="RegisterFonts">
11243 <xs:annotation>
11244 <xs:documentation>Registers installed fonts with the system.</xs:documentation>
11245 </xs:annotation>
11246 </xs:element>
11247 <xs:element ref="InstallODBC">
11248 <xs:annotation>
11249 <xs:documentation>Installs the drivers, translators, and data sources in the ODBCDriver table, ODBCTranslator table, and ODBCDataSource table.</xs:documentation>
11250 </xs:annotation>
11251 </xs:element>
11252 <xs:element ref="RegisterTypeLibraries" minOccurs="0">
11253 <xs:annotation>
11254 <xs:documentation>Registers type libraries with the system.</xs:documentation>
11255 </xs:annotation>
11256 </xs:element>
11257 <xs:element ref="SelfRegModules" minOccurs="0">
11258 <xs:annotation>
11259 <xs:documentation>Processes all modules listed in the SelfReg table and registers all installed modules with the system.</xs:documentation>
11260 </xs:annotation>
11261 </xs:element>
11262 <xs:element ref="RegisterComPlus">
11263 <xs:annotation>
11264 <xs:documentation>Registers COM+ applications.</xs:documentation>
11265 </xs:annotation>
11266 </xs:element>
11267 <xs:element ref="InstallServices">
11268 <xs:annotation>
11269 <xs:documentation>Registers a service for the system.</xs:documentation>
11270 </xs:annotation>
11271 </xs:element>
11272 <xs:element ref="StartServices">
11273 <xs:annotation>
11274 <xs:documentation>Starts system services.</xs:documentation>
11275 </xs:annotation>
11276 </xs:element>
11277 <xs:element ref="RegisterUser" minOccurs="0">
11278 <xs:annotation>
11279 <xs:documentation>Registers the user information with the installer to identify the user of a product.</xs:documentation>
11280 </xs:annotation>
11281 </xs:element>
11282 <xs:element ref="RegisterProduct" minOccurs="0">
11283 <xs:annotation>
11284 <xs:documentation>Registers the product information with the installer.</xs:documentation>
11285 </xs:annotation>
11286 </xs:element>
11287 <xs:element ref="PublishComponents" minOccurs="0">
11288 <xs:annotation>
11289 <xs:documentation>Manages the advertisement of the components from the PublishComponent table.</xs:documentation>
11290 </xs:annotation>
11291 </xs:element>
11292 <xs:element ref="PublishFeatures" minOccurs="0">
11293 <xs:annotation>
11294 <xs:documentation>Writes each feature's state into the system registry.</xs:documentation>
11295 </xs:annotation>
11296 </xs:element>
11297 <xs:element ref="PublishProduct" minOccurs="0">
11298 <xs:annotation>
11299 <xs:documentation>Manages the advertisement of the product information with the system.</xs:documentation>
11300 </xs:annotation>
11301 </xs:element>
11302 <xs:element ref="InstallFinalize">
11303 <xs:annotation>
11304 <xs:documentation>Marks the end of a sequence of actions that change the system.</xs:documentation>
11305 </xs:annotation>
11306 </xs:element>
11307 <xs:element ref="RemoveExistingProducts">
11308 <xs:annotation>
11309 <xs:documentation>Goes through the product codes listed in the ActionProperty column of the Upgrade table and removes the products in sequence.</xs:documentation>
11310 </xs:annotation>
11311 </xs:element>
11312 <xs:element ref="DisableRollback" minOccurs="0">
11313 <xs:annotation>
11314 <xs:documentation>Disables rollback for the remainder of the installation.</xs:documentation>
11315 </xs:annotation>
11316 </xs:element>
11317 <xs:element ref="InstallExecute" minOccurs="0">
11318 <xs:annotation>
11319 <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>
11320 </xs:annotation>
11321 </xs:element>
11322 <xs:element ref="InstallExecuteAgain" minOccurs="0">
11323 <xs:annotation>
11324 <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>
11325 </xs:annotation>
11326 </xs:element>
11327 <xs:element ref="MsiPublishAssemblies">
11328 <xs:annotation>
11329 <xs:documentation>Manages the advertisement of CLR and Win32 assemblies.</xs:documentation>
11330 </xs:annotation>
11331 </xs:element>
11332 <xs:element ref="MsiUnpublishAssemblies">
11333 <xs:annotation>
11334 <xs:documentation>Manages the unadvertisement of CLR and Win32 assemblies that are being removed.</xs:documentation>
11335 </xs:annotation>
11336 </xs:element>
11337 </xs:choice>
11338 </xs:complexType>
11339 </xs:element>
11340 <xs:element name="AdminUISequence">
11341 <xs:annotation>
11342 <xs:appinfo>
11343 <xse:msiRef table="AdminUISequence" href="https://docs.microsoft.com/en-us/windows/win32/msi/adminuisequence-table" />
11344 </xs:appinfo>
11345 </xs:annotation>
11346 <xs:complexType>
11347 <xs:choice minOccurs="0" maxOccurs="unbounded">
11348 <xs:element ref="Custom" minOccurs="0" maxOccurs="unbounded">
11349 <xs:annotation>
11350 <xs:documentation>Use to sequence a custom action.</xs:documentation>
11351 </xs:annotation>
11352 </xs:element>
11353 <xs:element ref="Show" minOccurs="0" maxOccurs="unbounded" />
11354 <xs:element ref="CostInitialize">
11355 <xs:annotation>
11356 <xs:documentation>Initiates the internal installation costing process.</xs:documentation>
11357 </xs:annotation>
11358 </xs:element>
11359 <xs:element ref="FileCost">
11360 <xs:annotation>
11361 <xs:documentation>Initiates dynamic costing of standard installation actions.</xs:documentation>
11362 </xs:annotation>
11363 </xs:element>
11364 <xs:element ref="CostFinalize">
11365 <xs:annotation>
11366 <xs:documentation>Ends the internal installation costing process begun by the CostInitialize action.</xs:documentation>
11367 </xs:annotation>
11368 </xs:element>
11369 <xs:element ref="ExecuteAction">
11370 <xs:annotation>
11371 <xs:documentation>Initiates the execution sequence.</xs:documentation>
11372 </xs:annotation>
11373 </xs:element>
11374 <xs:element ref="InstallValidate">
11375 <xs:annotation>
11376 <xs:documentation>Verifies that all costed volumes have enough space for the installation.</xs:documentation>
11377 </xs:annotation>
11378 </xs:element>
11379 <xs:element ref="InstallInitialize">
11380 <xs:annotation>
11381 <xs:documentation>Marks the beginning of a sequence of actions that change the system.</xs:documentation>
11382 </xs:annotation>
11383 </xs:element>
11384 <xs:element ref="InstallAdminPackage">
11385 <xs:annotation>
11386 <xs:documentation>Copies the product database to the administrative installation point.</xs:documentation>
11387 </xs:annotation>
11388 </xs:element>
11389 <xs:element ref="InstallFiles">
11390 <xs:annotation>
11391 <xs:documentation>Copies files specified in the File table from the source directory to the destination directory.</xs:documentation>
11392 </xs:annotation>
11393 </xs:element>
11394 <xs:element ref="InstallFinalize">
11395 <xs:annotation>
11396 <xs:documentation>Marks the end of a sequence of actions that change the system.</xs:documentation>
11397 </xs:annotation>
11398 </xs:element>
11399 <xs:element ref="LaunchConditions">
11400 <xs:annotation>
11401 <xs:documentation>Queries the LaunchCondition table and evaluates each conditional statement recorded there.</xs:documentation>
11402 </xs:annotation>
11403 </xs:element>
11404 </xs:choice>
11405 </xs:complexType>
11406 </xs:element>
11407 <xs:element name="AdminExecuteSequence">
11408 <xs:annotation>
11409 <xs:appinfo>
11410 <xse:msiRef table="AdminExecuteSequence" href="https://docs.microsoft.com/en-us/windows/win32/msi/adminexecutesequence-table" />
11411 </xs:appinfo>
11412 </xs:annotation>
11413 <xs:complexType>
11414 <xs:choice minOccurs="0" maxOccurs="unbounded">
11415 <xs:element ref="Custom" minOccurs="0" maxOccurs="unbounded">
11416 <xs:annotation>
11417 <xs:documentation>Use to sequence a custom action.</xs:documentation>
11418 </xs:annotation>
11419 </xs:element>
11420 <xs:element ref="CostInitialize">
11421 <xs:annotation>
11422 <xs:documentation>Initiates the internal installation costing process.</xs:documentation>
11423 </xs:annotation>
11424 </xs:element>
11425 <xs:element ref="FileCost">
11426 <xs:annotation>
11427 <xs:documentation>Initiates dynamic costing of standard installation actions.</xs:documentation>
11428 </xs:annotation>
11429 </xs:element>
11430 <xs:element ref="CostFinalize">
11431 <xs:annotation>
11432 <xs:documentation>Ends the internal installation costing process begun by the CostInitialize action.</xs:documentation>
11433 </xs:annotation>
11434 </xs:element>
11435 <xs:element ref="InstallValidate">
11436 <xs:annotation>
11437 <xs:documentation>Verifies that all costed volumes have enough space for the installation.</xs:documentation>
11438 </xs:annotation>
11439 </xs:element>
11440 <xs:element ref="InstallInitialize">
11441 <xs:annotation>
11442 <xs:documentation>Marks the beginning of a sequence of actions that change the system.</xs:documentation>
11443 </xs:annotation>
11444 </xs:element>
11445 <xs:element ref="InstallAdminPackage">
11446 <xs:annotation>
11447 <xs:documentation>Copies the product database to the administrative installation point.</xs:documentation>
11448 </xs:annotation>
11449 </xs:element>
11450 <xs:element ref="InstallFiles">
11451 <xs:annotation>
11452 <xs:documentation>Copies files specified in the File table from the source directory to the destination directory.</xs:documentation>
11453 </xs:annotation>
11454 </xs:element>
11455 <xs:element ref="PatchFiles">
11456 <xs:annotation>
11457 <xs:documentation>Queries the Patch table to determine which patches are to be applied.</xs:documentation>
11458 </xs:annotation>
11459 </xs:element>
11460 <xs:element ref="InstallFinalize">
11461 <xs:annotation>
11462 <xs:documentation>Marks the end of a sequence of actions that change the system.</xs:documentation>
11463 </xs:annotation>
11464 </xs:element>
11465 <xs:element ref="LaunchConditions">
11466 <xs:annotation>
11467 <xs:documentation>Queries the LaunchCondition table and evaluates each conditional statement recorded there.</xs:documentation>
11468 </xs:annotation>
11469 </xs:element>
11470 <xs:element ref="ResolveSource" minOccurs="0">
11471 <xs:annotation>
11472 <xs:documentation>Determines the location of the source and sets the SourceDir property if the source has not been resolved yet.</xs:documentation>
11473 </xs:annotation>
11474 </xs:element>
11475 </xs:choice>
11476 </xs:complexType>
11477 </xs:element>
11478 <xs:element name="AdvertiseExecuteSequence">
11479 <xs:annotation>
11480 <xs:appinfo>
11481 <xse:msiRef table="AdvtExecuteSequence" href="https://docs.microsoft.com/en-us/windows/win32/msi/advtexecutesequence-table" />
11482 </xs:appinfo>
11483 </xs:annotation>
11484 <xs:complexType>
11485 <xs:choice minOccurs="0" maxOccurs="unbounded">
11486 <xs:element ref="CostInitialize">
11487 <xs:annotation>
11488 <xs:documentation>Initiates the internal installation costing process.</xs:documentation>
11489 </xs:annotation>
11490 </xs:element>
11491 <xs:element ref="CostFinalize">
11492 <xs:annotation>
11493 <xs:documentation>Ends the internal installation costing process begun by the CostInitialize action.</xs:documentation>
11494 </xs:annotation>
11495 </xs:element>
11496 <xs:element ref="Custom" minOccurs="0" maxOccurs="unbounded">
11497 <xs:annotation>
11498 <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>
11499 </xs:annotation>
11500 </xs:element>
11501 <xs:element ref="InstallValidate">
11502 <xs:annotation>
11503 <xs:documentation>Verifies that all costed volumes have enough space for the installation.</xs:documentation>
11504 </xs:annotation>
11505 </xs:element>
11506 <xs:element ref="InstallInitialize">
11507 <xs:annotation>
11508 <xs:documentation>Marks the beginning of a sequence of actions that change the system.</xs:documentation>
11509 </xs:annotation>
11510 </xs:element>
11511 <xs:element ref="CreateShortcuts">
11512 <xs:annotation>
11513 <xs:documentation>Manages the creation of shortcuts.</xs:documentation>
11514 </xs:annotation>
11515 </xs:element>
11516 <xs:element ref="RegisterClassInfo">
11517 <xs:annotation>
11518 <xs:documentation>Manages the registration of COM class information with the system.</xs:documentation>
11519 </xs:annotation>
11520 </xs:element>
11521 <xs:element ref="RegisterExtensionInfo">
11522 <xs:annotation>
11523 <xs:documentation>Manages the registration of extension related information with the system.</xs:documentation>
11524 </xs:annotation>
11525 </xs:element>
11526 <xs:element ref="RegisterMIMEInfo">
11527 <xs:annotation>
11528 <xs:documentation>Registers MIME-related registry information with the system.</xs:documentation>
11529 </xs:annotation>
11530 </xs:element>
11531 <xs:element ref="RegisterProgIdInfo">
11532 <xs:annotation>
11533 <xs:documentation>Manages the registration of OLE ProgId information with the system.</xs:documentation>
11534 </xs:annotation>
11535 </xs:element>
11536 <xs:element ref="PublishComponents">
11537 <xs:annotation>
11538 <xs:documentation>Manages the advertisement of the components from the PublishComponent table.</xs:documentation>
11539 </xs:annotation>
11540 </xs:element>
11541 <xs:element ref="PublishFeatures">
11542 <xs:annotation>
11543 <xs:documentation>Writes each feature's state into the system registry.</xs:documentation>
11544 </xs:annotation>
11545 </xs:element>
11546 <xs:element ref="PublishProduct">
11547 <xs:annotation>
11548 <xs:documentation>Manages the advertisement of the product information with the system.</xs:documentation>
11549 </xs:annotation>
11550 </xs:element>
11551 <xs:element ref="InstallFinalize">
11552 <xs:annotation>
11553 <xs:documentation>Marks the end of a sequence of actions that change the system.</xs:documentation>
11554 </xs:annotation>
11555 </xs:element>
11556 <xs:element ref="MsiPublishAssemblies">
11557 <xs:annotation>
11558 <xs:documentation>Manages the advertisement of CLR and Win32 assemblies.</xs:documentation>
11559 </xs:annotation>
11560 </xs:element>
11561 </xs:choice>
11562 </xs:complexType>
11563 </xs:element>
11564 <xs:element name="Binary">
11565 <xs:annotation>
11566 <xs:documentation>
11567 Binary data used for CustomAction elements and UI controls.
11568 </xs:documentation>
11569 <xs:appinfo>
11570 <xse:msiRef table="Binary" href="https://learn.microsoft.com/en-us/windows/win32/msi/binary-table" />
11571 </xs:appinfo>
11572 </xs:annotation>
11573 <xs:complexType>
11574 <xs:choice minOccurs="0" maxOccurs="unbounded">
11575 <xs:any namespace="##other" processContents="lax">
11576 <xs:annotation>
11577 <xs:documentation>
11578 Extensibility point in the WiX XML Schema. Schema extensions can register additional
11579 elements at this point in the schema.
11580 </xs:documentation>
11581 </xs:annotation>
11582 </xs:any>
11583 </xs:choice>
11584 <xs:attribute name="Id" type="xs:string" use="required">
11585 <xs:annotation>
11586 <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>
11587 </xs:annotation>
11588 </xs:attribute>
11589 <xs:attribute name="SourceFile" type="xs:string">
11590 <xs:annotation>
11591 <xs:documentation>Path to the binary file.</xs:documentation>
11592 </xs:annotation>
11593 </xs:attribute>
11594 <xs:attribute name="SuppressModularization" type="YesNoTypeUnion">
11595 <xs:annotation>
11596 <xs:documentation>
11597 Use to suppress modularization of this Binary identifier in merge modules.
11598 </xs:documentation>
11599 </xs:annotation>
11600 </xs:attribute>
11601 <xs:anyAttribute namespace="##other" processContents="lax">
11602 <xs:annotation>
11603 <xs:documentation>
11604 Extensibility point in the WiX XML Schema. Schema extensions can register additional
11605 attributes at this point in the schema.
11606 </xs:documentation>
11607 </xs:annotation>
11608 </xs:anyAttribute>
11609 </xs:complexType>
11610 </xs:element>
11611 <xs:element name="Icon">
11612 <xs:annotation>
11613 <xs:documentation>
11614 Icon used for Shortcut, ProgId, or Class elements (but not UI controls).
11615 </xs:documentation>
11616 <xs:appinfo>
11617 <xse:msiRef table="Icon" href="https://learn.microsoft.com/en-us/windows/win32/msi/icon-table" />
11618 <xse:howtoRef href="ui_and_localization/configure_arp_appearance.html">How To: Set your installer's icon in Add/Remove Programs</xse:howtoRef>
11619 <xse:howtoRef href="files_and_registry/create_start_menu_shortcut.html">How To: Create a shortcut on the Start Menu</xse:howtoRef>
11620 </xs:appinfo>
11621 </xs:annotation>
11622 <xs:complexType>
11623 <xs:attribute name="Id" type="xs:string" use="required">
11624 <xs:annotation>
11625 <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>
11626 </xs:annotation>
11627 </xs:attribute>
11628 <xs:attribute name="SourceFile" type="xs:string">
11629 <xs:annotation>
11630 <xs:documentation>Path to the icon file.</xs:documentation>
11631 </xs:annotation>
11632 </xs:attribute>
11633 </xs:complexType>
11634 </xs:element>
11635 <xs:element name="EmbeddedChainer">
11636 <xs:annotation>
11637 <xs:appinfo>
11638 <xse:msiRef table="MsiEmbeddedChainer " href="http://msdn.microsoft.com/library/bb736316.aspx" />
11639 <xse:seeAlso ref="Binary" />
11640 <xse:seeAlso ref="File" />
11641 <xse:seeAlso ref="Property" />
11642 <xse:seeAlso ref="EmbeddedChainerRef" />
11643 </xs:appinfo>
11644 </xs:annotation>
11645 <xs:complexType>
11646 <xs:attribute name="Id" type="xs:string" use="required">
11647 <xs:annotation>
11648 <xs:documentation>Unique identifier for embedded chainer.</xs:documentation>
11649 </xs:annotation>
11650 </xs:attribute>
11651 <xs:attribute name="CommandLine" type="xs:string">
11652 <xs:annotation>
11653 <xs:documentation>Value to append to the transaction handle and passed to the chainer executable.</xs:documentation>
11654 </xs:annotation>
11655 </xs:attribute>
11656 <xs:attribute name="Condition" type="xs:string">
11657 <xs:annotation>
11658 <xs:documentation>
11659 Value is the condition. It is important to note that each EmbeddedChainer element must have a mutually exclusive condition
11660 to ensure that only one embedded chainer will execute at a time. If the conditions are not mutually exclusive the chainer
11661 that executes is undeterministic.
11662 </xs:documentation>
11663 </xs:annotation>
11664 </xs:attribute>
11665 <xs:attribute name="BinarySource" type="xs:string">
11666 <xs:annotation>
11667 <xs:documentation>
11668 Reference to the Binary element that contains the chainer executable. Mutually exclusive with
11669 the FileSource and PropertySource attributes.
11670 </xs:documentation>
11671 </xs:annotation>
11672 </xs:attribute>
11673 <xs:attribute name="FileSource" type="xs:string">
11674 <xs:annotation>
11675 <xs:documentation>
11676 Reference to the File element that is the chainer executable. Mutually exclusive with
11677 the BinarySource and PropertySource attributes.
11678 </xs:documentation>
11679 </xs:annotation>
11680 </xs:attribute>
11681 <xs:attribute name="PropertySource" type="xs:string">
11682 <xs:annotation>
11683 <xs:documentation>
11684 Reference to a Property that resolves to the full path to the chainer executable. Mutually exclusive with
11685 the BinarySource and FileSource attributes.
11686 </xs:documentation>
11687 </xs:annotation>
11688 </xs:attribute>
11689 <xs:anyAttribute namespace="##other" processContents="lax">
11690 <xs:annotation>
11691 <xs:documentation>
11692 Extensibility point in the WiX XML Schema. Schema extensions can register additional
11693 attributes at this point in the schema.
11694 </xs:documentation>
11695 </xs:annotation>
11696 </xs:anyAttribute>
11697 </xs:complexType>
11698 </xs:element>
11699 <xs:element name="EmbeddedChainerRef">
11700 <xs:annotation>
11701 <xs:documentation>
11702 Reference to an EmbeddedChainer element. This will force the entire referenced Fragment's contents
11703 to be included in the installer database.
11704 </xs:documentation>
11705 <xs:appinfo>
11706 <xse:seeAlso ref="EmbeddedChainer" />
11707 </xs:appinfo>
11708 </xs:annotation>
11709 <xs:complexType>
11710 <xs:attribute name="Id" type="xs:string" use="required" />
11711 <xs:anyAttribute namespace="##other" processContents="lax">
11712 <xs:annotation>
11713 <xs:documentation>
11714 Extensibility point in the WiX XML Schema. Schema extensions can register additional
11715 attributes at this point in the schema.
11716 </xs:documentation>
11717 </xs:annotation>
11718 </xs:anyAttribute>
11719 </xs:complexType>
11720 </xs:element>
11721 <!-- - - - - - - - - - - UI Definitions - - - - - - - - - - - - - -->
11722 <xs:element name="EmbeddedUI">
11723 <xs:annotation>
11724 <xs:appinfo>
11725 <xse:msiRef table="MsiEmbeddedUI" href="https://learn.microsoft.com/en-us/windows/win32/msi/msiembeddedui-table" />
11726 </xs:appinfo>
11727 </xs:annotation>
11728 <xs:complexType>
11729 <xs:choice minOccurs="0" maxOccurs="unbounded">
11730 <xs:element ref="EmbeddedUIResource">
11731 <xs:annotation>
11732 <xs:documentation>Specifies extra files to be extracted for use by the embedded UI, such as language resources.</xs:documentation>
11733 </xs:annotation>
11734 </xs:element>
11735 <xs:any namespace="##other" processContents="lax">
11736 <xs:annotation>
11737 <xs:documentation>
11738 Extensibility point in the WiX XML Schema. Schema extensions can register additional
11739 elements at this point in the schema.
11740 </xs:documentation>
11741 </xs:annotation>
11742 </xs:any>
11743 </xs:choice>
11744 <xs:attribute name="Id" type="xs:string">
11745 <xs:annotation>
11746 <xs:documentation>
11747 Unique identifier for embedded UI. If this attribute is not specified the Name attribute or the file name
11748 portion of the SourceFile attribute will be used.
11749 </xs:documentation>
11750 </xs:annotation>
11751 </xs:attribute>
11752 <xs:attribute name="IgnoreFatalExit" type="YesNoTypeUnion">
11753 <xs:annotation>
11754 <xs:documentation>Embedded UI will not recieve any INSTALLLOGMODE_FATALEXIT messages.</xs:documentation>
11755 </xs:annotation>
11756 </xs:attribute>
11757 <xs:attribute name="IgnoreError" type="YesNoTypeUnion">
11758 <xs:annotation>
11759 <xs:documentation>Embedded UI will not recieve any INSTALLLOGMODE_ERROR messages.</xs:documentation>
11760 </xs:annotation>
11761 </xs:attribute>
11762 <xs:attribute name="IgnoreWarning" type="YesNoTypeUnion">
11763 <xs:annotation>
11764 <xs:documentation>Embedded UI will not recieve any INSTALLLOGMODE_WARNING messages.</xs:documentation>
11765 </xs:annotation>
11766 </xs:attribute>
11767 <xs:attribute name="IgnoreUser" type="YesNoTypeUnion">
11768 <xs:annotation>
11769 <xs:documentation>Embedded UI will not recieve any INSTALLLOGMODE_USER messages.</xs:documentation>
11770 </xs:annotation>
11771 </xs:attribute>
11772 <xs:attribute name="IgnoreInfo" type="YesNoTypeUnion">
11773 <xs:annotation>
11774 <xs:documentation>Embedded UI will not recieve any INSTALLLOGMODE_INFO messages.</xs:documentation>
11775 </xs:annotation>
11776 </xs:attribute>
11777 <xs:attribute name="IgnoreFilesInUse" type="YesNoTypeUnion">
11778 <xs:annotation>
11779 <xs:documentation>Embedded UI will not recieve any INSTALLLOGMODE_FILESINUSE messages.</xs:documentation>
11780 </xs:annotation>
11781 </xs:attribute>
11782 <xs:attribute name="IgnoreResolveSource" type="YesNoTypeUnion">
11783 <xs:annotation>
11784 <xs:documentation>Embedded UI will not recieve any INSTALLLOGMODE_RESOLVESOURCE messages.</xs:documentation>
11785 </xs:annotation>
11786 </xs:attribute>
11787 <xs:attribute name="IgnoreOutOfDiskSpace" type="YesNoTypeUnion">
11788 <xs:annotation>
11789 <xs:documentation>Embedded UI will not recieve any INSTALLLOGMODE_OUTOFDISKSPACE messages.</xs:documentation>
11790 </xs:annotation>
11791 </xs:attribute>
11792 <xs:attribute name="IgnoreActionStart" type="YesNoTypeUnion">
11793 <xs:annotation>
11794 <xs:documentation>Embedded UI will not recieve any INSTALLLOGMODE_ACTIONSTART messages.</xs:documentation>
11795 </xs:annotation>
11796 </xs:attribute>
11797 <xs:attribute name="IgnoreActionData" type="YesNoTypeUnion">
11798 <xs:annotation>
11799 <xs:documentation>Embedded UI will not recieve any INSTALLLOGMODE_ACTIONDATA messages.</xs:documentation>
11800 </xs:annotation>
11801 </xs:attribute>
11802 <xs:attribute name="IgnoreProgress" type="YesNoTypeUnion">
11803 <xs:annotation>
11804 <xs:documentation>Embedded UI will not recieve any INSTALLLOGMODE_PROGRESS messages.</xs:documentation>
11805 </xs:annotation>
11806 </xs:attribute>
11807 <xs:attribute name="IgnoreCommonData" type="YesNoTypeUnion">
11808 <xs:annotation>
11809 <xs:documentation>Embedded UI will not recieve any INSTALLLOGMODE_COMMONDATA messages.</xs:documentation>
11810 </xs:annotation>
11811 </xs:attribute>
11812 <xs:attribute name="IgnoreInitialize" type="YesNoTypeUnion">
11813 <xs:annotation>
11814 <xs:documentation>Embedded UI will not recieve any INSTALLLOGMODE_INITIALIZE messages.</xs:documentation>
11815 </xs:annotation>
11816 </xs:attribute>
11817 <xs:attribute name="IgnoreTerminate" type="YesNoTypeUnion">
11818 <xs:annotation>
11819 <xs:documentation>Embedded UI will not recieve any INSTALLLOGMODE_TERMINATE messages.</xs:documentation>
11820 </xs:annotation>
11821 </xs:attribute>
11822 <xs:attribute name="IgnoreShowDialog" type="YesNoTypeUnion">
11823 <xs:annotation>
11824 <xs:documentation>Embedded UI will not recieve any INSTALLLOGMODE_SHOWDIALOG messages.</xs:documentation>
11825 </xs:annotation>
11826 </xs:attribute>
11827 <xs:attribute name="IgnoreRMFilesInUse" type="YesNoTypeUnion">
11828 <xs:annotation>
11829 <xs:documentation>Embedded UI will not recieve any INSTALLLOGMODE_RMFILESINUSE messages.</xs:documentation>
11830 </xs:annotation>
11831 </xs:attribute>
11832 <xs:attribute name="IgnoreInstallStart" type="YesNoTypeUnion">
11833 <xs:annotation>
11834 <xs:documentation>Embedded UI will not recieve any INSTALLLOGMODE_INSTALLSTART messages.</xs:documentation>
11835 </xs:annotation>
11836 </xs:attribute>
11837 <xs:attribute name="IgnoreInstallEnd" type="YesNoTypeUnion">
11838 <xs:annotation>
11839 <xs:documentation>Embedded UI will not recieve any INSTALLLOGMODE_INSTALLEND messages.</xs:documentation>
11840 </xs:annotation>
11841 </xs:attribute>
11842 <xs:attribute name="Name" type="LongFileNameType">
11843 <xs:annotation>
11844 <xs:documentation>
11845 The name for the embedded UI DLL when it is extracted from the MSI package and executed. (Windows Installer
11846 does not support the typical short filename and long filename combination for embedded UI files as it
11847 does for other kinds of files.) If this attribute is not specified the file name portion of the SourceFile
11848 attribute will be used.
11849 </xs:documentation>
11850 </xs:annotation>
11851 </xs:attribute>
11852 <xs:attribute name="SourceFile" type="xs:string" use="required">
11853 <xs:annotation>
11854 <xs:documentation>
11855 Path to the binary file that is the embedded UI. This must be a DLL that exports the following
11856 three entry points: InitializeEmbeddedUI, EmbeddedUIHandler and ShutdownEmbeddedUI.
11857 </xs:documentation>
11858 </xs:annotation>
11859 </xs:attribute>
11860 <xs:attribute name="SupportBasicUI" type="YesNoTypeUnion">
11861 <xs:annotation>
11862 <xs:documentation>Set yes to allow the Windows Installer to display the embedded UI during basic UI level installation.</xs:documentation>
11863 </xs:annotation>
11864 </xs:attribute>
11865 <xs:anyAttribute namespace="##other" processContents="lax">
11866 <xs:annotation>
11867 <xs:documentation>
11868 Extensibility point in the WiX XML Schema. Schema extensions can register additional
11869 attributes at this point in the schema.
11870 </xs:documentation>
11871 </xs:annotation>
11872 </xs:anyAttribute>
11873 </xs:complexType>
11874 </xs:element>
11875 <xs:element name="EmbeddedUIResource">
11876 <xs:annotation>
11877 <xs:documentation>
11878 Defines a resource for use by the embedded UI.
11879 </xs:documentation>
11880 <xs:appinfo>
11881 <xse:seeAlso ref="EmbeddedUI" />
11882 <xse:msiRef table="MsiEmbeddedUI" href="https://learn.microsoft.com/en-us/windows/win32/msi/msiembeddedui-table" />
11883 </xs:appinfo>
11884 </xs:annotation>
11885 <xs:complexType>
11886 <xs:choice minOccurs="0" maxOccurs="unbounded">
11887 <xs:any namespace="##other" processContents="lax">
11888 <xs:annotation>
11889 <xs:documentation>
11890 Extensibility point in the WiX XML Schema. Schema extensions can register additional
11891 elements at this point in the schema.
11892 </xs:documentation>
11893 </xs:annotation>
11894 </xs:any>
11895 </xs:choice>
11896 <xs:attribute name="Id" type="xs:string" use="required">
11897 <xs:annotation>
11898 <xs:documentation>Identifier for the embedded UI resource.</xs:documentation>
11899 </xs:annotation>
11900 </xs:attribute>
11901 <xs:attribute name="Name" type="LongFileNameType" use="required">
11902 <xs:annotation>
11903 <xs:documentation>
11904 The name for the resource when it is extracted from the MSI package for use by the embedded UI DLL. (Windows
11905 Installer does not support the typical short filename and long filename combination for embedded UI files
11906 as it does for other kinds of files.) If this attribute is not specified the Id attribute will be used.
11907 </xs:documentation>
11908 </xs:annotation>
11909 </xs:attribute>
11910 <xs:attribute name="SourceFile" type="xs:string" use="required">
11911 <xs:annotation>
11912 <xs:documentation>Path to the binary file that is the embedded UI resource.</xs:documentation>
11913 </xs:annotation>
11914 </xs:attribute>
11915 <xs:anyAttribute namespace="##other" processContents="lax">
11916 <xs:annotation>
11917 <xs:documentation>
11918 Extensibility point in the WiX XML Schema. Schema extensions can register additional
11919 attributes at this point in the schema.
11920 </xs:documentation>
11921 </xs:annotation>
11922 </xs:anyAttribute>
11923 </xs:complexType>
11924 </xs:element>
11925 <xs:element name="Error">
11926 <xs:annotation>
11927 <xs:appinfo>
11928 <xse:msiRef table="Error" href="https://learn.microsoft.com/en-us/windows/win32/msi/error-table" />
11929 </xs:appinfo>
11930 </xs:annotation>
11931 <xs:complexType>
11932 <xs:choice minOccurs="0" maxOccurs="unbounded">
11933 <xs:any namespace="##other" processContents="lax">
11934 <xs:annotation>
11935 <xs:documentation>
11936 Extensibility point in the WiX XML Schema. Schema extensions can register additional
11937 elements at this point in the schema.
11938 </xs:documentation>
11939 </xs:annotation>
11940 </xs:any>
11941 </xs:choice>
11942 <xs:attribute name="Id" type="Integer">
11943 <xs:annotation>
11944 <xs:documentation>Number of the error for which a message is being provided. See MSI SDK for error definitions.</xs:documentation>
11945 </xs:annotation>
11946 </xs:attribute>
11947 <xs:attribute name="Message" type="xs:string">
11948 <xs:annotation>
11949 <xs:documentation>Message to display for the specified error number.</xs:documentation>
11950 </xs:annotation>
11951 </xs:attribute>
11952 <xs:anyAttribute namespace="##other" processContents="lax">
11953 <xs:annotation>
11954 <xs:documentation>
11955 Extensibility point in the WiX XML Schema. Schema extensions can register additional
11956 attributes at this point in the schema.
11957 </xs:documentation>
11958 </xs:annotation>
11959 </xs:anyAttribute>
11960 </xs:complexType>
11961 </xs:element>
11962 <xs:element name="Publish">
11963 <xs:annotation>
11964 <xs:appinfo>
11965 <xse:msiRef table="ControlEvent" href="https://learn.microsoft.com/en-us/windows/win32/msi/controlevent-table" />
11966 </xs:appinfo>
11967 </xs:annotation>
11968 <xs:complexType>
11969 <xs:choice minOccurs="0" maxOccurs="unbounded">
11970 <xs:any namespace="##other" processContents="lax">
11971 <xs:annotation>
11972 <xs:documentation>
11973 Extensibility point in the WiX XML Schema. Schema extensions can register additional
11974 elements at this point in the schema.
11975 </xs:documentation>
11976 </xs:annotation>
11977 </xs:any>
11978 </xs:choice>
11979 <xs:attribute name="Condition" type="xs:string">
11980 <xs:annotation>
11981 <xs:documentation>Optional condition that determines whether the control event should be published.</xs:documentation>
11982 </xs:annotation>
11983 </xs:attribute>
11984 <xs:attribute name="Control" type="xs:string">
11985 <xs:annotation>
11986 <xs:documentation>
11987 The parent Control for this Publish element, should only be specified when this element is a child of the UI element.
11988 </xs:documentation>
11989 </xs:annotation>
11990 </xs:attribute>
11991 <xs:attribute name="Dialog" type="xs:string">
11992 <xs:annotation>
11993 <xs:documentation>
11994 The parent Dialog for this Publish element, should only be specified when this element is a child of the UI element.
11995 This attribute will create a reference to the specified Dialog, so an additional DialogRef is not necessary.
11996 </xs:documentation>
11997 </xs:annotation>
11998 </xs:attribute>
11999 <xs:attribute name="Event" type="xs:string">
12000 <xs:annotation>
12001 <xs:documentation>
12002 Set this attribute's value to one of the standard control events to trigger that event.
12003 Either this attribute or the Property attribute must be set, but not both at the same time.
12004 </xs:documentation>
12005 </xs:annotation>
12006 </xs:attribute>
12007 <xs:attribute name="Order" type="xs:string">
12008 <xs:annotation>
12009 <xs:documentation>
12010 This attribute should only need to be set if this element is nested under a UI element in order to
12011 control the order in which this publish event will be started.
12012 If this element is nested under a Control element, the default value will be one greater than any
12013 previous Publish element's order (the first element's default value is 1).
12014 If this element is nested under a UI element, the default value is always 1 (it does not get a
12015 default value based on any previous Publish elements).
12016 </xs:documentation>
12017 </xs:annotation>
12018 </xs:attribute>
12019 <xs:attribute name="Property" type="xs:string">
12020 <xs:annotation>
12021 <xs:documentation>
12022 Set this attribute's value to a property name to set that property.
12023 Either this attribute or the Event attribute must be set, but not both at the same time.
12024 </xs:documentation>
12025 </xs:annotation>
12026 </xs:attribute>
12027 <xs:attribute name="Value" type="xs:string">
12028 <xs:annotation>
12029 <xs:documentation>
12030 If the Property attribute is specified, set the value of this attribute to the new value for the property.
12031 To set a property to null, do not set this attribute (the ControlEvent Argument column will be set to '{}').
12032 Otherwise, this attribute's value should be the argument for the event specified in the Event attribute.
12033 If the event doesn't take an attribute, a common value to use is "0".
12034 </xs:documentation>
12035 </xs:annotation>
12036 </xs:attribute>
12037 <xs:anyAttribute namespace="##other" processContents="lax">
12038 <xs:annotation>
12039 <xs:documentation>
12040 Extensibility point in the WiX XML Schema. Schema extensions can register additional
12041 attributes at this point in the schema.
12042 </xs:documentation>
12043 </xs:annotation>
12044 </xs:anyAttribute>
12045 </xs:complexType>
12046 </xs:element>
12047 <xs:element name="Subscribe">
12048 <xs:annotation>
12049 <xs:documentation>
12050 Sets attributes for events in the EventMapping table
12051 </xs:documentation>
12052 <xs:appinfo>
12053 <xse:msiRef table="EventMapping" href="https://learn.microsoft.com/en-us/windows/win32/msi/eventmapping-table" />
12054 </xs:appinfo>
12055 </xs:annotation>
12056 <xs:complexType>
12057 <xs:choice minOccurs="0" maxOccurs="unbounded">
12058 <xs:any namespace="##other" processContents="lax">
12059 <xs:annotation>
12060 <xs:documentation>
12061 Extensibility point in the WiX XML Schema. Schema extensions can register additional
12062 elements at this point in the schema.
12063 </xs:documentation>
12064 </xs:annotation>
12065 </xs:any>
12066 </xs:choice>
12067 <xs:attribute name="Event" type="xs:string">
12068 <xs:annotation>
12069 <xs:documentation>must be one of the standard control events'</xs:documentation>
12070 </xs:annotation>
12071 </xs:attribute>
12072 <xs:attribute name="Attribute" type="xs:string">
12073 <xs:annotation>
12074 <xs:documentation>if not present can only handle enable, disable, hide, unhide events</xs:documentation>
12075 </xs:annotation>
12076 </xs:attribute>
12077 <xs:anyAttribute namespace="##other" processContents="lax">
12078 <xs:annotation>
12079 <xs:documentation>
12080 Extensibility point in the WiX XML Schema. Schema extensions can register additional
12081 attributes at this point in the schema.
12082 </xs:documentation>
12083 </xs:annotation>
12084 </xs:anyAttribute>
12085 </xs:complexType>
12086 </xs:element>
12087 <xs:element name="Text">
12088 <xs:annotation>
12089 <xs:documentation>
12090 An alternative to using the Text attribute on the Control element.
12091 </xs:documentation>
12092 </xs:annotation>
12093 <xs:complexType>
12094 <xs:attribute name="SourceFile" type="xs:string">
12095 <xs:annotation>
12096 <xs:documentation>
12097 Instructs the text to be imported from a file instead of the element value during the binding process.
12098 Cannot be specified with the Value attribute.
12099 </xs:documentation>
12100 </xs:annotation>
12101 </xs:attribute>
12102 <xs:attribute name="Value" type="xs:string">
12103 <xs:annotation>
12104 <xs:documentation>
12105 The value of the control's text. Cannot be specified with the SourceFile attribute.
12106 </xs:documentation>
12107 </xs:annotation>
12108 </xs:attribute>
12109 <xs:anyAttribute namespace="##other" processContents="lax">
12110 <xs:annotation>
12111 <xs:documentation>
12112 Extensibility point in the WiX XML Schema. Schema extensions can register additional
12113 attributes at this point in the schema.
12114 </xs:documentation>
12115 </xs:annotation>
12116 </xs:anyAttribute>
12117 </xs:complexType>
12118 </xs:element>
12119 <xs:element name="Control">
12120 <xs:annotation>
12121 <xs:appinfo>
12122 <xse:msiRef table="Control" href="https://docs.microsoft.com/en-us/windows/win32/msi/control-table" />
12123 <xse:msiRef table="ComboBox" href="https://docs.microsoft.com/en-us/windows/win32/msi/combobox-table" />
12124 <xse:msiRef table="Dialog" href="https://docs.microsoft.com/en-us/windows/win32/msi/dialog-table" />
12125 <xse:msiRef table="ListBox" href="https://docs.microsoft.com/en-us/windows/win32/msi/listbox-table" />
12126 <xse:msiRef table="ListView" href="https://docs.microsoft.com/en-us/windows/win32/msi/listview-table" />
12127 <xse:msiRef table="RadioButton" href="https://docs.microsoft.com/en-us/windows/win32/msi/radiobutton-table" />
12128 </xs:appinfo>
12129 <xs:documentation>Contains the controls that appear on each dialog.</xs:documentation>
12130 </xs:annotation>
12131 <xs:complexType>
12132 <xs:sequence>
12133 <xs:element ref="Text" minOccurs="0">
12134 <xs:annotation>
12135 <xs:documentation>Alternative to Text attribute.</xs:documentation>
12136 </xs:annotation>
12137 </xs:element>
12138 <xs:element ref="ComboBox" minOccurs="0">
12139 <xs:annotation>
12140 <xs:documentation>ComboBox table with ListItem children</xs:documentation>
12141 </xs:annotation>
12142 </xs:element>
12143 <xs:element ref="ListBox" minOccurs="0">
12144 <xs:annotation>
12145 <xs:documentation>ListBox table with ListItem children</xs:documentation>
12146 </xs:annotation>
12147 </xs:element>
12148 <xs:element ref="ListView" minOccurs="0">
12149 <xs:annotation>
12150 <xs:documentation>ListView table with ListItem children</xs:documentation>
12151 </xs:annotation>
12152 </xs:element>
12153 <xs:element ref="RadioButtonGroup" minOccurs="0">
12154 <xs:annotation>
12155 <xs:documentation>RadioButton table with RadioButton children</xs:documentation>
12156 </xs:annotation>
12157 </xs:element>
12158 <xs:element ref="Property" minOccurs="0">
12159 <xs:annotation>
12160 <xs:documentation>Property table entry for the Property table column associated with this control</xs:documentation>
12161 </xs:annotation>
12162 </xs:element>
12163 <xs:element ref="Binary" minOccurs="0">
12164 <xs:annotation>
12165 <xs:documentation>Icon referenced in icon column of row</xs:documentation>
12166 </xs:annotation>
12167 </xs:element>
12168 <xs:choice minOccurs="0" maxOccurs="unbounded">
12169 <xs:annotation>
12170 <xs:documentation>Child elements affecting operation of this control</xs:documentation>
12171 </xs:annotation>
12172 <xs:element ref="Publish" />
12173 <xs:element ref="Subscribe" />
12174 <xs:any namespace="##other" processContents="lax">
12175 <xs:annotation>
12176 <xs:documentation>
12177 Extensibility point in the WiX XML Schema. Schema extensions can register additional
12178 elements at this point in the schema.
12179 </xs:documentation>
12180 </xs:annotation>
12181 </xs:any>
12182 </xs:choice>
12183 </xs:sequence>
12184 <xs:attribute name="Id" use="required" type="xs:string">
12185 <xs:annotation>
12186 <xs:documentation>Combined with the Dialog Id to make up the primary key of the Control table.</xs:documentation>
12187 </xs:annotation>
12188 </xs:attribute>
12189 <xs:attribute name="Type" use="required" type="xs:string">
12190 <xs:annotation>
12191 <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>
12192 </xs:annotation>
12193 </xs:attribute>
12194 <xs:attribute name="X" use="required" type="LocalizableInteger">
12195 <xs:annotation>
12196 <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>
12197 </xs:annotation>
12198 </xs:attribute>
12199 <xs:attribute name="Y" use="required" type="LocalizableInteger">
12200 <xs:annotation>
12201 <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>
12202 </xs:annotation>
12203 </xs:attribute>
12204 <xs:attribute name="Width" use="required" type="LocalizableInteger">
12205 <xs:annotation>
12206 <xs:documentation>Width of the rectangular boundary of the control. This must be a non-negative number.</xs:documentation>
12207 </xs:annotation>
12208 </xs:attribute>
12209 <xs:attribute name="Height" use="required" type="LocalizableInteger">
12210 <xs:annotation>
12211 <xs:documentation>Height of the rectangular boundary of the control. This must be a non-negative number.</xs:documentation>
12212 </xs:annotation>
12213 </xs:attribute>
12214 <xs:attribute name="Property" type="xs:string">
12215 <xs:annotation>
12216 <xs:documentation>The name of a defined property to be linked to this control. This column is required for active controls.</xs:documentation>
12217 </xs:annotation>
12218 </xs:attribute>
12219 <xs:attribute name="Text" type="xs:string">
12220 <xs:annotation>
12221 <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="https://learn.microsoft.com/en-us/windows/win32/msi/formatted">Formatted</html:a> for details.</xs:documentation>
12222 </xs:annotation>
12223 </xs:attribute>
12224 <xs:attribute name="Help" type="xs:string">
12225 <xs:annotation>
12226 <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>
12227 </xs:annotation>
12228 </xs:attribute>
12229 <xs:attribute name="ToolTip" type="xs:string">
12230 <xs:annotation>
12231 <xs:documentation>The string used for the Tooltip.</xs:documentation>
12232 </xs:annotation>
12233 </xs:attribute>
12234 <xs:attribute name="CheckBoxValue" type="xs:string">
12235 <xs:annotation>
12236 <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>
12237 </xs:annotation>
12238 </xs:attribute>
12239 <xs:attribute name="CheckBoxPropertyRef" type="xs:string">
12240 <xs:annotation>
12241 <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>
12242 </xs:annotation>
12243 </xs:attribute>
12244
12245 <xs:attribute name="TabSkip" type="YesNoTypeUnion">
12246 <xs:annotation>
12247 <xs:documentation>Set this attribute to "yes" to cause this Control to be skipped in the tab sequence.</xs:documentation>
12248 </xs:annotation>
12249 </xs:attribute>
12250 <xs:attribute name="Default" type="YesNoTypeUnion">
12251 <xs:annotation>
12252 <xs:documentation>Set this attribute to "yes" to cause this Control to be invoked by the return key.</xs:documentation>
12253 </xs:annotation>
12254 </xs:attribute>
12255 <xs:attribute name="Cancel" type="YesNoTypeUnion">
12256 <xs:annotation>
12257 <xs:documentation>Set this attribute to "yes" to cause this Control to be invoked by the escape key.</xs:documentation>
12258 </xs:annotation>
12259 </xs:attribute>
12260
12261 <xs:attribute name="DefaultCondition">
12262 <xs:annotation>
12263 <xs:documentation>
12264 When the condition expression evaluates to true, set the Control as the default.
12265 </xs:documentation>
12266 </xs:annotation>
12267 </xs:attribute>
12268 <xs:attribute name="EnableCondition">
12269 <xs:annotation>
12270 <xs:documentation>
12271 When the condition expression evaluates to true, enable the Control.
12272 </xs:documentation>
12273 </xs:annotation>
12274 </xs:attribute>
12275 <xs:attribute name="DisableCondition">
12276 <xs:annotation>
12277 <xs:documentation>
12278 When the condition expression evaluates to true, disable the Control.
12279 </xs:documentation>
12280 </xs:annotation>
12281 </xs:attribute>
12282 <xs:attribute name="HideCondition">
12283 <xs:annotation>
12284 <xs:documentation>
12285 When the condition expression evaluates to true, hide the Control.
12286 </xs:documentation>
12287 </xs:annotation>
12288 </xs:attribute>
12289 <xs:attribute name="ShowCondition">
12290 <xs:annotation>
12291 <xs:documentation>
12292 When the condition expression evaluates to true, show the Control.
12293 </xs:documentation>
12294 </xs:annotation>
12295 </xs:attribute>
12296 <xs:attribute name="Hidden" type="YesNoTypeUnion">
12297 <xs:annotation>
12298 <xs:documentation>Set this attribute to "yes" to cause the Control to be hidden.</xs:documentation>
12299 </xs:annotation>
12300 </xs:attribute>
12301 <xs:attribute name="Disabled" type="YesNoTypeUnion">
12302 <xs:annotation>
12303 <xs:documentation>Set this attribute to "yes" to cause the Control to be disabled.</xs:documentation>
12304 </xs:annotation>
12305 </xs:attribute>
12306 <xs:attribute name="Sunken" type="YesNoTypeUnion">
12307 <xs:annotation>
12308 <xs:documentation>Set this attribute to "yes" to cause the Control to be sunken.</xs:documentation>
12309 </xs:annotation>
12310 </xs:attribute>
12311 <xs:attribute name="Indirect" type="YesNoTypeUnion">
12312 <xs:annotation>
12313 <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>
12314 </xs:annotation>
12315 </xs:attribute>
12316 <xs:attribute name="Integer" type="YesNoTypeUnion">
12317 <xs:annotation>
12318 <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>
12319 </xs:annotation>
12320 </xs:attribute>
12321 <xs:attribute name="RightToLeft" type="YesNoTypeUnion">
12322 <xs:annotation>
12323 <xs:documentation>Set this attribute to "yes" to cause the Control to display from right to left.</xs:documentation>
12324 </xs:annotation>
12325 </xs:attribute>
12326 <xs:attribute name="RightAligned" type="YesNoTypeUnion">
12327 <xs:annotation>
12328 <xs:documentation>Set this attribute to "yes" to cause the Control to be right aligned.</xs:documentation>
12329 </xs:annotation>
12330 </xs:attribute>
12331 <xs:attribute name="LeftScroll" type="YesNoTypeUnion">
12332 <xs:annotation>
12333 <xs:documentation>Set this attribute to "yes" to cause the scroll bar to display on the left side of the Control.</xs:documentation>
12334 </xs:annotation>
12335 </xs:attribute>
12336
12337 <xs:attribute name="Transparent" type="YesNoTypeUnion">
12338 <xs:annotation>
12339 <xs:documentation>This attribute is only valid for Text Controls.</xs:documentation>
12340 </xs:annotation>
12341 </xs:attribute>
12342 <xs:attribute name="NoPrefix" type="YesNoTypeUnion">
12343 <xs:annotation>
12344 <xs:documentation>This attribute is only valid for Text Controls.</xs:documentation>
12345 </xs:annotation>
12346 </xs:attribute>
12347 <xs:attribute name="NoWrap" type="YesNoTypeUnion">
12348 <xs:annotation>
12349 <xs:documentation>This attribute is only valid for Text Controls.</xs:documentation>
12350 </xs:annotation>
12351 </xs:attribute>
12352 <xs:attribute name="FormatSize" type="YesNoTypeUnion">
12353 <xs:annotation>
12354 <xs:documentation>This attribute is only valid for Text Controls.</xs:documentation>
12355 </xs:annotation>
12356 </xs:attribute>
12357 <xs:attribute name="UserLanguage" type="YesNoTypeUnion">
12358 <xs:annotation>
12359 <xs:documentation>This attribute is only valid for Text Controls.</xs:documentation>
12360 </xs:annotation>
12361 </xs:attribute>
12362 <xs:attribute name="Multiline" type="YesNoTypeUnion">
12363 <xs:annotation>
12364 <xs:documentation>This attribute is only valid for Edit Controls.</xs:documentation>
12365 </xs:annotation>
12366 </xs:attribute>
12367 <xs:attribute name="Password" type="YesNoTypeUnion">
12368 <xs:annotation>
12369 <xs:documentation>This attribute is only valid for Edit Controls.</xs:documentation>
12370 </xs:annotation>
12371 </xs:attribute>
12372 <xs:attribute name="ProgressBlocks" type="YesNoTypeUnion">
12373 <xs:annotation>
12374 <xs:documentation>This attribute is only valid for ProgressBar Controls.</xs:documentation>
12375 </xs:annotation>
12376 </xs:attribute>
12377 <xs:attribute name="Removable" type="YesNoTypeUnion">
12378 <xs:annotation>
12379 <xs:documentation>This attribute is only valid for Volume and Directory Controls.</xs:documentation>
12380 </xs:annotation>
12381 </xs:attribute>
12382 <xs:attribute name="Fixed" type="YesNoTypeUnion">
12383 <xs:annotation>
12384 <xs:documentation>This attribute is only valid for Volume and Directory Controls.</xs:documentation>
12385 </xs:annotation>
12386 </xs:attribute>
12387 <xs:attribute name="Remote" type="YesNoTypeUnion">
12388 <xs:annotation>
12389 <xs:documentation>This attribute is only valid for Volume and Directory Controls.</xs:documentation>
12390 </xs:annotation>
12391 </xs:attribute>
12392 <xs:attribute name="CDROM" type="YesNoTypeUnion">
12393 <xs:annotation>
12394 <xs:documentation>This attribute is only valid for Volume and Directory Controls.</xs:documentation>
12395 </xs:annotation>
12396 </xs:attribute>
12397 <xs:attribute name="RAMDisk" type="YesNoTypeUnion">
12398 <xs:annotation>
12399 <xs:documentation>This attribute is only valid for Volume and Directory Controls.</xs:documentation>
12400 </xs:annotation>
12401 </xs:attribute>
12402 <xs:attribute name="Floppy" type="YesNoTypeUnion">
12403 <xs:annotation>
12404 <xs:documentation>This attribute is only valid for Volume and Directory Controls.</xs:documentation>
12405 </xs:annotation>
12406 </xs:attribute>
12407 <xs:attribute name="ShowRollbackCost" type="YesNoTypeUnion">
12408 <xs:annotation>
12409 <xs:documentation>This attribute is only valid for VolumeCostList Controls.</xs:documentation>
12410 </xs:annotation>
12411 </xs:attribute>
12412 <xs:attribute name="Sorted" type="YesNoTypeUnion">
12413 <xs:annotation>
12414 <xs:documentation>
12415 This attribute is only valid for ListBox, ListView, and ComboBox Controls. Set
12416 the value of this attribute to "yes" to have entries appear in the order specified under the Control.
12417 If the attribute value is "no" or absent the entries in the control will appear in alphabetical order.
12418 </xs:documentation>
12419 </xs:annotation>
12420 </xs:attribute>
12421 <xs:attribute name="ComboList" type="YesNoTypeUnion">
12422 <xs:annotation>
12423 <xs:documentation>This attribute is only valid for ComboBox Controls.</xs:documentation>
12424 </xs:annotation>
12425 </xs:attribute>
12426 <xs:attribute name="Image" type="YesNoTypeUnion">
12427 <xs:annotation>
12428 <xs:documentation>This attribute is only valid for RadioButton, PushButton, and Icon Controls.</xs:documentation>
12429 </xs:annotation>
12430 </xs:attribute>
12431 <xs:attribute name="IconSize">
12432 <xs:annotation>
12433 <xs:documentation>This attribute is only valid for RadioButton, PushButton, and Icon Controls.</xs:documentation>
12434 </xs:annotation>
12435 <xs:simpleType>
12436 <xs:restriction base="xs:NMTOKEN">
12437 <xs:enumeration value="16" />
12438 <xs:enumeration value="32" />
12439 <xs:enumeration value="48" />
12440 </xs:restriction>
12441 </xs:simpleType>
12442 </xs:attribute>
12443 <xs:attribute name="FixedSize" type="YesNoTypeUnion">
12444 <xs:annotation>
12445 <xs:documentation>This attribute is only valid for RadioButton, PushButton, and Icon Controls.</xs:documentation>
12446 </xs:annotation>
12447 </xs:attribute>
12448 <xs:attribute name="Icon" type="YesNoTypeUnion">
12449 <xs:annotation>
12450 <xs:documentation>This attribute is only valid for RadioButton and PushButton Controls.</xs:documentation>
12451 </xs:annotation>
12452 </xs:attribute>
12453 <xs:attribute name="Bitmap" type="YesNoTypeUnion">
12454 <xs:annotation>
12455 <xs:documentation>This attribute is only valid for RadioButton and PushButton Controls.</xs:documentation>
12456 </xs:annotation>
12457 </xs:attribute>
12458 <xs:attribute name="PushLike" type="YesNoTypeUnion">
12459 <xs:annotation>
12460 <xs:documentation>This attribute is only valid for RadioButton and Checkbox Controls.</xs:documentation>
12461 </xs:annotation>
12462 </xs:attribute>
12463 <xs:attribute name="HasBorder" type="YesNoTypeUnion">
12464 <xs:annotation>
12465 <xs:documentation>This attribute is only valid for RadioButton Controls.</xs:documentation>
12466 </xs:annotation>
12467 </xs:attribute>
12468 <xs:attribute name="ElevationShield" type="YesNoTypeUnion">
12469 <xs:annotation>
12470 <xs:documentation>
12471 This attribute is only valid for PushButton controls.
12472 Set this attribute to "yes" to add the User Account Control (UAC) elevation icon (shield icon) to the PushButton control.
12473 If this attribute's value is "yes" and the installation is not yet running with elevated privileges,
12474 the pushbutton control is created using the User Account Control (UAC) elevation icon (shield icon).
12475 If this attribute's value is "yes" and the installation is already running with elevated privileges,
12476 the pushbutton control is created using the other icon attributes.
12477 Otherwise, the pushbutton control is created using the other icon attributes.
12478 </xs:documentation>
12479 </xs:annotation>
12480 </xs:attribute>
12481 <xs:anyAttribute namespace="##other" processContents="lax">
12482 <xs:annotation>
12483 <xs:documentation>
12484 Extensibility point in the WiX XML Schema. Schema extensions can register additional
12485 attributes at this point in the schema.
12486 </xs:documentation>
12487 </xs:annotation>
12488 </xs:anyAttribute>
12489 </xs:complexType>
12490 </xs:element>
12491 <xs:element name="Billboard">
12492 <xs:annotation>
12493 <xs:documentation>
12494 Billboard to display during install of a Feature
12495 </xs:documentation>
12496 <xs:appinfo>
12497 <xse:msiRef table="Billboard" href="https://learn.microsoft.com/en-us/windows/win32/msi/billboard-table" />
12498 <xse:msiRef table="BBControl" href="https://learn.microsoft.com/en-us/windows/win32/msi/bbcontrol-table" />
12499 </xs:appinfo>
12500 </xs:annotation>
12501 <xs:complexType>
12502 <xs:sequence>
12503 <xs:element ref="Control" minOccurs="0" maxOccurs="unbounded">
12504 <xs:annotation>
12505 <xs:documentation>Only controls of static type such as: Text, Bitmap, Icon, or custom control can be placed on a billboard.</xs:documentation>
12506 </xs:annotation>
12507 </xs:element>
12508 </xs:sequence>
12509 <xs:attribute name="Id" type="xs:string" use="required">
12510 <xs:annotation>
12511 <xs:documentation>Unique identifier for the Billboard.</xs:documentation>
12512 </xs:annotation>
12513 </xs:attribute>
12514 <xs:attribute name="Feature" type="xs:string">
12515 <xs:annotation>
12516 <xs:documentation>Feature whose state determines if the Billboard is shown.</xs:documentation>
12517 </xs:annotation>
12518 </xs:attribute>
12519 <xs:anyAttribute namespace="##other" processContents="lax">
12520 <xs:annotation>
12521 <xs:documentation>
12522 Extensibility point in the WiX XML Schema. Schema extensions can register additional
12523 attributes at this point in the schema.
12524 </xs:documentation>
12525 </xs:annotation>
12526 </xs:anyAttribute>
12527 </xs:complexType>
12528 </xs:element>
12529 <xs:element name="BillboardAction">
12530 <xs:annotation>
12531 <xs:documentation>
12532 Billboard action during which child Billboards are displayed
12533 </xs:documentation>
12534 <xs:appinfo>
12535 <xse:msiRef table="Billboard" href="https://learn.microsoft.com/en-us/windows/win32/msi/billboard-table" />
12536 <xse:msiRef table="BBControl" href="https://learn.microsoft.com/en-us/windows/win32/msi/bbcontrol-table" />
12537 </xs:appinfo>
12538 </xs:annotation>
12539 <xs:complexType>
12540 <xs:sequence>
12541 <xs:element ref="Billboard" maxOccurs="unbounded">
12542 <xs:annotation>
12543 <xs:documentation>Order of Billboard elements determines order of display</xs:documentation>
12544 </xs:annotation>
12545 </xs:element>
12546 </xs:sequence>
12547 <xs:attribute name="Id" type="xs:string" use="required">
12548 <xs:annotation>
12549 <xs:documentation>Action name that determines when the Billboard should be shown.</xs:documentation>
12550 </xs:annotation>
12551 </xs:attribute>
12552 <xs:anyAttribute namespace="##other" processContents="lax">
12553 <xs:annotation>
12554 <xs:documentation>
12555 Extensibility point in the WiX XML Schema. Schema extensions can register additional
12556 attributes at this point in the schema.
12557 </xs:documentation>
12558 </xs:annotation>
12559 </xs:anyAttribute>
12560 </xs:complexType>
12561 </xs:element>
12562 <xs:element name="Dialog">
12563 <xs:annotation>
12564 <xs:appinfo>
12565 <xse:msiRef table="Control" href="https://docs.microsoft.com/en-us/windows/win32/msi/control-table" />
12566 <xse:msiRef table="ComboBox" href="https://docs.microsoft.com/en-us/windows/win32/msi/combobox-table" />
12567 <xse:msiRef table="Dialog" href="https://docs.microsoft.com/en-us/windows/win32/msi/dialog-table" />
12568 <xse:msiRef table="ListBox" href="https://docs.microsoft.com/en-us/windows/win32/msi/listbox-table" />
12569 <xse:msiRef table="ListView" href="https://docs.microsoft.com/en-us/windows/win32/msi/listview-table" />
12570 <xse:msiRef table="RadioButton" href="https://docs.microsoft.com/en-us/windows/win32/msi/radiobutton-table" />
12571 </xs:appinfo>
12572 <xs:documentation>
12573 Defines a dialog box in the Dialog Table.
12574 </xs:documentation>
12575 </xs:annotation>
12576 <xs:complexType>
12577 <xs:choice minOccurs="0" maxOccurs="unbounded">
12578 <xs:element ref="Control">
12579 <xs:annotation>
12580 <xs:documentation>Control elements belonging to this dialog.</xs:documentation>
12581 </xs:annotation>
12582 </xs:element>
12583 <xs:any namespace="##other" processContents="lax">
12584 <xs:annotation>
12585 <xs:documentation>
12586 Extensibility point in the WiX XML Schema. Schema extensions can register additional
12587 elements at this point in the schema.
12588 </xs:documentation>
12589 </xs:annotation>
12590 </xs:any>
12591 </xs:choice>
12592 <xs:attribute name="Id" type="xs:string" use="required">
12593 <xs:annotation>
12594 <xs:documentation>Unique identifier for the dialog.</xs:documentation>
12595 </xs:annotation>
12596 </xs:attribute>
12597 <xs:attribute name="X" type="Integer">
12598 <xs:annotation>
12599 <xs:documentation>Horizontal placement of the dialog box as a percentage of screen width. The default value is 50.</xs:documentation>
12600 </xs:annotation>
12601 </xs:attribute>
12602 <xs:attribute name="Y" type="Integer">
12603 <xs:annotation>
12604 <xs:documentation>Vertical placement of the dialog box as a percentage of screen height. The default value is 50.</xs:documentation>
12605 </xs:annotation>
12606 </xs:attribute>
12607 <xs:attribute name="Width" use="required" type="Integer">
12608 <xs:annotation>
12609 <xs:documentation>The width of the dialog box in dialog units.</xs:documentation>
12610 </xs:annotation>
12611 </xs:attribute>
12612 <xs:attribute name="Height" use="required" type="Integer">
12613 <xs:annotation>
12614 <xs:documentation>The height of the dialog box in dialog units.</xs:documentation>
12615 </xs:annotation>
12616 </xs:attribute>
12617 <xs:attribute name="Title" type="xs:string">
12618 <xs:annotation>
12619 <xs:documentation>The title of the dialog box.</xs:documentation>
12620 </xs:annotation>
12621 </xs:attribute>
12622
12623 <xs:attribute name="Hidden" type="YesNoTypeUnion">
12624 <xs:annotation>
12625 <xs:documentation>Used to hide the dialog.</xs:documentation>
12626 </xs:annotation>
12627 </xs:attribute>
12628 <xs:attribute name="Modeless" type="YesNoTypeUnion">
12629 <xs:annotation>
12630 <xs:documentation>Used to set the dialog as modeless.</xs:documentation>
12631 </xs:annotation>
12632 </xs:attribute>
12633 <xs:attribute name="NoMinimize" type="YesNoTypeUnion">
12634 <xs:annotation>
12635 <xs:documentation>Used to specify if the dialog can be minimized.</xs:documentation>
12636 </xs:annotation>
12637 </xs:attribute>
12638 <xs:attribute name="SystemModal" type="YesNoTypeUnion">
12639 <xs:annotation>
12640 <xs:documentation>Used to set the dialog as system modal.</xs:documentation>
12641 </xs:annotation>
12642 </xs:attribute>
12643 <xs:attribute name="KeepModeless" type="YesNoTypeUnion">
12644 <xs:annotation>
12645 <xs:documentation>Keep modeless dialogs alive when this dialog is created through DoAction.</xs:documentation>
12646 </xs:annotation>
12647 </xs:attribute>
12648 <xs:attribute name="TrackDiskSpace" type="YesNoTypeUnion">
12649 <xs:annotation>
12650 <xs:documentation>Have the dialog periodically call the installer to check if available disk space has changed.</xs:documentation>
12651 </xs:annotation>
12652 </xs:attribute>
12653 <xs:attribute name="CustomPalette" type="YesNoTypeUnion">
12654 <xs:annotation>
12655 <xs:documentation>Used to specify if pictures in the dialog box are rendered with a custom palette.</xs:documentation>
12656 </xs:annotation>
12657 </xs:attribute>
12658 <xs:attribute name="RightToLeft" type="YesNoTypeUnion">
12659 <xs:annotation>
12660 <xs:documentation>Used to specify if the text in the dialog should be displayed in right to left reading order.</xs:documentation>
12661 </xs:annotation>
12662 </xs:attribute>
12663 <xs:attribute name="RightAligned" type="YesNoTypeUnion">
12664 <xs:annotation>
12665 <xs:documentation>Align text on the right.</xs:documentation>
12666 </xs:annotation>
12667 </xs:attribute>
12668 <xs:attribute name="LeftScroll" type="YesNoTypeUnion">
12669 <xs:annotation>
12670 <xs:documentation>Used to align the scroll bar on the left.</xs:documentation>
12671 </xs:annotation>
12672 </xs:attribute>
12673 <xs:attribute name="ErrorDialog" type="YesNoTypeUnion">
12674 <xs:annotation>
12675 <xs:documentation>Specifies this dialog as an error dialog.</xs:documentation>
12676 </xs:annotation>
12677 </xs:attribute>
12678 <xs:anyAttribute namespace="##other" processContents="lax">
12679 <xs:annotation>
12680 <xs:documentation>
12681 Extensibility point in the WiX XML Schema. Schema extensions can register additional
12682 attributes at this point in the schema.
12683 </xs:documentation>
12684 </xs:annotation>
12685 </xs:anyAttribute>
12686 </xs:complexType>
12687 </xs:element>
12688 <xs:element name="DialogRef">
12689 <xs:annotation>
12690 <xs:appinfo>
12691 <xse:seeAlso ref="Dialog" />
12692 </xs:appinfo>
12693 <xs:documentation>
12694 Reference to a Dialog. This will cause the entire referenced section's contents
12695 to be included in the installer database.
12696 </xs:documentation>
12697 </xs:annotation>
12698 <xs:complexType>
12699 <xs:attribute name="Id" type="xs:string" use="required">
12700 <xs:annotation>
12701 <xs:documentation>The identifier of the Dialog to reference.</xs:documentation>
12702 </xs:annotation>
12703 </xs:attribute>
12704 <xs:anyAttribute namespace="##other" processContents="lax">
12705 <xs:annotation>
12706 <xs:documentation>
12707 Extensibility point in the WiX XML Schema. Schema extensions can register additional
12708 attributes at this point in the schema.
12709 </xs:documentation>
12710 </xs:annotation>
12711 </xs:anyAttribute>
12712 </xs:complexType>
12713 </xs:element>
12714 <xs:element name="ProgressText">
12715 <xs:annotation>
12716 <xs:appinfo>
12717 <xse:msiRef table="ActionText" href="https://learn.microsoft.com/en-us/windows/win32/msi/actiontext-table" />
12718 </xs:appinfo>
12719 </xs:annotation>
12720 <xs:complexType>
12721 <xs:attribute name="Action" type="xs:string" use="required" />
12722 <xs:attribute name="Message" type="xs:string">
12723 <xs:annotation>
12724 <xs:documentation>Element value is progress message text for action.</xs:documentation>
12725 </xs:annotation>
12726 </xs:attribute>
12727 <xs:attribute name="Template" type="xs:string">
12728 <xs:annotation>
12729 <xs:documentation>Used to format ActionData messages from action processing</xs:documentation>
12730 </xs:annotation>
12731 </xs:attribute>
12732 </xs:complexType>
12733 </xs:element>
12734 <xs:element name="TextStyle">
12735 <xs:annotation>
12736 <xs:appinfo>
12737 <xse:msiRef table="TextStyle" href="https://docs.microsoft.com/en-us/windows/win32/msi/textstyle-table" />
12738 </xs:appinfo>
12739 </xs:annotation>
12740 <xs:complexType>
12741 <xs:attribute name="Id" type="xs:string">
12742 <xs:annotation>
12743 <xs:documentation>
12744 An optional identifier for the text style in the database. If one is not specified,
12745 one will be generated.
12746 </xs:documentation>
12747 </xs:annotation>
12748 </xs:attribute>
12749 <xs:attribute name="FaceName" use="required" type="xs:string">
12750 <xs:annotation>
12751 <xs:documentation>The face name of the font.</xs:documentation>
12752 </xs:annotation>
12753 </xs:attribute>
12754 <xs:attribute name="Size" use="required" type="xs:string">
12755 <xs:annotation>
12756 <xs:documentation>The font's size.</xs:documentation>
12757 </xs:annotation>
12758 </xs:attribute>
12759 <xs:attribute name="Red" type="Integer">
12760 <xs:annotation>
12761 <xs:documentation>A value from 0 to 255 to indicate the amount of red in the font.</xs:documentation>
12762 </xs:annotation>
12763 </xs:attribute>
12764 <xs:attribute name="Green" type="Integer">
12765 <xs:annotation>
12766 <xs:documentation>A value from 0 to 255 to indicate the amount of green in the font.</xs:documentation>
12767 </xs:annotation>
12768 </xs:attribute>
12769 <xs:attribute name="Blue" type="Integer">
12770 <xs:annotation>
12771 <xs:documentation>A value from 0 to 255 to indicate the amount of blue in the font.</xs:documentation>
12772 </xs:annotation>
12773 </xs:attribute>
12774 <xs:attribute name="Bold" type="YesNoTypeUnion">
12775 <xs:annotation>
12776 <xs:documentation>Indicates whether the font should be bold. Default is 'false'.</xs:documentation>
12777 </xs:annotation>
12778 </xs:attribute>
12779 <xs:attribute name="Italic" type="YesNoTypeUnion">
12780 <xs:annotation>
12781 <xs:documentation>Indicates whether the font should be italic. Default is 'false'.</xs:documentation>
12782 </xs:annotation>
12783 </xs:attribute>
12784 <xs:attribute name="Underline" type="YesNoTypeUnion">
12785 <xs:annotation>
12786 <xs:documentation>Indicates whether the font should be underline. Default is 'false'.</xs:documentation>
12787 </xs:annotation>
12788 </xs:attribute>
12789 <xs:attribute name="Strike" type="YesNoTypeUnion">
12790 <xs:annotation>
12791 <xs:documentation>Indicates whether the font should be strikethrough. Default is 'false'.</xs:documentation>
12792 </xs:annotation>
12793 </xs:attribute>
12794 <xs:anyAttribute namespace="##other" processContents="lax">
12795 <xs:annotation>
12796 <xs:documentation>
12797 Extensibility point in the WiX XML Schema. Schema extensions can register additional
12798 attributes at this point in the schema.
12799 </xs:documentation>
12800 </xs:annotation>
12801 </xs:anyAttribute>
12802 </xs:complexType>
12803 </xs:element>
12804 <xs:element name="ListItem">
12805 <xs:annotation>
12806 <xs:documentation>
12807 The value (and optional text) associated with an item in a ComboBox, ListBox, or ListView.
12808 </xs:documentation>
12809 <xs:appinfo>
12810 <xse:msiRef table="ComboBox" href="https://docs.microsoft.com/en-us/windows/win32/msi/combobox-table" />
12811 <xse:msiRef table="ListBox" href="https://docs.microsoft.com/en-us/windows/win32/msi/listbox-table" />
12812 <xse:msiRef table="ListView" href="https://docs.microsoft.com/en-us/windows/win32/msi/listview-table" />
12813 </xs:appinfo>
12814 </xs:annotation>
12815 <xs:complexType>
12816 <xs:attribute name="Value" type="xs:string" use="required">
12817 <xs:annotation>
12818 <xs:documentation>
12819 The value assigned to the associated ComboBox, ListBox, or ListView property if this item is selected.
12820 </xs:documentation>
12821 </xs:annotation>
12822 </xs:attribute>
12823 <xs:attribute name="Text" type="xs:string">
12824 <xs:annotation>
12825 <xs:documentation>
12826 The localizable, visible text to be assigned to the item.
12827 If not specified, this will default to the value of the Value attribute.
12828 </xs:documentation>
12829 </xs:annotation>
12830 </xs:attribute>
12831 <xs:attribute name="Icon" type="xs:string">
12832 <xs:annotation>
12833 <xs:documentation>
12834 The identifier of the Binary (not Icon) element containing the icon to associate with this item.
12835 This value is only valid when nested under a ListView element.
12836 </xs:documentation>
12837 </xs:annotation>
12838 </xs:attribute>
12839 <xs:anyAttribute namespace="##other" processContents="lax">
12840 <xs:annotation>
12841 <xs:documentation>
12842 Extensibility point in the WiX XML Schema. Schema extensions can register additional
12843 attributes at this point in the schema.
12844 </xs:documentation>
12845 </xs:annotation>
12846 </xs:anyAttribute>
12847 </xs:complexType>
12848 </xs:element>
12849 <xs:element name="ListBox">
12850 <xs:annotation>
12851 <xs:documentation>
12852 Set of items for a particular ListBox control tied to an install Property
12853 </xs:documentation>
12854 <xs:appinfo>
12855 <xse:msiRef table="Control" href="https://docs.microsoft.com/en-us/windows/win32/msi/control-table" />
12856 <xse:msiRef table="Dialog" href="https://docs.microsoft.com/en-us/windows/win32/msi/dialog-table" />
12857 <xse:msiRef table="ListView" href="https://docs.microsoft.com/en-us/windows/win32/msi/listview-table" />
12858 </xs:appinfo>
12859 </xs:annotation>
12860 <xs:complexType>
12861 <xs:choice minOccurs="0" maxOccurs="unbounded">
12862 <xs:element ref="ListItem">
12863 <xs:annotation>
12864 <xs:documentation>entry for ListBox table</xs:documentation>
12865 </xs:annotation>
12866 </xs:element>
12867 </xs:choice>
12868 <xs:attribute name="Property" use="required" type="xs:string">
12869 <xs:annotation>
12870 <xs:documentation>Property tied to this group</xs:documentation>
12871 </xs:annotation>
12872 </xs:attribute>
12873 <xs:anyAttribute namespace="##other" processContents="lax">
12874 <xs:annotation>
12875 <xs:documentation>
12876 Extensibility point in the WiX XML Schema. Schema extensions can register additional
12877 attributes at this point in the schema.
12878 </xs:documentation>
12879 </xs:annotation>
12880 </xs:anyAttribute>
12881 </xs:complexType>
12882 </xs:element>
12883 <xs:element name="ComboBox">
12884 <xs:annotation>
12885 <xs:documentation>
12886 Set of items for a particular ComboBox control tied to an install Property
12887 </xs:documentation>
12888 <xs:appinfo>
12889 <xse:msiRef table="ComboBox" href="https://docs.microsoft.com/en-us/windows/win32/msi/combobox-table" />
12890 <xse:msiRef table="Control" href="https://docs.microsoft.com/en-us/windows/win32/msi/control-table" />
12891 <xse:msiRef table="Dialog" href="https://docs.microsoft.com/en-us/windows/win32/msi/dialog-table" />
12892 </xs:appinfo>
12893 </xs:annotation>
12894 <xs:complexType>
12895 <xs:choice minOccurs="0" maxOccurs="unbounded">
12896 <xs:element ref="ListItem">
12897 <xs:annotation>
12898 <xs:documentation>entry for ComboBox table</xs:documentation>
12899 </xs:annotation>
12900 </xs:element>
12901 </xs:choice>
12902 <xs:attribute name="Property" use="required" type="xs:string">
12903 <xs:annotation>
12904 <xs:documentation>Property tied to this group</xs:documentation>
12905 </xs:annotation>
12906 </xs:attribute>
12907 <xs:anyAttribute namespace="##other" processContents="lax">
12908 <xs:annotation>
12909 <xs:documentation>
12910 Extensibility point in the WiX XML Schema. Schema extensions can register additional
12911 attributes at this point in the schema.
12912 </xs:documentation>
12913 </xs:annotation>
12914 </xs:anyAttribute>
12915 </xs:complexType>
12916 </xs:element>
12917 <xs:element name="ListView">
12918 <xs:annotation>
12919 <xs:documentation>
12920 Set of items for a particular ListView control tied to an install Property
12921 </xs:documentation>
12922 <xs:appinfo>
12923 <xse:msiRef table="ListView" href="https://docs.microsoft.com/en-us/windows/win32/msi/listview-table" />
12924 <xse:msiRef table="Control" href="https://docs.microsoft.com/en-us/windows/win32/msi/control-table" />
12925 <xse:msiRef table="Dialog" href="https://docs.microsoft.com/en-us/windows/win32/msi/dialog-table" />
12926 </xs:appinfo>
12927 </xs:annotation>
12928 <xs:complexType>
12929 <xs:choice minOccurs="0" maxOccurs="unbounded">
12930 <xs:element ref="ListItem">
12931 <xs:annotation>
12932 <xs:documentation>entry for ListView table</xs:documentation>
12933 </xs:annotation>
12934 </xs:element>
12935 </xs:choice>
12936 <xs:attribute name="Property" use="required" type="xs:string">
12937 <xs:annotation>
12938 <xs:documentation>Property tied to this group</xs:documentation>
12939 </xs:annotation>
12940 </xs:attribute>
12941 <xs:anyAttribute namespace="##other" processContents="lax">
12942 <xs:annotation>
12943 <xs:documentation>
12944 Extensibility point in the WiX XML Schema. Schema extensions can register additional
12945 attributes at this point in the schema.
12946 </xs:documentation>
12947 </xs:annotation>
12948 </xs:anyAttribute>
12949 </xs:complexType>
12950 </xs:element>
12951 <xs:element name="RadioButton">
12952 <xs:annotation>
12953 <xs:appinfo>
12954 <xse:seeAlso ref="RadioButtonGroup" />
12955 <xse:msiRef table="RadioButton" href="https://docs.microsoft.com/en-us/windows/win32/msi/radiobutton-table" />
12956 <xse:msiRef table="Control" href="https://docs.microsoft.com/en-us/windows/win32/msi/control-table" />
12957 <xse:msiRef table="Dialog" href="https://docs.microsoft.com/en-us/windows/win32/msi/dialog-table" />
12958 </xs:appinfo>
12959 <xs:documentation>Text or Icon plus Value that is assigned to the Property of the parent Control (RadioButtonGroup).</xs:documentation>
12960 </xs:annotation>
12961 <xs:complexType>
12962 <xs:attribute name="Bitmap" type="xs:string">
12963 <xs:annotation>
12964 <xs:documentation>
12965 This attribute defines the bitmap displayed with the radio button. The value of the attribute creates a reference
12966 to a Binary element that represents the bitmap. This attribute is mutually exclusive with the Icon and Text
12967 attributes.
12968 </xs:documentation>
12969 </xs:annotation>
12970 </xs:attribute>
12971 <xs:attribute name="Height" use="required" type="LocalizableInteger" />
12972 <xs:attribute name="Help" type="xs:string" />
12973 <xs:attribute name="Icon" type="xs:string">
12974 <xs:annotation>
12975 <xs:documentation>
12976 This attribute defines the icon displayed with the radio button. The value of the attribute creates a reference
12977 to a Binary element that represents the icon. This attribute is mutually exclusive with the Bitmap and Text
12978 attributes.
12979 </xs:documentation>
12980 </xs:annotation>
12981 </xs:attribute>
12982 <xs:attribute name="Text" type="xs:string">
12983 <xs:annotation>
12984 <xs:documentation>Text displayed with the radio button. This attribute is mutually exclusive with the Bitmap and Icon attributes.</xs:documentation>
12985 </xs:annotation>
12986 </xs:attribute>
12987 <xs:attribute name="ToolTip" type="xs:string" />
12988 <xs:attribute name="Value" type="xs:string" use="required">
12989 <xs:annotation>
12990 <xs:documentation>Value assigned to the associated control Property when this radio button is selected.</xs:documentation>
12991 </xs:annotation>
12992 </xs:attribute>
12993 <xs:attribute name="Width" use="required" type="LocalizableInteger" />
12994 <xs:attribute name="X" use="required" type="LocalizableInteger" />
12995 <xs:attribute name="Y" use="required" type="LocalizableInteger" />
12996 <xs:anyAttribute namespace="##other" processContents="lax">
12997 <xs:annotation>
12998 <xs:documentation>
12999 Extensibility point in the WiX XML Schema. Schema extensions can register additional
13000 attributes at this point in the schema.
13001 </xs:documentation>
13002 </xs:annotation>
13003 </xs:anyAttribute>
13004 </xs:complexType>
13005 </xs:element>
13006 <xs:element name="RadioButtonGroup">
13007 <xs:annotation>
13008 <xs:documentation>
13009 Set of radio buttons tied to the specified Property
13010 </xs:documentation>
13011 <xs:appinfo>
13012 <xse:msiRef table="RadioButton" href="https://docs.microsoft.com/en-us/windows/win32/msi/radiobutton-table" />
13013 <xse:msiRef table="Control" href="https://docs.microsoft.com/en-us/windows/win32/msi/control-table" />
13014 <xse:msiRef table="Dialog" href="https://docs.microsoft.com/en-us/windows/win32/msi/dialog-table" />
13015 </xs:appinfo>
13016 </xs:annotation>
13017 <xs:complexType>
13018 <xs:sequence>
13019 <xs:element ref="RadioButton" maxOccurs="unbounded" />
13020 </xs:sequence>
13021 <xs:attribute name="Property" use="required" type="xs:string">
13022 <xs:annotation>
13023 <xs:documentation>Property tied to this group.</xs:documentation>
13024 </xs:annotation>
13025 </xs:attribute>
13026 <xs:anyAttribute namespace="##other" processContents="lax">
13027 <xs:annotation>
13028 <xs:documentation>
13029 Extensibility point in the WiX XML Schema. Schema extensions can register additional
13030 attributes at this point in the schema.
13031 </xs:documentation>
13032 </xs:annotation>
13033 </xs:anyAttribute>
13034 </xs:complexType>
13035 </xs:element>
13036 <xs:element name="UIText">
13037 <xs:annotation>
13038 <xs:documentation>
13039 Text associated with certain controls.
13040 </xs:documentation>
13041 <xs:appinfo>
13042 <xse:msiRef table="UIText" href="https://docs.microsoft.com/en-us/windows/win32/msi/uitext-table" />
13043 </xs:appinfo>
13044 </xs:annotation>
13045 <xs:complexType>
13046 <xs:attribute name="Id" type="xs:string">
13047 <xs:annotation>
13048 <xs:documentation>
13049 An optional identifier for the text style in the database. If one is not specified,
13050 one will be generated.
13051 </xs:documentation>
13052 </xs:annotation>
13053 </xs:attribute>
13054 <xs:attribute name="Value" type="xs:string">
13055 <xs:annotation>
13056 <xs:documentation>The UI text.</xs:documentation>
13057 </xs:annotation>
13058 </xs:attribute>
13059 <xs:anyAttribute namespace="##other" processContents="lax">
13060 <xs:annotation>
13061 <xs:documentation>
13062 Extensibility point in the WiX XML Schema. Schema extensions can register additional
13063 attributes at this point in the schema.
13064 </xs:documentation>
13065 </xs:annotation>
13066 </xs:anyAttribute>
13067 </xs:complexType>
13068 </xs:element>
13069 <xs:element name="UIRef">
13070 <xs:annotation>
13071 <xs:documentation>
13072 Reference to a UI element. This will force the entire referenced Fragment's contents
13073 to be included in the installer database.
13074 </xs:documentation>
13075 <xs:appinfo>
13076 <xse:seeAlso ref="UI" />
13077 </xs:appinfo>
13078 </xs:annotation>
13079 <xs:complexType>
13080 <xs:attribute name="Id" type="xs:string" use="required" />
13081 <xs:anyAttribute namespace="##other" processContents="lax">
13082 <xs:annotation>
13083 <xs:documentation>
13084 Extensibility point in the WiX XML Schema. Schema extensions can register additional
13085 attributes at this point in the schema.
13086 </xs:documentation>
13087 </xs:annotation>
13088 </xs:anyAttribute>
13089 </xs:complexType>
13090 </xs:element>
13091 <xs:element name="UI">
13092 <xs:annotation>
13093 <xs:documentation>
13094 Enclosing element to compartmentalize UI specifications.
13095 </xs:documentation>
13096 <xs:appinfo>
13097 <xse:seeAlso ref="UIRef" />
13098 </xs:appinfo>
13099 </xs:annotation>
13100 <xs:complexType>
13101 <xs:choice minOccurs="0" maxOccurs="unbounded">
13102 <xs:element ref="BillboardAction" />
13103 <xs:element ref="ComboBox" />
13104 <xs:element ref="Dialog" />
13105 <xs:element ref="DialogRef" />
13106 <xs:element ref="EmbeddedUI" />
13107 <xs:element ref="Error" />
13108 <xs:element ref="ListBox" />
13109 <xs:element ref="ListView"/>
13110 <xs:element ref="ProgressText"/>
13111 <xs:element ref="Publish" />
13112 <xs:element ref="RadioButtonGroup"/>
13113 <xs:element ref="TextStyle" />
13114 <xs:element ref="UIText"/>
13115 <!--
13116 Elements with identical behavior as under Package/Fragment element, solely to allow grouping with other UI elements
13117 -->
13118 <xs:element ref="AdminUISequence" />
13119 <xs:element ref="InstallUISequence" />
13120 <xs:element ref="Binary" />
13121 <xs:element ref="Property" />
13122 <xs:element ref="PropertyRef" />
13123 <xs:element ref="UIRef" />
13124 <xs:any namespace="##other" processContents="lax">
13125 <xs:annotation>
13126 <xs:documentation>
13127 Extensibility point in the WiX XML Schema. Schema extensions can register additional
13128 elements at this point in the schema.
13129 </xs:documentation>
13130 </xs:annotation>
13131 </xs:any>
13132 </xs:choice>
13133 <xs:attribute name="Id" type="xs:string" />
13134 <xs:anyAttribute namespace="##other" processContents="lax">
13135 <xs:annotation>
13136 <xs:documentation>
13137 Extensibility point in the WiX XML Schema. Schema extensions can register additional
13138 attributes at this point in the schema.
13139 </xs:documentation>
13140 </xs:annotation>
13141 </xs:anyAttribute>
13142 </xs:complexType>
13143 </xs:element>
13144
13145 <xs:element name="CustomTable">
13146 <xs:annotation>
13147 <xs:documentation>Defines a custom table for use from a custom action.</xs:documentation>
13148 </xs:annotation>
13149 <xs:complexType>
13150 <xs:choice maxOccurs="unbounded">
13151 <xs:element ref="Column">
13152 <xs:annotation>
13153 <xs:documentation>Column definition for the custom table.</xs:documentation>
13154 </xs:annotation>
13155 </xs:element>
13156 <xs:element ref="Row">
13157 <xs:annotation>
13158 <xs:documentation>Row definition for the custom table.</xs:documentation>
13159 </xs:annotation>
13160 </xs:element>
13161 <xs:any namespace="##other" processContents="lax">
13162 <xs:annotation>
13163 <xs:documentation>
13164 Extensibility point in the WiX XML Schema. Schema extensions can register additional
13165 elements at this point in the schema.
13166 </xs:documentation>
13167 </xs:annotation>
13168 </xs:any>
13169 </xs:choice>
13170 <xs:attribute name="Id" type="xs:string" use="required">
13171 <xs:annotation>
13172 <xs:documentation>Identifier for the custom table. The id must be less than 31 characters.</xs:documentation>
13173 </xs:annotation>
13174 </xs:attribute>
13175 <xs:attribute name="Unreal" type="YesNoType">
13176 <xs:annotation>
13177 <xs:documentation>Indicates the table is not supposed to be included in the final output.</xs:documentation>
13178 </xs:annotation>
13179 </xs:attribute>
13180 <xs:anyAttribute namespace="##other" processContents="lax">
13181 <xs:annotation>
13182 <xs:documentation>
13183 Extensibility point in the WiX XML Schema. Schema extensions can register additional
13184 attributes at this point in the schema.
13185 </xs:documentation>
13186 </xs:annotation>
13187 </xs:anyAttribute>
13188 </xs:complexType>
13189 </xs:element>
13190 <xs:element name="Column">
13191 <xs:annotation>
13192 <xs:documentation>Column definition for a Custom Table</xs:documentation>
13193 </xs:annotation>
13194 <xs:complexType>
13195 <xs:choice minOccurs="0" maxOccurs="unbounded">
13196 <xs:any namespace="##other" processContents="lax">
13197 <xs:annotation>
13198 <xs:documentation>
13199 Extensibility point in the WiX XML Schema. Schema extensions can register additional
13200 elements at this point in the schema.
13201 </xs:documentation>
13202 </xs:annotation>
13203 </xs:any>
13204 </xs:choice>
13205 <xs:attribute name="Id" type="xs:string" use="required">
13206 <xs:annotation>
13207 <xs:documentation>Identifier for the column.</xs:documentation>
13208 </xs:annotation>
13209 </xs:attribute>
13210 <xs:attribute name="PrimaryKey" type="YesNoTypeUnion">
13211 <xs:annotation>
13212 <xs:documentation>Whether this column is a primary key.</xs:documentation>
13213 </xs:annotation>
13214 </xs:attribute>
13215 <xs:attribute name="Type" use="required">
13216 <xs:annotation>
13217 <xs:documentation>The type of this column.</xs:documentation>
13218 </xs:annotation>
13219 <xs:simpleType>
13220 <xs:restriction base="xs:NMTOKEN">
13221 <xs:enumeration value="binary">
13222 <xs:annotation>
13223 <xs:documentation>
13224 Column contains a path to a file that will be inserted into the column as a binary object.
13225 If this value is set, the Category attribute must also be set with a value of 'Binary' to pass ICE validation.
13226 </xs:documentation>
13227 </xs:annotation>
13228 </xs:enumeration>
13229 <xs:enumeration value="int">
13230 <xs:annotation>
13231 <xs:documentation>
13232 Column contains an integer or datetime value (the MinValue and MaxValue attributes should also be set).
13233 </xs:documentation>
13234 </xs:annotation>
13235 </xs:enumeration>
13236 <xs:enumeration value="string">
13237 <xs:annotation>
13238 <xs:documentation>
13239 Column contains a non-localizable string value.
13240 </xs:documentation>
13241 </xs:annotation>
13242 </xs:enumeration>
13243 </xs:restriction>
13244 </xs:simpleType>
13245 </xs:attribute>
13246 <xs:attribute name="Width" type="Integer">
13247 <xs:annotation>
13248 <xs:documentation>Width of this column.</xs:documentation>
13249 </xs:annotation>
13250 </xs:attribute>
13251 <xs:attribute name="Nullable" type="YesNoTypeUnion">
13252 <xs:annotation>
13253 <xs:documentation>Whether this column can be left null.</xs:documentation>
13254 </xs:annotation>
13255 </xs:attribute>
13256 <xs:attribute name="Localizable" type="YesNoTypeUnion">
13257 <xs:annotation>
13258 <xs:documentation>Whether this column can be localized.</xs:documentation>
13259 </xs:annotation>
13260 </xs:attribute>
13261 <xs:attribute name="MinValue" type="xs:long">
13262 <xs:annotation>
13263 <xs:documentation>Minimum value for a numeric value, date or version in this column.</xs:documentation>
13264 </xs:annotation>
13265 </xs:attribute>
13266 <xs:attribute name="MaxValue" type="xs:long">
13267 <xs:annotation>
13268 <xs:documentation>Maximum value for a numeric value, date or version in this column.</xs:documentation>
13269 </xs:annotation>
13270 </xs:attribute>
13271 <xs:attribute name="KeyTable" type="xs:string">
13272 <xs:annotation>
13273 <xs:documentation>Table in which this column is an external key. Can be semicolon delimited.</xs:documentation>
13274 </xs:annotation>
13275 </xs:attribute>
13276 <xs:attribute name="KeyColumn" type="Integer">
13277 <xs:annotation>
13278 <xs:documentation>Column in the table in KeyTable attribute.</xs:documentation>
13279 </xs:annotation>
13280 </xs:attribute>
13281 <xs:attribute name="Category">
13282 <xs:annotation>
13283 <xs:documentation>
13284 Category of this column.
13285 This attribute must be specified with a value of 'Binary' if the Type attribute's value is 'binary'.
13286 </xs:documentation>
13287 </xs:annotation>
13288 <xs:simpleType>
13289 <xs:restriction base="xs:NMTOKEN">
13290 <xs:enumeration value="text" />
13291 <xs:enumeration value="upperCase" />
13292 <xs:enumeration value="lowerCase" />
13293 <xs:enumeration value="integer" />
13294 <xs:enumeration value="doubleInteger" />
13295 <xs:enumeration value="timeDate" />
13296 <xs:enumeration value="identifier" />
13297 <xs:enumeration value="property" />
13298 <xs:enumeration value="filename" />
13299 <xs:enumeration value="wildCardFilename" />
13300 <xs:enumeration value="path" />
13301 <xs:enumeration value="paths" />
13302 <xs:enumeration value="anyPath" />
13303 <xs:enumeration value="defaultDir" />
13304 <xs:enumeration value="regPath" />
13305 <xs:enumeration value="formatted" />
13306 <xs:enumeration value="formattedSddl" />
13307 <xs:enumeration value="template" />
13308 <xs:enumeration value="condition" />
13309 <xs:enumeration value="guid" />
13310 <xs:enumeration value="version" />
13311 <xs:enumeration value="language" />
13312 <xs:enumeration value="binary" />
13313 <xs:enumeration value="customSource" />
13314 <xs:enumeration value="cabinet" />
13315 <xs:enumeration value="shortcut" />
13316 </xs:restriction>
13317 </xs:simpleType>
13318 </xs:attribute>
13319 <xs:attribute name="Set" type="xs:string">
13320 <xs:annotation>
13321 <xs:documentation>Semicolon delimited list of permissible values.</xs:documentation>
13322 </xs:annotation>
13323 </xs:attribute>
13324 <xs:attribute name="Description" type="xs:string">
13325 <xs:annotation>
13326 <xs:documentation>Description of this column.</xs:documentation>
13327 </xs:annotation>
13328 </xs:attribute>
13329 <xs:attribute name="Modularize">
13330 <xs:annotation>
13331 <xs:documentation>How this column should be modularized, if at all.</xs:documentation>
13332 </xs:annotation>
13333 <xs:simpleType>
13334 <xs:restriction base="xs:NMTOKEN">
13335 <xs:enumeration value="none">
13336 <xs:annotation>
13337 <xs:documentation>
13338 Column should not be modularized. This is the default value.
13339 </xs:documentation>
13340 </xs:annotation>
13341 </xs:enumeration>
13342 <xs:enumeration value="column">
13343 <xs:annotation>
13344 <xs:documentation>
13345 Column should be modularized.
13346 </xs:documentation>
13347 </xs:annotation>
13348 </xs:enumeration>
13349 <xs:enumeration value="condition">
13350 <xs:annotation>
13351 <xs:documentation>
13352 Column is a condition and should be modularized.
13353 </xs:documentation>
13354 </xs:annotation>
13355 </xs:enumeration>
13356 <xs:enumeration value="icon">
13357 <xs:annotation>
13358 <xs:documentation>
13359 When the column is an primary or foreign key to the Icon table it should be modularized special.
13360 </xs:documentation>
13361 </xs:annotation>
13362 </xs:enumeration>
13363 <xs:enumeration value="property">
13364 <xs:annotation>
13365 <xs:documentation>
13366 Any Properties in the column should be modularized.
13367 </xs:documentation>
13368 </xs:annotation>
13369 </xs:enumeration>
13370 <xs:enumeration value="semicolonDelimited">
13371 <xs:annotation>
13372 <xs:documentation>
13373 Semi-colon list of keys, all of which need to be modularized.
13374 </xs:documentation>
13375 </xs:annotation>
13376 </xs:enumeration>
13377 </xs:restriction>
13378 </xs:simpleType>
13379 </xs:attribute>
13380 <xs:anyAttribute namespace="##other" processContents="lax">
13381 <xs:annotation>
13382 <xs:documentation>
13383 Extensibility point in the WiX XML Schema. Schema extensions can register additional
13384 attributes at this point in the schema.
13385 </xs:documentation>
13386 </xs:annotation>
13387 </xs:anyAttribute>
13388 </xs:complexType>
13389 </xs:element>
13390 <xs:element name="Row">
13391 <xs:annotation>
13392 <xs:documentation>Row data for a Custom Table</xs:documentation>
13393 </xs:annotation>
13394 <xs:complexType>
13395 <xs:choice maxOccurs="unbounded">
13396 <xs:element ref="Data"/>
13397 <xs:any namespace="##other" processContents="lax">
13398 <xs:annotation>
13399 <xs:documentation>
13400 Extensibility point in the WiX XML Schema. Schema extensions can register additional
13401 elements at this point in the schema.
13402 </xs:documentation>
13403 </xs:annotation>
13404 </xs:any>
13405 </xs:choice>
13406 <xs:anyAttribute namespace="##other" processContents="lax">
13407 <xs:annotation>
13408 <xs:documentation>
13409 Extensibility point in the WiX XML Schema. Schema extensions can register additional
13410 attributes at this point in the schema.
13411 </xs:documentation>
13412 </xs:annotation>
13413 </xs:anyAttribute>
13414 </xs:complexType>
13415 </xs:element>
13416 <xs:element name="Data">
13417 <xs:annotation>
13418 <xs:documentation>Used for a Custom Table. Specifies the data for the parent Row and specified Column.</xs:documentation>
13419 </xs:annotation>
13420 <xs:complexType>
13421 <xs:attribute name="Column" type="xs:string" use="required">
13422 <xs:annotation>
13423 <xs:documentation>Specifies in which column to insert this data.</xs:documentation>
13424 </xs:annotation>
13425 </xs:attribute>
13426 <xs:attribute name="Value" type="xs:string">
13427 <xs:annotation>
13428 <xs:documentation>Specifies the optional data for this column.</xs:documentation>
13429 </xs:annotation>
13430 </xs:attribute>
13431 <xs:anyAttribute namespace="##other" processContents="lax">
13432 <xs:annotation>
13433 <xs:documentation>
13434 Extensibility point in the WiX XML Schema. Schema extensions can register additional
13435 attributes at this point in the schema.
13436 </xs:documentation>
13437 </xs:annotation>
13438 </xs:anyAttribute>
13439 </xs:complexType>
13440 </xs:element>
13441 <xs:element name="CustomTableRef">
13442 <xs:annotation>
13443 <xs:documentation>Used to reference a CustomTable element and optionally add more data.</xs:documentation>
13444 </xs:annotation>
13445 <xs:complexType>
13446 <xs:sequence>
13447 <xs:element ref="Row" minOccurs="0" maxOccurs="unbounded">
13448 <xs:annotation>
13449 <xs:documentation>Row definition for the custom table.</xs:documentation>
13450 </xs:annotation>
13451 </xs:element>
13452 </xs:sequence>
13453 <xs:attribute name="Id" type="xs:string" use="required">
13454 <xs:annotation>
13455 <xs:documentation>The identifier of the CustomTable element to reference.</xs:documentation>
13456 </xs:annotation>
13457 </xs:attribute>
13458 <xs:anyAttribute namespace="##other" processContents="lax">
13459 <xs:annotation>
13460 <xs:documentation>
13461 Extensibility point in the WiX XML Schema. Schema extensions can register additional
13462 attributes at this point in the schema.
13463 </xs:documentation>
13464 </xs:annotation>
13465 </xs:anyAttribute>
13466 </xs:complexType>
13467 </xs:element>
13468
13469 <xs:element name="EnsureTable">
13470 <xs:annotation>
13471 <xs:documentation>
13472 Use this element to ensure that a table appears in the installer database, even if its empty.
13473 </xs:documentation>
13474 <xs:appinfo>
13475 <xse:remarks>
13476 This element is particularly useful for two problems that may occur while merging merge modules:
13477
13478 * The first likely problem is that in order to properly merge you need to have certain
13479 tables present prior to merging. Using this element is one way to ensure those tables
13480 are present prior to the merging.
13481
13482 * The other common problem is that a merge module has incorrect validation information
13483 about some tables. By ensuring these tables prior to merging, you can avoid this
13484 problem because the correct validation information will go into the installer database
13485 before the merge module has a chance to set it incorrectly.
13486 </xse:remarks>
13487 </xs:appinfo>
13488 </xs:annotation>
13489 <xs:complexType>
13490 <xs:attribute name="Id" use="required" type="xs:string">
13491 <xs:annotation>
13492 <xs:documentation>The name of the table.</xs:documentation>
13493 </xs:annotation>
13494 </xs:attribute>
13495 <xs:anyAttribute namespace="##other" processContents="lax">
13496 <xs:annotation>
13497 <xs:documentation>
13498 Extensibility point in the WiX XML Schema. Schema extensions can register additional
13499 attributes at this point in the schema.
13500 </xs:documentation>
13501 </xs:annotation>
13502 </xs:anyAttribute>
13503 </xs:complexType>
13504 </xs:element>
13505 <xs:element name="WixVariable">
13506 <xs:annotation>
13507 <xs:documentation>
13508 This element exposes advanced WiX functionality. Use this element to declare WiX variables
13509 from directly within your authoring. WiX variables are not resolved until the final package
13510 file is actually generated (bind time). WiX variables do not persist into the package file,
13511 so they cannot be used when an MSI file is being installed; it's a WiX-only concept.
13512 </xs:documentation>
13513 </xs:annotation>
13514 <xs:complexType>
13515 <xs:attribute name="Id" type="xs:string" use="required">
13516 <xs:annotation>
13517 <xs:documentation>The name of the variable.</xs:documentation>
13518 </xs:annotation>
13519 </xs:attribute>
13520 <xs:attribute name="Overridable" type="YesNoTypeUnion">
13521 <xs:annotation>
13522 <xs:documentation>
13523 Set this value to 'yes' in order to make the variable's value overridable either by
13524 another WixVariable entry or via the command-line option -d_name_=_value_;
13525 for light.exe. If the same variable is declared overridable in multiple places it
13526 will cause an error (since WiX won't know which value is correct). The default value
13527 is 'no'.
13528 </xs:documentation>
13529 </xs:annotation>
13530 </xs:attribute>
13531 <xs:attribute name="Value" type="xs:string" use="required">
13532 <xs:annotation>
13533 <xs:documentation>
13534 The value of the variable. Note that because values are substituted at bind time,
13535 they skip all the validation done at compile time, which can be more thorough than
13536 validation done at bind time.
13537 </xs:documentation>
13538 </xs:annotation>
13539 </xs:attribute>
13540 <xs:anyAttribute namespace="##other" processContents="lax">
13541 <xs:annotation>
13542 <xs:documentation>
13543 Extensibility point in the WiX XML Schema. Schema extensions can register additional
13544 attributes at this point in the schema.
13545 </xs:documentation>
13546 </xs:annotation>
13547 </xs:anyAttribute>
13548 </xs:complexType>
13549 </xs:element>
13550 <xs:element name="InstanceTransforms">
13551 <xs:annotation>
13552 <xs:documentation>
13553 Use this element to contain definitions for instance transforms.
13554 </xs:documentation>
13555 </xs:annotation>
13556 <xs:complexType>
13557 <xs:choice minOccurs="0" maxOccurs="unbounded">
13558 <xs:element ref="Instance" />
13559 </xs:choice>
13560 <xs:attribute name="Property" type="xs:string" use="required">
13561 <xs:annotation>
13562 <xs:documentation>The Id of the Property who's value should change for each instance.</xs:documentation>
13563 </xs:annotation>
13564 </xs:attribute>
13565 <xs:anyAttribute namespace="##other" processContents="lax">
13566 <xs:annotation>
13567 <xs:documentation>
13568 Extensibility point in the WiX XML Schema. Schema extensions can register additional
13569 attributes at this point in the schema.
13570 </xs:documentation>
13571 </xs:annotation>
13572 </xs:anyAttribute>
13573 </xs:complexType>
13574 </xs:element>
13575 <xs:element name="Instance">
13576 <xs:annotation>
13577 <xs:documentation>
13578 Defines an instance transform for your product.
13579 </xs:documentation>
13580 </xs:annotation>
13581 <xs:complexType>
13582 <xs:attribute name="Id" type="xs:string" use="required">
13583 <xs:annotation>
13584 <xs:documentation>
13585 The identity of the instance transform. This value will define the name by which the instance
13586 should be referred to on the command line. In addition, the value of the this attribute will
13587 determine what the value of the property specified in Property attribute on InstanceTransforms
13588 will change to for each instance.
13589 </xs:documentation>
13590 </xs:annotation>
13591 </xs:attribute>
13592 <xs:attribute name="ProductCode" type="AutogenGuid" use="required">
13593 <xs:annotation>
13594 <xs:documentation>The ProductCode for this instance.</xs:documentation>
13595 </xs:annotation>
13596 </xs:attribute>
13597 <xs:attribute name="ProductName" type="xs:string">
13598 <xs:annotation>
13599 <xs:documentation>The ProductName for this instance.</xs:documentation>
13600 </xs:annotation>
13601 </xs:attribute>
13602 <xs:attribute name="UpgradeCode" type="Guid">
13603 <xs:annotation>
13604 <xs:documentation>The UpgradeCode for this instance.</xs:documentation>
13605 </xs:annotation>
13606 </xs:attribute>
13607 <xs:anyAttribute namespace="##other" processContents="lax">
13608 <xs:annotation>
13609 <xs:documentation>
13610 Extensibility point in the WiX XML Schema. Schema extensions can register additional
13611 attributes at this point in the schema.
13612 </xs:documentation>
13613 </xs:annotation>
13614 </xs:anyAttribute>
13615 </xs:complexType>
13616 </xs:element>
13617 <xs:element name="MajorUpgrade">
13618 <xs:annotation>
13619 <xs:documentation>
13620 Simplifies authoring for major upgrades, including support for preventing downgrades.
13621
13622 The parent Package element must have valid UpgradeCode and Version attributes.
13623
13624 When the FindRelatedProducts action detects a related product installed on the system,
13625 it appends the product code to the property named WIX_UPGRADE_DETECTED. After the
13626 FindRelatedProducts action is run, the value of the WIX_UPGRADE_DETECTED property is a
13627 list of product codes, separated by semicolons (;), detected on the system.
13628 </xs:documentation>
13629 <xs:appinfo>
13630 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Package" />
13631 </xs:appinfo>
13632 </xs:annotation>
13633 <xs:complexType>
13634 <xs:attribute name="AllowDowngrades" type="YesNoTypeUnion">
13635 <xs:annotation>
13636 <xs:documentation>
13637 When set to no (the default), products with lower version numbers are blocked from
13638 installing when a product with a higher version is installed; the DowngradeErrorMessage
13639 attribute must also be specified.
13640
13641 When set to yes, any version can be installed over any other version.
13642 </xs:documentation>
13643 </xs:annotation>
13644 </xs:attribute>
13645 <xs:attribute name="AllowSameVersionUpgrades" type="YesNoTypeUnion">
13646 <xs:annotation>
13647 <xs:documentation>
13648 When set to no (the default), installing a product with the same version and upgrade code
13649 (but different product code) is allowed and treated by MSI as two products. When set to yes,
13650 WiX sets the msidbUpgradeAttributesVersionMaxInclusive attribute, which tells MSI to treat
13651 a product with the same version as a major upgrade.
13652
13653 This is useful when two product versions differ only in the fourth version field. MSI
13654 specifically ignores that field when comparing product versions, so two products that
13655 differ only in the fourth version field are the same product and need this attribute set to
13656 yes to be detected.
13657
13658 Note that because MSI ignores the fourth product version field, setting this attribute to
13659 yes also allows downgrades when the first three product version fields are identical.
13660 For example, product version 1.0.0.1 will "upgrade" 1.0.0.2998 because they're seen as the
13661 same version (1.0.0). That could reintroduce serious bugs so the safest choice is to change
13662 the first three version fields and omit this attribute to get the default of no.
13663
13664 This attribute cannot be "yes" when AllowDowngrades is also "yes" -- AllowDowngrades
13665 already allows two products with the same version number to upgrade each other.
13666 </xs:documentation>
13667 </xs:annotation>
13668 </xs:attribute>
13669 <xs:attribute name="Disallow" type="YesNoTypeUnion">
13670 <xs:annotation>
13671 <xs:documentation>
13672 When set to yes, products with higer version numbers are blocked from
13673 installing when a product with a lower version is installed; the UpgradeErrorMessage
13674 attribute must also be specified.
13675
13676 When set to no (the default), any version can be installed over any lower version.
13677 </xs:documentation>
13678 </xs:annotation>
13679 </xs:attribute>
13680 <xs:attribute name="DowngradeErrorMessage" type="xs:string">
13681 <xs:annotation>
13682 <xs:documentation>
13683 The message displayed if users try to install a product with a lower version number
13684 when a product with a higher version is installed. Used only when AllowDowngrades
13685 is no (the default).
13686 </xs:documentation>
13687 </xs:annotation>
13688 </xs:attribute>
13689 <xs:attribute name="DisallowUpgradeErrorMessage" type="xs:string">
13690 <xs:annotation>
13691 <xs:documentation>
13692 The message displayed if users try to install a product with a higer version number
13693 when a product with a lower version is installed. Used only when Disallow
13694 is yes.
13695 </xs:documentation>
13696 </xs:annotation>
13697 </xs:attribute>
13698 <xs:attribute name="MigrateFeatures" type="YesNoTypeUnion">
13699 <xs:annotation>
13700 <xs:documentation>
13701 When set to yes (the default), the MigrateFeatureStates standard action will set the
13702 feature states of the upgrade product to those of the installed product.
13703
13704 When set to no, the installed features have no effect on the upgrade installation.
13705 </xs:documentation>
13706 </xs:annotation>
13707 </xs:attribute>
13708 <xs:attribute name="IgnoreLanguage" type="YesNoTypeUnion">
13709 <xs:annotation>
13710 <xs:documentation>
13711 When set to yes, the Upgrade table rows will match any product with the same UpgradeCode.
13712
13713 When set to no (the default), the Upgrade table rows will match only products with the
13714 same UpgradeCode and ProductLanguage.
13715 </xs:documentation>
13716 </xs:annotation>
13717 </xs:attribute>
13718 <xs:attribute name="IgnoreRemoveFailure" type="YesNoTypeUnion">
13719 <xs:annotation>
13720 <xs:documentation>
13721 When set to yes, failures removing the installed product during the upgrade will be
13722 ignored.
13723
13724 When set to no (the default), failures removing the installed product during the upgrade
13725 will be considered a failure and, depending on the scheduling, roll back the upgrade.
13726 </xs:documentation>
13727 </xs:annotation>
13728 </xs:attribute>
13729 <xs:attribute name="RemoveFeatures" type="xs:string">
13730 <xs:annotation>
13731 <xs:documentation>
13732 A formatted string that contains the list of features to remove from the installed
13733 product. The default is to remove all features. Note that if you use formatted property
13734 values that evaluate to an empty string, no features will be removed; only omitting
13735 this attribute defaults to removing all features.
13736 </xs:documentation>
13737 </xs:annotation>
13738 </xs:attribute>
13739 <xs:attribute name="Schedule" default="afterInstallValidate">
13740 <xs:annotation>
13741 <xs:documentation>
13742 Determines the scheduling of the RemoveExistingProducts standard action, which is when
13743 the installed product is removed. The default is "afterInstallValidate" which removes
13744 the installed product entirely before installing the upgrade product. It's slowest but
13745 gives the most flexibility in changing components and features in the upgrade product.
13746
13747 For more information, see <html:a href="https://learn.microsoft.com/en-us/windows/win32/msi/removeexistingproducts-action">RemoveExistingProducts</html:a>.
13748 </xs:documentation>
13749 </xs:annotation>
13750 <xs:simpleType>
13751 <xs:restriction base="xs:NMTOKEN">
13752 <xs:enumeration value="afterInstallValidate">
13753 <xs:annotation>
13754 <xs:documentation>
13755 (Default) Schedules RemoveExistingProducts after the InstallValidate standard
13756 action. This scheduling removes the installed product entirely before installing
13757 the upgrade product. It's slowest but gives the most flexibility in changing
13758 components and features in the upgrade product. Note that if the installation
13759 of the upgrade product fails, the machine will have neither version installed.
13760 </xs:documentation>
13761 </xs:annotation>
13762 </xs:enumeration>
13763 <xs:enumeration value="afterInstallInitialize">
13764 <xs:annotation>
13765 <xs:documentation>
13766 Schedules RemoveExistingProducts after the InstallInitialize standard action.
13767 This is similar to the afterInstallValidate scheduling, but if the installation
13768 of the upgrade product fails, Windows Installer also rolls back the removal of
13769 the installed product -- in other words, reinstalls it.
13770 </xs:documentation>
13771 </xs:annotation>
13772 </xs:enumeration>
13773 <xs:enumeration value="afterInstallExecute">
13774 <xs:annotation>
13775 <xs:documentation>
13776 Schedules RemoveExistingProducts between the InstallExecute and InstallFinalize standard actions.
13777 This scheduling installs the upgrade product "on top of" the installed product then lets
13778 RemoveExistingProducts uninstall any components that don't also exist in the upgrade product.
13779 Note that this scheduling requires strict adherence to the component rules because it relies
13780 on component reference counts to be accurate during installation of the upgrade product and
13781 removal of the installed product. For more information, see
13782 <html:a href="http://www.joyofsetup.com/2008/12/30/paying-for-upgrades/">Bob Arnson's blog post "Paying for Upgrades"</html:a> for details. If installation of the upgrade product fails, Windows Installer
13783 also rolls back the removal of the installed product -- in other words, reinstalls it.
13784 </xs:documentation>
13785 </xs:annotation>
13786 </xs:enumeration>
13787 <xs:enumeration value="afterInstallExecuteAgain">
13788 <xs:annotation>
13789 <xs:documentation>
13790 Schedules RemoveExistingProducts between the InstallExecuteAgain and InstallFinalize standard actions.
13791 This is identical to the afterInstallExecute scheduling but after the InstallExecuteAgain standard
13792 action instead of InstallExecute.
13793 </xs:documentation>
13794 </xs:annotation>
13795 </xs:enumeration>
13796 <xs:enumeration value="afterInstallFinalize">
13797 <xs:annotation>
13798 <xs:documentation>
13799 Schedules RemoveExistingProducts after the InstallFinalize standard action. This is similar to the
13800 afterInstallExecute and afterInstallExecuteAgain schedulings but takes place outside the
13801 installation transaction so if installation of the upgrade product fails, Windows Installer does
13802 not roll back the removal of the installed product, so the machine will have both versions
13803 installed.
13804 </xs:documentation>
13805 </xs:annotation>
13806 </xs:enumeration>
13807 </xs:restriction>
13808 </xs:simpleType>
13809 </xs:attribute>
13810 <xs:anyAttribute namespace="##other" processContents="lax">
13811 <xs:annotation>
13812 <xs:documentation>
13813 Extensibility point in the WiX XML Schema. Schema extensions can register additional
13814 attributes at this point in the schema.
13815 </xs:documentation>
13816 </xs:annotation>
13817 </xs:anyAttribute>
13818 </xs:complexType>
13819 </xs:element>
13820 <xs:element name="ProductSearch">
13821 <xs:annotation>
13822 <xs:appinfo>
13823 <xse:msiRef table="Upgrade" href="https://learn.microsoft.com/en-us/windows/win32/msi/upgrade-table" />
13824 </xs:appinfo>
13825 </xs:annotation>
13826 <xs:complexType>
13827 <xs:attribute name="Minimum" type="xs:string">
13828 <xs:annotation>
13829 <xs:documentation>Specifies the lower bound on the range of product versions to be detected by FindRelatedProducts.</xs:documentation>
13830 </xs:annotation>
13831 </xs:attribute>
13832 <xs:attribute name="Maximum" type="xs:string">
13833 <xs:annotation>
13834 <xs:documentation>Specifies the upper boundary of the range of product versions detected by FindRelatedProducts.</xs:documentation>
13835 </xs:annotation>
13836 </xs:attribute>
13837 <xs:attribute name="Language" type="xs:string">
13838 <xs:annotation>
13839 <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>
13840 </xs:annotation>
13841 </xs:attribute>
13842 <xs:attribute name="IncludeMinimum" type="YesNoTypeUnion">
13843 <xs:annotation>
13844 <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>
13845 </xs:annotation>
13846 </xs:attribute>
13847 <xs:attribute name="IncludeMaximum" type="YesNoTypeUnion">
13848 <xs:annotation>
13849 <xs:documentation>Set to "yes" to make the range of versions detected include the value specified in Maximum.</xs:documentation>
13850 </xs:annotation>
13851 </xs:attribute>
13852 <xs:attribute name="ExcludeLanguages" type="YesNoTypeUnion">
13853 <xs:annotation>
13854 <xs:documentation>Set to "yes" to detect all languages, excluding the languages listed in the Language attribute.</xs:documentation>
13855 </xs:annotation>
13856 </xs:attribute>
13857 <xs:attribute name="UpgradeCode" type="Guid" use="required">
13858 <xs:annotation>
13859 <xs:documentation>This value specifies the upgrade code for the products that are to be detected by the FindRelatedProducts action.</xs:documentation>
13860 </xs:annotation>
13861 </xs:attribute>
13862 <xs:anyAttribute namespace="##other" processContents="lax">
13863 <xs:annotation>
13864 <xs:documentation>
13865 Extensibility point in the WiX XML Schema. Schema extensions can register additional
13866 attributes at this point in the schema.
13867 </xs:documentation>
13868 </xs:annotation>
13869 </xs:anyAttribute>
13870 </xs:complexType>
13871 </xs:element>
13872 <!-- - - - - - - - - - - Complex Type Definitions - - - - - - - - - - - -->
13873 <xs:complexType name="ActionModuleSequenceType">
13874 <xs:attribute name="After" type="xs:string">
13875 <xs:annotation>
13876 <xs:documentation>The name of an action that this action should come after.</xs:documentation>
13877 </xs:annotation>
13878 </xs:attribute>
13879 <xs:attribute name="Before" type="xs:string">
13880 <xs:annotation>
13881 <xs:documentation>The name of an action that this action should come before.</xs:documentation>
13882 </xs:annotation>
13883 </xs:attribute>
13884 <xs:attribute name="Condition" type="xs:string">
13885 <xs:annotation>
13886 <xs:documentation>The condition of the action.</xs:documentation>
13887 </xs:annotation>
13888 </xs:attribute>
13889 <xs:attribute name="Overridable" type="YesNoTypeUnion">
13890 <xs:annotation>
13891 <xs:documentation>
13892 If "yes", the sequencing of this action may be overridden by sequencing elsewhere.
13893 </xs:documentation>
13894 </xs:annotation>
13895 </xs:attribute>
13896 <xs:attribute name="Sequence" type="Integer">
13897 <xs:annotation>
13898 <xs:documentation>A value used to indicate the position of this action in a sequence.</xs:documentation>
13899 </xs:annotation>
13900 </xs:attribute>
13901 <xs:attribute name="Suppress" type="YesNoTypeUnion">
13902 <xs:annotation>
13903 <xs:documentation>If yes, this action will not occur.</xs:documentation>
13904 </xs:annotation>
13905 </xs:attribute>
13906 </xs:complexType>
13907 <xs:complexType name="ActionSequenceType">
13908 <xs:attribute name="Condition" type="xs:string">
13909 <xs:annotation>
13910 <xs:documentation>The condition of the action.</xs:documentation>
13911 </xs:annotation>
13912 </xs:attribute>
13913 <xs:attribute name="Sequence" type="Integer">
13914 <xs:annotation>
13915 <xs:documentation>A value used to indicate the position of this action in a sequence.</xs:documentation>
13916 </xs:annotation>
13917 </xs:attribute>
13918 <xs:attribute name="Suppress" type="YesNoTypeUnion">
13919 <xs:annotation>
13920 <xs:documentation>If yes, this action will not occur.</xs:documentation>
13921 </xs:annotation>
13922 </xs:attribute>
13923 </xs:complexType>
13924 <!-- - - - - - - - - - - Simple Type Definitions - - - - - - - - - - - - -->
13925 <xs:simpleType name="Guid">
13926 <xs:annotation>
13927 <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>
13928 </xs:annotation>
13929 <xs:restriction base="xs:string">
13930 <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\.)?[_A-Za-z]{1}[0-9A-Za-z_\.]*\)|!\((loc|wix)\.[_A-Za-z]{1}[0-9A-Za-z_\.]*\)" />
13931 </xs:restriction>
13932 </xs:simpleType>
13933 <xs:simpleType name="AutogenGuid">
13934 <xs:annotation>
13935 <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>
13936 </xs:annotation>
13937 <xs:restriction base="xs:string">
13938 <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\.)?[_A-Za-z]{1}[0-9A-Za-z_\.]*\)|!\((loc|wix)\.[_A-Za-z]{1}[0-9A-Za-z_\.]*\)|\*" />
13939 </xs:restriction>
13940 </xs:simpleType>
13941 <xs:simpleType name="BitnessTypeUnion">
13942 <xs:annotation>
13943 <xs:documentation>Values of this type will be "default", "always32" or "always64".</xs:documentation>
13944 </xs:annotation>
13945 <xs:union memberTypes="BitnessType PreprocessorVariables"/>
13946 </xs:simpleType>
13947 <xs:simpleType name="BitnessType">
13948 <xs:annotation>
13949 <xs:documentation>Values of this type will be "default", "always32" or "always64".</xs:documentation>
13950 </xs:annotation>
13951 <xs:restriction base="xs:NMTOKEN">
13952 <xs:enumeration value="default" />
13953 <xs:enumeration value="always32" />
13954 <xs:enumeration value="always64" />
13955 </xs:restriction>
13956 </xs:simpleType>
13957 <xs:simpleType name="BurnContainerType">
13958 <xs:annotation>
13959 <xs:documentation>Values of this type will either be "attached" or "detached".</xs:documentation>
13960 </xs:annotation>
13961 <xs:restriction base="xs:NMTOKEN">
13962 <xs:enumeration value="attached" />
13963 <xs:enumeration value="detached" />
13964 </xs:restriction>
13965 </xs:simpleType>
13966 <xs:simpleType name="BurnExeProtocolType">
13967 <xs:annotation>
13968 <xs:documentation>The list of communcation protocols with executable packages Burn supports.
13969 </xs:documentation>
13970 </xs:annotation>
13971 <xs:restriction base="xs:NMTOKEN">
13972 <xs:enumeration value="none">
13973 <xs:annotation>
13974 <xs:documentation>
13975 The executable package does not support a communication protocol.
13976 </xs:documentation>
13977 </xs:annotation>
13978 </xs:enumeration>
13979 <xs:enumeration value="burn">
13980 <xs:annotation>
13981 <xs:documentation>
13982 The executable package implements the Burn communication protocol.
13983 </xs:documentation>
13984 </xs:annotation>
13985 </xs:enumeration>
13986 <xs:enumeration value="netfx4">
13987 <xs:annotation>
13988 <xs:documentation>
13989 The executable package implements the .NET Framework v4.0 communication protocol.
13990 </xs:documentation>
13991 </xs:annotation>
13992 </xs:enumeration>
13993 </xs:restriction>
13994 </xs:simpleType>
13995 <xs:simpleType name="ComponentGuid">
13996 <xs:annotation>
13997 <xs:documentation>Values of this type must be a GUID, with or without braces: `01234567-89AB-CDEF-0123-456789ABCDEF` or `{01234567-89AB-CDEF-0123-456789ABCDEF}`. `PUT-GUID-HERE` can be used for sample code. Empty values are also supported.</xs:documentation>
13998 </xs:annotation>
13999 <xs:restriction base="xs:string">
14000 <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\.)?[_A-Za-z]{1}[0-9A-Za-z_\.]*\)|!\((loc|wix)\.[_A-Za-z]{1}[0-9A-Za-z_\.]*\)|\*|^$" />
14001 </xs:restriction>
14002 </xs:simpleType>
14003 <xs:simpleType name="Integer">
14004 <xs:annotation>
14005 <xs:documentation>Values of this type must be a non-negative integer or a preprocessor variable with the format `$(Variable)` or `$(var.Variable)`.</xs:documentation>
14006 </xs:annotation>
14007 <xs:restriction base="xs:string">
14008 <xs:pattern value="[\d]+|\$\((var\.)?[_A-Za-z]{1}[0-9A-Za-z_\.]*\)" />
14009 </xs:restriction>
14010 </xs:simpleType>
14011 <xs:simpleType name="LocalizableInteger">
14012 <xs:annotation>
14013 <xs:documentation>Values of this type must be a non-negative integer or a localization variable with the format `!(loc.Variable)` where `Variable` is the name of the localization variable.</xs:documentation>
14014 </xs:annotation>
14015 <xs:restriction base="xs:string">
14016 <xs:pattern value="[\d]+|\$\((var\.)?[_A-Za-z]{1}[_A-Za-z0-9\.]*\)|!\((loc|bind)\.[_A-Za-z]{1}[_A-Za-z0-9\.]*\)" />
14017 </xs:restriction>
14018 </xs:simpleType>
14019 <xs:simpleType name="NegativeInteger">
14020 <xs:annotation>
14021 <xs:documentation>Values of this allow negative integer or a preprocessor variable with the format `$(Variable)` or `$(var.Variable).</xs:documentation>
14022 </xs:annotation>
14023 <xs:restriction base="xs:string">
14024 <xs:pattern value="-?[\d]+|\$\((var\.)?[_A-Za-z]{1}[0-9A-Za-z_\.]*\)" />
14025 </xs:restriction>
14026 </xs:simpleType>
14027 <xs:simpleType name="ShortFileNameType">
14028 <xs:annotation>
14029 <xs:documentation>Values of this type will look like: "FileName.ext". Only one period is allowed. The following characters are not allowed: \ ? | &gt; : / * " + , ; = [ ] &lt;, or whitespace. The name cannot exceed 8 characters and the extension cannot exceed 3 characters. The value could also be a localization variable with the format !(loc.VARIABLE).</xs:documentation>
14030 </xs:annotation>
14031 <xs:restriction base="xs:string">
14032 <xs:pattern value="[^\\\?|&gt;&lt;:/\*&quot;\+,;=\[\]\. ]{1,8}(\.[^\\\?|&gt;&lt;:/\*&quot;\+,;=\[\]\. ]{0,3})?|([!$])\(loc\.[_A-Za-z]{1}[0-9A-Za-z_\.]*\)" />
14033 </xs:restriction>
14034 </xs:simpleType>
14035 <xs:simpleType name="LongFileNameType">
14036 <xs:annotation>
14037 <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 &lt;. The name must be shorter than 260 characters. The value could also be a localization variable with the format !(loc.VARIABLE).</xs:documentation>
14038 </xs:annotation>
14039 <xs:restriction base="xs:string">
14040 <xs:pattern value="[^\\\?|&gt;&lt;:/\*&quot;]{1,259}|([!$])\(loc\.[_A-Za-z]{1}[0-9A-Za-z_\.]*\)" />
14041 </xs:restriction>
14042 </xs:simpleType>
14043 <xs:simpleType name="VersionType">
14044 <xs:annotation>
14045 <xs:documentation>Values of this type will look like: "x.x.x.x" where x is an integer from 0 to 65534.</xs:documentation>
14046 </xs:annotation>
14047 <xs:restriction base="xs:string">
14048 <xs:pattern value="(\d{1,5}\.){3}\d{1,5}" />
14049 </xs:restriction>
14050 </xs:simpleType>
14051 <xs:simpleType name="StrictThreePartVersionType">
14052 <xs:annotation>
14053 <xs:documentation>Values of this type will look exactly like: "x.x.x" where x is an integer.</xs:documentation>
14054 </xs:annotation>
14055 <xs:restriction base="xs:string">
14056 <xs:pattern value="(\d+\.){2}\d+|\$\((var\.)?[_A-Za-z]{1}[0-9A-Za-z_\.]*\)|!\((loc|bind)\.[_A-Za-z]{1}[0-9A-Za-z_\.]*\)" />
14057 </xs:restriction>
14058 </xs:simpleType>
14059 <xs:simpleType name="WixVersionType">
14060 <xs:annotation>
14061 <xs:documentation>Values of this type will be a 1-part, 2-part, 3-part or 4-part version number or a semantic version.</xs:documentation>
14062 </xs:annotation>
14063 <xs:restriction base="xs:string">
14064 <xs:pattern value="v?(\d+\.){0,3}\d+(-[\w.\d]+)?||\$\((var\.)?[_A-Za-z]{1}[0-9A-Za-z_\.]*\)|!\((loc|bind)\.[_A-Za-z]{1}[0-9A-Za-z_\.]*\)" />
14065 </xs:restriction>
14066 </xs:simpleType>
14067 <xs:simpleType name="WildCardShortFileNameType">
14068 <xs:annotation>
14069 <xs:documentation>Values of this type will look like: "File?.*". Only one period is allowed. The following characters are not allowed: \ | &gt; : / " + , ; = [ ] &lt;, 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>
14070 </xs:annotation>
14071 <xs:restriction base="xs:string">
14072 <xs:pattern value="[^\\\|&gt;&lt;:/&quot;\+,;=\[\]\. ]{1,16}(\.[^\\\|&gt;&lt;:/&quot;\+,;=\[\]\. ]{0,6})?|([!$])\(loc\.[_A-Za-z]{1}[0-9A-Za-z_\.]*\)" />
14073 </xs:restriction>
14074 </xs:simpleType>
14075 <xs:simpleType name="WildCardLongFileNameType">
14076 <xs:annotation>
14077 <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 &lt;. The name must be shorter than 260 characters. The value could also be a localization variable with the format !(loc.VARIABLE).</xs:documentation>
14078 </xs:annotation>
14079 <xs:restriction base="xs:string">
14080 <xs:pattern value="[^\\\|&gt;&lt;:/&quot;]{1,259}|([!$])\(loc\.[_A-Za-z]{1}[0-9A-Za-z_\.]*\)" />
14081 </xs:restriction>
14082 </xs:simpleType>
14083 <xs:simpleType name="HexType">
14084 <xs:annotation>
14085 <xs:documentation>This type supports any hexadecimal number. Both upper and lower case are supported for letters appearing in the number. This type also includes the empty string: "".</xs:documentation>
14086 </xs:annotation>
14087 <xs:restriction base="xs:string">
14088 <xs:pattern value="[0-9A-Fa-f]*" />
14089 </xs:restriction>
14090 </xs:simpleType>
14091 <xs:simpleType name="StandardDirectoryTypeUnion">
14092 <xs:annotation>
14093 <xs:documentation>A Windows Installer standard directory.</xs:documentation>
14094 </xs:annotation>
14095 <xs:union memberTypes="StandardDirectoryType PreprocessorVariables"/>
14096 </xs:simpleType>
14097 <xs:simpleType name="StandardDirectoryType">
14098 <xs:annotation>
14099 <xs:documentation>A Windows Installer standard directory.</xs:documentation>
14100 </xs:annotation>
14101 <xs:restriction base="xs:NMTOKEN">
14102 <xs:enumeration value="TARGETDIR" />
14103 <xs:enumeration value="AdminToolsFolder" />
14104 <xs:enumeration value="AppDataFolder" />
14105 <xs:enumeration value="CommonAppDataFolder" />
14106 <xs:enumeration value="CommonFilesFolder" />
14107 <xs:enumeration value="CommonFiles64Folder" />
14108 <xs:enumeration value="CommonFiles6432Folder" />
14109 <xs:enumeration value="DesktopFolder" />
14110 <xs:enumeration value="FavoritesFolder" />
14111 <xs:enumeration value="FontsFolder" />
14112 <xs:enumeration value="LocalAppDataFolder" />
14113 <xs:enumeration value="MyPicturesFolder" />
14114 <xs:enumeration value="NetHoodFolder" />
14115 <xs:enumeration value="PersonalFolder" />
14116 <xs:enumeration value="PrintHoodFolder" />
14117 <xs:enumeration value="ProgramFilesFolder" />
14118 <xs:enumeration value="ProgramFiles64Folder" />
14119 <xs:enumeration value="ProgramFiles6432Folder" />
14120 <xs:enumeration value="ProgramMenuFolder" />
14121 <xs:enumeration value="RecentFolder" />
14122 <xs:enumeration value="SendToFolder" />
14123 <xs:enumeration value="StartMenuFolder" />
14124 <xs:enumeration value="StartupFolder" />
14125 <xs:enumeration value="SystemFolder" />
14126 <xs:enumeration value="System16Folder" />
14127 <xs:enumeration value="System64Folder" />
14128 <xs:enumeration value="System6432Folder" />
14129 <xs:enumeration value="TempFolder" />
14130 <xs:enumeration value="TemplateFolder" />
14131 <xs:enumeration value="WindowsFolder" />
14132 </xs:restriction>
14133 </xs:simpleType>
14134 <xs:simpleType name="PackageScopeTypeUnion">
14135 <xs:annotation>
14136 <xs:documentation>Use this attribute to specify the installation scope of this package: per-machine, per-user, or a choice of either.</xs:documentation>
14137 </xs:annotation>
14138 <xs:union memberTypes="PackageScopeType PreprocessorVariables"/>
14139 </xs:simpleType>
14140 <xs:simpleType name="PackageScopeType">
14141 <xs:annotation>
14142 <xs:documentation>Use this attribute to specify the installation scope of this package: per-machine, per-user, or a choice of either.</xs:documentation>
14143 </xs:annotation>
14144 <xs:restriction base="xs:NMTOKEN">
14145 <xs:enumeration value="perMachine">
14146 <xs:annotation>
14147 <xs:documentation>
14148 Set this value to declare that the package is a per-machine installation and requires elevated privileges to install.
14149 Sets the ALLUSERS property to 1.
14150 </xs:documentation>
14151 </xs:annotation>
14152 </xs:enumeration>
14153 <xs:enumeration value="perUser">
14154 <xs:annotation>
14155 <xs:documentation>
14156 Set this value to declare that the package is a per-user installation and does not require elevated privileges to install.
14157 Sets the package's InstallPrivileges attribute to "limited."
14158 </xs:documentation>
14159 </xs:annotation>
14160 </xs:enumeration>
14161 <xs:enumeration value="perUserOrMachine">
14162 <xs:annotation>
14163 <xs:documentation>
14164 Set this value to declare that the package is [dual-purpose that can install per-user or per-machine](https://learn.microsoft.com/en-us/windows/win32/msi/single-package-authoring).
14165 Sets the ALLUSERS property to 2 and MSIINSTALLPERUSER property to 1.
14166 </xs:documentation>
14167 </xs:annotation>
14168 </xs:enumeration>
14169 </xs:restriction>
14170 </xs:simpleType>
14171 <xs:simpleType name="UpgradeStrategyTypeUnion">
14172 <xs:annotation>
14173 <xs:documentation>Use this attribute to specify the upgrade strategy of this package: major upgrade or none.</xs:documentation>
14174 </xs:annotation>
14175 <xs:union memberTypes="UpgradeStrategyType PreprocessorVariables"/>
14176 </xs:simpleType>
14177 <xs:simpleType name="UpgradeStrategyType">
14178 <xs:annotation>
14179 <xs:documentation>Use this attribute to specify the installation scope of this package: major upgrade or none.</xs:documentation>
14180 </xs:annotation>
14181 <xs:restriction base="xs:NMTOKEN">
14182 <xs:enumeration value="majorUpgrade">
14183 <xs:annotation>
14184 <xs:documentation>
14185 Set this value to declare that the package will be upgraded via major upgrades.
14186 You can author a major upgrade with your preferred options or a default major
14187 upgrade will be provided if you don't. The UpgradeCode attribute is required.
14188 </xs:documentation>
14189 </xs:annotation>
14190 </xs:enumeration>
14191 <xs:enumeration value="none">
14192 <xs:annotation>
14193 <xs:documentation>
14194 Set this value to declare that the package will not support major upgrades.
14195 This value is _not_ recommended because it means a product cannot be serviced
14196 in the event of major bug or security vulnerability.
14197 </xs:documentation>
14198 </xs:annotation>
14199 </xs:enumeration>
14200 </xs:restriction>
14201 </xs:simpleType>
14202 <xs:simpleType name="YesNoTypeUnion">
14203 <xs:annotation>
14204 <xs:documentation>Values of this type will either be "yes"/"true" or "no"/"false".</xs:documentation>
14205 </xs:annotation>
14206 <xs:union memberTypes="YesNoType PreprocessorVariables"/>
14207 </xs:simpleType>
14208 <xs:simpleType name="YesNoType">
14209 <xs:annotation>
14210 <xs:documentation>Values of this type will either be "yes"/"true" or "no"/"false".</xs:documentation>
14211 </xs:annotation>
14212 <xs:restriction base="xs:NMTOKEN">
14213 <xs:enumeration value="no" />
14214 <xs:enumeration value="false" />
14215 <xs:enumeration value="yes" />
14216 <xs:enumeration value="true" />
14217 </xs:restriction>
14218 </xs:simpleType>
14219 <xs:simpleType name="YesNoButtonTypeUnion">
14220 <xs:annotation>
14221 <xs:documentation>Values of this type will either be "button", "yes"/"true", or "no"/"false".</xs:documentation>
14222 </xs:annotation>
14223 <xs:union memberTypes="YesNoButtonType PreprocessorVariables"/>
14224 </xs:simpleType>
14225 <xs:simpleType name="YesNoButtonType">
14226 <xs:annotation>
14227 <xs:documentation>Values of this type will either be "button", "yes"/"true", or "no"/"false".</xs:documentation>
14228 </xs:annotation>
14229 <xs:restriction base="xs:NMTOKEN">
14230 <xs:enumeration value="no" />
14231 <xs:enumeration value="false" />
14232 <xs:enumeration value="yes" />
14233 <xs:enumeration value="true" />
14234 <xs:enumeration value="button" />
14235 </xs:restriction>
14236 </xs:simpleType>
14237 <xs:simpleType name="YesNoDefaultTypeUnion">
14238 <xs:annotation>
14239 <xs:documentation>Values of this type will either be "default", "yes", or "no".</xs:documentation>
14240 </xs:annotation>
14241 <xs:union memberTypes="YesNoDefaultType PreprocessorVariables"/>
14242 </xs:simpleType>
14243 <xs:simpleType name="YesNoDefaultType">
14244 <xs:annotation>
14245 <xs:documentation>Values of this type will either be "default", "yes", or "no".</xs:documentation>
14246 </xs:annotation>
14247 <xs:restriction base="xs:NMTOKEN">
14248 <xs:enumeration value="default" />
14249 <xs:enumeration value="no" />
14250 <xs:enumeration value="false" />
14251 <xs:enumeration value="yes" />
14252 <xs:enumeration value="true" />
14253 </xs:restriction>
14254 </xs:simpleType>
14255 <xs:simpleType name="KeepRemoveForceTypeUnion">
14256 <xs:annotation>
14257 <xs:documentation>Values of this type will either be "force", "keep", or "remove".</xs:documentation>
14258 </xs:annotation>
14259 <xs:union memberTypes="KeepRemoveForceType PreprocessorVariables"/>
14260 </xs:simpleType>
14261 <xs:simpleType name="KeepRemoveForceType">
14262 <xs:annotation>
14263 <xs:documentation>Values of this type will either be "force", "keep", or "remove".</xs:documentation>
14264 </xs:annotation>
14265 <xs:restriction base="xs:NMTOKEN">
14266 <xs:enumeration value="force">
14267 <xs:annotation>
14268 <xs:documentation>
14269 Always cache the package during Cache, Install, Modify, Repair, and Layout.
14270 </xs:documentation>
14271 </xs:annotation>
14272 </xs:enumeration>
14273 <xs:enumeration value="keep">
14274 <xs:annotation>
14275 <xs:documentation>
14276 Keep the package cached when the package is requested to be present.
14277 </xs:documentation>
14278 </xs:annotation>
14279 </xs:enumeration>
14280 <xs:enumeration value="remove">
14281 <xs:annotation>
14282 <xs:documentation>
14283 Always uncache the package after Cache, Install, Modify, Repair, Uninstall, and Layout.
14284 </xs:documentation>
14285 </xs:annotation>
14286 </xs:enumeration>
14287 </xs:restriction>
14288 </xs:simpleType>
14289 <xs:simpleType name="RegistryRootType">
14290 <xs:annotation>
14291 <xs:documentation>Values of this type represent possible registry roots.</xs:documentation>
14292 </xs:annotation>
14293 <xs:restriction base="xs:NMTOKEN">
14294 <xs:enumeration value="HKMU">
14295 <xs:annotation>
14296 <xs:documentation>
14297 A per-user installation will make the operation occur under HKEY_CURRENT_USER.
14298 A per-machine installation will make the operation occur under HKEY_LOCAL_MACHINE.
14299 </xs:documentation>
14300 </xs:annotation>
14301 </xs:enumeration>
14302 <xs:enumeration value="HKCR">
14303 <xs:annotation>
14304 <xs:documentation>
14305 Operation occurs under HKEY_CLASSES_ROOT. When using Windows 2000 or later, the installer writes or removes the value
14306 from the HKCU\Software\Classes hive during per-user installations. When using Windows 2000 or later operating systems,
14307 the installer writes or removes the value from the HKLM\Software\Classes hive during per-machine installations.
14308 </xs:documentation>
14309 </xs:annotation>
14310 </xs:enumeration>
14311 <xs:enumeration value="HKCU">
14312 <xs:annotation>
14313 <xs:documentation>
14314 Operation occurs under HKEY_CURRENT_USER. It is recommended to set the KeyPath attribute to `yes` when setting this value for writing values
14315 in order to ensure that the installer writes the necessary registry entries when there are multiple users on the same computer.
14316 </xs:documentation>
14317 </xs:annotation>
14318 </xs:enumeration>
14319 <xs:enumeration value="HKLM">
14320 <xs:annotation>
14321 <xs:documentation>
14322 Operation occurs under HKEY_LOCAL_MACHINE.
14323 </xs:documentation>
14324 </xs:annotation>
14325 </xs:enumeration>
14326 <xs:enumeration value="HKU">
14327 <xs:annotation>
14328 <xs:documentation>
14329 Operation occurs under HKEY_USERS.
14330 </xs:documentation>
14331 </xs:annotation>
14332 </xs:enumeration>
14333 </xs:restriction>
14334 </xs:simpleType>
14335 <xs:simpleType name="ExitType">
14336 <xs:annotation>
14337 <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.
14338 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>
14339 </xs:annotation>
14340 <xs:restriction base="xs:NMTOKEN">
14341 <xs:enumeration value="success" />
14342 <xs:enumeration value="cancel" />
14343 <xs:enumeration value="error" />
14344 <xs:enumeration value="suspend" />
14345 </xs:restriction>
14346 </xs:simpleType>
14347 <xs:simpleType name="InstallUninstallType">
14348 <xs:annotation>
14349 <xs:documentation>Specifies whether an action occur on install, uninstall or both.</xs:documentation>
14350 </xs:annotation>
14351 <xs:restriction base="xs:NMTOKEN">
14352 <xs:enumeration value="install">
14353 <xs:annotation>
14354 <xs:documentation>
14355 The action should happen during install (msiInstallStateLocal or msiInstallStateSource).
14356 </xs:documentation>
14357 </xs:annotation>
14358 </xs:enumeration>
14359 <xs:enumeration value="uninstall">
14360 <xs:annotation>
14361 <xs:documentation>
14362 The action should happen during uninstall (msiInstallStateAbsent).
14363 </xs:documentation>
14364 </xs:annotation>
14365 </xs:enumeration>
14366 <xs:enumeration value="both">
14367 <xs:annotation>
14368 <xs:documentation>
14369 The action should happen during both install and uninstall.
14370 </xs:documentation>
14371 </xs:annotation>
14372 </xs:enumeration>
14373 </xs:restriction>
14374 </xs:simpleType>
14375 <xs:simpleType name="SequenceType">
14376 <xs:annotation>
14377 <xs:documentation>
14378 Controls which sequences the item assignment is sequenced in.
14379 </xs:documentation>
14380 </xs:annotation>
14381 <xs:restriction base="xs:NMTOKEN">
14382 <xs:enumeration value="both">
14383 <xs:annotation>
14384 <xs:documentation>
14385 Schedules the assignment in the InstallUISequence and the InstallExecuteSequence.
14386 </xs:documentation>
14387 </xs:annotation>
14388 </xs:enumeration>
14389 <xs:enumeration value="first">
14390 <xs:annotation>
14391 <xs:documentation>
14392 Schedules the assignment to run in the InstallUISequence or the InstallExecuteSequence if the InstallUISequence is skipped.
14393 </xs:documentation>
14394 </xs:annotation>
14395 </xs:enumeration>
14396 <xs:enumeration value="execute">
14397 <xs:annotation>
14398 <xs:documentation>
14399 Schedules the assignment only in the the InstallExecuteSequence.
14400 </xs:documentation>
14401 </xs:annotation>
14402 </xs:enumeration>
14403 <xs:enumeration value="ui">
14404 <xs:annotation>
14405 <xs:documentation>
14406 Schedules the assignment only in the the InstallUISequence.
14407 </xs:documentation>
14408 </xs:annotation>
14409 </xs:enumeration>
14410 </xs:restriction>
14411 </xs:simpleType>
14412 <xs:simpleType name="CompressionLevelTypeUnion">
14413 <xs:annotation>
14414 <xs:documentation>
14415 Indicates the compression level for a cabinet.
14416 </xs:documentation>
14417 </xs:annotation>
14418 <xs:union memberTypes="CompressionLevelType PreprocessorVariables"/>
14419 </xs:simpleType>
14420
14421 <xs:simpleType name="CompressionLevelType">
14422 <xs:annotation>
14423 <xs:documentation>
14424 Indicates the compression level for a cabinet.
14425 </xs:documentation>
14426 </xs:annotation>
14427 <xs:restriction base="xs:NMTOKEN">
14428 <xs:enumeration value="high" />
14429 <xs:enumeration value="low" />
14430 <xs:enumeration value="medium" />
14431 <xs:enumeration value="mszip" />
14432 <xs:enumeration value="none" />
14433 </xs:restriction>
14434 </xs:simpleType>
14435 <xs:simpleType name="PreprocessorVariables">
14436 <xs:annotation>
14437 <xs:documentation>A type that represents 1 or more preprocessor variables.</xs:documentation>
14438 </xs:annotation>
14439 <xs:restriction base="xs:string">
14440 <xs:pattern value="(\$\((\w+\.)?(\w[\w()]*)\))+" />
14441 </xs:restriction>
14442 </xs:simpleType>
14443 <xs:simpleType name="DiskIdType">
14444 <xs:annotation>
14445 <xs:documentation>Values of this type must be an integer or the value of one or more preprocessor variables with the format `$(Variable)` or `$(var.Variable)`.</xs:documentation>
14446 </xs:annotation>
14447 <xs:restriction base="xs:string">
14448 <xs:pattern value="((\d+)|(\$\(\w+\.(\w|[.])+\)))+" />
14449 </xs:restriction>
14450 </xs:simpleType>
14451 <xs:simpleType name="VariableType">
14452 <xs:annotation>
14453 <xs:documentation>Indicates the type of a Variable.</xs:documentation>
14454 </xs:annotation>
14455 <xs:restriction base="xs:NMTOKEN">
14456 <xs:enumeration value="string">
14457 <xs:annotation>
14458 <xs:documentation>A literal string.</xs:documentation>
14459 </xs:annotation>
14460 </xs:enumeration>
14461 <xs:enumeration value="formatted">
14462 <xs:annotation>
14463 <xs:documentation>A string that may contain Variables.</xs:documentation>
14464 </xs:annotation>
14465 </xs:enumeration>
14466 <xs:enumeration value="numeric" />
14467 <xs:enumeration value="version" />
14468 </xs:restriction>
14469 </xs:simpleType>
14470
14471 <xs:element name="Provides">
14472 <xs:annotation>
14473 <xs:documentation>
14474 Describes the information for this product or feature that serves as a dependency of other products or features.
14475 </xs:documentation>
14476 <xs:appinfo>
14477 <xse:remarks>
14478 This element is required for any product, feature, or bundle that will use the Dependency feature to properly reference count
14479 other products or features. It should be authored into a component that is always installed and removed with the
14480 product or features that contain it. This guarantees that product dependencies are not removed before those products that
14481 depend on them.
14482
14483 The @Key attribute should identify a version range for your product that you guarantee will be backward compatible.
14484 This key is designed to persist throughout compatible upgrades so that dependent products do not have to be reinstalled
14485 and will not prevent your product from being upgraded. If this attribute is not authored, the value is the ProductCode
14486 and will not automatically support upgrades.
14487
14488 By default this uses the Package/@ProductCode attribute value, which may be automatically generated.
14489 </xse:remarks>
14490 <xse:howtoRef href="author_product_dependencies.html">How To: Author product dependencies</xse:howtoRef>
14491 </xs:appinfo>
14492 </xs:annotation>
14493 <xs:complexType>
14494 <xs:choice minOccurs="0" maxOccurs="unbounded">
14495 <xs:element ref="Requires" />
14496 <xs:element ref="RequiresRef" />
14497 </xs:choice>
14498 <xs:attribute name="Id" type="xs:string">
14499 <xs:annotation>
14500 <xs:documentation>
14501 Dependency provider identity. If this attribute is not specified, an identifier will be generated automatically.
14502 </xs:documentation>
14503 </xs:annotation>
14504 </xs:attribute>
14505 <xs:attribute name="Key" type="xs:string">
14506 <xs:annotation>
14507 <xs:documentation>
14508 Optional unique registry key name that identifies a product version range on which other products can depend.
14509 This attribute is required in package authoring, but optional for components.
14510 </xs:documentation>
14511 </xs:annotation>
14512 </xs:attribute>
14513 <xs:attribute name="Version" type="WixVersionType">
14514 <xs:annotation>
14515 <xs:documentation>
14516 The version of the package. For MSI packages, the ProductVersion will be used by default
14517 and this attribute should not be specified.
14518 </xs:documentation>
14519 </xs:annotation>
14520 </xs:attribute>
14521 <xs:attribute name="DisplayName" type="xs:string">
14522 <xs:annotation>
14523 <xs:documentation>
14524 Optional display name of the package. For MSI packages, the ProductName will be used by default.
14525 </xs:documentation>
14526 </xs:annotation>
14527 </xs:attribute>
14528 <xs:anyAttribute namespace="##other" processContents="lax">
14529 <xs:annotation>
14530 <xs:documentation>
14531 Extensibility point in the WiX XML Schema. Schema extensions can register additional attributes at this point in the schema.
14532 </xs:documentation>
14533 </xs:annotation>
14534 </xs:anyAttribute>
14535 </xs:complexType>
14536 </xs:element>
14537 <xs:element name="Requires">
14538 <xs:annotation>
14539 <xs:documentation>
14540 Describes a dependency on a provider for the current component or package.
14541 </xs:documentation>
14542 <xs:appinfo>
14543 <xse:remarks>
14544 <html:p>
14545 This element declares a dependency on any product that uses the Provides element. If that product is uninstalled
14546 before a product that requires it, the uninstall will err or warn the user that other products are installed
14547 which depend on that product. This behavior can be modified by changing the attribute values on the Requires element.
14548 </html:p>
14549 <html:p>
14550 If you do not nest this element under a Provides element, you must specify the @Id attribute
14551 so that it can be referenced by a RequiresRef element nested under a Provides element.
14552 </html:p>
14553 </xse:remarks>
14554 <xse:seeAlso ref="RequiresRef" />
14555 <xse:howtoRef href="author_product_dependencies.html">How To: Author product dependencies</xse:howtoRef>
14556 </xs:appinfo>
14557 </xs:annotation>
14558 <xs:complexType>
14559 <xs:attribute name="Id" type="xs:string">
14560 <xs:annotation>
14561 <xs:documentation>
14562 Dependency requirement identity. If this attribute is not specified, an identifier will be generated automatically.
14563 If this element is not authored under a Provides element, this attribute is required.
14564 </xs:documentation>
14565 </xs:annotation>
14566 </xs:attribute>
14567 <xs:attribute name="ProviderKey" type="xs:string" use="required">
14568 <xs:annotation>
14569 <xs:documentation>
14570 The unique registry key name for the dependency provider to require during installation of this product.
14571 </xs:documentation>
14572 </xs:annotation>
14573 </xs:attribute>
14574 <xs:attribute name="Minimum" type="WixVersionType">
14575 <xs:annotation>
14576 <xs:documentation>
14577 The minimum version of the dependency provider required to be installed. The default is unbound.
14578 </xs:documentation>
14579 </xs:annotation>
14580 </xs:attribute>
14581 <xs:attribute name="Maximum" type="WixVersionType">
14582 <xs:annotation>
14583 <xs:documentation>
14584 The maximum version of the dependency provider required to be installed. The default is unbound.
14585 </xs:documentation>
14586 </xs:annotation>
14587 </xs:attribute>
14588 <xs:attribute name="IncludeMinimum" type="YesNoType">
14589 <xs:annotation>
14590 <xs:documentation>
14591 Set to "yes" to make the range of dependency provider versions required include the value specified in Minimum.
14592 </xs:documentation>
14593 </xs:annotation>
14594 </xs:attribute>
14595 <xs:attribute name="IncludeMaximum" type="YesNoType">
14596 <xs:annotation>
14597 <xs:documentation>
14598 Set to "yes" to make the range of dependency provider versions required include the value specified in Maximum.
14599 </xs:documentation>
14600 </xs:annotation>
14601 </xs:attribute>
14602 <xs:anyAttribute namespace="##other" processContents="lax">
14603 <xs:annotation>
14604 <xs:documentation>
14605 Extensibility point in the WiX XML Schema. Schema extensions can register additional attributes at this point in the schema.
14606 </xs:documentation>
14607 </xs:annotation>
14608 </xs:anyAttribute>
14609 </xs:complexType>
14610 </xs:element>
14611 <xs:element name="RequiresRef">
14612 <xs:annotation>
14613 <xs:documentation>
14614 References existing authoring for a dependency on a provider for the current component or package.
14615 </xs:documentation>
14616 <xs:appinfo>
14617 <xse:remarks>
14618 <html:p>
14619 This element references a dependency on any product that uses the Provides element. If that product is uninstalled
14620 before a product that requires it, the uninstall will err or warn the user that other products are installed
14621 which depend on that product. This behavior can be modified by changing the attribute values on the Requires element.
14622 </html:p>
14623 </xse:remarks>
14624 <xse:seeAlso ref="Requires" />
14625 <xse:howtoRef href="author_product_dependencies.html">How To: Author product dependencies</xse:howtoRef>
14626 </xs:appinfo>
14627 </xs:annotation>
14628 <xs:complexType>
14629 <xs:attribute name="Id" type="xs:string" use="required">
14630 <xs:annotation>
14631 <xs:documentation>
14632 The identifier of the Requires element to reference.
14633 </xs:documentation>
14634 </xs:annotation>
14635 </xs:attribute>
14636 <xs:anyAttribute namespace="##other" processContents="lax">
14637 <xs:annotation>
14638 <xs:documentation>
14639 Extensibility point in the WiX XML Schema. Schema extensions can register additional attributes at this point in the schema.
14640 </xs:documentation>
14641 </xs:annotation>
14642 </xs:anyAttribute>
14643 </xs:complexType>
14644 </xs:element>
14645</xs:schema>
generated by cgit v1.2.3-55-g6feb (git 2.39.1) at 2025-04-26 05:32:54 +0000