SimpleActivationFactory 类

项目
10/18/2023

提供创建 Windows 运行时或经典 COM 基类的基础机制。

语法

template<typename Base>
class SimpleActivationFactory : public ActivationFactory<>;

参数

Base
基类。

备注

基类必须提供默认构造函数。

下面的代码示例演示了如何将 SimpleActivationFactory 与 ActivatableClassWithFactoryEx 宏一起使用。

ActivatableClassWithFactoryEx(MyClass, SimpleActivationFactory, MyServerName);

成员

公共方法

名称	描述
SimpleActivationFactory::ActivateInstance 方法	创建指定接口的实例。
SimpleActivationFactory::GetRuntimeClassName 方法	获取由 Base 类模板参数指定的类的实例的运行时类名称。
SimpleActivationFactory::GetTrustLevel 方法	获取由 Base 类模板参数指定的类的实例的信任级别。

继承层次结构

I0

ChainInterfaces

I0

RuntimeClassBase

ImplementsHelper

DontUseNewUseMake

RuntimeClassFlags

RuntimeClassBaseT

RuntimeClass

ActivationFactory

SimpleActivationFactory

要求

标头：module.h

命名空间： Microsoft::WRL

SimpleActivationFactory::ActivateInstance 方法

创建指定接口的实例。

STDMETHOD( ActivateInstance )(
    _Deref_out_ IInspectable **ppvObject
);

参数

ppvObject
此操作完成时，指向 Base 类模板参数所指定对象的实例的指针。

返回值

如果成功，则为 S_OK；否则为指示错误的 HRESULT。

备注

如果定义了 __WRL_STRICT__，而类模板参数中指定的基类不是派生自 RuntimeClass，或者不是使用 WinRt 或 WinRtClassicComMix RuntimeClassType 枚举值配置的，则会发出断言错误。

SimpleActivationFactory::GetRuntimeClassName 方法

获取由 Base 类模板参数指定的类的实例的运行时类名称。

STDMETHOD( GetRuntimeClassName )(
    _Out_ HSTRING* runtimeName
);

参数

runtimeName
此操作完成后，运行时类名称。

返回值

如果成功，则为 S_OK；否则为指示错误的 HRESULT。

备注

如果定义了 __WRL_STRICT__，而 Base 类模板参数中指定的类不是派生自 RuntimeClass，或者不是使用 ClassicCom 或 WinRtClassicComMix RuntimeClassType 枚举值配置的，则会发出断言错误。

SimpleActivationFactory::GetTrustLevel 方法

获取由 Base 类模板参数指定的类的实例的信任级别。

STDMETHOD(
   GetTrustLevel
)(_Out_ TrustLevel* trustLvl);

参数

trustLvl
此操作完成后，当前类对象的信任级别。

返回值

始终为 S_OK。

通过