com:SurrogateServer

Articolo
10/30/2023

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

Gerarchia degli elementi

<com:Extension>

<com:ComServer>

<com:SurrogateServer>

Sintassi

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

Chiave

{} intervallo specifico di occorrenze

Attributi ed elementi

Attributi

Attributo	Descrizione	Tipo di dati	Obbligatoria
CustomSurrogateExecutable	Percorso della dllSurrogate nella chiave AppId. Questo percorso è relativo alla radice del pacchetto e deve fare riferimento a un file nel pacchetto. Questo è mututalmente esclusivo con SystemSurrogate.	Stringa facoltativa con un valore compreso tra 1 e 256 caratteri di lunghezza 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 di lunghezza.	No
LaunchAndActivationPermission	Stringa SDDL che corrisponde al valore LaunchPermission della chiave AppID.	Valore stringa SDDL .	No
Appid	AppId che fa riferimento alla chiave AppId associata.	GUID facoltativo nel formato xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxx.	No
SystemSurrogate	Valore che corrisponde a valori noti dal valore DllSurrogate della chiave AppId. Questo è mututalmente esclusivo con CustomSurrogateExecutable.	Valore stringa facoltativo.	No

Elementi figlio

Elemento figlio	Descrizione
Classe	Definisce una registrazione della classe SurrogateServer.

Elementi padre

Elemento figlio	Descrizione
com:ComServer	Dichiara un punto di estensione del pacchetto di tipo windows.comServer. L'estensione comServer può includere quattro tipi di registrazioni: ExeServer, SurrogateServer, ProgId o TreatAsClass.

Commenti

Se non esiste 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`
Minimum OS Version	Windows 10 versione 1703 (Build 15063)

Condividi tramite