ATL Typedefs
The Active Template Library includes the following typedefs.
| Typedef | Description |
|---|---|
| _ATL_BASE_MODULE | Defined as a typedef based on _ATL_BASE_MODULE70. |
| _ATL_COM_MODULE | Defined as a typedef based on _ATL_COM_MODULE70. |
| _ATL_MODULE | Defined as a typedef based on _ATL_MODULE70. |
| _ATL_WIN_MODULE | Defined as a typedef based on _ATL_WIN_MODULE70 |
| ATL_URL_PORT | The type used by CUrl for specifying a port number. |
| CComDispatchDriver | This class manages COM interface pointers. |
| CComGlobalsThreadModel | Calls the appropriate thread model methods, regardless of the threading model being used. |
| CComObjectThreadModel | Calls the appropriate thread model methods, regardless of the threading model being used. |
| CContainedWindow | This class is a specialization of CContainedWindowT. |
| CPath | A specialization of CPathT using CString. |
| CPathA | A specialization of CPathT using CStringA. |
| CPathW | A specialization of CPathT using CStringW. |
| CSimpleValArray | Represents an array for storing simple types. |
| DefaultThreadTraits | The default thread traits class. |
| LPCURL | A pointer to a constant CUrl object. |
| LPURL | A pointer to a CUrl object. |
_ATL_BASE_MODULE
Defined as a typedef based on _ATL_BASE_MODULE70.
typedef ATL::_ATL_BASE_MODULE70 _ATL_BASE_MODULE;
Remarks
Used in every ATL project. Based on _ATL_BASE_MODULE70.
Classes that are part of the ATL 7.0 Module Classes derive from the _ATL_BASE_MODULE structure. For more information on ATL Module Classes, refer to COM Modules Classes.
Requirements
Header: atlcore.h
_ATL_COM_MODULE
Defined as a typedef based on _ATL_COM_MODULE70.
typedef ATL::_ATL_COM_MODULE70 _ATL_COM_MODULE;
Remarks
Used by ATL projects which use COM features. Based on _ATL_COM_MODULE70.
Requirements
Header: atlbase.h
_ATL_MODULE
Defined as a typedef based on _ATL_MODULE70.
typedef ATL::_ATL_MODULE70 _ATL_MODULE;
Requirements
Header:
Remarks
Based on _ATL_MODULE70.
_ATL_WIN_MODULE
Defined as a typedef based on _ATL_WIN_MODULE70.
typedef ATL::_ATL_WIN_MODULE70 _ATL_WIN_MODULE;
Remarks
Used by any ATL projects which use windowing features. Based on _ATL_WIN_MODULE70.
Requirements
Header: atlbase.h
ATL_URL_PORT
The type used by CUrl for specifying a port number.
typedef WORD ATL_URL_PORT;
Requirements
Header: atlutil.h
CComDispatchDriver
This class manages COM interface pointers.
typedef CComQIPtr<IDispatch, &__uuidof(IDispatch)> CComDispatchDriver;
Requirements
Header: atlbase.h
CComGlobalsThreadModel
Calls the appropriate thread model methods, regardless of the threading model being used.
#if defined(_ATL_SINGLE_THREADED)
typedef CComSingleThreadModel CComGlobalsThreadModel;
#elif defined(_ATL_APARTMENT_THREADED)
typedef CComMultiThreadModel CComGlobalsThreadModel;
#elif defined(_ATL_FREE_THREADED)
typedef CComMultiThreadModel CComGlobalsThreadModel;
#else
#pragma message ("No global threading model defined")
#endif
Remarks
Depending on the threading model used by your application, the typedef name CComGlobalsThreadModel references either CComSingleThreadModel or CComMultiThreadModel. These classes provide additional typedef names to reference a critical section class.
Note
CComGlobalsThreadModel does not reference class CComMultiThreadModelNoCS.
Using CComGlobalsThreadModel frees you from specifying a particular threading model class. Regardless of the threading model being used, the appropriate methods will be called.
In addition to CComGlobalsThreadModel, ATL provides the typedef name CComObjectThreadModel. The class referenced by each typedef depends on the threading model used, as shown in the following table:
| typedef | Single threading | Apartment threading | Free threading |
|---|---|---|---|
CComObjectThreadModel |
S | S | M |
CComGlobalsThreadModel |
S | M | M |
S= CComSingleThreadModel; M= CComMultiThreadModel
Use CComObjectThreadModel within a single object class. Use CComGlobalsThreadModel in an object that is globally available to your program, or when you want to protect module resources across multiple threads.
Requirements
Header: atlbase.h
CComObjectThreadModel
Calls the appropriate thread model methods, regardless of the threading model being used.
#if defined(_ATL_SINGLE_THREADED)
typedef CComSingleThreadModel CComObjectThreadModel;
#elif defined(_ATL_APARTMENT_THREADED)
typedef CComSingleThreadModel CComObjectThreadModel;
#elif defined(_ATL_FREE_THREADED)
typedef CComMultiThreadModel CComObjectThreadModel;
#else
#pragma message ("No global threading model defined")
#endif
Remarks
Depending on the threading model used by your application, the typedef name CComObjectThreadModel references either CComSingleThreadModel or CComMultiThreadModel. These classes provide additional typedef names to reference a critical section class.
Note
CComObjectThreadModel does not reference class CComMultiThreadModelNoCS.
Using CComObjectThreadModel frees you from specifying a particular threading model class. Regardless of the threading model being used, the appropriate methods will be called.
In addition to CComObjectThreadModel, ATL provides the typedef name CComGlobalsThreadModel. The class referenced by each typedef depends on the threading model used, as shown in the following table:
| typedef | Single threading | Apartment threading | Free threading |
|---|---|---|---|
CComObjectThreadModel |
S | S | M |
CComGlobalsThreadModel |
S | M | M |
S= CComSingleThreadModel; M= CComMultiThreadModel
Use CComObjectThreadModel within a single object class. Use CComGlobalsThreadModel in an object that is either globally available to your program, or when you want to protect module resources across multiple threads.
Requirements
Header: atlbase.h
CContainedWindow
This class is a specialization of CContainedWindowT.
typedef CContainedWindowT<CWindow> CContainedWindow;
Requirements
Header: atlwin.h
Remarks
CContainedWindow is a specialization of CContainedWindowT. If you want to change the base class or traits, use CContainedWindowT directly.
CPath
A specialization of CPathT using CString.
typedef CPathT<CString> CPath;
Requirements
Header: atlpath.h
CPathA
A specialization of CPathT using CStringA.
typedef CPathT<CStringA> CPathA;
Requirements
Header: atlpath.h
CPathW
A specialization of CPathT using CStringW.
typedef ATL::CPathT<CStringW> CPathW;
Requirements
Header: atlpath.h
CSimpleValArray
Represents an array for storing simple types.
#define CSimpleValArray CSimpleArray
Remarks
CSimpleValArray is provided for creating and managing arrays containing simple data types. It is a simple #define of CSimpleArray.
Requirements
Header: atlsimpcoll.h
LPCURL
A pointer to a constant CUrl object.
typedef const CUrl* LPCURL;
Requirements
Header: atlutil.h
DefaultThreadTraits
The default thread traits class.
Syntax
#if defined(_MT)
typedef CRTThreadTraits DefaultThreadTraits;
#else
typedef Win32ThreadTraits DefaultThreadTraits;
#endif
Remarks
If the current project uses the multithreaded CRT, DefaultThreadTraits is defined as CRTThreadTraits. Otherwise, Win32ThreadTraits is used.
Requirements
Header: atlbase.h
LPURL
A pointer to a CUrl object.
typedef CUrl* LPURL;
Requirements
Header: atlutil.h
See also
ATL COM Desktop Components
Functions
Global Variables
Classes and structs
Macros
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for