FileProtectionManager.SaveFileAsContainerAsync Method

Definition

Namespace:

Windows.Security.EnterpriseData

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]
/// [Windows.Foundation.Metadata.Overload("SaveFileAsContainerAsync")]
 static IAsyncOperation<ProtectedContainerExportResult> SaveFileAsContainerAsync(IStorageFile const& 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

IAsyncOperation<ProtectedContainerExportResult>

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

Attributes

RemoteAsyncAttribute OverloadAttribute

See also

• SaveFileAsContainerAsync(IStorageFile, IIterable<String>)

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

IAsyncOperation<ProtectedContainerExportResult>

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

Attributes

DefaultOverloadAttribute OverloadAttribute RemoteAsyncAttribute

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

• SaveFileAsContainerAsync(IStorageFile)