ProtectionPolicyManager.TryApplyProcessUIPolicy(String) Method

Definition

Namespace:

Windows.Security.EnterpriseData

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.

Enables UI policy enforcement for an enterprise identity. When an app is about to display a protected file (such as a PDF) or resource (buffer or stream) on its UI, it must enable UI policy enforcement based on the identity the file is protected to. A call to TryApplyProcessUIPolicy ensures that the OS knows about the current context of the app.

public:
 static bool TryApplyProcessUIPolicy(Platform::String ^ identity);

 static bool TryApplyProcessUIPolicy(winrt::hstring const& identity);

public static bool TryApplyProcessUIPolicy(string identity);

function tryApplyProcessUIPolicy(identity)

Public Shared Function TryApplyProcessUIPolicy (identity As String) As Boolean

Parameters

identity

String

Platform::String

winrt::hstring

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

Boolean

bool

true if the identity is being managed by an enterprise policy, or false if it is not.

Windows requirements

App capabilities

enterpriseDataPolicy