desktop10:Extension (в пакете или расширениях)

Объявляет точку расширяемости для приложения.

Иерархия элементов

> пакета<

     <расширения>

          <desktop10:Extension>

Синтаксис

<desktop10:Extension
  Category = 'A string that can be one of the following values: "windows.Folder", "windows.DataShortcuts", or "windows.CustomDesktopEventLog".'
  Executable = 'An optional string with a value between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or *. It specifies the default executable for the extension. If not specified, the executable defined for the app is used.  If specified, the EntryPoint property is also used. If that EntryPoint property isnt specified, the EntryPoint defined for the app is used.'
  EntryPoint = 'An optional string with a value between 1 and 256 characters in length, representing the  task handling the extension. This is normally the fully namespace-qualified name of a Windows Runtime type. If EntryPoint is not specified, the EntryPoint defined for the app is used instead.'
  RuntimeType = 'An optional string with a value between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *.'
  StartPage = 'An optional string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
  uap10:TrustLevel = 'An optional string that can have one of the following values: "appContainer" or "mediumIL".'
  uap10:RuntimeBehavior = 'An optional string that can have one of the following values: "windowsApp", "packagedClassicApp", or "win32App".'
  uap10:HostId = 'An alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
  uap10:Parameters = 'An optional string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.' 
  uap11:Id = 'An optional string with a value between 1 and 255 characters in length with a non-whitespace character at its beginning and end.'
  uap11:Subsystem = 'An optional string that can have one of the following values: "console" or "windows".'
  uap11:SupportsMultipleInstances = 'An optional boolean value.'
  uap11:ResourceGroup = 'An optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
  uap11:CurrentDirectoryPath = 'An optional string that cannot contain these characters: <, >, |, ?, or *. >'
  uap11:Parameters = 'An optional string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
  desktop7:CompatMode = 'An optional string the can have one of the following values: "classic" or "modern".'
  desktop7:Scope = 'An optional string that can have one of the following values: "machine" or "user".' >

  <!-- Child Elements -->
  desktop10:Folder
  desktop10:DataShortcuts
  desktop10:CustomDesktopEventLog

</desktop10:Extension>

Атрибуты и элементы

Атрибуты

Атрибут	Описание	Тип данных	Обязательно	Значение по умолчанию
категории	Категория расширения.	Строка, которая может иметь одно из следующих значений: окнах. Окнапапок . DataShortcutsили окнах. CustomDesktopEventLog.	Да
исполняемых	Исполняемый файл по умолчанию.	Необязательная строка со значением от 1 до 256 символов длиной, которая должна заканчиваться .exe и не может содержать следующие символы: <, >, :, ", |, ?или *. Он задает исполняемый файл по умолчанию для расширения. Если это не указано, используется исполняемый файл, определенный для приложения. При указании также используется свойство EntryPoint. Если это свойство EntryPoint не указано, используется запись, определенная для приложения.	Нет
EntryPoint	Идентификатор активируемого класса.	Необязательная строка со значением от 1 до 256 символов длиной, представляющая задачу, обрабатывающую расширение. Обычно это полное имя пространства имен типа среды выполнения Windows. Если Запись не указана, вместо этого используется точка входа, определенная для приложения.	Нет
RuntimeType	Поставщик среды выполнения. Этот атрибут обычно используется при наличии смешанных платформ в приложении.	Необязательная строка со значением от 1 до 255 символов длиной, которая не может начинаться или заканчиваться периодом или содержать следующие символы: <, >, :, ", /, \, |, ?или *.	Нет
StartPage	Веб-страница, обрабатывающая точку расширяемости.	Необязательная строка со значением от 1 до 256 символов длиной, которая не может содержать следующие символы: <, >, :, ", |, ?или *.	Нет
uap10:TrustLevel	Указывает уровень доверия расширения.	Необязательная строка, которая может иметь одно из следующих значений: appContainer или mediumIL.	Нет
uap10:RuntimeBehavior	Указывает поведение времени выполнения расширения.	Необязательная строка, которая может иметь одно из следующих значений: windowsApp, packagedClassicAppили win32App.	Нет
uap10:HostId	Указывает идентификатор среды выполнения узла для расширения.	Буквенно-цифровые строки со значением от 1 до 255 символов длиной. Должно начинаться с буквы.	Нет
uap10:Parameters	Содержит параметры командной строки для передачи в расширение. Поддерживается только для классических приложений, имеющих удостоверение пакета.	Необязательная строка со значением от 1 до 32767 символов длиной с символом без пробелов в начале и конце.	Нет
uap11:Id	Идентификатор расширения. Идентификатор должен быть уникальным для всех расширений в пакете.	Необязательная строка со значением от 1 до 255 символов длиной с символом без пробелов в начале и конце.	Нет
uap11:Подсистема	Подсистема, предназначенная расширением.	Необязательная строка, которая может иметь одно из следующих значений: консоли или окнах.	Нет
uap11:SupportsMultipleInstances	Указывает, должны ли экземпляры выполняться в разных процессах. Значение по умолчанию — false.	Необязательное логическое значение.	Нет
uap11:ResourceGroup	Тег, который можно использовать для группирования активаций расширений вместе для целей управления ресурсами (например, ЦП и памяти). Значение, которое можно задать ResourceGroup, является свободным и гибким. См. Application@ResourceGroup.	Необязательная буквенно-цифровые строки со значением от 1 до 255 символов длиной. Должно начинаться с буквы.	Нет
uap11:CurrentDirectoryPath	Указывает начальный каталог при запуске процесса приложения. Этот атрибут поддерживает макросы. Дополнительные сведения см. в разделе Макросы в схеме манифеста пакета.	Необязательная строка, которая не может содержать эти символы: <, >, |, ?или *. >	Нет
uap11:Parameters	Подсистема, предназначенная расширением. Этот атрибут поддерживает макросы. Дополнительные сведения см. в разделе Макросы в схеме манифеста пакета.	Необязательная строка со значением от 1 до 32767 символов длиной с символом без пробелов в начале и конце.	Нет
desktop7:CompatMode	Указывает, регистрируются ли сведения этого расширения в Windows классическими способами (например, распакованные типы приложений регистрируются с помощью COM через реестр) или новыми более расширенными способами. Значение по умолчанию — "современный". Для compatMode="classic" требуется возможность Microsoft.classicAppCompat_8wekyb3d8bbwe.	Необязательная строка может иметь одно из следующих значений: классических или современных.	Нет
desktop7:Scope	Указывает, отображаются ли регистрации только для других приложений, работающих как пользователь, у которого зарегистрирован этот пакет (пользователь), или отображается ли они всем пользователям и службам на компьютере (компьютере). Значение по умолчанию — user. Scope="machine" требует возможности Microsoft.classicAppCompatElevated_8wekyb3d8bbwe.	Необязательная строка, которая может иметь одно из следующих значений: компьютера или пользователя.	Нет

Дочерние элементы

Дочерний элемент	Описание
desktop10:Folder	Определяет папку для хранения ярлыков с локализуемыми сведениями.
desktop10:DataShortcuts	Указывает список неисполнимых ярлыков.
desktop10:CustomDesktopEventLog	Определяет пользовательский журнал событий.

Родительские элементы

Родительский элемент	Описание
расширений (в пакете)	Определяет одну или несколько точек расширяемости для приложения.

Требования

Пункт	Ценность
Пространство имен	http://schemas.microsoft.com/appx/manifest/desktop/windows10/10
uap10	http://schemas.microsoft.com/appx/manifest/uap/windows10/10
минимальная версия ОС	Windows 11 версии 22H2 (сборка 22621)