Partager via

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

  • Article

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