uap:Protocol (Windows 10)

[アーティクル]
10/30/2023

windows.protocol 型のアプリ拡張ポイントを宣言します。 URI 関連付けは、指定されたスキームで URI を処理するためにアプリが登録されていることを示します。

要素の階層

<uap:Protocol>

構文

<uap:Protocol
  Name = 'A string with a value between 2 and 39 characters in length that contains numbers, lowercase letters, periods ("."), plus signs ("+"), or dashes ("-"). The string cannot start with a period (".").'
  DesiredView = 'A string that can have one of the following values: "default", "useLess", "useHalf", "useMore", or "useMinimum".'
  ReturnResults = 'An optional string that can have one of the following values: "none", "always", "optional".' >

  <!-- Child elements -->
  uap:Logo?
  & uap:DisplayName?
  & desktop7:ProgId
</uap:Protocol>

キー

? 省略可能 (0 または 1) & インターリーブコネクタ (任意の順序で発生する可能性があります)

属性と要素

属性

属性	説明	データ型	必須
名前	URI スキームの名前 (など `mailto`)。この名前は、パッケージに対して一意である必要があります。	数字、小文字、ピリオド ()、プラス記号 ()、ダッシュ`-` (`.+`) を含む長さが 2 ~ 39 文字の文字列。文字列をピリオド (`.`) で始めることはできません。	Yes
DesiredView	予定の起動時に使用する画面領域の量。	default、useLess、useHalf、useMore、useMinimum のいずれかの値を持つ文字列。	いいえ
ReturnResults	URI のアクティブ化を介して呼び出されたときに、アプリが値を返すかどうかを指定します。	"none" (値を返しません)、"always" (URI アクティブ化は常に結果を返します)、"省略可能" ( LAUNCHUriForResultsAndContinueAsync を使用して結果に対してアクティブ化された場合、URI アクティブ化は結果を返します) のいずれかの値を持つことができます。省略可能な文字列。	いいえ

子要素

子要素	説明
uap:DisplayName	ユーザーに表示できるフレンドリ名。
uap:Logo	イメージを含むファイルへのパス。
desktop7:ProgId	CLSID に関連付けることができるプログラム識別子 (ProgID)。

親要素

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

例

次の例は、いずれかの SDK サンプルのパッケージマニフェストから取得したものです。

<Applications>
  <Application
    Id="App"
    StartPage="default.html">
    <Extensions>
      <uap:Extension
        Category="windows.protocol">
        <uap:Protocol
          Name="alsdk" />
      </uap:Extension>
    </Extensions>
  </Application>
</Applications>

こちらもご覧ください

タスクURI のアクティブ化を処理する方法

概念アプリコントラクトと拡張機能

必要条件

Item	値
Namespace	`http://schemas.microsoft.com/appx/manifest/uap/windows10`
Minimum OS Version	Windows 10 バージョン 1511 (ビルド 10586)