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

Accepte les données relatives à une nouvelle fenêtre qui tente de s’afficher et détermine si cette fenêtre doit être autorisée à s’ouvrir en fonction des préférences de l’utilisateur.

Syntaxe

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

Paramètres

[in] pszUrl

Type : LPCWSTR

Pointeur vers une mémoire tampon qui contient l’URL du contenu qui sera affiché dans la nouvelle fenêtre.

[in] pszName

Type : LPCWSTR

Pointeur vers une mémoire tampon qui contient le nom de la nouvelle fenêtre. Ce paramètre peut être NULL.

[in] pszUrlContext

Type : LPCWSTR

Pointeur vers une mémoire tampon qui contient l’URL qui a émis la commande pour ouvrir la nouvelle fenêtre.

[in] pszFeatures

Type : LPCWSTR

Pointeur vers une mémoire tampon qui contient la chaîne de fonctionnalité de la nouvelle fenêtre. Cette valeur peut être NULL.

[in] fReplace

Type : BOOL

Valeur booléenne utilisée lorsque le nouveau contenu spécifié dans pszUrl est chargé dans la fenêtre existante au lieu d’en créer une nouvelle. TRUE si le nouveau document doit remplacer le document actif dans la liste d’historiques ; FALSE si une nouvelle entrée doit être attribuée au nouveau document.

[in] dwFlags

Type : DWORD

Indicateur ou indicateurs de l’énumération NWMF qui fournissent des informations situationnelles sur l’appel pour ouvrir la nouvelle fenêtre. Cette valeur peut être 0 si aucun indicateur n’est nécessaire.

[in] dwUserActionTime

Type : DWORD

Nombre de graduations lorsque la dernière action de l’utilisateur s’est produite. Pour savoir combien de temps l’action s’est produite, appelez GetTickCount et comparez le résultat avec la valeur dans ce paramètre.

Valeur retournée

Type : HRESULT

Retourne les codes d’erreur standard, notamment les suivants :

Code de retour	Description
S_OK	Autoriser l’affichage de la fenêtre.
S_FALSE	Bloquer l’affichage de la fenêtre.
E_FAIL	Lorsque vous implémentez INewWindowManager pour un contrôle WebBrowser hébergé, cette valeur indique au contrôle WebBrowser d’utiliser l’implémentation par défaut.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP avec SP2 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (incluez Shobjidl.h)
DLL	Shell32.dll