com2:Extension (Windows 10)

  • Artigo

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

Hierarquia de elementos

do pacote

    aplicativos <>

          <application>

              extensões de <>

                    <com2:> de extensão

    extensões de <>

          <com2:> de extensão

Sintaxe

<com2:Extension
  Category = 'A string that can have one of the following values: "windows.comServer" or "windows.comInterface".' 
  uap10:TrustLevel = 'An optional string value that can be one of the following values: "appContainer" or "mediumIL".'
  uap10:RuntimeBehavior = 'An optional string 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 = 'A 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 -->
  com2:ComServer
  com2:ComInterface

</com2:Extension>

Atributos e elementos

Atributos

Atributo Descrição Tipo de dado Necessário Valor padrão
de Categoria O tipo de ponto de extensibilidade do aplicativo. Uma cadeia de caracteres que pode ter 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 ser um dos seguintes valores: appContainer ou mediumIL . Não
uap10:RuntimeBehavior Especifica o comportamento de tempo de execução da extensão. Um valor de cadeia de caracteres opcional que pode ser um dos seguintes valores: windowsApp, packagedClassicAppou win32App. Não
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. Não
uap10:Parameters Contém parâmetros de linha de comando para passar para a extensão. Só há suporte para aplicativos da área de trabalho que têm a identidade do pacote. Uma cadeia de caracteres com um valor entre 1 e 32767 caracteres de comprimento com um caractere não whitespace no início e no final. Não
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 whitespace no início e no final. Não
uap11:Subsistema Esse atributo é herdado da sintaxe de extensão base e não é aplicável à extensão com4. Além da validação sintactica, esse valor é ignorado. Uma cadeia de caracteres opcional que pode ter um dos seguintes valores: console ou janelas. Não
uap11:SupportsMultipleInstances Especifica se as instâncias devem ser executadas em processos diferentes. O valor padrão é false. Um valor booliano opcional. Não
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. Consulte 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. Não
uap11:CurrentDirectoryPath Especifica o diretório inicial quando o processo de 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 esses caracteres: <, >, |, ?ou *. > Não
uap11:Parameters Esse atributo é herdado da sintaxe de extensão base e não é aplicável à extensão com4. Além da validação sintactica, 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 32767 caracteres de comprimento com um caractere não whitespace no início e no final. Não
desktop7:CompatMode Especifica se as informações dessa extensão são registradas com o 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="clássico" requer a funcionalidade 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ó 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 de Microsoft.classicAppCompatElevated_8wekyb3d8bbwe. Uma cadeia de caracteres opcional que pode ter um dos seguintes valores: de computador ou usuário. Não

Elementos filho

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

Elementos pai

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

Requisitos

Item Valor
namespace http://schemas.microsoft.com/appx/manifest/com/windows10/2
elementos uap10 http://schemas.microsoft.com/appx/manifest/com/windows10/3
versão mínima do sistema operacional Windows 10 versão 1709 (Build 16299)