interface ICoreWebView2_10

  • Article

Note

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

interface ICoreWebView2_10
  : public ICoreWebView2_9

This interface is an extension of ICoreWebView2 that supports BasicAuthenticationRequested event.

Summary

Members Descriptions
add_BasicAuthenticationRequested Add an event handler for the BasicAuthenticationRequested event.
remove_BasicAuthenticationRequested Remove an event handler previously added with add_BasicAuthenticationRequested.

Applies to

Product Introduced
WebView2 Win32 1.0.1150.38
WebView2 Win32 Prerelease 1.0.1133

Members

add_BasicAuthenticationRequested

Add an event handler for the BasicAuthenticationRequested event.

public HRESULT add_BasicAuthenticationRequested(ICoreWebView2BasicAuthenticationRequestedEventHandler * eventHandler, EventRegistrationToken * token)

BasicAuthenticationRequested event is raised when WebView encounters a Basic HTTP Authentication request as described in https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication or an NTLM authentication request.

The host can provide a response with credentials for the authentication or cancel the request. If the host doesn't set the Cancel property to true or set either UserName or Password properties on the Response property, then WebView2 will show the default authentication challenge dialog prompt to the user.

    if (auto webView10 = m_webView.try_query<ICoreWebView2_10>())
    {
        CHECK_FAILURE(webView10->add_BasicAuthenticationRequested(
            Callback<ICoreWebView2BasicAuthenticationRequestedEventHandler>(
                [this](
                    ICoreWebView2* sender,
                    ICoreWebView2BasicAuthenticationRequestedEventArgs* args) {
                    wil::com_ptr<ICoreWebView2BasicAuthenticationResponse> basicAuthenticationResponse;
                    CHECK_FAILURE(args->get_Response(&basicAuthenticationResponse));
                    CHECK_FAILURE(basicAuthenticationResponse->put_UserName(L"user"));
                    CHECK_FAILURE(basicAuthenticationResponse->put_Password(L"pass"));

                    return S_OK;
                })
                .Get(),
            &m_basicAuthenticationRequestedToken));
    }
    else {
        FeatureNotAvailable();
    }

remove_BasicAuthenticationRequested

Remove an event handler previously added with add_BasicAuthenticationRequested.

public HRESULT remove_BasicAuthenticationRequested(EventRegistrationToken token)