Freigeben über


com3:SurrogateServer

Registriert einen SurrogateServer mit einer oder mehreren Klassenregistrierungen.

Elementhierarchie

<Paket>

    <Anwendungen>

         <Anwendung>

              <Erweiterungen>

                   <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 Standardwert
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)