com:SurrogateServer

Registra um SurrogateServer com um ou vários registros de classe.

Hierarquia de elementos

<Package>
   └─ <Applications>
      └─ <Application>
         └─ <Extensions>
            └─ <com:Extension>
               └─ <com:ComServer>
                  └─ <com:SurrogateServer>

Sintaxe

<com: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 = 'A [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}

</com:SurrogateServer>

Chave

{} Intervalo específico de ocorrências

Atributos e elementos

Attributes

Attribute Descrição Tipo de dados Obrigatório Valor predefinido
CustomSurrogateExecutável Um caminho para o Surrogate na chave AppId. Este caminho é relativo à raiz do pacote e deve referenciar um ficheiro no pacote. Isto é mutuamente exclusivo com o SystemSurrogate. Uma cadeia opcional com valor entre 1 e 256 caracteres que deve terminar em .exe e não pode conter estes caracteres: <, >, :, ", |, ?, , ou * Não
DisplayName DisplayName é uma cadeia 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. Não
Permissão de Lançamento e Ativação Uma string SDDL que corresponde ao valor LaunchPermission da chave AppID. Um valor de string SDDL . Não
AppId O AppId que faz referência à chave AppId associada. Um GUID opcional na forma xxxxxxxx-xxxx-xxxx-xxxxxx-xxxxxx-xxxxxxxxxxxx. Não
SystemSurrogate Um valor que corresponde a valores bem conhecidos do valor DllSurrogate da chave AppId. Isto é mutuamente exclusivo com o CustomSurrogateExecutable. Um valor de cadeia de caracteres opcional. Não

Elementos filhos

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

Elementos Principais

Elemento filho Descrição
com:ComServer Declara um ponto de extensão de pacote do tipo windows.comServer. A extensão comServer pode incluir quatro tipos de registos: ExeServer, SurrogateServer, ProgId ou TreatAsClass.

Observações

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

LaunchAndActivationPermission é uma string 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, então SystemSurrogate deve ser definido como PreviewHost e o CustomSurrogateExecutable não deve ser definido.

Requerimentos

Número valor
Espaço de nomes http://schemas.microsoft.com/appx/manifest/com/windows10
Versão mínima do SO Windows 10 versão 1703 (Build 15063)
  • Last updated on