com:SurrogateServer
向一或多個類別註冊註冊 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) |