desktop:Extension

Declareert een uitbreidbaarheidspunt voor de app.

Elementhiërarchie

<Pakket>

     <toepassingen>

          <\Application>

               <\Extensions>

                    <\Desktop:Extension>

Syntaxis

<desktop:Extension
  Category = 'A string value that can be one of the following values: "windows.fullTrustProcess", "windows.startupTask", "windows.toastNotificationActivation", or "windows.searchProtocolHandler".'
  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 *.'
  ResourceGroup =  'An optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
  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 optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with an alphabetic character.'
  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.'
  previewappcompat:CompatMode = 'An optional string that can have one of the following values: "classic" or "modern".'
  previewappcompat:Scope = 'An optional string that can be one of the following values: "user" or "machine".'
  uap11:Id = 'An optional string with a value between 1 and 256 characters in length.'
  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 with a value between 1 and 256 characters in length 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 = 'A string that can have one of the following values: "classic" or "modern".'
  desktop7:Scope = 'A string that can have one of the following values: "machine" or "user".' >

  <!-- Child elements -->
  desktop:FullTrustProcess?
  desktop:StartupTask?
  desktop:ToastNotificationActivation?
  desktop:SearchProtocolHandler?

</desktop:Extension>

Sleutel

? optioneel (nul of één)

Kenmerken en elementen

Kenmerken

