Поделиться через

Метод 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
 При реализации INewWindowManager для размещенного элемента управления WebBrowser это значение указывает элементу управления WebBrowser использовать реализацию по умолчанию.

Требования

Требование Значение
Минимальная версия клиента Windows XP с пакетом обновления 2 (SP2) [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header shobjidl_core.h (включая Shobjidl.h)
DLL Shell32.dll