com:SurrogateServer

發行項
10/30/2023

向一或多個類別註冊註冊 SurrogateServer。

元素階層

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

答案

{} 特定出現次數範圍

屬性和元素

屬性

屬性	描述	資料類型	必要
CustomSurrogateExecutable	AppId 機碼中 DllSurrogate 的路徑。此路徑相對於封裝根目錄，而且必須參考封裝中的檔案。這是與 SystemSurrogate 互斥的。	長度介於 1 到 256 個字元之間的選擇性字串，長度必須以 `.exe` 結尾且不能包含下列字元： `<` 、、 `>` 、 `:` 、 `"\|?` 、或 `*`	No
DisplayName	DisplayName 是對應至預設 AppID 索引鍵值的可當地語系化字串。	長度介於 1 到 256 個字元之間的選擇性字串。	No
LaunchAndActivationPermission	對應至 AppID 索引鍵之 LaunchPermission 值的 SDDL 字串。	SDDL 字串值。	No
AppId	參考相關聯 AppId 索引鍵的 AppId。	xxxxxxxx-xxxx-xxxx-xxxxxxxxxxxx 格式的選擇性 GUID。	No
SystemSurrogate	值，對應至 AppId 索引鍵之 DllSurrogate 值的已知值。這與 CustomSurrogateExecutable 互斥。	選擇性字串值。	No

子元素

子元素	Description
類別	定義 SurrogateServer 類別註冊。

父項目

子元素	描述
com:ComServer	宣告 windows.comServer類型的套件延伸點。 comServer延伸模組可能包含四種類型的註冊：ExeServer、SurrogateServer、ProgId或TreatAsClass。

備註

如果 AppId 機碼中沒有 DllSurrogate 的值，請勿使用 CustomSurrogateExecutable 屬性。

LaunchAndActivationPermission 是 SDDL 字串，對應至 AppID 機碼的 LaunchPermission 值。

SystemSurrogate會對應至 AppId 索引鍵之 DllSurrogate 值的值。例如，如果 DllSurrogate 值為 %System32%\prevhost.exe 或 %SysWow64%\prevhost.exe ， 則應該將 SystemSurrogate 設定為 PreviewHost ，而且不應設定 CustomSurrogateExecutable 。

規格需求

Item	值
Namespace	`http://schemas.microsoft.com/appx/manifest/com/windows10`
OS 最低版本	Windows 10版本 1703 (組建 15063)