Attribuut	Beschrijving	Gegevenstype	Vereist	Standaardwaarde
categorie	De categorie van de extensie.	Een tekenreekswaarde die een van de volgende waarden kan zijn: windows.fullTrustProcess, windows.startupTask, windows.toastNotificationActivationof windows.searchProtocolHandler.	Ja
uitvoerbare	Het standaard uitvoerbare bestand starten.	Een optionele tekenreeks met een waarde tussen 1 en 256 tekens lang die moet eindigen op .exe en mag deze tekens niet bevatten: <, >, :, ", |, ?of *. Hiermee geeft u het standaard uitvoerbare bestand voor de extensie op. Als dit niet is opgegeven, wordt het uitvoerbare bestand gebruikt dat voor de app is gedefinieerd. Indien opgegeven, wordt ook de eigenschap EntryPoint gebruikt. Als deze Eigenschap van EntryPoint niet is opgegeven, wordt het EntryPoint dat voor de app is gedefinieerd, gebruikt.	Nee
EntryPoint-	De activeringsbare klasse-id.	Een optionele tekenreeks met een waarde tussen 1 en 256 tekens, die de taak aangeeft die de extensie verwerkt. Dit is normaal gesproken de volledig naamruimte-gekwalificeerde naam van een Windows Runtime-type. Als EntryPoint niet is opgegeven, wordt in plaats daarvan het EntryPoint gebruikt dat voor de app is gedefinieerd.	Nee
RuntimeType-	De runtime-provider. Dit kenmerk wordt doorgaans gebruikt wanneer er gemengde frameworks in een app zijn.	Een optionele tekenreeks met een waarde tussen 1 en 255 tekens die niet kan beginnen of eindigen met een punt of deze tekens mag bevatten: <, >, :, ", /, \, |, ?of *.	Nee
StartPage-	De webpagina die het uitbreidbaarheidspunt verwerkt.	Een optionele tekenreeks met een waarde tussen 1 en 256 tekens die deze tekens niet mag bevatten: <, >, :, ", |, ?of *.	Nee
uap10:TrustLevel	Hiermee geeft u het vertrouwensniveau van de extensie.	Een optionele tekenreeks met een van de volgende waarden: appContainer of mediumIL-.	Nee
uap10:RuntimeBehavior	Hiermee geeft u het uitvoeringstijdgedrag van de extensie.	Een optionele tekenreeks met een van de volgende waarden: windowsApp, packagedClassicAppof win32App.	Nee
uap10:HostId	Hiermee geeft u de id van de hostruntime voor de extensie.	Een optionele alfanumerieke tekenreeks met een waarde tussen 1 en 255 tekens. Moet beginnen met een alfabetisch teken.	Nee
uap10:Parameters	Bevat opdrachtregelparameters die moeten worden doorgegeven aan de extensie. Alleen ondersteund voor desktop-apps met pakketidentiteit.	Een optionele tekenreeks met een waarde tussen 1 en 32767 tekens lang met een niet-witruimteteken aan het begin en einde.	Nee
uap11:Id	Een id voor de extensie. De id moet uniek zijn voor alle extensies in een pakket.	Een optionele tekenreeks met een waarde tussen 1 en 255 tekens lang met een niet-witruimteteken aan het begin en einde.	Nee
uap11:Subsystem	Dit kenmerk wordt overgenomen van de syntaxis van de basisextensie en is niet van toepassing op de com4-extensie. Behalve syntactische validatie wordt deze waarde genegeerd.	Een optionele tekenreeks met een van de volgende waarden: console of windows.	Nee
uap11:SupportsMultipleInstances	Hiermee geeft u op of exemplaren in verschillende processen moeten worden uitgevoerd. De standaardwaarde is onwaar.	Een optionele Booleaanse waarde.	Nee
uap11:ResourceGroup	Een tag die u kunt gebruiken om activeringen van extensies te groeperen voor resourcebeheerdoeleinden (bijvoorbeeld CPU en geheugen). De waarde die u ResourceGroup kunt instellen, is vrij en flexibel. Zie Application@ResourceGroup.	Een optionele alfanumerieke tekenreeks met een waarde tussen 1 en 255 tekens. Moet beginnen met een brief.	Nee
uap11:CurrentDirectoryPath	Hiermee geeft u de eerste map op wanneer het toepassingsproces wordt gestart. Dit kenmerk ondersteunt macro's. Zie Macro's in het pakketmanifestschemavoor meer informatie.	Een optionele tekenreeks die deze tekens niet mag bevatten: <, >, |, ?of *. >	Nee
uap11:Parameters	Dit kenmerk wordt overgenomen van de syntaxis van de basisextensie en is niet van toepassing op de com4-extensie. Behalve syntactische validatie wordt deze waarde genegeerd. Dit kenmerk ondersteunt macro's. Zie Macro's in het pakketmanifestschemavoor meer informatie.	Een optionele tekenreeks met een waarde tussen 1 en 32767 tekens lang met een niet-witruimteteken aan het begin en einde.	Nee
desktop7:CompatMode	Hiermee geeft u op of de informatie van deze extensie op klassieke manieren is geregistreerd bij Windows (bijvoorbeeld uitgepakte apps registreren typen met COM via het register) of op nieuwe meer bereikde manieren. De standaardwaarde is 'modern'. CompatMode="classic" vereist de mogelijkheid Microsoft.classicAppCompat_8wekyb3d8bbwe.	Een optionele tekenreeks kan een van de volgende waarden hebben: klassieke of moderne.	Nee
desktop7:Bereik	Hiermee geeft u op of de registraties alleen zichtbaar zijn voor andere toepassingen die worden uitgevoerd als een gebruiker die dit pakket heeft geregistreerd (gebruiker), of dat ze zichtbaar zijn voor alle gebruikers en services op de computer (machine). De standaardwaarde is 'gebruiker'. Scope="machine" vereist de Microsoft.classicAppCompatElevated_8wekyb3d8bbwe mogelijkheid.	Een optionele tekenreeks die een van de volgende waarden kan hebben: machine of gebruiker.	Nee

Onderliggende elementen

Onderliggend element	Beschrijving
FullTrustProcess-	Vertegenwoordigt een bureaubladproces dat wordt uitgevoerd in volledig vertrouwen.
StartupTask-	Vertegenwoordigt een bureaubladproces dat wordt uitgevoerd tijdens het opstarten van de app.
ToastNotificationActivation-	Hiermee staat u toe dat pop-upmeldingen in de app worden ontvangen.
SearchProtocolHandler-	Vertegenwoordigt een bureaubladproces verwerkt het zoekprotocol voor de app.

Bovenliggende elementen

Bovenliggend element	Beschrijving
extensies	Declareert een uitbreidbaarheidspunt voor het pakket.

Opmerkingen

Eisen

Item	Waarde
Namespace	http://schemas.microsoft.com/appx/manifest/foundation/windows10
uap10-	http://schemas.microsoft.com/appx/manifest/uap/windows10/10
minimale versie van het besturingssysteem	Windows 10 versie 1607 (build 14393)