com3:SurrogateServer

Articolo
10/30/2023

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

Gerarchia degli elementi

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

Condividi tramite