IOleControlSite::GetExtendedControl 方法 (ocidl.h)

检索指向容器用于包装实际控件的扩展控件的 IDispatch 指针。

语法

HRESULT GetExtendedControl(
  [out] IDispatch **ppDisp
);

参数

[out] ppDisp

指向 IDispatch 指针变量的指针,该变量接收指向扩展控件的接口指针。 如果发生错误,实现必须将 *ppDisp 设置为 NULL。 成功后,当不再需要 *ppDisp 时,调用方负责调用 Release

返回值

此方法可以返回E_OUTOFMEMORY和E_UNEXPECTED的标准返回值,以及以下值。

返回代码 说明
S_OK
该方法已成功完成。
E_NOTIMPL
容器不实现扩展控件。
E_POINTER
ppDisp 或 *ppDisp 中的地址无效。 例如,它可能为 NULL

注解

此方法为容器在扩展控件中维护的任何属性和方法提供实际控制访问权限。 否则,控件无法访问这些属性和方法。

调用方备注

返回的指针由调用方负责,调用方必须在不再需要时释放它。

要求

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

另请参阅

IOleControlSite