com:Interface (com:Extension の子孫)

  • [アーティクル]

新しい COM インターフェイスを登録します。

要素階層

<パッケージの>

     <アプリケーションの>

          <アプリケーション>

               <拡張機能の>

                    <com:Extension>

                         <com:ComInterface>

                              <com:Interface>

     <拡張機能の>

          <com:Extension>

               <com:ComInterface>

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

鍵

? 省略可能 (ゼロまたは 1)

属性と要素

属性

属性 形容 データ型 必須 既定値
ID インターフェイス ID (IID)。 長さが 1 ~ 255 文字の範囲で区切られた英数字文字列 (Foo.Bar や Foo.Bar.1 など)。 はい
UseUniversalMarshaler の OLE ユニバーサル マーシャラーをプロキシ スタブとして使用する場合は、これを true に設定します。 省略可能なブール値。 いいえ
ProxyStubClsid ProxyStubClsid32 レジストリ値に対応します。 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx 形式の省略可能な GUID。 いいえ
SynchronousInterface この登録を参照する AsynchronousInterface を含む別のインターフェイス登録の ID。 もう 1 つのインターフェイスは、同じ comInterface 拡張機能内にある必要があります。 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx 形式の省略可能な GUID。 いいえ
AsynchronousInterface この登録を参照する SynchronousInterface を含む別のインターフェイス登録の ID。 もう 1 つのインターフェイスは、同じ comInterface 拡張機能内にある必要があります。 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx 形式の省略可能な GUID。 いいえ

子要素

子要素 形容
com:TypeLib インターフェイスのタイプ ライブラリ。

親要素

Parent 要素 形容
com:ComInterface windows.comInterface型のパッケージ拡張ポイントを宣言します。 comInterface 拡張機能には、インターフェイス、ProxyStub、または TypeLibの 3 種類の登録が含まれる場合があります。

備考

ProxyStubClsid 属性は、同じ comInterface 拡張機能内の ProxyStub の ID を参照する必要があります。 ProxyStubClsid は、パッケージの一部として実装されているプロキシ スタブにのみ使用できます。 プロキシ スタブとして OLE ユニバーサル マーシャラーを使用するには、代わりに UseUniversalMarshaler 使用します。

UseUniversalMarshaler true の場合、インターフェイスの登録には TypeLib含める必要があります。

手記

ProxyStubClsid と UseUniversalMarshaler は相互に排他的です。

必要条件

アイテム 価値
名前空間の http://schemas.microsoft.com/appx/manifest/com/windows10
最小 OS バージョン Windows 10 バージョン 1703 (ビルド 15063)