com:Interface (descendente de com:Extension)

Artigo
10/23/2024

Registra novas interfaces COM.

Hierarquia de elementos

do pacote

aplicativos <>

extensões de <>

<com:Extension>

<com:ComInterface>

<com:Interface>

extensões de <>

<com:Extension>

<com:ComInterface>

<com:Interface>

Sintaxe

<com:Interface
    Id = 'An alphanumeric string separated by a period with a value between 1 and 255 characters in length (for example, Foo.Bar or Foo.Bar.1).'
    UseUniversalMarshaler = 'An optional boolean value.'
    ProxyStubClsid = 'An optional GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.'
    SynchronousInterface = 'An optional GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.'
    AsynchronousInterface = 'An optional GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.' >

  <!-- Child elements -->
  TypeLib?

</com:Interface>

Chave

? opcional (zero ou um)

Atributos e elementos

Atributos

Atributo	Descrição	Tipo de dado	Necessário
ID	Uma ID de interface (IID).	Uma cadeia de caracteres alfanumérica separada por um período entre 1 e 255 caracteres de comprimento (por exemplo, Foo.Bar ou Foo.Bar.1).	Sim
UseUniversalMarshaler	Defina isso como true para usar o Marshaler Universal OLE como o stub de proxy.	Um valor booliano opcional.	Não
proxyStubClsid	Corresponde ao proxyStubClsid32 valor do registro.	Um GUID opcional no formulário xxxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxx.	Não
SynchronousInterface	A ID de outro registro de interface que contém AsynchronousInterface que faz referência a esse registro. A outra interface deve estar na mesma extensão comInterface.	Um GUID opcional no formulário xxxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxx.	Não
Assíncrona	A ID de outro registro de interface que contém SynchronousInterface que faz referência a esse registro. A outra interface deve estar na mesma extensão comInterface.	Um GUID opcional no formulário xxxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxx.	Não

Elementos filho

Elemento filho	Descrição
com:TypeLib	Uma biblioteca de tipos para uma interface.

Elementos pai

Elemento pai	Descrição
com:ComInterface	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.

Observações

O atributo ProxyStubClsid deve referenciar a ID de um ProxyStub na mesma extensão de comInterface . ProxyStubClsid só pode ser usado para stubs de proxy com uma implementação como parte do pacote. Para usar o Marshaler Universal OLE como o stub de proxy, use UseUniversalMarshaler em vez disso.

Se UseUniversalMarshaler for true, o registro da interface deverá incluir TypeLib.

Nota

ProxyStubClsid e UseUniversalMarshaler são mutuamente exclusivos.

Requisitos

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

Partilhar via