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)