aboutsummaryrefslogtreecommitdiff
path: root/src/xsd/http/UrlReservation.xsd
blob: 1788918b752897ef11929b9ec30237c6a6f83a8f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
<element name="UrlReservation">
    <annotation>
      <documentation>
        Makes a reservation record for the HTTP Server API configuration store on Windows XP SP2,
        Windows Server 2003, and later.  For more information about the HTTP Server API, see
        [HTTP Server API](https://learn.microsoft.com/en-us/windows/win32/http/http-api-start-page).
      </documentation>
      <appinfo>
        <parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="Component" />
        <parent namespace="http://wixtoolset.org/schemas/v4/wxs" ref="ServiceInstall" />
      </appinfo>
    </annotation>

    <complexType>
      <choice minOccurs="0" maxOccurs="unbounded">
        <annotation>
          <documentation>
            The access control entries for the access control list.
          </documentation>
        </annotation>
        <element ref="UrlAce" />
        <any namespace="##other" processContents="lax">
          <annotation>
            <documentation>
              Extensibility point in the WiX XML Schema. Schema extensions can register additional
              elements at this point in the schema.
            </documentation>
          </annotation>
        </any>
      </choice>

      <attribute name="HandleExisting">
        <annotation>
          <documentation>
            Specifies the behavior when trying to install a URL reservation and it already exists.
          </documentation>
        </annotation>
        <simpleType>
          <restriction base="xs:NMTOKEN">
            <enumeration value="replace">
              <annotation>
                <documentation>
                  Replaces the existing URL reservation (the default).
                </documentation>
              </annotation>
            </enumeration>
            <enumeration value="ignore">
              <annotation>
                <documentation>
                  Keeps the existing URL reservation.
                </documentation>
              </annotation>
            </enumeration>
            <enumeration value="fail">
              <annotation>
                <documentation>
                  The installation fails.
                </documentation>
              </annotation>
            </enumeration>
          </restriction>
        </simpleType>
      </attribute>

      <attribute name="Id" type="xs:string">
        <annotation>
          <documentation>
            Unique ID of this URL reservation.
            If this attribute is not specified, an identifier will be generated automatically.
          </documentation>
        </annotation>
      </attribute>

      <attribute name="Sddl" type="xs:string">
        <annotation>
          <documentation>
            Security descriptor to apply to the URL reservation.
            Can't be specified when using children UrlAce elements.
          </documentation>
        </annotation>
      </attribute>

      <attribute name="Url" type="xs:string" use="required">
        <annotation>
          <documentation>
            The [UrlPrefix](https://learn.microsoft.com/en-us/windows/win32/http/urlprefix-strings)
            string that defines the portion of the URL namespace to which this reservation pertains.
          </documentation>
        </annotation>
      </attribute>

      <anyAttribute namespace="##other" processContents="lax">
        <annotation>
          <documentation>
            Extensibility point in the WiX XML Schema. Schema extensions can register additional
            attributes at this point in the schema.
          </documentation>
        </annotation>
      </anyAttribute>
    </complexType>
  </element>