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

Статья
08/25/2023

Активирует указанный класс среда выполнения Windows.

Синтаксис

HRESULT RoActivateInstance(
  [in]  HSTRING      activatableClassId,
  [out] IInspectable **instance
);

Параметры

[in] activatableClassId

Тип: HSTRING

Идентификатор класса, связанный с активируемым классом среды выполнения.

[out] instance

Тип: IInspectable**

Указатель на активированный экземпляр класса среды выполнения.

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

Тип: HRESULT

Эта функция может возвращать одно из этих значений.

Код возврата	Описание
S_OK	Класс был успешно активирован.
E_POINTER	instance имеет значение NULL.
CO_E_NOTINITIALIZED	Поток не инициализирован в среда выполнения Windows путем вызова функции RoInitialize.
E_ACCESSDENIED	Для TrustLevel для класса требуется процесс с полным доверием.
E_NOINTERFACE	Интерфейс IInspectable не реализуется указанным классом.
E_OUTOFMEMORY	Не удалось создать экземпляр класса .

Используйте функцию RoActivateInstance для активации класса среда выполнения Windows. Функция RoActivateInstance подключается к фабрике активации, связанной с указанным идентификатором активируемого класса, создает экземпляр, вызывая конструктор с нулевым аргументом в классе, и освобождает фабрику активации.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8 [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2012 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	roapi.h

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

Share via