共用方式為

com：Class (SurrogateServer/Class)

  • 發行項

定義 SurrogateServer 類別註冊。

元素階層

<套件>

    <應用程式>

         <應用程式>

              <擴充功能>

                   <com:Extension>

                        <com:ComServer>

                             <com:SurrogateServer>

                                  <com:Class>

Syntax

<com:Class
    Id = 'A GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.'
    Path = 'A string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
    ThreadingModel = 'A string that can be one of the following values: "Both", "STA", "MTA", "MainSTA", "Neutral".'
    DisplayName = 'An optional string with a value between 1 and 256 characters in length. This string is localizable.'
    EnableOleDefaultHandler = 'An optional boolean value.'
    ProgId = 'An optional alphanumeric string separated by a period with a value between 1 and 255 characters in length (for example, Foo.Bar or Foo.Bar.1)'
    VersionIndependentProgId = 'An optional alphanumeric string separated by a period with a value between 1 and 255 characters in length (for example, Foo.Bar or Foo.Bar.1)'
    AutoConvertTo = 'An optional GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.'
    InsertableObject = 'An optional boolean value.'
    ShortDisplayName = 'An optional string with a value between 1 and 40 characters in length.' >

  <!-- Child elements -->
  ( ImplementedCategories,
  Conversion?,
  DataFormats?,
  MiscStatus?,
  Verbs?,
  DefaultIcon?,
  ToolboxBitmap32? 
  )

</com:Class>

答案

? 選擇性 (零或一個)

屬性和元素

屬性

屬性 描述 資料類型 必要 預設值
Id Id 屬性會對應至 CLSID。 格式為 xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxxx 的 GUID。 Yes
路徑 Surrogate 類別 DLL 的完整路徑。 長度介於 1 到 256 個字元之間的字串，不能包含下列字元： < 、、 > 、 :|" 、、 ? 或 。 * Yes
ThreadingModel 載入 DLL 的執行緒模型。 可以是下列其中一個值的字串： Both、 STA、 MTA、 MainSTA、 Neutral。 Yes
DisplayName 可當地語系化的字串，對應至 CLSID 索引鍵的預設值。 長度介於 1 到 256 個字元之間的選擇性字串。 No
EnableOleDefaultHandler 如果 InprocHandler32 機碼的預設值為 「Ole32.dll」，則應將此設定為 true。 否則，應該省略它。 預設值為 false。 選擇性布林值。 No
ProgId 將程式設計識別碼 (ProgID) 與 CLSID 產生關聯。 選擇性英數位元字串，以長度介於 1 到 255 個字元之間的句號分隔 (，例如，Foo.Bar 或 Foo.Bar.1) No
VersionIndependentProgId 建立 ProgID 與 CLSID 的關聯。 這個值是用來判斷最新版的物件應用程式。 選擇性英數位元字串，以長度介於 1 到 255 個字元之間的句號分隔 (，例如，Foo.Bar 或 Foo.Bar.1) No
AutoConvertTo 指定將指定物件類別自動轉換成新的 物件類別。 格式為 xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxx 的選擇性 GUID。 No
InsertableObject 表示這個類別是可插入的。 選擇性布林值。 No
ShortDisplayName 類別顯示名稱的簡短版本。 長度介於 1 到 40 個字元之間的選擇性字串。 No

子元素

子項目 描述
ImplementedCategories 指定 類別所實作的類別。
轉換 指定類別的讀取/寫入權限。
DataFormats 指定支援的預設和主要資料格式。
MiscStatus 指定如何建立及顯示物件。
動詞 指定要為應用程式註冊的動詞。
DefaultIcon 提供物件圖示呈現的預設圖示資訊。
ToolboxBitmap32 識別要用於工具列或工具箱按鈕之 16 x 16 點陣圖的模組名稱和資源識別碼。

父元素

父元素 描述
com:SurrogateServer 向一或多個類別註冊註冊 SurrogateServer。

備註

具有相同 AppId 的類別註冊應該共用 SurrogateServer，除非必須在不同的應用程式/應用程式資訊清單元素下註冊。

ThreadingModel會對應至InprocServer32執行緒模型。 SurrogateServer 類別註冊應該在套件的私人 Hive 中註冊 InprocServer32。

規格需求

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