com:SurrogateServer

Article
10/30/2023

Inscrit un SurrogateServer avec une ou plusieurs inscriptions de classe.

Hiérarchie d’éléments

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

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. Cette option est exclusivement exclusive avec SystemSurrogate.	Chaîne facultative avec une valeur comprise entre 1 et 256 caractères qui doit se terminer par `.exe` et ne peut pas contenir ces caractères : `<`, `>`, `:`, `"`, `\|`, `?`, ou `*`	No
DisplayName	DisplayName est une chaîne localisable correspondant à la valeur de clé AppID par défaut.	Chaîne facultative dont la valeur est 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 .	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 enfant	Description
com:ComServer	Déclare un point d’extension de package de type windows.comServer. L’extension comServer peut inclure quatre types d’inscriptions : 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 sur PreviewHost et customSurrogateExecutable ne doit pas être défini.

Configuration requise

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

Partager via