APTTYPEQUALIFIER enumeration (objidl.h)

Specifies the set of possible COM apartment type qualifiers.

Syntax

typedef enum _APTTYPEQUALIFIER {
  APTTYPEQUALIFIER_NONE = 0,
  APTTYPEQUALIFIER_IMPLICIT_MTA = 1,
  APTTYPEQUALIFIER_NA_ON_MTA = 2,
  APTTYPEQUALIFIER_NA_ON_STA = 3,
  APTTYPEQUALIFIER_NA_ON_IMPLICIT_MTA = 4,
  APTTYPEQUALIFIER_NA_ON_MAINSTA = 5,
  APTTYPEQUALIFIER_APPLICATION_STA = 6,
  APTTYPEQUALIFIER_RESERVED_1 = 7
} APTTYPEQUALIFIER;

Constants

APTTYPEQUALIFIER_NONE Value: 0 No qualifier information for the current COM apartment type is available.
APTTYPEQUALIFIER_IMPLICIT_MTA Value: 1 This qualifier is only valid when the pAptType parameter of the CoGetApartmentType function specifies APTTYPE_MTA on return. A thread has an implicit MTA apartment type if it does not initialize the COM apartment itself, and if another thread has already initialized the MTA in the process. This qualifier informs the API caller that the MTA of the thread is implicitly inherited from other threads and is not initialized directly.
APTTYPEQUALIFIER_NA_ON_MTA Value: 2 This qualifier is only valid when the pAptType parameter of the CoGetApartmentType function contains APTTYPE_NA on return. When an MTA thread creates or invokes a COM in-process object using the "Neutral" threading model, the COM apartment type of the thread switches from MTA to a Neutral apartment type. This qualifier informs the API caller that the thread has switched from the MTA apartment type to the NA type.
APTTYPEQUALIFIER_NA_ON_STA Value: 3 This qualifier is only valid when the pAptType parameter of the CoGetApartmentType function contains APTTYPE_NA on return. When an STA thread creates or invokes a COM in-process object using the "Neutral" threading model, the COM apartment type of the thread switches from STA to a Neutral apartment type. This qualifier informs the API caller that the thread has switched from the STA apartment type to the NA type.
APTTYPEQUALIFIER_NA_ON_IMPLICIT_MTA Value: 4 This qualifier is only valid when the pAptType parameter of the CoGetApartmentType function contains APTTYPE_NA on return. When an implicit MTA thread creates or invokes a COM in-process object using the "Neutral" threading model, the COM apartment type of the thread switches from the implicit MTA type to a Neutral apartment type. This qualifier informs the API caller that the thread has switched from the implicit MTA apartment type to the NA type.
APTTYPEQUALIFIER_NA_ON_MAINSTA Value: 5 This qualifier is only valid when the pAptType parameter of the CoGetApartmentType function contains APTTYPE_NA on return. When the main STA thread creates or invokes a COM in-process object using the "Neutral" threading model, the COM apartment type of the thread switches from the main STA type to a Neutral apartment type. This qualifier informs the API caller that the thread has switched from the main STA apartment type to the NA type.
APTTYPEQUALIFIER_APPLICATION_STA Value: 6
APTTYPEQUALIFIER_RESERVED_1 Value: 7

Requirements

Requirement	Value
Minimum supported client	Windows 7 [desktop apps | UWP apps]
Minimum supported server	Windows Server 2008 R2 [desktop apps | UWP apps]
Header	objidl.h (include Objidl.h)

See also

CoGetApartmentType