INewWindowManager::EvaluateNewWindow-Methode (shobjidl_core.h)

Akzeptiert Daten zu einem neuen Fenster, das versucht, anzuzeigen, und bestimmt, ob dieses Fenster basierend auf den Einstellungen des Benutzers geöffnet werden darf.

Syntax

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

Parameter

[in] pszUrl

Typ: LPCWSTR

Ein Zeiger auf einen Puffer, der die URL des Inhalts enthält, der im neuen Fenster angezeigt wird.

[in] pszName

Typ: LPCWSTR

Ein Zeiger auf einen Puffer, der den Namen des neuen Fensters enthält. Dieser Parameter kann NULL sein.

[in] pszUrlContext

Typ: LPCWSTR

Ein Zeiger auf einen Puffer, der die URL enthält, die den Befehl zum Öffnen des neuen Fensters ausgegeben hat.

[in] pszFeatures

Typ: LPCWSTR

Ein Zeiger auf einen Puffer, der die Featurezeichenfolge für das neue Fenster enthält. Dieser Wert kann NULL sein.

[in] fReplace

Typ: BOOL

Ein boolescher Wert, der verwendet wird, wenn der in pszUrl angegebene neue Inhalt in das vorhandene Fenster geladen wird, anstatt einen neuen zu erstellen. TRUE , wenn das neue Dokument das aktuelle Dokument in der Verlaufsliste ersetzen soll; FALSE , wenn dem neuen Dokument ein neuer Eintrag zugewiesen werden soll.

[in] dwFlags

Art: DWORD

Ein Flag oder Flags aus der NWMF-Enumeration , die Situationsinformationen zum Aufruf zum Öffnen des neuen Fensters bereitstellen. Dieser Wert kann 0 sein, wenn keine Flags erforderlich sind.

[in] dwUserActionTime

Art: DWORD

Die Häkchenanzahl, wenn die letzte Benutzeraktion aufgetreten ist. Um herauszufinden, wie lange die Aktion zurückliegt, rufen Sie GetTickCount auf, und vergleichen Sie das Ergebnis mit dem Wert in diesem Parameter.

Rückgabewert

Typ: HRESULT

Gibt Standardfehlercodes zurück, einschließlich der folgenden:

Rückgabecode	BESCHREIBUNG
S_OK	Lassen Sie die Anzeige des Fensters zu.
S_FALSE	Blockanzeige des Fensters.
E_FAIL	Wenn Sie INewWindowManager für ein gehostetes WebBrowser-Steuerelement implementieren, weist dieser Wert das WebBrowser-Steuerelement an, die Standardimplementierung zu verwenden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (einschließlich Shobjidl.h)
DLL	Shell32.dll