Partilhar via


com:Extensão (Windows 10)

Fornece funcionalidade para expor registros COM para clientes fora do pacote do aplicativo.

Hierarquia de elementos

<Pacote>

     <Aplicações>

          <Aplicação>

               <Extensões>

                    <com:Extensão>

     <Extensões>

          <com:Extensão>

Sintaxe

<com:Extension
  Category = 'A string that can be one of the following values: "windows.comServer" or "windows.comInterface".' 
  uap10:TrustLevel = 'An optional string value that can one of the following value: "appContainer" or "mediumIL".'
  ap10:RuntimeBehavior = 'An optional string with a value that can be one of the following values: "windowsApp", "packagedClassicApp", or "win32App".'
  uap10:HostId = 'An optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
  uap10:Parameters = 'An optional string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.' 
  uap11:Id = 'An optional string with a value between 1 and 255 characters in length with a non-whitespace character at its beginning and end.'
  uap11:Subsystem = 'An optional string that can have one of the following values: "console" or "windows".'
  uap11:SupportsMultipleInstances = 'An optional boolean value.'
  uap11:ResourceGroup = 'An optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
  uap11:CurrentDirectoryPath = 'An optional string that cannot contain these characters: <, >, |, ?, or *. >'
  uap11:Parameters = 'An optional string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
  desktop7:CompatMode = 'An optional string the can have one of the following values: "classic" or "modern".'
  desktop7:Scope = 'An optional string that can have one of the following values: "machine" or "user".'>

  <!-- Child elements -->
  com:ComServer
  com:ComInterface

</com:Extension>

Atributos e elementos

Atributos

Atributo Descrição Tipo de dados Necessário Valor padrão
Categoria O tipo de ponto de extensibilidade do aplicativo. Uma cadeia de caracteres que pode ser um dos seguintes valores: windows.comServer ou windows.comInterface. Sim
uap10:TrustLevel Especifica o nível de confiança da extensão. Um valor de cadeia de caracteres opcional que pode ter um dos seguintes valores: appContainer ou mediumIL. Não
uap10:RuntimeBehavior Especifica o comportamento de tempo de execução da extensão. Uma cadeia de caracteres opcional com um valor que pode ser um dos seguintes valores: windowsApp, packagedClassicAppou win32App. Não
uap10:HostId Especifica a ID do tempo de execução do host para a extensão. Uma cadeia alfanumérica opcional com um valor entre 1 e 255 caracteres de comprimento. Deve começar com uma letra. Não
uap10:Parâmetros Contém parâmetros de linha de comando para passar para a extensão. Suportado apenas para aplicações de ambiente de trabalho com identidade de pacote. Uma cadeia de caracteres opcional com um valor entre 1 e 32767 caracteres de comprimento com um caractere sem espaço em branco no início e no fim. Não
uap11:Id Um identificador para a extensão. O ID deve ser exclusivo para todas as extensões em um pacote. Uma cadeia de caracteres opcional com um valor entre 1 e 255 caracteres de comprimento com um caractere sem espaço em branco no início e no fim. Não
uap11:Subsistema O subsistema visado pela extensão. Uma cadeia de caracteres opcional que pode ter um dos seguintes valores: console ou windows. Não
uap11:SupportsMultipleInstances Especifica se as instâncias devem ser executadas em processos diferentes. O valor padrão é false. Um valor booleano opcional. Não
uap11:ResourceGroup Uma tag que você pode usar para agrupar ativações de extensão para fins de gerenciamento de recursos (por exemplo, CPU e memória). O valor que você pode definir ResourceGroup é de forma livre e flexível. Ver Application@ResourceGroup. Uma cadeia alfanumérica opcional com um valor entre 1 e 255 caracteres de comprimento. Deve começar com uma letra. Não
uap11:CurrentDirectoryPath Especifica o diretório inicial quando o processo do aplicativo é iniciado. Este atributo suporta macros. Para obter mais informações, consulte Macros no esquema de manifesto do pacote. Uma cadeia de caracteres opcional que não pode conter estes caracteres: <, >, |, ?ou *. > Não
uap11:Parâmetros O subsistema visado pela extensão. Este atributo suporta macros. Para obter mais informações, consulte Macros no esquema de manifesto do pacote. Uma cadeia de caracteres opcional com um valor entre 1 e 32767 caracteres de comprimento com um caractere sem espaço em branco no início e no fim. Não
desktop7:CompatMode Especifica se as informações dessa extensão são registradas no Windows de maneiras clássicas (por exemplo, aplicativos não empacotados, tipos de registro com COM por meio do Registro) ou de maneiras novas e com mais escopo. O valor padrão é "moderno". CompatMode="classic" requer a capacidade de Microsoft.classicAppCompat_8wekyb3d8bbwe. Uma cadeia de caracteres opcional pode ter um dos seguintes valores: clássico ou moderno. Não
desktop7:Escopo Especifica se os registros são visíveis apenas para outros aplicativos em execução como um usuário que tem esse pacote registrado (usuário) ou se eles são visíveis para todos os usuários e serviços na máquina (máquina). O valor padrão é "user". Scope="machine" requer a capacidade Microsoft.classicAppCompatElevated_8wekyb3d8bbwe. Uma cadeia de caracteres opcional que pode ter um dos seguintes valores: máquina ou usuário. Não

Elementos filho

Elemento filho Descrição
com:ComServer Declara um ponto de extensão de pacote do tipo windows.comServer.
com:ComInterface Declara um ponto de extensão de pacote do tipo windows.comInterface.

Elementos pai

Elemento pai Descrição
Extensões (tipo: CT_ApplicationExtensions) Define um ou mais pontos de extensibilidade para o aplicativo.

Requerimentos

Número Valor
Espaço de nomes http://schemas.microsoft.com/appx/manifest/foundation/windows10
uap10 http://schemas.microsoft.com/appx/manifest/uap/windows10/10
Versão mínima do SO Windows 10 versão 1703 (compilação 15063)