com3:ServiceServer

Artikel
10/30/2023

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

Hierarki elemen

<Paket>

<com2:Extension>

<com2:ComServer>

<com3:ServiceServer>

Sintaks

<com3:ServiceServer
    ServiceName = 'A string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
    Arguments = 'A string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
    DisplayName = 'An optional string with a value between 1 and 256 characters in length. This string is localizable.'
    LaunchAndActivationPermission = 'An optional [SDDL string](/windows/win32/secauthz/security-descriptor-string-format) value.' >

  <!-- Child elements -->
  com3:Class{1,10000}

</com3ServiceServer>

Kunci

{} rentang kemunculan tertentu

Atribut dan elemen

Atribut

Atribut	Deskripsi	Jenis Data	Diperlukan
ServiceName	Nama layanan Windows yang menghosting server COM. Nama layanan ini harus cocok dengan nama elemen desktop6:Service yang sesuai dalam elemen Extensions tingkat aplikasi yang sama dalam manifes paket.	String dengan panjang nilai antara 1 dan 32767 karakter dengan karakter non-spasi di awal dan akhir.	Ya
Argumen	Parameter baris perintah layanan.	String dengan panjang nilai antara 1 dan 32767 karakter dengan karakter non-spasi di awal dan akhir.	Tidak
DisplayName	String yang dapat dilokalkan sesuai dengan nilai kunci AppID default.	String opsional dengan nilai antara 1 dan 256 karakter.	Tidak
LaunchAndActivationPermission	String SDDL yang sesuai dengan nilai LaunchPermission kunci AppID.	Nilai string SDDL opsional.	Tidak

Elemen anak

elemen anak	Deskripsi
com3:Kelas	Menentukan pendaftaran kelas untuk server COM.

Elemen induk

elemen induk	Deskripsi
com2:ComServer	Mendeklarasikan titik ekstensi paket jenis windows.comServer. Ekstensi comServer dapat mencakup jenis pendaftaran berikut: ServiceServer, ExeServer, SurrogateServer, ProgId, atau TreatAsClass.

Keterangan

ServiceServer dapat memiliki satu atau beberapa pendaftaran kelas. Beberapa pendaftaran kelas harus berbagi ServiceServer jika kunci LocalService mereka cocok dan mereka memiliki AppID yang sama (atau jika mereka tidak memiliki AppID), kecuali mereka perlu didaftarkan di bawah elemen manifes Aplikasi/Aplikasi yang berbeda.

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

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

Bagikan melalui