interface ICoreWebView2PermissionRequestedEventArgs
Note
This reference is no longer being maintained. For the latest API reference, see WebView2 API Reference.
interface ICoreWebView2PermissionRequestedEventArgs
: public IUnknown
Event args for the PermissionRequested event.
Summary
| Members | Descriptions |
|---|---|
| get_IsUserInitiated | TRUE when the permission request was initiated through a user gesture. |
| get_PermissionKind | The type of the permission that is requested. |
| get_State | The status of a permission request, (for example is the request is granted). |
| get_Uri | The origin of the web content that requests the permission. |
| GetDeferral | Gets an ICoreWebView2Deferral object. |
| put_State | Sets the State property. |
Applies to
| Product | Introduced |
|---|---|
| WebView2 Win32 | 0.9.430 |
| WebView2 Win32 Prerelease | 0.9.488 |
Members
get_IsUserInitiated
TRUE when the permission request was initiated through a user gesture.
public HRESULT get_IsUserInitiated(BOOL * isUserInitiated)
Note
Being initiated through a user gesture does not mean that user intended to access the associated resource.
get_PermissionKind
The type of the permission that is requested.
public HRESULT get_PermissionKind(COREWEBVIEW2_PERMISSION_KIND * permissionKind)
get_State
The status of a permission request, (for example is the request is granted).
public HRESULT get_State(COREWEBVIEW2_PERMISSION_STATE * state)
The default value is COREWEBVIEW2_PERMISSION_STATE_DEFAULT.
get_Uri
The origin of the web content that requests the permission.
public HRESULT get_Uri(LPWSTR * uri)
The caller must free the returned string with CoTaskMemFree. See API Conventions.
GetDeferral
Gets an ICoreWebView2Deferral object.
public HRESULT GetDeferral(ICoreWebView2Deferral ** deferral)
Use the deferral object to make the permission decision at a later time. The deferral only applies to the current request, and does not prevent the PermissionRequested event from getting raised for new requests. However, for some permission kinds the WebView will avoid creating a new request if there is a pending request of the same kind.
put_State
Sets the State property.
public HRESULT put_State(COREWEBVIEW2_PERMISSION_STATE state)