desktop2:Extension (in Package/Applications)

Dichiara un punto di estendibilità per l'app.

Gerarchia degli elementi

> pacchetto<

     <applicazioni>

          > dell'applicazione<

               <extensions>

                    <desktop2:Extension>

Sintassi

<desktop2:Extension
  Category = 'A string that can have one of the following values: "windows.appPrinter", "windows.searchFilterHandler", "windows.searchPropertyHandler", or "windows.mailProvider".'
  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 be one of the following values: "appContainer" or "mediumIL".'
  uap10:RuntimeBehavior = 'An optional string that can be 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 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 -->
  desktop2:AppPrinter?
  desktop2:SearchFilterHandler?
  desktop2:SearchPropertyHandler?
  desktop2:DesktopEventLogging?
  desktop2:FirewallRules?

</desktop2:Extension>

Chiave

? facoltativo (zero o uno)

Attributi ed elementi

Attributi

Attributo	Descrizione	Tipo di dati	Obbligatorio	Valore predefinito
categoria	Categoria dell'estensione.	Stringa che può avere uno dei valori seguenti: windows.appPrinter, windows.searchFilterHandler, windows.searchPropertyHandlero windows.mailProvider.	Sì
eseguibile	Eseguibile di avvio predefinito.	Stringa facoltativa con un valore compreso tra 1 e 256 caratteri che deve terminare con .exe e non può contenere questi caratteri: <, >, :, ", |, ?o *. Specifica il file eseguibile predefinito per l'estensione. Se non specificato, viene usato il file eseguibile definito per l'app. Se specificato, viene utilizzata anche la proprietà EntryPoint. Se la proprietà EntryPoint non è specificata, viene usato entrypoint definito per l'app.	No
EntryPoint	ID classe attivabile.	Stringa facoltativa con un valore compreso tra 1 e 256 caratteri, che rappresenta l'attività che gestisce l'estensione. Si tratta in genere del nome completo dello spazio dei nomi di un tipo Windows Runtime. Se EntryPoint non viene specificato, viene invece usato EntryPoint definito per l'app.	No
runtimeType	Provider di runtime. Questo attributo viene in genere usato quando sono presenti framework misti in un'app.	Stringa facoltativa con un valore compreso tra 1 e 255 caratteri che non può iniziare o terminare con un punto o contenere questi caratteri: <, >, :, ", /, \, |, ?o *.	No
StartPage	Pagina Web che gestisce il punto di estendibilità.	Stringa facoltativa con un valore compreso tra 1 e 256 caratteri che non può contenere questi caratteri: <, >, :, ", |, ?o *.	No
uap10:TrustLevel	Specifica il livello di attendibilità dell'estensione.	Stringa facoltativa che può essere uno dei valori seguenti: appContainer o mediumIL.	No
uap10:RuntimeBehavior	Specifica il comportamento di runtime dell'estensione.	Stringa facoltativa che può essere uno dei valori seguenti: windowsApp, packagedClassicAppo win32App.	No
uap10:HostId	Specifica l'ID del runtime host per l'estensione.	Stringa alfanumerica facoltativa con un valore compreso tra 1 e 255 caratteri. Deve iniziare con una lettera.	No
uap10:Parameters	Contiene i parametri della riga di comando da passare all'estensione. Supportato solo per le app desktop con identità del pacchetto.	Stringa facoltativa con un valore compreso tra 1 e 32767 caratteri con un carattere non vuoto all'inizio e alla fine.	No
uap11:Id	Identificatore dell'estensione. L'ID deve essere univoco per tutte le estensioni in un pacchetto.	Stringa facoltativa con un valore compreso tra 1 e 255 caratteri con un carattere non vuoto all'inizio e alla fine.	No
uap11:Subsystem	Sottosistema di destinazione dell'estensione.	Stringa facoltativa che può avere uno dei valori seguenti: console o windows.	No
uap11:SupportsMultipleInstances	Specifica se le istanze devono essere eseguite in processi diversi. Il valore predefinito è false.	Valore booleano facoltativo.	No
uap11:ResourceGroup	Tag che è possibile usare per raggruppare le attivazioni dell'estensione per scopi di gestione delle risorse, ad esempio CPU e memoria. Il valore che è possibile impostare ResourceGroup è in formato libero e flessibile. Vedere Application@ResourceGroup.	Stringa alfanumerica facoltativa con un valore compreso tra 1 e 255 caratteri. Deve iniziare con una lettera.	No
uap11:CurrentDirectoryPath	Specifica la directory iniziale all'avvio del processo dell'applicazione. Questo attributo supporta le macro. Per altre informazioni, vedere macro nello schema del manifesto del pacchetto.	Stringa facoltativa che non può contenere questi caratteri: <, >, |, ?o *. >	No
uap11:Parameters	Sottosistema di destinazione dell'estensione. Questo attributo supporta le macro. Per altre informazioni, vedere macro nello schema del manifesto del pacchetto.	Stringa facoltativa con un valore compreso tra 1 e 32767 caratteri con un carattere non vuoto all'inizio e alla fine.	No
desktop7:CompatMode	Specifica se le informazioni di questa estensione vengono registrate in Windows in modi classici (ad esempio, le app non in pacchetto registrano tipi con COM tramite il Registro di sistema) o in nuovi modi più con ambito. Il valore predefinito è "modern". CompatMode="classic" richiede la funzionalità Microsoft.classicAppCompat_8wekyb3d8bbwe.	Una stringa facoltativa può avere uno dei valori seguenti: classico o moderno .	No
desktop7:Scope	Specifica se le registrazioni sono visibili solo ad altre applicazioni in esecuzione come utente che ha registrato questo pacchetto (utente) o se sono visibili a tutti gli utenti e i servizi nel computer (computer). Il valore predefinito è "user". Scope="machine" richiede la funzionalità di Microsoft.classicAppCompatElevated_8wekyb3d8bbwe.	Stringa facoltativa che può avere uno dei valori seguenti: computer o utente.	No

Elementi figlio

Elemento figlio	Descrizione
AppPrinter	Consente di installare stampanti di file software nelle app Di Windows Desktop Bridge.
SearchFilterHandler	Consente alle app di Windows Desktop Bridge di registrare IFilters per estrarre le proprietà dei file per la ricerca.
SearchPropertyHandler	Consente alle app di Windows Desktop Bridge di installare gestori di proprietà nel sistema.
DesktopEventLogging	Consente alle app di Windows Desktop Bridge di registrarsi per la registrazione degli eventi di Windows.
FirewallRules	Specifica le regole di eccezione del firewall usate dalle app Desktop Bridge di Windows.

Elementi padre

Elemento padre	Descrizione
estensioni	Definisce uno o più punti di estendibilità per l'app.

Osservazioni

windows.mailProvider è una dichiarazione di estensione vuota che rappresenta un punto di ingresso per le applicazioni di posta elettronica per correggere il .dll corretto per gestire le richieste dell'API di posta elettronica. Deve essere usato in un'applicazione con attendibilità totale.

Fabbisogno

Articolo	Valore
Namespace	http://schemas.microsoft.com/appx/manifest/desktop/windows10/2
uap10	http://schemas.microsoft.com/appx/manifest/uap/windows10/10
versione minima del sistema operativo	Windows 10 versione 1703 (Build 15063)