com:Interface (descendente de com:Extension)

  • Artigo

Registra novas interfaces COM.

Hierarquia de elementos

do pacote

    aplicativos <>

          <application>

              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 Valor padrão
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)