Compartilhar via


desktop7:ApprovedShellExtension

Especifica que uma extensão de shell deve ser adicionada à lista de extensões de shell aprovadas quando instalada.

Hierarquia de elementos

<Pacote>

    <Aplicativos>

         <Aplicativo>

              <Extensões>

                   <desktop7:Extension>

                        <desktop7:ApprovedShellExtension>

Syntax

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

Atributos e elementos

Atributos

Atributo Descrição Tipo de dados Obrigatório Valor padrão
Nome Um nome descritivo da extensão do Shell. Esse valor não é realmente usado diretamente pelo sistema, mas facilita a leitura da entrada no registro. Uma cadeia de caracteres com um valor entre 1 e 32767 caracteres de comprimento com um caractere não whitespace no início e no final. Yes
Clsid O Clsid da classe COM que implementa a Extensão do Shell. Um GUID no formulário xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxx. Yes

Elementos filho

Nenhum.

Elementos pai

Elemento pai Descrição
Extensão Define um ponto de extensibilidade para o aplicativo.

Comentários

Importante

Registrar uma extensão de shell aprovada requer que o instalador tenha permissões administrativas, conforme observado em Registrando manipuladores de extensão do shell.

Os aplicativos MSIX não têm instaladores personalizados e não há como os usuários executá-los manualmente como administrador. Em vez disso, os aplicativos baseados em MSIX que usam o elemento desktop7:ApprovedShellExtension devem definir o atributo de manifesto desktop7:Scope como o valor do computador (o que solicitará que o usuário se eleve durante a instalação). Você define o atributo desktop7:Scope no elemento desktop:Extension .

Igualmente importante, para definir o atributo desktop7:Scope como computador, o pacote do aplicativo precisa declarar a funcionalidade <uap4:CustomCapability Name="Microsoft.classicAppCompatElevated_8wekyb3d8bbwe"/>personalizada . Essa funcionalidade personalizada é concedida apenas a um conjunto limitado de aplicativos.

Uma extensão de shell é usada em conjunto com uma classe COM no manifesto que é exposta por meio de COM empacotado (windows.comServer; consulte com:ComServer). Essa classe COM é usada como um Manipulador de Extensão do Shell (por exemplo, DesktopPropertyHandler, ThumbnailHandler). Essas informações se aplicam a todas as extensões de shell que você pode declarar no manifesto do pacote do aplicativo.

Conforme mencionado em Registrar manipuladores de extensão do Shell, o impacto de incluir ou não o elemento desktop7:ApprovedShellExtension é se a extensão do shell seria desativada ou não quando um administrador no computador ativar a chave EnforceShellExtensionSecurity.

Requisitos

Item Valor
Namespace http://schemas.microsoft.com/appx/manifest/desktop/windows10/7
Minimum OS Version Windows 10 (Build 19645)