com3 :Class (dans ServiceServer)

  • Article

Définit une inscription de classe dans un serveur COM hébergé dans un service Windows inscrit dans un élément com3 :ServiceServer .

Hiérarchie d’éléments

<Paquet>

    <Applications>

         <Application>

              <Extensions>

                   <com2:Extension>

                        com2:ComServer

                             com3:ServiceServer

                                  <com3:Class>

Syntax

<com3:Class
    Id = 'A GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.'
    DisplayName = 'An optional string with a value between 1 and 256 characters in length.'
    EnableOleDefaultHandler = 'An optional boolean value.'
    ProgId = 'An optional alphanumeric string separated by a period with a value between 1 and 255 characters in length (e.g. 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 (e.g. 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? 
  
</com3:Class>

Clé :

? facultatif (zéro ou un)

Attributs et éléments

Attributs

Attribut Description Type de données Obligatoire Valeur par défaut
Id L’attribut Id correspond au CLSID (HKCR\CLSID{MyGuid}). GUID au format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxx. Yes
DisplayName Chaîne localisable correspondant à la valeur par défaut de la clé du CLSID. Chaîne facultative dont la valeur est 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 programmatique (ProgID) à un CLSID. Chaîne alphanumérique facultative séparée par un point dont la valeur est 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 dont la valeur est 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 complet de la classe. Chaîne facultative dont la valeur est comprise entre 1 et 40 caractères. No

Éléments enfants

Élément enfant Description
ImplementedCategories 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 emblématiques 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
com3:ServiceServer Inscrit un serveur COM (avec une ou plusieurs inscriptions de classes) hébergé dans un service Windows qui est déclaré avec un élément desktop6 :Service correspondant.

Exemples

<?xml version="1.0" encoding="utf-8"?>
<Package IgnorableNamespaces="uap com com2 com3 desktop6"
         xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
         xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
         xmlns:desktop6="http://schemas.microsoft.com/appx/manifest/desktop/windows10/6"
         xmlns:com="http://schemas.microsoft.com/appx/manifest/com/windows10"
         xmlns:com2="http://schemas.microsoft.com/appx/manifest/com/windows10/2"
         xmlns:com3="http://schemas.microsoft.com/appx/manifest/com/windows10/3">
...
    <Applications>
        <Application ...>
            <Extensions>
                <desktop6:Extension Category="windows.service" Executable="ContosoPackagedService.exe" EntryPoint="packagedServiceComServer.service">
                    <desktop6:Service Name="examplePackagedServiceComServer" StartupType="manual" StartAccount="localService" /> 
                </desktop6:Extension>
                <com2:Extension Category="windows.comServer">
                    <com2:ComServer>
                        <com3:ServiceServer ServiceName="examplePackagedServiceComServer" DisplayName="ServicePackage public service server" 
                            LaunchAndActivationPermission="O:SYG:SYD:(A;;11;;;WD)(A;;11;;;RC)(A;;11;;;AC)(A;;11;;;AN)S:P(ML;;NX;;;S-1-16-0)">
                            <com3:Class Id="1BB09D24-6A0F-4C1F-BCB5-FB924324B2F5" DisplayName="CLSID_ContosoPublicServiceNoHandler"/>
                        </com3:ServiceServer>
                        <com3:TreatAsClass Id="2DAA3C97-F340-4C0E-B23C-92338974C5E9" DisplayName="CLSID_ContosoPublicServiceTreatAs" 
                            TreatAs="1BB09D24-6A0F-4C1F-BCB5-FB924324B2F5"/>
                        <com3:ProgId Id="ContosoPublicServiceNoHandler" Clsid="1BB09D24-6A0F-4C1F-BCB5-FB924324B2F5"/>
                        <com3:ProgId Id="ContosoPublicServiceNoHandler.1" CurrentVersion="ContosoPublicServiceNoHandler"/>
                    </com2:ComServer>
                </com2:Extension>
            </Extensions>
        </Application>
    </Applications>
</Package>

Configuration requise

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