com:SurrogateServer

Artikel
10/30/2023

Registriert einen SurrogateServer mit einer oder mehreren Klassenregistrierungen.

Elementhierarchie

<Paket>

<com:Extension>

<com:ComServer>

<com:SurrogateServer>

Syntax

<com:SurrogateServer  
    CustomSurrogateExecutable = 'An optional string with a value between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or *.'
    DisplayName = 'An optional string with a value between 1 and 256 characters in length. This string is localizable.'
    LaunchAndActivationPermission = 'A [SDDL string](/windows/win32/secauthz/security-descriptor-string-format) value.'
    AppId = 'An optional GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.' 
    SystemSurrogate = 'An optional string value.' >

  <!-- Child elements -->
  Class{1,10000}

</com:SurrogateServer>

Schlüssel

{} spezifischer Vorkommensbereich

Attribute und Elemente

Attribute

attribute	BESCHREIBUNG	Datentyp	Erforderlich
CustomSurrogateExecutable	Ein Pfad zum DllSurrogate im AppId-Schlüssel. Dieser Pfad ist relativ zum Paketstamm und muss auf eine Datei im Paket verweisen. Dies ist mit SystemSurrogate exklusiv.	Eine optionale Zeichenfolge mit einem Wert zwischen 1 und 256 Zeichen Länge, die mit und enden `.exe` muss und nicht die folgenden Zeichen enthalten darf: `<`, , `:>`, , `"`, , `\|`, `?`oder`*`	No
DisplayName	DisplayName ist eine lokalisierbare Zeichenfolge, die dem AppID-Standardschlüsselwert entspricht.	Eine optionale Zeichenfolge mit einem Wert zwischen 1 und 256 Zeichen Länge.	No
LaunchAndActivationPermission	Eine SDDL-Zeichenfolge , die dem LaunchPermission-Wert des AppID-Schlüssels entspricht.	Ein SDDL-Zeichenfolgenwert .	No
AppId	Die AppId, die auf den zugeordneten AppId-Schlüssel verweist.	Eine optionale GUID im Format xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.	No
SystemSurrogate	Ein Wert, der bekannten Werten aus dem DllSurrogate-Wert des AppId-Schlüssels entspricht. Dies ist mit CustomSurrogateExecutable mututal exklusiv.	Ein optionaler Zeichenfolgenwert.	No

Untergeordnete Elemente

Untergeordnetes Element	BESCHREIBUNG
Klasse	Definiert eine SurrogateServer-Klassenregistrierung.

Übergeordnete Elemente

Untergeordnetes Element	BESCHREIBUNG
com:ComServer	Deklariert einen Paketerweiterungspunkt vom Typ windows.comServer. Die comServer-Erweiterung kann vier Registrierungstypen enthalten: ExeServer, SurrogateServer, ProgId oder TreatAsClass.

Hinweise

Wenn im AppId-Schlüssel kein Wert für dllSurrogate vorhanden ist, verwenden Sie nicht das CustomSurrogateExecutable-Attribut.

LaunchAndActivationPermission ist eine SDDL-Zeichenfolge , die dem LaunchPermission-Wert des AppID-Schlüssels entspricht.

SystemSurrogate entspricht den Werten des DllSurrogate-Werts des AppId-Schlüssels. Wenn der DllSurrogate-Wert beispielsweise oder %SysWow64%\prevhost.exeist%System32%\prevhost.exe, sollte SystemSurrogate auf PreviewHost festgelegt werden, und CustomSurrogateExecutable sollte nicht festgelegt werden.

Anforderungen

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

Freigeben über