com3:SurrogateServer

  • Article

Inscrit un SurrogateServer avec une ou plusieurs inscriptions de classes.

Hiérarchie d’éléments

<Paquet>

    <Applications>

         <Application>

              <Extensions>

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