desktop2:Extension (パッケージ/拡張機能内)

アプリの機能拡張ポイントを宣言します。

要素の階層

<パッケージ>

    <拡張機能>

         <desktop2:Extension>

構文

<Extension
  Category = 'A string that can have one of the following values: "windows.firewallRules" or "windows.desktopEventLogging".' 
  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 *. It specifies the default executable for the extension. If not specified, the executable defined for the app is used.  If specified, the EntryPoint property is also used. If that EntryPoint property isnt specified, the EntryPoint defined for the app is used.'
  EntryPoint = 'An optional string with a value between 1 and 256 characters in length, representing the  task handling the extension. This is normally the fully namespace-qualified name of a Windows Runtime type. If EntryPoint is not specified, the EntryPoint defined for the app is used instead.'
  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 *.'
  uap10:TrustLevel = 'An optional string that can have one of the following values: "appContainer" or "mediumIL".'
  uap10:RuntimeBehavior = 'An optional string that can have one of the following values: "windowsApp", "packagedClassicApp", or "win32App".'
  uap10:HostId = 'An optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
  uap10:Parameters = 'A string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.' >

  <!-- Child elements -->
  desktop2:FirewallRules
  desktop2:DesktopEventLogging?

</uap:Extension>

キー

? 省略可能 (0 または 1)

属性と要素

属性

属性	説明	データ型	必須	既定値
カテゴリ	拡張機能のカテゴリ。	windows.firewallRules または windows.desktopEventLogging のいずれかの値を持つ文字列。	Yes
[実行可能ファイル]	既定の起動実行可能ファイル。	1 から 256 文字の長さの値を持つ省略可能な文字列。末尾が でなければならず.exe、、、"?|または *の文字<>:を含めることはできません。 拡張機能の既定の実行可能ファイルを指定します。 指定しない場合は、アプリに定義されている実行可能ファイルが使用されます。 指定した場合は、EntryPoint プロパティも使用されます。 その EntryPoint プロパティが指定されていない場合は、アプリに対して定義されている EntryPoint が使用されます。	いいえ
EntryPoint	アクティブ化可能なクラス ID。	拡張機能を処理するタスクを表す、1 ~ 256 文字の値を持つ省略可能な文字列。 これは、通常、Windows ランタイムの型の完全な名前空間修飾名です。 EntryPoint が指定されていない場合は、アプリに対して定義されている EntryPoint が代わりに使用されます。	いいえ
RuntimeType	ランタイム プロバイダー。 この属性は、通常、アプリにフレームワークが混在している場合に使用されます。	1 ~ 255 文字の長さの値を持つ省略可能な文字列。ピリオドで開始または終了したり、次:\*>?"|/の文字を含めたりすることはできません。 <	いいえ
StartPage	拡張ポイントを処理する Web ページです。	1 ~ 256 文字の長さの値を持つ省略可能な文字列。この文字列<には、、、:>、"、|、?または *を含めることはできません。	いいえ
uap10:TrustLevel	拡張機能の信頼レベルを指定します。	appContainer または mediumIL のいずれかの値を指定できる省略可能な文字列。	いいえ
uap10:RuntimeBehavior	拡張機能の実行時の動作を指定します。	windowsApp、packagedClassicApp、win32App のいずれかの値を持つ省略可能な文字列。	いいえ
uap10:HostId	拡張機能のホスト ランタイムの ID を指定します。	1 ~ 255 文字の長さの値を持つオプションの英数字文字列。 文字で始まる必要があります。	いいえ
uap10:Parameters	拡張機能に渡すコマンド ライン パラメーターが含まれます。 パッケージ ID を持つデスクトップ アプリでのみサポートされます。	長さが 1 ~ 32767 文字の文字列で、先頭と末尾に空白文字以外の文字が含まれます。	いいえ

子要素

子要素	説明
AppPrinter	Windows デスクトップ ブリッジ アプリにソフトウェア ファイル プリンターをインストールできるようにします。
SearchFilterHandler	Windows デスクトップ ブリッジ アプリで IFilters を登録し、検索用のファイル プロパティを抽出できるようにします。
SearchPropertyHandler	Windows デスクトップ ブリッジ アプリがシステムにプロパティ ハンドラーをインストールできるようにします。
DesktopEventLogging	Windows デスクトップ ブリッジ アプリが Windows イベント ログに登録できるようにします。
FirewallRules	Windows デスクトップ ブリッジ アプリで使用されるファイアウォール例外規則を指定します。

親要素

親要素	説明
desktop2:Extension	アプリの機能拡張ポイントを宣言します。

要件

Item	値
名前空間	http://schemas.microsoft.com/appx/manifest/desktop/windows10/2
uap10	http://schemas.microsoft.com/appx/manifest/uap/windows10/10
Minimum OS Version	Windows 10 バージョン 1703 (ビルド 15063)