com :Extension (Windows 10)

Fournit des fonctionnalités permettant d’exposer les inscriptions COM aux clients en dehors du package d’application.

Hiérarchie d’éléments

<Paquet>

    <Applications>

         <Application>

              <Extensions>

                   <com:Extension>

Syntaxe

<com:Extension
  Category = 'A string that can be one of the following values: "windows.comServer" or "windows.comInterface".' 
  uap10:TrustLevel = 'An optional string value that can one of the following value: "appContainer" or "mediumIL".'
  ap10:RuntimeBehavior = 'An optional string with a value 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 -->
  com:ComServer
  com:ComInterface

</com:Extension>

Attributs et éléments

Attributs

Attribut	Description	Type de données	Obligatoire	Valeur par défaut
Catégorie	Type de point d’extensibilité de l’application.	Chaîne qui peut être l’une des valeurs suivantes : windows.comServer ou windows.comInterface.	Yes
uap10 :TrustLevel	Spécifie le niveau de confiance de l’extension.	Valeur de chaîne facultative qui peut être 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 avec une valeur qui peut être 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 facultative dont la valeur est comprise entre 1 et 32767 caractères, avec un caractère sans 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 d’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 des processus différents. 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 lorsque le processus d’application est lancé.	Chaîne facultative qui ne peut pas contenir ces caractères : <, >, |, ?ou *. >	No
uap11 :Parameters	Cet attribut est hérité de la syntaxe d’extension de base et n’est pas applicable à l’extension com4. Outre la validation syntaxique, cette valeur est ignorée.	Chaîne facultative dont la valeur est comprise entre 1 et 32767 caractères, avec un caractère sans 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 auprès de COM via le registre) ou de nouvelles façons plus étendues. La valeur par défaut est « modern ». CompatMode="classic » nécessite la fonctionnalité Microsoft.classicAppCompat_8wekyb3d8bbwe .	Chaîne facultative pouvant avoir l’une des valeurs suivantes : classique ou moderne.	No
desktop7 :Scope	Spécifie si les inscriptions ne sont visibles que par les autres applications exécutées en tant qu’utilisateur ayant inscrit ce package (utilisateur), ou si elles sont visibles par tous les utilisateurs et services sur la machine (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
com:ComServer	Déclare un point d’extension de package de type windows.comServer.
com:ComInterface	Déclare un point d’extension de package de type windows.comInterface.

É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/foundation/windows10
uap10	http://schemas.microsoft.com/appx/manifest/uap/windows10/10
Minimum OS Version	Windows 10 version 1703 (build 15063)