desktop2 :Extension (dans package/applications)

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

Hiérarchie d’éléments

<package>

     <applications>

          <application>

               <extensions>

                    <desktop2 :Extension>

Syntaxe

<desktop2:Extension
  Category = 'A string that can have one of the following values: "windows.appPrinter", "windows.searchFilterHandler", "windows.searchPropertyHandler", or "windows.mailProvider".'
  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 be one of the following values: "appContainer" or "mediumIL".'
  uap10:RuntimeBehavior = 'An optional string that can be 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 = '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 -->
  desktop2:AppPrinter?
  desktop2:SearchFilterHandler?
  desktop2:SearchPropertyHandler?
  desktop2:DesktopEventLogging?
  desktop2:FirewallRules?

</desktop2: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.appPrinter, windows.searchFilterHandler, windows.searchPropertyHandlerou windows.mailProvider.	Oui
exécutable	Exécutable de lancement par défaut.	Chaîne facultative avec une valeur comprise entre 1 et 256 caractères de longueur 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é.	Non
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 normalement du nom complet qualifié d’espace de noms d’un type Windows Runtime. Si EntryPoint n’est pas spécifié, le Point d’entrée défini pour l’application est utilisé à la place.	Non
runtimeType	Fournisseur d’exécution. Cet attribut est généralement utilisé lorsqu’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 ces caractères : <, >, :, ", /, \, |, ?ou *.	Non
StartPage	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 *.	Non
uap10 :TrustLevel	Spécifie le niveau d’approbation de l’extension.	Chaîne facultative qui peut être l’une des valeurs suivantes : appContainer ou mediumIL.	Non
uap10 :RuntimeBehavior	Spécifie le comportement d’exécution de l’extension.	Chaîne facultative qui peut être l’une des valeurs suivantes : windowsApp, empaquetéClassicAppou win32App.	Non
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.	Non
uap10 :Parameters	Contient des paramètres de ligne de commande à passer à l’extension. Uniquement pris en charge pour les applications de bureau qui ont une identité de package.	Chaîne facultative avec une valeur comprise entre 1 et 32767 caractères de longueur avec un caractère non blanc à son début et à sa fin.	Non
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 de longueur avec un caractère d’espace non blanc au début et à la fin.	Non
uap11 :Sous-système	Sous-système ciblé par l’extension.	Chaîne facultative qui peut avoir l’une des valeurs suivantes : console ou windows.	Non
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.	Non
uap11 :ResourceGroup	Balise que vous pouvez utiliser pour regrouper les activations d’extension à des fins de gestion des ressources (par exemple, processeur et mémoire). La valeur que vous pouvez définir ResourceGroup est 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.	Non
uap11 :CurrentDirectoryPath	Spécifie le répertoire initial lorsque le processus d’application est lancé. Cet attribut prend en charge les macros. Pour plus d’informations, consultez Macros dans le schéma de manifeste de package.	Chaîne facultative qui ne peut pas contenir ces caractères : <, >, |, ?ou *. >	Non
uap11 :Parameters	Sous-système ciblé par l’extension. Cet attribut prend en charge les macros. Pour plus d’informations, consultez Macros dans le schéma de manifeste de package.	Chaîne facultative avec une valeur comprise entre 1 et 32767 caractères de longueur avec un caractère non blanc à son début et à sa fin.	Non
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 auprès de COM via le Registre) ou de nouvelles façons plus étendues. La valeur par défaut est « moderne ». CompatMode="classic » nécessite la fonctionnalité de Microsoft.classicAppCompat_8wekyb3d8bbwe.	Une chaîne facultative peut avoir l’une des valeurs suivantes : classique ou moderne .	Non
desktop7 :Scope	Spécifie si les inscriptions ne sont visibles que par d’autres applications s’exécutant en tant qu’utilisateur disposant de ce package inscrit (utilisateur), ou s’ils 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é de Microsoft.classicAppCompatElevated_8wekyb3d8bbwe.	Chaîne facultative qui peut avoir l’une des valeurs suivantes : machine ou utilisateur.	Non

Éléments enfants

Élément enfant	Description
AppPrinter	Permet d’installer des imprimantes de fichiers logiciels dans les applications Pont de bureau Windows.
searchFilterHandler	Permet aux applications Pont de bureau Windows d’inscrire des IFilters pour extraire les propriétés de fichier pour la recherche.
SearchPropertyHandler	Permet aux applications Pont de bureau Windows d’installer des gestionnaires de propriétés sur votre système.
DesktopEventLogging	Permet aux applications Pont de bureau Windows 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 Pont de bureau Windows.

Éléments parents

Élément parent	Description
extensions	Définit un ou plusieurs points d’extensibilité pour l’application.

Remarques

windows.mailProvider est une déclaration d’extension vide qui est un point d’entrée pour les applications de messagerie afin d’affiner les .dll correctes pour gérer les demandes d’API de messagerie. Cela doit être utilisé dans une application de confiance totale.

Exigences

Article	Valeur
Namespace	http://schemas.microsoft.com/appx/manifest/desktop/windows10/2
uap10	http://schemas.microsoft.com/appx/manifest/uap/windows10/10
version minimale du système d’exploitation	Windows 10 version 1703 (build 15063)