com4:ComInterface

Artigo
10/23/2024

Declara um ponto de extensão de pacote do tipo windows.comInterface. A extensão comInterface pode incluir três tipos de registros: Interface, ProxyStubou TypeLib.

Hierarquia de elementos

do pacote

aplicativos <>

extensões de <>

<com4:Extension>

<com4:ComInterface>

extensões de <>

<com4:Extension>

<com4:ComInterface>

Sintaxe

<com4:ComInterface>

<!-- Child elements -->
  ProxyStub{0,1}
  Interface{0,1}
  TypeLib{0,1}

</com4:ComInterface>

Chave

{} intervalo específico de ocorrências

Atributos e elementos

Atributos

Nenhum.

Elementos filho

Elemento filho	Descrição
ProxyStub	Registra um stub de proxy.
interface	Registra novas interfaces COM
TypeLib	Registra uma biblioteca de tipos.

Elementos pai

Elemento pai	Descrição
com4:Extension	Fornece funcionalidade para expor registros COM a clientes fora do pacote do aplicativo. A extensão com4 é uma nova versão que é um superconjunto e substituição para as versões de esquema COM anteriores.

Observações

A extensão comInterface pode estar no elemento de manifesto Application/Extensions/Extension ou no elemento de manifesto Package/Extensions/Extension. Não há diferença funcional entre essas duas opções, mas ambos os posicionamentos têm vantagens diferentes.

Se a extensão estiver em Application/Extensions/Extension, você poderá melhorar a legibilidade do manifesto mantendo registros de interface próximos aos registros de classe que os implementam. No entanto, se você colocar a extensão em Pacote/Extensões/Extensão, não precisará determinar qual aplicativo usar para cada interface.

É possível ter várias extensões de comInterface no elemento Applications/Application, mas na maioria dos casos isso não é necessário nem recomendado. Um exemplo de um caso de borda em que várias extensões de comInterface são necessárias é se um pacote precisa de alguns dos registros para ter CompatMode="clássico", enquanto outros têm CompatMode="modern", a única maneira de fazer isso é dividi-los entre extensões.

Nota

Todos os registros em comInterface que dependem de outro registro (por exemplo, um de Interface faz referência a um ProxyStub e/ou um TypeLib) devem estar na mesma extensão comInterface.

Requisitos

Item	Valor
namespace	`http://schemas.microsoft.com/appx/manifest/com/windows10/4`
versão mínima do sistema operacional	Windows 10 (Build 20348)

Compartilhar via