通过

SurrogateServer/Class) 中的 com：Class (

  • 项目

定义 SurrogateServer 类注册。

元素层次结构

<包>

    <应用程序>

         <应用程序>

              <扩展>

                   <com:Extension>

                        <com:ComServer>

                             <com:SurrogateServer>

                                  <com：Class>

语法

<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-xxxxxxxxxxxx 的 GUID。 是
路径 代理项类 DLL 的完整路径。 值长度介于 1 到 256 个字符之间的字符串，不能包含以下字符：<、>、:、"、|?、 或 *。 是
ThreadingModel 用于加载 DLL 的线程模型。 可以是以下值之一的字符串： 两者、 STA、 MTA、 MainSTA、 Neutral。 是
DisplayName 一个可本地化的字符串，对应于 CLSID 键的默认值。 值长度介于 1 到 256 个字符之间的可选字符串。 否
EnableOleDefaultHandler 如果 InprocHandler32 键的默认值为“Ole32.dll”，则应将其设置为 true。 否则应省略它。 默认值为 false。 可选的布尔值。 否
ProgId 将 ProgID) (编程标识符与 CLSID 相关联。 一个可选的字母数字字符串，由句点分隔，其值在长度 (介于 1 到 255 个字符之间，例如，Foo.Bar 或 Foo.Bar.1) 否
VersionIndependentProgId 将 ProgID 与 CLSID 相关联。 此值用于确定对象应用程序的最新版本。 一个可选的字母数字字符串，由句点分隔，其值在长度 (介于 1 到 255 个字符之间，例如，Foo.Bar 或 Foo.Bar.1) 否
AutoConvertTo 指定给定对象类到新对象类的自动转换。 格式为 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx 的可选 GUID。 否
InsertableObject 指示此类是可插入的。 可选的布尔值。 否
ShortDisplayName 类显示名称的简短版本。 值长度介于 1 到 40 个字符之间的可选字符串。 否

子元素

子元素 描述
ImplementedCategories 指定由 类实现的类别。
转换 指定类的读/写权限。
DataFormats 指定支持的默认和main数据格式。
MiscStatus 指定如何创建和显示对象。
动词 指定要为应用程序注册的谓词。
DefaultIcon 为对象的图标演示文稿提供默认图标信息。
ToolboxBitmap32 标识要用于工具栏或工具箱按钮表面的 16 x 16 位图的模块名称和资源 ID。

父元素

父元素 描述
com:SurrogateServer 使用一个或多个类注册注册代理服务器。

注解

同一 AppId 的类注册应共享一个 SurrogateServer，除非它们需要在不同的应用程序/应用程序清单元素下注册。

ThreadingModel 对应于 InprocServer32 线程模型。 SurrogateServer 类注册应在包的专用配置单元中具有 InprocServer32 注册。

要求

项 值
Namespace http://schemas.microsoft.com/appx/manifest/com/windows10
Minimum OS Version Windows 10版本 1703 (内部版本 15063)