com4 :ComServer

Article
10/23/2024

Déclare un point d’extension de package de type windows.comServer. L’extension comServer peut inclure des inscriptions de classes, y compris les détails d’activation pour les serveurs qui implémentent ces classes, et les inscriptions ProgId et TreatAsClass, qui fournissent des identificateurs supplémentaires utilisés pour référencer ces classes au moment de l’exécution.

Hiérarchie d’éléments

<com4 :ComServer>

<com4 :ComServer>

Syntaxe

<com4:ComServer>

<!-- Child elements -->
  Class{0,1}
  ExeServer{0,1}
  ServiceServer{0,1}
  SurrogateServer{0,1}
  TreatAsClass{0,1}
  ProgId{0,1}
  InProcessServer{0,1}
  InProcessHandler{0,1}
  ManagedInProcessServer{0,1}
  com5:InProcessServer{0,1}
  com5:InProcessHandler{0,1}

</com4:ComServer>

Clé

{} plage d’occurrences spécifique

Attributs et éléments

Attributs

Aucun.

Éléments enfants

Élément enfant	Description
classe	Définit une inscription de classe dans un serveur COM.
exeServer	Inscrit un ExeServer avec une ou plusieurs inscriptions de classe.
ServiceServer	Inscrit un ServiceServer avec une ou plusieurs inscriptions de classe.
SurrogateServer	Inscrit un surrogateServer avec une ou plusieurs inscriptions de classe.
TreatAsClass	Inscription qui correspond à une inscription CLSID avec la sous-clé TreatAs.
ProgId	Identificateur programmatique (ProgID) qui peut être associé à un CLSID.
InProcessServer	Inscrit un serveur in-process avec une ou plusieurs inscriptions de classe.
InProcessHandler	Inscrit un gestionnaire in-process avec une ou plusieurs inscriptions de classe.
ManagedInProcessServer	Inscrit un serveur in-process managé avec une ou plusieurs inscriptions de classe.
com5 :InProcessServer	Inscrit un serveur in-process avec une ou plusieurs inscriptions de classe. Le schéma com5 introduit des modifications mineures dans la validation syntaxique à partir du schéma com4.
com5 :InProcessHandler	Inscrit un gestionnaire in-process avec une ou plusieurs inscriptions de classe. Le schéma com5 introduit des modifications mineures dans la validation syntaxique à partir du schéma com4.

Éléments parents

Élément parent	Description
com4 :Extension	Fournit des fonctionnalités permettant d’exposer des inscriptions COM aux clients en dehors du package d’application. L’extension com4 est une nouvelle version qui est un super-ensemble de versions de schéma COM et de remplacement pour les versions de schéma COM précédentes.

Remarques

Dans les packages multi-applications, il est important de placer l’inscription du serveur COM sous l’élément manifeste Applications/Application correct, car les processus de serveur COM s’exécutent avec l’identité de l’élément Applications/Application ancêtres.

Les serveurs COM inscrits dans le manifeste obtiennent toujours le comportement d’Activation en tant que package (AAP), ce qui signifie que le serveur COM s’exécute avec le jeton par défaut de session utilisateur avec les revendications de package et d’application ajoutées. Cela diffère du comportement d’activation par défaut des serveurs COM inscrits classiquement, dans lesquels le serveur COM s’exécute avec le jeton du client. Pour la plupart des applications, cette différence ne peut pas être remarquée, car les clients s’exécutent généralement avec le jeton par défaut de session utilisateur. D’autres comportements d’activation, tels que RunAs, ne sont pas pris en charge.

Il est possible d’avoir plusieurs extensions comServer sous l’élément Applications/Application, mais dans la plupart des cas, cela n’est ni nécessaire ni recommandé. Un exemple de cas de périphérie dans lequel plusieurs extensions comServer sont nécessaires est si un package a besoin de certaines des inscriptions pour que CompatMode="classic » tandis que d’autres ont CompatMode="modern », la seule façon de procéder consiste à les fractionner entre les extensions.

Modifications apportées à l’extension com4

La syntaxe d’extension com4 est un nouvel ensemble de la syntaxe d’extension com précédente. Cette version de la syntaxe prend en charge la même structure que les versions antérieures de la syntaxe, où les inscriptions de classes sont représentées par des éléments ExeServer/Class, SurrogateServer/Class, ServiceServer/Class, InProcessServer/Class, InProcessHandler/Class ou ManagedInProcessServer/Class.

La nouvelle syntaxe prend également en charge d’autres structures, où :

ExeServer/ClassReference, SurrogateServer/ClassReference, ServiceServer/ClassReference, InProcessServer/ClassReference, InProcessHandler/ClassReference ou ManagedInProcessServer/ClassReference font référence à des éléments de classe de niveau supérieur

et/ou

Les éléments SurrogateServer/InProcessServerClassReference référencent les éléments InProcessServer/Class (alternativement, InProcessServer/ClassReference) ou ManagedInProcessServer/Class (alternativement, ManagedInProcessServer/ClassReference).

L’objectif principal de la nouvelle structure de syntaxe est d’activer les combinaisons de serveurs in-process, de gestionnaires in-process et d’inscriptions de serveur hors processus pour le même CLSID, comme possible et prises en charge avec la disposition de Registre classique. Pour plus d’informations sur la disposition du Registre COM, consultez clé CLSID.

Exigences

Article	Valeur
espace de noms	`http://schemas.microsoft.com/appx/manifest/com/windows10/4`
version minimale du système d’exploitation	Windows 10 (build 20348)

Partager via