com :Class (dans SurrogateServer/Class)

Article
10/30/2023

Définit une inscription de classe SurrogateServer.

Hiérarchie d’éléments

<com:Extension>

<com:ComServer>

<com:SurrogateServer>

<com :Class>

Syntax

<com:Class
    Id = 'A GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.'
    Path = 'A string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
    ThreadingModel = 'A string that can be one of the following values: "Both", "STA", "MTA", "MainSTA", "Neutral".'
    DisplayName = 'An optional string with a value between 1 and 256 characters in length. This string is localizable.'
    EnableOleDefaultHandler = 'An optional boolean value.'
    ProgId = 'An optional alphanumeric string separated by a period with a value between 1 and 255 characters in length (for example, Foo.Bar or Foo.Bar.1)'
    VersionIndependentProgId = 'An optional alphanumeric string separated by a period with a value between 1 and 255 characters in length (for example, Foo.Bar or Foo.Bar.1)'
    AutoConvertTo = 'An optional GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.'
    InsertableObject = 'An optional boolean value.'
    ShortDisplayName = 'An optional string with a value between 1 and 40 characters in length.' >

  <!-- Child elements -->
  ( ImplementedCategories,
  Conversion?,
  DataFormats?,
  MiscStatus?,
  Verbs?,
  DefaultIcon?,
  ToolboxBitmap32? 
  )

</com:Class>

Clé :

? facultatif (zéro ou un)

Attributs et éléments

Attributs

Attribut	Description	Type de données	Obligatoire
Id	L’attribut ID correspond au CLSID.	GUID sous la forme xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.	Yes
Chemin d’accès	Chemin d’accès complet à la DLL de la classe de substitution.	Chaîne dont la valeur est comprise entre 1 et 256 caractères et qui ne peut pas contenir les caractères suivants : `<`, `>`, `:`, `"\|`, `?`, ou `*`.	Yes
ThreadingModel	Modèle de thread pour le chargement des DLL.	Chaîne qui peut être l’une des valeurs suivantes : Both, STA, MTA, MainSTA, Neutral.	Yes
DisplayName	Chaîne localisable correspondant à la valeur par défaut de la clé du CLSID.	Chaîne facultative avec une valeur comprise entre 1 et 256 caractères.	No
EnableOleDefaultHandler	Cette valeur doit être définie sur true si la valeur par défaut de la clé InprocHandler32 est « Ole32.dll ». Sinon, il doit être omis. La valeur par défaut est false.	Valeur booléenne facultative.	No
ProgId	Associe un identificateur par programme (ProgID) à un CLSID.	Chaîne alphanumérique facultative séparée par un point d’une valeur comprise entre 1 et 255 caractères (par exemple, Foo.Bar ou Foo.Bar.1)	No
VersionIndependentProgId	Associe un ProgID à un CLSID. Cette valeur est utilisée pour déterminer la dernière version d’une application objet.	Chaîne alphanumérique facultative séparée par un point d’une valeur comprise entre 1 et 255 caractères (par exemple, Foo.Bar ou Foo.Bar.1)	No
AutoConvertTo	Spécifie la conversion automatique d’une classe d’objets donnée en une nouvelle classe d’objets.	GUID facultatif sous la forme xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.	No
InsertableObject	Indique que cette classe peut être insérée.	Valeur booléenne facultative.	No
ShortDisplayName	Version courte du nom d’affichage de la classe.	Chaîne facultative avec une valeur comprise entre 1 et 40 caractères.	No

Éléments enfants

Élément enfant	Description
ImplémentéCategories	Spécifie les catégories implémentées par la classe .
Conversion	Spécifie les autorisations de lecture/écriture d’une classe.
Dataformats	Spécifie les formats de données par défaut et main pris en charge.
MiscStatus	Spécifie comment créer et afficher un objet.
Verbes et adverbes	Spécifie les verbes à inscrire pour une application.
DefaultIcon	Fournit des informations sur les icônes par défaut pour les présentations iconiques d’objets.
Boîte à outilsBitmap32	Identifie le nom du module et l’ID de ressource d’une bitmap 16 x 16 à utiliser pour le visage d’une barre d’outils ou d’un bouton de boîte à outils.

Éléments parents

Élément parent	Description
com:SurrogateServer	Inscrit un SurrogateServer avec une ou plusieurs inscriptions de classes.

Remarques

Les inscriptions de classes avec le même AppId doivent partager un SurrogateServer, sauf si elles doivent être inscrites sous des éléments de manifeste d’applications/d’application différents.

ThreadingModel correspond au modèle de thread InprocServer32. Les inscriptions de classe SurrogateServer doivent avoir une inscription InprocServer32 dans la ruche privée du package.

Configuration requise

Élément	Valeur
Espace de noms	`http://schemas.microsoft.com/appx/manifest/com/windows10`
Minimum OS Version	Windows 10 version 1703 (build 15063)