Condividi tramite


com3:SurrogateServer

Registra un SurrogateServer con una o più registrazioni di classe.

Gerarchia degli elementi

<Pacchetto>

    <Applicazioni>

         <Applicazione>

              <Estensioni>

                   <com2:Extension>

                        <com2:ComServer>

                             <com3:SurrogateServer>

Sintassi

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

Chiave

{} intervallo specifico di occorrenze

Attributi ed elementi

Attributi

Attributo Descrizione Tipo di dati Obbligatoria Valore predefinito
CustomSurrogateExecutable Percorso di DllSurrogate nella chiave AppId. Questo percorso è relativo alla radice del pacchetto e deve fare riferimento a un file nel pacchetto. Questo si escludono a vicenda con SystemSurrogate. Stringa facoltativa con un valore compreso tra 1 e 256 caratteri che deve terminare con .exe e non può contenere questi caratteri: <, >, :, ", |, ?o *. No
DisplayName DisplayName è una stringa localizzabile corrispondente al valore predefinito della chiave AppID. Stringa facoltativa con un valore compreso tra 1 e 256 caratteri. No
LaunchAndActivationPermission Stringa SDDL che corrisponde al valore LaunchPermission della chiave AppID. Valore stringa SDDL facoltativo. No
Appid AppId che fa riferimento alla chiave AppId associata. GUID facoltativo nel formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. No
SystemSurrogate Valore che corrisponde ai valori noti del valore DllSurrogate della chiave AppId. Questa opzione è mutuamente esclusiva con CustomSurrogateExecutable. Valore stringa facoltativo. No

Elementi figlio

Elemento figlio Descrizione
Classe Definisce una registrazione della classe SurrogateServer.

Elementi padre

Elemento padre Descrizione
com2:ComServer Dichiara un punto di estensione del pacchetto di tipo windows.comServer. L'estensione comServer può includere i tipi di registrazioni seguenti: ServiceServer, ExeServer, SurrogateServer, ProgId o TreatAsClass.

Commenti

Se non è presente alcun valore per DllSurrogate nella chiave AppId, non usare l'attributo CustomSurrogateExecutable.

LaunchAndActivationPermission è una stringa SDDL che corrisponde al valore LaunchPermission della chiave AppID.

SystemSurrogate corrisponde ai valori del valore DllSurrogate della chiave AppId. Ad esempio, se il valore DllSurrogate è %System32%\prevhost.exe o %SysWow64%\prevhost.exe, SystemSurrogate deve essere impostato su PreviewHost e CustomSurrogateExecutable non deve essere impostato.

Requisiti

Elemento Valore
Namespace http://schemas.microsoft.com/appx/manifest/com/windows10/3
Minimum OS Version Windows 10 versione 2004 (Build 19041)