com3:SurrogateServer

Article
10/30/2023

Inscrit un SurrogateServer avec une ou plusieurs inscriptions de classes.

Hiérarchie d’éléments

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

Clé :

{} plage spécifique d’occurrences

Attributs et éléments

Attributs

Attribut	Description	Type de données	Obligatoire
CustomSurrogateExecutable	Chemin d’accès au DllSurrogate dans la clé AppId. Ce chemin est relatif à la racine du package et doit référencer un fichier dans le package. Cela s’exclut mutuellement avec SystemSurrogate.	Chaîne facultative avec une valeur comprise entre 1 et 256 caractères qui doit se terminer `.exe` par et ne peut pas contenir les caractères suivants : `<`, `>`, `":`, `\|`, `?`, ou `*`.	No
DisplayName	DisplayName est une chaîne localisable correspondant à la valeur de clé AppID par défaut.	Chaîne facultative avec une valeur comprise entre 1 et 256 caractères.	No
LaunchAndActivationPermission	Chaîne SDDL qui correspond à la valeur LaunchPermission de la clé AppID.	Valeur de chaîne SDDL facultative.	No
AppID	AppId qui fait référence à la clé AppId associée.	GUID facultatif sous la forme xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.	No
SystemSurrogate	Valeur qui correspond aux valeurs connues de la valeur DllSurrogate de la clé AppId. Cette option est exclusivement exclusive avec CustomSurrogateExecutable.	Valeur de chaîne facultative.	No

Éléments enfants

Élément enfant	Description
Classe	Définit une inscription de classe SurrogateServer.

Éléments parents

Élément parent	Description
com2:ComServer	Déclare un point d’extension de package de type windows.comServer. L’extension comServer peut inclure les types d’inscriptions suivants : ServiceServer, ExeServer, SurrogateServer, ProgId ou TreatAsClass.

Remarques

S’il n’existe aucune valeur pour dllSurrogate dans la clé AppId, n’utilisez pas l’attribut CustomSurrogateExecutable.

LaunchAndActivationPermission est une chaîne SDDL qui correspond à la valeur LaunchPermission de la clé AppID.

SystemSurrogate correspond aux valeurs de la valeur DllSurrogate de la clé AppId. Par exemple, si la valeur DllSurrogate est %System32%\prevhost.exe ou %SysWow64%\prevhost.exe, systemSurrogate doit être défini PreviewHost sur et le CustomSurrogateExecutable ne doit pas être défini.

Configuration requise

Élément	Valeur
Espace de noms	`http://schemas.microsoft.com/appx/manifest/com/windows10/3`
Minimum OS Version	Windows 10 version 2004 (build 19041)

Partager via