com3:Class

Definisce una registrazione di classe in un server COM ospitato in un servizio Windows registrato in un com3:ServiceServer elemento .

Gerarchia elementi

<Package>
   └─ <Extensions>
      └─ <com:Extension>
         └─ <com:ComServer>
            └─ <com3:ServiceServer>
               └─ <com3:Class>
   └─ <Applications>
      └─ <Application>
         └─ <Extensions>
            └─ <com:Extension>
               └─ <com:ComServer>
                  └─ <com3:ServiceServer>
                     └─ <com3:Class>

Sintassi

<com3:Class
  EnableOleDefaultHandler = 'An optional boolean value.'
  ProgId = 'An optional alphanumeric string separated by a period between 1 and 255 characters in length, e.g. Foo.Bar or Foo.Bar.1'
  VersionIndependentProgId = 'An optional alphanumeric string separated by a period 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 between 1 and 40 characters in length.'
  Id = 'A required GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.'
  DisplayName = 'An optional string between 1 and 256 characters in length. This string is localizable.' >

  <!-- Child elements -->
  com3:ImplementedCategories?
  com3:Conversion?
  com3:DataFormats?
  com3:MiscStatus?
  com3:Verbs?
  com3:DefaultIcon?
  com3:ToolboxBitmap32?

</com3:Class>

chiave

? facoltativo (zero o uno)

Attributes

Attribute Descrizione Tipo di dati Obbligatorio Valore predefinito
EnableOleDefaultHandler Deve essere impostato su true se il valore predefinito della chiave InprocHandler32 è "Ole32.dll". In caso contrario, deve essere omesso. Il valore predefinito è false. Valore booleano facoltativo. NO
Progid Associa un identificatore programmatico (ProgID) a un CLSID. Stringa alfanumerica facoltativa separata da un punto compreso tra 1 e 255 caratteri, ad esempio Foo.Bar o Foo.Bar.1 NO
VersionIndependentProgId Associa un ProgID a un CLSID. Questo valore viene usato per determinare la versione più recente di un'applicazione oggetto. Stringa alfanumerica facoltativa separata da un punto compreso tra 1 e 255 caratteri, ad esempio Foo.Bar o Foo.Bar.1 NO
AutoConvertTo Specifica la conversione automatica di una determinata classe di oggetti in una nuova classe di oggetti. GUID facoltativo nel formato xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. NO
InsertableObject Indica che questa classe può essere inserita. Valore booleano facoltativo. NO
ShortDisplayName Versione breve del nome visualizzato della classe. Stringa facoltativa compresa tra 1 e 40 caratteri. NO
ID L'attributo Id corrisponde al CLSID (HKCR\CLSID{MyGuid}). GUID nel formato xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. Sì
DisplayName Stringa localizzabile corrispondente al valore predefinito della chiave CLSID. Stringa facoltativa compresa tra 1 e 256 caratteri. Questa stringa è localizzabile. NO

Elementi figli

Elemento figlio Descrizione
com:ImplementedCategories Specifica le categorie implementate dalla classe .
com:Conversion Specifica i formati che un'applicazione può leggere e scrivere.
com:DataFormats Specifica i formati di dati predefiniti e principali supportati da un'applicazione.
com:MiscStatus Specifica come creare e visualizzare un oggetto .
com:Verbs Specifica i verbi da registrare per un'applicazione.
com:DefaultIcon Fornisce informazioni sull'icona predefinite per le presentazioni iconiche degli oggetti.
com:ToolboxBitmap32 Identifica il nome del modulo e l'ID risorsa per una bitmap 16 x 16 da usare per il viso di una barra degli strumenti o di un pulsante della casella degli strumenti.

Elementi principali

Elemento padre Descrizione
com3:ServiceServer Registra un server COM (con una o più registrazioni di classe) ospitato in un servizio Windows dichiarato con un elemento desktop6:Service corrispondente.

Requisiti

Elemento Valore
spazio dei nomi http://schemas.microsoft.com/appx/manifest/com/windows10/3
versione minima del sistema operativo Windows 10 versione 2004 (Build 19041)

Remarks

Esempi

<?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>
  • Last updated on