desktop7:ApprovedShellExtension

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

Hierarquia de elementos

<Package>
   └─ <Extensions>
      └─ <desktop7:Extension>
         └─ <desktop7:ApprovedShellExtension>
   └─ <Applications>
      └─ <Application>
         └─ <Extensions>
            └─ <desktop7:Extension>
               └─ <desktop7:ApprovedShellExtension>

Sintaxe

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

Attributes

Attribute Descrição Tipo de dados Obrigatório Valor predefinido
Nome Um nome descritivo da extensão Shell. Este valor não é realmente usado diretamente pelo sistema, mas facilita a leitura da entrada no registo. Uma cadeia de caracteres entre 1 e 32767 caracteres de comprimento com um caractere sem espaço em branco no início e no fim. Sim
Clsid O Clsid da classe COM que implementa a Extensão Shell. Um GUID na forma xxxxxxxx-xxxx-xxxx-xxxx-xxxxxx-xxxxxxxxxxxx. Sim

Elementos filhos

Nenhum.

Elementos principais

Elemento pai Descrição
desktop7:Extension Declara um ponto de extensibilidade para o aplicativo.

Requerimentos

Número valor
Namespace http://schemas.microsoft.com/appx/manifest/desktop/windows10/7
Versão mínima do SO Windows 10 (Build 19645)

Observações

Importante

Registar uma extensão de shell aprovada requer que o instalador tenha permissões administrativas, conforme indicado em Registo de Gestores de Extensão de Shell.

As aplicações MSIX não têm instaladores personalizados, e não há forma de os utilizadores as executarem manualmente como Administrador. Em vez disso, as aplicações baseadas em MSIX que usam o desktop7:ApprovedShellExtension elemento devem definir o atributo manifesto desktop7:Scope para o valor da máquina (o que irá pedir ao utilizador para elevar durante a instalação). Defines o atributo desktop7:Scope no elemento desktop:Extension .

Igualmente importante, para definir o atributo desktop7:Scope para máquina, o pacote da sua aplicação precisa de declarar a capacidade <uap4:CustomCapability Name="Microsoft.classicAppCompatElevated_8wekyb3d8bbwe"/>personalizada. Essa capacidade personalizada é concedida apenas a um conjunto limitado de aplicações.

Uma extensão de shell é usada em conjunto com uma classe COM no manifesto que é exposta através do Packaged COM (windows.comServer; ver com:ComServer). Essa classe COM é usada como Gestor de Extensão de Shell (por exemplo, DesktopPropertyHandler, ThumbnailHandler). Essa informação aplica-se a todas as extensões de shell que podes declarar no manifesto do pacote da aplicação.

Como mencionado em Registering Shell Extension Handlers, o impacto de incluir ou não incluir o desktop7:ApprovedShellExtension elemento é saber se a extensão shell será desligada quando um administrador na máquina ativa a chave EnforceShellExtensionSecurity.

Exemplos

  • Last updated on