com:Extension (Windows 10)

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

Hierarquia de elementos

<Pacote>

    <Aplicativos>

         <Aplicativo>

              <Extensões>

                   <com:Extension>

Syntax

<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	Obrigató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.	Yes
uap10:TrustLevel	Especifica o nível de confiança da extensão.	Um valor de cadeia de caracteres opcional que pode um dos seguintes valores: appContainer ou mediumIL.	No
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, packagedClassicApp ou win32App.	No
uap10:HostId	Especifica a ID do runtime do host para a extensão.	Uma cadeia de caracteres alfanumérica opcional com um valor entre 1 e 255 caracteres de comprimento. Deve começar com uma letra.	No
uap10:Parameters	Contém parâmetros de linha de comando a serem passados para a extensão. Há suporte apenas para aplicativos da área de trabalho que têm a identidade do pacote.	Uma cadeia de caracteres opcional com um valor entre 1 e 32.767 caracteres de comprimento com um caractere não em branco no início e no final.	No
uap11:Id	Um identificador para a extensão. A ID deve ser exclusiva 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 não em branco no início e no final.	No
uap11:Subsystem	Esse atributo é herdado da sintaxe de extensão base e não é aplicável à extensão com4. Além da validação sintática, esse valor é ignorado.	Uma cadeia de caracteres opcional que pode ter um dos seguintes valores: console ou janelas.	No
uap11:SupportsMultipleInstances	Especifica se as instâncias devem ser executadas em processos diferentes. O valor padrão é false.	Um valor booliano opcional.	No
uap11:ResourceGroup	Uma marca 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. Confira Application@ResourceGroup.	Uma cadeia de caracteres alfanumérica opcional com um valor entre 1 e 255 caracteres de comprimento. Deve começar com uma letra.	No
uap11:CurrentDirectoryPath	Especifica o diretório inicial quando o processo do aplicativo é iniciado. Esse atributo dá suporte a 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 *. >	No
uap11:Parameters	Esse atributo é herdado da sintaxe de extensão base e não é aplicável à extensão com4. Além da validação sintática, esse valor é ignorado. Esse atributo dá suporte a 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 32.767 caracteres de comprimento com um caractere não em branco no início e no final.	No
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 registram tipos com COM por meio do registro) ou de novas maneiras mais com escopo. O valor padrão é "moderno". CompatMode="classic" requer a funcionalidade Microsoft.classicAppCompat_8wekyb3d8bbwe .	Uma cadeia de caracteres opcional que pode ter um dos seguintes valores: clássico ou moderno.	No
desktop7:Scope	Especifica se os registros só são visíveis para outros aplicativos em execução como um usuário que tem esse pacote registrado (usuário) ou se estão visíveis para todos os usuários e serviços no computador (computador). O valor padrão é "user". Scope="machine" requer a funcionalidade Microsoft.classicAppCompatElevated_8wekyb3d8bbwe .	Uma cadeia de caracteres opcional que pode ter um dos seguintes valores: computador ou usuário.	No

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.

Requisitos

Item	Valor
Namespace	http://schemas.microsoft.com/appx/manifest/foundation/windows10
uap10	http://schemas.microsoft.com/appx/manifest/uap/windows10/10
Minimum OS Version	Windows 10 versão 1703 (Build 15063)