Opções, Assistente de Objeto Simples da ATL

Use esta página do Assistente de Objeto Simples da ATL na criação para aumentar a eficiência e o suporte a erros do objeto.

Para saber mais sobre projetos da ATL e classes COM da ATL, confira Componentes de Área de Trabalho COM da ATL.

• Modelo de threading

  Indica o método para gerenciar threads. Por padrão, o projeto usa o Apartment Threading.

  Confira mais informações em Como especificar o modelo de threading para um projeto.

  Opção	Descrição
  Single	Especifica que o objeto sempre será executado no thread COM primário. Confira Single-Threaded Apartments e InprocServer32 para obter mais informações.
  Apartment	Especifica que o objeto usa o Apartment Threading. Equivalente a um Apartment Threading único. Cada objeto de um componente do modelo Apartment Threading é atribuído a um apartment para seu thread, para a vida útil do objeto. No entanto, vários threads podem ser usados para vários objetos. Cada apartment é vinculado a um thread específico e tem uma bomba de mensagem do Windows (padrão). Confira Apartments Threading únicos para obter mais informações.
  Ambos	Especifica que o objeto pode usar apartment threading livre, dependendo de qual tipo de thread ele é criado.
  Gratuito	Especifica que o objeto usa threading livre. O threading livre é equivalente a um modelo de apartamento multithread. Confira Multithreaded Apartments para obter mais informações.
  Neutro	Especifica que o objeto segue as diretrizes para multithreaded apartments, mas pode ser executado em qualquer tipo de thread.

• Agregação

  Indica se o objeto usa agregação. O objeto de agregação escolhe quais interfaces expor aos clientes, e as interfaces são expostas como se o objeto de agregação as implementasse. Os clientes do objeto de agregação comunicam-se somente com o objeto de agregação.

  Opção	Descrição
  Sim	Especifica que o objeto pode ser agregado. O padrão.
  Não	Especifica que o objeto não está agregado.
  Apenas	Especifica que o objeto deve ser agregado.

• Interface

  Indica o tipo de interface com a qual o objeto é compatível. Por padrão, o objeto é compatível com uma interface dupla.

  Opção	Descrição
  Dupla	Especifica que o objeto é compatível com uma interface dupla (seu vtable tem funções de interface personalizada e métodos IDispatch de associação tardia). Permite que os clientes COM e os controladores de automação acessem o objeto. O padrão.
  Personalizado	Especifica que o objeto é compatível com uma interface personalizada (seu vtable tem funções de interface personalizada). Uma interface personalizada pode ser mais rápida do que uma interface dupla, principalmente entre limites de processo. - Compatível com automação Permite que os controladores de Automação acessem um objeto que tenha o suporte da interface personalizada.

• Suporte

  Indica o suporte adicional do objeto.

  Opção	Descrição
  ISupportErrorInfo	Cria suporte para a interface ISupportErrorInfo para que o objeto possa retornar informações do erro para o cliente.
  Pontos de conexão	Habilita pontos de conexão para o objeto fazendo com que a classe do objeto seja derivada de IConnectionPointContainerImpl.
  Marshaler de threads livres	Cria um objeto marshaler de thread livre para realizar marshaling de ponteiros de interface com eficiência entre threads no mesmo processo. Disponível para o objeto especificando Both como o modelo de threading.
  IObjectWithSite (suporte a objeto do IE)	Implementa IObjectWithSiteImpl, que fornece uma maneira simples de dar suporte à comunicação entre um objeto e seu site em um contêiner.

Confira também

Assistente de objeto simples da ATL
Objeto ATL Simples
Problemas de threading do servidor em processo