desktop7 :ApprovedShellExtension

Article
10/30/2023

Spécifie qu’une extension d’interpréteur de commandes doit être ajoutée à la liste des extensions d’interpréteur de commandes approuvées lors de l’installation.

Hiérarchie d’éléments

<desktop7 :ApprovedShellExtension>

Syntaxe

<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.' />

Attributs et éléments

Attributs

Attribut	Description	Type de données	Obligatoire	Valeur par défaut
Nom	Nom descriptif de l’extension Shell. Cette valeur n’est pas utilisée directement par le système, mais facilite la lecture de l’entrée dans le Registre.	Chaîne dont la valeur est comprise entre 1 et 32767 caractères avec un caractère non-espace blanc au début et à la fin.	Yes
Clsid	Clsid de la classe COM qui implémente l’extension shell.	GUID sous la forme xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.	Yes

Éléments enfants

Aucune.

Éléments parents

Élément parent	Description
Extension	Définit un point d’extensibilité pour l’application.

Remarques

Important

L’inscription d’une extension d’interpréteur de commandes approuvée nécessite que le programme d’installation dispose d’autorisations d’administration, comme indiqué dans Inscription des gestionnaires d’extensions shell.

Les applications MSIX n’ont pas de programmes d’installation personnalisés et les utilisateurs ne peuvent pas les exécuter manuellement en tant qu’administrateur. Au lieu de cela, les applications MSIX utilisant l’élément desktop7 :ApprovedShellExtension doivent définir l’attribut manifeste desktop7 :Scope sur la valeur de l’ordinateur (ce qui invite l’utilisateur à élever pendant l’installation). Vous définissez l’attribut desktop7 :Scope sur l’élément desktop :Extension .

Tout aussi important, pour définir l’attribut desktop7 :Scope sur la machine, le package de votre application doit déclarer la fonctionnalité <uap4:CustomCapability Name="Microsoft.classicAppCompatElevated_8wekyb3d8bbwe"/>personnalisée . Cette fonctionnalité personnalisée n’est accordée qu’à un ensemble limité d’applications.

Une extension d’interpréteur de commandes est utilisée conjointement avec une classe COM dans le manifeste qui est exposé via COM empaqueté (windows.comServer ; voir com :ComServer). Cette classe COM est utilisée comme gestionnaire d’extension shell (par exemple, DesktopPropertyHandler, ThumbnailHandler). Ces informations s’appliquent à toutes les extensions d’interpréteur de commandes que vous pouvez déclarer dans le manifeste du package d’application.

Comme mentionné dans Inscription des gestionnaires d’extensions Shell, l’impact de l’inclusion ou non de l’élément desktop7 :ApprovedShellExtension est que l’extension de l’interpréteur de commandes soit désactivée quand un administrateur sur l’ordinateur active la clé EnforceShellExtensionSecurity.

Configuration requise

Élément	Valeur
Espace de noms	`http://schemas.microsoft.com/appx/manifest/desktop/windows10/7`
Minimum OS Version	Windows 10 (build 19645)