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


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

Активирует указанный класс среда выполнения 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

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

CoCreateInstance

IActivationFactory

IInspectable

TrustLevel