IQuickActivate：：QuickActivate 方法 (ocidl.h)

项目
08/25/2023

快速激活控件。

语法

HRESULT QuickActivate(
  [in]      QACONTAINER *pQaContainer,
  [in, out] QACONTROL   *pQaControl
);

parameters

[in] pQaContainer

指向包含容器相关信息的 QACONTAINER 结构的指针。

[in, out] pQaControl

指向由控件填充的 QACONTROL 结构的指针，用于将控件的相关信息返回到容器。调用此方法的容器必须为此结构保留内存。

返回值

如果方法成功，则返回值S_OK。否则，它将E_FAIL。

注解

如果控件不支持 IQuickActivate，则容器在加载控件时执行某些握手操作。容器调用控件上的某些接口，而控件又调用容器客户端站点上的某些接口。首先，容器创建控件对象并调用 QueryInterface 来查询所需的接口。然后，容器在控件上调用 IOleObject：：SetClientSite ，并将指针传递到其客户端站点。接下来，控件在此站点上调用 QueryInterface ，检索指向其他必要接口的指针。

容器使用 QuickActivate 方法传递指向 QACONTAINER 结构的指针。结构包含指向控件所需的接口的指针，以及控件可能需要的某些环境属性的值。返回后，该控件将传递指向 QACONTROL 结构的指针，该结构包含指向容器所需的接口的指针和其他状态信息。

发生快速激活后，应调用 IPersist*：：Load 和 IPersist*：：InitNew 方法。控件应在快速激活期间与容器的接收器建立连接。但是，在调用 IPersist*：：Load 或 IPersist*：：InitNew 之前，这些连接不会处于活动状态。

要求


最低受支持的客户端	Windows 2000 专业版 [桌面应用 \|UWP 应用]
最低受支持的服务器	Windows 2000 Server [桌面应用 \|UWP 应用]
目标平台	Windows
标头	ocidl.h