Extension (dans package/extensions) (Windows 10)

  • Article

Déclare un point d’extensibilité pour le package.

Hiérarchie d’éléments

<Paquet>

    <Extensions>

         <Extension>

Syntaxe

<Extension
  Category = 'A string that can have one of the following values: "windows.activatableClass.inProcessServer", "windows.activatableClass.outOfProcessServer", "windows.activatableClass.proxyStub", "windows.certificates", "windows.publisherCacheFolders", "windows.comInterface", or "windows.loaderSearchPathOverride".'
  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 -->
  InProcessServer
  OutOfProcessServer
  ProxyStub
  Certificates
  PublisherCacheFolders
  com:ComInterface
  uap6:LoaderSearchPathOverride

</Extension>

Attributs et éléments

Attributs

Attribut Description Type de données Obligatoire Valeur par défaut
Catégorie Type de point d’extensibilité du package. Chaîne qui peut avoir l’une des valeurs suivantes : windows.activatableClass.inProcessServer, windows.activateableClass.outOfProcessServer, windows.activatableClass.proxyStub, windows.certificates, windows.publisherCacheFolders, windows.comInterface ou windows.loaderSearchPathOverride Yes
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 Cette valeur 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.
uap10 :Parameters Contient les paramètres de ligne de commande de l’extension. Chaîne 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
Certificats Déclare un point d’extensibilité de package de type windows.certificates. L’application nécessite un ou plusieurs certificats des magasins de certificats spécifiés.
InProcessServer Déclare un point d’extensibilité de package de type windows.activateableClass.inProcessServer. L’application utilise une bibliothèque de liens dynamiques (.dll) qui expose une ou plusieurs classes activables.
OutOfProcessServer Déclare un point d’extension de package de type windows.activatableClass.outOfProcessServer. L’application utilise un exécutable (.exe) qui expose une ou plusieurs classes activables.
ProxyStub Déclare un point d’extensibilité de package de type windows.activateableClass.proxyStub. Un proxy peut être composé d’une ou plusieurs interfaces.
PublisherCacheFolders Déclare un point d’extensibilité de package de type windows.publisherCacheFolders. Cela spécifie un ou plusieurs dossiers que le package partage avec d’autres packages du même éditeur.
com:ComInterface Déclare un point d’extension de package de type windows.comInterface.
uap6:LoaderSearchPathOverride Déclare un point d’extension de package de type windows.loaderSearchPathOverride.

Éléments parents

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

Les éléments suivants portent le même nom que celui-ci, mais ils ont un contenu ou des attributs différents :

Remarques

Les points d’extensibilité sont un mécanisme par lequel un package peut ajouter des fonctionnalités d’une manière définie par le système d’exploitation. Un point d’extensibilité est un emplacement où une application peut s’inscrire pour exécuter du code ou utiliser les ressources du package actuel. Pour ajouter des fonctionnalités pour une application particulière, utilisez l’élément Application enfant de l’élément Applications .

Le point d’extensibilité windows.certificates ne peut pas être déclaré plusieurs fois dans un manifeste.

Voir aussi

Configuration requise

Élément Valeur
Espace de noms http://schemas.microsoft.com/appx/manifest/foundation/windows10
Com http://schemas.microsoft.com/appx/manifest/com/windows10
uap6 http://schemas.microsoft.com/appx/manifest/uap/windows10/10