com3:SurrogateServer

Registra un suplenteServer con uno o varios registros de clase.

Jerarquía de elemento

<Paquete>

    <APLICACIONES>

         <Application>

              <Extensiones>

                   <com2:Extension>

                        <com2:ComServer>

                             <com3:SurrogateServer>

Syntax

<com3:SurrogateServer  
    CustomSurrogateExecutable = 'An optional string with a value between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or *.'
    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.'
    AppId = 'An optional GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.'
    SystemSurrogate = 'An optional string value.' >

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

</com3:SurrogateServer>

Clave

{} intervalo específico de repeticiones

Atributos y elementos

Atributos

Atributo Descripción Tipo de datos Obligatorio Valor predeterminado
CustomSurrogateExecutable Ruta de acceso a DllSurrogate en la clave AppId. Esta ruta de acceso es relativa a la raíz del paquete y debe hacer referencia a un archivo en el paquete. Esto es mutuamente excluyente con SystemSurrogate. Cadena opcional con un valor entre 1 y 256 caracteres de longitud que debe terminar con .exe y no puede contener estos caracteres: <, >, :, ", |, ?o *. No
DisplayName DisplayName es una 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. Un valor de cadena SDDL opcional. No
AppId AppId que hace referencia a la clave appId asociada. Guid opcional con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxx. No
SystemSurrogate Valor que corresponde a valores conocidos del valor DllSurrogate de la clave AppId. Esto es exclusivo de formamutal con CustomSurrogateExecutable. Valor de cadena opcional. No

Elementos secundarios

Elemento secundario Descripción
Clase Define un registro de clase SurrogateServer.

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

Si no hay ningún valor para DllSurrogate en la clave AppId, no use el atributo CustomSurrogateExecutable.

LaunchAndActivationPermission es una cadena SDDL que corresponde al valor LaunchPermission de la clave AppID.

SystemSurrogate corresponde a los valores del valor DllSurrogate de la clave AppId. Por ejemplo, si el valor dllSurrogate es %System32%\prevhost.exe o %SysWow64%\prevhost.exe, systemSurrogate debe establecerse PreviewHost en y customSurrogateExecutable no debe establecerse.

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)