Поделиться через


Функция RoInitialize (roapi.h)

Инициализирует среду выполнения Windows в текущем потоке с указанной моделью параллелизма.

Синтаксис

HRESULT RoInitialize(
  [in] RO_INIT_TYPE initType
);

Параметры

[in] initType

Тип: RO_INIT_TYPE

Модель параллелизма для потока. Значение по умолчанию — RO_INIT_MULTITHREADED.

Возвращаемое значение

Тип: HRESULT

Эта функция может возвращать стандартные возвращаемые значения E_INVALIDARG, E_OUTOFMEMORY и E_UNEXPECTED, а также следующие значения.

Код возврата Description
S_OK
Среда выполнения Windows успешно инициализирована в этом потоке.
S_FALSE
Среда выполнения Windows уже инициализирована в этом потоке.
RPC_E_CHANGED_MODE
Предыдущий вызов RoInitialize указал модель параллелизма для этого потока в качестве многопоточной квартиры (MTA). Это также может указывать на то, что произошло изменение с нейтральной потоковой квартиры на однопотоковую квартиру.

Замечания

Используйте функцию RoInitialize для инициализации потока в среде выполнения Windows. Перед вызовом среды выполнения Windows необходимо инициализировать все потоки, которые активируют и взаимодействуют с объектами среды выполнения Windows.

Вызовите функцию RoUninitialize , чтобы закрыть среду выполнения Windows в текущем потоке. Каждый успешный вызов RoInitialize, включая те, которые возвращают S_FALSE, должен быть сбалансирован соответствующим вызовом RoUninitialize.

Требования

Требование Ценность
Минимальный поддерживаемый клиент Windows 8 [классические приложения | Приложения UWP]
минимальный поддерживаемый сервер Windows Server 2012 [классические приложения | Приложения UWP]
целевая платформа Виндоус
Header roapi.h
Library mincore.lib

См. также

CoInitializeEx

RO_INIT_TYPE

RoUninitialize