interface ICoreWebView2ExperimentalProfile17

interface ICoreWebView2ExperimentalProfile17
  : public IUnknown

This is an interface to control Enhanced Security Mode (ESM) state.

Summary

Applies to

Members

get_EnhancedSecurityModeState

Gets the EnhancedSecurityModeState property.

public HRESULT get_EnhancedSecurityModeState(COREWEBVIEW2_ENHANCED_SECURITY_MODE_STATE * value)

put_EnhancedSecurityModeState

The EnhancedSecurityModeState property allows you to control whether Enhanced Security Mode is enabled or disabled for WebView2 instances associated with a profile.

public HRESULT put_EnhancedSecurityModeState(COREWEBVIEW2_ENHANCED_SECURITY_MODE_STATE value)

This applies to all WebViews sharing the same profile. The configuration is not persisted to the user data folder. The property is reset when the profile is recreated.

The default value is COREWEBVIEW2_ENHANCED_SECURITY_MODE_STATE_DISABLED.

When set to Disabled, Enhanced Security Mode is disabled. When set to Enabled, Enhanced Security Mode is enabled.

See COREWEBVIEW2_ENHANCED_SECURITY_MODE_STATE for descriptions of states.

Changes apply immediately to new navigation. Existing pages require a reload for the change to take effect.

void SettingsComponent::SetEnhancedSecurityModeState(
    COREWEBVIEW2_ENHANCED_SECURITY_MODE_STATE value)
{
    wil::com_ptr<ICoreWebView2_13> webView2_13;
    webView2_13 = m_webView.try_query<ICoreWebView2_13>();

    if (webView2_13)
    {
        wil::com_ptr<ICoreWebView2Profile> profile;
        CHECK_FAILURE(webView2_13->get_Profile(&profile));

        auto experimentalProfile17 = profile.try_query<ICoreWebView2ExperimentalProfile17>();
        if (experimentalProfile17)
        {
            CHECK_FAILURE(experimentalProfile17->put_EnhancedSecurityModeState(value));

            const wchar_t* stateText = L"Disabled";
            if (value == COREWEBVIEW2_ENHANCED_SECURITY_MODE_STATE_ENABLED)
            {
                stateText = L"Enabled";
            }

            MessageBox(
                nullptr,
                (std::wstring(L"Enhanced Security Mode state is set to ") + stateText).c_str(),
                L"Enhanced Security Mode State", MB_OK);
        }
    }
}