Método INewWindowManager::EvaluateNewWindow (shobjidl_core.h)

Acepta datos sobre una nueva ventana que intenta mostrar y determina si esa ventana debe poder abrirse en función de las preferencias del usuario.

Sintaxis

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

Parámetros

[in] pszUrl

Tipo: LPCWSTR

Puntero a un búfer que contiene la dirección URL del contenido que se mostrará en la nueva ventana.

[in] pszName

Tipo: LPCWSTR

Puntero a un búfer que contiene el nombre de la nueva ventana. Este parámetro puede ser NULL.

[in] pszUrlContext

Tipo: LPCWSTR

Puntero a un búfer que contiene la dirección URL que ha emitido el comando para abrir la nueva ventana.

[in] pszFeatures

Tipo: LPCWSTR

Puntero a un búfer que contiene la cadena de características de la nueva ventana. Este valor puede ser NULL.

[in] fReplace

Tipo: BOOL

Valor booleano que se usa cuando el nuevo contenido especificado en pszUrl se carga en la ventana existente en lugar de crear uno nuevo. TRUE si el nuevo documento debe reemplazar el documento actual en la lista de historial; FALSE si se debe proporcionar una nueva entrada al nuevo documento.

[in] dwFlags

Tipo: DWORD

Marca o marcas de la enumeración NWMF que proporcionan información situacional sobre la llamada para abrir la nueva ventana. Este valor puede ser 0 si no se necesita ninguna marca.

[in] dwUserActionTime

Tipo: DWORD

Recuento de tics cuando se produjo la última acción del usuario. Para averiguar cuánto tiempo se produjo la acción, llame a GetTickCount y compare el resultado con el valor de este parámetro.

Valor devuelto

Tipo: HRESULT

Devuelve códigos de error estándar, incluidos los siguientes:

Código devuelto	Descripción
S_OK	Permitir la presentación de la ventana.
S_FALSE	Bloquear la presentación de la ventana.
E_FAIL	Al implementar INewWindowManager para un control WebBrowser hospedado, este valor indica al control WebBrowser que use la implementación predeterminada.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shobjidl_core.h (include Shobjidl.h)
Archivo DLL	Shell32.dll