desktop6:Extension

Deklariert einen Erweiterungspunkt für die App.

Elementhierarchie

<Package>
   └─ <Extensions>
      └─ <desktop6:Extension>
   └─ <Applications>
      └─ <Application>
         └─ <Extensions>
            └─ <desktop6:Extension>

Syntax

<desktop6:Extension
  Category = 'A required string that can have one of the following values: "windows.service", "windows.mutablePackageDirectories", or "windows.customInstall".'
  desktop11:AppLifecycleBehavior = 'An optional string that can have one of the following values: "systemManaged", or "unmanaged".'
  Executable = 'An optional string between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or *.'
  EntryPoint = 'An optional string between 1 and 256 characters in length that cannot start or end with a whitespace character.'
  RuntimeType = 'An optional string between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, &#124;, ?, or *.'
  StartPage = 'An optional string between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
  ResourceGroup = 'An optional alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character.'
  uap10:TrustLevel = 'An optional string that can have one of the following values: "appContainer", or "mediumIL".'
  uap10:RuntimeBehavior = 'An optional string that can have one of the following values: "windowsApp", "packagedClassicApp", or "win32App".'
  uap10:HostId = 'An optional alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character.'
  uap10:Parameters = 'An optional string between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
  uap11:Id = 'An optional string between 1 and 255 characters in length with a non-whitespace character at its beginning and end.'
  uap11:Subsystem = 'An optional string that can have one of the following values: "console", or "windows".'
  uap11:SupportsMultipleInstances = 'An optional boolean value.'
  uap11:ResourceGroup = 'An optional alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character.'
  uap11:CurrentDirectoryPath = 'An optional string that cannot contain these characters: <, >, |, ?, or *.'
  uap11:Parameters = 'An optional string between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
  desktop7:CompatMode = 'An optional string that can have one of the following values: "classic", or "modern".'
  desktop7:Scope = 'An optional string that can have one of the following values: "machine", or "user".' >

  <!-- Child elements -->
  desktop6:Service?
  desktop6:MutablePackageDirectories?
  desktop6:CustomInstall?

</desktop6:Extension>

Schlüssel

? optional (null oder eins)

Attribute

