interface ICoreWebView2Settings8

Note

This reference is no longer being maintained. For the latest API reference, see WebView2 API Reference.

interface ICoreWebView2Settings8
  : public ICoreWebView2Settings7

A continuation of the ICoreWebView2Settings interface to manage smartscreen.

Summary

Members	Descriptions
get_IsReputationCheckingRequired	SmartScreen helps webviews identify reported phishing and malware websites and also helps users make informed decisions about downloads.
put_IsReputationCheckingRequired	Sets whether this webview2 instance needs SmartScreen protection for its content.

Applies to

Product	Introduced
WebView2 Win32	N/A
WebView2 Win32 Prerelease	1.0.1724

Members

get_IsReputationCheckingRequired

SmartScreen helps webviews identify reported phishing and malware websites and also helps users make informed decisions about downloads.

public HRESULT get_IsReputationCheckingRequired(BOOL * value)

IsReputationCheckingRequired is used to control whether SmartScreen enabled or not. SmartScreen is enabled or disabled for all CoreWebView2s using the same user data folder. If CoreWebView2Setting.IsReputationCheckingRequired is true for any CoreWebView2 using the same user data folder, then SmartScreen is enabled. If CoreWebView2Setting.IsReputationCheckingRequired is false for all CoreWebView2 using the same user data folder, then SmartScreen is disabled. When it is changed, the change will be applied to all WebViews using the same user data folder on the next navigation or download. The default value for IsReputationCheckingRequired is true. If the newly created CoreWebview2 does not set SmartScreen to false, when navigating(Such as Navigate(), LoadDataUrl(), ExecuteScript(), etc.), the default value will be applied to all CoreWebview2 using the same user data folder.

            CHECK_FEATURE_RETURN(m_settings8);

            BOOL is_smart_screen_enabled;
            CHECK_FAILURE(
                m_settings8->get_IsReputationCheckingRequired(&is_smart_screen_enabled));
            if (is_smart_screen_enabled)
            {
                CHECK_FAILURE(m_settings8->put_IsReputationCheckingRequired(false));
                MessageBox(
                    nullptr, L"SmartScreen is disabled after the next navigation.",
                    L"Settings change", MB_OK);
            }
            else
            {
                CHECK_FAILURE(m_settings8->put_IsReputationCheckingRequired(true));
                MessageBox(
                    nullptr, L"SmartScreen is enabled after the next navigation.",
                    L"Settings change", MB_OK);
            }

put_IsReputationCheckingRequired

Sets whether this webview2 instance needs SmartScreen protection for its content.

public HRESULT put_IsReputationCheckingRequired(BOOL value)

Set the IsReputationCheckingRequired property.