INewWindowManager::EvaluateNewWindow メソッド (shobjidl_core.h)

表示しようとしている新しいウィンドウに関するデータを受け入れ、ユーザーの設定に基づいてウィンドウを開くことを許可するかどうかを決定します。

構文

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

パラメーター

[in] pszUrl

種類: LPCWSTR

新しいウィンドウに表示されるコンテンツの URL を含むバッファーへのポインター。

[in] pszName

種類: LPCWSTR

新しいウィンドウの名前を含むバッファーへのポインター。 このパラメーターは、NULL でもかまいません。

[in] pszUrlContext

種類: LPCWSTR

新しいウィンドウを開くコマンドを発行した URL を含むバッファーへのポインター。

[in] pszFeatures

種類: LPCWSTR

新しいウィンドウの機能文字列を含むバッファーへのポインター。 この値は NULL にすることができます。

[in] fReplace

種類: BOOL

pszUrl で指定された新しいコンテンツが新しいコンテンツを作成する代わりに既存のウィンドウに読み込まれるときに使用されるブール値。 新 しい文書が履歴リストの現在の文書を置き換える必要がある場合は TRUE。 新 しいドキュメントに新しいエントリを指定する必要がある場合は FALSE。

[in] dwFlags

型: DWORD

新しいウィンドウを開く呼び出しに関する状況情報を提供する NWMF 列挙からのフラグまたはフラグ。 フラグが必要ない場合、この値は 0 にすることができます。

[in] dwUserActionTime

型: DWORD

最後のユーザー アクションが発生したときのティック数。 アクションが発生した時間を調べるには、 GetTickCount を呼び出し、結果をこのパラメーターの値と比較します。

戻り値

種類: HRESULT

次のような標準エラー コードを返します。

リターン コード	説明
S_OK	ウィンドウの表示を許可します。
S_FALSE	ウィンドウの表示をブロックします。
E_FAIL	ホストされた WebBrowser コントロールに INewWindowManager を実装すると、この値は WebBrowser コントロールに既定の実装を使用するように指示します。

要件

要件	値
サポートされている最小のクライアント	WINDOWS XP と SP2 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	shobjidl_core.h (Shobjidl.h を含む)
[DLL]	Shell32.dll