DataProtectionManager DataProtectionManager DataProtectionManager DataProtectionManager Class

Definition

Note

Windows Information Protection (WIP) policy cannot be applied on Windows 10, version 1511 (build 10586) or earlier.

Provides access to operations that manage buffers and streams that are protected to an enterprise identity.

public : static class DataProtectionManagerpublic static class DataProtectionManagerPublic Static Class DataProtectionManager// You can use this class in JavaScript.
Attributes
Windows 10 requirements
Device family
Windows Desktop Extension SDK (introduced v10.0.10240.0) Windows Mobile Extension SDK (introduced v10.0.10240.0)
API contract
Windows.Security.EnterpriseData.EnterpriseDataContract (introduced v1)
Capabilities
enterpriseDataPolicy

Methods

GetProtectionInfoAsync(IBuffer) GetProtectionInfoAsync(IBuffer) GetProtectionInfoAsync(IBuffer) GetProtectionInfoAsync(IBuffer)

Note

Windows Information Protection (WIP) policy cannot be applied on Windows 10, version 1511 (build 10586) or earlier.

Get the status of an enterprise protected buffer.

public : static IAsyncOperation<DataProtectionInfo> GetProtectionInfoAsync(IBuffer protectedData)public static IAsyncOperation<DataProtectionInfo> GetProtectionInfoAsync(IBuffer protectedData)Public Static Function GetProtectionInfoAsync(protectedData As IBuffer) As IAsyncOperation( Of DataProtectionInfo )// You can use this method in JavaScript.
Parameters
protectedData
IBuffer IBuffer IBuffer IBuffer

The buffer for which protection status is being queried.

Returns

When the call to this method completes successfully, it returns a DataProtectionInfo object that contains the status of the buffer.

Additional features and requirements
Device family
Windows Desktop Extension SDK (introduced v10.0.10240.0) Windows Mobile Extension SDK (introduced v10.0.10240.0)
API contract
Windows.Security.EnterpriseData.EnterpriseDataContract (introduced v1)
Capabilities
enterpriseDataPolicy

GetStreamProtectionInfoAsync(IInputStream) GetStreamProtectionInfoAsync(IInputStream) GetStreamProtectionInfoAsync(IInputStream) GetStreamProtectionInfoAsync(IInputStream)

Note

Windows Information Protection (WIP) policy cannot be applied on Windows 10, version 1511 (build 10586) or earlier.

Get the status of an enterprise protected stream.

public : static IAsyncOperation<DataProtectionInfo> GetStreamProtectionInfoAsync(IInputStream protectedStream)public static IAsyncOperation<DataProtectionInfo> GetStreamProtectionInfoAsync(IInputStream protectedStream)Public Static Function GetStreamProtectionInfoAsync(protectedStream As IInputStream) As IAsyncOperation( Of DataProtectionInfo )// You can use this method in JavaScript.
Parameters
protectedStream
IInputStream IInputStream IInputStream IInputStream

The stream for which protection status is being queried.

Returns

When the call to this method completes successfully, it returns a DataProtectionInfo object that contains the status of the stream.

Additional features and requirements
Device family
Windows Desktop Extension SDK (introduced v10.0.10240.0) Windows Mobile Extension SDK (introduced v10.0.10240.0)
API contract
Windows.Security.EnterpriseData.EnterpriseDataContract (introduced v1)
Capabilities
enterpriseDataPolicy

ProtectAsync(IBuffer, String) ProtectAsync(IBuffer, String) ProtectAsync(IBuffer, String) ProtectAsync(IBuffer, String)

Note

Windows Information Protection (WIP) policy cannot be applied on Windows 10, version 1511 (build 10586) or earlier.

Protect the data in a buffer to an enterprise identity.

public : static IAsyncOperation<BufferProtectUnprotectResult> ProtectAsync(IBuffer data, PlatForm::String identity)public static IAsyncOperation<BufferProtectUnprotectResult> ProtectAsync(IBuffer data, String identity)Public Static Function ProtectAsync(data As IBuffer, identity As String) As IAsyncOperation( Of BufferProtectUnprotectResult )// You can use this method in JavaScript.
Parameters
data
IBuffer IBuffer IBuffer IBuffer

The buffer to be protected.

identity
PlatForm::String String String String

The enterprise identity. This is an email address or domain that is managed. Your app should use IsIdentityManaged to confirm that an email address or domain is managed.

Returns
Additional features and requirements
Device family
Windows Desktop Extension SDK (introduced v10.0.10240.0) Windows Mobile Extension SDK (introduced v10.0.10240.0)
API contract
Windows.Security.EnterpriseData.EnterpriseDataContract (introduced v1)
Capabilities
enterpriseDataPolicy

