Partager via


desktop2 :Extension (dans package/extensions)

Déclare un point d’extensibilité pour l’application.

Hiérarchie d’éléments

<Paquet>

    <Extensions>

         <desktop2:Extension>

Syntax

<Extension
  Category = 'A string that can have one of the following values: "windows.firewallRules" or "windows.desktopEventLogging".' 
  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 optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
  uap10:Parameters = 'A string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.' >

  <!-- Child elements -->
  desktop2:FirewallRules
  desktop2:DesktopEventLogging?

</uap:Extension>

Clé :

? facultatif (zéro ou un)

Attributs et éléments

Attributs

Attribut Description Type de données Obligatoire Valeur par défaut
Catégorie Catégorie de l’extension. Chaîne qui peut avoir l’une des valeurs suivantes : windows.firewallRules ou windows.desktopEventLogging. Yes
Exécutable Exécutable de lancement par défaut. Chaîne facultative avec une valeur comprise entre 1 et 256 caractères qui doit se terminer par .exe et ne peut pas contenir ces caractères : <, >, :", |, , ?ou *. Il spécifie l’exécutable par défaut de l’extension. S’il n’est pas spécifié, l’exécutable défini pour l’application est utilisé. Si elle est spécifiée, la propriété EntryPoint est également utilisée. Si cette propriété EntryPoint n’est pas spécifiée, l’élément EntryPoint défini pour l’application est utilisé. No
EntryPoint ID de classe activable. Chaîne facultative avec une valeur comprise entre 1 et 256 caractères, représentant la tâche qui gère l’extension. Il s’agit généralement du nom complet de l’espace de noms d’un type Windows Runtime. Si EntryPoint n’est pas spécifié, l’élément EntryPoint défini pour l’application est utilisé à la place. No
RuntimeType Fournisseur d’exécution. Cet attribut est généralement utilisé quand il existe des frameworks mixtes dans une application. Chaîne facultative avec une valeur comprise entre 1 et 255 caractères qui ne peut pas commencer ou se terminer par un point ou contenir les caractères suivants : <, >, ":, /, \, |, , ?, ou *. No
StartPage La page web qui gère le point d’extensibilité. Chaîne facultative avec une valeur comprise entre 1 et 256 caractères qui ne peut pas contenir ces caractères : <, >, :, "|, , ?, ou *. No
uap10 :TrustLevel Spécifie le niveau de confiance de l’extension. Chaîne facultative qui peut avoir l’une des valeurs suivantes : appContainer ou mediumIL. No
uap10 :RuntimeBehavior Spécifie le comportement au moment de l’exécution de l’extension. Chaîne facultative qui peut avoir l’une des valeurs suivantes : windowsApp, packagedClassicApp ou win32App. No
uap10 :HostId Spécifie l’ID du runtime hôte pour l’extension. Chaîne alphanumérique facultative avec une valeur comprise entre 1 et 255 caractères. Doit commencer par une lettre. No
uap10 :Parameters Contient les paramètres de ligne de commande à passer à l’extension. Pris en charge uniquement pour les applications de bureau qui ont une identité de package. Chaîne dont la valeur est comprise entre 1 et 32 767 caractères, avec un caractère non-espace blanc au début et à la fin. No

Éléments enfants

Élément enfant Description
AppPrinter Permet d’installer des imprimantes de fichiers logiciels dans les applications Windows Pont du bureau.
SearchFilterHandler Permet aux applications Windows Pont du bureau d’inscrire des IFilters pour extraire les propriétés de fichier à des fins de recherche.
SearchPropertyHandler Permet aux applications Windows Pont du bureau d’installer des gestionnaires de propriétés sur votre système.
DesktopEventLogging Permet aux applications Windows Pont du bureau de s’inscrire à la journalisation des événements Windows.
FirewallRules Spécifie les règles d’exception de pare-feu utilisées par les applications Windows Pont du bureau.

Éléments parents

Élément parent Description
desktop2:Extension Déclare un point d’extensibilité pour l’application.

Configuration requise

Élément Valeur
Espace de noms http://schemas.microsoft.com/appx/manifest/desktop/windows10/2
uap10 http://schemas.microsoft.com/appx/manifest/uap/windows10/10
Minimum OS Version Windows 10 version 1703 (build 15063)