uap :Protocol (Windows 10)

Article
10/30/2023

Déclare un point d’extensibilité d’application de type windows.protocol. Une association d’URI indique que l’application est inscrite pour gérer les URI avec le schéma spécifié.

Hiérarchie d’éléments

<uap:Extension>

<uap:Protocol>

Syntax

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

Clé :

? connecteur facultatif (zéro ou un) & entrelacement (peut se produire dans n’importe quel ordre)

Attributs et éléments

Attributs

Attribut	Description	Type de données	Obligatoire
Nom	Nom du schéma d’URI (par exemple `mailto`). Ce nom doit être unique pour le package.	Chaîne dont la longueur est comprise entre 2 et 39 caractères et qui contient des chiffres, des lettres minuscules, des points (`.`), des signes plus (`+`) ou des tirets (`-`). La chaîne ne peut pas commencer par un point (`.`).	Yes
DesiredView	Quantité d’espace d’écran souhaitée à utiliser lors du lancement du rendez-vous.	Chaîne qui peut avoir l’une des valeurs suivantes : default, useLess, useHalf, useMore ou useMinimum.	No
ReturnResults	Spécifie si l’application retourne une valeur lorsqu’elle est appelée via une activation d’URI.	Chaîne facultative qui peut avoir l’une des valeurs suivantes : « none » (ne retourne pas de valeur), « always » (l’activation d’URI renvoie toujours un résultat), « facultatif » (l’activation d’URI retourne un résultat si elle est activée pour les résultats à l’aide de LaunchUriForResultsAndContinueAsync).	No

Éléments enfants

Élément enfant	Description
uap:DisplayName	Nom convivial qui peut être affiché aux utilisateurs.
uap:Logo	Chemin d’accès à un fichier qui contient une image.
desktop7 :ProgId	Identificateur programmatique (ProgID) qui peut être associé à un CLSID.

Éléments parents

Élément parent	Description
uap:Extension	Déclare un point d’extensibilité pour l’application.

Exemples

L’exemple suivant est tiré du manifeste de package de l’un des exemples de SDK.

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

Voir aussi

TâchesComment gérer l’activation d’URI

Concepts Contratset extensions d’application

Configuration requise

Élément	Valeur
Espace de noms	`http://schemas.microsoft.com/appx/manifest/uap/windows10`
Minimum OS Version	Windows 10 version 1511 (build 10586)

Partager via