com3:ServiceServer

아티클
10/30/2023

해당 desktop6:Service 요소로 선언된 Windows 서비스에서 호스트되는 COM 서버(하나 이상의 클래스 등록 포함)를 등록합니다.

요소 계층 구조

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

키

{} 특정 발생 범위

특성 및 요소

특성

attribute	Description	데이터 형식	필수
ServiceName	COM 서버를 호스트하는 Windows 서비스의 이름입니다. 이 서비스 이름은 패키지 매니페스트의 동일한 애플리케이션 수준 Extensions 요소에 있는 해당 desktop6:Service 요소의 이름과 일치해야 합니다.	시작과 끝에 공백이 아닌 문자가 있는 길이가 1~32767자인 문자열입니다.	Yes
인수	서비스의 명령줄 매개 변수입니다.	시작과 끝에 공백이 아닌 문자가 있는 길이가 1~32767자인 문자열입니다.	No
표시 이름	기본 AppID 키 값에 해당하는 지역화 가능한 문자열입니다.	길이가 1~256자인 선택적 문자열입니다.	No
LaunchAndActivationPermission	AppID 키의 LaunchPermission 값에 해당하는 SDDL 문자열 입니다.	선택적 SDDL 문자열 값입니다.	No

자식 요소

자식 요소	Description
com3:Class	COM 서버에 대한 클래스 등록을 정의합니다.

부모 요소

부모 요소	Description
com2:ComServer	windows.comServer 형식의 패키지 확장 지점을 선언합니다. comServer 확장에는 ServiceServer, ExeServer, SurrogateServer, ProgId 또는 TreatAsClass와 같은 유형의 등록이 포함될 수 있습니다.

설명

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>

요구 사항

항목	값
Namespace	`http://schemas.microsoft.com/appx/manifest/com/windows10/3`
Minimum OS Version	Windows 10 버전 2004(빌드 19041)