interface ICoreWebView2ExperimentalSaveFileSecurityCheckStartingEventArgs

Note

This an experimental API that is shipped with our prerelease SDK. See WebView2 release notes.

interface ICoreWebView2ExperimentalSaveFileSecurityCheckStartingEventArgs
  : public IUnknown

The event args for SaveFileSecurityCheckStarting event.

Summary

Members	Descriptions
get_CancelSave	Gets the CancelSave property.
get_DocumentOriginUri	Get the document origin URI of this file save operation.
get_FileExtension	Get the extension of file to be saved.
get_FilePath	Get the full path of file to be saved.
get_SuppressDefaultPolicy	Gets the SuppressDefaultPolicy property.
GetDeferral	Returns an ICoreWebView2Deferral object.
put_CancelSave	Set if cancel the upcoming save/download.
put_SuppressDefaultPolicy	Set if the default policy checking and security warning will be suppressed.

Applies to

Product	Introduced
WebView2 Win32	N/A
WebView2 Win32 Prerelease

Members

get_CancelSave

Gets the CancelSave property.

public HRESULT get_CancelSave(BOOL * value)

get_DocumentOriginUri

Get the document origin URI of this file save operation.

public HRESULT get_DocumentOriginUri(LPWSTR * value)

The caller must free the returned string with CoTaskMemFree. See API Conventions.

get_FileExtension

Get the extension of file to be saved.

public HRESULT get_FileExtension(LPWSTR * value)

The file extension is the extension portion of the FilePath, preserving original case.

Only final extension with period "." will be provided. For example, "*.tar.gz" is a double extension, where the ".gz" will be its final extension.

File extension can be empty, if the file name has no extension at all.

The caller must free the returned string with CoTaskMemFree. See API Conventions.

get_FilePath

Get the full path of file to be saved.

public HRESULT get_FilePath(LPWSTR * value)

This includes the file name and extension.

This method doesn't provide path validation, the returned string may longer than MAX_PATH.

The caller must free the returned string with CoTaskMemFree. See API Conventions.

get_SuppressDefaultPolicy

Gets the SuppressDefaultPolicy property.

public HRESULT get_SuppressDefaultPolicy(BOOL * value)

GetDeferral

Returns an ICoreWebView2Deferral object.

public HRESULT GetDeferral(ICoreWebView2Deferral ** value)

Use this operation to complete the SaveFileSecurityCheckStartingEvent.

The default policy checking and any default UI will be blocked temporarily, saving file to local won't start, until the deferral is completed.

put_CancelSave

Set if cancel the upcoming save/download.

public HRESULT put_CancelSave(BOOL value)

TRUE means the action will be cancelled before validations in default policy.

The default value is FALSE.

put_SuppressDefaultPolicy

Set if the default policy checking and security warning will be suppressed.

public HRESULT put_SuppressDefaultPolicy(BOOL value)

TRUE means it will be suppressed.

The default value is FALSE.