Partilhar via

com3:SurrogateServer

  • Artigo

Registra um SurrogateServer com um ou muitos registros de classe.

Hierarquia de elementos

<Pacote>

    <Aplicativos>

         <Aplicativo>

              <Extensões>

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

Chave

{} intervalo específico de ocorrências

Atributos e elementos

Atributos

Atributo Descrição Tipo de dados Obrigatório Valor padrão
CustomSurrogateExecutable Um caminho para o DllSurrogate na chave AppId. Esse caminho é relativo à raiz do pacote e deve fazer referência a um arquivo no pacote. Isso é mutuamente exclusivo com o SystemSurrogate. Uma cadeia de caracteres opcional com um valor entre 1 e 256 caracteres de comprimento que deve terminar com .exe e não pode conter esses caracteres: <, , :>, , "|, ?ou *. No
DisplayName DisplayName é uma cadeia de caracteres localizável correspondente ao valor padrão da chave AppID. 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
AppId O AppId que faz referência à chave AppId associada. Um GUID opcional no formulário xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxx. No
SystemSurrogate Um valor que corresponde a valores conhecidos do valor DllSurrogate da chave AppId. Isso é mututally exclusivo com CustomSurrogateExecutable. Um valor de cadeia de caracteres opcional. No

Elementos filho

Elemento filho Descrição
Classe Define um registro de classe SurrogateServer.

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

Se não houver nenhum valor para o DllSurrogate na chave AppId, não use o atributo CustomSurrogateExecutable.

LaunchAndActivationPermission é uma cadeia de caracteres SDDL que corresponde ao valor LaunchPermission da chave AppID.

O SystemSurrogate corresponde aos valores do valor DllSurrogate da chave AppId. Por exemplo, se o valor DllSurrogate for %System32%\prevhost.exe ou %SysWow64%\prevhost.exe, SystemSurrogate deverá ser definido PreviewHost como e CustomSurrogateExecutable não deverá ser definido.

Requisitos

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