com3:ServiceServer

Registra um servidor COM (com um ou mais registros de classe) hospedado em um serviço Windows declarado com um elemento desktop6:Service correspondente.

Hierarquia de elementos

<Pacote>

    <Aplicativos>

         <Aplicativo>

              <Extensões>

                   <com2:Extension>

                        <com2:ComServer>

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

Chave

{} intervalo específico de ocorrências

Atributos e elementos

Atributos

Atributo	Descrição	Tipo de dados	Obrigatório	Valor padrão
ServiceName	O nome do serviço Windows que hospeda o servidor COM. Esse nome de serviço deve corresponder ao nome de um elemento desktop6:Service correspondente no mesmo elemento Extensions no nível do aplicativo no manifesto do pacote.	Uma cadeia de caracteres com um valor entre 1 e 32767 caracteres de comprimento com um caractere não em branco no início e no final.	Yes
Argumentos	Os parâmetros de linha de comando do serviço.	Uma cadeia de caracteres com um valor entre 1 e 32767 caracteres de comprimento com um caractere não em branco no início e no final.	No
DisplayName	Uma cadeia de caracteres localizável correspondente ao valor de chave appID padrão.	Uma cadeia de caracteres opcional com um valor entre 1 e 256 caracteres de comprimento.	No
LaunchAndActivationPermission	Uma cadeia de caracteres SDDL que corresponde ao valor LaunchPermission da chave AppID.	Um valor de cadeia de caracteres SDDL opcional.	No

Elementos filho

Elemento filho	Descrição
com3:Class	Define um registro de classe para o servidor COM.

Elementos pai

Elemento pai	Descrição
com2:ComServer	Declara um ponto de extensão de pacote do tipo windows.comServer. A extensão comServer pode incluir os seguintes tipos de registros: ServiceServer, ExeServer, SurrogateServer, ProgId ou TreatAsClass.

Comentários

Um ServiceServer pode ter um ou mais registros de classe. Vários registros de classe devem compartilhar um ServiceServer se suas chaves LocalService corresponderem e tiverem a mesma AppID (ou se não tiverem um AppID), a menos que precisem ser registradas em diferentes elementos de manifesto Aplicativos/Aplicativo.

Exemplos

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

Requisitos

Item	Valor
Namespace	http://schemas.microsoft.com/appx/manifest/com/windows10/3
Minimum OS Version	Windows 10 versão 2004 (Build 19041)