com:Class (em SurrogateServer/Class)

Define um registro de classe SurrogateServer.

Hierarquia de elementos

<Pacote>

    <Aplicativos>

         <Aplicativo>

              <Extensões>

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

Chave

? opcional (zero ou um)

Atributos e elementos

Atributos

Atributo	Descrição	Tipo de dados	Obrigatório	Valor padrão
Id	O atributo Id corresponde ao CLSID.	Um GUID no formulário xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxx.	Yes
Caminho	O caminho completo para a DLL de classe substituta.	Uma cadeia de caracteres com um valor entre 1 e 256 caracteres de comprimento que não pode conter esses caracteres: <, >, :, , ", |?ou *.	Yes
ThreadingModel	O modelo de threading para carregar DLLs.	Uma cadeia de caracteres que pode ser um dos seguintes valores: STA, MTA, MainSTA, Neutral.	Yes
DisplayName	Uma cadeia de caracteres localizável correspondente ao valor padrão da chave do CLSID.	Uma cadeia de caracteres opcional com um valor entre 1 e 256 caracteres de comprimento.	No
EnableOleDefaultHandler	Isso deverá ser definido como true se o valor padrão da chave InprocHandler32 for "Ole32.dll". Caso contrário, ele deverá ser omitido. O valor padrão é false.	Um valor booliano opcional.	No
ProgId	Associa um identificador programático (ProgID) a um CLSID.	Uma cadeia de caracteres alfanumérica opcional separada por um período com um valor entre 1 e 255 caracteres de comprimento (por exemplo, Foo.Bar ou Foo.Bar.1)	No
VersionIndependentProgId	Associa um ProgID a um CLSID. Esse valor é usado para determinar a versão mais recente de um aplicativo de objeto.	Uma cadeia de caracteres alfanumérica opcional separada por um período com um valor entre 1 e 255 caracteres de comprimento (por exemplo, Foo.Bar ou Foo.Bar.1)	No
AutoConvertTo	Especifica a conversão automática de uma determinada classe de objetos em uma nova classe de objetos.	Um GUID opcional no formulário xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxx.	No
InsertableObject	Indica que essa classe é inserida.	Um valor booliano opcional.	No
ShortDisplayName	Uma versão curta do nome de exibição da classe.	Uma cadeia de caracteres opcional com um valor entre 1 e 40 caracteres de comprimento.	No

Elementos filho

Elemento filho	Descrição
ImplementedCategories	Especifica categorias implementadas pela classe .
Conversão	Especifica as permissões de leitura/gravação de uma classe.
Dataformats	Especifica os formatos de dados padrão e main com suporte.
Miscstatus	Especifica como criar e exibir um objeto.
Verbos	Especifica os verbos a serem registrados para um aplicativo.
Defaulticon	Fornece informações de ícone padrão para apresentações icônicas de objetos.
ToolboxBitmap32	Identifica o nome do módulo e a ID do recurso para um bitmap de 16 x 16 bits a ser usado para a face de um botão de barra de ferramentas ou caixa de ferramentas.

Elementos pai

Elemento pai	Descrição
com:SurrogateServer	Registra um SurrogateServer com um ou muitos registros de classe.

Comentários

Os registros de classe com o mesmo AppId devem compartilhar um SurrogateServer, a menos que precisem ser registrados em diferentes elementos de manifesto Aplicativos/Aplicativo.

O ThreadingModel corresponde ao modelo de threading InprocServer32 . Os registros de classe SurrogateServer devem ter um registro InprocServer32 no hive privado do pacote.

Requisitos

Item	Valor
Namespace	http://schemas.microsoft.com/appx/manifest/com/windows10
Minimum OS Version	Windows 10 versão 1703 (Build 15063)