desktop7 :Extension (dans package/applications)

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

Hiérarchie d’éléments

<Package>

    <Applications>

         <Application>

              <Extensions>

                   <desktop7 :Extension>

Syntax

<desktop7:Extension
  Category = 'A string that can have one of the following values: "windows.approvedShellExtension", "windows.controlPanelItem", "windows.service", "windows.mailProvider", "windows.shortcut", "windows.applicationRegistration", "windows.desktopAppMigration", "windows.systemFileAssociation", "windows.shadowCopyExcludeFiles", or "windows.errorReporting".'
  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 -->
  desktop7:ApprovedShellExtension?
  desktop7:ControlPanelItem?
  desktop7:Service?
  desktop7:MailProvider?
  desktop7:Shortcut?
  desktop7:ApplicationRegistration?
  desktop7:DesktopAppMigration?
  desktop7:SystemFileAssociation?
  desktop7:ShadowCopyExcludeFiles?
  desktop7:ErrorReporting?

</desktop7: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.approvedShellExtension, windows.controlPanelItem, windows.service, windows.mailProvider, windows.shortcut, windows.applicationRegistration, windows.desktopAppMigration, windows.systemFileAssociation, windows.shadowCopyExcludeFiles ou windows.errorReporting.	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 .exe par et ne peut pas contenir les caractères suivants : <, >, ":, |, ?, ou *. Il spécifie l’exécutable par défaut pour 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 dont la valeur est comprise entre 1 et 256 caractères et qui ne peut pas contenir les caractères suivants : <, >, :, ", |, ?ou *.	No
uap10 :TrustLevel	Spécifie le niveau d’approbation 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, empaquetéClassicApp ou win32App.	No
uap10 :HostId	Spécifie l’ID du runtime hôte pour l’extension.	Chaîne alphanumérique 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 facultative avec une valeur comprise entre 1 et 32767 caractères avec un caractère non-espace blanc au début et à la fin.	No
uap11 :Id	Identificateur de l’extension. L’ID doit être unique pour toutes les extensions d’un package.	Chaîne facultative avec une valeur comprise entre 1 et 255 caractères, avec un caractère non-espace blanc au début et à la fin.	No
uap11 :Sous-système	Cet attribut est hérité de la syntaxe de l’extension de base et n’est pas applicable à l’extension com4. Outre la validation syntaxique, cette valeur est ignorée.	Chaîne facultative qui peut avoir l’une des valeurs suivantes : console ou windows.	No
uap11 :SupportsMultipleInstances	Spécifie si les instances doivent s’exécuter dans différents processus. La valeur par défaut est false.	Valeur booléenne facultative.	No
uap11 :ResourceGroup	Balise que vous pouvez utiliser pour regrouper les activations d’extensions à des fins de gestion des ressources (par exemple, processeur et mémoire). La valeur que vous pouvez définir ResourceGroup est de forme libre et flexible. Voir Application@ResourceGroup.	Chaîne alphanumérique facultative avec une valeur comprise entre 1 et 255 caractères. Doit commencer par une lettre.	No
uap11 :CurrentDirectoryPath	Spécifie le répertoire initial lors du lancement du processus d’application.	Chaîne facultative qui ne peut pas contenir les caractères suivants : <, >, |, ?ou *. >	No
uap11 :Parameters	Cet attribut est hérité de la syntaxe de l’extension de base et n’est pas applicable à l’extension com4. Outre la validation syntaxique, cette valeur est ignorée.	Chaîne facultative avec une valeur comprise entre 1 et 32767 caractères avec un caractère non-espace blanc au début et à la fin.	No
desktop7 :CompatMode	Spécifie si les informations de cette extension sont inscrites auprès de Windows de manière classique (par exemple, les applications non empaquetées inscrivent des types avec COM via le registre) ou de nouvelles manières plus étendues. La valeur par défaut est « modern ». CompatMode="classic » nécessite la fonctionnalité Microsoft.classicAppCompat_8wekyb3d8bbwe .	Chaîne facultative le peut avoir l’une des valeurs suivantes : classique ou moderne.	No
desktop7 :Scope	Spécifie si les inscriptions sont visibles uniquement par d’autres applications s’exécutant en tant qu’utilisateur ayant inscrit ce package (utilisateur), ou si elles sont visibles par tous les utilisateurs et services sur l’ordinateur (machine). La valeur par défaut est « user ». Scope="machine » nécessite la fonctionnalité Microsoft.classicAppCompatElevated_8wekyb3d8bbwe .	Chaîne facultative qui peut avoir l’une des valeurs suivantes : machine ou utilisateur.	No

Éléments enfants

Élément enfant	Description
desktop7 :ApprovedShellExtension	Spécifie qu’une extension d’interpréteur de commandes doit être ajoutée à la liste des extensions d’interpréteur de commandes approuvées lors de l’installation.
desktop7 :ControlPanelItem	Inscrit une extension en tant qu’élément du panneau de configuration.
desktop7 :Service	Spécifie un service installé et inscrit avec l’application.
desktop7 :MailProvider	Spécifie un service installé et inscrit avec l’application.
desktop7 :Raccourci	Crée un raccourci vers un fichier.
desktop7 :ApplicationRegistration	Inscrit une application.
desktop7 :DesktopAppMigration	Spécifie un ensemble d’entrées de migration d’application pour les vignettes et les broches.
desktop7 :SystemFileAssociation	Inscrit les associations de fichiers système pour une application.
desktop7 :ShadowCopyExcludeFiles	Spécifie un ensemble de fichiers à exclure par le service VSS (Volume Shadow Copy Service).
desktop7 :ErrorReporting	Spécifie un ensemble de fichiers à exclure par le service VSS (Volume Shadow Copy Service).

Éléments parents

Élément parent	Description
Extensions (type : CT_ApplicationExtensions)	Définit un ou plusieurs points d’extensibilité pour l’application.

Configuration requise

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