Partilhar via


Options, ATL Simple Object Wizard

Observação

A Active Template Library (ATL) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

Use esta página do ATL Simple Object Wizard para projetar para aumentar a eficiência e o suporte a erros do objeto.

Para mais informações sobre projetos ATL e aulas ATL COM, consulte ATL COM Desktop Components.

  • Modelo de rosqueamento

    Indica o método para gerir threads. Por defeito, o projeto utiliza threading de Apartamento .

    Consulte Especificar o Modelo de Threading do Projeto para mais informações.

    Opção Description
    Solteiro Especifica que o objeto é sempre executado no thread principal COM. Consulte Single-Threaded Apartamentos e InprocServer32 para mais informações.
    Apartamento Especifica que o objeto usa threading de apartamento. Equivalente a um apartamento de fio único. Cada objeto de um componente com thread apartamento é atribuído a um apartamento para o seu thread, durante a vida útil do objeto; no entanto, múltiplos threads podem ser usados para múltiplos objetos. Cada apartamento está ligado a um tópico específico e tem uma bomba de mensagens do Windows (por defeito).

    Consulte Single-Threaded Apartamentos para mais informações.
    Ambos Especifica que o objeto pode usar threading apartamento ou livre, dependendo do tipo de thread que for criado.
    Gratuito Especifica que o objeto utiliza threading livre. A threading livre é equivalente a um modelo de apartamento multithread. Consulte Apartamentos Multithreaded para mais informações.
    Neutro Especifica que o objeto segue as diretrizes para apartamentos multithread, mas pode ser executado em qualquer tipo de thread.
  • Agregação

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

    Opção Description
    Sim Especifica que o objeto pode ser agregado. O padrão.
    No Especifica que o objeto não é agregado.
    Especifica que o objeto deve ser agregado.
  • Interface

    Indica o tipo de interface que o objeto suporta. Por defeito, o objeto suporta uma interface dupla.

    Opção Description
    Dual Especifica que o objeto suporta uma interface dupla (o seu vtable tem funções de interface personalizadas além de métodos de ligação IDispatch tardia). Permite que tanto os clientes COM como os controladores de automação acedam ao objeto. O padrão.
    Personalizado Especifica que o objeto suporta uma interface personalizada (o seu vtable tem funções de interface personalizadas). Uma interface personalizada pode ser mais rápida do que uma interface dupla, especialmente entre fronteiras de processo.

    - Compatível com automação Permite que os controladores de Automação acedam a um objeto que tenha suporte para interface personalizada.
  • Suporte

    Indica suporte adicional para o objeto.

    Opção Description
    ISupportErrorInfo Cria suporte para a interface ISupportErrorInfo para que o objeto possa devolver informações de erro ao cliente.
    Pontos de ligação Permite pontos de ligação para o seu objeto ao fazer com que a classe do seu objeto derive de IConnectionPointContainerImpl.
    Marshaler de rosca livre Cria um objeto marshaler free-threaded para marshalar ponteiros de interface de forma eficiente entre threads no mesmo processo. Disponível para objetos, especificando ambos como modelo de threading.
    IObjectWithSite (ou seja, suporte a objetos) Implementa o IObjectWithSiteImpl, que fornece uma forma simples de suportar a comunicação entre um objeto e o seu site num contentor.

Consulte também

Assistente de Objetos Simples ATL
ATL Simple Object
Problemas de threading do Servidor In-Process