threading (C++)

Specifies the threading model for a COM object.

[ threading(
   model=enumeration
) ]

Parameters

  • model(optional)
    One of the following threading models:

    • apartment (apartment threading)

    • neutral (.NET Framework components with no user interface)

    • single (simple threading)

    • free (free threading)

    • both (apartment and free threading)

    The default value is apartment.

Remarks

The threading C++ attribute does not appear in the generated .idl file but will be used in the implementation of your COM object.

In ATL projects, If the coclass attribute is also present, the threading model specified by model is passed as the template parameter to the CComObjectRootEx class, inserted by the coclass attribute.

The threading attribute also guards access to an event_source.

Example

See the licensed example for a sample use of threading.

Requirements

Attribute Context

Applies to

class, struct

Repeatable

No

Required attributes

coclass

Invalid attributes

None

For more information about the attribute contexts, see Attribute Contexts.

See Also

Reference

Neutral Apartments

Concepts

Multithreading

Visual C++ Samples

Other Resources

COM Attributes

Typedef, Enum, Union, and Struct Attributes

Class Attributes