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

Aceita dados sobre uma nova janela que está tentando exibir e determina se essa janela deve ter permissão para abrir com base nas preferências do usuário.

Sintaxe

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

Um ponteiro para um buffer que contém a URL do conteúdo que será exibido na nova janela.

[in] pszName

Tipo: LPCWSTR

Um ponteiro para um buffer que contém o nome da nova janela. Este parâmetro pode ser NULL.

[in] pszUrlContext

Tipo: LPCWSTR

Um ponteiro para um buffer que contém a URL que emitiu o comando para abrir a nova janela.

[in] pszFeatures

Tipo: LPCWSTR

Um ponteiro para um buffer que contém a cadeia de caracteres de recurso para a nova janela. Esse valor pode ser NULL.

[in] fReplace

Tipo: BOOL

Um valor booliano usado quando o novo conteúdo especificado em pszUrl é carregado na janela existente em vez de criar um novo. TRUE se o novo documento deve substituir o documento atual na lista de histórico; FALSE se o novo documento deve receber uma nova entrada.

[in] dwFlags

Tipo: DWORD

Um sinalizador ou sinalizadores da enumeração NWMF que fornecem informações situacionais sobre a chamada para abrir a nova janela. Esse valor poderá ser 0 se nenhum sinalizador for necessário.

[in] dwUserActionTime

Tipo: DWORD

A contagem de tiques quando a última ação do usuário ocorreu. Para descobrir há quanto tempo a ação ocorreu, chame GetTickCount e compare o resultado com o valor nesse parâmetro.

Retornar valor

Tipo: HRESULT

Retorna códigos de erro padrão, incluindo o seguinte:

Código de retorno	Descrição
S_OK	Permitir a exibição da janela.
S_FALSE	Bloquear a exibição da janela.
E_FAIL	Quando você implementa INewWindowManager para um controle WebBrowser hospedado, esse valor instrui o controle WebBrowser a usar a implementação padrão.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h (inclua Shobjidl.h)
DLL	Shell32.dll