Share via


FileProtectionManager.SaveFileAsContainerAsync Method

Definition

Overloads

SaveFileAsContainerAsync(IStorageFile)

Note

Starting in July 2022, Microsoft is deprecating Windows Information Protection (WIP) and the APIs that support WIP. Microsoft will continue to support WIP on supported versions of Windows. New versions of Windows won't include new capabilities for WIP, and it won't be supported in future versions of Windows. For more information, see Announcing sunset of Windows Information Protection.

For your data protection needs, Microsoft recommends that you use Microsoft Purview Information Protection and Microsoft Purview Data Loss Prevention. Purview simplifies the configuration set-up and provides an advanced set of capabilities.

Save an enterprise-protected file as a containerized version.

SaveFileAsContainerAsync(IStorageFile, IIterable<String>)

Note

Starting in July 2022, Microsoft is deprecating Windows Information Protection (WIP) and the APIs that support WIP. Microsoft will continue to support WIP on supported versions of Windows. New versions of Windows won't include new capabilities for WIP, and it won't be supported in future versions of Windows. For more information, see Announcing sunset of Windows Information Protection.

For your data protection needs, Microsoft recommends that you use Microsoft Purview Information Protection and Microsoft Purview Data Loss Prevention. Purview simplifies the configuration set-up and provides an advanced set of capabilities.

Save an enterprise-protected file as a containerized version, and share it with a specified list of user identities.

SaveFileAsContainerAsync(IStorageFile)

Note

Starting in July 2022, Microsoft is deprecating Windows Information Protection (WIP) and the APIs that support WIP. Microsoft will continue to support WIP on supported versions of Windows. New versions of Windows won't include new capabilities for WIP, and it won't be supported in future versions of Windows. For more information, see Announcing sunset of Windows Information Protection.

For your data protection needs, Microsoft recommends that you use Microsoft Purview Information Protection and Microsoft Purview Data Loss Prevention. Purview simplifies the configuration set-up and provides an advanced set of capabilities.

Save an enterprise-protected file as a containerized version.

public:
 static IAsyncOperation<ProtectedContainerExportResult ^> ^ SaveFileAsContainerAsync(IStorageFile ^ protectedFile);
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<ProtectedContainerExportResult> SaveFileAsContainerAsync(IStorageFile const& protectedFile);
/// [Windows.Foundation.Metadata.RemoteAsync]
/// [Windows.Foundation.Metadata.Overload("SaveFileAsContainerAsync")]
 static IAsyncOperation<ProtectedContainerExportResult> SaveFileAsContainerAsync(IStorageFile const& protectedFile);
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<ProtectedContainerExportResult> SaveFileAsContainerAsync(IStorageFile protectedFile);
[Windows.Foundation.Metadata.RemoteAsync]
[Windows.Foundation.Metadata.Overload("SaveFileAsContainerAsync")]
public static IAsyncOperation<ProtectedContainerExportResult> SaveFileAsContainerAsync(IStorageFile protectedFile);
function saveFileAsContainerAsync(protectedFile)
Public Shared Function SaveFileAsContainerAsync (protectedFile As IStorageFile) As IAsyncOperation(Of ProtectedContainerExportResult)

Parameters

protectedFile
IStorageFile

The protected source file being copied.

Returns

When the call to this method completes successfully, it returns a ProtectedContainerExportResult object representing the newly created container file.

Attributes

See also

Applies to

SaveFileAsContainerAsync(IStorageFile, IIterable<String>)

Note

Starting in July 2022, Microsoft is deprecating Windows Information Protection (WIP) and the APIs that support WIP. Microsoft will continue to support WIP on supported versions of Windows. New versions of Windows won't include new capabilities for WIP, and it won't be supported in future versions of Windows. For more information, see Announcing sunset of Windows Information Protection.

For your data protection needs, Microsoft recommends that you use Microsoft Purview Information Protection and Microsoft Purview Data Loss Prevention. Purview simplifies the configuration set-up and provides an advanced set of capabilities.

Save an enterprise-protected file as a containerized version, and share it with a specified list of user identities.

public:
 static IAsyncOperation<ProtectedContainerExportResult ^> ^ SaveFileAsContainerAsync(IStorageFile ^ protectedFile, IIterable<Platform::String ^> ^ sharedWithIdentities);
/// [Windows.Foundation.Metadata.DefaultOverload]
/// [Windows.Foundation.Metadata.Overload("SaveFileAsContainerWithSharingAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<ProtectedContainerExportResult> SaveFileAsContainerAsync(IStorageFile const& protectedFile, IIterable<winrt::hstring> const& sharedWithIdentities);
[Windows.Foundation.Metadata.DefaultOverload]
[Windows.Foundation.Metadata.Overload("SaveFileAsContainerWithSharingAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<ProtectedContainerExportResult> SaveFileAsContainerAsync(IStorageFile protectedFile, IEnumerable<string> sharedWithIdentities);
function saveFileAsContainerAsync(protectedFile, sharedWithIdentities)
Public Shared Function SaveFileAsContainerAsync (protectedFile As IStorageFile, sharedWithIdentities As IEnumerable(Of String)) As IAsyncOperation(Of ProtectedContainerExportResult)

Parameters

protectedFile
IStorageFile

The protected source file being copied.

sharedWithIdentities

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

A collection of strings representing the user identities to share the containerized file with. For example, email recipients.

Returns

When the call to this method completes successfully, it returns a ProtectedContainerExportResult object representing the newly created container file.

Attributes

Windows requirements

Device family
Windows Desktop Extension SDK (introduced in 10.0.10586.0)
Windows Mobile Extension SDK (introduced in 10.0.10586.0)
API contract
Windows.Security.EnterpriseData.EnterpriseDataContract (introduced in v2.0)

See also

Applies to