winrt.runtime module¶

Activation¶

Functions related to preparing the WinRT runtime for use.

init_apartment¶

init_apartment(apartment_type: ApartmentType, /) -> None

Initializes the WinRT runtime in the specified apartment type.

Calling this function is only necessary if you need a single threaded, e.g. for UI thread, or if you need to re-initialize the thread with a different apartment type.

Raises: ValueError if apartment_type is not an ApartmentType, and OSError if the thread is already in an apartment of the other type.

uninit_apartment¶

uninit_apartment() -> None

Uninitializes the WinRT runtime.

Not necessary on thread exit, but can be used to uninitialize and re-initialize a thread if needed.

ApartmentType¶

class ApartmentType

Enumeration of COM apartment types.

SINGLE_THREADED¶

Single-threaded apartment.

MULTI_THREADED¶

Multi-threaded apartment.