com3:Class (dalam ServiceServer)

  • Artikel

Menentukan pendaftaran kelas di server COM yang dihosting di layanan Windows yang terdaftar dalam elemen com3:ServiceServer .

Hierarki elemen

<Paket>

    <Aplikasi>

         <Aplikasi>

              <Ekstensi>

                   <com2:Extension>

                        com2:ComServer

                             com3:ServiceServer

                                  <com3:Kelas>

Sintaks

<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>

Kunci

? opsional (nol atau satu)

Atribut dan elemen

Atribut

Atribut Deskripsi Jenis Data Diperlukan Nilai default
Id Atribut Id sesuai dengan CLSID (HKCR\CLSID{MyGuid}). GUID dalam bentuk xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxx. Ya
DisplayName String yang dapat dilokalkan sesuai dengan nilai default kunci CLSID. String opsional dengan nilai antara 1 dan 256 karakter. Tidak
EnableOleDefaultHandler Ini harus diatur ke true jika nilai default kunci InprocHandler32 adalah "Ole32.dll". Jika tidak, itu harus dihilangkan. Nilai defaultnya adalah false. Nilai boolean opsional. Tidak
ProgId Mengaitkan pengidentifikasi terprogram (ProgID) dengan CLSID. String alfanumerik opsional yang dipisahkan oleh titik dengan nilai antara 1 dan 255 karakter (misalnya Foo.Bar atau Foo.Bar.1). Tidak
VersionIndependentProgId Mengaitkan ProgID dengan CLSID. Nilai ini digunakan untuk menentukan versi terbaru aplikasi objek. String alfanumerik opsional yang dipisahkan oleh titik dengan nilai antara 1 dan 255 karakter (misalnya Foo.Bar atau Foo.Bar.1). Tidak
AutoConvertTo Menentukan konversi otomatis dari kelas objek tertentu ke kelas objek baru. GUID opsional dalam bentuk xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx. Tidak
InsertableObject Menunjukkan bahwa kelas ini dapat disisipkan. Nilai boolean opsional. Tidak
ShortDisplayName Versi singkat dari nama tampilan kelas. String opsional dengan nilai antara 1 dan 40 karakter. Tidak

Elemen anak

elemen anak Deskripsi
ImplementedCategories Menentukan kategori yang diterapkan oleh kelas .
Konversi Menentukan izin baca/tulis kelas.
Format Data Menentukan format data default dan utama yang didukung.
MiscStatus Menentukan cara membuat dan menampilkan objek.
Kata kerja Menentukan kata kerja yang akan didaftarkan untuk aplikasi.
DefaultIcon Menyediakan informasi ikon default untuk presentasi objek ikonik.
Kotak AlatBitmap32 Mengidentifikasi nama modul dan ID sumber daya untuk bitmap 16 x 16 yang akan digunakan untuk wajah toolbar atau tombol kotak alat.

Elemen induk

elemen induk Deskripsi
com3:ServiceServer Mendaftarkan server COM (dengan satu atau beberapa pendaftaran kelas) yang dihosting dalam layanan Windows yang dideklarasikan dengan elemen desktop6:Service yang sesuai.

Contoh

<?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>

Persyaratan

Nilai
Ruang nama http://schemas.microsoft.com/appx/manifest/com/windows10/3