Edit

Share via

desktop:StartupTask

  • Article

Represents a desktop process that runs during app startup.

Element hierarchy

<Package>

      <Applications>

            <Application>

                  <Extensions>

                        <Desktop:Extension>

                              <\Desktop:StartupTask>

Syntax

<desktop:StartupTask
  TaskId = 'A string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
  Enabled = 'A boolean value.'
  DisplayName = 'A string with a value between 1 and 256 characters in length. This string is localizable.'
  rescap5:ImmediateRegistration =  'A boolean value.' />

Attributes and elements

Attributes

Attribute Description Data type Required Default value
TaskId A unique identifier for the task. A string between 1 and 32767 characters in length with a non-whitespace character at its beginning and end. Yes
Enabled Indicates whether or not the task is enabled. A packaged desktop app can set this value to true to enable the startup behavior when the app is first launched, without requiring a call to RequestEnableAsync. A boolean value. No
DisplayName A user-friendly name to display to users. A string between 1 and 256 characters in length. This string is localizable. No
rescap5:ImmediateRegistration Indicates whether the task should be registered immediately on installation. When set to true, and Enabled is also set to true, the startup task is enabled on installation, without requiring the app to be launched first. Requires the Microsoft.nonUserConfigurableStartupTasks_8wekyb3d8bbwe custom capability. A boolean value No

Child elements

None

Parent elements

Parent element Description
desktop:Extension Declares an extensibility point for the app.

Requirements

Item Value
Desktop http://schemas.microsoft.com/appx/manifest/desktop/windows10
Rescap5 http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/5
Minimum OS Version Windows 10 version 1607 (Build 14393)