com4:ComServer

Mendeklarasikan titik ekstensi paket jenis windows.comServer. Ekstensi comServer dapat mencakup pendaftaran kelas, termasuk detail aktivasi untuk server yang menerapkan kelas ini, dan pendaftaran ProgId dan TreatAsClass, yang menyediakan pengidentifikasi tambahan yang digunakan untuk mereferensikan kelas ini pada runtime.

Hierarki Elemen

<Paket>

    <Aplikasi>

         <Aplikasi>

              <Ekstensi>

                   <com4:Extension>

                        <com4:ComServer>

Sintaks

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

Kunci

{} rentang kemunculan tertentu

Atribut dan elemen

Atribut

Tidak ada.

Elemen anak

elemen anak Deskripsi
Kelas Menentukan pendaftaran kelas di server COM.
ExeServer Mendaftarkan ExeServer dengan satu atau banyak pendaftaran kelas.
ServiceServer Mendaftarkan ServiceServer dengan satu atau banyak pendaftaran kelas.
SurrogateServer Mendaftarkan SurrogateServer dengan satu atau banyak pendaftaran kelas.
TreatAsClass Pendaftaran yang sesuai dengan pendaftaran CLSID dengan subkuncar TreatAs.
ProgId Pengidentifikasi terprogram (ProgID) yang dapat dikaitkan dengan CLSID.
InProcessServer Mendaftarkan server dalam proses dengan satu atau banyak pendaftaran kelas.
InProcessHandler Mendaftarkan handler dalam proses dengan satu atau banyak pendaftaran kelas.
ManagedInProcessServer Mendaftarkan server dalam proses terkelola dengan satu atau banyak pendaftaran kelas.

Elemen induk

elemen induk Deskripsi
com4:Extension Menyediakan fungsionalitas untuk mengekspos pendaftaran COM kepada klien di luar paket aplikasi. Ekstensi com4 adalah versi baru yang merupakan superset dan penggantian untuk versi skema COM sebelumnya.

Keterangan

Dalam paket multi-aplikasi, penting untuk menempatkan pendaftaran server COM di bawah elemen manifes Aplikasi/Aplikasi yang benar, karena proses server COM akan berjalan dengan identitas elemen Aplikasi/Aplikasi leluhur.

Server COM yang terdaftar dalam manifes selalu mendapatkan perilaku Aktifkan Sebagai Paket (AAP), yang berarti server COM berjalan dengan token default sesi pengguna dengan paket dan klaim aplikasi ditambahkan. Ini berbeda dari perilaku aktivasi default server COM yang terdaftar secara klasifikasi, di mana server COM berjalan dengan token klien. Untuk sebagian besar aplikasi, perbedaan ini tidak akan terlihat karena klien biasanya berjalan dengan token default sesi pengguna. Perilaku aktivasi lainnya, seperti RunAs, tidak didukung.

Dimungkinkan untuk memiliki beberapa ekstensi comServer di bawah elemen Aplikasi/Aplikasi, tetapi dalam banyak kasus ini tidak diperlukan atau disarankan. Contoh kasus tepi di mana beberapa ekstensi comServer diperlukan adalah jika paket membutuhkan beberapa pendaftaran untuk memiliki CompatMode="classic" sementara yang lain memiliki CompatMode="modern", satu-satunya cara untuk melakukan ini adalah dengan membaginya di antara ekstensi.

Perubahan pada ekstensi com4

Sintaks ekstensi com4 adalah superset baru dari sintaks ekstensi com sebelumnya. Versi sintaks ini mendukung struktur yang sama dengan versi sintaks yang lebih lama, di mana pendaftaran kelas diwakili oleh elemen ExeServer/Class, SurrogateServer/Class, ServiceServer/Class, InProcessServer/Class, InProcessHandler/Class, atau ManagedInProcessServer/Class.

Sintaks baru juga mendukung struktur alternatif, di mana:

  • ExeServer/ClassReference, SurrogateServer/ClassReference, ServiceServer/ClassReference, InProcessServer/ClassReference, InProcessHandler/ClassReference, atau elemen ManagedInProcessServer/ClassReference mereferensikan elemen Kelas tingkat atas

dan/atau

  • Elemen SurrogateServer/InProcessServerClassReference mereferensikan elemen InProcessServer/Class (atau, InProcessServer/ClassReference) atau elemen ManagedInProcessServer/Class (atau, ManagedInProcessServer/ClassReference).

Tujuan utama struktur sintaks baru adalah untuk mengaktifkan kombinasi server dalam proses, handler dalam proses, dan pendaftaran server di luar proses untuk CLSID yang sama, seperti yang mungkin dan didukung dengan tata letak registri klasik. Untuk informasi selengkapnya tentang tata letak registri COM, lihat Kunci CLSID.

Persyaratan

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