共用方式為

com3:SurrogateServer

  • 發行項

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

元素階層

<套件>

    <應用程式>

         <應用程式>

              <擴充功能>

                   <com2:Extension>

                        <com2:ComServer>

                             <com3:SurrogateServer>

Syntax

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

答案

{} 特定出現次數範圍

屬性和元素

屬性

屬性 描述 資料類型 必要 預設值
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 類別註冊。

父元素

父元素 描述
com2:ComServer 宣告 windows.comServer類型的套件延伸點。 comServer延伸模組可能包含下列類型的註冊：ServiceServer、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/3
OS 最低版本 Windows 10版本 2004 (組建 19041)