aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRob Mensching <rob@firegiant.com>2025-02-14 12:53:59 -0800
committerRob Mensching <rob@firegiant.com>2025-02-14 12:53:59 -0800
commit43a35021f49d23c785865cb39d232e94b5aa5c4e (patch)
treea7e6118167ad4d9e92be914bc2865b769be4658c
parent1be4e0930eb296f44b8cecd10fc9632a867149ce (diff)
downloadwix-43a35021f49d23c785865cb39d232e94b5aa5c4e.tar.gz
wix-43a35021f49d23c785865cb39d232e94b5aa5c4e.tar.bz2
wix-43a35021f49d23c785865cb39d232e94b5aa5c4e.zip
Migrate XSDs from web project
This is the new home for the XSDs. Closer to the code to hopefully be kept better up to date as changes happen to the language.
Diffstat
-rw-r--r--src/xsd/bal.xsd745
-rw-r--r--src/xsd/complus.xsd934
-rw-r--r--src/xsd/dependency.xsd40
-rw-r--r--src/xsd/difxapp.xsd119
-rw-r--r--src/xsd/directx.xsd53
-rw-r--r--src/xsd/firewall.xsd578
-rw-r--r--src/xsd/http.xsd268
-rw-r--r--src/xsd/iis.xsd1438
-rw-r--r--src/xsd/msmq.xsd153
-rw-r--r--src/xsd/netfx.xsd687
-rw-r--r--src/xsd/ps.xsd227
-rw-r--r--src/xsd/sql.xsd461
-rw-r--r--src/xsd/thmutil.xsd1365
-rw-r--r--src/xsd/ui.xsd69
-rw-r--r--src/xsd/util.xsd2536
-rw-r--r--src/xsd/vs.xsd140
-rw-r--r--src/xsd/wix.xsd14645
-rw-r--r--src/xsd/wixloc.xsd167
18 files changed, 24625 insertions, 0 deletions
diff --git a/src/xsd/bal.xsd b/src/xsd/bal.xsd
new file mode 100644
index 00000000..ff4142ad
--- /dev/null
+++ b/src/xsd/bal.xsd
@@ -0,0 +1,745 @@
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 xmlns:wxs="http://wixtoolset.org/schemas/v4/wxs"
9 targetNamespace="http://wixtoolset.org/schemas/v4/wxs/bal"
10 xmlns="http://wixtoolset.org/schemas/v4/wxs/bal">
11 <xs:annotation>
12 <xs:documentation>
13 The source code schema for the WiX Toolset Bootstrapper Applications Extension.
14 </xs:documentation>
15 </xs:annotation>
16
17 <xs:import namespace="http://wixtoolset.org/schemas/v4/wxs" />
18
19 <xs:element name="Condition">
20 <xs:annotation>
21 <xs:documentation>
22 Conditions for a bundle using WixStdBA.
23 </xs:documentation>
24 <xs:appinfo>
25 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Bundle" />
26 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
27 </xs:appinfo>
28 </xs:annotation>
29 <xs:complexType>
30 <xs:choice minOccurs="0" maxOccurs="unbounded">
31 <xs:any namespace="##other" processContents="lax">
32 <xs:annotation>
33 <xs:documentation>
34 Extensibility point in the WiX XML Schema. Schema extensions can register additional
35 elements at this point in the schema.
36 </xs:documentation>
37 </xs:annotation>
38 </xs:any>
39 </xs:choice>
40 <xs:attribute name="Message" type="xs:string" use="required">
41 <xs:annotation>
42 <xs:documentation>
43 Set the value to the text to display when the condition fails and the installation must be terminated.
44 </xs:documentation>
45 </xs:annotation>
46 </xs:attribute>
47 <xs:attribute name="Condition" type="xs:string" use="required">
48 <xs:annotation>
49 <xs:documentation>
50 The condition that must evaluate to true for the installation to continue.
51 </xs:documentation>
52 </xs:annotation>
53 </xs:attribute>
54 <xs:anyAttribute namespace="##other" processContents="lax">
55 <xs:annotation>
56 <xs:documentation>
57 Extensibility point in the WiX XML Schema. Schema extensions can register additional
58 attributes at this point in the schema.
59 </xs:documentation>
60 </xs:annotation>
61 </xs:anyAttribute>
62 </xs:complexType>
63 </xs:element>
64
65 <xs:element name="WixInternalUIBootstrapperApplication">
66 <xs:annotation>
67 <xs:documentation>
68 Uses WixInternalUIBootstrapperApplication as the Bootstrapper Application for a Bundle.
69 WixInternalUIBootstrapperApplication has no UI itself, it relies on the splash screen, prereq BA, and MSI UI.
70
71 wixiuiba is not a typical BA because it has very specific requirements for the packages in the chain.
72 There can only be one non-permanent package in the chain, and it needs to be the last package.
73 The only exception is that multiple non-permanent packages can be specified with bal:PrimaryPackageType with a specific architecture.
74 Each primary package must be an MsiPackage that contains UI for install and maintenance.
75
76 If there are permanent packages, then they are always installed through the same prereq BA that is used for the managed BA hosts before executing the primary package.
77
78 Due to Windows limitations, a splash screen should be provided so that the elevation prompt and MSI UI is automatically given focus.
79 </xs:documentation>
80 <xs:appinfo>
81 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="BootstrapperApplication" />
82 </xs:appinfo>
83 </xs:annotation>
84 <xs:complexType>
85 <xs:choice minOccurs="0" maxOccurs="unbounded">
86 <xs:any namespace="##other" processContents="lax">
87 <xs:annotation>
88 <xs:documentation>
89 Extensibility point in the WiX XML Schema. Schema extensions can register additional
90 elements at this point in the schema.
91 </xs:documentation>
92 </xs:annotation>
93 </xs:any>
94 </xs:choice>
95 <xs:attribute name="LogoFile" type="xs:string">
96 <xs:annotation>
97 <xs:documentation>Source file of the logo graphic.</xs:documentation>
98 </xs:annotation>
99 </xs:attribute>
100 <xs:attribute name="ThemeFile" type="xs:string">
101 <xs:annotation>
102 <xs:documentation>Source file of the theme XML.</xs:documentation>
103 </xs:annotation>
104 </xs:attribute>
105 <xs:attribute name="LocalizationFile" type="xs:string">
106 <xs:annotation>
107 <xs:documentation>Source file of the theme localization .wxl file.</xs:documentation>
108 </xs:annotation>
109 </xs:attribute>
110 <xs:attribute name="Theme">
111 <xs:annotation>
112 <xs:documentation>The built-in theme to use.</xs:documentation>
113 </xs:annotation>
114 <xs:simpleType>
115 <xs:restriction base="xs:NMTOKEN">
116 <xs:enumeration value="none" />
117 <xs:enumeration value="standard" />
118 </xs:restriction>
119 </xs:simpleType>
120 </xs:attribute>
121 <xs:anyAttribute namespace="##other" processContents="lax">
122 <xs:annotation>
123 <xs:documentation>
124 Extensibility point in the WiX XML Schema. Schema extensions can register additional
125 attributes at this point in the schema.
126 </xs:documentation>
127 </xs:annotation>
128 </xs:anyAttribute>
129 </xs:complexType>
130 </xs:element>
131
132 <xs:element name="WixStandardBootstrapperApplication">
133 <xs:annotation>
134 <xs:documentation>
135 Uses WixStandardBootstrapperApplication as the Bootstrapper Application for a Bundle.
136 </xs:documentation>
137 <xs:appinfo>
138 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="BootstrapperApplication" />
139 </xs:appinfo>
140 </xs:annotation>
141 <xs:complexType>
142 <xs:choice minOccurs="0" maxOccurs="unbounded">
143 <xs:any namespace="##other" processContents="lax">
144 <xs:annotation>
145 <xs:documentation>
146 Extensibility point in the WiX XML Schema. Schema extensions can register additional
147 elements at this point in the schema.
148 </xs:documentation>
149 </xs:annotation>
150 </xs:any>
151 </xs:choice>
152 <xs:attribute name="LaunchTarget" type="xs:string">
153 <xs:annotation>
154 <xs:documentation>
155 If set, the success page will show a Launch button the user can use to launch the application being installed.
156 The string value can be formatted using Burn variables enclosed in brackets,
157 to refer to installation directories and so forth.
158 </xs:documentation>
159 </xs:annotation>
160 </xs:attribute>
161 <xs:attribute name="LaunchTargetElevatedId" type="xs:string">
162 <xs:annotation>
163 <xs:documentation>
164 Id of the target ApprovedExeForElevation element.
165 If set with LaunchTarget, WixStdBA will launch the application through the Engine's LaunchApprovedExe method instead of through ShellExecute.
166 </xs:documentation>
167 </xs:annotation>
168 </xs:attribute>
169 <xs:attribute name="LaunchArguments" type="xs:string">
170 <xs:annotation>
171 <xs:documentation>
172 If set, WixStdBA will supply these arguments when launching the application specified by the LaunchTarget attribute.
173 The string value can be formatted using Burn variables enclosed in brackets,
174 to refer to installation directories and so forth.
175 </xs:documentation>
176 </xs:annotation>
177 </xs:attribute>
178 <xs:attribute name="LaunchHidden" type="wxs:YesNoTypeUnion">
179 <xs:annotation>
180 <xs:documentation>
181 If set to "yes", WixStdBA will launch the application specified by the LaunchTarget attribute with the SW_HIDE flag.
182 This attribute is ignored when the LaunchTargetElevatedId attribute is specified.
183 </xs:documentation>
184 </xs:annotation>
185 </xs:attribute>
186 <xs:attribute name="LaunchWorkingFolder" type="xs:string">
187 <xs:annotation>
188 <xs:documentation>
189 WixStdBA will use this working folder when launching the specified application.
190 The string value can be formatted using Burn variables enclosed in brackets,
191 to refer to installation directories and so forth.
192 This attribute is ignored when the LaunchTargetElevatedId attribute is specified.
193 </xs:documentation>
194 </xs:annotation>
195 </xs:attribute>
196 <xs:attribute name="LicenseFile" type="xs:string">
197 <xs:annotation>
198 <xs:documentation>Source file of the RTF license file. Cannot be used simultaneously with LicenseUrl.</xs:documentation>
199 </xs:annotation>
200 </xs:attribute>
201 <xs:attribute name="LicenseUrl" type="xs:string">
202 <xs:annotation>
203 <xs:documentation>URL target of the license link. Cannot be used simultaneously with LicenseFile. This attribute can be empty to hide the license link completely.</xs:documentation>
204 </xs:annotation>
205 </xs:attribute>
206 <xs:attribute name="LogoFile" type="xs:string">
207 <xs:annotation>
208 <xs:documentation>Source file of the logo graphic.</xs:documentation>
209 </xs:annotation>
210 </xs:attribute>
211 <xs:attribute name="LogoSideFile" type="xs:string">
212 <xs:annotation>
213 <xs:documentation>Source file of the side logo graphic.</xs:documentation>
214 </xs:annotation>
215 </xs:attribute>
216 <xs:attribute name="ThemeFile" type="xs:string">
217 <xs:annotation>
218 <xs:documentation>Source file of the theme XML.</xs:documentation>
219 </xs:annotation>
220 </xs:attribute>
221 <xs:attribute name="LocalizationFile" type="xs:string">
222 <xs:annotation>
223 <xs:documentation>Source file of the theme localization .wxl file.</xs:documentation>
224 </xs:annotation>
225 </xs:attribute>
226 <xs:attribute name="SuppressOptionsUI" type="wxs:YesNoTypeUnion">
227 <xs:annotation>
228 <xs:documentation>If set to "yes", the Options button will not be shown and the user will not be able to choose an installation directory.</xs:documentation>
229 </xs:annotation>
230 </xs:attribute>
231 <xs:attribute name="SuppressDowngradeFailure" type="wxs:YesNoTypeUnion">
232 <xs:annotation>
233 <xs:documentation>
234 If set to "yes", attempting to installer a downgraded version of a bundle will be treated as a successful do-nothing operation.
235 The default behavior (or when explicitly set to "no") is to treat downgrade attempts as failures.
236 </xs:documentation>
237 </xs:annotation>
238 </xs:attribute>
239 <xs:attribute name="SuppressRepair" type="wxs:YesNoTypeUnion">
240 <xs:annotation>
241 <xs:documentation>If set to "yes", the Repair button will not be shown in the maintenance-mode UI.</xs:documentation>
242 </xs:annotation>
243 </xs:attribute>
244 <xs:attribute name="ShowVersion" type="wxs:YesNoTypeUnion">
245 <xs:annotation>
246 <xs:documentation>If set to "yes", the application version will be displayed on the UI.</xs:documentation>
247 </xs:annotation>
248 </xs:attribute>
249 <xs:attribute name="SupportCacheOnly" type="wxs:YesNoTypeUnion">
250 <xs:annotation>
251 <xs:documentation>If set to "yes", the bundle can be pre-cached using the /cache command line argument.</xs:documentation>
252 </xs:annotation>
253 </xs:attribute>
254 <xs:attribute name="Theme" use="required">
255 <xs:annotation>
256 <xs:documentation>The built-in theme to use.</xs:documentation>
257 </xs:annotation>
258 <xs:simpleType>
259 <xs:restriction base="xs:NMTOKEN">
260 <xs:enumeration value="hyperlinkLargeLicense" />
261 <xs:enumeration value="hyperlinkLicense" />
262 <xs:enumeration value="hyperlinkSidebarLicense" />
263 <xs:enumeration value="none" />
264 <xs:enumeration value="rtfLargeLicense" />
265 <xs:enumeration value="rtfLicense" />
266 </xs:restriction>
267 </xs:simpleType>
268 </xs:attribute>
269 <xs:anyAttribute namespace="##other" processContents="lax">
270 <xs:annotation>
271 <xs:documentation>
272 Extensibility point in the WiX XML Schema. Schema extensions can register additional
273 attributes at this point in the schema.
274 </xs:documentation>
275 </xs:annotation>
276 </xs:anyAttribute>
277 </xs:complexType>
278 </xs:element>
279
280 <xs:element name="WixManagedBootstrapperApplicationHost">
281 <xs:annotation>
282 <xs:documentation>
283 Uses WixManagedBootstrapperApplicationHost as the Bootstrapper Application for a Bundle.
284
285 _Available in WiX v4. Deprecated in WiX v5; use WixPrerequisiteBootstrapperApplication instead._
286 </xs:documentation>
287 <xs:appinfo>
288 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="BootstrapperApplication" />
289 </xs:appinfo>
290 </xs:annotation>
291 <xs:complexType>
292 <xs:choice minOccurs="0" maxOccurs="unbounded">
293 <xs:any namespace="##other" processContents="lax">
294 <xs:annotation>
295 <xs:documentation>
296 Extensibility point in the WiX XML Schema. Schema extensions can register additional
297 elements at this point in the schema.
298 </xs:documentation>
299 </xs:annotation>
300 </xs:any>
301 </xs:choice>
302 <xs:attribute name="AlwaysInstallPrereqs" type="xs:string">
303 <xs:annotation>
304 <xs:documentation>
305 When not set or set to "no", the prereq BA is only used when the .NET Framework runtime can't be loaded.
306 When set to "yes", the prereq BA will always run before the .NET Framework runtime is attempted to be loaded.
307 If set to "yes" and all prereq packages are already installed, then the prereq BA's UI is not shown.
308 </xs:documentation>
309 </xs:annotation>
310 </xs:attribute>
311 <xs:attribute name="LogoFile" type="xs:string">
312 <xs:annotation>
313 <xs:documentation>Source file of the logo graphic.</xs:documentation>
314 </xs:annotation>
315 </xs:attribute>
316 <xs:attribute name="ThemeFile" type="xs:string">
317 <xs:annotation>
318 <xs:documentation>Source file of the theme XML.</xs:documentation>
319 </xs:annotation>
320 </xs:attribute>
321 <xs:attribute name="LocalizationFile" type="xs:string">
322 <xs:annotation>
323 <xs:documentation>Source file of the theme localization .wxl file.</xs:documentation>
324 </xs:annotation>
325 </xs:attribute>
326 <xs:attribute name="Theme">
327 <xs:annotation>
328 <xs:documentation>The built-in theme to use. The default is "standard".</xs:documentation>
329 </xs:annotation>
330 <xs:simpleType>
331 <xs:restriction base="xs:NMTOKEN">
332 <xs:enumeration value="none" />
333 <xs:enumeration value="standard" />
334 </xs:restriction>
335 </xs:simpleType>
336 </xs:attribute>
337 <xs:anyAttribute namespace="##other" processContents="lax">
338 <xs:annotation>
339 <xs:documentation>
340 Extensibility point in the WiX XML Schema. Schema extensions can register additional
341 attributes at this point in the schema.
342 </xs:documentation>
343 </xs:annotation>
344 </xs:anyAttribute>
345 </xs:complexType>
346 </xs:element>
347
348 <xs:element name="ManagedBootstrapperApplicationPrereqInformation">
349 <xs:annotation>
350 <xs:documentation>
351 Adds license information for a prereq package, should only be used when unable to add the license attributes to the package directly.
352
353 _Available in WiX v4. Deprecated in WiX v5; use BootstrapperApplicationPrerequisiteInformation instead._
354 </xs:documentation>
355 <xs:appinfo>
356 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Bundle" />
357 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
358 </xs:appinfo>
359 </xs:annotation>
360 <xs:complexType>
361 <xs:choice minOccurs="0" maxOccurs="unbounded">
362 <xs:any namespace="##other" processContents="lax">
363 <xs:annotation>
364 <xs:documentation>
365 Extensibility point in the WiX XML Schema. Schema extensions can register additional
366 elements at this point in the schema.
367 </xs:documentation>
368 </xs:annotation>
369 </xs:any>
370 </xs:choice>
371 <xs:attribute name="PackageId" type="xs:string" use="required">
372 <xs:annotation>
373 <xs:documentation>Id of the target package.</xs:documentation>
374 </xs:annotation>
375 </xs:attribute>
376 <xs:attribute name="LicenseFile" type="xs:string">
377 <xs:annotation>
378 <xs:documentation>Source file of the license. May not be used with LicenseUrl.</xs:documentation>
379 </xs:annotation>
380 </xs:attribute>
381 <xs:attribute name="LicenseUrl" type="xs:string">
382 <xs:annotation>
383 <xs:documentation>Source url of the license. May not be used with LicenseFile.</xs:documentation>
384 </xs:annotation>
385 </xs:attribute>
386 <xs:anyAttribute namespace="##other" processContents="lax">
387 <xs:annotation>
388 <xs:documentation>
389 Extensibility point in the WiX XML Schema. Schema extensions can register additional
390 attributes at this point in the schema.
391 </xs:documentation>
392 </xs:annotation>
393 </xs:anyAttribute>
394 </xs:complexType>
395 </xs:element>
396
397 <xs:element name="WixDotNetCoreBootstrapperApplicationHost">
398 <xs:annotation>
399 <xs:documentation>
400 Uses WixDotNetCoreBootstrapperApplicationHost as the Bootstrapper Application for a Bundle.
401
402 _Available in WiX v4. Deprecated in WiX v5; use WixPrerequisiteBootstrapperApplication instead._
403 </xs:documentation>
404 <xs:appinfo>
405 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="BootstrapperApplication" />
406 </xs:appinfo>
407 </xs:annotation>
408 <xs:complexType>
409 <xs:choice minOccurs="0" maxOccurs="unbounded">
410 <xs:any namespace="##other" processContents="lax">
411 <xs:annotation>
412 <xs:documentation>
413 Extensibility point in the WiX XML Schema. Schema extensions can register additional
414 elements at this point in the schema.
415 </xs:documentation>
416 </xs:annotation>
417 </xs:any>
418 </xs:choice>
419 <xs:attribute name="AlwaysInstallPrereqs" type="wxs:YesNoTypeUnion">
420 <xs:annotation>
421 <xs:documentation>
422 When not set or set to "no", the prereq BA is only used when the .NET Core runtime can't be loaded.
423 When set to "yes", the prereq BA will always run before the .NET Core runtime is attempted to be loaded.
424 If set to "yes" and all prereq packages are already installed, then the prereq BA's UI is not shown.
425 </xs:documentation>
426 </xs:annotation>
427 </xs:attribute>
428 <xs:attribute name="LogoFile" type="xs:string">
429 <xs:annotation>
430 <xs:documentation>Source file of the logo graphic.</xs:documentation>
431 </xs:annotation>
432 </xs:attribute>
433 <xs:attribute name="ThemeFile" type="xs:string">
434 <xs:annotation>
435 <xs:documentation>Source file of the theme XML.</xs:documentation>
436 </xs:annotation>
437 </xs:attribute>
438 <xs:attribute name="LocalizationFile" type="xs:string">
439 <xs:annotation>
440 <xs:documentation>Source file of the theme localization .wxl file.</xs:documentation>
441 </xs:annotation>
442 </xs:attribute>
443 <xs:attribute name="SelfContainedDeployment" type="wxs:YesNoTypeUnion">
444 <xs:annotation>
445 <xs:documentation>
446 Whether the .NET Core BA was published as self-contained (SCD).
447 </xs:documentation>
448 </xs:annotation>
449 </xs:attribute>
450 <xs:attribute name="Theme">
451 <xs:annotation>
452 <xs:documentation>The built-in theme to use. The default value is "standard".</xs:documentation>
453 </xs:annotation>
454 <xs:simpleType>
455 <xs:restriction base="xs:NMTOKEN">
456 <xs:enumeration value="none" />
457 <xs:enumeration value="standard" />
458 </xs:restriction>
459 </xs:simpleType>
460 </xs:attribute>
461 <xs:anyAttribute namespace="##other" processContents="lax">
462 <xs:annotation>
463 <xs:documentation>
464 Extensibility point in the WiX XML Schema. Schema extensions can register additional
465 attributes at this point in the schema.
466 </xs:documentation>
467 </xs:annotation>
468 </xs:anyAttribute>
469 </xs:complexType>
470 </xs:element>
471
472 <xs:element name="WixPrerequisiteBootstrapperApplication">
473 <xs:annotation>
474 <xs:documentation>
475 Uses WixPrerequisiteBootstrapperApplication as a secondary Bootstrapper Application for a Bundle,
476 to bootstrap the prerequisites needed for a primary bootstrapper application.
477
478 _Available in WiX v5._
479 </xs:documentation>
480 <xs:appinfo>
481 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="BootstrapperApplication" />
482 </xs:appinfo>
483 </xs:annotation>
484 <xs:complexType>
485 <xs:choice minOccurs="0" maxOccurs="unbounded">
486 <xs:any namespace="##other" processContents="lax">
487 <xs:annotation>
488 <xs:documentation>
489 Extensibility point in the WiX XML Schema. Schema extensions can register additional
490 elements at this point in the schema.
491 </xs:documentation>
492 </xs:annotation>
493 </xs:any>
494 </xs:choice>
495 <xs:attribute name="LogoFile" type="xs:string">
496 <xs:annotation>
497 <xs:documentation>Source file of the logo graphic.</xs:documentation>
498 </xs:annotation>
499 </xs:attribute>
500 <xs:attribute name="ThemeFile" type="xs:string">
501 <xs:annotation>
502 <xs:documentation>Source file of the theme XML.</xs:documentation>
503 </xs:annotation>
504 </xs:attribute>
505 <xs:attribute name="LocalizationFile" type="xs:string">
506 <xs:annotation>
507 <xs:documentation>Source file of the theme localization .wxl file.</xs:documentation>
508 </xs:annotation>
509 </xs:attribute>
510 <xs:attribute name="Theme">
511 <xs:annotation>
512 <xs:documentation>The built-in theme to use. The default is "standard".</xs:documentation>
513 </xs:annotation>
514 <xs:simpleType>
515 <xs:restriction base="xs:NMTOKEN">
516 <xs:enumeration value="none" />
517 <xs:enumeration value="standard" />
518 </xs:restriction>
519 </xs:simpleType>
520 </xs:attribute>
521 <xs:anyAttribute namespace="##other" processContents="lax">
522 <xs:annotation>
523 <xs:documentation>
524 Extensibility point in the WiX XML Schema. Schema extensions can register additional
525 attributes at this point in the schema.
526 </xs:documentation>
527 </xs:annotation>
528 </xs:anyAttribute>
529 </xs:complexType>
530 </xs:element>
531
532 <xs:element name="BootstrapperApplicationPrerequisiteInformation">
533 <xs:annotation>
534 <xs:documentation>
535 Adds license information for a prereq package, should only be used when unable to add the license attributes to the package directly.
536
537 _Available in WiX v5._
538 </xs:documentation>
539 <xs:appinfo>
540 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Bundle" />
541 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
542 </xs:appinfo>
543 </xs:annotation>
544 <xs:complexType>
545 <xs:choice minOccurs="0" maxOccurs="unbounded">
546 <xs:any namespace="##other" processContents="lax">
547 <xs:annotation>
548 <xs:documentation>
549 Extensibility point in the WiX XML Schema. Schema extensions can register additional
550 elements at this point in the schema.
551 </xs:documentation>
552 </xs:annotation>
553 </xs:any>
554 </xs:choice>
555 <xs:attribute name="PackageId" type="xs:string" use="required">
556 <xs:annotation>
557 <xs:documentation>Id of the target package.</xs:documentation>
558 </xs:annotation>
559 </xs:attribute>
560 <xs:attribute name="LicenseFile" type="xs:string">
561 <xs:annotation>
562 <xs:documentation>Source file of the license. May not be used with LicenseUrl.</xs:documentation>
563 </xs:annotation>
564 </xs:attribute>
565 <xs:attribute name="LicenseUrl" type="xs:string">
566 <xs:annotation>
567 <xs:documentation>Source url of the license. May not be used with LicenseFile.</xs:documentation>
568 </xs:annotation>
569 </xs:attribute>
570 <xs:anyAttribute namespace="##other" processContents="lax">
571 <xs:annotation>
572 <xs:documentation>
573 Extensibility point in the WiX XML Schema. Schema extensions can register additional
574 attributes at this point in the schema.
575 </xs:documentation>
576 </xs:annotation>
577 </xs:anyAttribute>
578 </xs:complexType>
579 </xs:element>
580
581 <xs:attribute name="BAFactoryAssembly" type="wxs:YesNoTypeUnion">
582 <xs:annotation>
583 <xs:documentation>
584 When set to "yes", WixDotNetCoreBootstrapperApplicationHost will load the DLL and instantiate the type with the BootstrapperApplicationFactoryAttribute.
585 The DLL must have been built referencing the WixToolset.Dnc.HostGenerator source generator NuGet package.
586 The .NET Core project must have been published, not just built.
587 Only one payload may be marked with this attribute set to "yes".
588
589 _Available in WiX v4. Deprecated in WiX v5. Move the Payload/@SourceFile attribute to be the BootstrapperApplication/@SourceFile attribute and remove the Payload element._
590 </xs:documentation>
591 <xs:appinfo>
592 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Payload" />
593 </xs:appinfo>
594 </xs:annotation>
595 </xs:attribute>
596
597 <xs:attribute name="BAFunctions" type="wxs:YesNoTypeUnion">
598 <xs:annotation>
599 <xs:documentation>
600 When set to "yes", WixStdBA will load the DLL and work with it to handle BA messages.
601 Only one payload may be marked with this attribute set to "yes".
602 </xs:documentation>
603 <xs:appinfo>
604 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Payload" />
605 </xs:appinfo>
606 </xs:annotation>
607 </xs:attribute>
608
609 <xs:attribute name="CommandLineVariables">
610 <xs:annotation>
611 <xs:documentation>
612 This value determines whether case sensitivity is used to match overridable variables specified on the command line. The default is "caseSensitive".
613 </xs:documentation>
614 <xs:appinfo>
615 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Bundle" />
616 </xs:appinfo>
617 </xs:annotation>
618 <xs:simpleType>
619 <xs:restriction base="xs:NMTOKEN">
620 <xs:enumeration value="caseSensitive" />
621 <xs:enumeration value="caseInsensitive" />
622 </xs:restriction>
623 </xs:simpleType>
624 </xs:attribute>
625
626 <xs:attribute name="DisplayInternalUICondition" type="xs:string">
627 <xs:annotation>
628 <xs:documentation>
629 Specifies whether the bundle will show the UI authored into the msi package. If not specified or the condition evaluates
630 to false, all information is routed to the bootstrapper application to provide a unified installation experience.
631 Otherwise, the UI authored into the msi package will be displayed on top of any bootstrapper application UI.
632 WixStdBA doesn't support EmbeddedUI.
633 </xs:documentation>
634 <xs:appinfo>
635 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="MsiPackage" />
636 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="MspPackage" />
637 </xs:appinfo>
638 </xs:annotation>
639 </xs:attribute>
640
641 <xs:attribute name="Overridable" type="wxs:YesNoTypeUnion">
642 <xs:annotation>
643 <xs:documentation>
644 When set to "yes", lets the user override the variable's default value by specifying another value on the command line,
645 in the form Variable=Value. Otherwise, WixStdBA won't overwrite the default value and will log
646 "Ignoring attempt to set non-overridable variable: 'BAR'."
647 </xs:documentation>
648 <xs:appinfo>
649 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Variable" />
650 </xs:appinfo>
651 </xs:annotation>
652 </xs:attribute>
653
654 <xs:attribute name="PrereqLicenseFile" type="xs:string">
655 <xs:annotation>
656 <xs:documentation>
657 Source file of the RTF license file.
658 There may only be one package in the bundle that has either the PrereqLicenseFile attribute or the PrereqLicenseUrl attribute.
659 </xs:documentation>
660 <xs:appinfo>
661 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="BundlePackage" />
662 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="ExePackage" />
663 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="MsiPackage" />
664 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="MspPackage" />
665 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="MsuPackage" />
666 </xs:appinfo>
667 </xs:annotation>
668 </xs:attribute>
669
670 <xs:attribute name="PrereqLicenseUrl" type="xs:string">
671 <xs:annotation>
672 <xs:documentation>
673 URL target of the license link.
674 There may only be one package in the bundle that has either the PrereqLicenseFile attribute or the PrereqLicenseUrl attribute.
675 </xs:documentation>
676 <xs:appinfo>
677 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="BundlePackage" />
678 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="ExePackage" />
679 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="MsiPackage" />
680 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="MspPackage" />
681 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="MsuPackage" />
682 </xs:appinfo>
683 </xs:annotation>
684 </xs:attribute>
685
686 <xs:attribute name="PrereqPackage" type="wxs:YesNoTypeUnion">
687 <xs:annotation>
688 <xs:documentation>
689 When set to "yes", the Prereq BA will plan the package to be installed if its InstallCondition is "true" or empty.
690 </xs:documentation>
691 <xs:appinfo>
692 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="BundlePackage" />
693 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="ExePackage" />
694 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="MsiPackage" />
695 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="MspPackage" />
696 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="MsuPackage" />
697 </xs:appinfo>
698 </xs:annotation>
699 </xs:attribute>
700
701 <xs:attribute name="PrimaryPackageType">
702 <xs:annotation>
703 <xs:documentation>Used by WixInternalUIBootstrapperApplication to determine which package is the primary package. The default value is "default".</xs:documentation>
704 <xs:appinfo>
705 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="BundlePackage" />
706 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="ExePackage" />
707 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="MsiPackage" />
708 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="MspPackage" />
709 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="MsuPackage" />
710 </xs:appinfo>
711 </xs:annotation>
712 <xs:simpleType>
713 <xs:restriction base="xs:NMTOKEN">
714 <xs:enumeration value="default">
715 <xs:annotation>
716 <xs:documentation>
717 This package is used unless there is a package for the runtime machine's architecture.
718 </xs:documentation>
719 </xs:annotation>
720 </xs:enumeration>
721 <xs:enumeration value="x86">
722 <xs:annotation>
723 <xs:documentation>
724 This package is used when the runtime machine's OS is x86 (IMAGE_FILE_MACHINE_I386).
725 </xs:documentation>
726 </xs:annotation>
727 </xs:enumeration>
728 <xs:enumeration value="x64">
729 <xs:annotation>
730 <xs:documentation>
731 This package is used when the runtime machine's OS is x64 (IMAGE_FILE_MACHINE_AMD64).
732 </xs:documentation>
733 </xs:annotation>
734 </xs:enumeration>
735 <xs:enumeration value="arm64">
736 <xs:annotation>
737 <xs:documentation>
738 This package is used when the runtime machine's OS is ARM64 (IMAGE_FILE_MACHINE_ARM64).
739 </xs:documentation>
740 </xs:annotation>
741 </xs:enumeration>
742 </xs:restriction>
743 </xs:simpleType>
744 </xs:attribute>
745</xs:schema>
diff --git a/src/xsd/complus.xsd b/src/xsd/complus.xsd
new file mode 100644
index 00000000..5e658aed
--- /dev/null
+++ b/src/xsd/complus.xsd
@@ -0,0 +1,934 @@
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 xmlns:wxs="http://wixtoolset.org/schemas/v4/wxs"
9 targetNamespace="http://wixtoolset.org/schemas/v4/wxs/complus"
10 xmlns="http://wixtoolset.org/schemas/v4/wxs/complus">
11 <xs:annotation>
12 <xs:documentation>
13 The source code schema for the WiX Toolset COM+ Extension.
14 </xs:documentation>
15 </xs:annotation>
16
17 <xs:import namespace="http://wixtoolset.org/schemas/v4/wxs" />
18
19 <xs:element name="ComPlusPartition">
20 <xs:annotation>
21 <xs:appinfo>
22 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
23 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
24 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Module" />
25 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Package" />
26 </xs:appinfo>
27 <xs:documentation>
28 Defines a COM+ partition. If this element is a child of a
29 Component element, the partition will be created in association with this
30 component. If the element is a child of any of the Fragment, Module, or Package
31 elements it is considered to be a locater, referencing an existing partition.
32 </xs:documentation>
33 </xs:annotation>
34 <xs:complexType>
35 <xs:sequence>
36 <xs:choice minOccurs="0" maxOccurs="unbounded">
37 <xs:element ref="ComPlusPartitionRole" />
38 <xs:element ref="ComPlusPartitionUser" />
39 <xs:element ref="ComPlusApplication" />
40 </xs:choice>
41 </xs:sequence>
42 <xs:attribute name="Id" use="required" type="xs:string">
43 <xs:annotation><xs:documentation>
44 Identifier for the element.
45 </xs:documentation></xs:annotation>
46 </xs:attribute>
47 <xs:attribute name="PartitionId" use="optional" type="xs:string">
48 <xs:annotation><xs:documentation>
49 Id for the partition. This attribute can be omitted, in
50 which case an id will be generated on install. If the element is a locater,
51 this attribute can be omitted if a value is provided for the Name attribute.
52 </xs:documentation></xs:annotation>
53 </xs:attribute>
54 <xs:attribute name="Name" use="optional" type="xs:string">
55 <xs:annotation><xs:documentation>
56 Name of the partition. This attribute can be omitted if
57 the element is a locater, and a value is provided for the PartitionId
58 attribute.
59 </xs:documentation></xs:annotation>
60 </xs:attribute>
61 <xs:attribute name="Changeable" use="optional" type="wxs:YesNoTypeUnion" />
62 <xs:attribute name="Deleteable" use="optional" type="wxs:YesNoTypeUnion" />
63 <xs:attribute name="Description" use="optional" type="xs:string" />
64 </xs:complexType>
65 </xs:element>
66
67 <xs:element name="ComPlusPartitionRole">
68 <xs:annotation>
69 <xs:appinfo>
70 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
71 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
72 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Module" />
73 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Package" />
74 </xs:appinfo>
75 <xs:documentation>
76 Defines a COM+ partition role. Partition roles can not be
77 created; this element can only be used as a locater to reference an existing
78 role.
79 </xs:documentation>
80 </xs:annotation>
81 <xs:complexType>
82 <xs:sequence>
83 <xs:choice minOccurs="0" maxOccurs="unbounded">
84 <xs:element ref="ComPlusUserInPartitionRole" />
85 <xs:element ref="ComPlusGroupInPartitionRole" />
86 </xs:choice>
87 </xs:sequence>
88 <xs:attribute name="Id" use="required" type="xs:string">
89 <xs:annotation><xs:documentation>
90 Identifier for the element.
91 </xs:documentation></xs:annotation>
92 </xs:attribute>
93 <xs:attribute name="Partition" use="optional" type="xs:string">
94 <xs:annotation><xs:documentation>
95 The id of a ComPlusPartition element representing the partition
96 the role belongs to.
97 </xs:documentation></xs:annotation>
98 </xs:attribute>
99 <xs:attribute name="Name" use="required" type="xs:string">
100 <xs:annotation><xs:documentation>
101 Name of the partition role.
102 </xs:documentation></xs:annotation>
103 </xs:attribute>
104 </xs:complexType>
105 </xs:element>
106
107 <xs:element name="ComPlusUserInPartitionRole">
108 <xs:annotation>
109 <xs:appinfo>
110 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
111 </xs:appinfo>
112 <xs:documentation>
113 This element represents a user membership in a partition
114 role. When the parent component of this element is installed, the user will be
115 added to the associated partition role.
116 </xs:documentation>
117 </xs:annotation>
118 <xs:complexType>
119 <xs:attribute name="Id" use="required" type="xs:string">
120 <xs:annotation><xs:documentation>
121 Identifier for the element.
122 </xs:documentation></xs:annotation>
123 </xs:attribute>
124 <xs:attribute name="PartitionRole" use="optional" type="xs:string">
125 <xs:annotation><xs:documentation>
126 The id of a ComPlusPartitionRole element representing the
127 partition the user should be added to.
128 </xs:documentation></xs:annotation>
129 </xs:attribute>
130 <xs:attribute name="User" use="required" type="xs:string">
131 <xs:annotation><xs:documentation>
132 Foreign key into the User table.
133 </xs:documentation></xs:annotation>
134 </xs:attribute>
135 </xs:complexType>
136 </xs:element>
137
138 <xs:element name="ComPlusGroupInPartitionRole">
139 <xs:annotation>
140 <xs:appinfo>
141 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
142 </xs:appinfo>
143 <xs:documentation>
144 This element represents a security group membership in a
145 partition role. When the parent component of this element is installed, the
146 security group will be added to the associated partition role.
147 </xs:documentation>
148 </xs:annotation>
149 <xs:complexType>
150 <xs:attribute name="Id" use="required" type="xs:string">
151 <xs:annotation><xs:documentation>
152 Identifier for the element.
153 </xs:documentation></xs:annotation>
154 </xs:attribute>
155 <xs:attribute name="PartitionRole" use="optional" type="xs:string">
156 <xs:annotation><xs:documentation>
157 The id of a ComPlusPartitionRole element representing the
158 partition the user should be added to.
159 </xs:documentation></xs:annotation>
160 </xs:attribute>
161 <xs:attribute name="Group" use="required" type="xs:string">
162 <xs:annotation><xs:documentation>
163 Foreign key into the Group table.
164 </xs:documentation></xs:annotation>
165 </xs:attribute>
166 </xs:complexType>
167 </xs:element>
168
169 <xs:element name="ComPlusPartitionUser">
170 <xs:annotation>
171 <xs:appinfo>
172 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
173 </xs:appinfo>
174 <xs:documentation>
175 Represents a default partition definition for a user. When
176 the parent component of this element is installed, the default partition of the
177 user will be set to the referenced partition.
178 </xs:documentation>
179 </xs:annotation>
180 <xs:complexType>
181 <xs:attribute name="Id" use="required" type="xs:string">
182 <xs:annotation><xs:documentation>
183 Identifier for the element.
184 </xs:documentation></xs:annotation>
185 </xs:attribute>
186 <xs:attribute name="Partition" use="optional" type="xs:string">
187 <xs:annotation><xs:documentation>
188 The id of a ComPlusPartition element representing the
189 partition that will be the default partition for the user.
190 </xs:documentation></xs:annotation>
191 </xs:attribute>
192 <xs:attribute name="User" use="required" type="xs:string">
193 <xs:annotation><xs:documentation>
194 Foreign key into the User table.
195 </xs:documentation></xs:annotation>
196 </xs:attribute>
197 </xs:complexType>
198 </xs:element>
199
200 <xs:element name="ComPlusApplication">
201 <xs:annotation>
202 <xs:appinfo>
203 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
204 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
205 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Module" />
206 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Package" />
207 </xs:appinfo>
208 <xs:documentation>
209 Defines a COM+ application. If this element is a descendent
210 of a Component element, the application will be created in association with
211 this component. If the element is a child of any of the Fragment, Module, or
212 Package elements it is considered to be a locater, referencing an existing
213 application.
214
215 If the element is a child of a ComPlusPartition element,
216 or have its Partition attribute set, the application will be installed under
217 the referenced partition.
218 </xs:documentation>
219 </xs:annotation>
220 <xs:complexType>
221 <xs:sequence>
222 <xs:choice minOccurs="0" maxOccurs="unbounded">
223 <xs:element ref="ComPlusApplicationRole" />
224 <xs:element ref="ComPlusAssembly" />
225 </xs:choice>
226 </xs:sequence>
227 <xs:attribute name="Id" use="required" type="xs:string">
228 <xs:annotation><xs:documentation>
229 Identifier for the element.
230 </xs:documentation></xs:annotation>
231 </xs:attribute>
232 <xs:attribute name="Partition" use="optional" type="xs:string">
233 <xs:annotation><xs:documentation>
234 If the element is not a child of a ComPlusPartition
235 element, this attribute can be provided with the id of a ComPlusPartition
236 element representing the partition the application belongs to.
237 </xs:documentation></xs:annotation>
238 </xs:attribute>
239 <xs:attribute name="ApplicationId" use="optional" type="xs:string">
240 <xs:annotation><xs:documentation>
241 Id for the application. This attribute can be omitted, in
242 which case an id will be generated on install. If the element is a locater,
243 this attribute can be omitted if a value is provided for the Name attribute.
244 </xs:documentation></xs:annotation>
245 </xs:attribute>
246 <xs:attribute name="Name" use="optional" type="xs:string">
247 <xs:annotation><xs:documentation>
248 Name of the application. This attribute can be omitted if
249 the element is a locater, and a value is provided for the PartitionId
250 attribute.
251 </xs:documentation></xs:annotation>
252 </xs:attribute>
253 <xs:attribute name="ThreeGigSupportEnabled" use="optional" type="wxs:YesNoTypeUnion" />
254 <xs:attribute name="AccessChecksLevel" use="optional">
255 <xs:simpleType>
256 <xs:restriction base="xs:NMTOKEN">
257 <xs:enumeration value="applicationLevel" />
258 <xs:enumeration value="applicationComponentLevel" />
259 </xs:restriction>
260 </xs:simpleType>
261 </xs:attribute>
262 <xs:attribute name="Activation" use="optional">
263 <xs:simpleType>
264 <xs:restriction base="xs:NMTOKEN">
265 <xs:enumeration value="inproc" />
266 <xs:enumeration value="local" />
267 </xs:restriction>
268 </xs:simpleType>
269 </xs:attribute>
270 <xs:attribute name="ApplicationAccessChecksEnabled" use="optional" type="wxs:YesNoTypeUnion" />
271 <xs:attribute name="ApplicationDirectory" use="optional" type="xs:string" />
272 <xs:attribute name="Authentication" use="optional">
273 <xs:simpleType>
274 <xs:restriction base="xs:NMTOKEN">
275 <xs:enumeration value="default" />
276 <xs:enumeration value="none" />
277 <xs:enumeration value="connect" />
278 <xs:enumeration value="call" />
279 <xs:enumeration value="packet" />
280 <xs:enumeration value="integrity" />
281 <xs:enumeration value="privacy" />
282 </xs:restriction>
283 </xs:simpleType>
284 </xs:attribute>
285 <xs:attribute name="AuthenticationCapability" use="optional">
286 <xs:simpleType>
287 <xs:restriction base="xs:NMTOKEN">
288 <xs:enumeration value="none" />
289 <xs:enumeration value="secureReference" />
290 <xs:enumeration value="staticCloaking" />
291 <xs:enumeration value="dynamicCloaking" />
292 </xs:restriction>
293 </xs:simpleType>
294 </xs:attribute>
295 <xs:attribute name="Changeable" use="optional" type="wxs:YesNoTypeUnion" />
296 <xs:attribute name="CommandLine" use="optional" type="xs:string" />
297 <xs:attribute name="ConcurrentApps" use="optional" type="xs:int" />
298 <xs:attribute name="CreatedBy" use="optional" type="xs:string" />
299 <xs:attribute name="CRMEnabled" use="optional" type="wxs:YesNoTypeUnion" />
300 <xs:attribute name="CRMLogFile" use="optional" type="xs:string" />
301 <xs:attribute name="Deleteable" use="optional" type="wxs:YesNoTypeUnion" />
302 <xs:attribute name="Description" use="optional" type="xs:string" />
303 <xs:attribute name="DumpEnabled" use="optional" type="wxs:YesNoTypeUnion" />
304 <xs:attribute name="DumpOnException" use="optional" type="wxs:YesNoTypeUnion" />
305 <xs:attribute name="DumpOnFailfast" use="optional" type="wxs:YesNoTypeUnion" />
306 <xs:attribute name="DumpPath" use="optional" type="xs:string" />
307 <xs:attribute name="EventsEnabled" use="optional" type="wxs:YesNoTypeUnion" />
308 <xs:attribute name="Identity" use="optional" type="xs:string" />
309 <xs:attribute name="ImpersonationLevel" use="optional">
310 <xs:simpleType>
311 <xs:restriction base="xs:NMTOKEN">
312 <xs:enumeration value="anonymous" />
313 <xs:enumeration value="identify" />
314 <xs:enumeration value="impersonate" />
315 <xs:enumeration value="delegate" />
316 </xs:restriction>
317 </xs:simpleType>
318 </xs:attribute>
319 <xs:attribute name="IsEnabled" use="optional" type="wxs:YesNoTypeUnion" />
320 <xs:attribute name="MaxDumpCount" use="optional" type="xs:int" />
321 <xs:attribute name="Password" use="optional" type="xs:string" />
322 <xs:attribute name="QCAuthenticateMsgs" use="optional">
323 <xs:simpleType>
324 <xs:restriction base="xs:NMTOKEN">
325 <xs:enumeration value="secureApps" />
326 <xs:enumeration value="off" />
327 <xs:enumeration value="on" />
328 </xs:restriction>
329 </xs:simpleType>
330 </xs:attribute>
331 <xs:attribute name="QCListenerMaxThreads" use="optional" type="xs:int" />
332 <xs:attribute name="QueueListenerEnabled" use="optional" type="wxs:YesNoTypeUnion" />
333 <xs:attribute name="QueuingEnabled" use="optional" type="wxs:YesNoTypeUnion" />
334 <xs:attribute name="RecycleActivationLimit" use="optional" type="xs:int" />
335 <xs:attribute name="RecycleCallLimit" use="optional" type="xs:int" />
336 <xs:attribute name="RecycleExpirationTimeout" use="optional" type="xs:int" />
337 <xs:attribute name="RecycleLifetimeLimit" use="optional" type="xs:int" />
338 <xs:attribute name="RecycleMemoryLimit" use="optional" type="xs:int" />
339 <xs:attribute name="Replicable" use="optional" type="wxs:YesNoTypeUnion" />
340 <xs:attribute name="RunForever" use="optional" type="wxs:YesNoTypeUnion" />
341 <xs:attribute name="ShutdownAfter" use="optional" type="xs:int" />
342 <xs:attribute name="SoapActivated" use="optional" type="wxs:YesNoTypeUnion" />
343 <xs:attribute name="SoapBaseUrl" use="optional" type="xs:string" />
344 <xs:attribute name="SoapMailTo" use="optional" type="xs:string" />
345 <xs:attribute name="SoapVRoot" use="optional" type="xs:string" />
346 <xs:attribute name="SRPEnabled" use="optional" type="wxs:YesNoTypeUnion" />
347 <xs:attribute name="SRPTrustLevel" use="optional">
348 <xs:simpleType>
349 <xs:restriction base="xs:NMTOKEN">
350 <xs:enumeration value="disallowed" />
351 <xs:enumeration value="fullyTrusted" />
352 </xs:restriction>
353 </xs:simpleType>
354 </xs:attribute>
355 </xs:complexType>
356 </xs:element>
357
358 <xs:element name="ComPlusApplicationRole">
359 <xs:annotation>
360 <xs:appinfo>
361 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
362 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
363 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Module" />
364 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Package" />
365 </xs:appinfo>
366 <xs:documentation>
367 Defines an application role. If this element is a descendent
368 of a Component element, the application role will be created in association
369 with this component. If the element is a child of any of the Fragment, Module,
370 or Package elements it is considered to be a locater, referencing an existing
371 application role.
372 </xs:documentation>
373 </xs:annotation>
374 <xs:complexType>
375 <xs:sequence>
376 <xs:choice minOccurs="0" maxOccurs="unbounded">
377 <xs:element ref="ComPlusUserInApplicationRole" />
378 <xs:element ref="ComPlusGroupInApplicationRole" />
379 </xs:choice>
380 </xs:sequence>
381 <xs:attribute name="Id" use="required" type="xs:string">
382 <xs:annotation><xs:documentation>
383 Identifier for the element.
384 </xs:documentation></xs:annotation>
385 </xs:attribute>
386 <xs:attribute name="Application" use="optional" type="xs:string">
387 <xs:annotation><xs:documentation>
388 If the element is not a child of a ComPlusApplication
389 element, this attribute should be provided with the id of a
390 ComPlusApplication element representing the application the role belongs to.
391 </xs:documentation></xs:annotation>
392 </xs:attribute>
393 <xs:attribute name="Name" use="required" type="xs:string">
394 <xs:annotation><xs:documentation>
395 Name of the application role.
396 </xs:documentation></xs:annotation>
397 </xs:attribute>
398 <xs:attribute name="Description" use="optional" type="xs:string" />
399 </xs:complexType>
400 </xs:element>
401
402 <xs:element name="ComPlusUserInApplicationRole">
403 <xs:annotation>
404 <xs:appinfo>
405 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
406 </xs:appinfo>
407 <xs:documentation>
408 This element represents a user membership in an
409 application role. When the parent component of this element is installed, the
410 user will be added to the associated application role. This element must be a descendent
411 of a Component element; it can not be a child of a ComPlusApplicationRole
412 locater element. To reference a locater element use the ApplicationRole
413 attribute.
414 </xs:documentation>
415 </xs:annotation>
416 <xs:complexType>
417 <xs:attribute name="Id" use="required" type="xs:string">
418 <xs:annotation><xs:documentation>
419 Identifier for the element.
420 </xs:documentation></xs:annotation>
421 </xs:attribute>
422 <xs:attribute name="ApplicationRole" use="optional" type="xs:string">
423 <xs:annotation><xs:documentation>
424 If the element is not a child of a ComPlusApplicationRole
425 element, this attribute should be provided with the id of a
426 ComPlusApplicationRole element representing the application role the user is
427 to be added to.
428 </xs:documentation></xs:annotation>
429 </xs:attribute>
430 <xs:attribute name="User" use="required" type="xs:string">
431 <xs:annotation><xs:documentation>
432 Foreign key into the User table.
433 </xs:documentation></xs:annotation>
434 </xs:attribute>
435 </xs:complexType>
436 </xs:element>
437
438 <xs:element name="ComPlusGroupInApplicationRole">
439 <xs:annotation>
440 <xs:appinfo>
441 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
442 </xs:appinfo>
443 <xs:documentation>
444 This element represents a security group membership in an
445 application role. When the parent component of this element is installed, the
446 user will be added to the associated application role. This element must be a
447 descendent of a Component element; it can not be a child of a
448 ComPlusApplicationRole locater element. To reference a locater element use the
449 ApplicationRole attribute.
450 </xs:documentation>
451 </xs:annotation>
452 <xs:complexType>
453 <xs:attribute name="Id" use="required" type="xs:string">
454 <xs:annotation><xs:documentation>
455 Identifier for the element.
456 </xs:documentation></xs:annotation>
457 </xs:attribute>
458 <xs:attribute name="ApplicationRole" use="optional" type="xs:string">
459 <xs:annotation><xs:documentation>
460 If the element is not a child of a ComPlusApplicationRole
461 element, this attribute should be provided with the id of a
462 ComPlusApplicationRole element representing the application role the user is
463 to be added to.
464 </xs:documentation></xs:annotation>
465 </xs:attribute>
466 <xs:attribute name="Group" use="required" type="xs:string">
467 <xs:annotation><xs:documentation>
468 Foreign key into the Group table.
469 </xs:documentation></xs:annotation>
470 </xs:attribute>
471 </xs:complexType>
472 </xs:element>
473
474 <xs:element name="ComPlusAssembly">
475 <xs:annotation>
476 <xs:documentation>
477 Represents a DLL or assembly to be registered with COM+. If
478 this element is a child of a ComPlusApplication element, the assembly will be
479 registered in this application. Other ways the Application attribute must be
480 set to an application. The element must be a descendent of a Component element,
481 it can not be a child of a ComPlusApplication locator element.
482 </xs:documentation>
483 <xs:appinfo>
484 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
485 <xse:remarks>
486 <html:p>
487 When installing a native assembly, all components
488 contained in the assembly must be represented as ComPlusComponent elements
489 under this element. Any component not listed will not be removed during
490 uninstall.
491 </html:p>
492
493 <html:p>
494 The fields DllPath, TlbPath and PSDllPath are formatted
495 fields that should contain file paths to there respective file types. A typical
496 value for DllPath for example, should be something like “[#MyAssembly_dll]”,
497 where “MyAssembly_dll” is the key of the dll file in the File table.
498 </html:p>
499
500 <html:p>
501 <html:b>Warning</html:b>: The assembly name provided in the AssemblyName
502 attribute must be a fully specified assembly name, if a partial name is
503 provided a random assembly matching the partial name will be selected.
504 </html:p>
505 </xse:remarks>
506 </xs:appinfo>
507 </xs:annotation>
508 <xs:complexType>
509 <xs:sequence>
510 <xs:choice minOccurs="0" maxOccurs="unbounded">
511 <xs:element ref="ComPlusAssemblyDependency" />
512 <xs:element ref="ComPlusComponent" />
513 </xs:choice>
514 </xs:sequence>
515 <xs:attribute name="Id" use="required" type="xs:string">
516 <xs:annotation><xs:documentation>
517 Identifier for the element.
518 </xs:documentation></xs:annotation>
519 </xs:attribute>
520 <xs:attribute name="Application" use="optional" type="xs:string">
521 <xs:annotation><xs:documentation>
522 If the element is not a child of a ComPlusApplication
523 element, this attribute should be provided with the id of a ComPlusApplication
524 element representing the application the assembly is to be registered in.
525 This attribute can be omitted for a .NET assembly even if the application is
526 not a child of a ComPlusApplication element.
527 </xs:documentation></xs:annotation>
528 </xs:attribute>
529 <xs:attribute name="AssemblyName" use="optional" type="xs:string">
530 <xs:annotation><xs:documentation>
531 The name of the assembly used to identify the assembly in
532 the GAC. This attribute can be provided only if DllPathFromGAC is set to
533 “yes”.
534 </xs:documentation></xs:annotation>
535 </xs:attribute>
536 <xs:attribute name="DllPath" use="optional" type="xs:string">
537 <xs:annotation><xs:documentation>
538 The path to locate the assembly DLL during registration.
539 This attribute should be provided if DllPathFromGAC is not set to “yes”.
540 </xs:documentation></xs:annotation>
541 </xs:attribute>
542 <xs:attribute name="TlbPath" use="optional" type="xs:string">
543 <xs:annotation><xs:documentation>
544 An optional path to an external type lib for the assembly.
545 This attribute must be provided if the Type attribute is set to “.net”.
546 </xs:documentation></xs:annotation>
547 </xs:attribute>
548 <xs:attribute name="PSDllPath" use="optional" type="xs:string">
549 <xs:annotation><xs:documentation>
550 An optional path to an external proxy/stub DLL for the assembly.
551 </xs:documentation></xs:annotation>
552 </xs:attribute>
553 <xs:attribute name="Type" use="required">
554 <xs:annotation><xs:documentation>
555 </xs:documentation></xs:annotation>
556 <xs:simpleType>
557 <xs:restriction base="xs:NMTOKEN">
558 <xs:enumeration value="native" />
559 <xs:enumeration value=".net" />
560 </xs:restriction>
561 </xs:simpleType>
562 </xs:attribute>
563 <xs:attribute name="EventClass" use="optional" type="wxs:YesNoTypeUnion">
564 <xs:annotation><xs:documentation>
565 Indicates that the assembly is to be installed as an event
566 class DLL. This attribute is only valid for native assemblies. The assembly
567 will be installed with the COM+ catalog’s InstallEventClass() function.
568 </xs:documentation></xs:annotation>
569 </xs:attribute>
570 <xs:attribute name="DllPathFromGAC" use="optional" type="wxs:YesNoTypeUnion">
571 <xs:annotation><xs:documentation>
572 Indicates that the DLL path should be extracted from the
573 GAC instead for being provided in the DllPath attribute. If this attribute is
574 set to “yes”, the name of the assembly can be provided using the AssemblyName
575 attribute. Or, if this AssemblyName attribute is missing, the name will be
576 extracted from the MsiAssemblyName table using the id of the parent Component
577 element.
578 </xs:documentation></xs:annotation>
579 </xs:attribute>
580 <xs:attribute name="RegisterInCommit" use="optional" type="wxs:YesNoTypeUnion">
581 <xs:annotation><xs:documentation>
582 Indicates that the assembly should be installed in the
583 commit custom action instead of the normal deferred custom action. This is
584 necessary when installing .NET assemblies to the GAC in the same
585 installation, as the assemblies are not visible in the GAC until after the
586 InstallFinalize action has run.
587 </xs:documentation></xs:annotation>
588 </xs:attribute>
589 </xs:complexType>
590 </xs:element>
591
592 <xs:element name="ComPlusAssemblyDependency">
593 <xs:annotation>
594 <xs:documentation>
595 Defines a dependency between two assemblies. This element
596 affects the order in which assembles are registered. Any assemblies referenced
597 by this element are guarantied to be registered before, and unregistered after,
598 the assembly referenced by the parent ComPlusAssembly element.
599 </xs:documentation>
600 <xs:appinfo>
601 <xse:remarks>
602 It is only necessary to explicitly specify dependencies between
603 assemblies contained in the same package (MSI or MSM). Assemblies merged in to a
604 package from a merge module will always be installed before any assemblies
605 specified in the base package. Assemblies merged in from different merge
606 modules are sequenced using the ModuleDependency MSI table. It is not possible
607 to have cross dependencies between merge modules or have an assembly in a merge
608 module depend on an assembly in the base package.
609 </xse:remarks>
610 </xs:appinfo>
611 </xs:annotation>
612 <xs:complexType>
613 <xs:attribute name="RequiredAssembly" use="required" type="xs:string">
614 <xs:annotation><xs:documentation>
615 Reference to the id of the assembly required by the parent
616 ComPlusAssembly element.
617 </xs:documentation></xs:annotation>
618 </xs:attribute>
619 </xs:complexType>
620 </xs:element>
621
622 <xs:element name="ComPlusComponent">
623 <xs:annotation><xs:documentation>
624 Represents a COM+ component in an assembly.
625 </xs:documentation></xs:annotation>
626 <xs:complexType>
627 <xs:sequence>
628 <xs:choice minOccurs="0" maxOccurs="unbounded">
629 <xs:element ref="ComPlusRoleForComponent" />
630 <xs:element ref="ComPlusInterface" />
631 <xs:element ref="ComPlusSubscription" />
632 </xs:choice>
633 </xs:sequence>
634 <xs:attribute name="Id" use="required" type="xs:string">
635 <xs:annotation><xs:documentation>
636 Identifier for the element.
637 </xs:documentation></xs:annotation>
638 </xs:attribute>
639 <xs:attribute name="CLSID" use="required" type="uuid">
640 <xs:annotation><xs:documentation>
641 CLSID of the component.
642 </xs:documentation></xs:annotation>
643 </xs:attribute>
644 <xs:attribute name="AllowInprocSubscribers" use="optional" type="wxs:YesNoTypeUnion" />
645 <xs:attribute name="ComponentAccessChecksEnabled" use="optional" type="wxs:YesNoTypeUnion" />
646 <xs:attribute name="ComponentTransactionTimeout" use="optional" type="xs:int" />
647 <xs:attribute name="ComponentTransactionTimeoutEnabled" use="optional" type="wxs:YesNoTypeUnion" />
648 <xs:attribute name="COMTIIntrinsics" use="optional" type="wxs:YesNoTypeUnion" />
649 <xs:attribute name="ConstructionEnabled" use="optional" type="wxs:YesNoTypeUnion" />
650 <xs:attribute name="ConstructorString" use="optional" type="xs:string" />
651 <xs:attribute name="CreationTimeout" use="optional" type="xs:int" />
652 <xs:attribute name="Description" use="optional" type="xs:string" />
653 <xs:attribute name="EventTrackingEnabled" use="optional" type="wxs:YesNoTypeUnion" />
654 <xs:attribute name="ExceptionClass" use="optional" type="xs:string" />
655 <xs:attribute name="FireInParallel" use="optional" type="wxs:YesNoTypeUnion" />
656 <xs:attribute name="IISIntrinsics" use="optional" type="wxs:YesNoTypeUnion" />
657 <xs:attribute name="InitializesServerApplication" use="optional" type="wxs:YesNoTypeUnion" />
658 <xs:attribute name="IsEnabled" use="optional" type="wxs:YesNoTypeUnion" />
659 <xs:attribute name="IsPrivateComponent" use="optional" type="wxs:YesNoTypeUnion" />
660 <xs:attribute name="JustInTimeActivation" use="optional" type="wxs:YesNoTypeUnion" />
661 <xs:attribute name="LoadBalancingSupported" use="optional" type="wxs:YesNoTypeUnion" />
662 <xs:attribute name="MaxPoolSize" use="optional" type="xs:int" />
663 <xs:attribute name="MinPoolSize" use="optional" type="xs:int" />
664 <xs:attribute name="MultiInterfacePublisherFilterCLSID" use="optional" type="xs:string" />
665 <xs:attribute name="MustRunInClientContext" use="optional" type="wxs:YesNoTypeUnion" />
666 <xs:attribute name="MustRunInDefaultContext" use="optional" type="wxs:YesNoTypeUnion" />
667 <xs:attribute name="ObjectPoolingEnabled" use="optional" type="wxs:YesNoTypeUnion" />
668 <xs:attribute name="PublisherID" use="optional" type="xs:string" />
669 <xs:attribute name="SoapAssemblyName" use="optional" type="xs:string" />
670 <xs:attribute name="SoapTypeName" use="optional" type="xs:string" />
671 <xs:attribute name="Synchronization" use="optional">
672 <xs:simpleType>
673 <xs:restriction base="xs:NMTOKEN">
674 <xs:enumeration value="ignored" />
675 <xs:enumeration value="none" />
676 <xs:enumeration value="supported" />
677 <xs:enumeration value="required" />
678 <xs:enumeration value="requiresNew" />
679 </xs:restriction>
680 </xs:simpleType>
681 </xs:attribute>
682 <xs:attribute name="Transaction" use="optional">
683 <xs:simpleType>
684 <xs:restriction base="xs:NMTOKEN">
685 <xs:enumeration value="ignored" />
686 <xs:enumeration value="none" />
687 <xs:enumeration value="supported" />
688 <xs:enumeration value="required" />
689 <xs:enumeration value="requiresNew" />
690 </xs:restriction>
691 </xs:simpleType>
692 </xs:attribute>
693 <xs:attribute name="TxIsolationLevel" use="optional">
694 <xs:simpleType>
695 <xs:restriction base="xs:NMTOKEN">
696 <xs:enumeration value="any" />
697 <xs:enumeration value="readUnCommitted" />
698 <xs:enumeration value="readCommitted" />
699 <xs:enumeration value="repeatableRead" />
700 <xs:enumeration value="serializable" />
701 </xs:restriction>
702 </xs:simpleType>
703 </xs:attribute>
704 </xs:complexType>
705 </xs:element>
706
707 <xs:element name="ComPlusRoleForComponent">
708 <xs:annotation>
709 <xs:appinfo>
710 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
711 </xs:appinfo>
712 <xs:documentation>
713 Represents a role assignment to a COM+ component.
714 </xs:documentation>
715 </xs:annotation>
716 <xs:complexType>
717 <xs:attribute name="Id" use="required" type="xs:string">
718 <xs:annotation><xs:documentation>
719 Identifier for the element.
720 </xs:documentation></xs:annotation>
721 </xs:attribute>
722 <xs:attribute name="Component" use="optional" type="xs:string">
723 <xs:annotation><xs:documentation>
724 If the element is not a child of a ComPlusComponent
725 element, this attribute should be provided with the id of a ComPlusComponent
726 element representing the component the role is to be added to.
727 </xs:documentation></xs:annotation>
728 </xs:attribute>
729 <xs:attribute name="ApplicationRole" use="required" type="xs:string">
730 <xs:annotation><xs:documentation>
731 Id of the ComPlusApplicationRole element representing the
732 role that shall be granted access to the component.
733 </xs:documentation></xs:annotation>
734 </xs:attribute>
735 </xs:complexType>
736 </xs:element>
737
738 <xs:element name="ComPlusInterface">
739 <xs:annotation><xs:documentation>
740 Represents an interface for a COM+ component.
741 </xs:documentation></xs:annotation>
742 <xs:complexType>
743 <xs:sequence>
744 <xs:choice minOccurs="0" maxOccurs="unbounded">
745 <xs:element ref="ComPlusRoleForInterface" />
746 <xs:element ref="ComPlusMethod" />
747 </xs:choice>
748 </xs:sequence>
749 <xs:attribute name="Id" use="required" type="xs:string">
750 <xs:annotation><xs:documentation>
751 Identifier for the element.
752 </xs:documentation></xs:annotation>
753 </xs:attribute>
754 <xs:attribute name="IID" use="required" type="uuid">
755 <xs:annotation><xs:documentation>
756 IID of the interface.
757 </xs:documentation></xs:annotation>
758 </xs:attribute>
759 <xs:attribute name="Description" use="optional" type="xs:string" />
760 <xs:attribute name="QueuingEnabled" use="optional" type="wxs:YesNoTypeUnion" />
761 </xs:complexType>
762 </xs:element>
763
764 <xs:element name="ComPlusRoleForInterface">
765 <xs:annotation>
766 <xs:appinfo>
767 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
768 </xs:appinfo>
769 <xs:documentation>
770 Represents a role assignment to an interface.
771 </xs:documentation>
772 </xs:annotation>
773 <xs:complexType>
774 <xs:attribute name="Id" use="required" type="xs:string">
775 <xs:annotation><xs:documentation>
776 Identifier for the element.
777 </xs:documentation></xs:annotation>
778 </xs:attribute>
779 <xs:attribute name="Interface" use="optional" type="xs:string">
780 <xs:annotation><xs:documentation>
781 If the element is not a child of a ComPlusInterface
782 element, this attribute should be provided with the id of a ComPlusInterface
783 element representing the interface the role is to be added to.
784 </xs:documentation></xs:annotation>
785 </xs:attribute>
786 <xs:attribute name="ApplicationRole" use="required" type="xs:string">
787 <xs:annotation><xs:documentation>
788 Id of the ComPlusApplicationRole element representing the
789 role that shall be granted access to the interface.
790 </xs:documentation></xs:annotation>
791 </xs:attribute>
792 </xs:complexType>
793 </xs:element>
794
795 <xs:element name="ComPlusMethod">
796 <xs:annotation>
797 <xs:documentation>
798 Represents a method for an interface.
799 </xs:documentation>
800 </xs:annotation>
801 <xs:complexType>
802 <xs:sequence>
803 <xs:element ref="ComPlusRoleForMethod" minOccurs="0" maxOccurs="unbounded" />
804 </xs:sequence>
805 <xs:attribute name="Id" use="required" type="xs:string">
806 <xs:annotation>
807 <xs:documentation>
808 Identifier for the element.
809 </xs:documentation>
810 </xs:annotation>
811 </xs:attribute>
812 <xs:attribute name="Index" use="optional" type="xs:int">
813 <xs:annotation>
814 <xs:documentation>
815 Dispatch id of the method. If this attribute is not set a
816 value must be provided for the Name attribute.
817 </xs:documentation>
818 </xs:annotation>
819 </xs:attribute>
820 <xs:attribute name="Name" use="optional" type="xs:string">
821 <xs:annotation>
822 <xs:documentation>
823 Name of the method. If this attribute is not set a value
824 must be provided for the Index attribute.
825 </xs:documentation>
826 </xs:annotation>
827 </xs:attribute>
828 <xs:attribute name="AutoComplete" use="optional" type="wxs:YesNoTypeUnion" />
829 <xs:attribute name="Description" use="optional" type="xs:string" />
830 </xs:complexType>
831 </xs:element>
832
833 <xs:element name="ComPlusRoleForMethod">
834 <xs:annotation>
835 <xs:appinfo>
836 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
837 </xs:appinfo>
838 <xs:documentation>
839 Represents a role assignment to a COM+ method.
840 </xs:documentation>
841 </xs:annotation>
842 <xs:complexType>
843 <xs:attribute name="Id" use="required" type="xs:string">
844 <xs:annotation><xs:documentation>
845 Identifier for the element.
846 </xs:documentation></xs:annotation>
847 </xs:attribute>
848 <xs:attribute name="Method" use="optional" type="xs:string">
849 <xs:annotation><xs:documentation>
850 If the element is not a child of a ComPlusMethod element,
851 this attribute should be provided with the id of a ComPlusMethod element
852 representing the method the role is to be added to.
853 </xs:documentation></xs:annotation>
854 </xs:attribute>
855 <xs:attribute name="ApplicationRole" use="required" type="xs:string">
856 <xs:annotation><xs:documentation>
857 Id of the ComPlusApplicationRole element representing the
858 role that shall be granted access to the method.
859 </xs:documentation></xs:annotation>
860 </xs:attribute>
861 </xs:complexType>
862 </xs:element>
863
864 <xs:element name="ComPlusSubscription">
865 <xs:annotation>
866 <xs:appinfo>
867 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
868 </xs:appinfo>
869 <xs:documentation>
870 Defines an event subscription for a COM+ component.
871 </xs:documentation>
872 </xs:annotation>
873 <xs:complexType>
874 <xs:attribute name="Id" use="required" type="xs:string">
875 <xs:annotation><xs:documentation>
876 Identifier for the element.
877 </xs:documentation></xs:annotation>
878 </xs:attribute>
879 <xs:attribute name="Component" use="optional" type="xs:string">
880 <xs:annotation><xs:documentation>
881 If the element is not a child of a ComPlusComponent
882 element, this attribute should be provided with the id of a ComPlusComponent
883 element representing the component the subscription is to be created for.
884 </xs:documentation></xs:annotation>
885 </xs:attribute>
886 <xs:attribute name="SubscriptionId" use="optional" type="xs:string">
887 <xs:annotation><xs:documentation>
888 Id of the subscription. If a value is not provided for
889 this attribute, an id will be generated during installation.
890 </xs:documentation></xs:annotation>
891 </xs:attribute>
892 <xs:attribute name="Name" use="required" type="xs:string">
893 <xs:annotation><xs:documentation>
894 Name of the subscription.
895 </xs:documentation></xs:annotation>
896 </xs:attribute>
897 <xs:attribute name="EventCLSID" use="optional" type="xs:string">
898 <xs:annotation><xs:documentation>
899 CLSID of the event class for the subscription. If a value
900 for this attribute is not provided, a value for the PublisherID attribute
901 must be provided.
902 </xs:documentation></xs:annotation>
903 </xs:attribute>
904 <xs:attribute name="PublisherID" use="optional" type="xs:string">
905 <xs:annotation><xs:documentation>
906 Publisher id for the subscription. If a value for this
907 attribute is not provided, a value for the EventCLSID attribute must be
908 provided.
909 </xs:documentation></xs:annotation>
910 </xs:attribute>
911 <xs:attribute name="Description" use="optional" type="xs:string" />
912 <xs:attribute name="Enabled" use="optional" type="wxs:YesNoTypeUnion" />
913 <xs:attribute name="EventClassPartitionID" use="optional" type="xs:string" />
914 <xs:attribute name="FilterCriteria" use="optional" type="xs:string" />
915 <xs:attribute name="InterfaceID" use="optional" type="xs:string" />
916 <xs:attribute name="MachineName" use="optional" type="xs:string" />
917 <xs:attribute name="MethodName" use="optional" type="xs:string" />
918 <xs:attribute name="PerUser" use="optional" type="wxs:YesNoTypeUnion" />
919 <xs:attribute name="Queued" use="optional" type="wxs:YesNoTypeUnion" />
920 <xs:attribute name="SubscriberMoniker" use="optional" type="xs:string" />
921 <xs:attribute name="UserName" use="optional" type="xs:string" />
922 </xs:complexType>
923 </xs:element>
924
925 <xs:simpleType name="uuid">
926 <xs:annotation>
927 <xs:documentation>Values of this type will look like: "01234567-89AB-CDEF-0123-456789ABCDEF".</xs:documentation>
928 </xs:annotation>
929 <xs:restriction base="xs:string">
930 <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}" />
931 </xs:restriction>
932 </xs:simpleType>
933
934</xs:schema>
diff --git a/src/xsd/dependency.xsd b/src/xsd/dependency.xsd
new file mode 100644
index 00000000..b06e081c
--- /dev/null
+++ b/src/xsd/dependency.xsd
@@ -0,0 +1,40 @@
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:wxs="http://wixtoolset.org/schemas/v4/wxs"
8 targetNamespace="http://wixtoolset.org/schemas/v4/wxs/dependency"
9 xmlns="http://wixtoolset.org/schemas/v4/wxs/dependency">
10 <xs:annotation>
11 <xs:documentation>
12 The source code schema for the WiX Toolset Dependency Extension.
13 </xs:documentation>
14 </xs:annotation>
15
16 <xs:import namespace="http://wixtoolset.org/schemas/v4/wxs" />
17
18 <xs:attribute name="Check" type="wxs:YesNoTypeUnion">
19 <xs:annotation>
20 <xs:documentation>
21 When set to "yes", adds a custom action to prompt the user when dependencies are still on the computer. The default is "no".
22 </xs:documentation>
23 <xs:appinfo>
24 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Provides" />
25 </xs:appinfo>
26 </xs:annotation>
27 </xs:attribute>
28
29 <xs:attribute name="Enforce" type="wxs:YesNoTypeUnion">
30 <xs:annotation>
31 <xs:documentation>
32 When set to "yes", adds a custom action to prompt the user when dependencies are missing from the computer. The default is "no".
33 </xs:documentation>
34 <xs:appinfo>
35 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Requires" />
36 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="RequiresRef" />
37 </xs:appinfo>
38 </xs:annotation>
39 </xs:attribute>
40</xs:schema>
diff --git a/src/xsd/difxapp.xsd b/src/xsd/difxapp.xsd
new file mode 100644
index 00000000..f918faee
--- /dev/null
+++ b/src/xsd/difxapp.xsd
@@ -0,0 +1,119 @@
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 xmlns:wxs="http://wixtoolset.org/schemas/v4/wxs"
9 targetNamespace="http://wixtoolset.org/schemas/v4/wxs/difxapp"
10 xmlns="http://wixtoolset.org/schemas/v4/wxs/difxapp">
11 <xs:annotation>
12 <xs:documentation>
13 The source code schema for the WiX Toolset Driver Install Frameworks for Applications Extension.
14
15 ## WixToolset.DifxApp.wixext was deprecated in WiX v4
16
17 ## WixToolset.DifxApp.wixext was removed in WiX v5
18 </xs:documentation>
19 </xs:annotation>
20
21 <xs:import namespace="http://wixtoolset.org/schemas/v4/wxs" />
22
23 <xs:element name="Driver">
24 <xs:annotation>
25 <xs:appinfo>
26 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
27 </xs:appinfo>
28 <xs:documentation>
29 Installs a driver. To use this element, you need to reference the WixDifxAppExtension extension and add the
30 .wixlib appropriate for the target platform (difxapp_x86.wixlib or difxapp_x64.wixlib)
31 to your project.
32 </xs:documentation>
33 </xs:annotation>
34 <xs:complexType>
35 <xs:choice minOccurs="0" maxOccurs="unbounded">
36 <xs:any namespace="##other" processContents="lax">
37 <xs:annotation>
38 <xs:documentation>
39 Extensibility point in the WiX XML Schema. Schema extensions can register additional
40 elements at this point in the schema.
41 </xs:documentation>
42 </xs:annotation>
43 </xs:any>
44 </xs:choice>
45 <xs:attribute name="AddRemovePrograms" type="wxs:YesNoTypeUnion">
46 <xs:annotation>
47 <xs:documentation>
48 Specifies that the DIFxApp CustomActions should add an entry in the Add/Remove Programs Control
49 Panel applet. The default is 'yes'.
50 </xs:documentation>
51 </xs:annotation>
52 </xs:attribute>
53 <xs:attribute name="DeleteFiles" type="wxs:YesNoTypeUnion">
54 <xs:annotation>
55 <xs:documentation>
56 If set to "yes", configures DIFxApp to delete binary files that were copied to the system from the driver
57 store when a driver package was installed. If this attribute is set to "no" or not present, DIFxApp does not
58 remove these files from a system. Note that configuring DIFxApp to delete these files is controlled by the
59 Flags entry value of the component that represents the driver package in the MsiDriverPackages custom table.
60 Setting DeleteFiles to "yes" sets the corresponding bit in the Flags entry value. Setting DeleteFiles to "no"
61 clears the corresponding bit in the Flags entry value. If this attribute is not present, DIFxApp uses a
62 default value of "no".
63 </xs:documentation>
64 </xs:annotation>
65 </xs:attribute>
66 <xs:attribute name="ForceInstall" type="wxs:YesNoTypeUnion">
67 <xs:annotation>
68 <xs:documentation>
69 Specifies that the DIFxApp CustomActions should force the installation of a new Plug and Play driver
70 on a device, even if the currently installed driver on the device is a better match than the new driver.
71 Specifying 'no' is an excellent way to ensure the DIFxApp CustomActions recognize the Component contains
72 a driver for installation. The default is null which means the Component does not install a driver via
73 DIFxApp CustomActions. See http://www.microsoft.com/whdc/driver/install/difxtools.mspx for more information.
74 </xs:documentation>
75 </xs:annotation>
76 </xs:attribute>
77 <xs:attribute name="Legacy" type="wxs:YesNoTypeUnion">
78 <xs:annotation>
79 <xs:documentation>
80 If set to "yes", configures DIFxApp to install unsigned driver packages and driver packages with missing
81 files. For more information, see "Installing Unsigned Driver Packages in Legacy Mode" earlier in this paper.
82 If this attribute is set to "no" or not present, DIFxApp will install only signed driver packages. Note
83 that configuring DIFxApp to install unsigned drivers is controlled by the Flags entry value of the component
84 that represents the driver package in the MsiDriverPackages custom table. Setting Legacy to "yes" sets
85 the corresponding bit in the Flags entry value. Setting Legacy to "no" clears the bit in the Flags
86 entry value that configures DIFxApp to install unsigned driver packages. If this attribute is not present,
87 DIFxApp uses a default value of "no".
88 </xs:documentation>
89 </xs:annotation>
90 </xs:attribute>
91 <xs:attribute name="PlugAndPlayPrompt" type="wxs:YesNoTypeUnion">
92 <xs:annotation>
93 <xs:documentation>
94 Specifies that the DIFxApp CustomActions should prompt the user to connect the Plug and Play
95 device if it is not connected. The default is 'yes'.
96 </xs:documentation>
97 </xs:annotation>
98 </xs:attribute>
99 <xs:attribute name="Sequence" type="wxs:Integer">
100 <xs:annotation>
101 <xs:documentation>
102 Specifies an optional installation sequence number. DIFxApp CustomActions install the driver packages in
103 an installation package in the order of increasing sequence numbers. The same sequence number can be used
104 for more than one driver; however, the order in which packages with the same sequence number are actually
105 installed cannot be determined.
106 </xs:documentation>
107 </xs:annotation>
108 </xs:attribute>
109 <xs:anyAttribute namespace="##other" processContents="lax">
110 <xs:annotation>
111 <xs:documentation>
112 Extensibility point in the WiX XML Schema. Schema extensions can register additional
113 attributes at this point in the schema.
114 </xs:documentation>
115 </xs:annotation>
116 </xs:anyAttribute>
117 </xs:complexType>
118 </xs:element>
119</xs:schema>
diff --git a/src/xsd/directx.xsd b/src/xsd/directx.xsd
new file mode 100644
index 00000000..efac3587
--- /dev/null
+++ b/src/xsd/directx.xsd
@@ -0,0 +1,53 @@
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 xmlns:wxs="http://wixtoolset.org/schemas/v4/wxs"
9 targetNamespace="http://wixtoolset.org/schemas/v4/wxs/directx"
10 xmlns="http://wixtoolset.org/schemas/v4/wxs/directx">
11 <xs:annotation>
12 <xs:documentation>
13 The source code schema for the WiX Toolset DirectX Extension.
14 </xs:documentation>
15 </xs:annotation>
16
17 <xs:import namespace="http://wixtoolset.org/schemas/v4/wxs" />
18
19 <xs:element name="GetCapabilities">
20 <xs:annotation>
21 <xs:appinfo>
22 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
23 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Module" />
24 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Package" />
25 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="UI" />
26 </xs:appinfo>
27 <xs:documentation>
28 Schedules the WixToolset.DirectX.wixext custom action for the current platform to
29 detect DirectX capabilities. For more information, see [DirectX custom actions](../../../tools/wixext/directx).
30 </xs:documentation>
31 </xs:annotation>
32 <xs:complexType>
33 <xs:choice minOccurs="0" maxOccurs="unbounded">
34 <xs:any namespace="##other" processContents="lax">
35 <xs:annotation>
36 <xs:documentation>
37 Extensibility point in the WiX XML Schema. Schema extensions can register additional
38 elements at this point in the schema.
39 </xs:documentation>
40 </xs:annotation>
41 </xs:any>
42 </xs:choice>
43 <xs:anyAttribute namespace="##other" processContents="lax">
44 <xs:annotation>
45 <xs:documentation>
46 Extensibility point in the WiX XML Schema. Schema extensions can register additional
47 attributes at this point in the schema.
48 </xs:documentation>
49 </xs:annotation>
50 </xs:anyAttribute>
51 </xs:complexType>
52 </xs:element>
53</xs:schema>
diff --git a/src/xsd/firewall.xsd b/src/xsd/firewall.xsd
new file mode 100644
index 00000000..fcac0c96
--- /dev/null
+++ b/src/xsd/firewall.xsd
@@ -0,0 +1,578 @@
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 xmlns:wxs="http://wixtoolset.org/schemas/v4/wxs"
9 targetNamespace="http://wixtoolset.org/schemas/v4/wxs/firewall"
10 xmlns="http://wixtoolset.org/schemas/v4/wxs/firewall">
11 <xs:annotation>
12 <xs:documentation>
13 The source code schema for the WiX Toolset Firewall Extension.
14 </xs:documentation>
15 </xs:annotation>
16
17 <xs:import namespace="http://wixtoolset.org/schemas/v4/wxs" />
18
19 <xs:element name="FirewallException">
20 <xs:annotation>
21 <xs:documentation>
22 Registers an exception for a program or a specific port and protocol in the Windows Firewall.
23 For more information about the Windows Firewall, see [Windows Firewall with Advanced Security](https://learn.microsoft.com/en-us/previous-versions/windows/desktop/ics/windows-firewall-advanced-security-start-page).
24 </xs:documentation>
25 <xs:appinfo>
26 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
27 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="File" />
28 </xs:appinfo>
29 </xs:annotation>
30
31 <xs:complexType>
32 <xs:choice minOccurs="0" maxOccurs="unbounded">
33 <xs:annotation>
34 <xs:documentation>
35 Explicitly-listed remote addresses that this exception allows through the
36 firewall.
37 </xs:documentation>
38 </xs:annotation>
39 <xs:element ref="LocalAddress" />
40 <xs:element ref="Interface" />
41 <xs:element ref="InterfaceType" />
42 <xs:element ref="RemoteAddress" />
43 <xs:any namespace="##other" processContents="lax">
44 <xs:annotation>
45 <xs:documentation>
46 Extensibility point in the WiX XML Schema. Schema extensions can register additional
47 elements at this point in the schema.
48 </xs:documentation>
49 </xs:annotation>
50 </xs:any>
51 </xs:choice>
52
53 <xs:attribute name="Id" type="xs:string">
54 <xs:annotation>
55 <xs:documentation>
56 Unique ID of this firewall exception. If the Id is not specified, one will be generated.
57 </xs:documentation>
58 </xs:annotation>
59 </xs:attribute>
60
61 <xs:attribute name="Name" type="xs:string" use="required">
62 <xs:annotation>
63 <xs:documentation>
64 Name of this firewall exception, visible to the user in the firewall
65 control panel.
66 </xs:documentation>
67 </xs:annotation>
68 </xs:attribute>
69
70 <xs:attribute name="Action" type="FirewallActionTypeUnion">
71 <xs:annotation>
72 <xs:documentation>
73 The action for this firewall exception.
74 </xs:documentation>
75 </xs:annotation>
76 </xs:attribute>
77
78 <xs:attribute name="Enabled" type="FirewallYesNoPropertyType">
79 <xs:annotation>
80 <xs:documentation>
81 Indicates whether the firewall exception should be enabled.
82 </xs:documentation>
83 </xs:annotation>
84 </xs:attribute>
85
86 <xs:attribute name="Grouping" type="xs:string">
87 <xs:annotation>
88 <xs:documentation>
89 Grouping for the firewall exception.
90 </xs:documentation>
91 </xs:annotation>
92 </xs:attribute>
93
94 <xs:attribute name="IcmpTypesAndCodes" type="xs:string">
95 <xs:annotation>
96 <xs:documentation>
97 ICMP types and codes for the firewall exception.
98 </xs:documentation>
99 </xs:annotation>
100 </xs:attribute>
101
102 <xs:attribute name="Interface" type="xs:string">
103 <xs:annotation>
104 <xs:documentation>
105 Interface for the firewall exception.
106 </xs:documentation>
107 </xs:annotation>
108 </xs:attribute>
109
110 <xs:attribute name="InterfaceType" type="FirewallInterfaceTypeUnion">
111 <xs:annotation>
112 <xs:documentation>
113 Interface type for the firewall exception.
114 </xs:documentation>
115 </xs:annotation>
116 </xs:attribute>
117
118 <xs:attribute name="IPSecSecureFlags" type="FirewallIPSecSecureFlagsUnion">
119 <xs:annotation>
120 <xs:documentation>
121 IPSec secure flags for the firewall exception.
122 </xs:documentation>
123 </xs:annotation>
124 </xs:attribute>
125
126 <xs:attribute name="LocalAppPackageId" type="xs:string">
127 <xs:annotation>
128 <xs:documentation>
129 Local AppPackageId for the firewall exception.
130 </xs:documentation>
131 </xs:annotation>
132 </xs:attribute>
133
134 <xs:attribute name="LocalUserAuthorizedList" type="xs:string">
135 <xs:annotation>
136 <xs:documentation>
137 Local user authorized list for the firewall exception.
138 </xs:documentation>
139 </xs:annotation>
140 </xs:attribute>
141
142 <xs:attribute name="LocalUserOwner" type="xs:string">
143 <xs:annotation>
144 <xs:documentation>
145 Local user owner for the firewall exception.
146 </xs:documentation>
147 </xs:annotation>
148 </xs:attribute>
149
150 <xs:attribute name="LocalScope" type="FirewallLocalScopeTypeUnion">
151 <xs:annotation>
152 <xs:documentation>
153 Local scope for the firewall exception.
154 </xs:documentation>
155 </xs:annotation>
156 </xs:attribute>
157
158 <xs:attribute name="Scope" type="FirewallScopeTypeUnion">
159 <xs:annotation>
160 <xs:documentation>
161 The scope of this firewall exception, which indicates whether incoming
162 connections can come from any computer including those on the Internet
163 or only those on the local network subnet. To more precisely specify
164 allowed remote address, specify a custom scope using RemoteAddress
165 child elements.
166 </xs:documentation>
167 </xs:annotation>
168 </xs:attribute>
169
170 <xs:attribute name="Port" type="xs:string">
171 <xs:annotation>
172 <xs:documentation>
173 Port to allow through the firewall for this exception. By default,
174 any program is allowed access through the port unless a File or
175 Program attribute is specified.
176 </xs:documentation>
177 </xs:annotation>
178 </xs:attribute>
179
180 <xs:attribute name="Protocol" type="FirewallProtocolTypeUnion">
181 <xs:annotation>
182 <xs:documentation>
183 IP protocol used for this firewall exception. If Port is defined,
184 "tcp" is assumed if the protocol is not specified.
185 </xs:documentation>
186 </xs:annotation>
187 </xs:attribute>
188
189 <xs:attribute name="File" type="xs:string">
190 <xs:annotation>
191 <xs:documentation>
192 Identifier of a File to be granted access through the firewall. By default,
193 all incoming ports and protocols are allowed unless the Port and.or Protocol
194 attributes are specified.
195
196 If you use File, you cannot also use Program.
197 </xs:documentation>
198 </xs:annotation>
199 </xs:attribute>
200
201 <xs:attribute name="Program" type="xs:string">
202 <xs:annotation>
203 <xs:documentation>
204 Path to a target program to be granted access through the firewall. By default,
205 all incoming ports and protocols are allowed unless the Port and.or Protocol
206 attributes are specified.
207
208 Note that this is a formatted field, so you can use [#fileId]
209 syntax to refer to a file being installed. If you use Program, you cannot
210 also use File.
211 </xs:documentation>
212 </xs:annotation>
213 </xs:attribute>
214
215 <xs:attribute name="IgnoreFailure" type="wxs:YesNoTypeUnion">
216 <xs:annotation>
217 <xs:documentation>
218 If "yes", failures to register this firewall exception will be silently
219 ignored. If "no" (the default), failures will cause rollback.
220 </xs:documentation>
221 </xs:annotation>
222 </xs:attribute>
223
224 <xs:attribute name="Profile" type="FirewallProfileTypeUnion">
225 <xs:annotation>
226 <xs:documentation>
227 Profile type for this firewall exception. Default is "all".
228 </xs:documentation>
229 </xs:annotation>
230 </xs:attribute>
231
232 <xs:attribute name="Description" type="xs:string">
233 <xs:annotation>
234 <xs:documentation>
235 Description for this firewall rule displayed in Windows Firewall manager.
236 </xs:documentation>
237 </xs:annotation>
238 </xs:attribute>
239
240 <xs:attribute name="EdgeTraversal" type="FirewallEdgeTraversalTypeUnion">
241 <xs:annotation>
242 <xs:documentation>
243 Sets the edge traversal of the firewall exception.
244 </xs:documentation>
245 </xs:annotation>
246 </xs:attribute>
247
248 <xs:attribute name="OnUpdate" type="FirewallOnUpdateTypeUnion">
249 <xs:annotation>
250 <xs:documentation>
251 Installation instruction when updating the firewall exception.
252 </xs:documentation>
253 </xs:annotation>
254 </xs:attribute>
255
256 <xs:attribute name="Outbound" type="wxs:YesNoTypeUnion">
257 <xs:annotation>
258 <xs:documentation>
259 If "yes", registers an outbound firewall rule. The default is "no".
260 </xs:documentation>
261 </xs:annotation>
262 </xs:attribute>
263
264 <xs:attribute name="RemoteMachineAuthorizedList" type="xs:string">
265 <xs:annotation>
266 <xs:documentation>
267 Remote machine authorized list for the firewall exception.
268 </xs:documentation>
269 </xs:annotation>
270 </xs:attribute>
271
272 <xs:attribute name="RemoteUserAuthorizedList" type="xs:string">
273 <xs:annotation>
274 <xs:documentation>
275 Remote user authorized list for the firewall exception.
276 </xs:documentation>
277 </xs:annotation>
278 </xs:attribute>
279
280 <xs:attribute name="RemotePort" type="xs:string">
281 <xs:annotation>
282 <xs:documentation>
283 Remote port for the firewall exception.
284 </xs:documentation>
285 </xs:annotation>
286 </xs:attribute>
287
288 <xs:attribute name="Service" type="xs:string">
289 <xs:annotation>
290 <xs:documentation>
291 Service for the firewall exception. Cannot be specified when the firewall exception is a child of a service element.
292 </xs:documentation>
293 </xs:annotation>
294 </xs:attribute>
295
296 <xs:anyAttribute namespace="##other" processContents="lax">
297 <xs:annotation>
298 <xs:documentation>
299 Extensibility point in the WiX XML Schema. Schema extensions can register additional
300 attributes at this point in the schema.
301 </xs:documentation>
302 </xs:annotation>
303 </xs:anyAttribute>
304 </xs:complexType>
305 </xs:element>
306
307 <xs:element name="LocalAddress">
308 <xs:annotation>
309 <xs:documentation>
310 [WiX v5] Registers a local address to the firewall rule.
311 </xs:documentation>
312 </xs:annotation>
313
314 <xs:complexType>
315 <xs:choice minOccurs="0" maxOccurs="unbounded">
316 <xs:any namespace="##other" processContents="lax">
317 <xs:annotation>
318 <xs:documentation>
319 Extensibility point in the WiX XML Schema. Schema extensions can register additional
320 elements at this point in the schema.
321 </xs:documentation>
322 </xs:annotation>
323 </xs:any>
324 </xs:choice>
325 <xs:attribute name="Value" type="xs:string" use="required">
326 <xs:annotation>
327 <xs:documentation>
328 A local address to which the port or program can listen. See [LocalAddresses](https://learn.microsoft.com/en-us/windows/win32/api/netfw/nf-netfw-inetfwrule-get_localaddresses)
329 for examples.
330 </xs:documentation>
331 </xs:annotation>
332 </xs:attribute>
333 <xs:anyAttribute namespace="##other" processContents="lax">
334 <xs:annotation>
335 <xs:documentation>
336 Extensibility point in the WiX XML Schema. Schema extensions can register additional
337 attributes at this point in the schema.
338 </xs:documentation>
339 </xs:annotation>
340 </xs:anyAttribute>
341 </xs:complexType>
342 </xs:element>
343
344 <xs:element name="Interface">
345 <xs:annotation>
346 <xs:documentation>
347 [WiX v5] Registers an interface with the firewall rule.
348 </xs:documentation>
349 </xs:annotation>
350
351 <xs:complexType>
352 <xs:choice minOccurs="0" maxOccurs="unbounded">
353 <xs:any namespace="##other" processContents="lax">
354 <xs:annotation>
355 <xs:documentation>
356 Extensibility point in the WiX XML Schema. Schema extensions can register additional
357 elements at this point in the schema.
358 </xs:documentation>
359 </xs:annotation>
360 </xs:any>
361 </xs:choice>
362 <xs:attribute name="Name" type="xs:string" use="required">
363 <xs:annotation>
364 <xs:documentation>
365 A interface to which the firewall rule applices. See [Interfaces](https://learn.microsoft.com/en-us/windows/win32/api/netfw/nf-netfw-inetfwrule-get_interfaces)
366 for examples.
367 </xs:documentation>
368 </xs:annotation>
369 </xs:attribute>
370 <xs:anyAttribute namespace="##other" processContents="lax">
371 <xs:annotation>
372 <xs:documentation>
373 Extensibility point in the WiX XML Schema. Schema extensions can register additional
374 attributes at this point in the schema.
375 </xs:documentation>
376 </xs:annotation>
377 </xs:anyAttribute>
378 </xs:complexType>
379 </xs:element>
380
381 <xs:element name="InterfaceType">
382 <xs:annotation>
383 <xs:documentation>
384 [WiX v5] Registers an inteface type to the firewall rule.
385 </xs:documentation>
386 </xs:annotation>
387 <xs:complexType>
388 <xs:choice minOccurs="0" maxOccurs="unbounded">
389 <xs:any namespace="##other" processContents="lax">
390 <xs:annotation>
391 <xs:documentation>
392 Extensibility point in the WiX XML Schema. Schema extensions can register additional
393 elements at this point in the schema.
394 </xs:documentation>
395 </xs:annotation>
396 </xs:any>
397 </xs:choice>
398 <xs:attribute name="Value" type="FirewallInterfaceTypeUnion">
399 <xs:annotation>
400 <xs:documentation>
401 A interface type to which the firewall rule applices. See [Interfaces](https://learn.microsoft.com/en-us/windows/win32/api/netfw/nf-netfw-inetfwrule-get_interfaces)
402 for examples.
403 </xs:documentation>
404 </xs:annotation>
405 </xs:attribute>
406 <xs:anyAttribute namespace="##other" processContents="lax">
407 <xs:annotation>
408 <xs:documentation>
409 Extensibility point in the WiX XML Schema. Schema extensions can register additional
410 attributes at this point in the schema.
411 </xs:documentation>
412 </xs:annotation>
413 </xs:anyAttribute>
414 </xs:complexType>
415 </xs:element>
416
417 <xs:element name="RemoteAddress">
418 <xs:complexType>
419 <xs:choice minOccurs="0" maxOccurs="unbounded">
420 <xs:any namespace="##other" processContents="lax">
421 <xs:annotation>
422 <xs:documentation>
423 Extensibility point in the WiX XML Schema. Schema extensions can register additional
424 elements at this point in the schema.
425 </xs:documentation>
426 </xs:annotation>
427 </xs:any>
428 </xs:choice>
429 <xs:attribute name="Value" type="xs:string" use="required">
430 <xs:annotation>
431 <xs:documentation>
432 A remote address to which the port or program can listen. See [RemoteAddresses](https://learn.microsoft.com/en-us/windows/win32/api/netfw/nf-netfw-inetfwrule-get_remoteaddresses)
433 for examples.
434 </xs:documentation>
435 </xs:annotation>
436 </xs:attribute>
437 <xs:anyAttribute namespace="##other" processContents="lax">
438 <xs:annotation>
439 <xs:documentation>
440 Extensibility point in the WiX XML Schema. Schema extensions can register additional
441 attributes at this point in the schema.
442 </xs:documentation>
443 </xs:annotation>
444 </xs:anyAttribute>
445 </xs:complexType>
446 </xs:element>
447
448 <xs:simpleType name="PropertyReference">
449 <xs:annotation>
450 <xs:documentation>A type that represents a Property reference.</xs:documentation>
451 </xs:annotation>
452 <xs:restriction base="xs:string">
453 <xs:pattern value="\[.+\]" />
454 </xs:restriction>
455 </xs:simpleType>
456
457 <xs:simpleType name="FirewallActionTypeUnion">
458 <xs:union memberTypes="FirewallActionType PropertyReference wxs:PreprocessorVariables"/>
459 </xs:simpleType>
460 <xs:simpleType name="FirewallActionType">
461 <xs:restriction base="xs:NMTOKEN">
462 <xs:enumeration value="allow" />
463 <xs:enumeration value="block" />
464 </xs:restriction>
465 </xs:simpleType>
466
467 <xs:simpleType name="FirewallEdgeTraversalTypeUnion">
468 <xs:union memberTypes="FirewallEdgeTraversalType PropertyReference wxs:PreprocessorVariables"/>
469 </xs:simpleType>
470 <xs:simpleType name="FirewallEdgeTraversalType">
471 <xs:restriction base="xs:NMTOKEN">
472 <xs:enumeration value="allow" />
473 <xs:enumeration value="deferToApp" />
474 <xs:enumeration value="deferToUser" />
475 <xs:enumeration value="deny" />
476 </xs:restriction>
477 </xs:simpleType>
478
479 <xs:simpleType name="FirewallInterfaceTypeUnion">
480 <xs:union memberTypes="FirewallInterfaceType PropertyReference wxs:PreprocessorVariables"/>
481 </xs:simpleType>
482 <xs:simpleType name="FirewallInterfaceType">
483 <xs:restriction base="xs:NMTOKEN">
484 <xs:enumeration value="all" />
485 <xs:enumeration value="lan" />
486 <xs:enumeration value="remoteAccess" />
487 <xs:enumeration value="wireless" />
488 </xs:restriction>
489 </xs:simpleType>
490
491 <xs:simpleType name="FirewallIPSecSecureFlagsUnion">
492 <xs:union memberTypes="FirewallIPSecSecureFlags PropertyReference wxs:PreprocessorVariables"/>
493 </xs:simpleType>
494 <xs:simpleType name="FirewallIPSecSecureFlags">
495 <xs:restriction base="xs:NMTOKEN">
496 <xs:enumeration value="none" />
497 <xs:enumeration value="encrypt" />
498 <xs:enumeration value="negotiateEncryption" />
499 <xs:enumeration value="noEncapsulation" />
500 <xs:enumeration value="withIntegrity" />
501 </xs:restriction>
502 </xs:simpleType>
503
504 <xs:simpleType name="FirewallLocalScopeTypeUnion">
505 <xs:union memberTypes="FirewallLocalScopeType PropertyReference wxs:PreprocessorVariables"/>
506 </xs:simpleType>
507 <xs:simpleType name="FirewallLocalScopeType">
508 <xs:restriction base="xs:NMTOKEN">
509 <xs:enumeration value="any" />
510 <xs:enumeration value="dns" />
511 <xs:enumeration value="dhcp" />
512 <xs:enumeration value="wins" />
513 <xs:enumeration value="localSubnet" />
514 <xs:enumeration value="defaultGateway" />
515 </xs:restriction>
516 </xs:simpleType>
517
518 <xs:simpleType name="FirewallOnUpdateTypeUnion">
519 <xs:union memberTypes="FirewallOnUpdateType PropertyReference wxs:PreprocessorVariables"/>
520 </xs:simpleType>
521 <xs:simpleType name="FirewallOnUpdateType">
522 <xs:restriction base="xs:NMTOKEN">
523 <xs:enumeration value="doNothing" />
524 <xs:enumeration value="enableOnly" />
525 </xs:restriction>
526 </xs:simpleType>
527
528 <xs:simpleType name="FirewallProfileTypeUnion">
529 <xs:union memberTypes="FirewallProfileType PropertyReference wxs:PreprocessorVariables"/>
530 </xs:simpleType>
531 <xs:simpleType name="FirewallProfileType">
532 <xs:restriction base="xs:NMTOKEN">
533 <xs:enumeration value="domain" />
534 <xs:enumeration value="private" />
535 <xs:enumeration value="public" />
536 <xs:enumeration value="all" />
537 </xs:restriction>
538 </xs:simpleType>
539
540 <xs:simpleType name="FirewallProtocolTypeUnion">
541 <xs:union memberTypes="PropertyReference FirewallProtocolType FirewallProtocolNumber wxs:PreprocessorVariables"/>
542 </xs:simpleType>
543 <xs:simpleType name="FirewallProtocolType">
544 <xs:restriction base="xs:NMTOKEN">
545 <xs:enumeration value="tcp" />
546 <xs:enumeration value="udp" />
547 </xs:restriction>
548 </xs:simpleType>
549 <xs:simpleType name="FirewallProtocolNumber">
550 <xs:restriction base="xs:integer">
551 <xs:minInclusive value="0"/>
552 <xs:maxInclusive value="255"/>
553 </xs:restriction>
554 </xs:simpleType>
555
556 <xs:simpleType name="FirewallScopeTypeUnion">
557 <xs:union memberTypes="FirewallScopeType PropertyReference wxs:PreprocessorVariables"/>
558 </xs:simpleType>
559 <xs:simpleType name="FirewallScopeType">
560 <xs:restriction base="xs:NMTOKEN">
561 <xs:enumeration value="any" />
562 <xs:enumeration value="localSubnet" />
563 <xs:enumeration value="dns" />
564 <xs:enumeration value="dhcp" />
565 <xs:enumeration value="wins" />
566 <xs:enumeration value="defaultGateway" />
567 </xs:restriction>
568 </xs:simpleType>
569
570 <xs:simpleType name="FirewallYesNoPropertyType">
571 <xs:annotation>
572 <xs:documentation>
573 Allows "yes" or "true" or "no" or "false" or a Property reference.
574 </xs:documentation>
575 </xs:annotation>
576 <xs:union memberTypes="PropertyReference wxs:YesNoTypeUnion"/>
577 </xs:simpleType>
578</xs:schema>
diff --git a/src/xsd/http.xsd b/src/xsd/http.xsd
new file mode 100644
index 00000000..63820522
--- /dev/null
+++ b/src/xsd/http.xsd
@@ -0,0 +1,268 @@
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 xmlns:wxs="http://wixtoolset.org/schemas/v4/wxs"
9 targetNamespace="http://wixtoolset.org/schemas/v4/wxs/http"
10 xmlns="http://wixtoolset.org/schemas/v4/wxs/http">
11 <xs:annotation>
12 <xs:documentation>
13 The source code schema for the Windows Installer XML Toolset Http Extension.
14 </xs:documentation>
15 </xs:annotation>
16
17 <xs:import namespace="http://wixtoolset.org/schemas/v4/wxs" />
18
19 <xs:element name="SniSslCertificate">
20 <xs:annotation>
21 <xs:documentation>
22 Associates an SNI SSL certificate with HTTP.SYS.
23 </xs:documentation>
24 <xs:appinfo>
25 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
26 </xs:appinfo>
27 </xs:annotation>
28 <xs:complexType>
29 <xs:choice minOccurs="0" maxOccurs="unbounded">
30 <xs:any namespace="##other" processContents="lax">
31 <xs:annotation>
32 <xs:documentation>
33 Extensibility point in the WiX XML Schema. Schema extensions can register additional
34 elements at this point in the schema.
35 </xs:documentation>
36 </xs:annotation>
37 </xs:any>
38 </xs:choice>
39 <xs:attribute name="Id" type="xs:string">
40 <xs:annotation>
41 <xs:documentation>
42 Unique ID of this SNI SSL.
43 If this attribute is not specified, an identifier will be generated automatically.
44 </xs:documentation>
45 </xs:annotation>
46 </xs:attribute>
47
48 <xs:attribute name="AppId" type="xs:string">
49 <xs:annotation>
50 <xs:documentation>A GUID used ot identify the SNI SSL binding.</xs:documentation>
51 </xs:annotation>
52 </xs:attribute>
53
54 <xs:attribute name="HandleExisting">
55 <xs:annotation>
56 <xs:documentation>
57 Rights for this ACE. Default is "all".
58 </xs:documentation>
59 </xs:annotation>
60 <xs:simpleType>
61 <xs:restriction base="xs:NMTOKEN">
62 <xs:enumeration value="replace" />
63 <xs:enumeration value="ignore" />
64 <xs:enumeration value="fail" />
65 </xs:restriction>
66 </xs:simpleType>
67 </xs:attribute>
68
69 <xs:attribute name="Host" type="xs:string" use="required">
70 <xs:annotation>
71 <xs:documentation>Host of the URL to bind with the SNI SSL certificate.</xs:documentation>
72 </xs:annotation>
73 </xs:attribute>
74
75 <xs:attribute name="Port" type="xs:string" use="required">
76 <xs:annotation>
77 <xs:documentation>Host of the URL to bind with the SNI SSL certificate.</xs:documentation>
78 </xs:annotation>
79 </xs:attribute>
80
81 <xs:attribute name="Store" type="xs:string">
82 <xs:annotation>
83 <xs:documentation>Certificate store containing the SNI SSL certificate.</xs:documentation>
84 </xs:annotation>
85 </xs:attribute>
86
87 <xs:attribute name="Thumbprint" type="xs:string" use="required">
88 <xs:annotation>
89 <xs:documentation>Thumbprint of the SNI SSL certificate.</xs:documentation>
90 </xs:annotation>
91 </xs:attribute>
92
93 <xs:anyAttribute namespace="##other" processContents="lax">
94 <xs:annotation>
95 <xs:documentation>
96 Extensibility point in the WiX XML Schema. Schema extensions can register additional
97 attributes at this point in the schema.
98 </xs:documentation>
99 </xs:annotation>
100 </xs:anyAttribute>
101 </xs:complexType>
102 </xs:element>
103
104 <xs:element name="UrlReservation">
105 <xs:annotation>
106 <xs:documentation>
107 Makes a reservation record for the HTTP Server API configuration store on Windows XP SP2,
108 Windows Server 2003, and later. For more information about the HTTP Server API, see
109 [HTTP Server API](https://learn.microsoft.com/en-us/windows/win32/http/http-api-start-page).
110 </xs:documentation>
111 <xs:appinfo>
112 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
113 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="ServiceInstall" />
114 </xs:appinfo>
115 </xs:annotation>
116
117 <xs:complexType>
118 <xs:choice minOccurs="0" maxOccurs="unbounded">
119 <xs:annotation>
120 <xs:documentation>
121 The access control entries for the access control list.
122 </xs:documentation>
123 </xs:annotation>
124 <xs:element ref="UrlAce" />
125 <xs:any namespace="##other" processContents="lax">
126 <xs:annotation>
127 <xs:documentation>
128 Extensibility point in the WiX XML Schema. Schema extensions can register additional
129 elements at this point in the schema.
130 </xs:documentation>
131 </xs:annotation>
132 </xs:any>
133 </xs:choice>
134
135 <xs:attribute name="HandleExisting">
136 <xs:annotation>
137 <xs:documentation>
138 Specifies the behavior when trying to install a URL reservation and it already exists.
139 </xs:documentation>
140 </xs:annotation>
141 <xs:simpleType>
142 <xs:restriction base="xs:NMTOKEN">
143 <xs:enumeration value="replace">
144 <xs:annotation>
145 <xs:documentation>
146 Replaces the existing URL reservation (the default).
147 </xs:documentation>
148 </xs:annotation>
149 </xs:enumeration>
150 <xs:enumeration value="ignore">
151 <xs:annotation>
152 <xs:documentation>
153 Keeps the existing URL reservation.
154 </xs:documentation>
155 </xs:annotation>
156 </xs:enumeration>
157 <xs:enumeration value="fail">
158 <xs:annotation>
159 <xs:documentation>
160 The installation fails.
161 </xs:documentation>
162 </xs:annotation>
163 </xs:enumeration>
164 </xs:restriction>
165 </xs:simpleType>
166 </xs:attribute>
167
168 <xs:attribute name="Id" type="xs:string">
169 <xs:annotation>
170 <xs:documentation>
171 Unique ID of this URL reservation.
172 If this attribute is not specified, an identifier will be generated automatically.
173 </xs:documentation>
174 </xs:annotation>
175 </xs:attribute>
176
177 <xs:attribute name="Sddl" type="xs:string">
178 <xs:annotation>
179 <xs:documentation>
180 Security descriptor to apply to the URL reservation.
181 Can't be specified when using children UrlAce elements.
182 </xs:documentation>
183 </xs:annotation>
184 </xs:attribute>
185
186 <xs:attribute name="Url" type="xs:string" use="required">
187 <xs:annotation>
188 <xs:documentation>
189 The [UrlPrefix](https://learn.microsoft.com/en-us/windows/win32/http/urlprefix-strings)
190 string that defines the portion of the URL namespace to which this reservation pertains.
191 </xs:documentation>
192 </xs:annotation>
193 </xs:attribute>
194
195 <xs:anyAttribute namespace="##other" processContents="lax">
196 <xs:annotation>
197 <xs:documentation>
198 Extensibility point in the WiX XML Schema. Schema extensions can register additional
199 attributes at this point in the schema.
200 </xs:documentation>
201 </xs:annotation>
202 </xs:anyAttribute>
203 </xs:complexType>
204 </xs:element>
205
206 <xs:element name="UrlAce">
207 <xs:annotation>
208 <xs:documentation>
209 The security principal and which rights to assign to them for the URL reservation.
210 </xs:documentation>
211 </xs:annotation>
212 <xs:complexType>
213 <xs:choice minOccurs="0" maxOccurs="unbounded">
214 <xs:any namespace="##other" processContents="lax">
215 <xs:annotation>
216 <xs:documentation>
217 Extensibility point in the WiX XML Schema. Schema extensions can register additional
218 elements at this point in the schema.
219 </xs:documentation>
220 </xs:annotation>
221 </xs:any>
222 </xs:choice>
223 <xs:attribute name="Id" type="xs:string">
224 <xs:annotation>
225 <xs:documentation>
226 Unique ID of this URL ACE.
227 If this attribute is not specified, an identifier will be generated automatically.
228 </xs:documentation>
229 </xs:annotation>
230 </xs:attribute>
231
232 <xs:attribute name="SecurityPrincipal" type="xs:string">
233 <xs:annotation>
234 <xs:documentation>
235 The security principal for this ACE. When the UrlReservation is under a ServiceInstall element, this defaults to
236 "NT SERVICE\ServiceInstallName". This may be either a SID or an account name in a format that
237 [LookupAccountName](https://learn.microsoft.com/en-us/windows/win32/api/winbase/nf-winbase-lookupaccountnamea)
238 supports. When using a SID, an asterisk must be prepended. For example, "*S-1-5-18".
239 </xs:documentation>
240 </xs:annotation>
241 </xs:attribute>
242
243 <xs:attribute name="Rights">
244 <xs:annotation>
245 <xs:documentation>
246 Rights for this ACE. Default is "all".
247 </xs:documentation>
248 </xs:annotation>
249 <xs:simpleType>
250 <xs:restriction base="xs:NMTOKEN">
251 <xs:enumeration value="register" />
252 <xs:enumeration value="delegate" />
253 <xs:enumeration value="all" />
254 </xs:restriction>
255 </xs:simpleType>
256 </xs:attribute>
257
258 <xs:anyAttribute namespace="##other" processContents="lax">
259 <xs:annotation>
260 <xs:documentation>
261 Extensibility point in the WiX XML Schema. Schema extensions can register additional
262 attributes at this point in the schema.
263 </xs:documentation>
264 </xs:annotation>
265 </xs:anyAttribute>
266 </xs:complexType>
267 </xs:element>
268</xs:schema>
diff --git a/src/xsd/iis.xsd b/src/xsd/iis.xsd
new file mode 100644
index 00000000..b43bff42
--- /dev/null
+++ b/src/xsd/iis.xsd
@@ -0,0 +1,1438 @@
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 xmlns:wxs="http://wixtoolset.org/schemas/v4/wxs"
9 targetNamespace="http://wixtoolset.org/schemas/v4/wxs/iis"
10 xmlns="http://wixtoolset.org/schemas/v4/wxs/iis">
11 <xs:annotation>
12 <xs:documentation>
13 The source code schema for the WiX Toolset Internet Information Services Extension.
14 </xs:documentation>
15 </xs:annotation>
16
17 <xs:import namespace="http://wixtoolset.org/schemas/v4/wxs" />
18
19 <xs:element name="WebDirProperties">
20 <xs:annotation>
21 <xs:appinfo>
22 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
23 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Module" />
24 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Package" />
25 </xs:appinfo>
26 <xs:documentation>
27 WebDirProperties used by one or more WebSites. Lists properties common to IIS web sites and vroots. Corresponding properties can be viewed through the IIS Manager snap-in. One property entry can be reused by multiple sites or vroots using the Id field as a reference, using WebVirtualDir.DirProperties, WebSite.DirProperties, or WebDir.DirProperties.
28 </xs:documentation>
29 </xs:annotation>
30 <xs:complexType>
31 <xs:choice minOccurs="0" maxOccurs="unbounded">
32 <xs:any namespace="##other" processContents="lax">
33 <xs:annotation>
34 <xs:documentation>
35 Extensibility point in the WiX XML Schema. Schema extensions can register additional
36 elements at this point in the schema.
37 </xs:documentation>
38 </xs:annotation>
39 </xs:any>
40 </xs:choice>
41 <xs:attribute name="Id" type="xs:string">
42 <xs:annotation>
43 <xs:documentation>Identifier for the WebDirProperties. The Id is required when the parent is a Fragment, Module, or Package. Otherwise, Id is optional and if not specified, it will be generated.</xs:documentation>
44 </xs:annotation>
45 </xs:attribute>
46 <xs:attribute name="Read" type="wxs:YesNoTypeUnion" />
47 <xs:attribute name="Write" type="wxs:YesNoTypeUnion" />
48 <xs:attribute name="Script" type="wxs:YesNoTypeUnion" />
49 <xs:attribute name="Execute" type="wxs:YesNoTypeUnion" />
50 <xs:attribute name="AnonymousAccess" type="wxs:YesNoTypeUnion">
51 <xs:annotation>
52 <xs:documentation>Sets the Enable Anonymous Access checkbox, which maps anonymous users to a Windows user account. When setting this to 'yes' you should also provide the user account using the AnonymousUser attribute, and determine what setting to use for the IIsControlledPassword attribute. Defaults to 'no.'</xs:documentation>
53 </xs:annotation>
54 </xs:attribute>
55 <xs:attribute name="AnonymousUser" type="xs:string">
56 <xs:annotation>
57 <xs:documentation>Reference to the Id attribute on the User element to be used as the anonymous user for the directory. See the User element for more information.</xs:documentation>
58 </xs:annotation>
59 </xs:attribute>
60 <xs:attribute name="IIsControlledPassword" type="wxs:YesNoTypeUnion">
61 <xs:annotation>
62 <xs:documentation>Sets whether IIS should control the password used for the Windows account specified in the AnonymousUser attribute. Defaults to 'no.'</xs:documentation>
63 </xs:annotation>
64 </xs:attribute>
65 <xs:attribute name="WindowsAuthentication" type="wxs:YesNoTypeUnion">
66 <xs:annotation>
67 <xs:documentation>Sets the Windows Authentication option, which enables integrated Windows authentication to be used on the site. Defaults to 'no.'</xs:documentation>
68 </xs:annotation>
69 </xs:attribute>
70 <xs:attribute name="DigestAuthentication" type="wxs:YesNoTypeUnion">
71 <xs:annotation>
72 <xs:documentation>Sets the Digest Authentication option, which allows using digest authentication with domain user accounts. Defaults to 'no.'</xs:documentation>
73 </xs:annotation>
74 </xs:attribute>
75 <xs:attribute name="BasicAuthentication" type="wxs:YesNoTypeUnion">
76 <xs:annotation>
77 <xs:documentation>Sets the Basic Authentication option, which allows clients to provide credentials in plaintext over the wire. Defaults to 'no.'</xs:documentation>
78 </xs:annotation>
79 </xs:attribute>
80 <xs:attribute name="PassportAuthentication" type="wxs:YesNoTypeUnion">
81 <xs:annotation>
82 <xs:documentation>Sets the Passport Authentication option, which allows clients to provide credentials via a .Net Passport account. Defaults to 'no.'</xs:documentation>
83 </xs:annotation>
84 </xs:attribute>
85 <xs:attribute name="LogVisits" type="wxs:YesNoTypeUnion">
86 <xs:annotation>
87 <xs:documentation>Sets whether visits to this site should be logged. Defaults to 'no.'</xs:documentation>
88 </xs:annotation>
89 </xs:attribute>
90 <xs:attribute name="Index" type="wxs:YesNoTypeUnion">
91 <xs:annotation>
92 <xs:documentation>Sets the Index Resource option, which specifies whether this web directory should be indexed. Defaults to 'no.'</xs:documentation>
93 </xs:annotation>
94 </xs:attribute>
95 <xs:attribute name="DefaultDocuments" type="xs:string">
96 <xs:annotation>
97 <xs:documentation>The list of default documents to set for this web directory, in comma-delimited format.</xs:documentation>
98 </xs:annotation>
99 </xs:attribute>
100 <xs:attribute name="AspDetailedError" type="wxs:YesNoTypeUnion">
101 <xs:annotation>
102 <xs:documentation>Sets the option for whether to send detailed ASP errors back to the client on script error. Default is 'no.'</xs:documentation>
103 </xs:annotation>
104 </xs:attribute>
105 <xs:attribute name="HttpExpires" type="xs:string">
106 <xs:annotation>
107 <xs:documentation>Value to set the HttpExpires attribute to for a Web Dir in the metabase.</xs:documentation>
108 </xs:annotation>
109 </xs:attribute>
110 <xs:attribute name="CacheControlMaxAge" type="xs:nonNegativeInteger">
111 <xs:annotation>
112 <xs:documentation>Integer value specifying the cache control maximum age value.</xs:documentation>
113 </xs:annotation>
114 </xs:attribute>
115 <xs:attribute name="CacheControlCustom" type="xs:string">
116 <xs:annotation>
117 <xs:documentation>Custom HTTP 1.1 cache control directives.</xs:documentation>
118 </xs:annotation>
119 </xs:attribute>
120 <xs:attribute name="ClearCustomError" type="wxs:YesNoTypeUnion">
121 <xs:annotation>
122 <xs:documentation>Specifies whether IIs will return custom errors for this directory.</xs:documentation>
123 </xs:annotation>
124 </xs:attribute>
125 <xs:attribute name="AccessSSL" type="wxs:YesNoTypeUnion">
126 <xs:annotation>
127 <xs:documentation>A value of true indicates that file access requires SSL file permission processing, with or without a client certificate. This corresponds to AccessSSL flag for AccessSSLFlags IIS metabase property.</xs:documentation>
128 </xs:annotation>
129 </xs:attribute>
130 <xs:attribute name="AccessSSL128" type="wxs:YesNoTypeUnion">
131 <xs:annotation>
132 <xs:documentation>A value of true indicates that file access requires SSL file permission processing with a minimum key size of 128 bits, with or without a client certificate. This corresponds to AccessSSL128 flag for AccessSSLFlags IIS metabase property.</xs:documentation>
133 </xs:annotation>
134 </xs:attribute>
135 <xs:attribute name="AccessSSLMapCert" type="wxs:YesNoTypeUnion">
136 <xs:annotation>
137 <xs:documentation>This corresponds to AccessSSLMapCert flag for AccessSSLFlags IIS metabase property.</xs:documentation>
138 </xs:annotation>
139 </xs:attribute>
140 <xs:attribute name="AccessSSLNegotiateCert" type="wxs:YesNoTypeUnion">
141 <xs:annotation>
142 <xs:documentation>This corresponds to AccessSSLNegotiateCert flag for AccessSSLFlags IIS metabase property.</xs:documentation>
143 </xs:annotation>
144 </xs:attribute>
145 <xs:attribute name="AccessSSLRequireCert" type="wxs:YesNoTypeUnion">
146 <xs:annotation>
147 <xs:documentation>This corresponds to AccessSSLRequireCert flag for AccessSSLFlags IIS metabase property.</xs:documentation>
148 </xs:annotation>
149 </xs:attribute>
150 <xs:attribute name="AuthenticationProviders" type="xs:string">
151 <xs:annotation>
152 <xs:documentation>Comma delimited list, in order of precedence, of Windows authentication providers that IIS will attempt to use: NTLM, Kerberos, Negotiate, and others.</xs:documentation>
153 </xs:annotation>
154 </xs:attribute>
155 <xs:anyAttribute namespace="##other" processContents="lax">
156 <xs:annotation>
157 <xs:documentation>
158 Extensibility point in the WiX XML Schema. Schema extensions can register additional
159 attributes at this point in the schema.
160 </xs:documentation>
161 </xs:annotation>
162 </xs:anyAttribute>
163 </xs:complexType>
164 </xs:element>
165
166 <xs:element name="WebError">
167 <xs:annotation>
168 <xs:documentation>Custom Web Errors used by WebSites and Virtual Directories.</xs:documentation>
169 <xs:appinfo>
170 <xse:remarks>
171 You can only use error code and sub code combinations which are supported by IIS. Attempting to set a custom error for
172 an error code and sub code combination that is not supported by IIS (in the default list of error codes) will result in
173 an installation failure.
174 </xse:remarks>
175 </xs:appinfo>
176 </xs:annotation>
177 <xs:complexType>
178 <xs:choice minOccurs="0" maxOccurs="unbounded">
179 <xs:any namespace="##other" processContents="lax">
180 <xs:annotation>
181 <xs:documentation>
182 Extensibility point in the WiX XML Schema. Schema extensions can register additional
183 elements at this point in the schema.
184 </xs:documentation>
185 </xs:annotation>
186 </xs:any>
187 </xs:choice>
188 <xs:attribute name="ErrorCode" use="required" type="wxs:Integer">
189 <xs:annotation>
190 <xs:documentation>HTTP 1.1 error code.</xs:documentation>
191 </xs:annotation>
192 </xs:attribute>
193 <xs:attribute name="SubCode" use="required" type="wxs:Integer">
194 <xs:annotation>
195 <xs:documentation>Error sub code. Set to 0 to get the wild card "*".</xs:documentation>
196 </xs:annotation>
197 </xs:attribute>
198 <xs:attribute name="File" type="xs:string">
199 <xs:annotation>
200 <xs:documentation>File to be sent to the client for this error code and sub code. This can be formatted. For example: [#FileId].</xs:documentation>
201 </xs:annotation>
202 </xs:attribute>
203 <xs:attribute name="URL" type="xs:string">
204 <xs:annotation>
205 <xs:documentation>URL to be sent to the client for this error code and sub code. This can be formatted.</xs:documentation>
206 </xs:annotation>
207 </xs:attribute>
208 <xs:anyAttribute namespace="##other" processContents="lax">
209 <xs:annotation>
210 <xs:documentation>
211 Extensibility point in the WiX XML Schema. Schema extensions can register additional
212 attributes at this point in the schema.
213 </xs:documentation>
214 </xs:annotation>
215 </xs:anyAttribute>
216 </xs:complexType>
217 </xs:element>
218
219 <xs:element name="HttpHeader">
220 <xs:annotation>
221 <xs:documentation>Custom HTTP Header definition for IIS resources such as WebSite and WebVirtualDir.</xs:documentation>
222 </xs:annotation>
223 <xs:complexType>
224 <xs:choice minOccurs="0" maxOccurs="unbounded">
225 <xs:any namespace="##other" processContents="lax">
226 <xs:annotation>
227 <xs:documentation>
228 Extensibility point in the WiX XML Schema. Schema extensions can register additional
229 elements at this point in the schema.
230 </xs:documentation>
231 </xs:annotation>
232 </xs:any>
233 </xs:choice>
234 <xs:attribute name="Id" type="xs:string">
235 <xs:annotation>
236 <xs:documentation>Primary key for custom HTTP Header entry. This will default to the Name attribute.</xs:documentation>
237 </xs:annotation>
238 </xs:attribute>
239 <xs:attribute name="Name" type="xs:string" use="required">
240 <xs:annotation>
241 <xs:documentation>Name of the custom HTTP Header.</xs:documentation>
242 </xs:annotation>
243 </xs:attribute>
244 <xs:attribute name="Value" type="xs:string">
245 <xs:annotation>
246 <xs:documentation>Value for the custom HTTP Header. 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 <a href="http://msdn.microsoft.com/library/aa368609.aspx" target="_blank">Formatted</a> for details.</xs:documentation>
247 </xs:annotation>
248 </xs:attribute>
249 <xs:anyAttribute namespace="##other" processContents="lax">
250 <xs:annotation>
251 <xs:documentation>
252 Extensibility point in the WiX XML Schema. Schema extensions can register additional
253 attributes at this point in the schema.
254 </xs:documentation>
255 </xs:annotation>
256 </xs:anyAttribute>
257 </xs:complexType>
258 </xs:element>
259
260 <xs:element name="MimeMap">
261 <xs:annotation>
262 <xs:documentation>MimeMap definition for IIS resources.</xs:documentation>
263 </xs:annotation>
264 <xs:complexType>
265 <xs:choice minOccurs="0" maxOccurs="unbounded">
266 <xs:any namespace="##other" processContents="lax">
267 <xs:annotation>
268 <xs:documentation>
269 Extensibility point in the WiX XML Schema. Schema extensions can register additional
270 elements at this point in the schema.
271 </xs:documentation>
272 </xs:annotation>
273 </xs:any>
274 </xs:choice>
275 <xs:attribute name="Id" type="xs:string">
276 <xs:annotation>
277 <xs:documentation>Id for the MimeMap. If the Id is not specified, it will be generated.</xs:documentation>
278 </xs:annotation>
279 </xs:attribute>
280 <xs:attribute name="Type" type="xs:string" use="required">
281 <xs:annotation>
282 <xs:documentation>Mime-type covered by the MimeMap.</xs:documentation>
283 </xs:annotation>
284 </xs:attribute>
285 <xs:attribute name="Extension" type="xs:string" use="required">
286 <xs:annotation>
287 <xs:documentation>Extension covered by the MimeMap. Must begin with a dot.</xs:documentation>
288 </xs:annotation>
289 </xs:attribute>
290 <xs:anyAttribute namespace="##other" processContents="lax">
291 <xs:annotation>
292 <xs:documentation>
293 Extensibility point in the WiX XML Schema. Schema extensions can register additional
294 attributes at this point in the schema.
295 </xs:documentation>
296 </xs:annotation>
297 </xs:anyAttribute>
298 </xs:complexType>
299 </xs:element>
300
301 <xs:element name="WebFilter">
302 <xs:annotation>
303 <xs:appinfo>
304 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
305 </xs:appinfo>
306 <xs:documentation>IIs Filter for a Component or Web Site</xs:documentation>
307 </xs:annotation>
308 <xs:complexType>
309 <xs:choice minOccurs="0" maxOccurs="unbounded">
310 <xs:any namespace="##other" processContents="lax">
311 <xs:annotation>
312 <xs:documentation>
313 Extensibility point in the WiX XML Schema. Schema extensions can register additional
314 elements at this point in the schema.
315 </xs:documentation>
316 </xs:annotation>
317 </xs:any>
318 </xs:choice>
319 <xs:attribute name="Id" type="xs:string">
320 <xs:annotation>
321 <xs:documentation>The unique Id for the web filter. If the Id is not specified, it will be generated.</xs:documentation>
322 </xs:annotation>
323 </xs:attribute>
324 <xs:attribute name="Name" type="xs:string" use="required">
325 <xs:annotation>
326 <xs:documentation>The name of the filter to be used in IIS.</xs:documentation>
327 </xs:annotation>
328 </xs:attribute>
329 <xs:attribute name="Path" type="xs:string" use="required">
330 <xs:annotation>
331 <xs:documentation>
332 The path of the filter executable file.
333 This should usually be a value like '[!FileId]', where 'FileId' is the file identifier
334 of the filter executable file.
335 </xs:documentation>
336 </xs:annotation>
337 </xs:attribute>
338 <xs:attribute name="WebSite" type="xs:string">
339 <xs:annotation>
340 <xs:documentation>
341 Specifies the parent website for this filter (if there is one).
342 If this is a global filter, then this attribute should not be specified.
343 </xs:documentation>
344 </xs:annotation>
345 </xs:attribute>
346 <xs:attribute name="Description" type="xs:string">
347 <xs:annotation>
348 <xs:documentation>Description of the filter.</xs:documentation>
349 </xs:annotation>
350 </xs:attribute>
351 <xs:attribute name="Flags" type="wxs:Integer">
352 <xs:annotation>
353 <xs:documentation>Sets the MD_FILTER_FLAGS metabase key for the filter. This must be an integer. See MSDN 'FilterFlags' documentation for more details.</xs:documentation>
354 </xs:annotation>
355 </xs:attribute>
356 <xs:attribute name="LoadOrder" type="xs:string">
357 <xs:annotation>
358 <xs:documentation>
359 The legal values are "first", "last", or a number.
360 If a number is specified, it must be greater than 0.
361 </xs:documentation>
362 </xs:annotation>
363 </xs:attribute>
364 <xs:anyAttribute namespace="##other" processContents="lax">
365 <xs:annotation>
366 <xs:documentation>
367 Extensibility point in the WiX XML Schema. Schema extensions can register additional
368 attributes at this point in the schema.
369 </xs:documentation>
370 </xs:annotation>
371 </xs:anyAttribute>
372 </xs:complexType>
373 </xs:element>
374
375 <xs:element name="WebApplicationExtension">
376 <xs:annotation>
377 <xs:documentation>Extension for WebApplication</xs:documentation>
378 </xs:annotation>
379 <xs:complexType>
380 <xs:choice minOccurs="0" maxOccurs="unbounded">
381 <xs:any namespace="##other" processContents="lax">
382 <xs:annotation>
383 <xs:documentation>
384 Extensibility point in the WiX XML Schema. Schema extensions can register additional
385 elements at this point in the schema.
386 </xs:documentation>
387 </xs:annotation>
388 </xs:any>
389 </xs:choice>
390 <xs:attribute name="Executable" type="xs:string" use="required">
391 <xs:annotation>
392 <xs:documentation>Usually a Property that resolves to short file name path.</xs:documentation>
393 </xs:annotation>
394 </xs:attribute>
395 <xs:attribute name="Extension" type="xs:string">
396 <xs:annotation>
397 <xs:documentation>
398 Extension being registered. Do not prefix with a '.' (e.g. you should use "html", not ".html").
399 To register for all extensions, use Extension="*". To register a wildcard application map (which
400 handles all requests, even those for directories or files with no extension) omit the Extension
401 attribute completely.
402 </xs:documentation>
403 </xs:annotation>
404 </xs:attribute>
405 <xs:attribute name="Verbs" type="xs:string">
406 </xs:attribute>
407 <xs:attribute name="Script" type="wxs:YesNoTypeUnion">
408 </xs:attribute>
409 <xs:attribute name="CheckPath" type="wxs:YesNoTypeUnion">
410 </xs:attribute>
411 <xs:anyAttribute namespace="##other" processContents="lax">
412 <xs:annotation>
413 <xs:documentation>
414 Extensibility point in the WiX XML Schema. Schema extensions can register additional
415 attributes at this point in the schema.
416 </xs:documentation>
417 </xs:annotation>
418 </xs:anyAttribute>
419 </xs:complexType>
420 </xs:element>
421
422 <xs:element name="WebAppPool">
423 <xs:annotation>
424 <xs:appinfo>
425 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
426 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
427 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Module" />
428 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Package" />
429 </xs:appinfo>
430 <xs:documentation>IIS Application Pool</xs:documentation>
431 </xs:annotation>
432 <xs:complexType>
433 <xs:choice minOccurs="0" maxOccurs="unbounded">
434 <xs:element ref="RecycleTime" />
435 <xs:any namespace="##other" processContents="lax">
436 <xs:annotation>
437 <xs:documentation>
438 Extensibility point in the WiX XML Schema. Schema extensions can register additional
439 elements at this point in the schema.
440 </xs:documentation>
441 </xs:annotation>
442 </xs:any>
443 </xs:choice>
444 <xs:attribute name="Id" type="xs:string">
445 <xs:annotation>
446 <xs:documentation>Id of the AppPool. If the Id is not specified, it will be generated.</xs:documentation>
447 </xs:annotation>
448 </xs:attribute>
449 <xs:attribute name="Name" type="xs:string" use="required">
450 <xs:annotation>
451 <xs:documentation>Name of the AppPool to be shown in IIs.</xs:documentation>
452 </xs:annotation>
453 </xs:attribute>
454 <xs:attribute name="User" type="xs:string">
455 <xs:annotation>
456 <xs:documentation>User account to run the AppPool as. To use this, you must set the Identity attribute to 'other'.</xs:documentation>
457 </xs:annotation>
458 </xs:attribute>
459 <xs:attribute name="RecycleMinutes" type="wxs:Integer">
460 <xs:annotation>
461 <xs:documentation>How often, in minutes, you want the AppPool to be recycled.</xs:documentation>
462 </xs:annotation>
463 </xs:attribute>
464 <xs:attribute name="RecycleRequests" type="wxs:Integer">
465 <xs:annotation>
466 <xs:documentation>How often, in requests, you want the AppPool to be recycled.</xs:documentation>
467 </xs:annotation>
468 </xs:attribute>
469 <xs:attribute name="VirtualMemory" type="wxs:Integer">
470 <xs:annotation>
471 <xs:documentation>Specifies the amount of virtual memory (in KB) that a worker process can use before the worker process recycles. The maximum value supported for this attribute is 4,294,967 KB.</xs:documentation>
472 </xs:annotation>
473 </xs:attribute>
474 <xs:attribute name="PrivateMemory" type="wxs:Integer">
475 <xs:annotation>
476 <xs:documentation>Specifies the amount of private memory (in KB) that a worker process can use before the worker process recycles. The maximum value supported for this attribute is 4,294,967 KB.</xs:documentation>
477 </xs:annotation>
478 </xs:attribute>
479 <xs:attribute name="IdleTimeout" type="wxs:Integer">
480 <xs:annotation>
481 <xs:documentation>Shutdown worker process after being idle for (time in minutes).</xs:documentation>
482 </xs:annotation>
483 </xs:attribute>
484 <xs:attribute name="QueueLimit" type="wxs:Integer">
485 <xs:annotation>
486 <xs:documentation>Limit the kernel request queue (number of requests).</xs:documentation>
487 </xs:annotation>
488 </xs:attribute>
489 <xs:attribute name="MaxCpuUsage" type="PercentType">
490 <xs:annotation>
491 <xs:documentation>Maximum CPU usage (percent).</xs:documentation>
492 </xs:annotation>
493 </xs:attribute>
494 <xs:attribute name="RefreshCpu" type="wxs:Integer">
495 <xs:annotation>
496 <xs:documentation>Refresh CPU usage numbers (in minutes).</xs:documentation>
497 </xs:annotation>
498 </xs:attribute>
499 <xs:attribute name="CpuAction">
500 <xs:annotation>
501 <xs:documentation>Action taken when CPU exceeds maximum CPU use (as defined with MaxCpuUsage and RefreshCpu).</xs:documentation>
502 </xs:annotation>
503 <xs:simpleType>
504 <xs:restriction base="xs:string">
505 <xs:enumeration value="none"/>
506 <xs:enumeration value="shutdown"/>
507 </xs:restriction>
508 </xs:simpleType>
509 </xs:attribute>
510 <xs:attribute name="MaxWorkerProcesses" type="wxs:Integer">
511 <xs:annotation>
512 <xs:documentation>Maximum number of worker processes.</xs:documentation>
513 </xs:annotation>
514 </xs:attribute>
515 <xs:attribute name="Identity">
516 <xs:annotation>
517 <xs:documentation>Identity you want the AppPool to run under (applicationPoolIdentity is only available on IIS7). Use the 'other' value in conjunction with the User attribute to specify non-standard user.</xs:documentation>
518 </xs:annotation>
519 <xs:simpleType>
520 <xs:restriction base="xs:string">
521 <xs:enumeration value="networkService"/>
522 <xs:enumeration value="localService"/>
523 <xs:enumeration value="localSystem"/>
524 <xs:enumeration value="other"/>
525 <xs:enumeration value="applicationPoolIdentity"/>
526 </xs:restriction>
527 </xs:simpleType>
528 </xs:attribute>
529 <xs:attribute name="ManagedPipelineMode" type="xs:string">
530 <xs:annotation>
531 <xs:documentation>
532 Specifies the request-processing mode that is used to process requests for managed content. Only available on IIS7, ignored on IIS6.
533 See https://learn.microsoft.com/en-us/iis/configuration/system.applicationHost/applicationPools/applicationPoolDefaults/ for valid values.
534 This attribute may be set via a formatted Property (e.g. [MyProperty]).
535 </xs:documentation>
536 </xs:annotation>
537 </xs:attribute>
538 <xs:attribute name="ManagedRuntimeVersion" type="xs:string">
539 <xs:annotation>
540 <xs:documentation>
541 Specifies the .NET Framework version to be used by the application pool. Only available on IIS7, ignored on IIS6.
542 See https://learn.microsoft.com/en-us/iis/configuration/system.applicationHost/applicationPools/applicationPoolDefaults/ for valid values.
543 This attribute may be set via a formatted Property (e.g. [MyProperty]).
544 </xs:documentation>
545 </xs:annotation>
546 </xs:attribute>
547 <xs:anyAttribute namespace="##other" processContents="lax">
548 <xs:annotation>
549 <xs:documentation>
550 Extensibility point in the WiX XML Schema. Schema extensions can register additional
551 attributes at this point in the schema.
552 </xs:documentation>
553 </xs:annotation>
554 </xs:anyAttribute>
555 </xs:complexType>
556 </xs:element>
557
558 <xs:element name="RecycleTime">
559 <xs:annotation>
560 <xs:documentation>IIS6 Application Pool Recycle Times on 24 hour clock.</xs:documentation>
561 </xs:annotation>
562 <xs:complexType>
563 <xs:choice minOccurs="0" maxOccurs="unbounded">
564 <xs:any namespace="##other" processContents="lax">
565 <xs:annotation>
566 <xs:documentation>
567 Extensibility point in the WiX XML Schema. Schema extensions can register additional
568 elements at this point in the schema.
569 </xs:documentation>
570 </xs:annotation>
571 </xs:any>
572 </xs:choice>
573 <xs:attribute name="Value" use="required">
574 <xs:simpleType>
575 <xs:restriction base="xs:string">
576 <xs:pattern value="\d{1,2}:\d{2}"/>
577 </xs:restriction>
578 </xs:simpleType>
579 </xs:attribute>
580 <xs:anyAttribute namespace="##other" processContents="lax">
581 <xs:annotation>
582 <xs:documentation>
583 Extensibility point in the WiX XML Schema. Schema extensions can register additional
584 attributes at this point in the schema.
585 </xs:documentation>
586 </xs:annotation>
587 </xs:anyAttribute>
588 </xs:complexType>
589 </xs:element>
590
591 <xs:element name="Certificate">
592 <xs:annotation>
593 <xs:documentation>
594 Used to install and uninstall certificates.
595 </xs:documentation>
596 <xs:appinfo>
597 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
598 <xse:seeAlso ref="CertificateRef"/>
599 </xs:appinfo>
600 </xs:annotation>
601 <xs:complexType>
602 <xs:choice minOccurs="0" maxOccurs="unbounded">
603 <xs:any namespace="##other" processContents="lax">
604 <xs:annotation>
605 <xs:documentation>
606 Extensibility point in the WiX XML Schema. Schema extensions can register additional
607 elements at this point in the schema.
608 </xs:documentation>
609 </xs:annotation>
610 </xs:any>
611 </xs:choice>
612 <xs:attribute name="Id" type="xs:string">
613 <xs:annotation>
614 <xs:documentation>
615 Unique identifier for this certificate in the installation package. If the Id is not specified, it will be generated.
616 </xs:documentation>
617 </xs:annotation>
618 </xs:attribute>
619 <xs:attribute name="Name" type="xs:string" use="required">
620 <xs:annotation>
621 <xs:documentation>
622 Name of the certificate that will be installed or uninstalled in the specified store.
623 This attribute may be set via a formatted Property (e.g. [MyProperty]).
624 </xs:documentation>
625 </xs:annotation>
626 </xs:attribute>
627 <xs:attribute name="StoreName" use="required">
628 <xs:simpleType>
629 <xs:restriction base="xs:string">
630 <xs:enumeration value="ca">
631 <xs:annotation>
632 <xs:documentation>
633 Contains the certificates of certificate authorities that the user trusts to issue certificates to others. Certificates in these stores are normally supplied with the operating system or by the user's network administrator.
634 </xs:documentation>
635 </xs:annotation>
636 </xs:enumeration>
637 <xs:enumeration value="my">
638 <xs:annotation>
639 <xs:documentation>
640 Use the "personal" value instead.
641 </xs:documentation>
642 </xs:annotation>
643 </xs:enumeration>
644 <xs:enumeration value="personal">
645 <xs:annotation>
646 <xs:documentation>
647 Contains personal certificates. These certificates will usually have an associated private key. This store is often
648 referred to as the "MY" certificate store.
649 </xs:documentation>
650 </xs:annotation>
651 </xs:enumeration>
652 <xs:enumeration value="request"/>
653 <xs:enumeration value="root">
654 <xs:annotation>
655 <xs:documentation>
656 Contains the certificates of certificate authorities that the user trusts to issue certificates to others. Certificates in these stores are normally supplied with the operating system or by the user's network administrator. Certificates in this store are typically self-signed.
657 </xs:documentation>
658 </xs:annotation>
659 </xs:enumeration>
660 <xs:enumeration value="otherPeople">
661 <xs:annotation>
662 <xs:documentation>
663 Contains the certificates of those that the user normally sends enveloped messages to or receives signed messages from.
664 See <a href="http://msdn.microsoft.com/library/aa388160.aspx" target="_blank">MSDN documentation</a> for more information.
665 </xs:documentation>
666 </xs:annotation>
667 </xs:enumeration>
668 <xs:enumeration value="trustedPeople">
669 <xs:annotation>
670 <xs:documentation>
671 Contains the certificates of those directly trusted people and resources.
672 See <a href="http://msdn.microsoft.com/en-us/library/system.security.cryptography.x509certificates.storename.aspx" target="_blank">MSDN documentation</a> for more information.
673 </xs:documentation>
674 </xs:annotation>
675 </xs:enumeration>
676 <xs:enumeration value="trustedPublisher">
677 <xs:annotation>
678 <xs:documentation>
679 Contains the certificates of those publishers who are trusted.
680 See <a href="http://msdn.microsoft.com/en-us/library/system.security.cryptography.x509certificates.storename.aspx" target="_blank">MSDN documentation</a> for more information.
681 </xs:documentation>
682 </xs:annotation>
683 </xs:enumeration>
684 </xs:restriction>
685 </xs:simpleType>
686 </xs:attribute>
687 <xs:attribute name="StoreLocation" use="required">
688 <xs:simpleType>
689 <xs:restriction base="xs:string">
690 <xs:enumeration value="currentUser"/>
691 <xs:enumeration value="localMachine"/>
692 </xs:restriction>
693 </xs:simpleType>
694 </xs:attribute>
695 <!-- The Overwrite attribute is not implemented at this time.
696 <xs:attribute name="Overwrite" type="wxs:YesNoTypeUnion" />
697 -->
698 <xs:attribute name="Request" type="wxs:YesNoTypeUnion">
699 <xs:annotation>
700 <xs:documentation>
701 This attribute controls whether the CertificatePath attribute is a path to a certificate file (Request=&apos;no&apos;) or the
702 certificate authority to request the certificate from (Request=&apos;yes&apos;).
703 </xs:documentation>
704 </xs:annotation>
705 </xs:attribute>
706 <xs:attribute name="BinaryRef" type="xs:string">
707 <xs:annotation>
708 <xs:documentation>
709 Reference to a Binary element that will store the certificate as a stream inside the package. This attribute cannot be specified with
710 the CertificatePath attribute.
711 </xs:documentation>
712 <xs:appinfo>
713 <xse:seeAlso ref="Binary"/>
714 </xs:appinfo>
715 </xs:annotation>
716 </xs:attribute>
717 <xs:attribute name="CertificatePath" type="xs:string">
718 <xs:annotation>
719 <xs:documentation>
720 If the Request attribute is "no" then this attribute is the path to the certificate file outside of the package.
721 If the Request attribute is "yes" then this atribute is the certificate authority to request the certificate from.
722 This attribute may be set via a formatted Property (e.g. [MyProperty]).
723 </xs:documentation>
724 </xs:annotation>
725 </xs:attribute>
726 <xs:attribute name="PFXPassword" type="xs:string">
727 <xs:annotation>
728 <xs:documentation>
729 If the Binary stream or path to the file outside of the package is a password protected PFX file, the password for that
730 PFX must be specified here. This attribute may be set via a formatted Property (e.g. [MyProperty]).
731 </xs:documentation>
732 </xs:annotation>
733 </xs:attribute>
734 <xs:attribute name="Vital" type="wxs:YesNoTypeUnion">
735 <xs:annotation>
736 <xs:documentation>
737 Indicates whether to fail the install if the certificate fails to install. The default is "yes".
738 </xs:documentation>
739 </xs:annotation>
740 </xs:attribute>
741 <xs:anyAttribute namespace="##other" processContents="lax">
742 <xs:annotation>
743 <xs:documentation>
744 Extensibility point in the WiX XML Schema. Schema extensions can register additional
745 attributes at this point in the schema.
746 </xs:documentation>
747 </xs:annotation>
748 </xs:anyAttribute>
749 </xs:complexType>
750 </xs:element>
751
752 <xs:element name="CertificateRef">
753 <xs:annotation>
754 <xs:documentation>
755 Associates a certificate with the parent WebSite. The Certificate element should be
756 in the same Component as the parent WebSite.
757 </xs:documentation>
758 <xs:appinfo>
759 <xse:seeAlso ref="Certificate"/>
760 </xs:appinfo>
761 </xs:annotation>
762 <xs:complexType>
763 <xs:choice minOccurs="0" maxOccurs="unbounded">
764 <xs:any namespace="##other" processContents="lax">
765 <xs:annotation>
766 <xs:documentation>
767 Extensibility point in the WiX XML Schema. Schema extensions can register additional
768 elements at this point in the schema.
769 </xs:documentation>
770 </xs:annotation>
771 </xs:any>
772 </xs:choice>
773 <xs:attribute name="Id" type="xs:string" use="required">
774 <xs:annotation>
775 <xs:documentation>
776 The identifier of the referenced Certificate.
777 </xs:documentation>
778 </xs:annotation>
779 </xs:attribute>
780 <xs:anyAttribute namespace="##other" processContents="lax">
781 <xs:annotation>
782 <xs:documentation>
783 Extensibility point in the WiX XML Schema. Schema extensions can register additional
784 attributes at this point in the schema.
785 </xs:documentation>
786 </xs:annotation>
787 </xs:anyAttribute>
788 </xs:complexType>
789 </xs:element>
790
791 <xs:element name="WebProperty">
792 <xs:annotation>
793 <xs:appinfo>
794 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
795 <xse:remarks>
796 Here is an explanation of the acceptable values for each property and their meaning:
797 <html:ul>
798 <html:li>
799 For the Ids IIs5IsolationMode and LogInUTF8, no value should be specified since
800 the presence of this property indicates that the setting should be set.
801 </html:li>
802 <html:li>
803 For the MaxGlobalBandwidth Id, the value should be specified in kilobytes. The
804 value should be a base 10 number.
805 </html:li>
806 <html:li>
807 ETagChangeNumber sets the machine-specific portion of ETag as a number. This value,
808 when synchronized across servers in a web farm, allows the web farm to return an
809 identical ETag for a given resource regardless of the server that handled the
810 request. The value should be a base 10 number.
811 </html:li>
812 </html:ul>
813 </xse:remarks>
814 </xs:appinfo>
815 <xs:documentation>IIS Properties</xs:documentation>
816 </xs:annotation>
817 <xs:complexType>
818 <xs:choice minOccurs="0" maxOccurs="unbounded">
819 <xs:any namespace="##other" processContents="lax">
820 <xs:annotation>
821 <xs:documentation>
822 Extensibility point in the WiX XML Schema. Schema extensions can register additional
823 elements at this point in the schema.
824 </xs:documentation>
825 </xs:annotation>
826 </xs:any>
827 </xs:choice>
828 <xs:attribute name="Id" use="required">
829 <xs:simpleType>
830 <xs:restriction base="xs:string">
831 <xs:enumeration value="ETagChangeNumber"/>
832 <xs:enumeration value="IIs5IsolationMode"/>
833 <xs:enumeration value="MaxGlobalBandwidth"/>
834 <xs:enumeration value="LogInUTF8"/>
835 </xs:restriction>
836 </xs:simpleType>
837 </xs:attribute>
838 <xs:attribute name="Value" type="xs:string">
839 <xs:annotation>
840 <xs:documentation>
841 The value to be used for the WebProperty specified in the Id attribute. See
842 the remarks section for information on acceptable values for each Id.
843 </xs:documentation>
844 </xs:annotation>
845 </xs:attribute>
846 <xs:anyAttribute namespace="##other" processContents="lax">
847 <xs:annotation>
848 <xs:documentation>
849 Extensibility point in the WiX XML Schema. Schema extensions can register additional
850 attributes at this point in the schema.
851 </xs:documentation>
852 </xs:annotation>
853 </xs:anyAttribute>
854 </xs:complexType>
855 </xs:element>
856
857 <xs:element name="WebApplication">
858 <xs:annotation>
859 <xs:appinfo>
860 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
861 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Module" />
862 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Package" />
863 </xs:appinfo>
864 <xs:documentation>Defines properties for a web application. These properties can be used for more than one application defined in a web site or vroot, by defining this element in a common location and referring to it by setting the WebApplication attribute of the WebSite and WebVirtualDir elements.</xs:documentation>
865 </xs:annotation>
866 <xs:complexType>
867 <xs:choice minOccurs="0" maxOccurs="unbounded">
868 <xs:element ref="WebApplicationExtension" />
869 <xs:any namespace="##other" processContents="lax">
870 <xs:annotation>
871 <xs:documentation>
872 Extensibility point in the WiX XML Schema. Schema extensions can register additional
873 elements at this point in the schema.
874 </xs:documentation>
875 </xs:annotation>
876 </xs:any>
877 </xs:choice>
878 <xs:attribute name="Id" type="xs:string">
879 <xs:annotation>
880 <xs:documentation>Identifier for the web application. If the Id is not specified, it will be generated.</xs:documentation>
881 </xs:annotation>
882 </xs:attribute>
883 <xs:attribute name="Name" type="xs:string" use="required">
884 <xs:annotation>
885 <xs:documentation>Sets the name of this application.</xs:documentation>
886 </xs:annotation>
887 </xs:attribute>
888 <xs:attribute name="Isolation">
889 <xs:annotation>
890 <xs:documentation>
891 Sets the application isolation level for this application for pre-IIS 6 applications.
892 </xs:documentation>
893 </xs:annotation>
894 <xs:simpleType>
895 <xs:restriction base="xs:NMTOKEN">
896 <xs:enumeration value="low">
897 <xs:annotation>
898 <xs:documentation>
899 Means the application executes within the IIS process.
900 </xs:documentation>
901 </xs:annotation>
902 </xs:enumeration>
903 <xs:enumeration value="medium">
904 <xs:annotation>
905 <xs:documentation>
906 Executes pooled in a separate process.
907 </xs:documentation>
908 </xs:annotation>
909 </xs:enumeration>
910 <xs:enumeration value="high">
911 <xs:annotation>
912 <xs:documentation>
913 Means execution alone in a separate process.
914 </xs:documentation>
915 </xs:annotation>
916 </xs:enumeration>
917 </xs:restriction>
918 </xs:simpleType>
919 </xs:attribute>
920 <xs:attribute name="AllowSessions" type="wxs:YesNoDefaultTypeUnion">
921 <xs:annotation>
922 <xs:documentation>Sets the Enable Session State option. When enabled, you can set the session timeout using the SessionTimeout attribute.</xs:documentation>
923 </xs:annotation>
924 </xs:attribute>
925 <xs:attribute name="SessionTimeout" type="wxs:Integer">
926 <xs:annotation>
927 <xs:documentation>Sets the timeout value for sessions in minutes.</xs:documentation>
928 </xs:annotation>
929 </xs:attribute>
930 <xs:attribute name="Buffer" type="wxs:YesNoDefaultTypeUnion">
931 <xs:annotation>
932 <xs:documentation>Sets the option that enables response buffering in the application, which allows ASP script to set response headers anywhere in the script.</xs:documentation>
933 </xs:annotation>
934 </xs:attribute>
935 <xs:attribute name="ParentPaths" type="wxs:YesNoDefaultTypeUnion">
936 <xs:annotation>
937 <xs:documentation>Sets the parent paths option, which allows a client to use relative paths to reach parent directories from this application.</xs:documentation>
938 </xs:annotation>
939 </xs:attribute>
940 <xs:attribute name="DefaultScript">
941 <xs:annotation>
942 <xs:documentation>Sets the default script language for the site.</xs:documentation>
943 </xs:annotation>
944 <xs:simpleType>
945 <xs:restriction base="xs:NMTOKEN">
946 <xs:enumeration value="VBScript"/>
947 <xs:enumeration value="JScript"/>
948 </xs:restriction>
949 </xs:simpleType>
950 </xs:attribute>
951 <xs:attribute name="ScriptTimeout" type="wxs:Integer">
952 <xs:annotation>
953 <xs:documentation>Sets the timeout value in seconds for executing ASP scripts.</xs:documentation>
954 </xs:annotation>
955 </xs:attribute>
956 <xs:attribute name="ServerDebugging" type="wxs:YesNoDefaultTypeUnion">
957 <xs:annotation>
958 <xs:documentation>Enable ASP server-side script debugging.</xs:documentation>
959 </xs:annotation>
960 </xs:attribute>
961 <xs:attribute name="ClientDebugging" type="wxs:YesNoDefaultTypeUnion">
962 <xs:annotation>
963 <xs:documentation>Enable ASP client-side script debugging.</xs:documentation>
964 </xs:annotation>
965 </xs:attribute>
966 <xs:attribute name="WebAppPool" type="xs:string">
967 <xs:annotation>
968 <xs:documentation>References the Id attribute of a WebAppPool element to use as the application pool for this application in IIS 6 applications.</xs:documentation>
969 </xs:annotation>
970 </xs:attribute>
971 <xs:anyAttribute namespace="##other" processContents="lax">
972 <xs:annotation>
973 <xs:documentation>
974 Extensibility point in the WiX XML Schema. Schema extensions can register additional
975 attributes at this point in the schema.
976 </xs:documentation>
977 </xs:annotation>
978 </xs:anyAttribute>
979 </xs:complexType>
980 </xs:element>
981
982 <xs:element name="WebAddress">
983 <xs:annotation>
984 <xs:documentation>WebAddress for WebSite</xs:documentation>
985 </xs:annotation>
986 <xs:complexType>
987 <xs:choice minOccurs="0" maxOccurs="unbounded">
988 <xs:any namespace="##other" processContents="lax">
989 <xs:annotation>
990 <xs:documentation>
991 Extensibility point in the WiX XML Schema. Schema extensions can register additional
992 elements at this point in the schema.
993 </xs:documentation>
994 </xs:annotation>
995 </xs:any>
996 </xs:choice>
997 <xs:attribute name="Id" type="xs:string">
998 <xs:annotation>
999 <xs:documentation>Identifier for the web application. If the Id is not specified, it will be generated.</xs:documentation>
1000 </xs:annotation>
1001 </xs:attribute>
1002 <xs:attribute name="IP" type="xs:string">
1003 <xs:annotation>
1004 <xs:documentation>
1005 The IP address to locate an existing WebSite or create a new WebSite. When the WebAddress is part of a WebSite element
1006 used to locate an existing web site the following rules are used:
1007 <html:ul>
1008 <html:li>When this attribute is not specified only the "All Unassigned" IP address will be located.</html:li>
1009 <html:li>When this attribute is explicitly specified only the specified IP address will be located.</html:li>
1010 <html:li>When this attribute has the value "*" then any IP address including the "All Unassigned" IP address will be located</html:li>
1011 </html:ul>
1012
1013 When the WebAddress is part of a WebSite element used to create a new web site the following rules are used:
1014
1015 <html:ul>
1016 <html:li>When this attribute is not specified or the value is "*" the "All Unassigned" IP address will be used.</html:li>
1017 <html:li>When this attribute is explicitly specified the IP address will use that value.</html:li>
1018 </html:ul>
1019
1020 The IP attribute can contain a formatted string that is processed at install time to insert the values of properties using
1021 [PropertyName] syntax.
1022 </xs:documentation>
1023 </xs:annotation>
1024 </xs:attribute>
1025 <xs:attribute name="Port" type="xs:string" use="required"/>
1026 <xs:attribute name="Header" type="xs:string"/>
1027 <xs:attribute name="Secure" type="wxs:YesNoTypeUnion">
1028 <xs:annotation>
1029 <xs:documentation>Determines if this address represents a secure binding. The default is 'no'.</xs:documentation>
1030 </xs:annotation>
1031 </xs:attribute>
1032 <xs:anyAttribute namespace="##other" processContents="lax">
1033 <xs:annotation>
1034 <xs:documentation>
1035 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1036 attributes at this point in the schema.
1037 </xs:documentation>
1038 </xs:annotation>
1039 </xs:anyAttribute>
1040 </xs:complexType>
1041 </xs:element>
1042
1043 <xs:element name="WebVirtualDir">
1044 <xs:annotation>
1045 <xs:appinfo>
1046 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
1047 </xs:appinfo>
1048 <xs:documentation>Defines an IIS virtual directory. When this element is a child of WebSite element, the virtual directory is defined within that web site. Otherwise this virtual directory must reference a WebSite element via the WebSite attribute</xs:documentation>
1049 </xs:annotation>
1050 <xs:complexType>
1051 <xs:choice minOccurs="0" maxOccurs="unbounded">
1052 <xs:element ref="WebApplication" minOccurs="0" maxOccurs="1" />
1053 <xs:element ref="WebDirProperties" minOccurs="0" maxOccurs="1" />
1054 <xs:element ref="WebError" />
1055 <xs:element ref="WebVirtualDir" />
1056 <xs:element ref="HttpHeader" />
1057 <xs:element ref="MimeMap" />
1058 <xs:any namespace="##other" processContents="lax">
1059 <xs:annotation>
1060 <xs:documentation>
1061 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1062 elements at this point in the schema.
1063 </xs:documentation>
1064 </xs:annotation>
1065 </xs:any>
1066 </xs:choice>
1067 <xs:attribute name="Id" type="xs:string">
1068 <xs:annotation>
1069 <xs:documentation>Identifier for the web application. If the Id is not specified, it will be generated.</xs:documentation>
1070 </xs:annotation>
1071 </xs:attribute>
1072 <xs:attribute name="WebSite" type="xs:string">
1073 <xs:annotation>
1074 <xs:documentation>References the Id attribute for a WebSite in which this virtual directory belongs. Required when this element is not a child of WebSite element.</xs:documentation>
1075 </xs:annotation>
1076 </xs:attribute>
1077 <xs:attribute name="Alias" type="xs:string" use="required">
1078 <xs:annotation>
1079 <xs:documentation>Sets the application name, which is the URL relative path used to access this virtual directory</xs:documentation>
1080 </xs:annotation>
1081 </xs:attribute>
1082 <xs:attribute name="Directory" use="required" type="xs:string">
1083 <xs:annotation>
1084 <xs:documentation>References the Id attribute for a Directory element that points to the content for this virtual directory.</xs:documentation>
1085 </xs:annotation>
1086 </xs:attribute>
1087 <xs:attribute name="DirProperties" type="xs:string">
1088 <xs:annotation>
1089 <xs:documentation>
1090 References the Id attribute for a WebDirProperties element that specifies the security and access properties for this virtual directory.
1091 This attribute may not be specified if a WebDirProperties element is directly nested in this element.
1092 </xs:documentation>
1093 </xs:annotation>
1094 </xs:attribute>
1095 <xs:attribute name="WebApplication" type="xs:string">
1096 <xs:annotation>
1097 <xs:documentation>References the Id attribute for a WebApplication element that specifies web application settings for this virtual directory. If a WebApplication child is not specified, the virtual directory does not host web applications.</xs:documentation>
1098 </xs:annotation>
1099 </xs:attribute>
1100 <xs:anyAttribute namespace="##other" processContents="lax">
1101 <xs:annotation>
1102 <xs:documentation>
1103 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1104 attributes at this point in the schema.
1105 </xs:documentation>
1106 </xs:annotation>
1107 </xs:anyAttribute>
1108 </xs:complexType>
1109 </xs:element>
1110
1111 <xs:element name="WebDir">
1112 <xs:annotation>
1113 <xs:appinfo>
1114 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
1115 </xs:appinfo>
1116 <xs:documentation>Defines a subdirectory within an IIS web site. When this element is a child of WebSite, the web directory is defined within that web site. Otherwise the web directory must reference a WebSite element via the WebSite attribute.</xs:documentation>
1117 </xs:annotation>
1118 <xs:complexType>
1119 <xs:choice minOccurs="0" maxOccurs="unbounded">
1120 <xs:element ref="WebApplication" minOccurs="0" maxOccurs="1" />
1121 <xs:element ref="WebDirProperties" minOccurs="0" maxOccurs="1" />
1122 <xs:any namespace="##other" processContents="lax">
1123 <xs:annotation>
1124 <xs:documentation>
1125 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1126 elements at this point in the schema.
1127 </xs:documentation>
1128 </xs:annotation>
1129 </xs:any>
1130 </xs:choice>
1131 <xs:attribute name="Id" type="xs:string">
1132 <xs:annotation>
1133 <xs:documentation>Identifier for the web application. If the Id is not specified, it will be generated.</xs:documentation>
1134 </xs:annotation>
1135 </xs:attribute>
1136 <xs:attribute name="WebApplication" type="xs:string">
1137 <xs:annotation>
1138 <xs:documentation>References the Id attribute for a WebApplication element in which this directory belongs.</xs:documentation>
1139 </xs:annotation>
1140 </xs:attribute>
1141 <xs:attribute name="WebSite" type="xs:string">
1142 <xs:annotation>
1143 <xs:documentation>References the Id attribute for a WebSite element in which this directory belongs. Required when this element is not a child of a WebSite element.</xs:documentation>
1144 </xs:annotation>
1145 </xs:attribute>
1146 <xs:attribute name="Path" type="xs:string" use="required">
1147 <xs:annotation>
1148 <xs:documentation>Specifies the name of this web directory.</xs:documentation>
1149 </xs:annotation>
1150 </xs:attribute>
1151 <xs:attribute name="DirProperties" type="xs:string">
1152 <xs:annotation>
1153 <xs:documentation>
1154 References the Id attribute for a WebDirProperties element that specifies the security and access properties for this web directory.
1155 This attribute may not be specified if a WebDirProperties element is directly nested in this element.
1156 </xs:documentation>
1157 </xs:annotation>
1158 </xs:attribute>
1159 <xs:anyAttribute namespace="##other" processContents="lax">
1160 <xs:annotation>
1161 <xs:documentation>
1162 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1163 attributes at this point in the schema.
1164 </xs:documentation>
1165 </xs:annotation>
1166 </xs:anyAttribute>
1167 </xs:complexType>
1168 </xs:element>
1169
1170 <xs:element name="WebSite">
1171 <xs:annotation>
1172 <xs:appinfo>
1173 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
1174 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
1175 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Module" />
1176 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Package" />
1177 <xse:remarks>
1178 Nesting WebSite under a Component element will result in a WebSite being installed to the machine as the package is installed.
1179 Nesting WebSite under Package, Fragment, or Module
1180 results in a web site "locator" record being created in
1181 the IIsWebSite table. This means that the web site
1182 itself is neither installed nor uninstalled by the MSI
1183 package. It does make the database available for referencing
1184 from a WebApplication, WebVirtualDir or WebDir record. This allows an MSI to install
1185 WebApplications, WebVirtualDirs or WebDirs to already existing web sites on the machine.
1186 The install will fail if the web site does not exist in these cases.
1187 </xse:remarks>
1188 </xs:appinfo>
1189 <xs:documentation>IIs Web Site</xs:documentation>
1190 </xs:annotation>
1191 <xs:complexType>
1192 <xs:choice minOccurs="0" maxOccurs="unbounded">
1193 <xs:element ref="WebAddress" minOccurs="1" maxOccurs="unbounded"/>
1194 <xs:element ref="WebApplication" minOccurs="0" maxOccurs="1" />
1195 <xs:element ref="WebDirProperties" minOccurs="0" maxOccurs="1" />
1196 <xs:element ref="MimeMap"/>
1197 <xs:element ref="CertificateRef"/>
1198 <xs:element ref="HttpHeader"/>
1199 <xs:element ref="WebDir"/>
1200 <xs:element ref="WebError"/>
1201 <xs:element ref="WebFilter"/>
1202 <xs:element ref="WebVirtualDir"/>
1203 <xs:any namespace="##other" processContents="lax">
1204 <xs:annotation>
1205 <xs:documentation>
1206 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1207 elements at this point in the schema.
1208 </xs:documentation>
1209 </xs:annotation>
1210 </xs:any>
1211 </xs:choice>
1212 <xs:attribute name="Id" type="xs:string">
1213 <xs:annotation>
1214 <xs:documentation>Identifier for the WebSite. Used within the MSI package only. If the Id is not specified, it will be generated.</xs:documentation>
1215 </xs:annotation>
1216 </xs:attribute>
1217 <xs:attribute name="AutoStart" type="wxs:YesNoTypeUnion">
1218 <xs:annotation>
1219 <xs:documentation>Specifies whether to automatically start the web site.</xs:documentation>
1220 </xs:annotation>
1221 </xs:attribute>
1222 <xs:attribute name="ConfigureIfExists" type="wxs:YesNoTypeUnion">
1223 <xs:annotation>
1224 <xs:documentation>Specifies whether to configure the web site if it already exists. Note: This will not affect uninstall behavior. If the web site exists on uninstall, it will be removed.</xs:documentation>
1225 </xs:annotation>
1226 </xs:attribute>
1227 <xs:attribute name="ConnectionTimeout" type="xs:nonNegativeInteger">
1228 <xs:annotation>
1229 <xs:documentation>Sets the timeout value for connections in seconds.</xs:documentation>
1230 </xs:annotation>
1231 </xs:attribute>
1232 <xs:attribute name="Description" use="required" type="xs:string">
1233 <xs:annotation>
1234 <xs:documentation>This is the name of the web site that will show up in the IIS management console.</xs:documentation>
1235 </xs:annotation>
1236 </xs:attribute>
1237 <xs:attribute name="Directory" type="xs:string">
1238 <xs:annotation>
1239 <xs:documentation>Root directory of the web site. Resolved to a directory in the Directory table at install time by the server custom actions.</xs:documentation>
1240 </xs:annotation>
1241 </xs:attribute>
1242 <xs:attribute name="DirProperties" type="xs:string">
1243 <xs:annotation>
1244 <xs:documentation>
1245 References the Id attribute for a WebDirProperties element that specifies the security and access properties for this website root directory.
1246 This attribute may not be specified if a WebDirProperties element is directly nested in this element.
1247 </xs:documentation>
1248 </xs:annotation>
1249 </xs:attribute>
1250 <xs:attribute name="Sequence" type="wxs:Integer">
1251 <xs:annotation>
1252 <xs:documentation>Sequence that the web site is to be created in.</xs:documentation>
1253 </xs:annotation>
1254 </xs:attribute>
1255 <xs:attribute name="SiteId" type="xs:string">
1256 <xs:annotation>
1257 <xs:documentation>
1258 Optional attribute to directly specify the site id of the WebSite. Use this to ensure all web
1259 sites in a web garden get the same site id. If a number is provided, the site id must be unique
1260 on all target machines. If "*" is used, the Description attribute will be hashed to create a unique
1261 value for the site id. This value must be a positive number or a "*" or a formatted value that resolves
1262 to "-1" (for the same behavior as "*") or a positive number or blank. If this attribute is absent then
1263 the web site will be located using the WebAddress element associated with the web site.
1264 </xs:documentation>
1265 </xs:annotation>
1266 </xs:attribute>
1267 <xs:attribute name="StartOnInstall" type="wxs:YesNoTypeUnion">
1268 <xs:annotation>
1269 <xs:documentation>Specifies whether to start the web site on install.</xs:documentation>
1270 </xs:annotation>
1271 </xs:attribute>
1272 <xs:attribute name="WebApplication" type="xs:string">
1273 <xs:annotation>
1274 <xs:documentation>Reference to a WebApplication that is to be installed as part of this web site.</xs:documentation>
1275 </xs:annotation>
1276 </xs:attribute>
1277 <xs:attribute name="WebLog" type="xs:string">
1278 <xs:annotation>
1279 <xs:documentation>Reference to WebLog definition.</xs:documentation>
1280 </xs:annotation>
1281 </xs:attribute>
1282 <xs:anyAttribute namespace="##other" processContents="lax">
1283 <xs:annotation>
1284 <xs:documentation>
1285 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1286 attributes at this point in the schema.
1287 </xs:documentation>
1288 </xs:annotation>
1289 </xs:anyAttribute>
1290 </xs:complexType>
1291 </xs:element>
1292
1293 <xs:element name="WebLog">
1294 <xs:annotation>
1295 <xs:appinfo>
1296 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
1297 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Module" />
1298 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Package" />
1299 </xs:appinfo>
1300 <xs:documentation>WebLog definition.</xs:documentation>
1301 </xs:annotation>
1302 <xs:complexType>
1303 <xs:choice minOccurs="0" maxOccurs="unbounded">
1304 <xs:any namespace="##other" processContents="lax">
1305 <xs:annotation>
1306 <xs:documentation>
1307 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1308 elements at this point in the schema.
1309 </xs:documentation>
1310 </xs:annotation>
1311 </xs:any>
1312 </xs:choice>
1313 <xs:attribute name="Id" type="xs:string" use="required">
1314 <xs:annotation>
1315 <xs:documentation>Identifier for the WebLog.</xs:documentation>
1316 </xs:annotation>
1317 </xs:attribute>
1318 <xs:attribute name="Type" use="required">
1319 <xs:simpleType>
1320 <xs:restriction base="xs:NMTOKEN">
1321 <xs:enumeration value="IIS">
1322 <xs:annotation>
1323 <xs:documentation>
1324 Microsoft IIS Log File Format
1325 </xs:documentation>
1326 </xs:annotation>
1327 </xs:enumeration>
1328 <xs:enumeration value="NCSA">
1329 <xs:annotation>
1330 <xs:documentation>
1331 NCSA Common Log File Format
1332 </xs:documentation>
1333 </xs:annotation>
1334 </xs:enumeration>
1335 <xs:enumeration value="none">
1336 <xs:annotation>
1337 <xs:documentation>
1338 Disables logging.
1339 </xs:documentation>
1340 </xs:annotation>
1341 </xs:enumeration>
1342 <xs:enumeration value="ODBC">
1343 <xs:annotation>
1344 <xs:documentation>
1345 ODBC Logging
1346 </xs:documentation>
1347 </xs:annotation>
1348 </xs:enumeration>
1349 <xs:enumeration value="W3C">
1350 <xs:annotation>
1351 <xs:documentation>
1352 W3C Extended Log File Format
1353 </xs:documentation>
1354 </xs:annotation>
1355 </xs:enumeration>
1356 </xs:restriction>
1357 </xs:simpleType>
1358 </xs:attribute>
1359 <xs:anyAttribute namespace="##other" processContents="lax">
1360 <xs:annotation>
1361 <xs:documentation>
1362 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1363 attributes at this point in the schema.
1364 </xs:documentation>
1365 </xs:annotation>
1366 </xs:anyAttribute>
1367 </xs:complexType>
1368 </xs:element>
1369
1370 <xs:element name="WebServiceExtension">
1371 <xs:annotation>
1372 <xs:appinfo>
1373 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
1374 </xs:appinfo>
1375 <xs:documentation>The WebServiceExtension property is used by the Web server to determine whether a Web service extension is permitted to run.</xs:documentation>
1376 </xs:annotation>
1377 <xs:complexType>
1378 <xs:choice minOccurs="0" maxOccurs="unbounded">
1379 <xs:any namespace="##other" processContents="lax">
1380 <xs:annotation>
1381 <xs:documentation>
1382 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1383 elements at this point in the schema.
1384 </xs:documentation>
1385 </xs:annotation>
1386 </xs:any>
1387 </xs:choice>
1388 <xs:attribute name="Id" type="xs:string">
1389 <xs:annotation>
1390 <xs:documentation>Identifier for the web service extension. Used within the MSI package only. If the Id is not specified, it will be generated.</xs:documentation>
1391 </xs:annotation>
1392 </xs:attribute>
1393 <xs:attribute name="File" type="xs:string" use="required">
1394 <xs:annotation>
1395 <xs:documentation>Usually a Property that resolves to short file name path</xs:documentation>
1396 </xs:annotation>
1397 </xs:attribute>
1398 <xs:attribute name="Description" type="xs:string">
1399 <xs:annotation>
1400 <xs:documentation>Description of the extension.</xs:documentation>
1401 </xs:annotation>
1402 </xs:attribute>
1403 <xs:attribute name="Group" type="xs:string">
1404 <xs:annotation>
1405 <xs:documentation>String used to identify groups of extensions.</xs:documentation>
1406 </xs:annotation>
1407 </xs:attribute>
1408 <xs:attribute name="Allow" use="required" type="wxs:YesNoTypeUnion">
1409 <xs:annotation>
1410 <xs:documentation>Indicates if the extension is allowed or denied.</xs:documentation>
1411 </xs:annotation>
1412 </xs:attribute>
1413 <xs:attribute name="UIDeletable" type="wxs:YesNoTypeUnion">
1414 <xs:annotation>
1415 <xs:documentation>Indicates if the UI is allowed to delete the extension from the list of not. Default: Not deletable.</xs:documentation>
1416 </xs:annotation>
1417 </xs:attribute>
1418 <xs:anyAttribute namespace="##other" processContents="lax">
1419 <xs:annotation>
1420 <xs:documentation>
1421 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1422 attributes at this point in the schema.
1423 </xs:documentation>
1424 </xs:annotation>
1425 </xs:anyAttribute>
1426 </xs:complexType>
1427 </xs:element>
1428
1429 <xs:simpleType name="PercentType">
1430 <xs:annotation>
1431 <xs:documentation>Values of this type are any integers between 0 and 100, inclusive.</xs:documentation>
1432 </xs:annotation>
1433 <xs:restriction base="xs:nonNegativeInteger">
1434 <xs:maxInclusive value="100"/>
1435 </xs:restriction>
1436 </xs:simpleType>
1437
1438</xs:schema>
diff --git a/src/xsd/msmq.xsd b/src/xsd/msmq.xsd
new file mode 100644
index 00000000..223b4e48
--- /dev/null
+++ b/src/xsd/msmq.xsd
@@ -0,0 +1,153 @@
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 xmlns:wxs="http://wixtoolset.org/schemas/v4/wxs"
9 targetNamespace="http://wixtoolset.org/schemas/v4/wxs/msmq"
10 xmlns="http://wixtoolset.org/schemas/v4/wxs/msmq">
11 <xs:annotation>
12 <xs:documentation>
13 The source code schema for the WiX Toolset MSMQ Extension.
14 </xs:documentation>
15 </xs:annotation>
16
17 <xs:import namespace="http://wixtoolset.org/schemas/v4/wxs" />
18
19 <xs:element name="MessageQueue">
20 <xs:annotation>
21 <xs:documentation>Installs an MSMQ message queue.</xs:documentation>
22 <xs:appinfo>
23 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
24 </xs:appinfo>
25 </xs:annotation>
26 <xs:complexType>
27 <xs:choice minOccurs="0" maxOccurs="unbounded">
28 <xs:element ref="MessageQueuePermission" />
29 <xs:any namespace="##other" processContents="lax">
30 <xs:annotation>
31 <xs:documentation>
32 Extensibility point in the WiX XML Schema. Schema extensions can register additional
33 elements at this point in the schema.
34 </xs:documentation>
35 </xs:annotation>
36 </xs:any>
37 </xs:choice>
38 <xs:attribute name="Id" type="xs:string">
39 <xs:annotation>
40 <xs:documentation>Identifier for the message queue. If the Id is not specified, one will be generated.</xs:documentation>
41 </xs:annotation>
42 </xs:attribute>
43 <xs:attribute name="Authenticate" type="wxs:YesNoTypeUnion">
44 <xs:annotation>
45 <xs:documentation>The default value is "no".</xs:documentation>
46 </xs:annotation>
47 </xs:attribute>
48 <xs:attribute name="BasePriority" type="wxs:Integer">
49 <xs:annotation>
50 <xs:documentation>The base priority of the queue.</xs:documentation>
51 </xs:annotation>
52 </xs:attribute>
53 <xs:attribute name="Journal" type="wxs:YesNoTypeUnion">
54 <xs:annotation>
55 <xs:documentation>The default value is "no".</xs:documentation>
56 </xs:annotation>
57 </xs:attribute>
58 <xs:attribute name="JournalQuota" type="wxs:Integer" />
59 <xs:attribute name="Label" use="required" type="xs:string" />
60 <xs:attribute name="MulticastAddress" type="xs:string" />
61 <xs:attribute name="PathName" use="required" type="xs:string" />
62 <xs:attribute name="PrivLevel">
63 <xs:simpleType>
64 <xs:restriction base="xs:NMTOKEN">
65 <xs:enumeration value="none" />
66 <xs:enumeration value="optional" />
67 <xs:enumeration value="body" />
68 </xs:restriction>
69 </xs:simpleType>
70 </xs:attribute>
71 <xs:attribute name="Quota" type="wxs:Integer" />
72 <xs:attribute name="Transactional" type="wxs:YesNoTypeUnion">
73 <xs:annotation>
74 <xs:documentation>The default value is "no".</xs:documentation>
75 </xs:annotation>
76 </xs:attribute>
77 <xs:attribute name="ServiceTypeGuid" type="xs:string" />
78 <xs:anyAttribute namespace="##other" processContents="lax">
79 <xs:annotation>
80 <xs:documentation>
81 Extensibility point in the WiX XML Schema. Schema extensions can register additional
82 attributes at this point in the schema.
83 </xs:documentation>
84 </xs:annotation>
85 </xs:anyAttribute>
86 </xs:complexType>
87 </xs:element>
88
89 <xs:element name="MessageQueuePermission">
90 <xs:annotation><xs:documentation>
91 </xs:documentation>
92 <xs:appinfo>
93 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
94 </xs:appinfo>
95 </xs:annotation>
96 <xs:complexType>
97 <xs:choice minOccurs="0" maxOccurs="unbounded">
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="Id" use="required" type="xs:string">
108 <xs:annotation>
109 <xs:documentation>Identifier for the message queue permission. If the Id is not specified, one will be generated.</xs:documentation>
110 </xs:annotation>
111 </xs:attribute>
112 <xs:attribute name="MessageQueue" type="xs:string">
113 <xs:annotation>
114 <xs:documentation>Message queue to set permissions on. Must be specified when under a Component element. Cannot be specified when under a MessageQueue element.</xs:documentation>
115 </xs:annotation>
116 </xs:attribute>
117 <xs:attribute name="User" type="xs:string">
118 <xs:annotation>
119 <xs:documentation></xs:documentation>
120 </xs:annotation>
121 </xs:attribute>
122 <xs:attribute name="Group" type="xs:string">
123 <xs:annotation>
124 <xs:documentation></xs:documentation>
125 </xs:annotation>
126 </xs:attribute>
127 <xs:attribute name="DeleteMessage" type="wxs:YesNoTypeUnion" />
128 <xs:attribute name="PeekMessage" type="wxs:YesNoTypeUnion" />
129 <xs:attribute name="WriteMessage" type="wxs:YesNoTypeUnion" />
130 <xs:attribute name="DeleteJournalMessage" type="wxs:YesNoTypeUnion" />
131 <xs:attribute name="SetQueueProperties" type="wxs:YesNoTypeUnion" />
132 <xs:attribute name="GetQueueProperties" type="wxs:YesNoTypeUnion" />
133 <xs:attribute name="DeleteQueue" type="wxs:YesNoTypeUnion" />
134 <xs:attribute name="GetQueuePermissions" type="wxs:YesNoTypeUnion" />
135 <xs:attribute name="ChangeQueuePermissions" type="wxs:YesNoTypeUnion" />
136 <xs:attribute name="TakeQueueOwnership" type="wxs:YesNoTypeUnion" />
137 <xs:attribute name="ReceiveMessage" type="wxs:YesNoTypeUnion" />
138 <xs:attribute name="ReceiveJournalMessage" type="wxs:YesNoTypeUnion" />
139 <xs:attribute name="QueueGenericRead" type="wxs:YesNoTypeUnion" />
140 <xs:attribute name="QueueGenericWrite" type="wxs:YesNoTypeUnion" />
141 <xs:attribute name="QueueGenericExecute" type="wxs:YesNoTypeUnion" />
142 <xs:attribute name="QueueGenericAll" type="wxs:YesNoTypeUnion" />
143 <xs:anyAttribute namespace="##other" processContents="lax">
144 <xs:annotation>
145 <xs:documentation>
146 Extensibility point in the WiX XML Schema. Schema extensions can register additional
147 attributes at this point in the schema.
148 </xs:documentation>
149 </xs:annotation>
150 </xs:anyAttribute>
151 </xs:complexType>
152 </xs:element>
153</xs:schema>
diff --git a/src/xsd/netfx.xsd b/src/xsd/netfx.xsd
new file mode 100644
index 00000000..079b95c9
--- /dev/null
+++ b/src/xsd/netfx.xsd
@@ -0,0 +1,687 @@
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:wxs="http://wixtoolset.org/schemas/v4/wxs"
8 targetNamespace="http://wixtoolset.org/schemas/v4/wxs/netfx"
9 xmlns="http://wixtoolset.org/schemas/v4/wxs/netfx">
10 <xs:annotation>
11 <xs:documentation>
12 The source code schema for the WiX Toolset .NET Framework Extension.
13 </xs:documentation>
14 </xs:annotation>
15
16 <xs:import namespace="http://wixtoolset.org/schemas/v4/wxs" />
17
18 <xs:element name="NativeImage">
19 <xs:annotation>
20 <xs:documentation>
21 Improves the performance of managed applications by creating native images.
22 Requires the .NET Framework 2.0 or newer to be installed on the target machine since
23 it runs [NGen](https://learn.microsoft.com/en-us/dotnet/framework/tools/ngen-exe-native-image-generator).
24 </xs:documentation>
25 <xs:appinfo>
26 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="File" />
27 <xse:remarks>
28 Native images are files containing compiled processor-specific machine code, which
29 are installed into the native image cache on the local computer. The runtime
30 can use native images from the cache instead using the just-in-time (JIT)
31 compiler to compile the original assembly.
32
33 The native image custom actions are configured to ignore failures so that failing
34 to generate or remove a native image will not cause setup to fail and roll back.
35 </xse:remarks>
36 </xs:appinfo>
37 </xs:annotation>
38 <xs:complexType>
39 <xs:choice minOccurs="0" maxOccurs="unbounded">
40 <xs:any namespace="##other" processContents="lax">
41 <xs:annotation>
42 <xs:documentation>
43 Extensibility point in the WiX XML Schema. Schema extensions can register additional
44 elements at this point in the schema.
45 </xs:documentation>
46 </xs:annotation>
47 </xs:any>
48 </xs:choice>
49 <xs:attribute name="Id" type="xs:string">
50 <xs:annotation>
51 <xs:documentation>Identifier for the native image in the output database. If the Id is not specified, one will be generated.</xs:documentation>
52 </xs:annotation>
53 </xs:attribute>
54 <xs:attribute name="AppBaseDirectory" type="xs:string">
55 <xs:annotation>
56 <xs:documentation>
57 The directory to use for locating dependent assemblies.
58 For DLL assemblies and assemblies installed to the Global Assembly Cache (GAC),
59 this attribute should be set to the directory of the application which loads this
60 assembly. For EXE assemblies, this attribute does not need to be set because NGen
61 will use the directory of the assembly file by default.
62
63 The value can be in the form of a directory identifier, or a formatted string
64 that resolves to either a directory identifier or a full path to a directory.
65 </xs:documentation>
66 </xs:annotation>
67 </xs:attribute>
68 <xs:attribute name="AssemblyApplication" type="xs:string">
69 <xs:annotation>
70 <xs:documentation>
71 The application which will load this assembly.
72 For DLL assemblies which are loaded via reflection, this attribute should
73 be set to indicate the application which will load this assembly.
74 The configuration of the application (usually specified via an exe.config file) will be used
75 to determine how to resolve dependencies for this assembly.
76
77 The value can be in the form of a file identifier, or a formatted string
78 that resolves to either a file identifier or a full path to a file.
79
80 When a shared component is loaded at run time, using the Load method, the
81 application's configuration file determines the dependencies that are loaded
82 for the shared component — for example, the version of a dependency that is loaded.
83 This attribute gives guidance on which dependencies would be loaded at run time in order
84 to figure out which dependency assemblies will also need to have native images generated
85 (assuming the Dependency attribute is not set to "no").
86
87 This attribute cannot be set if the AssemblyApplication attribute is set on the parent
88 File element (please note that these attributes both refer to the same application
89 assembly but do very different things: specifiying File/@AssemblyApplication will force
90 an assembly to install to a private location next to the indicated application, whereas
91 this AssemblyApplication attribute will be used to help resolve dependent assemblies
92 while generating native images for this assembly).
93 </xs:documentation>
94 </xs:annotation>
95 </xs:attribute>
96 <xs:attribute name="Debug" type="wxs:YesNoTypeUnion">
97 <xs:annotation>
98 <xs:documentation>
99 Set to "yes" to generate native images that can be used under a debugger.
100 The default value is "no".
101 </xs:documentation>
102 </xs:annotation>
103 </xs:attribute>
104 <xs:attribute name="Dependencies" type="wxs:YesNoTypeUnion">
105 <xs:annotation>
106 <xs:documentation>
107 Set to "no" to generate the minimum number of native images.
108 The default value is "yes".
109 </xs:documentation>
110 </xs:annotation>
111 </xs:attribute>
112 <xs:attribute name="Platform" type="NativeImagePreprocessorPlatformType">
113 <xs:annotation>
114 <xs:documentation>
115 Sets the platform(s) for which native images will be generated.
116 </xs:documentation>
117 </xs:annotation>
118 </xs:attribute>
119 <xs:attribute name="Priority">
120 <xs:annotation>
121 <xs:documentation>
122 Sets the priority of generating the native images for this assembly.
123 </xs:documentation>
124 </xs:annotation>
125 <xs:simpleType>
126 <xs:restriction base="xs:NMTOKEN">
127 <xs:enumeration value="0">
128 <xs:annotation>
129 <xs:documentation>
130 This is the highest priority, it means that image generation occurs
131 and completes during setup. This option ensures images are generated
132 by the time setup is complete.
133 </xs:documentation>
134 </xs:annotation>
135 </xs:enumeration>
136 <xs:enumeration value="1">
137 <xs:annotation>
138 <xs:documentation>
139 This will queue image generation to the NGen service to occur immediately.
140 This option will slow down setup performance.
141 </xs:documentation>
142 </xs:annotation>
143 </xs:enumeration>
144 <xs:enumeration value="2">
145 <xs:annotation>
146 <xs:documentation>
147 This will queue image generation to the NGen service to occur after all priority 1
148 assemblies have completed.
149 This option will slow down setup performance.
150 </xs:documentation>
151 </xs:annotation>
152 </xs:enumeration>
153 <xs:enumeration value="3">
154 <xs:annotation>
155 <xs:documentation>
156 This is the lowest priority, it will queue image generation to occur when the
157 machine is idle.
158 This option should not slow down setup performance.
159 This is the default value.
160 </xs:documentation>
161 </xs:annotation>
162 </xs:enumeration>
163 </xs:restriction>
164 </xs:simpleType>
165 </xs:attribute>
166 <xs:attribute name="Profile" type="wxs:YesNoTypeUnion">
167 <xs:annotation>
168 <xs:documentation>
169 Set to "yes" to generate native images that can be used under a profiler.
170 The default value is "no".
171 </xs:documentation>
172 </xs:annotation>
173 </xs:attribute>
174 <xs:anyAttribute namespace="##other" processContents="lax">
175 <xs:annotation>
176 <xs:documentation>
177 Extensibility point in the WiX XML Schema. Schema extensions can register additional
178 attributes at this point in the schema.
179 </xs:documentation>
180 </xs:annotation>
181 </xs:anyAttribute>
182 </xs:complexType>
183 </xs:element>
184
185 <xs:element name="DotNetCoreSearch">
186 <xs:annotation>
187 <xs:documentation>
188 Searches for an installation of .NET Core.
189 The variable gets set to the latest version of the given Runtime, Platform, and Major Version.
190 </xs:documentation>
191 <xs:appinfo>
192 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Bundle" />
193 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
194 </xs:appinfo>
195 </xs:annotation>
196 <xs:complexType>
197 <xs:choice minOccurs="0" maxOccurs="unbounded">
198 <xs:any namespace="##other" processContents="lax">
199 <xs:annotation>
200 <xs:documentation>
201 Extensibility point in the WiX XML Schema. Schema extensions can register additional
202 elements at this point in the schema.
203 </xs:documentation>
204 </xs:annotation>
205 </xs:any>
206 </xs:choice>
207 <xs:attribute name="Id" type="xs:string">
208 <xs:annotation>
209 <xs:documentation>Identifier for the search. If the Id is not specified, one will be generated.</xs:documentation>
210 </xs:annotation>
211 </xs:attribute>
212 <xs:attribute name="Variable" type="xs:string" use="required">
213 <xs:annotation>
214 <xs:documentation>Name of the variable in which to place the result of the search.</xs:documentation>
215 </xs:annotation>
216 </xs:attribute>
217 <xs:attribute name="Condition" type="xs:string">
218 <xs:annotation>
219 <xs:documentation>Condition for evaluating the search. If this evaluates to false, the search is not executed at all.</xs:documentation>
220 </xs:annotation>
221 </xs:attribute>
222 <xs:attribute name="After" type="xs:string">
223 <xs:annotation>
224 <xs:documentation>Id of the search that this one should come after.</xs:documentation>
225 </xs:annotation>
226 </xs:attribute>
227 <xs:attribute name="RuntimeType">
228 <xs:annotation>
229 <xs:documentation>The type of .NET Core runtime to search for.</xs:documentation>
230 </xs:annotation>
231 <xs:simpleType>
232 <xs:restriction base="xs:NMTOKEN">
233 <xs:enumeration value="aspnet">
234 <xs:annotation>
235 <xs:documentation>
236 Attempt to check for an ASP.NET Core type runtime.
237 The ASP.NET Core Runtime enables you to run web/server applications.
238 </xs:documentation>
239 </xs:annotation>
240 </xs:enumeration>
241 <xs:enumeration value="core">
242 <xs:annotation>
243 <xs:documentation>
244 Attempt to check for a .NET type runtime.
245 The .NET Core Runtime contains just the components needed to run a console app.
246 </xs:documentation>
247 </xs:annotation>
248 </xs:enumeration>
249 <xs:enumeration value="desktop">
250 <xs:annotation>
251 <xs:documentation>
252 Attempt to check for a .NET Desktop type runtime.
253 The .NET Desktop Runtime enables you to run Windows desktop applications.
254 </xs:documentation>
255 </xs:annotation>
256 </xs:enumeration>
257 </xs:restriction>
258 </xs:simpleType>
259 </xs:attribute>
260 <xs:attribute name="Platform" type="NetfxPreprocessorPlatformType">
261 <xs:annotation>
262 <xs:documentation>The platform to search for.</xs:documentation>
263 </xs:annotation>
264 </xs:attribute>
265 <xs:attribute name="MajorVersion" type="wxs:Integer">
266 <xs:annotation>
267 <xs:documentation>Major version of .NET. For example, "6".</xs:documentation>
268 </xs:annotation>
269 </xs:attribute>
270 <xs:anyAttribute namespace="##other" processContents="lax">
271 <xs:annotation>
272 <xs:documentation>
273 Extensibility point in the WiX XML Schema. Schema extensions can register additional
274 attributes at this point in the schema.
275 </xs:documentation>
276 </xs:annotation>
277 </xs:anyAttribute>
278 </xs:complexType>
279 </xs:element>
280
281 <xs:element name="DotNetCoreSearchRef">
282 <xs:annotation>
283 <xs:documentation>References a DotNetCoreSearch.</xs:documentation>
284 <xs:appinfo>
285 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Bundle" />
286 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
287 </xs:appinfo>
288 </xs:annotation>
289 <xs:complexType>
290 <xs:choice minOccurs="0" maxOccurs="unbounded">
291 <xs:any namespace="##other" processContents="lax">
292 <xs:annotation>
293 <xs:documentation>
294 Extensibility point in the WiX XML Schema. Schema extensions can register additional
295 elements at this point in the schema.
296 </xs:documentation>
297 </xs:annotation>
298 </xs:any>
299 </xs:choice>
300 <xs:attribute name="Id" type="xs:string" use="required" />
301 <xs:anyAttribute namespace="##other" processContents="lax">
302 <xs:annotation>
303 <xs:documentation>
304 Extensibility point in the WiX XML Schema. Schema extensions can register additional
305 attributes at this point in the schema.
306 </xs:documentation>
307 </xs:annotation>
308 </xs:anyAttribute>
309 </xs:complexType>
310 </xs:element>
311
312 <xs:element name="DotNetCoreSdkSearch">
313 <xs:annotation>
314 <xs:documentation>
315 Searches for an installation of .NET Core SDK.
316 The variable gets set to the latest version of the given Platform and Major Version.
317 </xs:documentation>
318 <xs:appinfo>
319 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Bundle" />
320 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
321 </xs:appinfo>
322 </xs:annotation>
323 <xs:complexType>
324 <xs:choice minOccurs="0" maxOccurs="unbounded">
325 <xs:any namespace="##other" processContents="lax">
326 <xs:annotation>
327 <xs:documentation>
328 Extensibility point in the WiX XML Schema. Schema extensions can register additional
329 elements at this point in the schema.
330 </xs:documentation>
331 </xs:annotation>
332 </xs:any>
333 </xs:choice>
334 <xs:attribute name="Id" type="xs:string">
335 <xs:annotation>
336 <xs:documentation>Identifier for the search. If the Id is not specified, one will be generated.</xs:documentation>
337 </xs:annotation>
338 </xs:attribute>
339 <xs:attribute name="Variable" type="xs:string" use="required">
340 <xs:annotation>
341 <xs:documentation>Name of the variable in which to place the result of the search.</xs:documentation>
342 </xs:annotation>
343 </xs:attribute>
344 <xs:attribute name="Condition" type="xs:string">
345 <xs:annotation>
346 <xs:documentation>Condition for evaluating the search. If this evaluates to false, the search is not executed at all.</xs:documentation>
347 </xs:annotation>
348 </xs:attribute>
349 <xs:attribute name="After" type="xs:string">
350 <xs:annotation>
351 <xs:documentation>Id of the search that this one should come after.</xs:documentation>
352 </xs:annotation>
353 </xs:attribute>
354 <xs:attribute name="Platform" type="NetfxPreprocessorPlatformType">
355 <xs:annotation>
356 <xs:documentation>The platform to search for.</xs:documentation>
357 </xs:annotation>
358 </xs:attribute>
359 <xs:attribute name="MajorVersion" type="wxs:Integer">
360 <xs:annotation>
361 <xs:documentation>Major version of .NET SDK. For example, "6".</xs:documentation>
362 </xs:annotation>
363 </xs:attribute>
364 <xs:anyAttribute namespace="##other" processContents="lax">
365 <xs:annotation>
366 <xs:documentation>
367 Extensibility point in the WiX XML Schema. Schema extensions can register additional
368 attributes at this point in the schema.
369 </xs:documentation>
370 </xs:annotation>
371 </xs:anyAttribute>
372 </xs:complexType>
373 </xs:element>
374
375 <xs:element name="DotNetCoreSdkSearchRef">
376 <xs:annotation>
377 <xs:documentation>References a DotNetCoreSdkSearch.</xs:documentation>
378 <xs:appinfo>
379 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Bundle" />
380 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
381 </xs:appinfo>
382 </xs:annotation>
383 <xs:complexType>
384 <xs:choice minOccurs="0" maxOccurs="unbounded">
385 <xs:any namespace="##other" processContents="lax">
386 <xs:annotation>
387 <xs:documentation>
388 Extensibility point in the WiX XML Schema. Schema extensions can register additional
389 elements at this point in the schema.
390 </xs:documentation>
391 </xs:annotation>
392 </xs:any>
393 </xs:choice>
394 <xs:attribute name="Id" type="xs:string" use="required" />
395 <xs:anyAttribute namespace="##other" processContents="lax">
396 <xs:annotation>
397 <xs:documentation>
398 Extensibility point in the WiX XML Schema. Schema extensions can register additional
399 attributes at this point in the schema.
400 </xs:documentation>
401 </xs:annotation>
402 </xs:anyAttribute>
403 </xs:complexType>
404 </xs:element>
405
406 <xs:element name="DotNetCoreSdkFeatureBandSearch">
407 <xs:annotation>
408 <xs:documentation>
409 Searches for an installation of .NET Core SDK of the given platform.
410 The variable gets set to the latest version of the SDK that is in the feature band specified by Version.
411 </xs:documentation>
412 <xs:appinfo>
413 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Bundle" />
414 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
415 </xs:appinfo>
416 </xs:annotation>
417 <xs:complexType>
418 <xs:choice minOccurs="0" maxOccurs="unbounded">
419 <xs:any namespace="##other" processContents="lax">
420 <xs:annotation>
421 <xs:documentation>
422 Extensibility point in the WiX XML Schema. Schema extensions can register additional
423 elements at this point in the schema.
424 </xs:documentation>
425 </xs:annotation>
426 </xs:any>
427 </xs:choice>
428 <xs:attribute name="Id" type="xs:string">
429 <xs:annotation>
430 <xs:documentation>Identifier for the search. If the Id is not specified, one will be generated.</xs:documentation>
431 </xs:annotation>
432 </xs:attribute>
433 <xs:attribute name="Variable" type="xs:string" use="required">
434 <xs:annotation>
435 <xs:documentation>Name of the variable in which to place the result of the search.</xs:documentation>
436 </xs:annotation>
437 </xs:attribute>
438 <xs:attribute name="Condition" type="xs:string">
439 <xs:annotation>
440 <xs:documentation>Condition for evaluating the search. If this evaluates to false, the search is not executed at all.</xs:documentation>
441 </xs:annotation>
442 </xs:attribute>
443 <xs:attribute name="After" type="xs:string">
444 <xs:annotation>
445 <xs:documentation>Id of the search that this one should come after.</xs:documentation>
446 </xs:annotation>
447 </xs:attribute>
448 <xs:attribute name="Platform" type="NetfxPreprocessorPlatformType">
449 <xs:annotation>
450 <xs:documentation>The platform to search for.</xs:documentation>
451 </xs:annotation>
452 </xs:attribute>
453 <xs:attribute name="Version" type="wxs:StrictThreePartVersionType">
454 <xs:annotation>
455 <xs:documentation>
456 A specific .NET Core SDK feature band. For example, "6.0.400".
457 For more information about feature bands, see https://learn.microsoft.com/en-us/dotnet/core/releases-and-support#feature-bands-sdk-only.
458 </xs:documentation>
459 </xs:annotation>
460 </xs:attribute>
461 <xs:anyAttribute namespace="##other" processContents="lax">
462 <xs:annotation>
463 <xs:documentation>
464 Extensibility point in the WiX XML Schema. Schema extensions can register additional
465 attributes at this point in the schema.
466 </xs:documentation>
467 </xs:annotation>
468 </xs:anyAttribute>
469 </xs:complexType>
470 </xs:element>
471
472 <xs:element name="DotNetCoreSdkFeatureBandSearchRef">
473 <xs:annotation>
474 <xs:documentation>References a DotNetCoreSdkFeatureBandSearch.</xs:documentation>
475 <xs:appinfo>
476 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Bundle" />
477 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
478 </xs:appinfo>
479 </xs:annotation>
480 <xs:complexType>
481 <xs:choice minOccurs="0" maxOccurs="unbounded">
482 <xs:any namespace="##other" processContents="lax">
483 <xs:annotation>
484 <xs:documentation>
485 Extensibility point in the WiX XML Schema. Schema extensions can register additional
486 elements at this point in the schema.
487 </xs:documentation>
488 </xs:annotation>
489 </xs:any>
490 </xs:choice>
491 <xs:attribute name="Id" type="xs:string" use="required" />
492 <xs:anyAttribute namespace="##other" processContents="lax">
493 <xs:annotation>
494 <xs:documentation>
495 Extensibility point in the WiX XML Schema. Schema extensions can register additional
496 attributes at this point in the schema.
497 </xs:documentation>
498 </xs:annotation>
499 </xs:anyAttribute>
500 </xs:complexType>
501 </xs:element>
502
503 <xs:element name="DotNetCompatibilityCheck">
504 <xs:annotation>
505 <xs:documentation>
506 Validates whether the specified .NET is installed on the computer.
507 </xs:documentation>
508 <xs:appinfo>
509 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Package" />
510 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Module" />
511 </xs:appinfo>
512 </xs:annotation>
513 <xs:complexType>
514 <xs:choice minOccurs="0" maxOccurs="unbounded">
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">
525 <xs:annotation>
526 <xs:documentation>Identifier for the compatibility check. If the Id is not specified, one will be generated.</xs:documentation>
527 </xs:annotation>
528 </xs:attribute>
529 <xs:attribute name="Property" type="xs:string" use="required">
530 <xs:annotation>
531 <xs:documentation>
532 Name of the property in which to place the result of the compatibility check. The possible values are:
533 - 0 - Successful compatibility check.
534 - 13 - Requested platform is not compatible with OS. _Introduced in WiX v5.0._
535 - 12289 - No runtime is installed.
536 - 12290 - Required runtime is not installed.
537 - 12291 - Failed to get hostfxr exports.
538 - 12292 - Invalid arguments.
539 - 12293 - Failed to construct temp json file path.
540 - 12294 - Failed to create temp json file.
541 </xs:documentation>
542 </xs:annotation>
543 </xs:attribute>
544 <xs:attribute name="RuntimeType">
545 <xs:annotation>
546 <xs:documentation>The .NET runtime to check against.</xs:documentation>
547 </xs:annotation>
548 <xs:simpleType>
549 <xs:restriction base="xs:NMTOKEN">
550 <xs:enumeration value="aspnet" />
551 <xs:enumeration value="core" />
552 <xs:enumeration value="desktop" />
553 </xs:restriction>
554 </xs:simpleType>
555 </xs:attribute>
556 <xs:attribute name="Platform" type="NetfxPreprocessorPlatformType">
557 <xs:annotation>
558 <xs:documentation>The platform to use to validate.</xs:documentation>
559 </xs:annotation>
560 </xs:attribute>
561 <xs:attribute name="Version" type="wxs:StrictThreePartVersionType">
562 <xs:annotation>
563 <xs:documentation>Version of .NET to check against.</xs:documentation>
564 </xs:annotation>
565 </xs:attribute>
566 <xs:attribute name="RollForward">
567 <xs:annotation>
568 <xs:documentation>The roll forward policy to use while validating.</xs:documentation>
569 </xs:annotation>
570 <xs:simpleType>
571 <xs:restriction base="xs:NMTOKEN">
572 <xs:enumeration value="latestMajor" />
573 <xs:enumeration value="major" />
574 <xs:enumeration value="latestMinor" />
575 <xs:enumeration value="minor" />
576 <xs:enumeration value="latestPatch" />
577 <xs:enumeration value="disable" />
578 </xs:restriction>
579 </xs:simpleType>
580 </xs:attribute>
581 <xs:anyAttribute namespace="##other" processContents="lax">
582 <xs:annotation>
583 <xs:documentation>
584 Extensibility point in the WiX XML Schema. Schema extensions can register additional
585 attributes at this point in the schema.
586 </xs:documentation>
587 </xs:annotation>
588 </xs:anyAttribute>
589 </xs:complexType>
590 </xs:element>
591
592 <xs:element name="DotNetCompatibilityCheckRef">
593 <xs:annotation>
594 <xs:documentation>References a DotNetCompatibilityCheck.</xs:documentation>
595 <xs:appinfo>
596 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Package" />
597 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Module" />
598 </xs:appinfo>
599 </xs:annotation>
600 <xs:complexType>
601 <xs:choice minOccurs="0" maxOccurs="unbounded">
602 <xs:any namespace="##other" processContents="lax">
603 <xs:annotation>
604 <xs:documentation>
605 Extensibility point in the WiX XML Schema. Schema extensions can register additional
606 elements at this point in the schema.
607 </xs:documentation>
608 </xs:annotation>
609 </xs:any>
610 </xs:choice>
611 <xs:attribute name="Id" type="xs:string" use="required" />
612 <xs:anyAttribute namespace="##other" processContents="lax">
613 <xs:annotation>
614 <xs:documentation>
615 Extensibility point in the WiX XML Schema. Schema extensions can register additional
616 attributes at this point in the schema.
617 </xs:documentation>
618 </xs:annotation>
619 </xs:anyAttribute>
620 </xs:complexType>
621 </xs:element>
622
623 <xs:simpleType name="NativeImagePlatformType">
624 <xs:restriction base="xs:NMTOKEN">
625 <xs:enumeration value="32bit">
626 <xs:annotation>
627 <xs:documentation>
628 Attempt to generate native images only for the 32-bit version of the .NET Framework
629 on the target machine. If the 32-bit version of the .NET Framework 2.0 or newer is not
630 present on the target machine, native image custom actions will not be scheduled.
631 This is the default value.
632 </xs:documentation>
633 </xs:annotation>
634 </xs:enumeration>
635 <xs:enumeration value="64bit">
636 <xs:annotation>
637 <xs:documentation>
638 Attempt to generate native images only for the 64-bit version of the .NET Framework
639 on the target machine. If a 64-bit version of the .NET Framework 2.0 or newer is not
640 present on the target machine, native image custom actions will not be scheduled.
641 </xs:documentation>
642 </xs:annotation>
643 </xs:enumeration>
644 <xs:enumeration value="all">
645 <xs:annotation>
646 <xs:documentation>
647 Attempt to generate native images for the 32-bit and 64-bit versions of the .NET Framework
648 on the target machine. If a version of the .NET Framework 2.0 or newer is not present on the
649 target machine for a processor architecture, native image custom actions will not be
650 scheduled for that processor architecture.
651 </xs:documentation>
652 </xs:annotation>
653 </xs:enumeration>
654 </xs:restriction>
655 </xs:simpleType>
656
657 <xs:simpleType name="NativeImagePreprocessorPlatformType">
658 <xs:annotation>
659 <xs:documentation>
660 Platform referencing the machine architecture.
661 </xs:documentation>
662 </xs:annotation>
663 <xs:union memberTypes="NativeImagePlatformType wxs:PreprocessorVariables"/>
664 </xs:simpleType>
665
666 <xs:simpleType name="NetfxPlatformType">
667 <xs:annotation>
668 <xs:documentation>
669 Platform referencing the machine architecture.
670 </xs:documentation>
671 </xs:annotation>
672 <xs:restriction base="xs:NMTOKEN">
673 <xs:enumeration value="arm64" />
674 <xs:enumeration value="x64" />
675 <xs:enumeration value="x86" />
676 </xs:restriction>
677 </xs:simpleType>
678
679 <xs:simpleType name="NetfxPreprocessorPlatformType">
680 <xs:annotation>
681 <xs:documentation>
682 Platform referencing the machine architecture.
683 </xs:documentation>
684 </xs:annotation>
685 <xs:union memberTypes="NetfxPlatformType wxs:PreprocessorVariables"/>
686 </xs:simpleType>
687</xs:schema>
diff --git a/src/xsd/ps.xsd b/src/xsd/ps.xsd
new file mode 100644
index 00000000..fce957d8
--- /dev/null
+++ b/src/xsd/ps.xsd
@@ -0,0 +1,227 @@
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 xmlns:wxs="http://wixtoolset.org/schemas/v4/wxs"
9 targetNamespace="http://wixtoolset.org/schemas/v4/wxs/powershell"
10 xmlns="http://wixtoolset.org/schemas/v4/wxs/powershell">
11 <xs:annotation>
12 <xs:documentation>
13 The source code schema for the WiX Toolset PowerShell Extension.
14 </xs:documentation>
15 </xs:annotation>
16
17 <xs:import namespace="http://wixtoolset.org/schemas/v4/wxs" />
18
19 <xs:element name="FormatsFile">
20 <xs:annotation>
21 <xs:documentation>
22 Identifies the parent File as a formats XML file for the referenced PowerShell snap-in.
23 </xs:documentation>
24 <xs:appinfo>
25 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="File" />
26 <xse:remarks>
27 A formats XML file that defines output formats for objects on the pipeline.
28 </xse:remarks>
29 </xs:appinfo>
30 </xs:annotation>
31 <xs:complexType>
32 <xs:choice minOccurs="0" maxOccurs="unbounded">
33 <xs:any namespace="##other" processContents="lax">
34 <xs:annotation>
35 <xs:documentation>
36 Extensibility point in the WiX XML Schema. Schema extensions can register additional
37 elements at this point in the schema.
38 </xs:documentation>
39 </xs:annotation>
40 </xs:any>
41 </xs:choice>
42 <xs:attribute name="FileId" type="xs:string">
43 <xs:annotation>
44 <xs:documentation>
45 Reference to the formats File ID. This is required when nested under the SnapIn element.
46 </xs:documentation>
47 </xs:annotation>
48 </xs:attribute>
49 <xs:attribute name="SnapIn" type="xs:string">
50 <xs:annotation>
51 <xs:documentation>
52 Reference to the PowerShell snap-in ID for which this formats file is associated. This is required when nested under the File element.
53 </xs:documentation>
54 </xs:annotation>
55 </xs:attribute>
56 <xs:anyAttribute namespace="##other" processContents="lax">
57 <xs:annotation>
58 <xs:documentation>
59 Extensibility point in the WiX XML Schema. Schema extensions can register additional
60 attributes at this point in the schema.
61 </xs:documentation>
62 </xs:annotation>
63 </xs:anyAttribute>
64 </xs:complexType>
65 </xs:element>
66
67 <xs:element name="TypesFile">
68 <xs:annotation>
69 <xs:documentation>
70 Identifies the parent File as a types XML file for the referenced PowerShell snap-in.
71 </xs:documentation>
72 <xs:appinfo>
73 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="File" />
74 <xse:remarks>
75 A types XML file used by the extensible type system.
76 </xse:remarks>
77 </xs:appinfo>
78 </xs:annotation>
79 <xs:complexType>
80 <xs:choice minOccurs="0" maxOccurs="unbounded">
81 <xs:any namespace="##other" processContents="lax">
82 <xs:annotation>
83 <xs:documentation>
84 Extensibility point in the WiX XML Schema. Schema extensions can register additional
85 elements at this point in the schema.
86 </xs:documentation>
87 </xs:annotation>
88 </xs:any>
89 </xs:choice>
90 <xs:attribute name="FileId" type="xs:string">
91 <xs:annotation>
92 <xs:documentation>
93 Reference to the types File ID. This is required when nested under the SnapIn element.
94 </xs:documentation>
95 </xs:annotation>
96 </xs:attribute>
97 <xs:attribute name="SnapIn" type="xs:string">
98 <xs:annotation>
99 <xs:documentation>
100 Reference to the PowerShell snap-in ID for which this types file is associated. This is required when nested under the File element.
101 </xs:documentation>
102 </xs:annotation>
103 </xs:attribute>
104 <xs:anyAttribute namespace="##other" processContents="lax">
105 <xs:annotation>
106 <xs:documentation>
107 Extensibility point in the WiX XML Schema. Schema extensions can register additional
108 attributes at this point in the schema.
109 </xs:documentation>
110 </xs:annotation>
111 </xs:anyAttribute>
112 </xs:complexType>
113 </xs:element>
114
115 <xs:element name="SnapIn">
116 <xs:annotation>
117 <xs:documentation>
118 Identifies the parent File as a PowerShell snap-in to be registered on the system.
119 </xs:documentation>
120 <xs:appinfo>
121 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="File" />
122 <xse:remarks>
123 [PowerShell](http://www.microsoft.com/powershell) snap-ins allow developers to
124 extend the functionality of of the PowerShell engine. Add this element to identify
125 the parent File as a PowerShell snap-in that will get registered on the system.
126 </xse:remarks>
127 </xs:appinfo>
128 </xs:annotation>
129 <xs:complexType>
130 <xs:choice minOccurs="0" maxOccurs="unbounded">
131 <xs:element ref="FormatsFile" />
132 <xs:element ref="TypesFile" />
133 <xs:any namespace="##other" processContents="lax">
134 <xs:annotation>
135 <xs:documentation>
136 Extensibility point in the WiX XML Schema. Schema extensions can register additional
137 elements at this point in the schema.
138 </xs:documentation>
139 </xs:annotation>
140 </xs:any>
141 </xs:choice>
142 <xs:attribute name="Id" type="xs:string" use="required">
143 <xs:annotation>
144 <xs:documentation>
145 The identifier for this PowerShell snap-in.
146 </xs:documentation>
147 </xs:annotation>
148 </xs:attribute>
149 <xs:attribute name="CustomSnapInType" type="xs:string">
150 <xs:annotation>
151 <xs:documentation>
152 The full type name of a class that is used to register a list of cmdlets and providers.
153 </xs:documentation>
154 </xs:annotation>
155 </xs:attribute>
156 <xs:attribute name="Description" type="xs:string">
157 <xs:annotation>
158 <xs:documentation>
159 A brief description of the snap-in.
160 </xs:documentation>
161 </xs:annotation>
162 </xs:attribute>
163 <xs:attribute name="DescriptionIndirect" type="EmbeddedResource">
164 <xs:annotation>
165 <xs:documentation>
166 An embedded resource that contains a brief description of the snap-in.
167 This resource must be embedded in the current snap-in assembly.
168 </xs:documentation>
169 </xs:annotation>
170 </xs:attribute>
171 <xs:attribute name="RequiredPowerShellVersion" type="wxs:VersionType">
172 <xs:annotation>
173 <xs:documentation>
174 The required version of PowerShell that must be installed and is associated with the
175 snap-in registration. The default value is "1.0".
176 </xs:documentation>
177 </xs:annotation>
178 </xs:attribute>
179 <xs:attribute name="Vendor" type="xs:string">
180 <xs:annotation>
181 <xs:documentation>
182 The name of the snap-in vendor.
183 </xs:documentation>
184 </xs:annotation>
185 </xs:attribute>
186 <xs:attribute name="VendorIndirect" type="EmbeddedResource">
187 <xs:annotation>
188 <xs:documentation>
189 An embedded resource that contains the name of the snap-in vendor.
190 This resource must be embedded in the current snap-in assembly.
191 </xs:documentation>
192 </xs:annotation>
193 </xs:attribute>
194 <xs:attribute name="Version" type="wxs:VersionType">
195 <xs:annotation>
196 <xs:documentation>
197 The version of the snapin. If not specified, this is taken from the assembly name.
198 </xs:documentation>
199 </xs:annotation>
200 </xs:attribute>
201 <xs:anyAttribute namespace="##other" processContents="lax">
202 <xs:annotation>
203 <xs:documentation>
204 Extensibility point in the WiX XML Schema. Schema extensions can register additional
205 attributes at this point in the schema.
206 </xs:documentation>
207 </xs:annotation>
208 </xs:anyAttribute>
209 </xs:complexType>
210 </xs:element>
211
212 <xs:simpleType name="EmbeddedResource">
213 <xs:annotation>
214 <xs:documentation>
215 <html:p>
216 Values should be in the format *ResourceName,StringName*, where *ResourceName*
217 is the name of the embedded resource in your assembly sans the ".resources" extension, and *StringName*
218 is the name of the string resource in the embedded resource.
219 </html:p>
220 <html:p>
221 Example: UtilityMshSnapInResources,Description
222 </html:p>
223 </xs:documentation>
224 </xs:annotation>
225 <xs:restriction base="xs:string" />
226 </xs:simpleType>
227</xs:schema>
diff --git a/src/xsd/sql.xsd b/src/xsd/sql.xsd
new file mode 100644
index 00000000..2c15a66e
--- /dev/null
+++ b/src/xsd/sql.xsd
@@ -0,0 +1,461 @@
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 xmlns:wxs="http://wixtoolset.org/schemas/v4/wxs"
9 targetNamespace="http://wixtoolset.org/schemas/v4/wxs/sql"
10 xmlns="http://wixtoolset.org/schemas/v4/wxs/sql">
11 <xs:annotation>
12 <xs:documentation>
13 The source code schema for the WiX Toolset SQL Server Extension.
14 </xs:documentation>
15 </xs:annotation>
16
17 <xs:import namespace="http://wixtoolset.org/schemas/v4/wxs" />
18
19 <xs:element name="SqlDatabase">
20 <xs:annotation>
21 <xs:appinfo>
22 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
23 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
24 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Module" />
25 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Package" />
26 <xse:remarks>
27 Nesting SqlDatabase under a Component element will result in a SqlDatabase being installed to the machine as the package is installed.
28
29 Nesting SqlDatabase under Package, Fragment, or Module
30 results in a database "locator" record being created in
31 the SqlDatabase table. This means that the database
32 itself is neither installed nor uninstalled by the MSI
33 package. It does make the database available for referencing
34 from a SqlString or SqlScript record. This allows MSI to install
35 SqlScripts or SqlStrings to already existing databases on the machine.
36 The install will fail if the database does not exist in these cases.
37
38 The User attribute references credentials specified in a User element.
39 If a user is not specified then Windows Authentication will be used by default
40 using the credentials of the user performing the install to execute sql
41 strings, etc.
42 </xse:remarks>
43 <xse:seeAlso namespace="http://wixtoolset.org/schemas/v4/wxs/util" ref="User"/>
44 </xs:appinfo>
45 <xs:documentation>SQL Database</xs:documentation>
46 </xs:annotation>
47 <xs:complexType>
48 <xs:choice minOccurs="0" maxOccurs="unbounded">
49 <xs:element ref="SqlFileSpec" />
50 <xs:element ref="SqlLogFileSpec" />
51 <xs:element ref="SqlScript"/>
52 <xs:element ref="SqlString"/>
53 <xs:any namespace="##other" processContents="lax">
54 <xs:annotation>
55 <xs:documentation>
56 Extensibility point in the WiX XML Schema. Schema extensions can register additional
57 elements at this point in the schema.
58 </xs:documentation>
59 </xs:annotation>
60 </xs:any>
61 </xs:choice>
62 <xs:attribute name="Id" type="xs:string">
63 <xs:annotation>
64 <xs:documentation>Unique identifier in your installation package for this database. If an Id is not provided, one will generated for you.</xs:documentation>
65 </xs:annotation>
66 </xs:attribute>
67 <xs:attribute name="Server" type="xs:string" use="required">
68 <xs:annotation>
69 <xs:documentation>Database server name.</xs:documentation>
70 </xs:annotation>
71 </xs:attribute>
72 <xs:attribute name="Instance" type="xs:string">
73 <xs:annotation>
74 <xs:documentation>Optional database server instance.</xs:documentation>
75 </xs:annotation>
76 </xs:attribute>
77 <xs:attribute name="Database" type="xs:string" use="required">
78 <xs:annotation>
79 <xs:documentation>
80 The name of the database. The value can be a literal value or derived from a
81 Property element using the [Formatted](https://learn.microsoft.com/en-us/windows/win32/msi/formatted)
82 syntax.
83 </xs:documentation>
84 </xs:annotation>
85 </xs:attribute>
86 <xs:attribute name="User" type="xs:string">
87 <xs:annotation>
88 <xs:documentation>Optional user used to connect to database.</xs:documentation>
89 </xs:annotation>
90 </xs:attribute>
91 <xs:attribute name="CreateOnInstall" type="wxs:YesNoTypeUnion">
92 <xs:annotation>
93 <xs:documentation>Create the database during installation.</xs:documentation>
94 </xs:annotation>
95 </xs:attribute>
96 <xs:attribute name="CreateOnReinstall" type="wxs:YesNoTypeUnion">
97 <xs:annotation>
98 <xs:documentation>
99 Specifies whether to create the database when the associated component is reinstalled. Setting CreateOnInstall to yes does <html:b>not</html:b> imply CreateOnReinstall is set to yes. CreateOnReinstall must be set in addition to CreateOnInstall for it to be created during both install and reinstall.
100 </xs:documentation>
101 </xs:annotation>
102 </xs:attribute>
103 <xs:attribute name="CreateOnUninstall" type="wxs:YesNoTypeUnion">
104 <xs:annotation>
105 <xs:documentation>Create the database during uninstallation.</xs:documentation>
106 </xs:annotation>
107 </xs:attribute>
108 <xs:attribute name="DropOnInstall" type="wxs:YesNoTypeUnion">
109 <xs:annotation>
110 <xs:documentation>Drop the database during installation.</xs:documentation>
111 </xs:annotation>
112 </xs:attribute>
113 <xs:attribute name="DropOnReinstall" type="wxs:YesNoTypeUnion">
114 <xs:annotation>
115 <xs:documentation>
116 Specifies whether to drop the database when the associated component is reinstalled. Setting DropOnInstall to yes does <html:b>not</html:b> imply DropOnReinstall is set to yes. DropOnReinstall must be set in addition to DropOnInstall for it to be dropped during both install and reinstall.
117 </xs:documentation>
118 </xs:annotation>
119 </xs:attribute>
120 <xs:attribute name="DropOnUninstall" type="wxs:YesNoTypeUnion">
121 <xs:annotation>
122 <xs:documentation>Drop the database during uninstallation.</xs:documentation>
123 </xs:annotation>
124 </xs:attribute>
125 <xs:attribute name="ContinueOnError" type="wxs:YesNoTypeUnion">
126 <xs:annotation>
127 <xs:documentation>Continue even if the database operation fails.</xs:documentation>
128 </xs:annotation>
129 </xs:attribute>
130 <xs:attribute name="ConfirmOverwrite" type="wxs:YesNoTypeUnion">
131 <xs:annotation>
132 <xs:documentation>Prompt the user to overwrite the database.</xs:documentation>
133 </xs:annotation>
134 </xs:attribute>
135 <xs:anyAttribute namespace="##other" processContents="lax">
136 <xs:annotation>
137 <xs:documentation>
138 Extensibility point in the WiX XML Schema. Schema extensions can register additional
139 attributes at this point in the schema.
140 </xs:documentation>
141 </xs:annotation>
142 </xs:anyAttribute>
143 </xs:complexType>
144 </xs:element>
145
146 <xs:element name="SqlFileSpec">
147 <xs:annotation>
148 <xs:documentation>File specification for a Sql database.</xs:documentation>
149 </xs:annotation>
150 <xs:complexType>
151 <xs:choice minOccurs="0" maxOccurs="unbounded">
152 <xs:any namespace="##other" processContents="lax">
153 <xs:annotation>
154 <xs:documentation>
155 Extensibility point in the WiX XML Schema. Schema extensions can register additional
156 elements at this point in the schema.
157 </xs:documentation>
158 </xs:annotation>
159 </xs:any>
160 </xs:choice>
161 <xs:attribute name="Id" use="required" type="xs:string">
162 <xs:annotation>
163 <xs:documentation>Unique identifier in your installation package for this file specification. If an Id is not provided, one will generated for you.</xs:documentation>
164 </xs:annotation>
165 </xs:attribute>
166 <xs:attribute name="Name" type="xs:string">
167 <xs:annotation>
168 <xs:documentation>Specifies the logical name for the database file.</xs:documentation>
169 </xs:annotation>
170 </xs:attribute>
171 <xs:attribute name="Filename" use="required" type="xs:string">
172 <xs:annotation>
173 <xs:documentation>Specifies the operating-system file name for the database file.</xs:documentation>
174 </xs:annotation>
175 </xs:attribute>
176 <xs:attribute name="Size" type="xs:string">
177 <xs:annotation>
178 <xs:documentation>
179 Specifies the size of the database file. The GB, MB and KB suffixes can be used to specify gigabytes,
180 megabytes or kilobytes. The default is megabytes if no suffix is specified. When a Size is not
181 supplied for a database file, SQL Server uses the size of the primary file in the model database.
182 </xs:documentation>
183 </xs:annotation>
184 </xs:attribute>
185 <xs:attribute name="MaxSize" type="xs:string">
186 <xs:annotation>
187 <xs:documentation>
188 Specifies the maximum size to which the database file can grow. The GB, MB and KB suffixes can be used to
189 to specify gigabytes, megabytes or kilobytes. The default is megabytes if no suffix is specified. If
190 MaxSize is not specified, the file will grow until the disk is full.
191 </xs:documentation>
192 </xs:annotation>
193 </xs:attribute>
194 <xs:attribute name="GrowthSize" type="xs:string">
195 <xs:annotation>
196 <xs:documentation>
197 Specifies the growth increment of the database file. The GB, MB and KB and % suffixes can be used to
198 specify gigabytes, megabytes, kilobytes or a percentage of the current file size to grow. The default is
199 megabytes if no suffix is specified. The default value is 10% if GrowthSize is not specified, and the
200 minimum value is 64 KB. The GrowthSize setting for a file cannot exceed the MaxSize setting.
201 </xs:documentation>
202 </xs:annotation>
203 </xs:attribute>
204 <xs:anyAttribute namespace="##other" processContents="lax">
205 <xs:annotation>
206 <xs:documentation>
207 Extensibility point in the WiX XML Schema. Schema extensions can register additional
208 attributes at this point in the schema.
209 </xs:documentation>
210 </xs:annotation>
211 </xs:anyAttribute>
212 </xs:complexType>
213 </xs:element>
214
215 <xs:element name="SqlLogFileSpec">
216 <xs:annotation>
217 <xs:documentation>File specification for a Sql database.</xs:documentation>
218 </xs:annotation>
219 <xs:complexType>
220 <xs:choice minOccurs="0" maxOccurs="unbounded">
221 <xs:any namespace="##other" processContents="lax">
222 <xs:annotation>
223 <xs:documentation>
224 Extensibility point in the WiX XML Schema. Schema extensions can register additional
225 elements at this point in the schema.
226 </xs:documentation>
227 </xs:annotation>
228 </xs:any>
229 </xs:choice>
230 <xs:attribute name="Id" type="xs:string">
231 <xs:annotation>
232 <xs:documentation>Unique identifier in your installation package for this log file specification. If an Id is not provided, one will generated for you.</xs:documentation>
233 </xs:annotation>
234 </xs:attribute>
235 <xs:attribute name="Name" type="xs:string">
236 <xs:annotation>
237 <xs:documentation>Specifies the logical name for the log file.</xs:documentation>
238 </xs:annotation>
239 </xs:attribute>
240 <xs:attribute name="Filename" type="xs:string">
241 <xs:annotation>
242 <xs:documentation>Specifies the operating-system file name for the log file.</xs:documentation>
243 </xs:annotation>
244 </xs:attribute>
245 <xs:attribute name="Size" type="xs:string">
246 <xs:annotation>
247 <xs:documentation>
248 Specifies the size of the log file. The GB, MB and KB suffixes can be used to specify gigabytes,
249 megabytes or kilobytes. The default is megabytes if no suffix is specified. When a Size is not
250 supplied for a log file, SQL Server makes the file 1 MB.
251 </xs:documentation>
252 </xs:annotation>
253 </xs:attribute>
254 <xs:attribute name="MaxSize" type="xs:string">
255 <xs:annotation>
256 <xs:documentation>
257 Specifies the maximum size to which the log file can grow. The GB, MB and KB suffixes can be used to
258 to specify gigabytes, megabytes or kilobytes. The default is megabytes if no suffix is specified. If
259 MaxSize is not specified, the file will grow until the disk is full.
260 </xs:documentation>
261 </xs:annotation>
262 </xs:attribute>
263 <xs:attribute name="GrowthSize" type="xs:string">
264 <xs:annotation>
265 <xs:documentation>
266 Specifies the growth increment of the log file. The GB, MB and KB and % suffixes can be used to
267 specify gigabytes, megabytes, kilobytes or a percentage of the current file size to grow. The default is
268 megabytes if no suffix is specified. The default value is 10% if GrowthSize is not specified, and the
269 minimum value is 64 KB. The GrowthSize setting for a file cannot exceed the MaxSize setting.
270 </xs:documentation>
271 </xs:annotation>
272 </xs:attribute>
273 <xs:anyAttribute namespace="##other" processContents="lax">
274 <xs:annotation>
275 <xs:documentation>
276 Extensibility point in the WiX XML Schema. Schema extensions can register additional
277 attributes at this point in the schema.
278 </xs:documentation>
279 </xs:annotation>
280 </xs:anyAttribute>
281 </xs:complexType>
282 </xs:element>
283
284 <xs:element name="SqlScript">
285 <xs:annotation>
286 <xs:appinfo>
287 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
288 </xs:appinfo>
289 <xs:documentation>SQL Script</xs:documentation>
290 </xs:annotation>
291 <xs:complexType>
292 <xs:choice minOccurs="0" maxOccurs="unbounded">
293 <xs:any namespace="##other" processContents="lax">
294 <xs:annotation>
295 <xs:documentation>
296 Extensibility point in the WiX XML Schema. Schema extensions can register additional
297 elements at this point in the schema.
298 </xs:documentation>
299 </xs:annotation>
300 </xs:any>
301 </xs:choice>
302 <xs:attribute name="Id" type="xs:string">
303 <xs:annotation>
304 <xs:documentation>Unique identifier in your installation package for this sql script. If an Id is not provided, one will generated for you.</xs:documentation>
305 </xs:annotation>
306 </xs:attribute>
307 <xs:attribute name="SqlDb" type="xs:string">
308 <xs:annotation>
309 <xs:documentation>Id of the SqlDatabase to execute the script against. Required when not child of SqlDatabase.</xs:documentation>
310 </xs:annotation>
311 </xs:attribute>
312 <xs:attribute name="User" type="xs:string">
313 <xs:annotation>
314 <xs:documentation>Optional user used to connect to database.</xs:documentation>
315 </xs:annotation>
316 </xs:attribute>
317 <xs:attribute name="BinaryRef" type="xs:string" use="required">
318 <xs:annotation>
319 <xs:documentation>Reference to Binary stream that contains the SQL script to execute.</xs:documentation>
320 </xs:annotation>
321 </xs:attribute>
322 <xs:attribute name="ExecuteOnInstall" type="wxs:YesNoTypeUnion">
323 <xs:annotation>
324 <xs:documentation>Specifies to execute the script when the associated component is installed. This attribute is mutually exclusive with the RollbackOnInstall, RollbackOnReinstall and RollbackOnUninstall attributes.</xs:documentation>
325 </xs:annotation>
326 </xs:attribute>
327 <xs:attribute name="ExecuteOnReinstall" type="wxs:YesNoTypeUnion">
328 <xs:annotation>
329 <xs:documentation>Specifies whether to execute the script when the associated component is reinstalled. Setting ExecuteOnInstall to yes does <html:b>not</html:b> imply ExecuteOnReinstall is set to yes. ExecuteOnReinstall must be set in addition to ExecuteOnInstall for it to be executed during both install and reinstall. This attribute is mutually exclusive with the RollbackOnInstall, RollbackOnReinstall and RollbackOnUninstall attributes.</xs:documentation>
330 </xs:annotation>
331 </xs:attribute>
332 <xs:attribute name="ExecuteOnUninstall" type="wxs:YesNoTypeUnion">
333 <xs:annotation>
334 <xs:documentation>Specifies to execute the script when the associated component is uninstalled. This attribute is mutually exclusive with the RollbackOnInstall, RollbackOnReinstall and RollbackOnUninstall attributes.</xs:documentation>
335 </xs:annotation>
336 </xs:attribute>
337 <xs:attribute name="RollbackOnInstall" type="wxs:YesNoTypeUnion">
338 <xs:annotation>
339 <xs:documentation>Specifies whether to execute the script on rollback if an attempt is made to install the associated component. This attribute is mutually exclusive with the ExecuteOnInstall, ExecuteOnReinstall and ExecuteOnUninstall attributes.</xs:documentation>
340 </xs:annotation>
341 </xs:attribute>
342 <xs:attribute name="RollbackOnReinstall" type="wxs:YesNoTypeUnion">
343 <xs:annotation>
344 <xs:documentation>Specifies whether to execute the script on rollback if an attempt is made to reinstall the associated component. This attribute is mutually exclusive with the ExecuteOnInstall, ExecuteOnReinstall and ExecuteOnUninstall attributes.</xs:documentation>
345 </xs:annotation>
346 </xs:attribute>
347 <xs:attribute name="RollbackOnUninstall" type="wxs:YesNoTypeUnion">
348 <xs:annotation>
349 <xs:documentation>Specifies whether to execute the script on rollback if an attempt is made to uninstall the associated component. This attribute is mutually exclusive with the ExecuteOnInstall, ExecuteOnReinstall and ExecuteOnUninstall attributes.</xs:documentation>
350 </xs:annotation>
351 </xs:attribute>
352 <xs:attribute name="ContinueOnError" type="wxs:YesNoTypeUnion">
353 <xs:annotation>
354 <xs:documentation>Continue executing scripts even if this one fails.</xs:documentation>
355 </xs:annotation>
356 </xs:attribute>
357 <xs:attribute name="Sequence" type="wxs:Integer">
358 <xs:annotation>
359 <xs:documentation>Specifes the order to run the SQL Scripts. It is recommended that rollback scripts be scheduled before their complementary execution script. This order is also relative across the SqlString element.</xs:documentation>
360 </xs:annotation>
361 </xs:attribute>
362 <xs:anyAttribute namespace="##other" processContents="lax">
363 <xs:annotation>
364 <xs:documentation>
365 Extensibility point in the WiX XML Schema. Schema extensions can register additional
366 attributes at this point in the schema.
367 </xs:documentation>
368 </xs:annotation>
369 </xs:anyAttribute>
370 </xs:complexType>
371 </xs:element>
372
373 <xs:element name="SqlString">
374 <xs:annotation>
375 <xs:appinfo>
376 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
377 </xs:appinfo>
378 <xs:documentation>SQL String</xs:documentation>
379 </xs:annotation>
380 <xs:complexType>
381 <xs:choice minOccurs="0" maxOccurs="unbounded">
382 <xs:any namespace="##other" processContents="lax">
383 <xs:annotation>
384 <xs:documentation>
385 Extensibility point in the WiX XML Schema. Schema extensions can register additional
386 elements at this point in the schema.
387 </xs:documentation>
388 </xs:annotation>
389 </xs:any>
390 </xs:choice>
391 <xs:attribute name="Id" type="xs:string">
392 <xs:annotation>
393 <xs:documentation>Unique identifier in your installation package for this sql command. If an Id is not provided, one will generated for you.</xs:documentation>
394 </xs:annotation>
395 </xs:attribute>
396 <xs:attribute name="SqlDb" type="xs:string">
397 <xs:annotation>
398 <xs:documentation>Id of the SqlDatabase to execute the script against. Required when not child of SqlDatabase.</xs:documentation>
399 </xs:annotation>
400 </xs:attribute>
401 <xs:attribute name="User" type="xs:string">
402 <xs:annotation>
403 <xs:documentation>Optional user used to connect to database.</xs:documentation>
404 </xs:annotation>
405 </xs:attribute>
406 <xs:attribute name="SQL" type="xs:string" use="required">
407 <xs:annotation>
408 <xs:documentation>SQL command to execute against the database.</xs:documentation>
409 </xs:annotation>
410 </xs:attribute>
411 <xs:attribute name="ExecuteOnInstall" type="wxs:YesNoTypeUnion">
412 <xs:annotation>
413 <xs:documentation>Specifies to execute the string when the associated component is installed. This attribute is mutually exclusive with the RollbackOnInstall, RollbackOnReinstall and RollbackOnUninstall attributes.</xs:documentation>
414 </xs:annotation>
415 </xs:attribute>
416 <xs:attribute name="ExecuteOnReinstall" type="wxs:YesNoTypeUnion">
417 <xs:annotation>
418 <xs:documentation>Specifies whether to execute the string when the associated component is reinstalled. Setting ExecuteOnInstall to yes does <html:b>not</html:b> imply ExecuteOnReinstall is set to yes. ExecuteOnReinstall must be set in addition to ExecuteOnInstall for it to be executed during both install and reinstall. This attribute is mutually exclusive with the RollbackOnInstall, RollbackOnReinstall and RollbackOnUninstall attributes.</xs:documentation>
419 </xs:annotation>
420 </xs:attribute>
421 <xs:attribute name="ExecuteOnUninstall" type="wxs:YesNoTypeUnion">
422 <xs:annotation>
423 <xs:documentation>Specifies to execute the string when the associated component is uninstalled. This attribute is mutually exclusive with the RollbackOnInstall, RollbackOnReinstall and RollbackOnUninstall attributes.</xs:documentation>
424 </xs:annotation>
425 </xs:attribute>
426 <xs:attribute name="RollbackOnInstall" type="wxs:YesNoTypeUnion">
427 <xs:annotation>
428 <xs:documentation>Specifies whether to execute the string on rollback if an attempt is made to install the associated component. This attribute is mutually exclusive with the ExecuteOnInstall, ExecuteOnReinstall and ExecuteOnUninstall attributes.</xs:documentation>
429 </xs:annotation>
430 </xs:attribute>
431 <xs:attribute name="RollbackOnReinstall" type="wxs:YesNoTypeUnion">
432 <xs:annotation>
433 <xs:documentation>Specifies whether to execute the string on rollback if an attempt is made to reinstall the associated component. This attribute is mutually exclusive with the ExecuteOnInstall, ExecuteOnReinstall and ExecuteOnUninstall attributes.</xs:documentation>
434 </xs:annotation>
435 </xs:attribute>
436 <xs:attribute name="RollbackOnUninstall" type="wxs:YesNoTypeUnion">
437 <xs:annotation>
438 <xs:documentation>Specifies whether to execute the string on rollback if an attempt is made to uninstall the associated component. This attribute is mutually exclusive with the ExecuteOnInstall, ExecuteOnReinstall and ExecuteOnUninstall attributes.</xs:documentation>
439 </xs:annotation>
440 </xs:attribute>
441 <xs:attribute name="ContinueOnError" type="wxs:YesNoTypeUnion">
442 <xs:annotation>
443 <xs:documentation>Continue executing strings even if this one fails.</xs:documentation>
444 </xs:annotation>
445 </xs:attribute>
446 <xs:attribute name="Sequence" type="wxs:Integer">
447 <xs:annotation>
448 <xs:documentation>Specifes the order to run the SQL Strings. It is recommended that rollback strings be scheduled before their complementary execution string. This order is also relative across the SqlScript element.</xs:documentation>
449 </xs:annotation>
450 </xs:attribute>
451 <xs:anyAttribute namespace="##other" processContents="lax">
452 <xs:annotation>
453 <xs:documentation>
454 Extensibility point in the WiX XML Schema. Schema extensions can register additional
455 attributes at this point in the schema.
456 </xs:documentation>
457 </xs:annotation>
458 </xs:anyAttribute>
459 </xs:complexType>
460 </xs:element>
461</xs:schema>
diff --git a/src/xsd/thmutil.xsd b/src/xsd/thmutil.xsd
new file mode 100644
index 00000000..417bac87
--- /dev/null
+++ b/src/xsd/thmutil.xsd
@@ -0,0 +1,1365 @@
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/thmutil"
9 xmlns="http://wixtoolset.org/schemas/v4/thmutil">
10 <xs:annotation>
11 <xs:documentation>
12 Schema for describing Theme files processed by thmutil.
13 </xs:documentation>
14 </xs:annotation>
15
16 <xs:import namespace="http://www.w3.org/1999/xhtml" />
17
18 <xs:element name="Theme">
19 <xs:annotation>
20 <xs:documentation>
21 This is the top-level container element for every thmutil Theme file.
22 </xs:documentation>
23 </xs:annotation>
24 <xs:complexType>
25 <xs:sequence>
26 <xs:element ref="Font" maxOccurs="unbounded" />
27 <xs:element ref="Image" minOccurs="0" maxOccurs="unbounded" />
28 <xs:element ref="ImageList" minOccurs="0" maxOccurs="unbounded" />
29 <xs:element ref="Window" minOccurs="1" maxOccurs="1" />
30 </xs:sequence>
31 <xs:attribute name="ImageFile" type="xs:string">
32 <xs:annotation>
33 <xs:documentation>
34 Relative path to an image file that can serve as a single source for images in the rest of the theme.
35 This image is referenced by controls using the SourceX and SourceY attributes.
36 Mutually exclusive with the ImageResource attribute.
37 </xs:documentation>
38 </xs:annotation>
39 </xs:attribute>
40 <xs:attribute name="ImageResource" type="xs:string">
41 <xs:annotation>
42 <xs:documentation>
43 Identifier that references an image resource in the module for the window.
44 This image is referenced by controls using the SourceX and SourceY attributes.
45 Mutually exclusive with the ImageFile attribute.
46 </xs:documentation>
47 </xs:annotation>
48 </xs:attribute>
49 </xs:complexType>
50 </xs:element>
51
52 <xs:element name="Font">
53 <xs:annotation>
54 <xs:documentation>Defines a font including the size and color.</xs:documentation>
55 </xs:annotation>
56 <xs:complexType>
57 <xs:simpleContent>
58 <xs:extension base="xs:string">
59 <xs:annotation>
60 <xs:documentation>Name of the font face (required).</xs:documentation>
61 </xs:annotation>
62 <xs:attribute name="Id" type="xs:string" use="required">
63 <xs:annotation>
64 <xs:documentation>Identifier for the font.</xs:documentation>
65 </xs:annotation>
66 </xs:attribute>
67 <xs:attribute name="Height" type="xs:int" use="required">
68 <xs:annotation>
69 <xs:documentation>Font size. Use negative numbers to specify the font in pixels.</xs:documentation>
70 </xs:annotation>
71 </xs:attribute>
72 <xs:attribute name="Weight" type="xs:nonNegativeInteger">
73 <xs:annotation>
74 <xs:documentation>Font weight.</xs:documentation>
75 </xs:annotation>
76 </xs:attribute>
77 <xs:attribute name="Foreground" type="FontColorType">
78 <xs:annotation>
79 <xs:documentation>
80 A system color id or a hexadecimal value representing BGR foreground color of the font.
81 "ffffff" is white, "ff0000" is pure blue, "00ff00" is pure green, "0000ff" is pure red, and "000000" is black.
82 If this attribute is absent the foreground will be transparent.
83 Supported system color ids are: btnface, btntext, graytext, highlight, highlighttext, hotlight, window, and windowtext.
84 </xs:documentation>
85 </xs:annotation>
86 </xs:attribute>
87 <xs:attribute name="Background" type="FontColorType">
88 <xs:annotation>
89 <xs:documentation>
90 A system color id or a hexadecimal value representing BGR background color of the font.
91 "ffffff" is white, "ff0000" is pure blue, "00ff00" is pure green, "0000ff" is pure red, and "000000" is black.
92 If this attribute is absent the background will be transparent.
93 Supported system color ids are: btnface, btntext, graytext, highlight, highlighttext, hotlight, window, and windowtext.
94 </xs:documentation>
95 </xs:annotation>
96 </xs:attribute>
97 <xs:attribute name="Underline" type="YesNoType">
98 <xs:annotation>
99 <xs:documentation>Specifies whether the font is underlined.</xs:documentation>
100 </xs:annotation>
101 </xs:attribute>
102 </xs:extension>
103 </xs:simpleContent>
104 </xs:complexType>
105 </xs:element>
106
107 <xs:element name="Image">
108 <xs:annotation>
109 <xs:documentation>
110 Defines an image which can be shared between multiple controls.
111 If alternates are provided, the dimensions of the destination rectangle are compared to all of the available sources:
112 1. If there is an exact match for width and height then that source will be used (no scaling required).
113 2. If there is not an exact match then the smallest source whose width and height are larger or equal to the destination will be used and downscaled.
114 3. If there is still no match then the largest source will be used and upscaled.
115 </xs:documentation>
116 </xs:annotation>
117 <xs:complexType>
118 <xs:choice minOccurs="0" maxOccurs="unbounded">
119 <xs:element ref="AlternateResolution" />
120 </xs:choice>
121 <xs:attribute name="Id" type="xs:string" use="required">
122 <xs:annotation>
123 <xs:documentation>Identifier for the Image.</xs:documentation>
124 </xs:annotation>
125 </xs:attribute>
126 <xs:attribute name="ImageFile" type="xs:string">
127 <xs:annotation>
128 <xs:documentation>
129 Relative path to an image file for the control.
130 Mutually exclusive with ImageResource attribute.
131 </xs:documentation>
132 </xs:annotation>
133 </xs:attribute>
134 <xs:attribute name="ImageResource" type="xs:nonNegativeInteger">
135 <xs:annotation>
136 <xs:documentation>
137 Identifier that references an image resource with type RT_RCDATA in the module for the control.
138 Mutually exclusive with ImageFile attribute.
139 </xs:documentation>
140 </xs:annotation>
141 </xs:attribute>
142 </xs:complexType>
143 </xs:element>
144
145 <xs:element name="ImageList">
146 <xs:annotation>
147 <xs:documentation>List of images which can be shared between multiple controls.</xs:documentation>
148 </xs:annotation>
149 <xs:complexType>
150 <xs:choice maxOccurs="unbounded">
151 <xs:element ref="ImageListItem" />
152 </xs:choice>
153 <xs:attribute name="Name" type="xs:string" use="required">
154 <xs:annotation>
155 <xs:documentation>
156 Name of the ImageList, to be referenced by other controls.
157 </xs:documentation>
158 </xs:annotation>
159 </xs:attribute>
160 </xs:complexType>
161 </xs:element>
162
163 <xs:element name="Page">
164 <xs:annotation>
165 <xs:documentation>Named set of controls that can be shown and hidden collectively.</xs:documentation>
166 </xs:annotation>
167 <xs:complexType>
168 <xs:group ref="ControlElements" maxOccurs="unbounded"/>
169 <xs:attribute name="Name" type="xs:string">
170 <xs:annotation>
171 <xs:documentation>
172 Optional name for the page.
173 </xs:documentation>
174 </xs:annotation>
175 </xs:attribute>
176 </xs:complexType>
177 </xs:element>
178
179 <xs:element name="Window">
180 <xs:annotation>
181 <xs:documentation>Defines the overall look of the main window.</xs:documentation>
182 </xs:annotation>
183 <xs:complexType>
184 <xs:choice minOccurs="0" maxOccurs="unbounded">
185 <xs:element ref="Page" />
186 <xs:group ref="ControlElements" minOccurs="0" maxOccurs="unbounded" />
187 </xs:choice>
188 <xs:attribute name="AutoResize" type="YesNoType">
189 <xs:annotation>
190 <xs:documentation>Specifies whether the ThmUtil default window proc should process WM_SIZE and WM_SIZING events.</xs:documentation>
191 </xs:annotation>
192 </xs:attribute>
193 <xs:attribute name="Caption" type="xs:string">
194 <xs:annotation>
195 <xs:documentation>
196 Caption for the window.
197 This is required if not using the StringId attribute.
198 </xs:documentation>
199 </xs:annotation>
200 </xs:attribute>
201 <xs:attribute name="FontId" type="xs:string" use="required">
202 <xs:annotation>
203 <xs:documentation>Identifier to the Font element that serves as the default font for the window.</xs:documentation>
204 </xs:annotation>
205 </xs:attribute>
206 <xs:attribute name="Height" type="xs:positiveInteger" use="required">
207 <xs:annotation>
208 <xs:documentation>Height of the window's client area.</xs:documentation>
209 </xs:annotation>
210 </xs:attribute>
211 <xs:attribute name="HexStyle" type="xs:hexBinary">
212 <xs:annotation>
213 <xs:documentation>
214 Hexadecimal window style. If this is not specified the default value is: WS_OVERLAPPED | WS_VISIBLE | WS_MINIMIZEBOX | WS_SYSMENU | WS_CAPTION.
215 If SourceX and SourceY are specified, then WS_OVERLAPPED is replaced with WS_POPUP.
216 </xs:documentation>
217 </xs:annotation>
218 </xs:attribute>
219 <xs:attribute name="IconFile" type="xs:string">
220 <xs:annotation>
221 <xs:documentation>Relative path to an icon file for the window. Mutually exclusive with IconResource attribute.</xs:documentation>
222 </xs:annotation>
223 </xs:attribute>
224 <xs:attribute name="IconResource" type="xs:string">
225 <xs:annotation>
226 <xs:documentation>
227 Identifier that references an icon resource in the module for the icon for the window.
228 Mutually exclusive with IconFile attribute.
229 </xs:documentation>
230 </xs:annotation>
231 </xs:attribute>
232 <xs:attribute name="MinimumHeight" type="xs:positiveInteger">
233 <xs:annotation>
234 <xs:documentation>Minimum height of the window. Can only be specified if AutoResize is enabled.</xs:documentation>
235 </xs:annotation>
236 </xs:attribute>
237 <xs:attribute name="MinimumWidth" type="xs:positiveInteger">
238 <xs:annotation>
239 <xs:documentation>Minimum width of the window. Can only be specified if AutoResize is enabled.</xs:documentation>
240 </xs:annotation>
241 </xs:attribute>
242 <xs:attribute name="SourceX" type="xs:nonNegativeInteger">
243 <xs:annotation>
244 <xs:documentation>
245 X offset of the window background in the Theme/@ImageFile or Theme/@ImageResource.
246 Can only be specified with Theme/@ImageFile or Theme/@ImageResource.
247 </xs:documentation>
248 </xs:annotation>
249 </xs:attribute>
250 <xs:attribute name="SourceY" type="xs:nonNegativeInteger">
251 <xs:annotation>
252 <xs:documentation>
253 Y offset of the window background in the Theme/@ImageFile or Theme/@ImageResource.
254 Can only be specified with Theme/@ImageFile or Theme/@ImageResource.
255 </xs:documentation>
256 </xs:annotation>
257 </xs:attribute>
258 <xs:attribute name="StringId" type="xs:nonNegativeInteger">
259 <xs:annotation>
260 <xs:documentation>
261 Identifier that references a string resource in the module to define the window caption.
262 Mutually exclusive with the Caption attribute.
263 </xs:documentation>
264 </xs:annotation>
265 </xs:attribute>
266 <xs:attribute name="Width" type="xs:positiveInteger" use="required">
267 <xs:annotation>
268 <xs:documentation>Width of the window's client area.</xs:documentation>
269 </xs:annotation>
270 </xs:attribute>
271 </xs:complexType>
272 </xs:element>
273
274 <xs:element name="Billboard">
275 <xs:annotation>
276 <xs:documentation>Defines a control that rotates through a set of panels on a specified interval.</xs:documentation>
277 </xs:annotation>
278 <xs:complexType>
279 <xs:sequence>
280 <xs:element ref="Panel" />
281 </xs:sequence>
282 <xs:attributeGroup ref="CommonControlAttributes" />
283 <xs:attribute name="Interval" type="xs:positiveInteger">
284 <xs:annotation>
285 <xs:documentation>
286 Specifies the time to wait before showing the next panel, in milliseconds.
287 </xs:documentation>
288 </xs:annotation>
289 </xs:attribute>
290 <xs:attribute name="Loop" type="YesNoType">
291 <xs:annotation>
292 <xs:documentation>Specifies whether the billboard should loop through the panels infinitely.</xs:documentation>
293 </xs:annotation>
294 </xs:attribute>
295 </xs:complexType>
296 </xs:element>
297
298 <xs:element name="AlternateResolution">
299 <xs:annotation>
300 <xs:documentation>
301 Defines an alternate resolution to avoid scaling in different DPIs.
302 </xs:documentation>
303 </xs:annotation>
304 <xs:complexType>
305 <xs:attribute name="ImageFile" type="xs:string">
306 <xs:annotation>
307 <xs:documentation>
308 Relative path to an image file for the control.
309 Mutually exclusive with ImageResource attribute.
310 </xs:documentation>
311 </xs:annotation>
312 </xs:attribute>
313 <xs:attribute name="ImageResource" type="xs:nonNegativeInteger">
314 <xs:annotation>
315 <xs:documentation>
316 Identifier that references an image resource with type RT_RCDATA in the module for the control.
317 Mutually exclusive with ImageFile attribute.
318 </xs:documentation>
319 </xs:annotation>
320 </xs:attribute>
321 </xs:complexType>
322 </xs:element>
323
324 <xs:element name="Button">
325 <xs:annotation>
326 <xs:documentation>
327 Defines a button.
328 </xs:documentation>
329 </xs:annotation>
330 <xs:complexType mixed="true">
331 <xs:annotation>
332 <xs:documentation>
333 Text to display in the button.
334 Mutually exclusive with the StringId attribute and child Text elements.
335 </xs:documentation>
336 </xs:annotation>
337 <xs:choice minOccurs="0" maxOccurs="unbounded">
338 <xs:annotation>
339 <xs:documentation>
340 If multiple Action elements are given, the conditions should be mutually exclusive (when multiple conditions are true, the behavior is undefined and could be changed at any time).
341 If none of the conditions of the Action elements are true, then it uses the Action element without the Condition attribute.
342 </xs:documentation>
343 </xs:annotation>
344 <xs:element ref="ButtonImage" maxOccurs="1" />
345 <xs:element ref="ButtonFocusImage" maxOccurs="1" />
346 <xs:element ref="ButtonHoverImage" maxOccurs="1" />
347 <xs:element ref="ButtonSelectedImage" maxOccurs="1" />
348 <xs:element ref="BrowseDirectoryAction" />
349 <xs:element ref="ChangePageAction" />
350 <xs:element ref="CloseWindowAction" />
351 <xs:element ref="Text" />
352 <xs:element ref="Tooltip" maxOccurs="1" />
353 </xs:choice>
354 <xs:attributeGroup ref="CommonControlAttributes" />
355 <xs:attributeGroup ref="OwnerDrawImageAttributes" />
356 <xs:attribute name="FontId" type="xs:string">
357 <xs:annotation>
358 <xs:documentation>Identifier to the Font element that serves as the font for the control. Only valid when using graphic buttons.</xs:documentation>
359 </xs:annotation>
360 </xs:attribute>
361 <xs:attribute name="HoverFontId" type="xs:string">
362 <xs:annotation>
363 <xs:documentation>Identifier to the Font element that serves as the font when the control is hovered over. Only valid when using graphic buttons.</xs:documentation>
364 </xs:annotation>
365 </xs:attribute>
366 <xs:attribute name="SelectedFontId" type="xs:string">
367 <xs:annotation>
368 <xs:documentation>Identifier to the Font element that serves as the font when the control is selected. Only valid when using graphic buttons.</xs:documentation>
369 </xs:annotation>
370 </xs:attribute>
371 <xs:attribute name="StringId" type="xs:nonNegativeInteger">
372 <xs:annotation>
373 <xs:documentation>
374 Identifier that references a string resource in the module to define the text for the control.
375 </xs:documentation>
376 </xs:annotation>
377 </xs:attribute>
378 </xs:complexType>
379 </xs:element>
380
381 <xs:element name="ButtonImage">
382 <xs:annotation>
383 <xs:documentation>
384 Defines a button image.
385 ButtonHoverImage and ButtonSelectedImage are required with ButtonImage.
386 </xs:documentation>
387 </xs:annotation>
388 <xs:complexType>
389 <xs:attributeGroup ref="OwnerDrawImageAttributes" />
390 </xs:complexType>
391 </xs:element>
392
393 <xs:element name="ButtonFocusImage">
394 <xs:annotation>
395 <xs:documentation>
396 Defines a button image that is used when the control has focus.
397 ButtonImage, ButtonHoverImage, and ButtonSelectedImage are required with ButtonFocusImage.
398 If not specified, then the default focus rectangle is drawn on top of ButtonImage.
399 </xs:documentation>
400 </xs:annotation>
401 <xs:complexType>
402 <xs:attributeGroup ref="OwnerDrawImageAttributes" />
403 </xs:complexType>
404 </xs:element>
405
406 <xs:element name="ButtonHoverImage">
407 <xs:annotation>
408 <xs:documentation>
409 Defines a button image that is used when the control is hovered over.
410 ButtonImage and ButtonSelectedImage are required with ButtonHoverImage.
411 </xs:documentation>
412 </xs:annotation>
413 <xs:complexType>
414 <xs:attributeGroup ref="OwnerDrawImageAttributes" />
415 </xs:complexType>
416 </xs:element>
417
418 <xs:element name="ButtonSelectedImage">
419 <xs:annotation>
420 <xs:documentation>
421 Defines a button image that is used when the control is selected.
422 ButtonImage and ButtonHoverImage are required with ButtonSelectedImage.
423 </xs:documentation>
424 </xs:annotation>
425 <xs:complexType>
426 <xs:attributeGroup ref="OwnerDrawImageAttributes" />
427 </xs:complexType>
428 </xs:element>
429
430 <xs:element name="BrowseDirectoryAction">
431 <xs:annotation>
432 <xs:documentation>
433 When the button is pressed, a directory browser dialog is shown.
434 </xs:documentation>
435 </xs:annotation>
436 <xs:complexType>
437 <xs:attribute name="Condition" type="xs:string">
438 <xs:annotation>
439 <xs:documentation>
440 The condition that determines if the parent control will execute this action.
441 </xs:documentation>
442 </xs:annotation>
443 </xs:attribute>
444 <xs:attribute name="VariableName" type="xs:string" use="required">
445 <xs:annotation>
446 <xs:documentation>
447 The name of the variable to update when the user selects a directory from the dialog.
448 </xs:documentation>
449 </xs:annotation>
450 </xs:attribute>
451 </xs:complexType>
452 </xs:element>
453
454 <xs:element name="ChangePageAction">
455 <xs:annotation>
456 <xs:documentation>
457 When the button is pressed, the specified page is shown.
458 </xs:documentation>
459 </xs:annotation>
460 <xs:complexType>
461 <xs:attribute name="Cancel" type="YesNoType">
462 <xs:annotation>
463 <xs:documentation>
464 When set to 'yes', none of the variable changes made on the current page are saved.
465 </xs:documentation>
466 </xs:annotation>
467 </xs:attribute>
468 <xs:attribute name="Condition" type="xs:string">
469 <xs:annotation>
470 <xs:documentation>
471 The condition that determines if the parent control will execute this action.
472 </xs:documentation>
473 </xs:annotation>
474 </xs:attribute>
475 <xs:attribute name="Page" type="xs:string" use="required">
476 <xs:annotation>
477 <xs:documentation>
478 The Name of the Page to show.
479 </xs:documentation>
480 </xs:annotation>
481 </xs:attribute>
482 </xs:complexType>
483 </xs:element>
484
485 <xs:element name="CloseWindowAction">
486 <xs:annotation>
487 <xs:documentation>
488 When the button is pressed, the WM_CLOSE message is sent to the window.
489 </xs:documentation>
490 </xs:annotation>
491 <xs:complexType>
492 <xs:attribute name="Condition" type="xs:string">
493 <xs:annotation>
494 <xs:documentation>
495 The condition that determines if the parent control will execute this action.
496 </xs:documentation>
497 </xs:annotation>
498 </xs:attribute>
499 </xs:complexType>
500 </xs:element>
501
502 <xs:element name="Checkbox">
503 <xs:annotation>
504 <xs:documentation>Defines a checkbox.</xs:documentation>
505 </xs:annotation>
506 <xs:complexType mixed="true">
507 <xs:annotation>
508 <xs:documentation>
509 Text to display beside the checkbox.
510 Mutually exclusive with the StringId attribute and child Text elements.
511 </xs:documentation>
512 </xs:annotation>
513 <xs:choice minOccurs="0" maxOccurs="unbounded">
514 <xs:element ref="Text" />
515 <xs:element ref="Tooltip" maxOccurs="1" />
516 </xs:choice>
517 <xs:attributeGroup ref="CommonControlAttributes" />
518 <xs:attribute name="FontId" type="xs:string">
519 <xs:annotation>
520 <xs:documentation>Identifier to the Font element that serves as the font for the control.</xs:documentation>
521 </xs:annotation>
522 </xs:attribute>
523 <xs:attribute name="StringId" type="xs:nonNegativeInteger">
524 <xs:annotation>
525 <xs:documentation>
526 Identifier that references a string resource in the module to define the text for the control.
527 </xs:documentation>
528 </xs:annotation>
529 </xs:attribute>
530 </xs:complexType>
531 </xs:element>
532
533 <xs:element name="Combobox">
534 <xs:annotation>
535 <xs:documentation>Defines a combobox.</xs:documentation>
536 </xs:annotation>
537 <xs:complexType>
538 <xs:attributeGroup ref="CommonControlAttributes" />
539 <xs:attribute name="FontId" type="xs:string">
540 <xs:annotation>
541 <xs:documentation>Identifier to the Font element that serves as the font for the control.</xs:documentation>
542 </xs:annotation>
543 </xs:attribute>
544 </xs:complexType>
545 </xs:element>
546
547 <xs:element name="CommandLink">
548 <xs:annotation>
549 <xs:documentation>Defines a button.</xs:documentation>
550 </xs:annotation>
551 <xs:complexType mixed="true">
552 <xs:annotation>
553 <xs:documentation>
554 Text to display in the button.
555 Mutually exclusive with the StringId attribute and child Text elements.
556 </xs:documentation>
557 </xs:annotation>
558 <xs:choice minOccurs="0" maxOccurs="unbounded">
559 <xs:annotation>
560 <xs:documentation>
561 If multiple Action elements are given, the conditions should be mutually exclusive (when multiple conditions are true, the behavior is undefined and could be changed at any time).
562 If none of the conditions of the Action elements are true, then it uses the Action element without the Condition attribute.
563 </xs:documentation>
564 </xs:annotation>
565 <xs:element ref="BrowseDirectoryAction" />
566 <xs:element ref="ChangePageAction" />
567 <xs:element ref="CloseWindowAction" />
568 <xs:element ref="Note" />
569 <xs:element ref="Text" />
570 </xs:choice>
571 <xs:attributeGroup ref="CommonControlAttributes" />
572 <xs:attribute name="FontId" type="xs:string">
573 <xs:annotation>
574 <xs:documentation>Identifier to the Font element that serves as the font for the control. Only valid when using graphic buttons.</xs:documentation>
575 </xs:annotation>
576 </xs:attribute>
577 <xs:attribute name="IconFile" type="xs:string">
578 <xs:annotation>
579 <xs:documentation>
580 Relative path to an icon file to define a command link glyph.
581 Mutually exclusive with IconResource and ImageFile and ImageResource attributes.
582 </xs:documentation>
583 </xs:annotation>
584 </xs:attribute>
585 <xs:attribute name="IconResource" type="xs:string">
586 <xs:annotation>
587 <xs:documentation>
588 Identifier that references an icon resource in the module to define a command link glyph.
589 Mutually exclusive with IconFile and ImageFile and ImageResource attributes.
590 </xs:documentation>
591 </xs:annotation>
592 </xs:attribute>
593 <xs:attribute name="ImageFile" type="xs:string">
594 <xs:annotation>
595 <xs:documentation>
596 Relative path to an image file to define a command link glyph.
597 Mutually exclusive with IconFile and IconResource and ImageResource attributes.
598 </xs:documentation>
599 </xs:annotation>
600 </xs:attribute>
601 <xs:attribute name="ImageResource" type="xs:string">
602 <xs:annotation>
603 <xs:documentation>
604 Identifier that references an image resource in the module to define a command link glyph.
605 Mutually exclusive with IconFile and IconResource and ImageFile attributes.
606 </xs:documentation>
607 </xs:annotation>
608 </xs:attribute>
609 <xs:attribute name="StringId" type="xs:nonNegativeInteger">
610 <xs:annotation>
611 <xs:documentation>
612 Identifier that references a string resource in the module to define the text for the control.
613 </xs:documentation>
614 </xs:annotation>
615 </xs:attribute>
616 </xs:complexType>
617 </xs:element>
618
619 <xs:element name="Editbox">
620 <xs:annotation>
621 <xs:documentation>Defines an edit box.</xs:documentation>
622 </xs:annotation>
623 <xs:complexType mixed="true">
624 <xs:simpleContent>
625 <xs:extension base="xs:string">
626 <xs:annotation>
627 <xs:documentation>
628 Initial text for the control.
629 Mutually exclusive with the StringId attribute and child Text elements.
630 </xs:documentation>
631 </xs:annotation>
632 <xs:attributeGroup ref="CommonControlAttributes" />
633 <xs:attribute name="FileSystemAutoComplete" type="YesNoType">
634 <xs:annotation>
635 <xs:documentation>Specifies whether the edit box should auto-complete with file system paths.</xs:documentation>
636 </xs:annotation>
637 </xs:attribute>
638 <xs:attribute name="FontId" type="xs:string">
639 <xs:annotation>
640 <xs:documentation>Identifier to the Font element that serves as the font for the control.</xs:documentation>
641 </xs:annotation>
642 </xs:attribute>
643 <xs:attribute name="StringId" type="xs:nonNegativeInteger">
644 <xs:annotation>
645 <xs:documentation>
646 Identifier that references a string resource in the module to define the initial text for the control.
647 </xs:documentation>
648 </xs:annotation>
649 </xs:attribute>
650 </xs:extension>
651 </xs:simpleContent>
652 </xs:complexType>
653 </xs:element>
654
655 <xs:element name="Hyperlink">
656 <xs:annotation>
657 <xs:documentation>Defines a hyperlink.</xs:documentation>
658 </xs:annotation>
659 <xs:complexType mixed="true">
660 <xs:annotation>
661 <xs:documentation>
662 Text to display as the link.
663 Mutually exclusive with the StringId attribute and child Text elements.
664 </xs:documentation>
665 </xs:annotation>
666 <xs:choice minOccurs="0" maxOccurs="unbounded">
667 <xs:element ref="Text" />
668 <xs:element ref="Tooltip" maxOccurs="1" />
669 </xs:choice>
670 <xs:attributeGroup ref="CommonControlAttributes" />
671 <xs:attribute name="FontId" type="xs:string">
672 <xs:annotation>
673 <xs:documentation>Identifier to the Font element that serves as the unselected font.</xs:documentation>
674 </xs:annotation>
675 </xs:attribute>
676 <xs:attribute name="HoverFontId" type="xs:string">
677 <xs:annotation>
678 <xs:documentation>Identifier to the Font element that serves as the font when the control is hovered over.</xs:documentation>
679 </xs:annotation>
680 </xs:attribute>
681 <xs:attribute name="SelectedFontId" type="xs:string">
682 <xs:annotation>
683 <xs:documentation>Identifier to the Font element that serves as the font when the control is selected.</xs:documentation>
684 </xs:annotation>
685 </xs:attribute>
686 <xs:attribute name="StringId" type="xs:nonNegativeInteger">
687 <xs:annotation>
688 <xs:documentation>
689 Identifier that references a string resource in the module to define the text for the control.
690 </xs:documentation>
691 </xs:annotation>
692 </xs:attribute>
693 </xs:complexType>
694 </xs:element>
695
696 <xs:element name="Hypertext">
697 <xs:annotation>
698 <xs:documentation>Defines a text block with support for HTML `&lt;a&gt;` tags.</xs:documentation>
699 </xs:annotation>
700 <xs:complexType mixed="true">
701 <xs:annotation>
702 <xs:documentation>
703 Text to display as the link.
704 Use HTML &lt;a href="URL"&gt; to create a link.
705 Mutually exclusive with the StringId attribute and child Text elements.
706 </xs:documentation>
707 </xs:annotation>
708 <xs:choice minOccurs="0" maxOccurs="unbounded">
709 <xs:element ref="Text" />
710 <xs:element ref="Tooltip" maxOccurs="1" />
711 </xs:choice>
712 <xs:attributeGroup ref="CommonControlAttributes" />
713 <xs:attribute name="FontId" type="xs:string">
714 <xs:annotation>
715 <xs:documentation>Identifier to the Font element that serves as the font for the control.</xs:documentation>
716 </xs:annotation>
717 </xs:attribute>
718 <xs:attribute name="StringId" type="xs:nonNegativeInteger">
719 <xs:annotation>
720 <xs:documentation>
721 Identifier that references a string resource in the module to define the text for the control.
722 </xs:documentation>
723 </xs:annotation>
724 </xs:attribute>
725 </xs:complexType>
726 </xs:element>
727
728 <xs:element name="ImageListItem">
729 <xs:annotation>
730 <xs:documentation>Defines an image for an ImageList.</xs:documentation>
731 </xs:annotation>
732 <xs:complexType>
733 <xs:attribute name="ImageFile" type="xs:string">
734 <xs:annotation>
735 <xs:documentation>Relative path to an image file. Mutually exclusive with ImageResource.</xs:documentation>
736 </xs:annotation>
737 </xs:attribute>
738 <xs:attribute name="ImageResource" type="xs:nonNegativeInteger">
739 <xs:annotation>
740 <xs:documentation>Identifier that references an image resource in the module. Mutually exclusive with ImageFile.</xs:documentation>
741 </xs:annotation>
742 </xs:attribute>
743 </xs:complexType>
744 </xs:element>
745
746 <xs:element name="ImageControl">
747 <xs:annotation>
748 <xs:documentation>Defines an image control.</xs:documentation>
749 </xs:annotation>
750 <xs:complexType>
751 <xs:attributeGroup ref="CommonControlAttributes" />
752 <xs:attributeGroup ref="OwnerDrawImageAttributes" />
753 </xs:complexType>
754 </xs:element>
755
756 <xs:element name="Label">
757 <xs:annotation>
758 <xs:documentation>Defines a label.</xs:documentation>
759 </xs:annotation>
760 <xs:complexType mixed="true">
761 <xs:annotation>
762 <xs:documentation>
763 Text for the label to display.
764 Mutually exclusive with the StringId attribute and child Text elements.
765 </xs:documentation>
766 </xs:annotation>
767 <xs:choice minOccurs="0" maxOccurs="unbounded">
768 <xs:element ref="Text" />
769 <xs:element ref="Tooltip" maxOccurs="1" />
770 </xs:choice>
771 <xs:attributeGroup ref="CommonControlAttributes" />
772 <xs:attribute name="Center" type="YesNoType" use="optional">
773 <xs:annotation>
774 <xs:documentation>Specifies whether the text should be centered horizontally in the width of the control. Default is "no".</xs:documentation>
775 </xs:annotation>
776 </xs:attribute>
777 <xs:attribute name="DisablePrefix" type="YesNoType" use="optional">
778 <xs:annotation>
779 <xs:documentation>By default ampersands (&amp;) in the text will underline the next character and treat it as an accelerator key. Set this attribute to "yes" to disable that behavior. Default is "no".</xs:documentation>
780 </xs:annotation>
781 </xs:attribute>
782 <xs:attribute name="FontId" type="xs:string">
783 <xs:annotation>
784 <xs:documentation>Numeric identifier to the Font element that serves as the font for the control.</xs:documentation>
785 </xs:annotation>
786 </xs:attribute>
787 <xs:attribute name="StringId" type="xs:nonNegativeInteger">
788 <xs:annotation>
789 <xs:documentation>
790 Identifier that references a string resource in the module to define the text for the label.
791 </xs:documentation>
792 </xs:annotation>
793 </xs:attribute>
794 </xs:complexType>
795 </xs:element>
796
797 <xs:element name="ListView">
798 <xs:annotation>
799 <xs:documentation>Defines a listview.</xs:documentation>
800 </xs:annotation>
801 <xs:complexType>
802 <xs:choice maxOccurs="unbounded">
803 <xs:element ref="Column" />
804 </xs:choice>
805 <xs:attributeGroup ref="CommonControlAttributes" />
806 <xs:attribute name="FontId" type="xs:string">
807 <xs:annotation>
808 <xs:documentation>Identifier to the Font element that serves as the default font for the ListView.</xs:documentation>
809 </xs:annotation>
810 </xs:attribute>
811 <xs:attribute name="HexExtendedStyle" type="xs:hexBinary">
812 <xs:annotation>
813 <xs:documentation>Hexadecimal extended window style.</xs:documentation>
814 </xs:annotation>
815 </xs:attribute>
816 <xs:attribute name="ImageList" type="xs:string">
817 <xs:annotation>
818 <xs:documentation>
819 The name of the ImageList to assign to this listview with type LVSIL_NORMAL.
820 </xs:documentation>
821 </xs:annotation>
822 </xs:attribute>
823 <xs:attribute name="ImageListSmall" type="xs:string">
824 <xs:annotation>
825 <xs:documentation>
826 The name of the ImageList to assign to this listview with type LVSIL_SMALL.
827 </xs:documentation>
828 </xs:annotation>
829 </xs:attribute>
830 <xs:attribute name="ImageListState" type="xs:string">
831 <xs:annotation>
832 <xs:documentation>
833 The name of the ImageList to assign to this listview with type LVSIL_STATE.
834 </xs:documentation>
835 </xs:annotation>
836 </xs:attribute>
837 <xs:attribute name="ImageListGroupHeader" type="xs:string">
838 <xs:annotation>
839 <xs:documentation>
840 The name of the ImageList to assign to this listview with type LVSIL_GROUPHEADER.
841 </xs:documentation>
842 </xs:annotation>
843 </xs:attribute>
844 </xs:complexType>
845 </xs:element>
846
847 <xs:element name="Note">
848 <xs:annotation>
849 <xs:documentation>
850 Defines note text for a command link control based on an optional condition.
851 If multiple Note elements are given for one control, the conditions should be mutually exclusive (when multiple conditions are true, the behavior is undefined and may be changed at any time).
852 If none of the conditions of a control's Note elements are true, then it uses the text of the Note element without the Condition attribute.
853 </xs:documentation>
854 </xs:annotation>
855 <xs:complexType>
856 <xs:simpleContent>
857 <xs:extension base="xs:string">
858 <xs:annotation>
859 <xs:documentation>
860 Note text for the parent command link control.
861 </xs:documentation>
862 </xs:annotation>
863 <xs:attribute name="Condition" type="xs:string">
864 <xs:annotation>
865 <xs:documentation>
866 The condition that determines when the parent control will use this note text.
867 </xs:documentation>
868 </xs:annotation>
869 </xs:attribute>
870 </xs:extension>
871 </xs:simpleContent>
872 </xs:complexType>
873 </xs:element>
874
875 <xs:element name="Panel">
876 <xs:annotation>
877 <xs:documentation>Defines a collection of controls.</xs:documentation>
878 </xs:annotation>
879 <xs:complexType>
880 <xs:group ref="PanelControlElements" maxOccurs="unbounded"/>
881 <xs:attributeGroup ref="CommonControlAttributes" />
882 </xs:complexType>
883 </xs:element>
884
885 <xs:element name="Progressbar">
886 <xs:annotation>
887 <xs:documentation>
888 Defines a progress bar.
889 </xs:documentation>
890 </xs:annotation>
891 <xs:complexType>
892 <xs:choice minOccurs="0" maxOccurs="unbounded">
893 <xs:element ref="ProgressbarImage" />
894 </xs:choice>
895 <xs:attributeGroup ref="CommonControlAttributes" />
896 </xs:complexType>
897 </xs:element>
898
899 <xs:element name="ProgressbarImage">
900 <xs:annotation>
901 <xs:documentation>
902 Defines a progress bar image.
903 The image must be 4 pixels wide: left pixel is the left side of progress bar, left middle pixel is progress used, right middle pixel is progress unused, right pixel is right side of progress bar.
904 If multiple ProgressbarImages are given, each is assigned an index in document order and can be selected programmatically with ThemeSetProgressControlColor.
905 </xs:documentation>
906 </xs:annotation>
907 <xs:complexType>
908 <xs:attributeGroup ref="OwnerDrawImageAttributes" />
909 </xs:complexType>
910 </xs:element>
911
912 <xs:element name="RadioButton">
913 <xs:annotation>
914 <xs:documentation>Defines an individual radio button within a set of radio buttons.</xs:documentation>
915 </xs:annotation>
916 <xs:complexType mixed="true">
917 <xs:annotation>
918 <xs:documentation>
919 Text to display beside the radio button.
920 Mutually exclusive with the StringId attribute and child Text elements.
921 </xs:documentation>
922 </xs:annotation>
923 <xs:choice minOccurs="0" maxOccurs="unbounded">
924 <xs:element ref="Text" />
925 <xs:element ref="Tooltip" maxOccurs="1" />
926 </xs:choice>
927 <xs:attributeGroup ref="CommonControlAttributes" />
928 <xs:attribute name="FontId" type="xs:string">
929 <xs:annotation>
930 <xs:documentation>Identifier to the Font element that serves as the font for the control.</xs:documentation>
931 </xs:annotation>
932 </xs:attribute>
933 <xs:attribute name="StringId" type="xs:nonNegativeInteger">
934 <xs:annotation>
935 <xs:documentation>
936 Identifier that references a string resource in the module to define the text for the control.
937 </xs:documentation>
938 </xs:annotation>
939 </xs:attribute>
940 <xs:attribute name="Value" type="xs:string">
941 <xs:annotation>
942 <xs:documentation>Optional value used when setting the variable associated with the set of radio buttons.</xs:documentation>
943 </xs:annotation>
944 </xs:attribute>
945 </xs:complexType>
946 </xs:element>
947
948 <xs:element name="RadioButtons">
949 <xs:annotation>
950 <xs:documentation>Defines a set of radio buttons.</xs:documentation>
951 </xs:annotation>
952 <xs:complexType>
953 <xs:choice maxOccurs="unbounded">
954 <xs:element ref="RadioButton" />
955 </xs:choice>
956 <xs:attribute name="Name" type="xs:string">
957 <xs:annotation>
958 <xs:documentation>Optional variable name for the set of radio buttons.</xs:documentation>
959 </xs:annotation>
960 </xs:attribute>
961 </xs:complexType>
962 </xs:element>
963
964 <xs:element name="Richedit">
965 <xs:annotation>
966 <xs:documentation>Defines a rich edit control.</xs:documentation>
967 </xs:annotation>
968 <xs:complexType mixed="true">
969 <xs:annotation>
970 <xs:documentation>
971 Initial text for the control.
972 Mutually exclusive with the StringId attribute.
973 </xs:documentation>
974 </xs:annotation>
975 <xs:choice minOccurs="0" maxOccurs="unbounded">
976 <xs:element ref="Text" />
977 <xs:element ref="Tooltip" maxOccurs="1" />
978 </xs:choice>
979 <xs:attributeGroup ref="CommonControlAttributes" />
980 <xs:attribute name="FontId" type="xs:string">
981 <xs:annotation>
982 <xs:documentation>
983 Identifier to the Font element that serves as the font for the control.
984 </xs:documentation>
985 </xs:annotation>
986 </xs:attribute>
987 <xs:attribute name="StringId" type="xs:nonNegativeInteger">
988 <xs:annotation>
989 <xs:documentation>
990 Identifier that references a string resource in the module to define the initial text for the control.
991 </xs:documentation>
992 </xs:annotation>
993 </xs:attribute>
994 </xs:complexType>
995 </xs:element>
996
997 <xs:element name="Static">
998 <xs:annotation>
999 <xs:documentation>Defines a straight line.</xs:documentation>
1000 </xs:annotation>
1001 <xs:complexType>
1002 <xs:attributeGroup ref="CommonControlAttributes" />
1003 </xs:complexType>
1004 </xs:element>
1005
1006 <xs:element name="Tab">
1007 <xs:annotation>
1008 <xs:documentation>Defines an individual tab within a set of tabs.</xs:documentation>
1009 </xs:annotation>
1010 <xs:complexType>
1011 <xs:simpleContent>
1012 <xs:extension base="xs:string">
1013 <xs:annotation>
1014 <xs:documentation>
1015 Caption of the tab.
1016 Mutually exclusive with the StringId attribute.
1017 </xs:documentation>
1018 </xs:annotation>
1019 <xs:attribute name="StringId" type="xs:nonNegativeInteger">
1020 <xs:annotation>
1021 <xs:documentation>
1022 Identifier that references a string resource in the module to define the caption of the tab.
1023 </xs:documentation>
1024 </xs:annotation>
1025 </xs:attribute>
1026 </xs:extension>
1027 </xs:simpleContent>
1028 </xs:complexType>
1029 </xs:element>
1030
1031 <xs:element name="Tabs">
1032 <xs:annotation>
1033 <xs:documentation>Defines a set of tabs.</xs:documentation>
1034 </xs:annotation>
1035 <xs:complexType>
1036 <xs:choice maxOccurs="unbounded">
1037 <xs:element ref="Tab" />
1038 </xs:choice>
1039 <xs:attributeGroup ref="CommonControlAttributes" />
1040 <xs:attribute name="FontId" type="xs:string">
1041 <xs:annotation>
1042 <xs:documentation>Identifier to the Font element that serves as the font for the control.</xs:documentation>
1043 </xs:annotation>
1044 </xs:attribute>
1045 </xs:complexType>
1046 </xs:element>
1047
1048 <xs:element name="Text">
1049 <xs:annotation>
1050 <xs:documentation>
1051 Defines text for the parent control based on an optional condition.
1052 If multiple Text elements are given for one control, the conditions should be mutually exclusive (when multiple conditions are true, the behavior is undefined and may be changed at any time).
1053 If none of the conditions of a control's Text elements are true, then it uses the text of the Text element without the Condition attribute.
1054 </xs:documentation>
1055 </xs:annotation>
1056 <xs:complexType>
1057 <xs:simpleContent>
1058 <xs:extension base="xs:string">
1059 <xs:annotation>
1060 <xs:documentation>
1061 Text for the parent control.
1062 </xs:documentation>
1063 </xs:annotation>
1064 <xs:attribute name="Condition" type="xs:string">
1065 <xs:annotation>
1066 <xs:documentation>
1067 The condition that determines when the parent control will use this text.
1068 </xs:documentation>
1069 </xs:annotation>
1070 </xs:attribute>
1071 </xs:extension>
1072 </xs:simpleContent>
1073 </xs:complexType>
1074 </xs:element>
1075
1076 <xs:element name="Tooltip">
1077 <xs:annotation>
1078 <xs:documentation>
1079 Defines text for the parent control's tooltip.
1080 </xs:documentation>
1081 </xs:annotation>
1082 <xs:complexType>
1083 <xs:simpleContent>
1084 <xs:extension base="xs:string">
1085 <xs:annotation>
1086 <xs:documentation>
1087 Text for the parent control's tooltip.
1088 </xs:documentation>
1089 </xs:annotation>
1090 </xs:extension>
1091 </xs:simpleContent>
1092 </xs:complexType>
1093 </xs:element>
1094
1095 <xs:element name="TreeView">
1096 <xs:annotation>
1097 <xs:documentation>Defines a treeview.</xs:documentation>
1098 </xs:annotation>
1099 <xs:complexType>
1100 <xs:attributeGroup ref="CommonControlAttributes"/>
1101 <xs:attribute name="AlwaysShowSelect">
1102 <xs:annotation>
1103 <xs:documentation>Specifies whether the row always appears selected even when the treeview has lost focus.</xs:documentation>
1104 </xs:annotation>
1105 </xs:attribute>
1106 <xs:attribute name="EnableDragDrop">
1107 <xs:annotation>
1108 <xs:documentation>Specifies whether drag and drop is enabled for the treeview.</xs:documentation>
1109 </xs:annotation>
1110 </xs:attribute>
1111 <xs:attribute name="FullRowSelect">
1112 <xs:annotation>
1113 <xs:documentation>Specifies whether an entire row is selected for the treeview.</xs:documentation>
1114 </xs:annotation>
1115 </xs:attribute>
1116 <xs:attribute name="HasButtons">
1117 <xs:annotation>
1118 <xs:documentation>Specifies whether the treeview will show buttons.</xs:documentation>
1119 </xs:annotation>
1120 </xs:attribute>
1121 <xs:attribute name="HasLines">
1122 <xs:annotation>
1123 <xs:documentation>Specifies whether lines appear for all treeview items.</xs:documentation>
1124 </xs:annotation>
1125 </xs:attribute>
1126 <xs:attribute name="LinesAtRoot">
1127 <xs:annotation>
1128 <xs:documentation>Specifies whether the root nodes have lines beside them.</xs:documentation>
1129 </xs:annotation>
1130 </xs:attribute>
1131 </xs:complexType>
1132 </xs:element>
1133
1134 <xs:element name="Column">
1135 <xs:annotation>
1136 <xs:documentation>A column of a list.</xs:documentation>
1137 </xs:annotation>
1138 <xs:complexType>
1139 <xs:simpleContent>
1140 <xs:extension base="xs:string">
1141 <xs:annotation>
1142 <xs:documentation>
1143 Text for the column header.
1144 Mutually exclusive with the StringId attribute.
1145 </xs:documentation>
1146 </xs:annotation>
1147 <xs:attribute name="Width" type="xs:int">
1148 <xs:annotation>
1149 <xs:documentation>Width of the column.</xs:documentation>
1150 </xs:annotation>
1151 </xs:attribute>
1152 <xs:attribute name="Expands" type="YesNoType">
1153 <xs:annotation>
1154 <xs:documentation>
1155 Whether or not this column can grow to fill available width of the listview.
1156 More than one column can be marked with yes - all expandable columns will share available extra space.
1157 This is especially useful if the Window/@AutoResize is yes.
1158 </xs:documentation>
1159 </xs:annotation>
1160 </xs:attribute>
1161 <xs:attribute name="StringId" type="xs:nonNegativeInteger">
1162 <xs:annotation>
1163 <xs:documentation>
1164 Identifier that references a string resource in the module to define the text for the column header.
1165 </xs:documentation>
1166 </xs:annotation>
1167 </xs:attribute>
1168 </xs:extension>
1169 </xs:simpleContent>
1170 </xs:complexType>
1171 </xs:element>
1172
1173 <xs:group name="ControlElements">
1174 <xs:choice>
1175 <xs:element ref="Billboard" />
1176 <xs:element ref="Button" />
1177 <xs:element ref="Checkbox" />
1178 <xs:element ref="Combobox" />
1179 <xs:element ref="CommandLink" />
1180 <xs:element ref="Editbox" />
1181 <xs:element ref="Hyperlink" />
1182 <xs:element ref="Hypertext" />
1183 <xs:element ref="ImageControl" />
1184 <xs:element ref="Label" />
1185 <xs:element ref="ListView" />
1186 <xs:element ref="Panel" />
1187 <xs:element ref="Progressbar" />
1188 <xs:element ref="RadioButtons" />
1189 <xs:element ref="Richedit" />
1190 <xs:element ref="Static" />
1191 <xs:element ref="Tabs" />
1192 <xs:element ref="TreeView" />
1193 </xs:choice>
1194 </xs:group>
1195
1196 <xs:group name="PanelControlElements">
1197 <xs:choice>
1198 <xs:element ref="Hyperlink" />
1199 <xs:element ref="Hypertext" />
1200 <xs:element ref="ImageControl" />
1201 <xs:element ref="Label" />
1202 <xs:element ref="Progressbar" />
1203 <xs:element ref="Static" />
1204 </xs:choice>
1205 </xs:group>
1206
1207 <xs:attributeGroup name="CommonControlAttributes">
1208 <xs:attribute name="Name" type="xs:string">
1209 <xs:annotation>
1210 <xs:documentation>
1211 Optional name for the control.
1212
1213 If the ThmUtil variable callback system has been configured, such as by
1214 WixStandardBootstrapperApplication, ThmUtil uses the control name to
1215 find a matching variable name. ThmUtil retrieves the variable's value
1216 to set the initial value of the control and sets the variable's value
1217 when the user interacts with the control.
1218
1219 For example, a checkbox control is checked when the matching variable
1220 has a nonzero value and unchecked for a value of `0`. When the user
1221 checks a checkbox control, ThmUtil sets the variable value to a nonzero
1222 value (currently `1`) and to `0` if the checkbox is unchecked.
1223
1224 An edit box control gets its initial value from a matching variable
1225 value. The control value is saved to the variable when navigating away
1226 from the page or when choosing a folder via an associated Browse button.
1227 </xs:documentation>
1228 </xs:annotation>
1229 </xs:attribute>
1230 <xs:attribute name="EnableCondition" type="xs:string">
1231 <xs:annotation>
1232 <xs:documentation>A condition that determines if the control is enabled. If this condition is true or omitted, then the control will be enabled.</xs:documentation>
1233 </xs:annotation>
1234 </xs:attribute>
1235 <xs:attribute name="Height" type="xs:int" use="required">
1236 <xs:annotation>
1237 <xs:documentation>Height of the control. Non-positive values extend the control to the bottom of the window minus the value. A zero value extends the control to the bottom of the window.</xs:documentation>
1238 </xs:annotation>
1239 </xs:attribute>
1240 <xs:attribute name="HexStyle" type="xs:hexBinary">
1241 <xs:annotation>
1242 <xs:documentation>Hexadecimal window style for the control.</xs:documentation>
1243 </xs:annotation>
1244 </xs:attribute>
1245 <xs:attribute name="HideWhenDisabled" type="YesNoType">
1246 <xs:annotation>
1247 <xs:documentation>Specifies whether the control should be hidden when disabled.</xs:documentation>
1248 </xs:annotation>
1249 </xs:attribute>
1250 <xs:attribute name="TabStop" type="YesNoType">
1251 <xs:annotation>
1252 <xs:documentation>Specifies whether the control is part of the tab sequence of controls.</xs:documentation>
1253 </xs:annotation>
1254 </xs:attribute>
1255 <xs:attribute name="Visible" type="YesNoType">
1256 <xs:annotation>
1257 <xs:documentation>Specifies whether the control is initially visible.</xs:documentation>
1258 </xs:annotation>
1259 </xs:attribute>
1260 <xs:attribute name="VisibleCondition" type="xs:string">
1261 <xs:annotation>
1262 <xs:documentation>
1263 A condition that determines if the control is visible. If this condition is true or omitted, then the control will be visible.
1264 </xs:documentation>
1265 </xs:annotation>
1266 </xs:attribute>
1267 <xs:attribute name="Width" type="xs:int" use="required">
1268 <xs:annotation>
1269 <xs:documentation>Width of the control. Non-positive values extend the control to the right of the window minus the value. A zero value extends the control to the right of the window.</xs:documentation>
1270 </xs:annotation>
1271 </xs:attribute>
1272 <xs:attribute name="X" type="xs:int" use="required">
1273 <xs:annotation>
1274 <xs:documentation>X coordinate for the control from the left of the window. Negative values are coordinates from the right of the window minus the width of the control.</xs:documentation>
1275 </xs:annotation>
1276 </xs:attribute>
1277 <xs:attribute name="Y" type="xs:int" use="required">
1278 <xs:annotation>
1279 <xs:documentation>Y coordinate for the control from the top of the window. Negative values are coordinates from the bottom of the window minus the height of the control.</xs:documentation>
1280 </xs:annotation>
1281 </xs:attribute>
1282 </xs:attributeGroup>
1283
1284 <xs:attributeGroup name="OwnerDrawImageAttributes">
1285 <xs:attribute name="ImageId" type="xs:string">
1286 <xs:annotation>
1287 <xs:documentation>
1288 Identifier to the Image element that serves as the image for the control.
1289 Mutually exclusive with ImageFile and ImageResource and SourceX and SourceY attributes.
1290 </xs:documentation>
1291 </xs:annotation>
1292 </xs:attribute>
1293 <xs:attribute name="ImageFile" type="xs:string">
1294 <xs:annotation>
1295 <xs:documentation>
1296 Relative path to an image file for the control.
1297 Mutually exclusive with ImageId and ImageResource and SourceX and SourceY attributes.
1298 </xs:documentation>
1299 </xs:annotation>
1300 </xs:attribute>
1301 <xs:attribute name="ImageResource" type="xs:nonNegativeInteger">
1302 <xs:annotation>
1303 <xs:documentation>
1304 Identifier that references an image resource with type RT_RCDATA in the module for the control.
1305 Mutually exclusive with ImageId and ImageFile and SourceX and SourceY attributes.
1306 </xs:documentation>
1307 </xs:annotation>
1308 </xs:attribute>
1309 <xs:attribute name="SourceX" type="xs:nonNegativeInteger">
1310 <xs:annotation>
1311 <xs:documentation>
1312 X offset of the Theme/@ImageFile or Theme/@ImageResource.
1313 Can only be specified with Theme/@ImageFile or Theme/@ImageResource.
1314 Mutually exclusive with ImageId and ImageFile and ImageResource attributes.
1315 </xs:documentation>
1316 </xs:annotation>
1317 </xs:attribute>
1318 <xs:attribute name="SourceY" type="xs:nonNegativeInteger">
1319 <xs:annotation>
1320 <xs:documentation>
1321 Y offset of the Theme/@ImageFile or Theme/@ImageResource.
1322 Can only be specified with Theme/@ImageFile or Theme/@ImageResource.
1323 Mutually exclusive with ImageId and ImageFile and ImageResource attributes.
1324 </xs:documentation>
1325 </xs:annotation>
1326 </xs:attribute>
1327 </xs:attributeGroup>
1328
1329 <xs:simpleType name="YesNoType">
1330 <xs:annotation>
1331 <xs:documentation>Values of this type will either be "yes" or "no".</xs:documentation>
1332 </xs:annotation>
1333 <xs:restriction base="xs:NMTOKEN">
1334 <xs:enumeration value="no"/>
1335 <xs:enumeration value="yes"/>
1336 </xs:restriction>
1337 </xs:simpleType>
1338
1339 <xs:simpleType name="SystemColorType">
1340 <xs:annotation>
1341 <xs:documentation>
1342 Indicates a system color for a font.
1343 </xs:documentation>
1344 </xs:annotation>
1345 <xs:restriction base="xs:NMTOKEN">
1346 <xs:enumeration value="btnface" />
1347 <xs:enumeration value="btntext" />
1348 <xs:enumeration value="graytext" />
1349 <xs:enumeration value="highlight" />
1350 <xs:enumeration value="highlighttext" />
1351 <xs:enumeration value="hotlight" />
1352 <xs:enumeration value="window" />
1353 <xs:enumeration value="windowtext" />
1354 </xs:restriction>
1355 </xs:simpleType>
1356
1357 <xs:simpleType name="FontColorType">
1358 <xs:annotation>
1359 <xs:documentation>
1360 Indicates the foreground or background color of a font.
1361 </xs:documentation>
1362 </xs:annotation>
1363 <xs:union memberTypes="SystemColorType xs:string"/>
1364 </xs:simpleType>
1365</xs:schema>
diff --git a/src/xsd/ui.xsd b/src/xsd/ui.xsd
new file mode 100644
index 00000000..bfb9c39f
--- /dev/null
+++ b/src/xsd/ui.xsd
@@ -0,0 +1,69 @@
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 xmlns:wxs="http://wixtoolset.org/schemas/v4/wxs"
9 targetNamespace="http://wixtoolset.org/schemas/v4/wxs/ui"
10 xmlns="http://wixtoolset.org/schemas/v4/wxs/ui">
11 <xs:annotation>
12 <xs:documentation>
13 The source code schema for the WiX Toolset UI Extension.
14 </xs:documentation>
15 </xs:annotation>
16
17 <xs:import namespace="http://wixtoolset.org/schemas/v4/wxs" />
18
19 <xs:element name="WixUI">
20 <xs:annotation>
21 <xs:appinfo>
22 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
23 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Module" />
24 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Package" />
25 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="PatchFamily" />
26 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="UI" />
27 </xs:appinfo>
28 <xs:documentation>
29 References a WixUI dialog set, either one that's included in WixToolset.UI.wixext or a
30 custom dialog set included in your authoring.
31 </xs:documentation>
32 </xs:annotation>
33 <xs:complexType>
34 <xs:choice minOccurs="0" maxOccurs="unbounded">
35 <xs:any namespace="##other" processContents="lax">
36 <xs:annotation>
37 <xs:documentation>
38 Extensibility point in the WiX XML Schema. Schema extensions can register additional
39 elements at this point in the schema.
40 </xs:documentation>
41 </xs:annotation>
42 </xs:any>
43 </xs:choice>
44 <xs:attribute name="Id" type="xs:string" use="required">
45 <xs:annotation>
46 <xs:documentation>
47 Identifier for the dialog set to reference.
48 </xs:documentation>
49 </xs:annotation>
50 </xs:attribute>
51 <xs:attribute name="InstallDirectory" type="xs:string">
52 <xs:annotation>
53 <xs:documentation>
54 An optional identifier that specifies the directory to set WIXUI_INSTALLDIR to,
55 for WixUI dialog sets that require it.
56 </xs:documentation>
57 </xs:annotation>
58 </xs:attribute>
59 <xs:anyAttribute namespace="##other" processContents="lax">
60 <xs:annotation>
61 <xs:documentation>
62 Extensibility point in the WiX XML Schema. Schema extensions can register additional
63 attributes at this point in the schema.
64 </xs:documentation>
65 </xs:annotation>
66 </xs:anyAttribute>
67 </xs:complexType>
68 </xs:element>
69</xs:schema>
diff --git a/src/xsd/util.xsd b/src/xsd/util.xsd
new file mode 100644
index 00000000..1b649f48
--- /dev/null
+++ b/src/xsd/util.xsd
@@ -0,0 +1,2536 @@
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 xmlns:wxs="http://wixtoolset.org/schemas/v4/wxs"
9 targetNamespace="http://wixtoolset.org/schemas/v4/wxs/util"
10 xmlns="http://wixtoolset.org/schemas/v4/wxs/util">
11 <xs:annotation>
12 <xs:documentation>
13 The source code schema for the WiX Toolset Utility Extension.
14 </xs:documentation>
15 </xs:annotation>
16
17 <xs:import namespace="http://wixtoolset.org/schemas/v4/wxs" />
18
19 <xs:element name="CloseApplication">
20 <xs:annotation>
21 <xs:appinfo>
22 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Bundle" />
23 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Package" />
24 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Module" />
25 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
26 </xs:appinfo>
27 <xs:documentation>Closes applications or schedules a reboot if application cannot be closed.</xs:documentation>
28 </xs:annotation>
29 <xs:complexType>
30 <xs:choice minOccurs="0" maxOccurs="unbounded">
31 <xs:any namespace="##other" processContents="lax">
32 <xs:annotation>
33 <xs:documentation>
34 Extensibility point in the WiX XML Schema. Schema extensions can register additional
35 elements at this point in the schema.
36 </xs:documentation>
37 </xs:annotation>
38 </xs:any>
39 </xs:choice>
40 <xs:attribute name="Id" type="xs:string">
41 <xs:annotation>
42 <xs:documentation>Identifier for the close application (primary key). If the Id is not specified, one will be generated.</xs:documentation>
43 </xs:annotation>
44 </xs:attribute>
45 <xs:attribute name="Target" type="xs:string" use="required">
46 <xs:annotation>
47 <xs:documentation>Name of the exectuable to be closed. This should only be the file name.</xs:documentation>
48 </xs:annotation>
49 </xs:attribute>
50 <xs:attribute name="Condition" type="xs:string">
51 <xs:annotation>
52 <xs:documentation>
53 Condition that determines if the application should be closed. Must be blank or evaluate to true
54 for the application to be scheduled for closing.
55 </xs:documentation>
56 </xs:annotation>
57 </xs:attribute>
58 <xs:attribute name="Description" type="xs:string">
59 <xs:annotation>
60 <xs:documentation>Description to show if application is running and needs to be closed.</xs:documentation>
61 </xs:annotation>
62 </xs:attribute>
63 <xs:attribute name="Sequence" type="wxs:Integer">
64 <xs:annotation>
65 <xs:documentation>Optionally orders the applications to be closed.</xs:documentation>
66 </xs:annotation>
67 </xs:attribute>
68 <xs:attribute name="CloseMessage" type="wxs:YesNoTypeUnion">
69 <xs:annotation>
70 <xs:documentation>Optionally sends a close message to the application. Default is no.</xs:documentation>
71 </xs:annotation>
72 </xs:attribute>
73 <xs:attribute name="EndSessionMessage" type="wxs:YesNoTypeUnion">
74 <xs:annotation>
75 <xs:documentation>Sends WM_QUERYENDSESSION then WM_ENDSESSION messages to the application. Default is "no".</xs:documentation>
76 </xs:annotation>
77 </xs:attribute>
78 <xs:attribute name="ElevatedCloseMessage" type="wxs:YesNoTypeUnion">
79 <xs:annotation>
80 <xs:documentation>Optionally sends a close message to the application from deffered action without impersonation. Default is no.</xs:documentation>
81 </xs:annotation>
82 </xs:attribute>
83 <xs:attribute name="ElevatedEndSessionMessage" type="wxs:YesNoTypeUnion">
84 <xs:annotation>
85 <xs:documentation>Sends WM_QUERYENDSESSION then WM_ENDSESSION messages to the application from a deffered action without impersonation. Default is "no".</xs:documentation>
86 </xs:annotation>
87 </xs:attribute>
88 <xs:attribute name="RebootPrompt" type="wxs:YesNoTypeUnion">
89 <xs:annotation>
90 <xs:documentation>
91 Optionally prompts for reboot if application is still running.
92 The TerminateProcess attribute must be "no" or not specified if this attribute is "yes".
93 The default is "yes".
94 </xs:documentation>
95 </xs:annotation>
96 </xs:attribute>
97 <xs:attribute name="PromptToContinue" type="wxs:YesNoTypeUnion">
98 <xs:annotation>
99 <xs:documentation>
100 When this attribute is set to "yes", the user will be prompted when the application is still running. The Description attribute must contain the message to
101 display in the prompt. The prompt occurs before executing any of the other options and gives the options to "Abort", "Retry", or "Ignore". Abort will cancel
102 the install. Retry will attempt the check again and if the application is still running, prompt again. "Ignore" will continue and execute any other options
103 set on the CloseApplication element. The default is "no".
104 </xs:documentation>
105 </xs:annotation>
106 </xs:attribute>
107 <xs:attribute name="Property" type="xs:string">
108 <xs:annotation>
109 <xs:documentation>Property to be set if application is still running. Useful for launch conditions or to conditionalize custom UI to ask user to shut down apps.</xs:documentation>
110 </xs:annotation>
111 </xs:attribute>
112 <xs:attribute name="TerminateProcess" type="wxs:Integer">
113 <xs:annotation>
114 <xs:documentation>
115 Attempts to terminates process and return the attribute value as the process's exit code if the application is still running after sending any requested close and/or end session messages.
116 If this attribute is specified, the RebootPrompt attribute must be "no".
117 </xs:documentation>
118 </xs:annotation>
119 </xs:attribute>
120 <xs:attribute name="Timeout" type="wxs:Integer">
121 <xs:annotation>
122 <xs:documentation>
123 Optional time in seconds to wait for the application to exit after the close and/or end session messages. If the application is still running after the timeout then
124 the RebootPrompt or TerminateProcess attributes will be considered. The default value is "5" seconds.
125 </xs:documentation>
126 </xs:annotation>
127 </xs:attribute>
128 <xs:anyAttribute namespace="##other" processContents="lax">
129 <xs:annotation>
130 <xs:documentation>
131 Extensibility point in the WiX XML Schema. Schema extensions can register additional
132 attributes at this point in the schema.
133 </xs:documentation>
134 </xs:annotation>
135 </xs:anyAttribute>
136 </xs:complexType>
137 </xs:element>
138
139 <xs:element name="ComponentSearch">
140 <xs:annotation>
141 <xs:documentation>Describes a component search.</xs:documentation>
142 <xs:appinfo>
143 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Bundle" />
144 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
145 </xs:appinfo>
146 </xs:annotation>
147 <xs:complexType>
148 <xs:choice minOccurs="0" maxOccurs="unbounded">
149 <xs:any namespace="##other" processContents="lax">
150 <xs:annotation>
151 <xs:documentation>
152 Extensibility point in the WiX XML Schema. Schema extensions can register additional
153 elements at this point in the schema.
154 </xs:documentation>
155 </xs:annotation>
156 </xs:any>
157 </xs:choice>
158 <xs:attributeGroup ref="SearchCommonAttributes" />
159 <xs:attribute name="Guid" type="xs:string" use="required">
160 <xs:annotation>
161 <xs:documentation>Component to search for.</xs:documentation>
162 </xs:annotation>
163 </xs:attribute>
164 <xs:attribute name="ProductCode" type="xs:string">
165 <xs:annotation>
166 <xs:documentation>Optional ProductCode to determine if the component is installed.</xs:documentation>
167 </xs:annotation>
168 </xs:attribute>
169 <xs:attribute name="Result">
170 <xs:annotation>
171 <xs:documentation>
172 Rather than saving the matching key path into the variable, a ComponentSearch can save an attribute of the component instead.
173 </xs:documentation>
174 </xs:annotation>
175 <xs:simpleType>
176 <xs:restriction base="xs:NMTOKEN">
177 <xs:enumeration value="directory">
178 <xs:annotation>
179 <xs:documentation>Saves the parent directory for the component's file key path; other types of key path are returned unmodified.</xs:documentation>
180 </xs:annotation>
181 </xs:enumeration>
182 <xs:enumeration value="keyPath">
183 <xs:annotation>
184 <xs:documentation>Saves the key path of the component if installed. This is the default.</xs:documentation>
185 </xs:annotation>
186 </xs:enumeration>
187 <xs:enumeration value="state">
188 <xs:annotation>
189 <xs:documentation>Saves the state of the component: absent (2), locally installed (3), will run from source (4), or installed in default location (either local or from source) (5)</xs:documentation>
190 </xs:annotation>
191 </xs:enumeration>
192 </xs:restriction>
193 </xs:simpleType>
194 </xs:attribute>
195 <xs:anyAttribute namespace="##other" processContents="lax">
196 <xs:annotation>
197 <xs:documentation>
198 Extensibility point in the WiX XML Schema. Schema extensions can register additional
199 attributes at this point in the schema.
200 </xs:documentation>
201 </xs:annotation>
202 </xs:anyAttribute>
203 </xs:complexType>
204 </xs:element>
205
206 <xs:element name="ComponentSearchRef">
207 <xs:annotation>
208 <xs:documentation>References a ComponentSearch.</xs:documentation>
209 <xs:appinfo>
210 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Bundle" />
211 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
212 </xs:appinfo>
213 </xs:annotation>
214 <xs:complexType>
215 <xs:choice minOccurs="0" maxOccurs="unbounded">
216 <xs:any namespace="##other" processContents="lax">
217 <xs:annotation>
218 <xs:documentation>
219 Extensibility point in the WiX XML Schema. Schema extensions can register additional
220 elements at this point in the schema.
221 </xs:documentation>
222 </xs:annotation>
223 </xs:any>
224 </xs:choice>
225 <xs:attribute name="Id" type="xs:string" use="required" />
226 <xs:anyAttribute namespace="##other" processContents="lax">
227 <xs:annotation>
228 <xs:documentation>
229 Extensibility point in the WiX XML Schema. Schema extensions can register additional
230 attributes at this point in the schema.
231 </xs:documentation>
232 </xs:annotation>
233 </xs:anyAttribute>
234 </xs:complexType>
235 </xs:element>
236
237 <xs:element name="DirectorySearch">
238 <xs:annotation>
239 <xs:documentation>Describes a directory search.</xs:documentation>
240 <xs:appinfo>
241 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Bundle" />
242 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
243 </xs:appinfo>
244 </xs:annotation>
245 <xs:complexType>
246 <xs:choice minOccurs="0" maxOccurs="unbounded">
247 <xs:any namespace="##other" processContents="lax">
248 <xs:annotation>
249 <xs:documentation>
250 Extensibility point in the WiX XML Schema. Schema extensions can register additional
251 elements at this point in the schema.
252 </xs:documentation>
253 </xs:annotation>
254 </xs:any>
255 </xs:choice>
256 <xs:attributeGroup ref="SearchCommonAttributes" />
257 <xs:attribute name="Path" type="xs:string">
258 <xs:annotation>
259 <xs:documentation>Directory path to search for.</xs:documentation>
260 </xs:annotation>
261 </xs:attribute>
262 <xs:attribute name="DisableFileRedirection" type="wxs:YesNoTypeUnion">
263 <xs:annotation>
264 <xs:documentation>When set to "yes" and the running bundle is 32-bit, Wow64DisableWow64FsRedirection is called before starting the search.</xs:documentation>
265 </xs:annotation>
266 </xs:attribute>
267 <xs:attribute name="Result">
268 <xs:annotation>
269 <xs:documentation>
270 Rather than saving the matching directory path into the variable, a DirectorySearch can save an
271 attribute of the matching directory instead.
272 </xs:documentation>
273 </xs:annotation>
274 <xs:simpleType>
275 <xs:restriction base="xs:NMTOKEN">
276 <xs:enumeration value="exists">
277 <xs:annotation>
278 <xs:documentation>Saves true if a matching directory is found; false otherwise.</xs:documentation>
279 </xs:annotation>
280 </xs:enumeration>
281 </xs:restriction>
282 </xs:simpleType>
283 </xs:attribute>
284 <xs:anyAttribute namespace="##other" processContents="lax">
285 <xs:annotation>
286 <xs:documentation>
287 Extensibility point in the WiX XML Schema. Schema extensions can register additional
288 attributes at this point in the schema.
289 </xs:documentation>
290 </xs:annotation>
291 </xs:anyAttribute>
292 </xs:complexType>
293 </xs:element>
294
295 <xs:element name="DirectorySearchRef">
296 <xs:annotation>
297 <xs:documentation>References a DirectorySearch.</xs:documentation>
298 <xs:appinfo>
299 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Bundle" />
300 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
301 </xs:appinfo>
302 </xs:annotation>
303 <xs:complexType>
304 <xs:choice minOccurs="0" maxOccurs="unbounded">
305 <xs:any namespace="##other" processContents="lax">
306 <xs:annotation>
307 <xs:documentation>
308 Extensibility point in the WiX XML Schema. Schema extensions can register additional
309 elements at this point in the schema.
310 </xs:documentation>
311 </xs:annotation>
312 </xs:any>
313 </xs:choice>
314 <xs:attribute name="Id" type="xs:string" use="required" />
315 <xs:anyAttribute namespace="##other" processContents="lax">
316 <xs:annotation>
317 <xs:documentation>
318 Extensibility point in the WiX XML Schema. Schema extensions can register additional
319 attributes at this point in the schema.
320 </xs:documentation>
321 </xs:annotation>
322 </xs:anyAttribute>
323 </xs:complexType>
324 </xs:element>
325
326 <xs:element name="EventSource">
327 <xs:annotation>
328 <xs:appinfo>
329 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
330 </xs:appinfo>
331 <xs:documentation>Creates an event source.</xs:documentation>
332 </xs:annotation>
333 <xs:complexType>
334 <xs:choice minOccurs="0" maxOccurs="unbounded">
335 <xs:any namespace="##other" processContents="lax">
336 <xs:annotation>
337 <xs:documentation>
338 Extensibility point in the WiX XML Schema. Schema extensions can register additional
339 elements at this point in the schema.
340 </xs:documentation>
341 </xs:annotation>
342 </xs:any>
343 </xs:choice>
344 <xs:attribute name="CategoryCount" type="wxs:Integer">
345 <xs:annotation>
346 <xs:documentation>
347 The number of categories in CategoryMessageFile. CategoryMessageFile
348 must be specified too.
349 </xs:documentation>
350 </xs:annotation>
351 </xs:attribute>
352 <xs:attribute name="CategoryMessageFile" type="xs:string">
353 <xs:annotation>
354 <xs:documentation>
355 Name of the category message file. CategoryCount must be specified too.
356 Note that this is a formatted field, so you can use [#fileId] syntax to
357 refer to a file being installed. It is also written as a REG_EXPAND_SZ
358 string, so you can use %environment_variable% syntax to refer to a file
359 already present on the user's machine.
360 </xs:documentation>
361 </xs:annotation>
362 </xs:attribute>
363 <xs:attribute name="EventMessageFile" type="xs:string" use="required">
364 <xs:annotation>
365 <xs:documentation>
366 Name of the event message file.
367 Note that this is a formatted field, so you can use [#fileId] syntax to
368 refer to a file being installed. It is also written as a REG_EXPAND_SZ
369 string, so you can use %environment_variable% syntax to refer to a file
370 already present on the user's machine.
371 </xs:documentation>
372 </xs:annotation>
373 </xs:attribute>
374 <xs:attribute name="KeyPath" type="wxs:YesNoTypeUnion">
375 <xs:annotation>
376 <xs:documentation>
377 Marks the EventSource registry as the key path of the component it belongs to.
378 </xs:documentation>
379 </xs:annotation>
380 </xs:attribute>
381 <xs:attribute name="Log" type="xs:string" use="required">
382 <xs:annotation>
383 <xs:documentation>Name of the event source's log. The "Security" log is not support.</xs:documentation>
384 </xs:annotation>
385 </xs:attribute>
386 <xs:attribute name="Name" type="xs:string" use="required">
387 <xs:annotation>
388 <xs:documentation>Name of the event source.</xs:documentation>
389 </xs:annotation>
390 </xs:attribute>
391 <xs:attribute name="ParameterMessageFile" type="xs:string">
392 <xs:annotation>
393 <xs:documentation>
394 Name of the parameter message file.
395 Note that this is a formatted field, so you can use [#fileId] syntax to
396 refer to a file being installed. It is also written as a REG_EXPAND_SZ
397 string, so you can use %environment_variable% syntax to refer to a file
398 already present on the user's machine.
399 </xs:documentation>
400 </xs:annotation>
401 </xs:attribute>
402 <xs:attribute name="SupportsErrors" type="wxs:YesNoTypeUnion">
403 <xs:annotation>
404 <xs:documentation>
405 Equivalent to EVENTLOG_ERROR_TYPE.
406 </xs:documentation>
407 </xs:annotation>
408 </xs:attribute>
409 <xs:attribute name="SupportsFailureAudits" type="wxs:YesNoTypeUnion">
410 <xs:annotation>
411 <xs:documentation>
412 Equivalent to EVENTLOG_AUDIT_FAILURE.
413 </xs:documentation>
414 </xs:annotation>
415 </xs:attribute>
416 <xs:attribute name="SupportsInformationals" type="wxs:YesNoTypeUnion">
417 <xs:annotation>
418 <xs:documentation>
419 Equivalent to EVENTLOG_INFORMATION_TYPE.
420 </xs:documentation>
421 </xs:annotation>
422 </xs:attribute>
423 <xs:attribute name="SupportsSuccessAudits" type="wxs:YesNoTypeUnion">
424 <xs:annotation>
425 <xs:documentation>
426 Equivalent to EVENTLOG_AUDIT_SUCCESS.
427 </xs:documentation>
428 </xs:annotation>
429 </xs:attribute>
430 <xs:attribute name="SupportsWarnings" type="wxs:YesNoTypeUnion">
431 <xs:annotation>
432 <xs:documentation>
433 Equivalent to EVENTLOG_WARNING_TYPE.
434 </xs:documentation>
435 </xs:annotation>
436 </xs:attribute>
437 <xs:anyAttribute namespace="##other" processContents="lax">
438 <xs:annotation>
439 <xs:documentation>
440 Extensibility point in the WiX XML Schema. Schema extensions can register additional
441 attributes at this point in the schema.
442 </xs:documentation>
443 </xs:annotation>
444 </xs:anyAttribute>
445 </xs:complexType>
446 </xs:element>
447
448 <xs:element name="FileSearch">
449 <xs:annotation>
450 <xs:documentation>Describes a file search.</xs:documentation>
451 <xs:appinfo>
452 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Bundle" />
453 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
454 </xs:appinfo>
455 </xs:annotation>
456 <xs:complexType>
457 <xs:choice minOccurs="0" maxOccurs="unbounded">
458 <xs:any namespace="##other" processContents="lax">
459 <xs:annotation>
460 <xs:documentation>
461 Extensibility point in the WiX XML Schema. Schema extensions can register additional
462 elements at this point in the schema.
463 </xs:documentation>
464 </xs:annotation>
465 </xs:any>
466 </xs:choice>
467 <xs:attributeGroup ref="SearchCommonAttributes" />
468 <xs:attribute name="Path" type="xs:string">
469 <xs:annotation>
470 <xs:documentation>File path to search for.</xs:documentation>
471 </xs:annotation>
472 </xs:attribute>
473 <xs:attribute name="DisableFileRedirection" type="wxs:YesNoTypeUnion">
474 <xs:annotation>
475 <xs:documentation>When set to "yes" and the running bundle is 32-bit, Wow64DisableWow64FsRedirection is called before starting the search.</xs:documentation>
476 </xs:annotation>
477 </xs:attribute>
478 <xs:attribute name="Result">
479 <xs:annotation>
480 <xs:documentation>
481 Rather than saving the matching file path into the variable, a FileSearch can save an attribute of the matching file instead.
482 </xs:documentation>
483 </xs:annotation>
484 <xs:simpleType>
485 <xs:restriction base="xs:NMTOKEN">
486 <xs:enumeration value="exists">
487 <xs:annotation>
488 <xs:documentation>Saves true if a matching file is found; false otherwise.</xs:documentation>
489 </xs:annotation>
490 </xs:enumeration>
491 <xs:enumeration value="version">
492 <xs:annotation>
493 <xs:documentation>Saves the version information for files that have it (.exe, .dll); zero-version (0.0.0.0) otherwise.</xs:documentation>
494 </xs:annotation>
495 </xs:enumeration>
496 </xs:restriction>
497 </xs:simpleType>
498 </xs:attribute>
499 <xs:anyAttribute namespace="##other" processContents="lax">
500 <xs:annotation>
501 <xs:documentation>
502 Extensibility point in the WiX XML Schema. Schema extensions can register additional
503 attributes at this point in the schema.
504 </xs:documentation>
505 </xs:annotation>
506 </xs:anyAttribute>
507 </xs:complexType>
508 </xs:element>
509
510 <xs:element name="FileSearchRef">
511 <xs:annotation>
512 <xs:documentation>References a FileSearch.</xs:documentation>
513 <xs:appinfo>
514 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Bundle" />
515 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
516 </xs:appinfo>
517 </xs:annotation>
518 <xs:complexType>
519 <xs:choice minOccurs="0" maxOccurs="unbounded">
520 <xs:any namespace="##other" processContents="lax">
521 <xs:annotation>
522 <xs:documentation>
523 Extensibility point in the WiX XML Schema. Schema extensions can register additional
524 elements at this point in the schema.
525 </xs:documentation>
526 </xs:annotation>
527 </xs:any>
528 </xs:choice>
529 <xs:attribute name="Id" type="xs:string" use="required" />
530 <xs:anyAttribute namespace="##other" processContents="lax">
531 <xs:annotation>
532 <xs:documentation>
533 Extensibility point in the WiX XML Schema. Schema extensions can register additional
534 attributes at this point in the schema.
535 </xs:documentation>
536 </xs:annotation>
537 </xs:anyAttribute>
538 </xs:complexType>
539 </xs:element>
540
541 <xs:element name="FileShare">
542 <xs:annotation>
543 <xs:appinfo>
544 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
545 </xs:appinfo>
546 <xs:documentation>Creates a file share out of the component's directory.</xs:documentation>
547 </xs:annotation>
548 <xs:complexType>
549 <xs:choice minOccurs="0" maxOccurs="unbounded">
550 <xs:element ref="FileSharePermission">
551 <xs:annotation>
552 <xs:documentation>At least one of these ACL permission must be specified.</xs:documentation>
553 </xs:annotation>
554 </xs:element>
555 <xs:any namespace="##other" processContents="lax">
556 <xs:annotation>
557 <xs:documentation>
558 Extensibility point in the WiX XML Schema. Schema extensions can register additional
559 elements at this point in the schema.
560 </xs:documentation>
561 </xs:annotation>
562 </xs:any>
563 </xs:choice>
564 <xs:attribute name="Id" type="xs:string">
565 <xs:annotation>
566 <xs:documentation>Identifier for the file share (primary key).</xs:documentation>
567 </xs:annotation>
568 </xs:attribute>
569 <xs:attribute name="Name" type="xs:string" use="required">
570 <xs:annotation>
571 <xs:documentation>Name of the file share.</xs:documentation>
572 </xs:annotation>
573 </xs:attribute>
574 <xs:attribute name="Description" type="xs:string">
575 <xs:annotation>
576 <xs:documentation>Description of the file share.</xs:documentation>
577 </xs:annotation>
578 </xs:attribute>
579 <xs:anyAttribute namespace="##other" processContents="lax">
580 <xs:annotation>
581 <xs:documentation>
582 Extensibility point in the WiX XML Schema. Schema extensions can register additional
583 attributes at this point in the schema.
584 </xs:documentation>
585 </xs:annotation>
586 </xs:anyAttribute>
587 </xs:complexType>
588 </xs:element>
589
590 <xs:element name="FileSharePermission">
591 <xs:annotation>
592 <xs:documentation>
593 Sets ACLs on a FileShare. This element has no Id attribute.
594 The table and key are taken from the parent element.
595 </xs:documentation>
596 </xs:annotation>
597 <xs:complexType>
598 <xs:choice minOccurs="0" maxOccurs="unbounded">
599 <xs:any namespace="##other" processContents="lax">
600 <xs:annotation>
601 <xs:documentation>
602 Extensibility point in the WiX XML Schema. Schema extensions can register additional
603 elements at this point in the schema.
604 </xs:documentation>
605 </xs:annotation>
606 </xs:any>
607 </xs:choice>
608 <xs:attribute name="User" use="required" type="xs:string"></xs:attribute>
609 <!-- Common ACLs -->
610 <xs:attribute name="Read" type="wxs:YesNoTypeUnion"></xs:attribute>
611 <xs:attribute name="Delete" type="wxs:YesNoTypeUnion"></xs:attribute>
612 <xs:attribute name="ReadPermission" type="wxs:YesNoTypeUnion"></xs:attribute>
613 <xs:attribute name="ChangePermission" type="wxs:YesNoTypeUnion"></xs:attribute>
614 <xs:attribute name="TakeOwnership" type="wxs:YesNoTypeUnion"></xs:attribute>
615 <!-- Folder and File ACLs -->
616 <xs:attribute name="ReadAttributes" type="wxs:YesNoTypeUnion"></xs:attribute>
617 <xs:attribute name="WriteAttributes" type="wxs:YesNoTypeUnion"></xs:attribute>
618 <xs:attribute name="ReadExtendedAttributes" type="wxs:YesNoTypeUnion"></xs:attribute>
619 <xs:attribute name="WriteExtendedAttributes" type="wxs:YesNoTypeUnion"></xs:attribute>
620 <xs:attribute name="Synchronize" type="wxs:YesNoTypeUnion"></xs:attribute>
621 <!-- Folder only ACLs -->
622 <xs:attribute name="CreateFile" type="wxs:YesNoTypeUnion">
623 <xs:annotation>
624 <xs:documentation>For a directory, the right to create a file in the directory. Only valid under a 'CreateFolder' parent.</xs:documentation>
625 </xs:annotation>
626 </xs:attribute>
627 <xs:attribute name="CreateChild" type="wxs:YesNoTypeUnion">
628 <xs:annotation>
629 <xs:documentation>For a directory, the right to create a subdirectory. Only valid under a 'CreateFolder' parent.</xs:documentation>
630 </xs:annotation>
631 </xs:attribute>
632 <xs:attribute name="DeleteChild" type="wxs:YesNoTypeUnion">
633 <xs:annotation>
634 <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>
635 </xs:annotation>
636 </xs:attribute>
637 <xs:attribute name="Traverse" type="wxs:YesNoTypeUnion">
638 <xs:annotation>
639 <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>
640 </xs:annotation>
641 </xs:attribute>
642 <!-- Generic ACLs, mapped by system to appropriate permissions -->
643 <xs:attribute name="GenericAll" type="wxs:YesNoTypeUnion"></xs:attribute>
644 <xs:attribute name="GenericExecute" type="wxs:YesNoTypeUnion"></xs:attribute>
645 <xs:attribute name="GenericWrite" type="wxs:YesNoTypeUnion"></xs:attribute>
646 <xs:attribute name="GenericRead" type="wxs:YesNoTypeUnion">
647 <xs:annotation>
648 <xs:documentation>specifying this will fail to grant read access</xs:documentation>
649 </xs:annotation>
650 </xs:attribute>
651 <xs:anyAttribute namespace="##other" processContents="lax">
652 <xs:annotation>
653 <xs:documentation>
654 Extensibility point in the WiX XML Schema. Schema extensions can register additional
655 attributes at this point in the schema.
656 </xs:documentation>
657 </xs:annotation>
658 </xs:anyAttribute>
659 </xs:complexType>
660 </xs:element>
661
662 <xs:element name="FormatFile">
663 <xs:annotation>
664 <xs:appinfo>
665 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="File" />
666 </xs:appinfo>
667 <xs:documentation>
668 Formats a file's contents at install time. The contents are formatted according to the rules of the
669 [Formatted](https://learn.microsoft.com/en-us/windows/win32/msi/formatted) data type.
670 </xs:documentation>
671 </xs:annotation>
672 <xs:complexType>
673 <xs:choice minOccurs="0" maxOccurs="unbounded">
674 <xs:any namespace="##other" processContents="lax">
675 <xs:annotation>
676 <xs:documentation>
677 Extensibility point in the WiX XML Schema. Schema extensions can register additional
678 elements at this point in the schema.
679 </xs:documentation>
680 </xs:annotation>
681 </xs:any>
682 </xs:choice>
683 <xs:attribute name="BinaryRef" type="xs:string" use="required">
684 <xs:annotation>
685 <xs:documentation>
686 The id of a Binary row that contains a copy of the file. The file in the Binary table overwrites whatever
687 file is installed by the parent component.
688 </xs:documentation>
689 </xs:annotation>
690 </xs:attribute>
691 <xs:anyAttribute namespace="##other" processContents="lax">
692 <xs:annotation>
693 <xs:documentation>
694 Extensibility point in the WiX XML Schema. Schema extensions can register additional
695 attributes at this point in the schema.
696 </xs:documentation>
697 </xs:annotation>
698 </xs:anyAttribute>
699 </xs:complexType>
700 </xs:element>
701
702 <xs:element name="Group">
703 <xs:annotation>
704 <xs:appinfo>
705 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
706 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Module" />
707 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Package" />
708 </xs:appinfo>
709 <xs:documentation>
710 Finds user groups on the local machine or specified Active Directory domain. The local machine will be
711 searched for the group first then fallback to looking in Active Directory. This element is not capable
712 of creating new groups but can be used to add new or existing users to an existing group.
713 </xs:documentation>
714 </xs:annotation>
715 <xs:complexType>
716 <xs:choice minOccurs="0" maxOccurs="unbounded">
717 <xs:any namespace="##other" processContents="lax">
718 <xs:annotation>
719 <xs:documentation>
720 Extensibility point in the WiX XML Schema. Schema extensions can register additional
721 elements at this point in the schema.
722 </xs:documentation>
723 </xs:annotation>
724 </xs:any>
725 </xs:choice>
726 <xs:attribute name="Id" type="xs:string">
727 <xs:annotation>
728 <xs:documentation>Unique identifier in your installation package for this group.</xs:documentation>
729 </xs:annotation>
730 </xs:attribute>
731 <xs:attribute name="Name" type="xs:string" use="required">
732 <xs:annotation>
733 <xs:documentation>A [Formatted](https://learn.microsoft.com/en-us/windows/win32/msi/formatted) string that contains the name of the group to be found.</xs:documentation>
734 </xs:annotation>
735 </xs:attribute>
736 <xs:attribute name="Domain" type="xs:string">
737 <xs:annotation>
738 <xs:documentation>An optional [Formatted](https://learn.microsoft.com/en-us/windows/win32/msi/formatted) string that specifies the domain for the group.</xs:documentation>
739 </xs:annotation>
740 </xs:attribute>
741 <xs:anyAttribute namespace="##other" processContents="lax">
742 <xs:annotation>
743 <xs:documentation>
744 Extensibility point in the WiX XML Schema. Schema extensions can register additional
745 attributes at this point in the schema.
746 </xs:documentation>
747 </xs:annotation>
748 </xs:anyAttribute>
749 </xs:complexType>
750 </xs:element>
751
752 <xs:element name="GroupRef">
753 <xs:annotation>
754 <xs:documentation>Used to join a user to a group</xs:documentation>
755 </xs:annotation>
756 <xs:complexType>
757 <xs:choice minOccurs="0" maxOccurs="unbounded">
758 <xs:any namespace="##other" processContents="lax">
759 <xs:annotation>
760 <xs:documentation>
761 Extensibility point in the WiX XML Schema. Schema extensions can register additional
762 elements at this point in the schema.
763 </xs:documentation>
764 </xs:annotation>
765 </xs:any>
766 </xs:choice>
767 <xs:attribute name="Id" type="xs:string" use="required" />
768 <xs:anyAttribute namespace="##other" processContents="lax">
769 <xs:annotation>
770 <xs:documentation>
771 Extensibility point in the WiX XML Schema. Schema extensions can register additional
772 attributes at this point in the schema.
773 </xs:documentation>
774 </xs:annotation>
775 </xs:anyAttribute>
776 </xs:complexType>
777 </xs:element>
778
779 <xs:element name="InternetShortcut">
780 <xs:annotation>
781 <xs:appinfo>
782 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
783 <xse:howtoRef href="files_and_registry/create_internet_shortcut.html">How To: Create a shortcut to a webpage</xse:howtoRef>
784 </xs:appinfo>
785 <xs:documentation>Creates a shortcut to a URL.</xs:documentation>
786 </xs:annotation>
787 <xs:complexType>
788 <xs:choice minOccurs="0" maxOccurs="unbounded">
789 <xs:any namespace="##other" processContents="lax">
790 <xs:annotation>
791 <xs:documentation>
792 Extensibility point in the WiX XML Schema. Schema extensions can register additional
793 elements at this point in the schema.
794 </xs:documentation>
795 </xs:annotation>
796 </xs:any>
797 </xs:choice>
798 <xs:attribute name="Id" type="xs:string">
799 <xs:annotation>
800 <xs:documentation>Unique identifier in your installation package for this Internet shortcut.</xs:documentation>
801 </xs:annotation>
802 </xs:attribute>
803 <xs:attribute name="Directory" type="xs:string">
804 <xs:annotation>
805 <xs:documentation>Identifier reference to Directory element where shortcut is to be created. This attribute's value defaults to the parent Component directory.</xs:documentation>
806 </xs:annotation>
807 </xs:attribute>
808 <xs:attribute name="Name" type="xs:string" use="required">
809 <xs:annotation>
810 <xs:documentation>
811 The name of the shortcut file, which is visible to the user. (The .lnk
812 extension is added automatically and by default, is not shown to the user.)
813 </xs:documentation>
814 </xs:annotation>
815 </xs:attribute>
816 <xs:attribute name="Target" type="xs:string" use="required">
817 <xs:annotation>
818 <xs:documentation>
819 URL that should be opened when the user selects the shortcut. Windows
820 opens the URL in the appropriate handler for the protocol specified
821 in the URL. Note that this is a formatted field, so you can use
822 [#fileId] syntax to refer to a file being installed (using the file:
823 protocol).
824 </xs:documentation>
825 </xs:annotation>
826 </xs:attribute>
827 <xs:attribute name="Type">
828 <xs:annotation>
829 <xs:documentation>Which type of shortcut should be created.</xs:documentation>
830 </xs:annotation>
831 <xs:simpleType>
832 <xs:restriction base="xs:NMTOKEN">
833 <xs:enumeration value="url">
834 <xs:annotation>
835 <xs:documentation>Creates .url files using IUniformResourceLocatorW.</xs:documentation>
836 </xs:annotation>
837 </xs:enumeration>
838 <xs:enumeration value="link">
839 <xs:annotation>
840 <xs:documentation>Creates .lnk files using IShellLinkW (default).</xs:documentation>
841 </xs:annotation>
842 </xs:enumeration>
843 </xs:restriction>
844 </xs:simpleType>
845 </xs:attribute>
846 <xs:attribute name="IconFile" type="xs:string">
847 <xs:annotation>
848 <xs:documentation>
849 Icon file that should be displayed. Note that this is a formatted field, so you can use
850 [#fileId] syntax to refer to a file being installed (using the file:
851 protocol).
852 </xs:documentation>
853 </xs:annotation>
854 </xs:attribute>
855 <xs:attribute name="IconIndex" type="wxs:Integer">
856 <xs:annotation>
857 <xs:documentation>
858 Index of the icon being referenced.
859 </xs:documentation>
860 </xs:annotation>
861 </xs:attribute>
862 <xs:anyAttribute namespace="##other" processContents="lax">
863 <xs:annotation>
864 <xs:documentation>
865 Extensibility point in the WiX XML Schema. Schema extensions can register additional
866 attributes at this point in the schema.
867 </xs:documentation>
868 </xs:annotation>
869 </xs:anyAttribute>
870 </xs:complexType>
871 </xs:element>
872
873 <xs:element name="PerformanceCategory">
874 <xs:annotation>
875 <xs:appinfo>
876 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
877 </xs:appinfo>
878 <xs:documentation>Used to create performance categories and configure performance counters.</xs:documentation>
879 </xs:annotation>
880 <xs:complexType>
881 <xs:choice minOccurs="0" maxOccurs="unbounded">
882 <xs:element ref="PerformanceCounter" />
883 <xs:any namespace="##other" processContents="lax">
884 <xs:annotation>
885 <xs:documentation>
886 Extensibility point in the WiX XML Schema. Schema extensions can register additional
887 elements at this point in the schema.
888 </xs:documentation>
889 </xs:annotation>
890 </xs:any>
891 </xs:choice>
892 <xs:attribute name="Id" type="xs:string">
893 <xs:annotation>
894 <xs:documentation>Unique identifier in your installation package for this performance counter category.</xs:documentation>
895 </xs:annotation>
896 </xs:attribute>
897 <xs:attribute name="Name" type="xs:string">
898 <xs:annotation>
899 <xs:documentation>Name for the performance counter category. If this attribute is not provided the Id attribute is used as the name of the performance counter category.</xs:documentation>
900 </xs:annotation>
901 </xs:attribute>
902 <xs:attribute name="Help" type="xs:string">
903 <xs:annotation>
904 <xs:documentation>Optional help text for the performance counter category.</xs:documentation>
905 </xs:annotation>
906 </xs:attribute>
907 <xs:attribute name="MultiInstance" type="wxs:YesNoTypeUnion">
908 <xs:annotation>
909 <xs:documentation>Flag that specifies whether the performance counter category is multi or single instanced. Default is single instance.</xs:documentation>
910 </xs:annotation>
911 </xs:attribute>
912 <xs:attribute name="Library" type="xs:string">
913 <xs:annotation>
914 <xs:documentation>DLL that contains the performance counter. The default is "netfxperf.dll" which should be used for all managed code performance counters.</xs:documentation>
915 </xs:annotation>
916 </xs:attribute>
917 <xs:attribute name="Open" type="xs:string">
918 <xs:annotation>
919 <xs:documentation>Function entry point in to the Library DLL called when opening the performance counter. The default is "OpenPerformanceData" which should be used for all managed code performance counters.</xs:documentation>
920 </xs:annotation>
921 </xs:attribute>
922 <xs:attribute name="Close" type="xs:string">
923 <xs:annotation>
924 <xs:documentation>Function entry point in to the Library DLL called when closing the performance counter. The default is "ClosePerformanceData" which should be used for all managed code performance counters.</xs:documentation>
925 </xs:annotation>
926 </xs:attribute>
927 <xs:attribute name="Collect" type="xs:string">
928 <xs:annotation>
929 <xs:documentation>Function entry point in to the Library DLL called when collecting data from the performance counter. The default is "CollectPerformanceData" which should be used for all managed code performance counters.</xs:documentation>
930 </xs:annotation>
931 </xs:attribute>
932 <xs:attribute name="DefaultLanguage" type="PerformanceCounterLanguageType">
933 <xs:annotation>
934 <xs:documentation>Default language for the performance category and contained counters' names and help text.</xs:documentation>
935 </xs:annotation>
936 </xs:attribute>
937 <xs:anyAttribute namespace="##other" processContents="lax">
938 <xs:annotation>
939 <xs:documentation>
940 Extensibility point in the WiX XML Schema. Schema extensions can register additional
941 attributes at this point in the schema.
942 </xs:documentation>
943 </xs:annotation>
944 </xs:anyAttribute>
945 </xs:complexType>
946 </xs:element>
947
948 <xs:element name="PerformanceCounter">
949 <xs:annotation>
950 <xs:documentation>Creates a performance counter in a performance category.</xs:documentation>
951 </xs:annotation>
952 <xs:complexType>
953 <xs:choice minOccurs="0" maxOccurs="unbounded">
954 <xs:any namespace="##other" processContents="lax">
955 <xs:annotation>
956 <xs:documentation>
957 Extensibility point in the WiX XML Schema. Schema extensions can register additional
958 elements at this point in the schema.
959 </xs:documentation>
960 </xs:annotation>
961 </xs:any>
962 </xs:choice>
963 <xs:attribute name="Name" type="xs:string">
964 <xs:annotation>
965 <xs:documentation>Name for the performance counter.</xs:documentation>
966 </xs:annotation>
967 </xs:attribute>
968 <xs:attribute name="Help" type="xs:string">
969 <xs:annotation>
970 <xs:documentation>Optional help text for the performance counter.</xs:documentation>
971 </xs:annotation>
972 </xs:attribute>
973 <xs:attribute name="Type" type="PerformanceCounterTypesType">
974 <xs:annotation>
975 <xs:documentation>Type of the performance counter.</xs:documentation>
976 </xs:annotation>
977 </xs:attribute>
978 <xs:attribute name="Language" type="PerformanceCounterLanguageType">
979 <xs:annotation>
980 <xs:documentation>Language for the peformance counter name and help. The default is to use the parent PerformanceCategory element's DefaultLanguage attribute.</xs:documentation>
981 </xs:annotation>
982 </xs:attribute>
983 <xs:anyAttribute namespace="##other" processContents="lax">
984 <xs:annotation>
985 <xs:documentation>
986 Extensibility point in the WiX XML Schema. Schema extensions can register additional
987 attributes at this point in the schema.
988 </xs:documentation>
989 </xs:annotation>
990 </xs:anyAttribute>
991 </xs:complexType>
992 </xs:element>
993
994 <xs:element name="PerfCounter">
995 <xs:annotation>
996 <xs:appinfo>
997 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="File" />
998 <xse:deprecated ref="PerformanceCounter" />
999 </xs:appinfo>
1000 <xs:documentation>Used to install Perfmon counters.</xs:documentation>
1001 </xs:annotation>
1002 <xs:complexType>
1003 <xs:choice minOccurs="0" maxOccurs="unbounded">
1004 <xs:any namespace="##other" processContents="lax">
1005 <xs:annotation>
1006 <xs:documentation>
1007 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1008 elements at this point in the schema.
1009 </xs:documentation>
1010 </xs:annotation>
1011 </xs:any>
1012 </xs:choice>
1013 <xs:attribute name="Name" type="xs:string" />
1014 <xs:anyAttribute namespace="##other" processContents="lax">
1015 <xs:annotation>
1016 <xs:documentation>
1017 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1018 attributes at this point in the schema.
1019 </xs:documentation>
1020 </xs:annotation>
1021 </xs:anyAttribute>
1022 </xs:complexType>
1023 </xs:element>
1024
1025 <xs:element name="PerfCounterManifest">
1026 <xs:annotation>
1027 <xs:appinfo>
1028 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="File" />
1029 </xs:appinfo>
1030 <xs:documentation>
1031 Used to install Perfmon Counter Manifests.
1032 Note that this functionality cannot be used with major upgrades that are scheduled after the InstallExecute,
1033 InstallExecuteAgain, or InstallFinalize actions. For more information on major upgrade scheduling, see
1034 [RemoveExistingProducts Action](https://learn.microsoft.com/en-us/windows/win32/msi/removeexistingproducts-action).
1035 </xs:documentation>
1036 </xs:annotation>
1037 <xs:complexType>
1038 <xs:choice minOccurs="0" maxOccurs="unbounded">
1039 <xs:any namespace="##other" processContents="lax">
1040 <xs:annotation>
1041 <xs:documentation>
1042 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1043 elements at this point in the schema.
1044 </xs:documentation>
1045 </xs:annotation>
1046 </xs:any>
1047 </xs:choice>
1048 <xs:attribute name="ResourceFileDirectory" type="xs:string">
1049 <xs:annotation>
1050 <xs:documentation>The directory that holds the resource file of the providers in the perfmon counter manifest. Often the resource file path cannot be determined until setup time. Put the directory here and during perfmon manifest registrtion the path will be updated in the registry. If not specified, Perfmon will look for the resource file in the same directory of the perfmon counter manifest file.</xs:documentation>
1051 </xs:annotation>
1052 </xs:attribute>
1053 <xs:anyAttribute namespace="##other" processContents="lax">
1054 <xs:annotation>
1055 <xs:documentation>
1056 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1057 attributes at this point in the schema.
1058 </xs:documentation>
1059 </xs:annotation>
1060 </xs:anyAttribute>
1061 </xs:complexType>
1062 </xs:element>
1063
1064 <xs:element name="EventManifest">
1065 <xs:annotation>
1066 <xs:appinfo>
1067 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="File" />
1068 </xs:appinfo>
1069 <xs:documentation>Used to install Event Manifests.</xs:documentation>
1070 </xs:annotation>
1071 <xs:complexType>
1072 <xs:choice minOccurs="0" maxOccurs="unbounded">
1073 <xs:any namespace="##other" processContents="lax">
1074 <xs:annotation>
1075 <xs:documentation>
1076 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1077 elements at this point in the schema.
1078 </xs:documentation>
1079 </xs:annotation>
1080 </xs:any>
1081 </xs:choice>
1082 <xs:attribute name="MessageFile" type="xs:string">
1083 <xs:annotation>
1084 <xs:documentation>The message file (including path) of all the providers in the event manifest. Often the message file path cannot be determined until setup time. Put your MessageFile here and the messageFileName attribute of the all the providers in the manifest will be updated with the path before it is registered. </xs:documentation>
1085 </xs:annotation>
1086 </xs:attribute>
1087 <xs:attribute name="ParameterFile" type="xs:string">
1088 <xs:annotation>
1089 <xs:documentation>The parameter file (including path) of all the providers in the event manifest. Often the parameter file path cannot be determined until setup time. Put your ParameterFile here and the parameterFileName attribute of the all the providers in the manifest will be updated with the path before it is registered. </xs:documentation>
1090 </xs:annotation>
1091 </xs:attribute>
1092 <xs:attribute name="ResourceFile" type="xs:string">
1093 <xs:annotation>
1094 <xs:documentation>The resource file (including path) of all the providers in the event manifest. Often the resource file path cannot be determined until setup time. Put your ResourceFile here and the resourceFileName attribute of the all the providers in the manifest will be updated with the path before it is registered. </xs:documentation>
1095 </xs:annotation>
1096 </xs:attribute>
1097 <xs:anyAttribute namespace="##other" processContents="lax">
1098 <xs:annotation>
1099 <xs:documentation>
1100 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1101 attributes at this point in the schema.
1102 </xs:documentation>
1103 </xs:annotation>
1104 </xs:anyAttribute>
1105 </xs:complexType>
1106 </xs:element>
1107
1108 <xs:element name="PermissionEx">
1109 <xs:annotation>
1110 <xs:documentation>
1111 Sets ACLs on File, Registry, CreateFolder, or ServiceInstall. When under a Registry element, this cannot be used
1112 if the Action attribute's value is remove or removeKeyOnInstall. This element has no Id attribute.
1113 The table and key are taken from the parent element.
1114 </xs:documentation>
1115 <xs:appinfo>
1116 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="CreateFolder" />
1117 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="File" />
1118 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="RegistryKey" />
1119 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="RegistryValue" />
1120 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="ServiceInstall" />
1121 </xs:appinfo>
1122 </xs:annotation>
1123 <xs:complexType>
1124 <xs:choice minOccurs="0" maxOccurs="unbounded">
1125 <xs:any namespace="##other" processContents="lax">
1126 <xs:annotation>
1127 <xs:documentation>
1128 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1129 elements at this point in the schema.
1130 </xs:documentation>
1131 </xs:annotation>
1132 </xs:any>
1133 </xs:choice>
1134 <xs:attribute name="User" type="xs:string" use="required"></xs:attribute>
1135 <xs:attribute name="Domain" type="xs:string"></xs:attribute>
1136 <xs:attribute name="Inheritable" type="wxs:YesNoTypeUnion">
1137 <xs:annotation>
1138 <xs:documentation>Whether the permissions are inheritable. The default is "yes".</xs:documentation>
1139 </xs:annotation>
1140 </xs:attribute>
1141 <!-- Common ACLs -->
1142 <xs:attribute name="Read" type="wxs:YesNoTypeUnion"></xs:attribute>
1143 <xs:attribute name="Delete" type="wxs:YesNoTypeUnion"></xs:attribute>
1144 <xs:attribute name="ReadPermission" type="wxs:YesNoTypeUnion"></xs:attribute>
1145 <xs:attribute name="ChangePermission" type="wxs:YesNoTypeUnion"></xs:attribute>
1146 <xs:attribute name="TakeOwnership" type="wxs:YesNoTypeUnion"></xs:attribute>
1147 <!-- Folder and File ACLs -->
1148 <xs:attribute name="ReadAttributes" type="wxs:YesNoTypeUnion"></xs:attribute>
1149 <xs:attribute name="WriteAttributes" type="wxs:YesNoTypeUnion"></xs:attribute>
1150 <xs:attribute name="ReadExtendedAttributes" type="wxs:YesNoTypeUnion"></xs:attribute>
1151 <xs:attribute name="WriteExtendedAttributes" type="wxs:YesNoTypeUnion"></xs:attribute>
1152 <xs:attribute name="Synchronize" type="wxs:YesNoTypeUnion"></xs:attribute>
1153 <!-- Folder only ACLs -->
1154 <xs:attribute name="CreateFile" type="wxs:YesNoTypeUnion">
1155 <xs:annotation>
1156 <xs:documentation>For a directory, the right to create a file in the directory. Only valid under a 'CreateFolder' parent.</xs:documentation>
1157 </xs:annotation>
1158 </xs:attribute>
1159 <xs:attribute name="CreateChild" type="wxs:YesNoTypeUnion">
1160 <xs:annotation>
1161 <xs:documentation>For a directory, the right to create a subdirectory. Only valid under a 'CreateFolder' parent.</xs:documentation>
1162 </xs:annotation>
1163 </xs:attribute>
1164 <xs:attribute name="DeleteChild" type="wxs:YesNoTypeUnion">
1165 <xs:annotation>
1166 <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>
1167 </xs:annotation>
1168 </xs:attribute>
1169 <xs:attribute name="Traverse" type="wxs:YesNoTypeUnion">
1170 <xs:annotation>
1171 <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>
1172 </xs:annotation>
1173 </xs:attribute>
1174 <!-- File only ACLs -->
1175 <xs:attribute name="Append" type="wxs:YesNoTypeUnion"></xs:attribute>
1176 <xs:attribute name="Execute" type="wxs:YesNoTypeUnion"></xs:attribute>
1177 <!-- File and Registry ACLs -->
1178 <xs:attribute name="Write" type="wxs:YesNoTypeUnion"></xs:attribute>
1179 <!-- Registry only ACLs -->
1180 <xs:attribute name="CreateSubkeys" type="wxs:YesNoTypeUnion"></xs:attribute>
1181 <xs:attribute name="EnumerateSubkeys" type="wxs:YesNoTypeUnion"></xs:attribute>
1182 <xs:attribute name="Notify" type="wxs:YesNoTypeUnion"></xs:attribute>
1183 <xs:attribute name="CreateLink" type="wxs:YesNoTypeUnion"></xs:attribute>
1184 <!-- Generic ACLs, mapped by system to appropriate permissions -->
1185 <xs:attribute name="GenericAll" type="wxs:YesNoTypeUnion"></xs:attribute>
1186 <xs:attribute name="GenericExecute" type="wxs:YesNoTypeUnion"></xs:attribute>
1187 <xs:attribute name="GenericWrite" type="wxs:YesNoTypeUnion"></xs:attribute>
1188 <xs:attribute name="GenericRead" type="wxs:YesNoTypeUnion">
1189 <xs:annotation>
1190 <xs:documentation>specifying this will fail to grant read access</xs:documentation>
1191 </xs:annotation>
1192 </xs:attribute>
1193 <!-- Service only ACLs -->
1194 <xs:attribute name="ServiceQueryConfig" type="wxs:YesNoTypeUnion">
1195 <xs:annotation>
1196 <xs:documentation>Required to call the QueryServiceConfig and QueryServiceConfig2 functions to query the service configuration. Only valid under a 'ServiceInstall' parent.</xs:documentation>
1197 </xs:annotation>
1198 </xs:attribute>
1199 <xs:attribute name="ServiceChangeConfig" type="wxs:YesNoTypeUnion">
1200 <xs:annotation>
1201 <xs:documentation>Required to call the ChangeServiceConfig or ChangeServiceConfig2 function to change the service configuration. Only valid under a 'ServiceInstall' parent.</xs:documentation>
1202 </xs:annotation>
1203 </xs:attribute>
1204 <xs:attribute name="ServiceQueryStatus" type="wxs:YesNoTypeUnion">
1205 <xs:annotation>
1206 <xs:documentation>Required to call the QueryServiceStatus function to ask the service control manager about the status of the service. Only valid under a 'ServiceInstall' parent.</xs:documentation>
1207 </xs:annotation>
1208 </xs:attribute>
1209 <xs:attribute name="ServiceEnumerateDependents" type="wxs:YesNoTypeUnion">
1210 <xs:annotation>
1211 <xs:documentation>Required to call the EnumDependentServices function to enumerate all the services dependent on the service. Only valid under a 'ServiceInstall' parent.</xs:documentation>
1212 </xs:annotation>
1213 </xs:attribute>
1214 <xs:attribute name="ServiceStart" type="wxs:YesNoTypeUnion">
1215 <xs:annotation>
1216 <xs:documentation>Required to call the StartService function to start the service. Only valid under a 'ServiceInstall' parent.</xs:documentation>
1217 </xs:annotation>
1218 </xs:attribute>
1219 <xs:attribute name="ServiceStop" type="wxs:YesNoTypeUnion">
1220 <xs:annotation>
1221 <xs:documentation>Required to call the ControlService function to stop the service. Only valid under a 'ServiceInstall' parent.</xs:documentation>
1222 </xs:annotation>
1223 </xs:attribute>
1224 <xs:attribute name="ServicePauseContinue" type="wxs:YesNoTypeUnion">
1225 <xs:annotation>
1226 <xs:documentation>Required to call the ControlService function to pause or continue the service. Only valid under a 'ServiceInstall' parent.</xs:documentation>
1227 </xs:annotation>
1228 </xs:attribute>
1229 <xs:attribute name="ServiceInterrogate" type="wxs:YesNoTypeUnion">
1230 <xs:annotation>
1231 <xs:documentation>Required to call the ControlService function to ask the service to report its status immediately. Only valid under a 'ServiceInstall' parent.</xs:documentation>
1232 </xs:annotation>
1233 </xs:attribute>
1234 <xs:attribute name="ServiceUserDefinedControl" type="wxs:YesNoTypeUnion">
1235 <xs:annotation>
1236 <xs:documentation>Required to call the ControlService function to specify a user-defined control code. Only valid under a 'ServiceInstall' parent.</xs:documentation>
1237 </xs:annotation>
1238 </xs:attribute>
1239 <xs:anyAttribute namespace="##other" processContents="lax">
1240 <xs:annotation>
1241 <xs:documentation>
1242 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1243 attributes at this point in the schema.
1244 </xs:documentation>
1245 </xs:annotation>
1246 </xs:anyAttribute>
1247 </xs:complexType>
1248 </xs:element>
1249
1250 <xs:element name="ProductSearch">
1251 <xs:annotation>
1252 <xs:documentation>Describes a product search.</xs:documentation>
1253 <xs:appinfo>
1254 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Bundle" />
1255 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
1256 </xs:appinfo>
1257 </xs:annotation>
1258 <xs:complexType>
1259 <xs:choice minOccurs="0" maxOccurs="unbounded">
1260 <xs:any namespace="##other" processContents="lax">
1261 <xs:annotation>
1262 <xs:documentation>
1263 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1264 elements at this point in the schema.
1265 </xs:documentation>
1266 </xs:annotation>
1267 </xs:any>
1268 </xs:choice>
1269 <xs:attributeGroup ref="SearchCommonAttributes" />
1270 <xs:attribute name="Guid" type="xs:string">
1271 <xs:annotation>
1272 <xs:documentation>The Guid attribute has been deprecated; use the ProductCode or UpgradeCode attribute instead. If this attribute is used, it is assumed to be a ProductCode.</xs:documentation>
1273 </xs:annotation>
1274 </xs:attribute>
1275 <xs:attribute name="ProductCode" type="xs:string">
1276 <xs:annotation>
1277 <xs:documentation>The ProductCode to use for the search. This attribute must be omitted if UpgradeCode is specified.</xs:documentation>
1278 </xs:annotation>
1279 </xs:attribute>
1280 <xs:attribute name="UpgradeCode" type="xs:string">
1281 <xs:annotation>
1282 <xs:documentation>The UpgradeCode to use for the search. This attribute must be omitted if ProductCode is specified. Note that if multiple products are found, the highest versioned product will be used for the result.</xs:documentation>
1283 </xs:annotation>
1284 </xs:attribute>
1285 <xs:attribute name="Result">
1286 <xs:annotation>
1287 <xs:documentation>
1288 Rather than saving the product version into the variable, a ProductSearch can save another attribute of the matching product instead.
1289 </xs:documentation>
1290 </xs:annotation>
1291 <xs:simpleType>
1292 <xs:restriction base="xs:NMTOKEN">
1293 <xs:enumeration value="assignment">
1294 <xs:annotation>
1295 <xs:documentation>Saves the assignment type of the product: per-user (0), or per-machine (1).</xs:documentation>
1296 </xs:annotation>
1297 </xs:enumeration>
1298 <xs:enumeration value="language">
1299 <xs:annotation>
1300 <xs:documentation>Saves the language of a matching product if found; empty otherwise.</xs:documentation>
1301 </xs:annotation>
1302 </xs:enumeration>
1303 <xs:enumeration value="state">
1304 <xs:annotation>
1305 <xs:documentation>Saves the state of the product: advertised (1), absent (2), or locally installed (5).</xs:documentation>
1306 </xs:annotation>
1307 </xs:enumeration>
1308 <xs:enumeration value="version">
1309 <xs:annotation>
1310 <xs:documentation>Saves the version of a matching product if found; 0.0.0.0 otherwise. This is the default.</xs:documentation>
1311 </xs:annotation>
1312 </xs:enumeration>
1313 </xs:restriction>
1314 </xs:simpleType>
1315 </xs:attribute>
1316 <xs:anyAttribute namespace="##other" processContents="lax">
1317 <xs:annotation>
1318 <xs:documentation>
1319 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1320 attributes at this point in the schema.
1321 </xs:documentation>
1322 </xs:annotation>
1323 </xs:anyAttribute>
1324 </xs:complexType>
1325 </xs:element>
1326
1327 <xs:element name="ProductSearchRef">
1328 <xs:annotation>
1329 <xs:documentation>References a ProductSearch.</xs:documentation>
1330 <xs:appinfo>
1331 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Bundle" />
1332 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
1333 </xs:appinfo>
1334 </xs:annotation>
1335 <xs:complexType>
1336 <xs:choice minOccurs="0" maxOccurs="unbounded">
1337 <xs:any namespace="##other" processContents="lax">
1338 <xs:annotation>
1339 <xs:documentation>
1340 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1341 elements at this point in the schema.
1342 </xs:documentation>
1343 </xs:annotation>
1344 </xs:any>
1345 </xs:choice>
1346 <xs:attribute name="Id" type="xs:string" use="required" />
1347 <xs:anyAttribute namespace="##other" processContents="lax">
1348 <xs:annotation>
1349 <xs:documentation>
1350 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1351 attributes at this point in the schema.
1352 </xs:documentation>
1353 </xs:annotation>
1354 </xs:anyAttribute>
1355 </xs:complexType>
1356 </xs:element>
1357
1358 <xs:element name="RemoveFolderEx">
1359 <xs:annotation>
1360 <xs:appinfo>
1361 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
1362 <xse:msiRef table="RemoveFile" href="https://learn.microsoft.com/en-us/windows/win32/msi/removefile-table"/>
1363 <xse:remarks>
1364 <html:p>
1365 The custom action that implements RemoveFolderEx does so by writing temporary rows to the RemoveFile table
1366 for each subfolder of the root folder you specify. Because it might dramatically affect Windows Installer's
1367 [File Costing](https://learn.microsoft.com/en-us/windows/win32/msi/file-costing),
1368 the temporary rows must be written before the CostInitialize standard action. Unfortunately, MSI doesn't
1369 create properties for the Directory hierarchy in your package until later, in the CostFinalize action.
1370 </html:p>
1371 <html:p>
1372 An easy workaround for a typical use case of removing a folder during uninstall is to write the directory
1373 path to the registry and to load it during uninstall. See [The WiX toolset's "Remember Property" pattern](http://robmensching.com/blog/posts/2010/5/2/the-wix-toolsets-remember-property-pattern)
1374 for an example.
1375 </html:p>
1376 <html:p>
1377 If you use custom actions to set properties, ensure that they are scheduled before the WixRemoveFoldersEx custom action.
1378 </html:p>
1379 </xse:remarks>
1380 </xs:appinfo>
1381 <xs:documentation>
1382 Remove a folder and all contained files and folders if the parent component is selected for installation or removal.
1383 The folder must be specified in the Property attribute as the name of a property that will have a value that resolves
1384 to the full path of the folder before the CostInitialize action. Note that Directory ids cannot be used.
1385 For more details, see the Remarks.
1386 </xs:documentation>
1387 </xs:annotation>
1388 <xs:complexType>
1389 <xs:choice minOccurs="0" maxOccurs="unbounded">
1390 <xs:any namespace="##other" processContents="lax">
1391 <xs:annotation>
1392 <xs:documentation>
1393 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1394 elements at this point in the schema.
1395 </xs:documentation>
1396 </xs:annotation>
1397 </xs:any>
1398 </xs:choice>
1399 <xs:attribute name="Id" type="xs:string">
1400 <xs:annotation>
1401 <xs:documentation>
1402 Primary key used to identify this particular entry. If this is not specified, a stable identifier
1403 will be generated at compile time based on the other attributes.
1404 </xs:documentation>
1405 </xs:annotation>
1406 </xs:attribute>
1407 <xs:attribute name="Condition" type="xs:string">
1408 <xs:annotation>
1409 <xs:documentation>
1410 Condition that determines if the folders should be removed. Must be blank or evaluate to true
1411 for the folder to be scheduled for removal.
1412 </xs:documentation>
1413 </xs:annotation>
1414 </xs:attribute>
1415 <xs:attribute name="Property" type="xs:string">
1416 <xs:annotation>
1417 <xs:documentation>
1418 The id of a property that resolves to the full path of the source directory. The property does not have
1419 to exist in the installer database at creation time; it could be created at installation time by a custom
1420 action, on the command line, etc. The property value can contain environment variables surrounded by
1421 percent signs such as from a REG_EXPAND_SZ registry value; environment variables will be expanded before
1422 being evaluated for a full path.
1423 </xs:documentation>
1424 </xs:annotation>
1425 </xs:attribute>
1426 <xs:attribute name="On">
1427 <xs:annotation>
1428 <xs:documentation>
1429 This value determines when the folder may be removed.
1430 </xs:documentation>
1431 </xs:annotation>
1432 <xs:simpleType>
1433 <xs:restriction base="xs:NMTOKEN">
1434 <xs:enumeration value="install">
1435 <xs:annotation>
1436 <xs:documentation>
1437 Removes the folder only when the parent component is being installed (msiInstallStateLocal or msiInstallStateSource).
1438 </xs:documentation>
1439 </xs:annotation>
1440 </xs:enumeration>
1441 <xs:enumeration value="uninstall">
1442 <xs:annotation>
1443 <xs:documentation>
1444 Removes the folder only when the parent component is being removed (msiInstallStateAbsent). This is the default if the On attribute is not specified.
1445 </xs:documentation>
1446 </xs:annotation>
1447 </xs:enumeration>
1448 <xs:enumeration value="both">
1449 <xs:annotation>
1450 <xs:documentation>
1451 Removes the folder when the parent component is being installed or removed.
1452 </xs:documentation>
1453 </xs:annotation>
1454 </xs:enumeration>
1455 </xs:restriction>
1456 </xs:simpleType>
1457 </xs:attribute>
1458 <xs:anyAttribute namespace="##other" processContents="lax">
1459 <xs:annotation>
1460 <xs:documentation>
1461 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1462 attributes at this point in the schema.
1463 </xs:documentation>
1464 </xs:annotation>
1465 </xs:anyAttribute>
1466 </xs:complexType>
1467 </xs:element>
1468
1469 <xs:element name="RestartResource">
1470 <xs:annotation>
1471 <xs:documentation>Registers a resource with the Restart Manager.</xs:documentation>
1472 <xs:appinfo>
1473 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
1474 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
1475 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Module" />
1476 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Package" />
1477 </xs:appinfo>
1478 </xs:annotation>
1479 <xs:complexType>
1480 <xs:choice minOccurs="0" maxOccurs="unbounded">
1481 <xs:any namespace="##other" processContents="lax">
1482 <xs:annotation>
1483 <xs:documentation>
1484 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1485 elements at this point in the schema.
1486 </xs:documentation>
1487 </xs:annotation>
1488 </xs:any>
1489 </xs:choice>
1490 <xs:attribute name="Id" type="xs:string">
1491 <xs:annotation>
1492 <xs:documentation>
1493 The unique identifier for this resource. A unique identifier will
1494 be generated automatically if not specified.
1495 </xs:documentation>
1496 </xs:annotation>
1497 </xs:attribute>
1498 <xs:attribute name="Path" type="xs:string">
1499 <xs:annotation>
1500 <xs:documentation>
1501 The full path to the process module to register with the Restart Manager.
1502 This can be a formatted value that resolves to a full path.
1503 </xs:documentation>
1504 </xs:annotation>
1505 </xs:attribute>
1506 <xs:attribute name="ProcessName" type="xs:string">
1507 <xs:annotation>
1508 <xs:documentation>
1509 The name of a process to register with the Restart Manager.
1510 This can be a formatted value that resolves to a process name.
1511 </xs:documentation>
1512 </xs:annotation>
1513 </xs:attribute>
1514 <xs:attribute name="ServiceName" type="xs:string">
1515 <xs:annotation>
1516 <xs:documentation>
1517 The name of a Windows service to register with the Restart Manager.
1518 This can be a formatted value that resolves to a service name.
1519 </xs:documentation>
1520 </xs:annotation>
1521 </xs:attribute>
1522 <xs:anyAttribute namespace="##other" processContents="lax">
1523 <xs:annotation>
1524 <xs:documentation>
1525 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1526 attributes at this point in the schema.
1527 </xs:documentation>
1528 </xs:annotation>
1529 </xs:anyAttribute>
1530 </xs:complexType>
1531 </xs:element>
1532
1533 <xs:element name="RegistrySearch">
1534 <xs:annotation>
1535 <xs:documentation>Describes a registry search.</xs:documentation>
1536 <xs:appinfo>
1537 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Bundle" />
1538 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
1539 </xs:appinfo>
1540 </xs:annotation>
1541 <xs:complexType>
1542 <xs:choice minOccurs="0" maxOccurs="unbounded">
1543 <xs:any namespace="##other" processContents="lax">
1544 <xs:annotation>
1545 <xs:documentation>
1546 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1547 elements at this point in the schema.
1548 </xs:documentation>
1549 </xs:annotation>
1550 </xs:any>
1551 </xs:choice>
1552 <xs:attributeGroup ref="SearchCommonAttributes" />
1553 <xs:attribute name="Bitness" type="wxs:BitnessTypeUnion">
1554 <xs:annotation>
1555 <xs:documentation>
1556 Overrides the default registry to search. The value `always64` will force
1557 the search to look in the 64-bit registry even when building for 32-bit.
1558 Simliarly, the value `always32` will force the search to look in the 32-bit
1559 registry even when building for 64-bit.
1560 The default value is `default` where the search will look in the same registry
1561 as the bitness of the package.
1562 </xs:documentation>
1563 </xs:annotation>
1564 </xs:attribute>
1565 <xs:attribute name="Root" use="required">
1566 <xs:annotation>
1567 <xs:documentation>Registry root hive to search under.</xs:documentation>
1568 </xs:annotation>
1569 <xs:simpleType>
1570 <xs:restriction base="xs:NMTOKEN">
1571 <xs:enumeration value="HKLM">
1572 <xs:annotation>
1573 <xs:documentation>HKEY_LOCAL_MACHINE</xs:documentation>
1574 </xs:annotation>
1575 </xs:enumeration>
1576 <xs:enumeration value="HKCU">
1577 <xs:annotation>
1578 <xs:documentation>HKEY_CURRENT_USER</xs:documentation>
1579 </xs:annotation>
1580 </xs:enumeration>
1581 <xs:enumeration value="HKCR">
1582 <xs:annotation>
1583 <xs:documentation>HKEY_CLASSES_ROOT</xs:documentation>
1584 </xs:annotation>
1585 </xs:enumeration>
1586 <xs:enumeration value="HKU">
1587 <xs:annotation>
1588 <xs:documentation>HKEY_USERS</xs:documentation>
1589 </xs:annotation>
1590 </xs:enumeration>
1591 </xs:restriction>
1592 </xs:simpleType>
1593 </xs:attribute>
1594 <xs:attribute name="Key" type="xs:string" use="required">
1595 <xs:annotation>
1596 <xs:documentation>Key to search for.</xs:documentation>
1597 </xs:annotation>
1598 </xs:attribute>
1599 <xs:attribute name="Value" type="xs:string">
1600 <xs:annotation>
1601 <xs:documentation>Optional value to search for under the given Key.</xs:documentation>
1602 </xs:annotation>
1603 </xs:attribute>
1604 <xs:attribute name="ExpandEnvironmentVariables" type="wxs:YesNoTypeUnion">
1605 <xs:annotation>
1606 <xs:documentation>Whether to expand any environment variables in REG_SZ, REG_EXPAND_SZ, or REG_MULTI_SZ values.</xs:documentation>
1607 </xs:annotation>
1608 </xs:attribute>
1609 <xs:attribute name="Result">
1610 <xs:annotation>
1611 <xs:documentation>
1612 Rather than saving the matching registry value into the variable, a RegistrySearch can save an attribute of the matching entry instead.
1613 </xs:documentation>
1614 </xs:annotation>
1615 <xs:simpleType>
1616 <xs:restriction base="xs:NMTOKEN">
1617 <xs:enumeration value="exists">
1618 <xs:annotation>
1619 <xs:documentation>Saves true if a matching registry entry is found; false otherwise.</xs:documentation>
1620 </xs:annotation>
1621 </xs:enumeration>
1622 <xs:enumeration value="value">
1623 <xs:annotation>
1624 <xs:documentation>Saves the value of the registry key in the variable. This is the default.</xs:documentation>
1625 </xs:annotation>
1626 </xs:enumeration>
1627 </xs:restriction>
1628 </xs:simpleType>
1629 </xs:attribute>
1630 <xs:anyAttribute namespace="##other" processContents="lax">
1631 <xs:annotation>
1632 <xs:documentation>
1633 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1634 attributes at this point in the schema.
1635 </xs:documentation>
1636 </xs:annotation>
1637 </xs:anyAttribute>
1638 </xs:complexType>
1639 </xs:element>
1640
1641 <xs:element name="RegistrySearchRef">
1642 <xs:annotation>
1643 <xs:documentation>References a RegistrySearch.</xs:documentation>
1644 <xs:appinfo>
1645 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Bundle" />
1646 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
1647 </xs:appinfo>
1648 </xs:annotation>
1649 <xs:complexType>
1650 <xs:choice minOccurs="0" maxOccurs="unbounded">
1651 <xs:any namespace="##other" processContents="lax">
1652 <xs:annotation>
1653 <xs:documentation>
1654 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1655 elements at this point in the schema.
1656 </xs:documentation>
1657 </xs:annotation>
1658 </xs:any>
1659 </xs:choice>
1660 <xs:attribute name="Id" type="xs:string" use="required" />
1661 <xs:anyAttribute namespace="##other" processContents="lax">
1662 <xs:annotation>
1663 <xs:documentation>
1664 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1665 attributes at this point in the schema.
1666 </xs:documentation>
1667 </xs:annotation>
1668 </xs:anyAttribute>
1669 </xs:complexType>
1670 </xs:element>
1671
1672 <xs:element name="ServiceConfig">
1673 <xs:annotation>
1674 <xs:documentation>Service configuration information for failure actions.</xs:documentation>
1675 <xs:appinfo>
1676 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
1677 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="ServiceInstall" />
1678 <xse:remarks>
1679 Nesting a ServiceConfig element under a ServiceInstall element will result in the service being installed to be configured.
1680 Nesting a ServiceConfig element under a component element will result in an already installed service to be configured. If the service does not exist prior to the install of the MSI package, the install will fail.
1681 </xse:remarks>
1682 </xs:appinfo>
1683 </xs:annotation>
1684 <xs:complexType>
1685 <xs:choice minOccurs="0" maxOccurs="unbounded">
1686 <xs:any namespace="##other" processContents="lax">
1687 <xs:annotation>
1688 <xs:documentation>
1689 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1690 elements at this point in the schema.
1691 </xs:documentation>
1692 </xs:annotation>
1693 </xs:any>
1694 </xs:choice>
1695 <xs:attribute name="ServiceName" type="xs:string">
1696 <xs:annotation>
1697 <xs:documentation>Required if not under a ServiceInstall element.</xs:documentation>
1698 </xs:annotation>
1699 </xs:attribute>
1700 <xs:attribute name="FirstFailureActionType" use="required">
1701 <xs:annotation>
1702 <xs:documentation>Action to take on the first failure of the service.</xs:documentation>
1703 </xs:annotation>
1704 <xs:simpleType>
1705 <xs:restriction base="xs:NMTOKEN">
1706 <xs:enumeration value="none" />
1707 <xs:enumeration value="reboot" />
1708 <xs:enumeration value="restart" />
1709 <xs:enumeration value="runCommand" />
1710 </xs:restriction>
1711 </xs:simpleType>
1712 </xs:attribute>
1713 <xs:attribute name="SecondFailureActionType" use="required">
1714 <xs:annotation>
1715 <xs:documentation>Action to take on the second failure of the service.</xs:documentation>
1716 </xs:annotation>
1717 <xs:simpleType>
1718 <xs:restriction base="xs:NMTOKEN">
1719 <xs:enumeration value="none" />
1720 <xs:enumeration value="reboot" />
1721 <xs:enumeration value="restart" />
1722 <xs:enumeration value="runCommand" />
1723 </xs:restriction>
1724 </xs:simpleType>
1725 </xs:attribute>
1726 <xs:attribute name="ThirdFailureActionType" use="required">
1727 <xs:annotation>
1728 <xs:documentation>Action to take on the third failure of the service.</xs:documentation>
1729 </xs:annotation>
1730 <xs:simpleType>
1731 <xs:restriction base="xs:NMTOKEN">
1732 <xs:enumeration value="none" />
1733 <xs:enumeration value="reboot" />
1734 <xs:enumeration value="restart" />
1735 <xs:enumeration value="runCommand" />
1736 </xs:restriction>
1737 </xs:simpleType>
1738 </xs:attribute>
1739 <xs:attribute name="ResetPeriodInDays" type="wxs:Integer">
1740 <xs:annotation>
1741 <xs:documentation>Number of days after which to reset the failure count to zero if there are no failures.</xs:documentation>
1742 </xs:annotation>
1743 </xs:attribute>
1744 <xs:attribute name="RestartServiceDelayInSeconds" type="wxs:Integer">
1745 <xs:annotation>
1746 <xs:documentation>If any of the three *ActionType attributes is "restart", this specifies the number of seconds to wait before doing so.</xs:documentation>
1747 </xs:annotation>
1748 </xs:attribute>
1749 <xs:attribute name="ProgramCommandLine" type="xs:string">
1750 <xs:annotation>
1751 <xs:documentation>If any of the three *ActionType attributes is "runCommand", this specifies the command to run when doing so. This value is formatted.</xs:documentation>
1752 </xs:annotation>
1753 </xs:attribute>
1754 <xs:attribute name="RebootMessage" type="xs:string">
1755 <xs:annotation>
1756 <xs:documentation>If any of the three *ActionType attributes is "reboot", this specifies the message to broadcast to server users before doing so.</xs:documentation>
1757 </xs:annotation>
1758 </xs:attribute>
1759 <xs:anyAttribute namespace="##other" processContents="lax">
1760 <xs:annotation>
1761 <xs:documentation>
1762 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1763 attributes at this point in the schema.
1764 </xs:documentation>
1765 </xs:annotation>
1766 </xs:anyAttribute>
1767 </xs:complexType>
1768 </xs:element>
1769
1770 <xs:element name="TouchFile">
1771 <xs:annotation>
1772 <xs:documentation>Updates the last modified date/time of a file.</xs:documentation>
1773 <xs:appinfo>
1774 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
1775 </xs:appinfo>
1776 </xs:annotation>
1777 <xs:complexType>
1778 <xs:choice minOccurs="0" maxOccurs="unbounded">
1779 <xs:any namespace="##other" processContents="lax">
1780 <xs:annotation>
1781 <xs:documentation>
1782 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1783 elements at this point in the schema.
1784 </xs:documentation>
1785 </xs:annotation>
1786 </xs:any>
1787 </xs:choice>
1788 <xs:attribute name="Id" type="xs:string">
1789 <xs:annotation>
1790 <xs:documentation>Identifier for the touch file operation. If the identifier is not specified it will be generated.</xs:documentation>
1791 </xs:annotation>
1792 </xs:attribute>
1793 <xs:attribute name="Path" use="required" type="xs:string">
1794 <xs:annotation>
1795 <xs:documentation>Path of the file to update. This value is formatted.</xs:documentation>
1796 </xs:annotation>
1797 </xs:attribute>
1798 <xs:attribute name="OnInstall" type="wxs:YesNoTypeUnion">
1799 <xs:annotation>
1800 <xs:documentation>Specifies whether or not the modified time of the file should be updated on install. If the OnInstall, OnReinstall and OnUninstall attributes are all absent the default is 'yes'.</xs:documentation>
1801 </xs:annotation>
1802 </xs:attribute>
1803 <xs:attribute name="OnReinstall" type="wxs:YesNoTypeUnion">
1804 <xs:annotation>
1805 <xs:documentation>Specifies whether or not the modified time of the file should be updated on reinstall. If the OnInstall, OnReinstall and OnUninstall attributes are all absent the default is 'yes'.</xs:documentation>
1806 </xs:annotation>
1807 </xs:attribute>
1808 <xs:attribute name="OnUninstall" type="wxs:YesNoTypeUnion">
1809 <xs:annotation>
1810 <xs:documentation>Specifies whether or not the modified time of the file should be updated on uninstall. If the OnInstall, OnReinstall and OnUninstall attributes are all absent the default is 'no'.</xs:documentation>
1811 </xs:annotation>
1812 </xs:attribute>
1813 <xs:attribute name="Nonvital" type="wxs:YesNoTypeUnion">
1814 <xs:annotation>
1815 <xs:documentation>Indicates the installation will succeed even if the modified time of the file cannot be updated. The default is 'no'.</xs:documentation>
1816 </xs:annotation>
1817 </xs:attribute>
1818 <xs:anyAttribute namespace="##other" processContents="lax">
1819 <xs:annotation>
1820 <xs:documentation>
1821 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1822 attributes at this point in the schema.
1823 </xs:documentation>
1824 </xs:annotation>
1825 </xs:anyAttribute>
1826 </xs:complexType>
1827 </xs:element>
1828
1829 <xs:element name="User">
1830 <xs:annotation>
1831 <xs:documentation>User for all kinds of things. When it is not nested under a component it is included in the MSI so it can be referenced by other elements such as the User attribute in the AppPool element. When it is nested under a Component element, the User will be created on install and can also be used for reference.</xs:documentation>
1832 <xs:appinfo>
1833 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
1834 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
1835 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Module" />
1836 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Package" />
1837 <xse:seeAlso ref="Group" />
1838 <xse:seeAlso ref="GroupRef" />
1839 </xs:appinfo>
1840 </xs:annotation>
1841 <xs:complexType>
1842 <xs:choice minOccurs="0" maxOccurs="unbounded">
1843 <xs:element ref="GroupRef" minOccurs="0" maxOccurs="unbounded" />
1844 <xs:any namespace="##other" processContents="lax">
1845 <xs:annotation>
1846 <xs:documentation>
1847 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1848 elements at this point in the schema.
1849 </xs:documentation>
1850 </xs:annotation>
1851 </xs:any>
1852 </xs:choice>
1853 <xs:attribute name="Id" type="xs:string" />
1854 <xs:attribute name="Name" type="xs:string" use="required">
1855 <xs:annotation>
1856 <xs:documentation>A [Formatted])(https://learn.microsoft.com/en-us/windows/win32/msi/formatted) string that contains the name of the user account.</xs:documentation>
1857 </xs:annotation>
1858 </xs:attribute>
1859 <xs:attribute name="Domain" type="xs:string">
1860 <xs:annotation>
1861 <xs:documentation>A [Formatted])(https://learn.microsoft.com/en-us/windows/win32/msi/formatted) string that contains the local machine or Active Directory domain for the user.</xs:documentation>
1862 </xs:annotation>
1863 </xs:attribute>
1864 <xs:attribute name="Password" type="xs:string">
1865 <xs:annotation>
1866 <xs:documentation>Usually a Property that is passed in on the command-line to keep it more secure.</xs:documentation>
1867 </xs:annotation>
1868 </xs:attribute>
1869 <xs:attribute name="PasswordNeverExpires" type="wxs:YesNoTypeUnion">
1870 <xs:annotation>
1871 <xs:documentation>The account's password never expires. Equivalent to UF_DONT_EXPIRE_PASSWD.</xs:documentation>
1872 </xs:annotation>
1873 </xs:attribute>
1874 <xs:attribute name="CanNotChangePassword" type="wxs:YesNoTypeUnion">
1875 <xs:annotation>
1876 <xs:documentation>The user cannot change the account's password. Equivalent to UF_PASSWD_CANT_CHANGE.</xs:documentation>
1877 </xs:annotation>
1878 </xs:attribute>
1879 <xs:attribute name="RemoveOnUninstall" type="wxs:YesNoTypeUnion">
1880 <xs:annotation>
1881 <xs:documentation>Indicates whether the user account should be removed or left behind on uninstall.</xs:documentation>
1882 </xs:annotation>
1883 </xs:attribute>
1884 <xs:attribute name="FailIfExists" type="wxs:YesNoTypeUnion">
1885 <xs:annotation>
1886 <xs:documentation>Indicates if the install should fail if the user already exists.</xs:documentation>
1887 </xs:annotation>
1888 </xs:attribute>
1889 <xs:attribute name="LogonAsService" type="wxs:YesNoTypeUnion">
1890 <xs:annotation>
1891 <xs:documentation>Indicates whether or not the user can logon as a serivce. User creation can be skipped if all that is desired is to set this access right on the user.</xs:documentation>
1892 </xs:annotation>
1893 </xs:attribute>
1894 <xs:attribute name="LogonAsBatchJob" type="wxs:YesNoTypeUnion">
1895 <xs:annotation>
1896 <xs:documentation>Indicates whether or not the user can logon as a batch job. User creation can be skipped if all that is desired is to set this access right on the user.</xs:documentation>
1897 </xs:annotation>
1898 </xs:attribute>
1899 <xs:attribute name="UpdateIfExists" type="wxs:YesNoTypeUnion">
1900 <xs:annotation>
1901 <xs:documentation>Indicates if the user account properties should be updated if the user already exists.</xs:documentation>
1902 </xs:annotation>
1903 </xs:attribute>
1904 <xs:attribute name="PasswordExpired" type="wxs:YesNoTypeUnion">
1905 <xs:annotation>
1906 <xs:documentation>Indicates whether the user must change their password on their first login.</xs:documentation>
1907 </xs:annotation>
1908 </xs:attribute>
1909 <xs:attribute name="Disabled" type="wxs:YesNoTypeUnion">
1910 <xs:annotation>
1911 <xs:documentation>The account is disabled. Equivalent to UF_ACCOUNTDISABLE.</xs:documentation>
1912 </xs:annotation>
1913 </xs:attribute>
1914 <xs:attribute name="CreateUser" type="wxs:YesNoTypeUnion">
1915 <xs:annotation>
1916 <xs:documentation>Indicates whether or not to create the user. User creation can be skipped if all that is desired is to join a user to groups.</xs:documentation>
1917 </xs:annotation>
1918 </xs:attribute>
1919 <xs:attribute name="Vital" type="wxs:YesNoTypeUnion">
1920 <xs:annotation>
1921 <xs:documentation>Indicates whether failure to create the user or add the user to a group fails the installation. The default value is "yes".</xs:documentation>
1922 </xs:annotation>
1923 </xs:attribute>
1924 <xs:attribute name="Comment" type="xs:string">
1925 <xs:annotation>
1926 <xs:documentation>Optional comment to set on the user.</xs:documentation>
1927 </xs:annotation>
1928 </xs:attribute>
1929 <xs:attribute name="RemoveComment" type="wxs:YesNoTypeUnion">
1930 <xs:annotation>
1931 <xs:documentation>Indicates whether remove the comment from the user. The default value is "no".</xs:documentation>
1932 </xs:annotation>
1933 </xs:attribute>
1934 <xs:anyAttribute namespace="##other" processContents="lax">
1935 <xs:annotation>
1936 <xs:documentation>
1937 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1938 attributes at this point in the schema.
1939 </xs:documentation>
1940 </xs:annotation>
1941 </xs:anyAttribute>
1942 </xs:complexType>
1943 </xs:element>
1944
1945 <xs:element name="WindowsFeatureSearch">
1946 <xs:annotation>
1947 <xs:documentation>Detects the existence of a Windows feature.</xs:documentation>
1948 <xs:appinfo>
1949 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Bundle" />
1950 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
1951 </xs:appinfo>
1952 </xs:annotation>
1953 <xs:complexType>
1954 <xs:choice minOccurs="0" maxOccurs="unbounded">
1955 <xs:any namespace="##other" processContents="lax">
1956 <xs:annotation>
1957 <xs:documentation>
1958 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1959 elements at this point in the schema.
1960 </xs:documentation>
1961 </xs:annotation>
1962 </xs:any>
1963 </xs:choice>
1964 <xs:attributeGroup ref="SearchCommonAttributes" />
1965 <xs:attribute name="Feature" use="required">
1966 <xs:annotation>
1967 <xs:documentation>The feature to detect.</xs:documentation>
1968 </xs:annotation>
1969 <xs:simpleType>
1970 <xs:restriction base="xs:NMTOKEN">
1971 <xs:enumeration value="sha2CodeSigning">
1972 <xs:annotation>
1973 <xs:documentation>The oldest OS with this feature is Win7 SP1 with KB3033929.</xs:documentation>
1974 </xs:annotation>
1975 </xs:enumeration>
1976 </xs:restriction>
1977 </xs:simpleType>
1978 </xs:attribute>
1979 <xs:anyAttribute namespace="##other" processContents="lax">
1980 <xs:annotation>
1981 <xs:documentation>
1982 Extensibility point in the WiX XML Schema. Schema extensions can register additional
1983 attributes at this point in the schema.
1984 </xs:documentation>
1985 </xs:annotation>
1986 </xs:anyAttribute>
1987 </xs:complexType>
1988 </xs:element>
1989
1990 <xs:element name="WindowsFeatureSearchRef">
1991 <xs:annotation>
1992 <xs:documentation>References a WindowsFeatureSearch.</xs:documentation>
1993 <xs:appinfo>
1994 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Bundle" />
1995 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
1996 </xs:appinfo>
1997 </xs:annotation>
1998 <xs:complexType>
1999 <xs:choice minOccurs="0" maxOccurs="unbounded">
2000 <xs:any namespace="##other" processContents="lax">
2001 <xs:annotation>
2002 <xs:documentation>
2003 Extensibility point in the WiX XML Schema. Schema extensions can register additional
2004 elements at this point in the schema.
2005 </xs:documentation>
2006 </xs:annotation>
2007 </xs:any>
2008 </xs:choice>
2009 <xs:attribute name="Id" type="xs:string" use="required" />
2010 <xs:anyAttribute namespace="##other" processContents="lax">
2011 <xs:annotation>
2012 <xs:documentation>
2013 Extensibility point in the WiX XML Schema. Schema extensions can register additional
2014 attributes at this point in the schema.
2015 </xs:documentation>
2016 </xs:annotation>
2017 </xs:anyAttribute>
2018 </xs:complexType>
2019 </xs:element>
2020
2021 <xs:element name="XmlFile">
2022 <xs:annotation>
2023 <xs:documentation>
2024 Adds or removes .xml file entries. If you use the XmlFile element you must reference WixUtilExtension.dll as it contains the XmlFile custom actions.
2025 </xs:documentation>
2026 <xs:appinfo>
2027 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
2028 </xs:appinfo>
2029 </xs:annotation>
2030 <xs:complexType>
2031 <xs:choice minOccurs="0" maxOccurs="unbounded">
2032 <xs:any namespace="##other" processContents="lax">
2033 <xs:annotation>
2034 <xs:documentation>
2035 Extensibility point in the WiX XML Schema. Schema extensions can register additional
2036 elements at this point in the schema.
2037 </xs:documentation>
2038 </xs:annotation>
2039 </xs:any>
2040 </xs:choice>
2041 <xs:attribute name="Id" type="xs:string">
2042 <xs:annotation>
2043 <xs:documentation>Identifier for xml file modification.</xs:documentation>
2044 </xs:annotation>
2045 </xs:attribute>
2046 <xs:attribute name="ElementPath" type="xs:string" use="required">
2047 <xs:annotation>
2048 <xs:documentation>The XPath of the element to be modified. Note that this is a formatted field and therefore, square brackets in the XPath must be escaped. In addition, XPaths allow backslashes to be used to escape characters, so if you intend to include literal backslashes, you must escape them as well by doubling them in this attribute. The string is formatted by MSI first, and the result is consumed as the XPath.</xs:documentation>
2049 </xs:annotation>
2050 </xs:attribute>
2051 <xs:attribute name="File" type="xs:string" use="required">
2052 <xs:annotation>
2053 <xs:documentation>Path of the .xml file to configure.</xs:documentation>
2054 </xs:annotation>
2055 </xs:attribute>
2056 <xs:attribute name="Name" type="xs:string">
2057 <xs:annotation>
2058 <xs:documentation>Name of XML node to set/add to the specified element. Not setting this attribute causes the element's text value to be set. Otherwise this specified the attribute name that is set.</xs:documentation>
2059 </xs:annotation>
2060 </xs:attribute>
2061 <xs:attribute name="Value" type="xs:string">
2062 <xs:annotation>
2063 <xs:documentation>
2064 The value to be written. See the <html:a href="http://msdn.microsoft.com/library/aa368609(VS.85).aspx" target="_blank">Formatted topic</html:a> for information how to escape square brackets in the value.
2065 </xs:documentation>
2066 </xs:annotation>
2067 </xs:attribute>
2068 <xs:attribute name="Action" use="required">
2069 <xs:annotation>
2070 <xs:documentation>The type of modification to be made to the XML file when the component is installed.</xs:documentation>
2071 </xs:annotation>
2072 <xs:simpleType>
2073 <xs:restriction base="xs:NMTOKEN">
2074 <xs:enumeration value="createElement">
2075 <xs:annotation>
2076 <xs:documentation>Creates a new element under the element specified in ElementPath. The Name attribute is required in this case and specifies the name of the new element. The Value attribute is not necessary when createElement is specified as the action. If the Value attribute is set, it will cause the new element's text value to be set.</xs:documentation>
2077 </xs:annotation>
2078 </xs:enumeration>
2079 <xs:enumeration value="deleteValue">
2080 <xs:annotation>
2081 <xs:documentation>Deletes a value from the element specified in the ElementPath. If Name is specified, the attribute with that name is deleted. If Name is not specified, the text value of the element specified in the ElementPath is deleted. The Value attribute is ignored if deleteValue is the action specified.</xs:documentation>
2082 </xs:annotation>
2083 </xs:enumeration>
2084 <xs:enumeration value="setValue">
2085 <xs:annotation>
2086 <xs:documentation>Sets a value in the element specified in the ElementPath. If Name is specified, and attribute with that name is set to the value specified in Value. If Name is not specified, the text value of the element is set. Value is a required attribute if setValue is the action specified.</xs:documentation>
2087 </xs:annotation>
2088 </xs:enumeration>
2089 <xs:enumeration value="bulkSetValue">
2090 <xs:annotation>
2091 <xs:documentation>Sets all the values in the elements that match the ElementPath. If Name is specified, attributes with that name are set to the same value specified in Value. If Name is not specified, the text values of the elements are set. Value is a required attribute if setBulkValue is the action specified.</xs:documentation>
2092 </xs:annotation>
2093 </xs:enumeration>
2094 </xs:restriction>
2095 </xs:simpleType>
2096 </xs:attribute>
2097 <xs:attribute name="Permanent" type="wxs:YesNoTypeUnion">
2098 <xs:annotation>
2099 <xs:documentation>Specifies whether or not the modification should be removed on uninstall. This has no effect on uninstall if the action was deleteValue.</xs:documentation>
2100 </xs:annotation>
2101 </xs:attribute>
2102 <xs:attribute name="PreserveModifiedDate" type="wxs:YesNoTypeUnion">
2103 <xs:annotation>
2104 <xs:documentation>Specifies wheter or not the modification should preserve the modified date. Preserving the modified date will allow the file to be patched if no other modifications have been made.</xs:documentation>
2105 </xs:annotation>
2106 </xs:attribute>
2107 <xs:attribute name="Sequence" type="wxs:Integer">
2108 <xs:annotation>
2109 <xs:documentation>Specifies the order in which the modification is to be attempted on the XML file. It is important to ensure that new elements are created before you attempt to add an attribute to them.</xs:documentation>
2110 </xs:annotation>
2111 </xs:attribute>
2112 <xs:attribute name="SelectionLanguage">
2113 <xs:annotation>
2114 <xs:documentation>
2115 Specify whether the DOM object should use XPath language or the old XSLPattern language (default) as the query language.
2116 </xs:documentation>
2117 </xs:annotation>
2118 <xs:simpleType>
2119 <xs:restriction base="xs:NMTOKEN">
2120 <xs:enumeration value="XPath" />
2121 <xs:enumeration value="XSLPattern" />
2122 </xs:restriction>
2123 </xs:simpleType>
2124 </xs:attribute>
2125 <xs:anyAttribute namespace="##other" processContents="lax">
2126 <xs:annotation>
2127 <xs:documentation>
2128 Extensibility point in the WiX XML Schema. Schema extensions can register additional
2129 attributes at this point in the schema.
2130 </xs:documentation>
2131 </xs:annotation>
2132 </xs:anyAttribute>
2133 </xs:complexType>
2134 </xs:element>
2135
2136 <xs:element name="XmlConfig">
2137 <xs:annotation>
2138 <xs:documentation>
2139 Adds or removes .xml file entries. If you use the XmlConfig element you must reference WixUtilExtension.dll as it contains the XmlConfig custom actions.
2140 </xs:documentation>
2141 <xs:appinfo>
2142 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
2143 </xs:appinfo>
2144 </xs:annotation>
2145 <xs:complexType>
2146 <xs:choice minOccurs="0" maxOccurs="unbounded">
2147 <xs:element ref="XmlConfig" />
2148 <xs:any namespace="##other" processContents="lax">
2149 <xs:annotation>
2150 <xs:documentation>
2151 Extensibility point in the WiX XML Schema. Schema extensions can register additional
2152 elements at this point in the schema.
2153 </xs:documentation>
2154 </xs:annotation>
2155 </xs:any>
2156 </xs:choice>
2157 <xs:attribute name="Id" type="xs:string">
2158 <xs:annotation>
2159 <xs:documentation>Identifier for xml file modification.</xs:documentation>
2160 </xs:annotation>
2161 </xs:attribute>
2162 <xs:attribute name="Action">
2163 <xs:simpleType>
2164 <xs:restriction base="xs:NMTOKEN">
2165 <xs:enumeration value="create" />
2166 <xs:enumeration value="delete" />
2167 </xs:restriction>
2168 </xs:simpleType>
2169 </xs:attribute>
2170 <xs:attribute name="ElementId" type="xs:string">
2171 <xs:annotation>
2172 <xs:documentation>The Id of another XmlConfig to add attributes to. In this case, the 'ElementPath', 'Action', 'Node', and 'On' attributes must be omitted.</xs:documentation>
2173 </xs:annotation>
2174 </xs:attribute>
2175 <xs:attribute name="ElementPath" type="xs:string">
2176 <xs:annotation>
2177 <xs:documentation>The XPath of the parent element being modified. Note that this is a formatted field and therefore, square brackets in the XPath must be escaped. In addition, XPaths allow backslashes to be used to escape characters, so if you intend to include literal backslashes, you must escape them as well by doubling them in this attribute. The string is formatted by MSI first, and the result is consumed as the XPath.</xs:documentation>
2178 </xs:annotation>
2179 </xs:attribute>
2180 <xs:attribute name="File" type="xs:string" use="required">
2181 <xs:annotation>
2182 <xs:documentation>Path of the .xml file to configure.</xs:documentation>
2183 </xs:annotation>
2184 </xs:attribute>
2185 <xs:attribute name="Name" type="xs:string">
2186 <xs:annotation>
2187 <xs:documentation>Name of XML node to set/add to the specified element. Not setting this attribute causes the element's text value to be set. Otherwise this specified the attribute name that is set.</xs:documentation>
2188 </xs:annotation>
2189 </xs:attribute>
2190 <xs:attribute name="Node">
2191 <xs:simpleType>
2192 <xs:restriction base="xs:NMTOKEN">
2193 <xs:enumeration value="element" />
2194 <xs:enumeration value="value" />
2195 <xs:enumeration value="document" />
2196 </xs:restriction>
2197 </xs:simpleType>
2198 </xs:attribute>
2199 <xs:attribute name="On">
2200 <xs:simpleType>
2201 <xs:restriction base="xs:NMTOKEN">
2202 <xs:enumeration value="install" />
2203 <xs:enumeration value="uninstall" />
2204 </xs:restriction>
2205 </xs:simpleType>
2206 </xs:attribute>
2207 <xs:attribute name="PreserveModifiedDate" type="wxs:YesNoTypeUnion">
2208 <xs:annotation>
2209 <xs:documentation>Specifies wheter or not the modification should preserve the modified date. Preserving the modified date will allow the file to be patched if no other modifications have been made.</xs:documentation>
2210 </xs:annotation>
2211 </xs:attribute>
2212 <xs:attribute name="Sequence" type="wxs:Integer">
2213 <xs:annotation>
2214 <xs:documentation>Specifies the order in which the modification is to be attempted on the XML file. It is important to ensure that new elements are created before you attempt to add an attribute to them.</xs:documentation>
2215 </xs:annotation>
2216 </xs:attribute>
2217 <xs:attribute name="Value" type="xs:string">
2218 <xs:annotation>
2219 <xs:documentation>
2220 The value to be written. See the <html:a href="https://docs.microsoft.com/en-us/windows/win32/msi/formatted" target="_blank">Formatted topic</html:a> for information how to escape square brackets in the value.
2221 </xs:documentation>
2222 </xs:annotation>
2223 </xs:attribute>
2224 <xs:attribute name="VerifyPath" type="xs:string">
2225 <xs:annotation>
2226 <xs:documentation>The XPath to the element being modified. This is required for 'delete' actions. For 'create' actions, VerifyPath is used to decide if the element already exists. Note that this is a formatted field and therefore, square brackets in the XPath must be escaped. In addition, XPaths allow backslashes to be used to escape characters, so if you intend to include literal backslashes, you must escape them as well by doubling them in this attribute. The string is formatted by MSI first, and the result is consumed as the XPath.</xs:documentation>
2227 </xs:annotation>
2228 </xs:attribute>
2229 <xs:anyAttribute namespace="##other" processContents="lax">
2230 <xs:annotation>
2231 <xs:documentation>
2232 Extensibility point in the WiX XML Schema. Schema extensions can register additional
2233 attributes at this point in the schema.
2234 </xs:documentation>
2235 </xs:annotation>
2236 </xs:anyAttribute>
2237 </xs:complexType>
2238 </xs:element>
2239
2240 <xs:element name="BroadcastEnvironmentChange">
2241 <xs:annotation>
2242 <xs:documentation>Schedules the BroadcastEnvironmentChange custom action for the current platform.</xs:documentation>
2243 <xs:appinfo>
2244 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Package" />
2245 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Module" />
2246 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
2247 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="UI" />
2248 </xs:appinfo>
2249 </xs:annotation>
2250 </xs:element>
2251
2252 <xs:element name="BroadcastSettingChange">
2253 <xs:annotation>
2254 <xs:documentation>Schedules the BroadcastSettingChange custom action for the current platform.</xs:documentation>
2255 <xs:appinfo>
2256 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Package" />
2257 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Module" />
2258 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
2259 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="UI" />
2260 </xs:appinfo>
2261 </xs:annotation>
2262 </xs:element>
2263
2264 <xs:element name="CheckRebootRequired">
2265 <xs:annotation>
2266 <xs:documentation>Schedules the CheckRebootRequired custom action for the current platform.</xs:documentation>
2267 <xs:appinfo>
2268 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Package" />
2269 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Module" />
2270 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
2271 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="UI" />
2272 </xs:appinfo>
2273 </xs:annotation>
2274 </xs:element>
2275
2276 <xs:element name="ExitEarlyWithSuccess">
2277 <xs:annotation>
2278 <xs:documentation>Schedules the ExitEarlyWithSuccess custom action for the current platform.</xs:documentation>
2279 <xs:appinfo>
2280 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Package" />
2281 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Module" />
2282 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
2283 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="UI" />
2284 </xs:appinfo>
2285 </xs:annotation>
2286 </xs:element>
2287
2288 <xs:element name="FailWhenDeferred">
2289 <xs:annotation>
2290 <xs:documentation>Schedules the FailWhenDeferred custom action for the current platform.</xs:documentation>
2291 <xs:appinfo>
2292 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Package" />
2293 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Module" />
2294 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
2295 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="UI" />
2296 </xs:appinfo>
2297 </xs:annotation>
2298 </xs:element>
2299
2300 <xs:element name="WaitForEvent">
2301 <xs:annotation>
2302 <xs:documentation>Schedules the WaitForEvent custom action for the current platform.</xs:documentation>
2303 <xs:appinfo>
2304 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Package" />
2305 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Module" />
2306 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
2307 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="UI" />
2308 </xs:appinfo>
2309 </xs:annotation>
2310 </xs:element>
2311
2312 <xs:element name="WaitForEventDeferred">
2313 <xs:annotation>
2314 <xs:documentation>Schedules the WaitForEventDeferred custom action for the current platform.</xs:documentation>
2315 <xs:appinfo>
2316 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Package" />
2317 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Module" />
2318 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
2319 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="UI" />
2320 </xs:appinfo>
2321 </xs:annotation>
2322 </xs:element>
2323
2324 <xs:element name="QueryNativeMachine">
2325 <xs:annotation>
2326 <xs:documentation>
2327 Schedules the QueryNativeMachine custom action for the current platform. For more information, see [QueryNativeMachine properties](../../../tools/wixext/wininfo#querynativemachine).
2328 </xs:documentation>
2329 <xs:appinfo>
2330 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Package" />
2331 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Module" />
2332 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
2333 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="UI" />
2334 </xs:appinfo>
2335 </xs:annotation>
2336 </xs:element>
2337
2338 <xs:element name="QueryWindowsDirectories">
2339 <xs:annotation>
2340 <xs:documentation>
2341 Schedules the QueryOsDirs custom action for the current platform. For more information, see [QueryWindowsDirectories properties](../../../tools/wixext/wininfo#querywindowsdirectories).
2342 </xs:documentation>
2343 <xs:appinfo>
2344 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Package" />
2345 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Module" />
2346 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
2347 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="UI" />
2348 </xs:appinfo>
2349 </xs:annotation>
2350 </xs:element>
2351
2352 <xs:element name="QueryWindowsDriverInfo">
2353 <xs:annotation>
2354 <xs:documentation>
2355 Schedules the QueryOsDriverInfo custom action for the current platform. For more information, see [QueryWindowsDriverInfo properties](../../../tools/wixext/wininfo#querywindowsdriverinfo).
2356 </xs:documentation>
2357 <xs:appinfo>
2358 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Package" />
2359 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Module" />
2360 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
2361 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="UI" />
2362 </xs:appinfo>
2363 </xs:annotation>
2364 </xs:element>
2365
2366 <xs:element name="QueryWindowsSuiteInfo">
2367 <xs:annotation>
2368 <xs:documentation>
2369 Schedules the QueryOsInfo custom action for the current platform. For more information, see [QueryWindowsSuiteInfo properties](../../../tools/wixext/wininfo#querywindowssuiteinfo).
2370 </xs:documentation>
2371 <xs:appinfo>
2372 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Package" />
2373 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Module" />
2374 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
2375 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="UI" />
2376 </xs:appinfo>
2377 </xs:annotation>
2378 </xs:element>
2379
2380 <xs:element name="QueryWindowsWellKnownSIDs">
2381 <xs:annotation>
2382 <xs:documentation>
2383 Schedules the QueryOsWellKnownSID custom action for the current platform. For more information, see [QueryWindowsWellKnownSIDs properties](../../../tools/wixext/wininfo#querywindowswellknownsids).
2384 </xs:documentation>
2385 <xs:documentation>Schedules the QueryOsWellKnownSID custom action for the current platform.</xs:documentation>
2386 <xs:appinfo>
2387 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Package" />
2388 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Module" />
2389 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
2390 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="UI" />
2391 </xs:appinfo>
2392 </xs:annotation>
2393 </xs:element>
2394
2395 <xs:attributeGroup name="SearchCommonAttributes">
2396 <xs:attribute name="Id" type="xs:string">
2397 <xs:annotation>
2398 <xs:documentation>Id of the search for ordering and dependency.</xs:documentation>
2399 </xs:annotation>
2400 </xs:attribute>
2401 <xs:attribute name="Variable" type="xs:string" use="required">
2402 <xs:annotation>
2403 <xs:documentation>Name of the variable in which to place the result of the search.</xs:documentation>
2404 </xs:annotation>
2405 </xs:attribute>
2406 <xs:attribute name="Condition" type="xs:string">
2407 <xs:annotation>
2408 <xs:documentation>Condition for evaluating the search. If this evaluates to false, the search is not executed at all.</xs:documentation>
2409 </xs:annotation>
2410 </xs:attribute>
2411 <xs:attribute name="After" type="xs:string">
2412 <xs:annotation>
2413 <xs:documentation>Id of the search that this one should come after.</xs:documentation>
2414 </xs:annotation>
2415 </xs:attribute>
2416 </xs:attributeGroup>
2417
2418 <xs:simpleType name="PerformanceCounterLanguageType">
2419 <xs:annotation>
2420 <xs:documentation>Enumeration of valid languages for performance counters.</xs:documentation>
2421 </xs:annotation>
2422 <xs:restriction base="xs:NMTOKEN">
2423 <xs:enumeration value="afrikaans" />
2424 <xs:enumeration value="albanian" />
2425 <xs:enumeration value="arabic" />
2426 <xs:enumeration value="armenian" />
2427 <xs:enumeration value="assamese" />
2428 <xs:enumeration value="azeri" />
2429 <xs:enumeration value="basque" />
2430 <xs:enumeration value="belarusian" />
2431 <xs:enumeration value="bengali" />
2432 <xs:enumeration value="bulgarian" />
2433 <xs:enumeration value="catalan" />
2434 <xs:enumeration value="chinese" />
2435 <xs:enumeration value="croatian" />
2436 <xs:enumeration value="czech" />
2437 <xs:enumeration value="danish" />
2438 <xs:enumeration value="divehi" />
2439 <xs:enumeration value="dutch" />
2440 <xs:enumeration value="english" />
2441 <xs:enumeration value="estonian" />
2442 <xs:enumeration value="faeroese" />
2443 <xs:enumeration value="farsi" />
2444 <xs:enumeration value="finnish" />
2445 <xs:enumeration value="french" />
2446 <xs:enumeration value="galician" />
2447 <xs:enumeration value="georgian" />
2448 <xs:enumeration value="german" />
2449 <xs:enumeration value="greek" />
2450 <xs:enumeration value="gujarati" />
2451 <xs:enumeration value="hebrew" />
2452 <xs:enumeration value="hindi" />
2453 <xs:enumeration value="hungarian" />
2454 <xs:enumeration value="icelandic" />
2455 <xs:enumeration value="indonesian" />
2456 <xs:enumeration value="italian" />
2457 <xs:enumeration value="japanese" />
2458 <xs:enumeration value="kannada" />
2459 <xs:enumeration value="kashmiri" />
2460 <xs:enumeration value="kazak" />
2461 <xs:enumeration value="konkani" />
2462 <xs:enumeration value="korean" />
2463 <xs:enumeration value="kyrgyz" />
2464 <xs:enumeration value="latvian" />
2465 <xs:enumeration value="lithuanian" />
2466 <xs:enumeration value="macedonian" />
2467 <xs:enumeration value="malay" />
2468 <xs:enumeration value="malayalam" />
2469 <xs:enumeration value="manipuri" />
2470 <xs:enumeration value="marathi" />
2471 <xs:enumeration value="mongolian" />
2472 <xs:enumeration value="nepali" />
2473 <xs:enumeration value="norwegian" />
2474 <xs:enumeration value="oriya" />
2475 <xs:enumeration value="polish" />
2476 <xs:enumeration value="portuguese" />
2477 <xs:enumeration value="punjabi" />
2478 <xs:enumeration value="romanian" />
2479 <xs:enumeration value="russian" />
2480 <xs:enumeration value="sanskrit" />
2481 <xs:enumeration value="serbian" />
2482 <xs:enumeration value="sindhi" />
2483 <xs:enumeration value="slovak" />
2484 <xs:enumeration value="slovenian" />
2485 <xs:enumeration value="spanish" />
2486 <xs:enumeration value="swahili" />
2487 <xs:enumeration value="swedish" />
2488 <xs:enumeration value="syriac" />
2489 <xs:enumeration value="tamil" />
2490 <xs:enumeration value="tatar" />
2491 <xs:enumeration value="telugu" />
2492 <xs:enumeration value="thai" />
2493 <xs:enumeration value="turkish" />
2494 <xs:enumeration value="ukrainian" />
2495 <xs:enumeration value="urdu" />
2496 <xs:enumeration value="uzbek" />
2497 <xs:enumeration value="vietnamese" />
2498 </xs:restriction>
2499 </xs:simpleType>
2500
2501 <xs:simpleType name="PerformanceCounterTypesType">
2502 <xs:annotation>
2503 <xs:documentation>Enumeration of valid types for performance counters.</xs:documentation>
2504 </xs:annotation>
2505 <xs:restriction base="xs:NMTOKEN">
2506 <xs:enumeration value="averageBase" />
2507 <xs:enumeration value="averageCount64" />
2508 <xs:enumeration value="averageTimer32" />
2509 <xs:enumeration value="counterDelta32" />
2510 <xs:enumeration value="counterTimerInverse" />
2511 <xs:enumeration value="sampleFraction" />
2512 <xs:enumeration value="timer100Ns" />
2513 <xs:enumeration value="counterTimer" />
2514 <xs:enumeration value="rawFraction" />
2515 <xs:enumeration value="timer100NsInverse" />
2516 <xs:enumeration value="counterMultiTimer" />
2517 <xs:enumeration value="counterMultiTimer100Ns" />
2518 <xs:enumeration value="counterMultiTimerInverse" />
2519 <xs:enumeration value="counterMultiTimer100NsInverse" />
2520 <xs:enumeration value="elapsedTime" />
2521 <xs:enumeration value="sampleBase" />
2522 <xs:enumeration value="rawBase" />
2523 <xs:enumeration value="counterMultiBase" />
2524 <xs:enumeration value="rateOfCountsPerSecond64" />
2525 <xs:enumeration value="rateOfCountsPerSecond32" />
2526 <xs:enumeration value="countPerTimeInterval64" />
2527 <xs:enumeration value="countPerTimeInterval32" />
2528 <xs:enumeration value="sampleCounter" />
2529 <xs:enumeration value="counterDelta64" />
2530 <xs:enumeration value="numberOfItems64" />
2531 <xs:enumeration value="numberOfItems32" />
2532 <xs:enumeration value="numberOfItemsHEX64" />
2533 <xs:enumeration value="numberOfItemsHEX32" />
2534 </xs:restriction>
2535 </xs:simpleType>
2536</xs:schema>
diff --git a/src/xsd/vs.xsd b/src/xsd/vs.xsd
new file mode 100644
index 00000000..f233db92
--- /dev/null
+++ b/src/xsd/vs.xsd
@@ -0,0 +1,140 @@
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 xmlns:wxs="http://wixtoolset.org/schemas/v4/wxs"
9 targetNamespace="http://wixtoolset.org/schemas/v4/wxs/vs"
10 xmlns="http://wixtoolset.org/schemas/v4/wxs/vs">
11 <xs:annotation>
12 <xs:documentation>
13 The source code schema for the WiX Toolset Visual Studio Extension.
14 </xs:documentation>
15 </xs:annotation>
16
17 <xs:import namespace="http://wixtoolset.org/schemas/v4/wxs" />
18
19 <xs:element name="FindVisualStudio">
20 <xs:annotation>
21 <xs:documentation>
22 This element detects which, if any, Visual Studio instances are installed. If so, it sets
23 the appropriate property or properties: `VS2017_ROOT_FOLDER`, `VS2019_ROOT_FOLDER`, or
24 `VS2022_ROOT_FOLDER`.
25 </xs:documentation>
26 <xs:appinfo>
27 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Fragment" />
28 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Module" />
29 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Package" />
30 </xs:appinfo>
31 </xs:annotation>
32 <xs:complexType>
33 <xs:choice minOccurs="0" maxOccurs="unbounded">
34 <xs:any namespace="##other" processContents="lax">
35 <xs:annotation>
36 <xs:documentation>
37 Extensibility point in the WiX XML Schema. Schema extensions can register additional
38 elements at this point in the schema.
39 </xs:documentation>
40 </xs:annotation>
41 </xs:any>
42 </xs:choice>
43 </xs:complexType>
44 </xs:element>
45
46 <xs:element name="VsixPackage">
47 <xs:annotation>
48 <xs:documentation>
49 This element provides the metdata required to install/uninstall a file as
50 a VSIX Package. The VSIX package file will be installed as part of the MSI
51 then passed to the VSIX installer to install the VSIX package. To avoid the
52 duplication, simply use the MSI to install the VSIX package itself.
53 </xs:documentation>
54 <xs:appinfo>
55 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
56 <xse:parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="File" />
57 </xs:appinfo>
58 </xs:annotation>
59 <xs:complexType>
60 <xs:choice minOccurs="0" maxOccurs="unbounded">
61 <xs:any namespace="##other" processContents="lax">
62 <xs:annotation>
63 <xs:documentation>
64 Extensibility point in the WiX XML Schema. Schema extensions can register additional
65 elements at this point in the schema.
66 </xs:documentation>
67 </xs:annotation>
68 </xs:any>
69 </xs:choice>
70 <xs:attribute name="File" type="xs:string">
71 <xs:annotation>
72 <xs:documentation>
73 Reference to file identifer. This attribute is required when the element is not a
74 child of a File element and is invalid when the element is a child of the File element.
75 </xs:documentation>
76 </xs:annotation>
77 </xs:attribute>
78 <xs:attribute name="PackageId" type="xs:string" use="required">
79 <xs:annotation>
80 <xs:documentation>
81 Identity of the VSIX package per its internal manifest. If this value is not correct
82 the VSIX package will not correctly uninstall.
83 </xs:documentation>
84 </xs:annotation>
85 </xs:attribute>
86 <xs:attribute name="Permanent" type="wxs:YesNoTypeUnion">
87 <xs:annotation>
88 <xs:documentation>
89 Indicates whether the VSIX package is uninstalled when the parent Component is uninstalled.
90 The default is 'no'.
91 </xs:documentation>
92 </xs:annotation>
93 </xs:attribute>
94 <xs:attribute name="Target" type="xs:string">
95 <xs:annotation>
96 <xs:documentation>
97 Specifies the SKU of Visual Studio in which to register the extension. If no target
98 is specified the extension is registered with all installed SKUs. If the Target
99 attribute is specified the TargetVersion attribute must also be specified. The
100 following is a list of known Visual Studio targets: integratedShell, professional,
101 premium, ultimate, vbExpress, vcExpress, vcsExpress, vwdExpress
102 </xs:documentation>
103 </xs:annotation>
104 </xs:attribute>
105 <xs:attribute name="TargetVersion" type="wxs:VersionType">
106 <xs:annotation>
107 <xs:documentation>
108 Specifies the version of Visual Studio in which to register the extension. This attribute
109 is required if the Target attribute is specified.
110 </xs:documentation>
111 </xs:annotation>
112 </xs:attribute>
113 <xs:attribute name="Vital" type="wxs:YesNoTypeUnion">
114 <xs:annotation>
115 <xs:documentation>
116 Indicates whether failure to install the VSIX package causes the installation to rollback.
117 The default is 'yes'.
118 </xs:documentation>
119 </xs:annotation>
120 </xs:attribute>
121 <xs:attribute name="VsixInstallerPathProperty" type="xs:string">
122 <xs:annotation>
123 <xs:documentation>
124 Optional reference to a Property element that contains the path to the VsixInstaller.exe.
125 By default, the latest VsixInstaller.exe on the machine will be used to install the VSIX
126 package. It is highly recommended that this attribute is *not* used.
127 </xs:documentation>
128 </xs:annotation>
129 </xs:attribute>
130 <xs:anyAttribute namespace="##other" processContents="lax">
131 <xs:annotation>
132 <xs:documentation>
133 Extensibility point in the WiX XML Schema. Schema extensions can register additional
134 attributes at this point in the schema.
135 </xs:documentation>
136 </xs:annotation>
137 </xs:anyAttribute>
138 </xs:complexType>
139 </xs:element>
140</xs:schema>
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>
diff --git a/src/xsd/wixloc.xsd b/src/xsd/wixloc.xsd
new file mode 100644
index 00000000..094324cf
--- /dev/null
+++ b/src/xsd/wixloc.xsd
@@ -0,0 +1,167 @@
1<?xml version="1.0" encoding="utf-8"?>
2<!-- Copyright (c) .NET Foundation and contributors. All rights reserved. Licensed under the Microsoft Reciprocal License. See LICENSE.TXT file in the project root for full license information. -->
3
4
5<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
6 xmlns:xse="http://wixtoolset.org/schemas/XmlSchemaExtension"
7 xmlns:html="http://www.w3.org/1999/xhtml"
8 targetNamespace="http://wixtoolset.org/schemas/v4/wxl"
9 xmlns="http://wixtoolset.org/schemas/v4/wxl">
10 <xs:annotation>
11 <xs:documentation>
12 Schema for describing WiX Localization files (.wxl).
13 </xs:documentation>
14 </xs:annotation>
15
16 <xs:element name="WixLocalization">
17 <xs:annotation>
18 <xs:appinfo>
19 <xse:remarks>
20 <html:p>You can specify any valid Windows code page by integer like 1252, or by web name like Windows-1252 or iso-8859-1. See [Code pages](../../tools/codepage.md) for more information.</html:p>
21 </xse:remarks>
22 <xse:howtoRef href="ui_and_localization/build_a_localized_version.html">How To: Build a localized version of your installer</xse:howtoRef>
23 <xse:howtoRef href="ui_and_localization/make_installer_localizable.html">How To: Make your installer localizable</xse:howtoRef>
24 </xs:appinfo>
25 </xs:annotation>
26 <xs:complexType>
27 <xs:choice minOccurs="0" maxOccurs="unbounded">
28 <xs:element ref="String" />
29 <xs:element ref="UI" />
30 </xs:choice>
31 <xs:attribute name="Codepage" type="xs:string">
32 <xs:annotation>
33 <xs:documentation>Optional code page integer value or web name for the resulting database. You can also specify -1 which will not reset the database code page. See remarks for more information.</xs:documentation>
34 </xs:annotation>
35 </xs:attribute>
36 <xs:attribute name="Culture" type="xs:string">
37 <xs:annotation>
38 <xs:documentation>Optional culture for this localization file. If the Culture attribute is not provided, the localization file is considered to be language neutral. This culture value is used to filter applicable localization files during the build. Language neutral localization files are always included.</xs:documentation>
39 </xs:annotation>
40 </xs:attribute>
41 <xs:attribute name="ExtensionDefaultCulture" type="LocalizationYesNoType">
42 <xs:annotation>
43 <xs:documentation>[WiX v5] Optional. Indicates that the localization file's culture is the default culture for a WiX Extension. Only valid when used in a WiX library included in a WiX Extension..</xs:documentation>
44 </xs:annotation>
45 </xs:attribute>
46 <xs:attribute name="Language" type="Integer">
47 <xs:annotation>
48 <xs:documentation>The decimal language ID (LCID) for the culture. Used only when processed by native code using locutil.</xs:documentation>
49 </xs:annotation>
50 </xs:attribute>
51 <xs:attribute name="SummaryInformationCodepage" type="xs:string">
52 <xs:annotation>
53 <xs:documentation>Optional code page integer value or web name for the resulting database's SummaryInformation. If not specified, the SummaryInformation codepage will be set to the same value from the Codepage attribute. If no codepage is provided, the SummaryInformation will default to the ANSI codepage. See remarks for more information.</xs:documentation>
54 </xs:annotation>
55 </xs:attribute>
56 </xs:complexType>
57 </xs:element>
58
59 <xs:element name="String">
60 <xs:annotation>
61 <xs:appinfo>
62 <xse:howtoRef href="ui_and_localization/build_a_localized_version.html">How To: Build a localized version of your installer</xse:howtoRef>
63 <xse:howtoRef href="ui_and_localization/make_installer_localizable.html">How To: Make your installer localizable</xse:howtoRef>
64 </xs:appinfo>
65 </xs:annotation>
66 <xs:complexType>
67 <xs:attribute name="Id" type="xs:string" use="required">
68 <xs:annotation>
69 <xs:documentation>Identity of the localized string. Referenced in .wxs files using `!(loc.Id)` or in locutil using `#(loc.Id)`.</xs:documentation>
70 </xs:annotation>
71 </xs:attribute>
72 <xs:attribute name="Overridable" type="LocalizationYesNoType">
73 <xs:annotation>
74 <xs:documentation>Determines if the localized string may be overridden by a definition in another localization file. The default value is `no`.</xs:documentation>
75 </xs:annotation>
76 </xs:attribute>
77 <xs:attribute name="Localizable" type="LocalizationYesNoType">
78 <xs:annotation>
79 <xs:documentation>Indicates whether the string is localizable text or a non-localizable string that must be unique per locale. The value of this attribute is not used by the WiX Toolset. It provided as documentation for localizers to ignore things like GUIDs or identifiers that look like text.</xs:documentation>
80 </xs:annotation>
81 </xs:attribute>
82 <xs:attribute name="Value" type="xs:string">
83 <xs:annotation>
84 <xs:documentation>The localized value for this string.</xs:documentation>
85 </xs:annotation>
86 </xs:attribute>
87 </xs:complexType>
88 </xs:element>
89
90 <xs:element name="UI">
91 <xs:annotation>
92 <xs:documentation>Allows a localization to override the position, size, and text of dialogs and controls.</xs:documentation>
93 </xs:annotation>
94 <xs:complexType mixed="true">
95 <xs:attribute name="Dialog" type="xs:string">
96 <xs:annotation>
97 <xs:documentation>Identifies the dialog to localize or the dialog that a control to localize is in.</xs:documentation>
98 </xs:annotation>
99 </xs:attribute>
100 <xs:attribute name="Control" type="xs:string">
101 <xs:annotation>
102 <xs:documentation>Combined with the Dialog attribute, identifies the control to localize.</xs:documentation>
103 </xs:annotation>
104 </xs:attribute>
105 <xs:attribute name="X" type="Integer">
106 <xs:annotation>
107 <xs:documentation>For a dialog, overrides the authored horizontal centering. For a control, overrides the authored horizontal coordinate of the upper-left corner of the rectangular boundary. This must be a non-negative number.</xs:documentation>
108 </xs:annotation>
109 </xs:attribute>
110 <xs:attribute name="Y" type="Integer">
111 <xs:annotation>
112 <xs:documentation>For a dialog, overrides the authored vertical centering. For a control, overrides the authored vertical coordinate of the upper-left corner of the rectangular boundary of the control. This must be a non-negative number.</xs:documentation>
113 </xs:annotation>
114 </xs:attribute>
115 <xs:attribute name="Width" type="Integer">
116 <xs:annotation>
117 <xs:documentation>For a dialog, overrides the authored width in dialog units. For a control, overrides the authored width of the rectangular boundary of the control. This must be a non-negative number.</xs:documentation>
118 </xs:annotation>
119 </xs:attribute>
120 <xs:attribute name="Height" type="Integer">
121 <xs:annotation>
122 <xs:documentation>For a dialog, overrides the authored height in dialog units. For a control, overrides the authored height of the rectangular boundary of the control. This must be a non-negative number.</xs:documentation>
123 </xs:annotation>
124 </xs:attribute>
125 <xs:attribute name="RightToLeft" type="LocalizationYesNoType">
126 <xs:annotation>
127 <xs:documentation>Set this attribute to "yes" to cause the Control to display from right to left. Not valid for a dialog.</xs:documentation>
128 </xs:annotation>
129 </xs:attribute>
130 <xs:attribute name="RightAligned" type="LocalizationYesNoType">
131 <xs:annotation>
132 <xs:documentation>Set this attribute to "yes" to cause the Control to be right aligned. Not valid for a dialog.</xs:documentation>
133 </xs:annotation>
134 </xs:attribute>
135 <xs:attribute name="LeftScroll" type="LocalizationYesNoType">
136 <xs:annotation>
137 <xs:documentation>Set this attribute to "yes" to cause the scroll bar to display on the left side of the Control. Not valid for a dialog.</xs:documentation>
138 </xs:annotation>
139 </xs:attribute>
140 <xs:attribute name="Text" type="xs:string">
141 <xs:annotation>
142 <xs:documentation>Override the text of a UI element.</xs:documentation>
143 </xs:annotation>
144 </xs:attribute>
145 </xs:complexType>
146 </xs:element>
147
148 <xs:simpleType name="Integer">
149 <xs:annotation>
150 <xs:documentation>Values of this type must be an integer or a preprocessor variable with the format `$(Variable)` or `$(var.Variable).</xs:documentation>
151 </xs:annotation>
152 <xs:restriction base="xs:string">
153 <xs:pattern value="[\d]+|\$\((var\.)?[_A-Za-z][0-9A-Za-z_.]*\)" />
154 </xs:restriction>
155 </xs:simpleType>
156 <xs:simpleType name="LocalizationYesNoType">
157 <xs:annotation>
158 <xs:documentation>Values of this type will either be "yes"/"true" or "no"/"false".</xs:documentation>
159 </xs:annotation>
160 <xs:restriction base="xs:NMTOKEN">
161 <xs:enumeration value="no" />
162 <xs:enumeration value="false" />
163 <xs:enumeration value="yes" />
164 <xs:enumeration value="true" />
165 </xs:restriction>
166 </xs:simpleType>
167</xs:schema>
generated by cgit v1.2.3-55-g6feb (git 2.39.1) at 2025-03-19 22:06:50 +0000