com4:ComServer

Artikel
07/21/2023

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

Hierarki Elemen

<Paket>

<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.
com5:InProcessServer	Mendaftarkan server dalam proses dengan satu atau banyak pendaftaran kelas. Skema com5 memperkenalkan beberapa perubahan kecil dalam validasi sintaksis dari skema com4.
com5:InProcessHandler	Mendaftarkan handler dalam proses dengan satu atau banyak pendaftaran kelas. Skema com5 memperkenalkan beberapa perubahan kecil dalam validasi sintaksis dari skema com4.

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

Item	Nilai
Ruang nama	`http://schemas.microsoft.com/appx/manifest/com/windows10/4`
Versi OS Minimum	Windows 10 (Build 20348)