ProtectStreamAsync(IInputStream, String, IOutputStream) ProtectStreamAsync(IInputStream, String, IOutputStream) ProtectStreamAsync(IInputStream, String, IOutputStream) ProtectStreamAsync(IInputStream, String, IOutputStream)

Note

Windows Information Protection (WIP) policy cannot be applied on Windows 10, version 1511 (build 10586) or earlier.

Protect a stream of data to an enterprise identity.

public : static IAsyncOperation<DataProtectionInfo> ProtectStreamAsync(IInputStream unprotectedStream, PlatForm::String identity, IOutputStream protectedStream)public static IAsyncOperation<DataProtectionInfo> ProtectStreamAsync(IInputStream unprotectedStream, String identity, IOutputStream protectedStream)Public Static Function ProtectStreamAsync(unprotectedStream As IInputStream, identity As String, protectedStream As IOutputStream) As IAsyncOperation( Of DataProtectionInfo )// You can use this method in JavaScript.
Parameters
unprotectedStream
IInputStream IInputStream IInputStream IInputStream

The input, unprotected stream.

identity
PlatForm::String String String String

The enterprise identity. This is an email address or domain that is managed. Your app should use IsIdentityManaged to confirm that an email address or domain is managed.

protectedStream
IOutputStream IOutputStream IOutputStream IOutputStream

The output, protected stream.

Returns

When the call to this method completes successfully, it returns a DataProtectionInfo object that contains the status of the protected stream.

Additional features and requirements
Device family
Windows Desktop Extension SDK (introduced v10.0.10240.0) Windows Mobile Extension SDK (introduced v10.0.10240.0)
API contract
Windows.Security.EnterpriseData.EnterpriseDataContract (introduced v1)
Capabilities
enterpriseDataPolicy

UnprotectAsync(IBuffer) UnprotectAsync(IBuffer) UnprotectAsync(IBuffer) UnprotectAsync(IBuffer)

Note

Windows Information Protection (WIP) policy cannot be applied on Windows 10, version 1511 (build 10586) or earlier.

Removes the protection to an enterprise identity from a buffer.

public : static IAsyncOperation<BufferProtectUnprotectResult> UnprotectAsync(IBuffer data)public static IAsyncOperation<BufferProtectUnprotectResult> UnprotectAsync(IBuffer data)Public Static Function UnprotectAsync(data As IBuffer) As IAsyncOperation( Of BufferProtectUnprotectResult )// You can use this method in JavaScript.
Parameters
data
IBuffer IBuffer IBuffer IBuffer

The buffer to be unprotected.

Returns
Additional features and requirements
Device family
Windows Desktop Extension SDK (introduced v10.0.10240.0) Windows Mobile Extension SDK (introduced v10.0.10240.0)
API contract
Windows.Security.EnterpriseData.EnterpriseDataContract (introduced v1)
Capabilities
enterpriseDataPolicy

Remarks

UnprotectAsync never returns a status of Unprotected since it requires that the input resource be protected. (It is not possible to reliably verify that a resource is unprotected.) If your app compares the result to Unprotected, it contains a design flaw because it implies that it lost track of whether the buffer is protected.

UnprotectStreamAsync(IInputStream, IOutputStream) UnprotectStreamAsync(IInputStream, IOutputStream) UnprotectStreamAsync(IInputStream, IOutputStream) UnprotectStreamAsync(IInputStream, IOutputStream)

Note

Windows Information Protection (WIP) policy cannot be applied on Windows 10, version 1511 (build 10586) or earlier.

Removes the protection to an enterprise identity from a stream of data.

public : static IAsyncOperation<DataProtectionInfo> UnprotectStreamAsync(IInputStream protectedStream, IOutputStream unprotectedStream)public static IAsyncOperation<DataProtectionInfo> UnprotectStreamAsync(IInputStream protectedStream, IOutputStream unprotectedStream)Public Static Function UnprotectStreamAsync(protectedStream As IInputStream, unprotectedStream As IOutputStream) As IAsyncOperation( Of DataProtectionInfo )// You can use this method in JavaScript.
Parameters
protectedStream
IInputStream IInputStream IInputStream IInputStream

The input, protected stream.

unprotectedStream
IOutputStream IOutputStream IOutputStream IOutputStream

The output, unprotected stream.

Returns

When the call to this method completes successfully, it returns a DataProtectionInfo object that contains the status of the unprotected stream.

Additional features and requirements
Device family
Windows Desktop Extension SDK (introduced v10.0.10240.0) Windows Mobile Extension SDK (introduced v10.0.10240.0)
API contract
Windows.Security.EnterpriseData.EnterpriseDataContract (introduced v1)
Capabilities
enterpriseDataPolicy

Remarks

See the remarks in the UnprotectStreamAsync method.