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 或更高版本)