com：Class (SurrogateServer/Class)

發行項
10/30/2023

定義 SurrogateServer 類別註冊。

元素階層

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

Share via