com3:ServiceServer
使用一或多個類別註冊來註冊 COM 伺服器 (,) 裝載于以對應 Desktop6:Service 元素宣告的 Windows 服務中。
元素階層
<com3:ServiceServer>
Syntax
<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>
答案
{}
特定出現次數範圍
屬性和元素
屬性
屬性 | 描述 | 資料類型 | 必要 | 預設值 |
---|---|---|---|---|
ServiceName | 裝載 COM 伺服器的 Windows 服務名稱。 此服務名稱必須符合封裝資訊清單中相同應用層級Extensions元素中對應desktop6:Service元素的名稱。 | 長度介於 1 到 32767 個字元之間的字串,其開頭和結尾具有非空白字元。 | Yes | |
引數 | 服務的命令列參數。 | 長度介於 1 到 32767 個字元之間的字串,其開頭和結尾具有非空白字元。 | No | |
DisplayName | 對應至預設 AppID 索引鍵值的可當地語系化字串。 | 長度介於 1 到 256 個字元之間的選擇性字串。 | No | |
LaunchAndActivationPermission | 對應至 AppID 索引鍵之 LaunchPermission 值的 SDDL 字串 。 | 選擇性 的 SDDL 字串 值。 | No |
子元素
子項目 | 描述 |
---|---|
com3:Class | 定義 COM 伺服器的類別註冊。 |
父元素
父元素 | 描述 |
---|---|
com2:ComServer | 宣告 windows.comServer類型的套件延伸點。 comServer延伸模組可能包含下列類型的註冊:ServiceServer、ExeServer、SurrogateServer、ProgId或TreatAsClass。 |
備註
ServiceServer可以有一或多個類別註冊。 如果ServiceServer 的 LocalService金鑰相符,而且它們有相同的 AppID (,或者它們沒有AppID) ,除非必須在不同的應用程式/應用程式資訊清單元素下註冊,否則多個類別註冊應該共用ServiceServer。
範例
<?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>
規格需求
Item | 值 |
---|---|
Namespace | http://schemas.microsoft.com/appx/manifest/com/windows10/3 |
OS 最低版本 | Windows 10版本 2004 (組建 19041) |