element-protocol.md

description	Search.Product	title	ms.assetid	keywords	ms.topic	ms.date
Declares an app extensibility point of type windows.protocol (Windows 8).	eADQiWindows 10XVcnh	Protocol (Windows 8 package schema)	ac911c85-02eb-408c-8c4b-24a4e172df8b	windows 10, uwp, schema, package manifest	reference	04/05/2017

Protocol (package schema for Windows 8)

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

<Package>

<Applications>

<Application>

<Extensions>

<Extension>

<Protocol>

Syntax

<Protocol Name = A string between 3 and 39 characters in length that contains numbers, lowercased letters, or a hyphen ('-'). >

  <!-- 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 3 and 39 characters in length that contains numbers, lowercased letters, or a hyphen ('-').	Yes

 

Child Elements

Child Element	Description
DisplayName	A friendly name that can be displayed to users.
Logo	A path to a file that contains an image.

 

Parent Elements

Parent Element	Description
Extension (in type: CT_ApplicationExtensions)	Declares an extensibility point for the app.

 

Examples

The following example is taken from the package manifest of one of the SDK samples.

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

See also

Tasks How to handle URI activation

Concepts App contracts and extensions

Requirements

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