com:Interface (потомок com:Extension)

Статья
10/23/2024

Регистрирует новые com-интерфейсы.

Иерархия элементов

пакета

<com:Interface>

<com:Interface>

Синтаксис

<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>

Ключ

? необязательный (ноль или один)

Атрибуты и элементы

Атрибуты

Атрибут	Описание	Тип данных	Обязательно
идентификатора	Идентификатор интерфейса (IID).	Буквенно-цифровые строки, разделенные периодом от 1 до 255 символов длиной (например, Foo.Bar или Foo.Bar.1).	Да
UseUniversalMarshaler	Задайте для этого значение true, чтобы использовать универсальный маршалер OLE в качестве заглушки прокси-сервера.	Необязательное логическое значение.	Нет
ProxyStubClsid	Соответствует значению реестра ProxyStubClsid32.	Необязательный GUID в форме xxxx-xxxx-xxxx-xxxx-xxxx-xxxx.	Нет
SynchronousInterface	Идентификатор другой регистрации интерфейса, содержащей асинхроннуюinterface, которая ссылается на эту регистрацию. Другой интерфейс должен находиться в том же расширении comInterface.	Необязательный GUID в форме xxxx-xxxx-xxxx-xxxx-xxxx-xxxx.	Нет
асинхронныйinterface	Идентификатор другой регистрации интерфейса, содержащей СинхронныйInterface, ссылающийся на эту регистрацию. Другой интерфейс должен находиться в том же расширении comInterface.	Необязательный GUID в форме xxxx-xxxx-xxxx-xxxx-xxxx-xxxx.	Нет

Дочерние элементы

Дочерний элемент	Описание
com:TypeLib	Библиотека типов для интерфейса.

Родительские элементы

Родительский элемент	Описание
com:ComInterface	Объявляет точку расширения пакета типа windows.comInterface. Расширение comInterface может включать три типа регистраций: интерфейс, ProxyStubили TypeLib.

Замечания

Атрибут proxyStubClsid должен ссылаться на идентификатор ProxyStub в том же расширении comInterface. ProxyStubClsid можно использовать только для заглушки прокси с реализацией в составе пакета. Чтобы использовать универсальный маршалер OLE в качестве заглушки прокси-сервера, используйте вместо этого UseUniversalMarshaler.

Если UseUniversalMarshaler имеет значение true, регистрация интерфейса должна включать TypeLib.

Заметка

ProxyStubClsid и UseUniversalMarshaler являются взаимоисключающими.

Требования

Пункт	Ценность
пространства имен	`http://schemas.microsoft.com/appx/manifest/com/windows10`
минимальная версия ОС	Windows 10 версии 1703 (сборка 15063)

Поделиться через