desktop7:ApprovedShellExtension

Artikel
10/30/2023

Gibt an, dass der Liste genehmigter Shellerweiterungen bei der Installation eine Shellerweiterung hinzugefügt werden soll.

Elementhierarchie

<Paket>

<desktop7:Erweiterung>

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

Attribute und Elemente

Attribute

attribute	BESCHREIBUNG	Datentyp	Erforderlich	Standardwert
Name	Ein aussagekräftiger Name der Shell-Erweiterung. Dieser Wert wird vom System nicht direkt verwendet, erleichtert aber das Lesen des Eintrags in der Registrierung.	Eine Zeichenfolge mit einem Wert zwischen 1 und 32767 Zeichen Länge mit einem Zeichen ohne Leerzeichen am Anfang und Ende.	Yes
Clsid	Die Clsid der COM-Klasse, die die Shellerweiterung implementiert.	Eine GUID im Format xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.	Yes

Untergeordnete Elemente

Keine

Übergeordnete Elemente

Übergeordnetes Element	BESCHREIBUNG
Erweiterung	Definiert einen Erweiterbarkeitspunkt für die Anwendung.

Hinweise

Wichtig

Das Registrieren einer genehmigten Shellerweiterung erfordert, dass das Installationsprogramm über Administratorberechtigungen verfügt, wie unter Registrieren von Shellerweiterungshandlern angegeben.

MSIX-Apps verfügen nicht über benutzerdefinierte Installationsprogramme, und es gibt keine Möglichkeit für Benutzer, sie manuell als Administrator auszuführen. Stattdessen müssen MSIX-basierte Apps, die das desktop7:ApprovedShellExtension-Element verwenden, das manifest-Attribut desktop7:Scope auf den Wert des Computers festlegen (wodurch der Benutzer während der Installation aufgefordert wird, eine Erhöhung zu erhöhen). Sie legen das desktop7:Scope-Attribut für das desktop:Extension-Element fest.

Ebenso wichtig ist, dass das Paket Ihrer App die benutzerdefinierte Funktion <uap4:CustomCapability Name="Microsoft.classicAppCompatElevated_8wekyb3d8bbwe"/>deklarieren muss, um das Attribut desktop7:Scope auf Computer festzulegen. Diese benutzerdefinierte Funktion wird nur einer begrenzten Gruppe von Apps gewährt.

Eine Shellerweiterung wird in Verbindung mit einer COM-Klasse im Manifest verwendet, die über paketiertes COM verfügbar gemacht wird (windows.comServersiehe com:ComServer). Diese COM-Klasse wird als Shellerweiterungshandler (z. B . DesktopPropertyHandler, ThumbnailHandler) verwendet. Diese Informationen gelten für alle Shellerweiterungen, die Sie im App-Paketmanifest deklarieren können.

Wie unter Registrieren von Shellerweiterungshandlern erwähnt, hat das Einschließen des desktop7:ApprovedShellExtension-Elements die Auswirkung, ob die Shellerweiterung deaktiviert wird oder nicht, wenn ein Administrator auf dem Computer den Schlüssel EnforceShellExtensionSecurity aktiviert.

Anforderungen

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