Condividi tramite

Metodo INewWindowManager::EvaluateNewWindow (shobjidl_core.h)

  • Articolo

Accetta i dati relativi a una nuova finestra che tenta di visualizzare e determina se tale finestra deve essere consentita per l'apertura in base alle preferenze dell'utente.

Sintassi

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

Parametri

[in] pszUrl

Tipo: LPCWSTR

Puntatore a un buffer che contiene l'URL del contenuto che verrà visualizzato nella nuova finestra.

[in] pszName

Tipo: LPCWSTR

Puntatore a un buffer contenente il nome della nuova finestra. Questo parametro può essere NULL.

[in] pszUrlContext

Tipo: LPCWSTR

Puntatore a un buffer contenente l'URL che ha emesso il comando per aprire la nuova finestra.

[in] pszFeatures

Tipo: LPCWSTR

Puntatore a un buffer contenente la stringa di funzionalità per la nuova finestra. Questo valore può essere NULL.

[in] fReplace

Tipo: BOOL

Valore booleano usato quando il nuovo contenuto specificato in pszUrl viene caricato nella finestra esistente anziché crearne uno nuovo. TRUE se il nuovo documento deve sostituire il documento corrente nell'elenco di cronologia; FALSE se al nuovo documento deve essere assegnata una nuova voce.

[in] dwFlags

Tipo: DWORD

Flag o flag dell'enumerazione NWMF che forniscono informazioni situazioni sulla chiamata per aprire la nuova finestra. Questo valore può essere 0 se non sono necessari flag.

[in] dwUserActionTime

Tipo: DWORD

Conteggio dei segni di graduazione quando si è verificata l'ultima azione dell'utente. Per scoprire quanto tempo fa si è verificata l'azione, chiamare GetTickCount e confrontare il risultato con il valore in questo parametro.

Valore restituito

Tipo: HRESULT

Restituisce codici di errore standard, inclusi i seguenti:

Codice restituito Descrizione
S_OK
 Consente la visualizzazione della finestra.
S_FALSE
 Blocca la visualizzazione della finestra.
E_FAIL
 Quando si implementa INewWindowManager per un controllo WebBrowser ospitato, questo valore indica al controllo WebBrowser di usare l'implementazione predefinita.

Requisiti

Requisito Valore
Client minimo supportato Windows XP con SP2 [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shobjidl_core.h (include Shobjidl.h)
DLL Shell32.dll