com:SurrogateServer

  • Article

Inscrit un SurrogateServer avec une ou plusieurs inscriptions de classe.

Hiérarchie d’éléments

<Paquet>

    <Applications>

         <Application>

              <Extensions>

                   <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 Valeur par défaut
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)