com:Class (dalam SurrogateServer/Class)

Artikel
07/20/2023

Mendefinisikan pendaftaran kelas SurrogateServer.

Hierarki elemen

<Paket>

<com:Extension>

<com:ComServer>

<com:SurrogateServer>

<com:Class>

Sintaks

<com:Class
    Id = 'A GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.'
    Path = 'A string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
    ThreadingModel = 'A string that can be one of the following values: "Both", "STA", "MTA", "MainSTA", "Neutral".'
    DisplayName = 'An optional string with a value between 1 and 256 characters in length. This string is localizable.'
    EnableOleDefaultHandler = 'An optional boolean value.'
    ProgId = 'An optional alphanumeric string separated by a period with a value between 1 and 255 characters in length (for example, 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 (for example, 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? 
  )

</com:Class>

Kunci

? opsional (nol atau satu)

Atribut dan elemen

Atribut

Atribut	Deskripsi	Jenis Data	Diperlukan
Id	Atribut Id sesuai dengan CLSID.	GUID dalam bentuk xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxx.	Ya
Jalur	Jalur lengkap ke DLL kelas pengganti.	String dengan nilai antara 1 dan 256 karakter yang panjangnya tidak boleh berisi karakter ini: `<`, , `>`, `:"`, `\|`, `?`, atau `*`.	Ya
ThreadingModel	Model utas untuk memuat DLL.	String yang bisa menjadi salah satu nilai berikut: Keduanya, STA, MTA, MainSTA, Netral.	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-xxxxxxxxxxx.	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
com:SurrogateServer	Mendaftarkan SurrogateServer dengan satu atau banyak pendaftaran kelas.

Keterangan

Pendaftaran kelas dengan AppId yang sama harus berbagi SurrogateServer, kecuali mereka perlu didaftarkan di bawah elemen manifes Aplikasi/Aplikasi yang berbeda.

ThreadingModel sesuai dengan model utas InprocServer32. Pendaftaran kelas SurrogateServer harus memiliki pendaftaran InprocServer32 di sarang privat paket.

Persyaratan

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