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

Инициализирует поток для использования СРЕДА ВЫПОЛНЕНИЯ WINDOWS API.

Синтаксис

HRESULT Initialize(
  RO_INIT_TYPE initType
);

Параметры

initType

Указывает тип подразделения инициализируемых потоков.

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

• S_OK — впервые успешно инициализирована в текущем потоке.
• S_FALSE — успешная вложенная инициализация (текущий поток уже инициализирован для указанного типа подразделения)
• E_INVALIDARG — недопустимое значение initType
• CO_E_INIT_TLS — не удалось выделить внутреннюю структуру TLS COM
• E_OUTOFMEMORY — не удалось выделить структуры для каждого потока или подразделения, отличные от TLS
• RPC_E_CHANGED_MODE — текущий поток уже инициализирован для типа подразделения, отличного от указанного.

Комментарии

Windows::Foundation::Initialize изменяется для создания ASTA вместо классических stas для RO_INIT_TYPE значения RO_INIT_SINGLETHREADED. Windows::Foundation::Initialize(RO_INIT_SINGLETHREADED) не поддерживается для классических приложений и возвращает CO_E_NOTSUPPORTED при вызове из процесса, отличного от приложения Магазина Windows.

Для приложений Microsoft DirectX необходимо инициализировать начальный поток с помощью Windows::Foundation::Initialize(RO_INIT_MULTITHREADED).

Для внепроцессного EXE-сервера необходимо инициализировать исходный поток сервера с помощью Windows::Foundation::Initialize(RO_INIT_MULTITHREADED).

Требования

Требование	Значение
Целевая платформа	Windows
Header	roapi.h

См. также раздел

RO_INIT_TYPE