Attribut Beschreibung Datentyp Erforderlich Standardwert
Kategorie Die Kategorie der Erweiterung. Eine Zeichenfolge, die einen der folgenden Werte sein muss: windows.service (in Application); windows.mutablePackageDirectories, windows.customInstall (in Package). Ja
desktop11:AppLifecycleBehavior Eine optionale Zeichenfolge, die einen der folgenden Werte aufweisen kann: systemManaged, unmanaged. Nein
Ausführbare Datei Die ausführbare Standardstartdatei. Eine optionale Zeichenfolge zwischen 1 und 256 Zeichen länge, die mit ".exe" enden muss und diese Zeichen nicht enthalten darf: <, , : >, ", ", |, ?, oder *. Nein
EntryPoint Die aktivierbare Klassen-ID. Eine optionale Zeichenfolge zwischen 1 und 256 Zeichen länge, die nicht mit einem Leerzeichen beginnen oder enden kann. Nein
RuntimeType Der Laufzeitanbieter. Dieses Attribut wird in der Regel verwendet, wenn gemischte Frameworks in einer App vorhanden sind. Eine optionale Zeichenfolge zwischen 1 und 255 Zeichen länge, die nicht mit einem Punkt beginnen oder enden kann oder diese Zeichen enthalten kann: <, , : >, ", ", /, |, ?oder *. Nein
StartPage Die Webseite, die den Erweiterungspunkt behandelt. Eine optionale Zeichenfolge zwischen 1 und 256 Zeichen, die diese Zeichen nicht enthalten können: <, , : >, ", ", |, ?, oder *. Nein
ResourceGroup Ein Tag, mit dem Sie Erweiterungsaktivierungen für Ressourcenverwaltungszwecke (z. B. CPU und Arbeitsspeicher) gruppieren können. Eine optionale alphanumerische Zeichenfolge zwischen 1 und 255 Zeichen länge. Muss mit einem alphabetischen Zeichen beginnen. Nein
uap10:TrustLevel Gibt die Vertrauensstufe der Erweiterung an. Eine optionale Zeichenfolge, die einen der folgenden Werte aufweisen kann: appContainer, mediumIL. Nein
uap10:RuntimeBehavior Gibt das Laufzeitverhalten der Erweiterung an. Eine optionale Zeichenfolge, die einen der folgenden Werte aufweisen kann: windowsApp, packagedClassicApp, win32App. Nein
uap10:HostId Gibt die ID der Hostlaufzeit für die Erweiterung an. Eine optionale alphanumerische Zeichenfolge zwischen 1 und 255 Zeichen länge. Muss mit einem alphabetischen Zeichen beginnen. Nein
uap10:Parameters Enthält Befehlszeilenparameter, die an die Erweiterung übergeben werden sollen. Wird nur für Desktop-Apps mit Paketidentität unterstützt. Eine optionale Zeichenfolge zwischen 1 und 32767 Zeichen mit einem Nicht-Leerzeichen am Anfang und Ende. Nein
uap11:Id Ein Bezeichner für die Erweiterung. Die ID muss für alle Erweiterungen in einem Paket eindeutig sein. Eine optionale Zeichenfolge zwischen 1 und 255 Zeichen mit einem Nicht-Leerzeichen am Anfang und Ende. Nein
uap11:Subsystem Das Subsystem, das durch die Erweiterung ausgerichtet ist. Eine optionale Zeichenfolge, die einen der folgenden Werte aufweisen kann: Konsole, Fenster. Nein
uap11:SupportsMultipleInstances Gibt an, ob Instanzen in verschiedenen Prozessen ausgeführt werden sollen. Der Standardwert ist "false". Ein optionaler boolescher Wert. Nein
uap11:ResourceGroup Ein Tag, mit dem Sie Erweiterungsaktivierungen für Ressourcenverwaltungszwecke (z. B. CPU und Arbeitsspeicher) gruppieren können. Der Wert, den Sie resourceGroup festlegen können, ist formfrei und flexibel. Siehe Application@ResourceGroup. Eine optionale alphanumerische Zeichenfolge zwischen 1 und 255 Zeichen länge. Muss mit einem alphabetischen Zeichen beginnen. Nein
uap11:CurrentDirectoryPath Gibt das anfangsverzeichnis an, wenn der Anwendungsprozess gestartet wird. Dieses Attribut unterstützt Makros. Weitere Informationen finden Sie unter "Makros" im Paketmanifestschema. Eine optionale Zeichenfolge, die diese Zeichen nicht enthalten kann: <, , >| , ? oder *. Nein
uap11:Parameters Das Subsystem, das durch die Erweiterung ausgerichtet ist. Dieses Attribut unterstützt Makros. Weitere Informationen finden Sie unter "Makros" im Paketmanifestschema. Eine optionale Zeichenfolge zwischen 1 und 32767 Zeichen mit einem Nicht-Leerzeichen am Anfang und Ende. Nein
desktop7:CompatMode Gibt an, ob die Informationen dieser Erweiterung mit Windows auf klassische Weise registriert werden (z. B. entpackte Apps registrieren Typen mit COM über die Registrierung) oder auf neue, bereichsbezogenere Weise. Der Standardwert ist "modern". CompatMode="classic" erfordert die Microsoft.classicAppCompat_8wekyb3d8bbwe-Funktion . Eine optionale Zeichenfolge, die einen der folgenden Werte aufweisen kann: klassisch, modern. Nein
desktop7:Scope Gibt an, ob die Registrierungen nur für andere Anwendungen sichtbar sind, die als Benutzer ausgeführt werden, der dieses Paket registriert hat (Benutzer), oder ob sie für alle Benutzer und Dienste auf dem Computer (Computer) sichtbar sind. Der Standardwert ist "user". Scope="machine" erfordert die Microsoft.classicAppCompatElevated_8wekyb3d8bbwe-Funktion . Eine optionale Zeichenfolge, die einen der folgenden Werte aufweisen kann: Computer, Benutzer. Nein

Untergeordnete Elemente

Untergeordnetes Element Beschreibung
desktop6:Service- Gibt einen Dienst an, der zusammen mit der App installiert und registriert ist. Diese Dienste können so konfiguriert werden, dass sie entweder unter dem Konto "Lokaler Dienst", "Netzwerkdienst" oder "Lokales System" ausgeführt werden.
desktop6:MutablePackageDirectories Ermöglicht Ihrer Desktopanwendung, einen oder mehrere Ordner anzugeben, in denen Benutzer die Installationsdateien für Ihre Anwendung ändern können (z. B. zum Installieren von Mods).
desktop6:CustomInstall Ermöglicht Ihrer Desktopanwendung, eine oder mehrere zusätzliche Installer-Dateien (.exe oder .msi) anzugeben, die mit Ihrer Desktopanwendung installiert sind. Dies ist beispielsweise nützlich für Apps, die eine weiterverteilbare Komponente eines Drittanbieters bündeln.

Übergeordnete Elemente

Übergeordnetes Element Beschreibung
Extensions (in Package)
Extensions (in Application)

Anforderungen

Artikel Wert
Namespace http://schemas.microsoft.com/appx/manifest/desktop/windows10/6
Desktop11 http://schemas.microsoft.com/appx/manifest/desktop/windows10/11
Desktop7 http://schemas.microsoft.com/appx/manifest/desktop/windows10/7
uap10 http://schemas.microsoft.com/appx/manifest/uap/windows10/10
uap11 http://schemas.microsoft.com/appx/manifest/uap/windows10/11
Mindestversion des Betriebssystems Windows 10 Version 1903 (Build 18362)

Bemerkungen

Beispiele