com4:Extension

COM 登録をアプリ パッケージの外部のクライアントに公開する機能を提供します。 com4 拡張機能は、以前の COM スキーマ バージョンのスーパーセットであり、置き換わる新しいバージョンです。 詳細については、「解説」セクションを参照してください。

要素階層

<パッケージの>

     <アプリケーションの>

          <アプリケーション>

               <拡張機能の>

                    <com4:Extension>

     <拡張機能の>

          <com4:Extension>

構文

<com4:Extension
  Category = 'A string that can have one of the following values: "windows.comServer" or "windows.comInterface".'
  Executable = 'An optional string with a value between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or *.'
  EntryPoint = 'An optional string with a value between 1 and 256 characters in length that cannot start or end with a whitespace character.'
  RuntimeType = 'An optional string with a value between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *.'
  StartPage = 'An optional string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
  ResourceGroup = 'An optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
  TrustLevel = 'An optional string the can have one of the following values: "appContainer" or "mediumIL".'
  RuntimeBehavior = 'An optional string the can have one of the following values: "windowsApp", "packagedClassicApp", or "win32App".'
  HostId = 'An optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
  Parameters = 'An optional string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
  uap11:Id = 'An optional string with a value between 1 and 255 characters in length with a non-whitespace character at its beginning and end.'
  uap11:Subsystem = 'An optional string that can have one of the following values: "console" or "windows".'
  uap11:SupportsMultipleInstances = 'An optional boolean value.'
  uap11:ResourceGroup = 'An optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
  uap11:CurrentDirectoryPath = 'An optional string that cannot contain these characters: <, >, |, ?, or *. >'
  uap11:Parameters = 'An optional string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
  desktop7:CompatMode = 'An optional string the can have one of the following values: "classic" or "modern".'
  desktop7:Scope = 'An optional string that can have one of the following values: "machine" or "user".' />

  <!-- Child elements -->
  com4:ComServer
  com4:ComInterface

</com4:Extension>

属性と要素

属性

子要素

親要素

備考

com4 拡張機能は、基本的に古い windows.comServer/windows.comInterface 拡張構文の書き換えです。 この拡張機能は、継承された構文と同じ動作を持つ、以前の com 拡張機能のスーパーセットです。 パッケージ化で使用される新しい構文のマニフェスト検証は、拡張機能のセマンティック要件に合わせて調整されます。

• 以前のバージョンでは、各拡張機能は個別のドキュメントとして扱われ、一意でないキーと未解決の参照を検証できます。
• 以前のバージョンでは、一意/キー制約の対象となる属性の重複は、重複した属性が拡張機能の同じインスタンスに表示される場合にのみ、マニフェスト検証によってキャッチされていました。 これらの属性を複製したパッケージはデプロイに失敗し、問題を特定するための診断情報が制限されます。
• 以前のバージョンでは、参照先が拡張機能の別のインスタンスにある keyref はマニフェスト検証によってブロックされます。これは、配置/ランタイム動作でサポートされる内容に対する人為的な制限です。

すべての windows.comServer/windows.comInterface 拡張機能に新しい com4 名前空間を使用できる Windows 11 を対象とするアプリケーションでは、それを使用する必要があります。 次のような理由から、新しい名前空間と古い名前空間の混在はお勧めしません。

• 新しい名前空間をサポートするバージョンにパッケージをデプロイすると、すべての名前空間の拡張機能が処理され、異なる名前空間バージョンを使用する拡張機能間で重複するすべての一意識別子が失敗します。 以前の名前空間を使用すると、マニフェストの検証でこれらのエラーが検出されなくなります。
• 古い名前空間スキーマの制限により、古い構文の keyref は、拡張機能の異なるインスタンスにあるため、新しい構文のキーを参照できません。

次の com4 構文セマンティクスの使用には、機能の要件があります。

• CompatMode="classic" にはMicrosoft.classicAppCompat_8wekyb3d8bbweが必要です
• Scope="machine" にはMicrosoft.classicAppCompatElevated_8wekyb3d8bbweが必要です

次の例は、同じクラスのアウトプロセスおよびインプロセス サーバー実装を登録する方法を示しています。

例

<com4:Class Id="f4ed7720-9b3a-44a4-xxxx-xxxxxxxxxxxx" DisplayName="CLSID_Foo"/> 
<com:ExeServer Executable="MyServer.exe" DisplayName="My server">  
  <com4:ClassReference Id="f4ed7720-9b3a-44a4-xxxx-xxxxxxxxxxxx"/>  
</com:ExeServer> 
<com4:InProcessServer Path="MyServer.dll">  
  <com4:ClassReference Id="f4ed7720-9b3a-44a4-xxxx-xxxxxxxxxxxx"/>  
</com4:InProcessServer> 

com4 拡張機能の新機能

• インプロセス サーバー (アンマネージドとマネージドの両方) とカスタムインプロセス ハンドラー (つまり、OLE の既定のハンドラーではない) のサポート。 この機能は現在、ポリシーによって機能が制限され、制限されています。
  • これは現在、外部の場所を持つパッケージでのみ使用することを目的としています。パッケージの dll がパッケージの外部に読み込まれるのを妨げるインストール場所の ACL が原因で、ほとんどの通常のパッケージでは機能しません。 外部の場所を持つパッケージの詳細については、「外部の場所でパッケージ化してパッケージ ID を付与する」を参照してください。
• TypeLib をクラス登録に関連付けることができるようになりました。

必要条件