Freigeben über

INewWindowManager::EvaluateNewWindow-Methode (shobjidl_core.h)

  • Artikel

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