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

返回标准错误代码,包括以下内容:

返回代码 说明
S_OK
允许显示窗口。
S_FALSE
阻止窗口显示。
E_FAIL
为托管的 WebBrowser 控件实现 INewWindowManager 时,此值指示 WebBrowser 控件使用默认实现。

要求

要求
最低受支持的客户端 Windows XP SP2 [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h (包括 Shobjidl.h)
DLL Shell32.dll