共用方式為


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