IOleInPlaceSiteEx：：RequestUIActivate 方法 (ocidl.h)

通知容器对象即将进入 UI 活动状态。

语法

HRESULT RequestUIActivate();

如果对象可以继续激活过程并调用 IOleInPlaceSite：：OnUIActivate，则此方法返回S_OK。其他可能的返回值包括以下内容。

返回代码	说明
S_FALSE	对象无法进入 UI 活动状态。对象必须调用 IOleInPlaceSite：：OnUIDeactivate ，以便容器可以执行还原焦点的必要处理。
E_FAIL	此操作失败。

对象调用此方法以确定它是否可以进入 UI 活动状态，并通知容器它即将进行此转换。容器可以返回拒绝此请求S_FALSE，例如，如果最终用户已取消操作，或者当前活动对象不会放弃其活动状态。

如果对象不调用 IOleInPlaceSiteEx：：RequestUIActivate，容器将处理数据验证，并从 IOleInPlaceSite：：OnUIActivate 触发 Enter 和 Exit 事件。

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	ocidl.h