Options, ATL Active Server Page Component Wizard
The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.
The latest version of this topic can be found at Options, ATL Active Server Page Component Wizard.
Use this page of the ATL Active Server Page Component Wizard to design for increased efficiency and error support for the object.
For more information on ATL projects and ATL COM classes, see ATL COM Desktop Components.
Threading model
Indicates the method for managing threads. By default, the project uses Apartment threading.
See Specifying the Project's Threading Model for more information.
| Option | Description |
|---|---|
Single | Specifies that the object uses the single threading model. In the single threading model, an object always runs in the primary COM thread. See Single-Threaded Apartments and InprocServer32 for more information. |
| Apartment | Specifies that the object uses apartment threading. Equivalent to single thread apartment. Each object of an apartment-threaded component is assigned an apartment for its thread, for the life of the object; however, multiple threads can be used for multiple objects. Each apartment is tied to a specific thread and has a Windows message pump (default). See Single-Threaded Apartments for more information. |
| Both | Specifies that the object can use either apartment or free threading, depending from which kind of a thread it is created. |
| Free | Specifies that the object uses free threading. Free threading is equivalent to a multithread apartment model. See Multithreaded Apartments for more information. |
| Neutral (Windows 2000 only) | Specifies that the object follows the guidelines for multithreaded apartments, but it can execute on any kind of thread. |
Aggregation
Indicates whether the object uses aggregation. The aggregate object chooses which interfaces to expose to clients, and the interfaces are exposed as if the aggregate object implemented them. Clients of the aggregate object communicate only with the aggregate object.
| Option | Description |
|---|---|
| Yes | Specifies that the object can be aggregated. The default. |
| No | Specifies that the object is not aggregated. |
| Only | Specifies that the object must be aggregated. |
Support
(Element description to be added)
| Option | Description |
|---|---|
| ISupportErrorInfo | Creates support for the ISupportErrorInfo interface so the object can return error information to the client. |
| Connection points | Enables connection points for your object by making your object's class derive from IConnectionPointContainerImpl. |
| Free-threaded marshaler | Creates a free-threaded marshaler object to marshal interface pointers efficiently between threads in the same process. Available to object specifying either Both or Free as the threading model. |
ATL Active Server Page Component Wizard
ATL Active Server Page Component