IUnknown_GetWindow 函数 (shlwapi.h)
尝试通过查询具有 GetWindow 方法的各种接口,从组件对象模型 (COM) 对象检索窗口句柄。
语法
LWSTDAPI IUnknown_GetWindow(
[in] IUnknown *punk,
[out] HWND *phwnd
);
参数
[in] punk
类型: IUnknown*
指向 COM 对象的指针,此函数将尝试从中获取窗口句柄。
[out] phwnd
类型: HWND*
指向 HWND 的指针,此函数成功返回时接收窗口句柄。 如果未获取窗口句柄,此参数将设置为 NULL。
返回值
类型: HRESULT
如果成功返回窗口句柄,则返回S_OK,否则返回 COM 错误代码。 如果未找到合适的接口,该函数将返回E_NOINTERFACE。 否则,该函数返回由相应接口的 GetWindow 方法返回的 HRESULT。
注解
此函数尝试通过调用 IOleWindow::GetWindow、 IInternetSecurityMgrSite::GetWindow 和 IShellView::GetWindow 来检索窗口句柄。 将来版本的 IUnknown_GetWindow 可能会尝试其他接口。
注意IShellView 查询在理论上是不必要的,因为 IShellView 派生自 IOleWindow。 函数显式查询此接口,因为某些对象未正确实现 QueryInterface ,并且无法响应基接口的查询。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 专业版、Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server、Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | shlwapi.h |
DLL | Shlwapi.dll (5.0 或更高版本) |