INewWindowManager::EvaluateNewWindow method (shobjidl_core.h)

Menerima data tentang jendela baru yang mencoba ditampilkan dan menentukan apakah jendela tersebut harus diizinkan untuk dibuka berdasarkan preferensi pengguna.

Sintaks

HRESULT EvaluateNewWindow(
  [in] LPCWSTR pszUrl,
  [in] LPCWSTR pszName,
  [in] LPCWSTR pszUrlContext,
  [in] LPCWSTR pszFeatures,
  [in] BOOL    fReplace,
  [in] DWORD   dwFlags,
  [in] DWORD   dwUserActionTime
);

Parameter

[in] pszUrl

Jenis: LPCWSTR

Penunjuk ke buffer yang berisi URL konten yang akan ditampilkan di jendela baru.

[in] pszName

Jenis: LPCWSTR

Penunjuk ke buffer yang berisi nama jendela baru. Parameter ini bisa NULL.

[in] pszUrlContext

Jenis: LPCWSTR

Penunjuk ke buffer yang berisi URL yang telah mengeluarkan perintah untuk membuka jendela baru.

[in] pszFeatures

Jenis: LPCWSTR

Penunjuk ke buffer yang berisi string fitur untuk jendela baru. Nilai ini bisa NULL.

[in] fReplace

Jenis: BOOL

Nilai boolean yang digunakan ketika konten baru yang ditentukan dalam pszUrl dimuat ke jendela yang ada alih-alih membuat yang baru. TRUE jika dokumen baru harus mengganti dokumen saat ini dalam daftar riwayat; FALSE jika dokumen baru harus diberi entri baru.

[in] dwFlags

Jenis: DWORD

Bendera atau bendera dari enumerasi NWMF yang memberikan informasi situasif tentang panggilan untuk membuka jendela baru. Nilai ini bisa 0 jika tidak ada bendera yang diperlukan.

[in] dwUserActionTime

Jenis: DWORD

Jumlah centang saat tindakan pengguna terakhir terjadi. Untuk mengetahui berapa lama tindakan terjadi, panggil GetTickCount dan bandingkan hasilnya dengan nilai dalam parameter ini.

Mengembalikan nilai

Jenis: HRESULT

Mengembalikan kode kesalahan standar, termasuk yang berikut ini:

Menampilkan kode	Deskripsi
S_OK	Perbolehkan tampilan jendela.
S_FALSE	Blokir tampilan jendela.
E_FAIL	Saat Anda menerapkan INewWindowManager untuk kontrol WebBrowser yang dihosting, nilai ini menginstruksikan kontrol WebBrowser untuk menggunakan implementasi default.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP dengan SP2 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)
DLL	Shell32.dll