Share via

Функция 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