INewWindowManager::EvaluateNewWindow 方法 (shobjidl_core.h)
接受尝试显示的新窗口的相关数据,并根据用户的首选项确定是否允许该窗口打开。
语法
HRESULT EvaluateNewWindow(
[in] LPCWSTR pszUrl,
[in] LPCWSTR pszName,
[in] LPCWSTR pszUrlContext,
[in] LPCWSTR pszFeatures,
[in] BOOL fReplace,
[in] DWORD dwFlags,
[in] DWORD dwUserActionTime
);
参数
[in] pszUrl
类型: LPCWSTR
指向缓冲区的指针,该缓冲区包含将在新窗口中显示的内容的 URL。
[in] pszName
类型: LPCWSTR
指向包含新窗口名称的缓冲区的指针。 此参数可以为 NULL。
[in] pszUrlContext
类型: LPCWSTR
指向缓冲区的指针,该缓冲区包含已发出用于打开新窗口的命令的 URL。
[in] pszFeatures
类型: LPCWSTR
指向包含新窗口的功能字符串的缓冲区的指针。 此值可以为 NULL。
[in] fReplace
类型: BOOL
将 pszUrl 中指定的新内容加载到现有窗口中而不是创建新窗口时使用的布尔值。 如果新文档应替换历史记录列表中的当前文档,则为 TRUE;如果应为新文档指定一个新条目,则为 FALSE。
[in] dwFlags
类型:DWORD
NWMF 枚举中的一个或多个标志,提供有关调用以打开新窗口的情况信息。 如果不需要标志,则此值可以为 0。
[in] dwUserActionTime
类型:DWORD
上次用户操作发生时的刻度计数。 若要了解操作发生的时间,请调用 GetTickCount 并将结果与此参数中的值进行比较。
返回值
类型: HRESULT
返回标准错误代码,包括以下内容:
返回代码 | 说明 |
---|---|
|
允许显示窗口。 |
|
阻止窗口显示。 |
|
为托管的 WebBrowser 控件实现 INewWindowManager 时,此值指示 WebBrowser 控件使用默认实现。 |
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP SP2 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | shobjidl_core.h (包括 Shobjidl.h) |
DLL | Shell32.dll |