Edit

Share via

com4:Class (in SurrogateServer)

  • Article

Defines a surrogate server class registration.

Element hierarchy

<Package>

    <Applications>

         <Application>

              <Extensions>

                   <com4:SurrogateServer>

                        <com4:Class>

Syntax

<com4:Class
    Path = 'A string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *'.
    ThreadingModel = 'A string with one of the following values: "Both", "STA", "MTA", "MainSTA", or "Neutral".'
    Virtualization = 'A string with one of the following values: "enabled" or "disabled".'
    EnableOleDefaultHandler = 'A boolean value.'
    ProgId = 'An 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 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 = 'A GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.'
    InsertableObject = 'A boolean value.'
    ShortDisplayName = 'A string with a value between 1 and 40 characters in length.'
    Id = 'A GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.'
    DisplayName = 'A string with a value between 1 and 256 characters in length. This string is localizable.'>

<!-- Child elements -->
  ImplementedCategories
  Conversion
  DataFormats
  MiscStatus
  Verbs
  DefaultIcon
  ToolboxBitmap32
  TypeLib

</com4:Class>

Attributes and elements

Attributes

Attribute Description Data type Required Default value
Path The path to the surrogate server DLL. A string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or * Yes
ThreadingModel The threading model for loading DLLs. A string with one of the following values: Both, STA, MTA, MainSTA, or Neutral. Yes
Virtualization Specifies whether virtualization is used when loading the class. A string with one of the following values: enabled or disabled. Yes
EnableOleDefaultHandler This should be set to true if the default value of the InprocHandler32 key is "Ole32.dll". Otherwise it should be omitted. The default value is false. 'A boolean value. Yes
ProgId Associates a programmatic identifier (ProgID) with a CLSID. An alphanumeric string, separated by a period, with a value between 1 and 255 characters in length (for example, Foo.Bar or Foo.Bar.1). No
VersionIndependentProgId Associates a ProgID with a CLSID. This value is used to determine the latest version of an object application. An alphanumeric string, separated by a period, with a value between 1 and 255 characters in length (for example, Foo.Bar or Foo.Bar.1). No
AutoConvertTo Specifies the automatic conversion of a given class of objects to a new class of objects. A GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. No
InsertableObject Indicates that this class is insertable. 'A boolean value. No
ShortDisplayName A short version of the class display name. A string with a value between 1 and 40 characters in length. No
Id The Id attribute corresponds to the CLSID. A GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. Yes
DisplayName A localizable string corresponding to the default value of the CLSID's key. A string with a value between 1 and 256 characters in length. No

Child elements

Child element Description
ImplementedCategories Specifies categories implemented by the class.
Conversion Specifies the formats an application can read and write.
DataFormats Specifies the default and main data formats supported by an application.
MiscStatus Specifies how to create and display an object.
Verbs Specifies the verbs to be registered for an application.
DefaultIcon Provides default icon information for iconic presentations of objects.
ToolboxBitmap32 Identifies the module name and resource ID for a 16 x 16 bitmap to use for the face of a toolbar or toolbox button.
TypeLib A type library for a class or interface.

Parent elements

Parent element Description
com4:SurrogateServer Registers a SurrogateServer with one or many class registrations.

Requirements

Item Value
Namespace http://schemas.microsoft.com/appx/manifest/com/windows10/4
Minimum OS Version Windows 10 (Build 20348)