Edit

Share via

Protocol (extensions schema for Windows 8.1)

  • Article

Declares an app extensibility point of type windows.protocol. A URI association indicates that the app is registered to handle URIs with the specified scheme.

Element hierarchy

<Extension>
<Protocol>

Syntax

<Protocol Name           = A string between 2 and 39 characters in length that contains numbers, lowercased letters, dots ('.'), pluses('+'), or hyphens ('-'). The string can't start with a dot ('.').

          m:DesiredView? = "default" | "useLess" | "useHalf" | "useMore" | "useMinimum" >

  <!-- Child elements -->
  ( Logo?
  & DisplayName?
  )

</Protocol>

Key

?   optional (zero or one) &   interleave connector (may occur in any order)

Attributes and Elements

Attributes

Attribute Description Data type Required Default value
Name

The name of the URI scheme, such as "mailto". This name must be unique for the package.

 A string between 2 and 39 characters in length that contains numbers, lowercased letters, dots ('.'), pluses('+'), or hyphens ('-'). The string can't start with a dot ('.'). Yes
m:DesiredView

The desired view of the app.

Windows Phone:  DesiredView isn't supported for Windows Phone.

This attribute can have one of the following values:

  • default
  • useLess
  • useHalf
  • useMore
  • useMinimum
 No

 

Child Elements

Child Element Description
DisplayName

A friendly name that can be displayed to users. This string is localizable.
Logo

A path to a file that contains an image.

 

Parent Elements

Parent Element Description
Extension (type: CT_ApplicationExtension)

Declares an extensibility point for the app.

 

See also

Tasks How to handle URI activation

Concepts App contracts and extensions

Requirements

Value
Namespace http://schemas.microsoft.com/appx/2010/manifest