interface ICoreWebView2Settings8

Article
08/13/2024

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	1.0.1722.45
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. SmartScreen of WebView2 apps can be controlled by Windows system setting "SmartScreen for Microsoft Edge", specially, for WebView2 in Windows Store apps, SmartScreen is controlled by another Windows system setting "SmartScreen for Microsoft Store apps". When the Windows setting is enabled, the SmartScreen operates under the control of the IsReputationCheckingRequired. When the Windows setting is disabled, the SmartScreen will be disabled regardless of the IsReputationCheckingRequired value set in WebView2 apps. In other words, under this circumstance the value of IsReputationCheckingRequired will be saved but overridden by system setting. Upon re-enabling the Windows setting, the CoreWebview2 will reference the IsReputationCheckingRequired to determine the SmartScreen status.

            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.

Share via