deployment:Extension (in Package/Extensions)
Deklariert einen Erweiterbarkeitspunkt für die App, die einen nicht angedockten Bereitstellungserweiterungshandler (DEH) angibt.
Elementhierarchie
<deployment:Extension>
Syntax
<deployment:Extension
Category = 'A string that can have one of the following values: "windows.deploymentExtensionHandler".'
Executable = 'An optional string with a value between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or *. It specifies the default executable for the extension. If not specified, the executable defined for the app is used. If specified, the EntryPoint property is also used. If that EntryPoint property isnt specified, the EntryPoint defined for the app is used.'
EntryPoint = 'An optional string with a value between 1 and 256 characters in length, representing the task handling the extension. This is normally the fully namespace-qualified name of a Windows Runtime type. If EntryPoint is not specified, the EntryPoint defined for the app is used instead.'
RuntimeType = 'An optional string with a value between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *.'
StartPage = 'An optional string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
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 alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
uap10:Parameters = 'An optional string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
uap11:Id = 'An optional string with a value 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 with a value between 1 and 255 characters in length. Must begin with a letter.'
uap11:CurrentDirectoryPath = 'An optional string that cannot contain these characters: <, >, |, ?, or *. >'
uap11:Parameters = 'An optional string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
desktop7:CompatMode = 'An optional string the 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 -->
deployment:DeploymentExtensionHandler?
</deployment:Extension>
Schlüssel
?
optional (null oder 1)
Attribute und Elemente
Attribute
attribute | BESCHREIBUNG | Datentyp | Erforderlich | Standardwert |
---|---|---|---|---|
Kategorie | Die Kategorie der Erweiterung. | Eine Zeichenfolge, die einen der folgenden Werte aufweisen kann: windows.fileExplorerClassicContextMenuHandler oder windows.fileExplorerClassicDragDropContextMenuHandler. | Yes | |
Ausführbare Datei | Die ausführbare Standardstartdatei. | Eine optionale Zeichenfolge mit einem Wert zwischen 1 und 256 Zeichen, der mit enden .exe muss und nicht enthalten kann: < , > , : , " , | , ? oder * . Es gibt die standardmäßige ausführbare Datei für die Erweiterung an. Wenn nicht angegeben, wird die für die App definierte ausführbare Datei verwendet. Wenn angegeben, wird auch die EntryPoint-Eigenschaft verwendet. Wenn diese EntryPoint-Eigenschaft nicht angegeben wird, wird der für die App definierte EntryPoint verwendet. |
No | |
EntryPoint | Die aktivierbare Klassen-ID. | Eine optionale Zeichenfolge mit einem Wert zwischen 1 und 256 Zeichen, der die Aufgabe darstellt, die die Erweiterung behandelt. Dies ist normalerweise der vollständig qualifizierte Namespacename eines Windows-Runtime-Typs. Wenn EntryPoint nicht angegeben ist, wird stattdessen der für die App definierte EntryPoint verwendet. | No | |
Runtimetype | Der Laufzeitanbieter. Dieses Attribut wird in der Regel verwendet, wenn in einer App gemischte Frameworks vorhanden sind. | Eine optionale Zeichenfolge mit einem Wert zwischen 1 und 255 Zeichen, die nicht mit einem Punkt beginnen oder enden kann oder die folgende Zeichen enthält: < , > , : , " , / \ , | , ? oder * . |
No | |
StartPage | Die Webseite, die den Erweiterungspunkt behandelt. | Eine optionale Zeichenfolge mit einem Wert zwischen 1 und 256 Zeichen, die diese Zeichen nicht enthalten darf: < , > , : , " , | , ? oder * . |
No | |
uap10:TrustLevel | Gibt die Vertrauensstufe der Erweiterung an. | Eine optionale Zeichenfolge, die einen der folgenden Werte aufweisen kann: appContainer oder mediumIL. | No | |
uap10:RuntimeBehavior | Gibt das Laufzeitverhalten der Erweiterung an. | Eine optionale Zeichenfolge, die einen der folgenden Werte aufweisen kann: windowsApp, packagedClassicApp oder win32App. | No | |
uap10:HostId | Gibt die ID der Hostruntime für die Erweiterung an. | Eine alphanumerische Zeichenfolge mit einem Wert zwischen 1 und 255 Zeichen. Muss mit einem Buchstaben beginnen. | No | |
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 mit einem Wert zwischen 1 und 32767 Zeichen länge mit einem Leerzeichen am Anfang und Ende. | No | |
uap11:ID | Ein Bezeichner für die Erweiterung. Die ID muss für alle Erweiterungen in einem Paket eindeutig sein. | Eine optionale Zeichenfolge mit einem Wert zwischen 1 und 255 Zeichen länge und einem Leerzeichen am Anfang und Ende. | No | |
uap11:Subsystem | Dieses Attribut wird von der Syntax der Basiserweiterung geerbt und gilt nicht für die com4-Erweiterung. Abgesehen von der syntaktischen Validierung wird dieser Wert ignoriert. | Eine optionale Zeichenfolge, die einen der folgenden Werte aufweisen kann: Konsole oder Fenster. | No | |
uap11:SupportsMultipleInstances | Gibt an, ob Instanzen in verschiedenen Prozessen ausgeführt werden sollen. Der Standardwert ist „FALSE“. | Ein optionaler boolescher Wert. | No | |
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 freiform und flexibel. Siehe Application@ResourceGroup. | Eine optionale alphanumerische Zeichenfolge mit einem Wert zwischen 1 und 255 Zeichen. Muss mit einem Buchstaben beginnen. | No | |
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 * . > |
No | |
uap11:Parameter | Dieses Attribut wird von der Syntax der Basiserweiterung geerbt und gilt nicht für die com4-Erweiterung. Abgesehen von der syntaktischen Validierung wird dieser Wert ignoriert. Dieses Attribut unterstützt Makros. Weitere Informationen finden Sie unter Makros im Paketmanifestschema. | Eine optionale Zeichenfolge mit einem Wert zwischen 1 und 32767 Zeichen länge mit einem Leerzeichen am Anfang und Ende. | No | |
desktop7:CompatMode | Gibt an, ob die Informationen dieser Erweiterung bei Windows auf klassische Weise (z. B. unpacking apps register types with COM über the registry) oder auf neue, umfassendere Weise bei Windows registriert werden. Der Standardwert ist "modern". CompatMode="classic" erfordert die Microsoft.classicAppCompat_8wekyb3d8bbwe-Funktion . | Eine optionale Zeichenfolge, die einen der folgenden Werte aufweisen kann: klassisch oder modern. | No | |
desktop7:Bereich | Gibt an, ob die Registrierungen nur für andere Anwendungen sichtbar sind, die als Benutzer ausgeführt werden, für den dieses Paket registriert ist (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 oder Benutzer. | No |
Untergeordnete Elemente
Untergeordnetes Element | Beschreibung |
---|---|
DeploymentExtensionHandler | Ermöglicht einer App, eine oder mehrere DLL-Dateien anzugeben, die DEH-Funktionen bereitstellen, die außerhalb einer Betriebssystemversion ausgeliefert werden. |
Übergeordnete Elemente
Übergeordnetes Element | BESCHREIBUNG |
---|---|
Erweiterungen | Definiert einen oder mehrere Erweiterbarkeitspunkte für die App. |
Hinweise
Ein DEH ermöglicht Apps den Zugriff auf Erweiterbarkeitspunkte im Betriebssystem. Eine nicht angedockte DEH ist eine, die außerhalb eines Betriebssystemreleases ausgeliefert wird. Diese Erweiterung ist nicht für die Verwendung durch Drittanbieterentwickler vorgesehen.
Beispiele
Das folgende Beispiel zeigt die Verwendung des DeploymentExtensionHandler-Elements in einer Paketmanifestdatei, um eine nicht abgedockte DEH zu registrieren.
<Extension Category=”windows.deploymentExtensionHandler”>
<DeploymentExtensionHandler>
<Files>
<File>path/to/UndockedDEH.dll </File>
<File>path/to/UndockedDEH2.dll </File>
</Files>
</DeploymentExtensionHandler>
</Extension>
Anforderungen
Element | Wert |
---|---|
Namespace | http://schemas.microsoft.com/appx/manifest/deployment/windows10 |
uap10 | http://schemas.microsoft.com/appx/manifest/uap/windows10/10 |
uap11 | http://schemas.microsoft.com/appx/manifest/uap/windows10/11 |
desktop7 | http://schemas.microsoft.com/appx/manifest/desktop/windows10/7 |
Minimum OS Version | Windows 10 (Build 20348) |