com3:ServiceServer

  • Artículo

Registra un servidor COM (con uno o varios registros de clases) hospedados en un servicio de Windows declarado con un elemento desktop6:Service correspondiente.

Jerarquía de elemento

<Paquete>

    <APLICACIONES>

         <Application>

              <Extensiones>

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

Clave

{} intervalo específico de repeticiones

Atributos y elementos

Atributos

Atributo Descripción Tipo de datos Obligatorio Valor predeterminado
ServiceName Nombre del servicio de Windows que hospeda el servidor COM. Este nombre de servicio debe coincidir con el nombre de un elemento desktop6:Service correspondiente en el mismo elemento Extensions de nivel de aplicación en el manifiesto del paquete. Cadena con un valor de entre 1 y 32767 caracteres de longitud con un carácter que no es de espacio en blanco al principio y al final. Sí
Argumentos Parámetros de la línea de comandos del servicio. Cadena con un valor de entre 1 y 32767 caracteres de longitud con un carácter que no es de espacio en blanco al principio y al final. No
DisplayName Cadena localizable correspondiente al valor de clave AppID predeterminado. Cadena opcional con un valor entre 1 y 256 caracteres de longitud. No
LaunchAndActivationPermission Cadena SDDL que corresponde al valor LaunchPermission de la clave AppID. Valor de cadena SDDL opcional. No

Elementos secundarios

Elemento secundario Descripción
com3:Class Define un registro de clase para el servidor COM.

Elementos primarios

Elemento primario Descripción
com2:ComServer Declara un punto de extensión de paquete de tipo windows.comServer. La extensión comServer puede incluir los siguientes tipos de registros: ServiceServer, ExeServer, SurrogateServer, ProgId o TreatAsClass.

Comentarios

Un ServiceServer puede tener uno o varios registros de clases. Varios registros de clases deben compartir un ServiceServer si sus claves localService coinciden y tienen el mismo AppID (o si no tienen un AppID), a menos que deban registrarse en diferentes elementos de manifiesto de aplicaciones o aplicaciones.

Ejemplos

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

Elemento Value
Espacio de nombres http://schemas.microsoft.com/appx/manifest/com/windows10/3
Minimum OS Version Windows 10 versión 2004 (compilación 19041)