desktop7:ApprovedShellExtension

Articolo
10/30/2023

Specifica che un'estensione della shell deve essere aggiunta all'elenco delle estensioni della shell approvate durante l'installazione.

Gerarchia degli elementi

<desktop7:Extension>

<desktop7:ApprovedShellExtension>

Sintassi

<desktop7:ApprovedShellExtension
  Name = 'A string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
  Clsid = 'A GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.' />

Attributi ed elementi

Attributi

Attributo	Descrizione	Tipo di dati	Obbligatoria	Valore predefinito
Nome	Nome descrittivo dell'estensione Shell. Questo valore non viene effettivamente usato direttamente dal sistema, ma semplifica la lettura della voce nel Registro di sistema.	Stringa con un valore compreso tra 1 e 32767 caratteri in lunghezza con un carattere non di spazi vuoti all'inizio e alla fine.	Sì
CLSID	Clsid della classe COM che implementa l'estensione shell.	GUID nel formato xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxx.	Sì

Elementi figlio

Nessuno.

Elementi padre

Elemento padre	Descrizione
Estensione	Definisce un punto di estendibilità per l'applicazione.

Commenti

Importante

La registrazione di un'estensione della shell approvata richiede che il programma di installazione disponga di autorizzazioni amministrative, come indicato nella registrazione dei gestori di estensioni shell.

Le app MSIX non dispongono di programmi di installazione personalizzati e non è possibile che gli utenti eseguano manualmente l'esecuzione come amministratore. Invece, le app basate su MSIX che usano l'elemento desktop7:ApprovedShellExtension devono impostare l'attributo manifesto desktop7:Scope sul valore del computer ( che richiederà all'utente di elevare durante l'installazione). Impostare l'attributo desktop7:Scope nell'elemento desktop:Extension .

Altrettanto importante, per impostare l'attributo desktop7:Scope sul computer, il pacchetto dell'app deve dichiarare la funzionalità <uap4:CustomCapability Name="Microsoft.classicAppCompatElevated_8wekyb3d8bbwe"/>personalizzata . Tale funzionalità personalizzata viene concessa solo a un set limitato di app.

Un'estensione della shell viene usata in combinazione con una classe COM nel manifesto esposto tramite Packaged COM (windows.comServervedere com:ComServer). Tale classe COM viene usata come gestore estensione shell , ad esempio DesktopPropertyHandler, ThumbnailHandler. Queste informazioni si applicano a tutte le estensioni della shell che è possibile dichiarare nel manifesto del pacchetto dell'app.

Come accennato nella registrazione dei gestori di estensioni shell, l'impatto dell'inclusione o meno dell'elemento desktop7:ApprovedShellExtension è se l'estensione della shell verrebbe disattivata quando un amministratore del computer attiva la chiave ApplicaShellExtensionSecurity.

Requisiti

Elemento	valore
Spazio dei nomi	`http://schemas.microsoft.com/appx/manifest/desktop/windows10/7`
Minimum OS Version	Windows 10 (Build 19645)