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 控件使用預設實作。

規格需求

需求 值
最低支援的用戶端 具有 SP2 的 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 shobjidl_core.h (包括 Shobjidl.h)
Dll Shell32.dll