com3:SurrogateServer

Artikel
10/30/2023

Registriert einen SurrogateServer mit einer oder mehreren Klassenregistrierungen.

Elementhierarchie

<Paket>

<com2:Extension>

<com2:ComServer>

<com3:SurrogateServer>

Syntax

<com3: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 = 'An optional [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}

</com3: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 schließt sich mit SystemSurrogate gegenseitig aus.	Eine optionale Zeichenfolge mit einem Wert zwischen 1 und 256 Zeichen Länge, der 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 optionaler 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

Übergeordnetes Element	BESCHREIBUNG
com2:ComServer	Deklariert einen Paketerweiterungspunkt vom Typ windows.comServer. Die comServer-Erweiterung kann die folgenden Registrierungstypen enthalten: ServiceServer, 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/3`
Minimum OS Version	Windows 10 Version 2004 (Build 19041)

Freigeben über