ProtectionPolicyManager.HasContentBeenRevokedSince(String, DateTime) 方法

定义

命名空间:

Windows.Security.EnterpriseData

注意

从 2022 年 7 月开始，Microsoft 将弃用 Windows 信息保护 (WIP) 和支持 WIP 的 API。 Microsoft 将继续在受支持的 Windows 版本上支持 WIP。 新版本的 Windows 不包含 WIP 的新功能，将来的 Windows 版本中不支持它。 有关详细信息，请参阅宣布 Windows 信息保护的日落。

出于数据保护需求，Microsoft 建议使用Microsoft Purview 信息保护和Microsoft Purview 数据丢失防护。 Purview 简化了配置设置，并提供一组高级功能。

使用此方法可检查 (托管或曾经托管的已知标识，) 是自指定日期和时间以来已撤销对受保护数据的访问权限，还是仍可访问。 请注意，对于未知标识 (，API 返回 true，即从未管理过且当前未) 管理的标识。 这样，你的应用就可以清理与标识关联的数据，而该标识没有信息。 有关详细信息，请参阅备注。

public:
 static bool HasContentBeenRevokedSince(Platform::String ^ identity, DateTime since);

 static bool HasContentBeenRevokedSince(winrt::hstring const& identity, DateTime const& since);

public static bool HasContentBeenRevokedSince(string identity, System.DateTimeOffset since);

function hasContentBeenRevokedSince(identity, since)

Public Shared Function HasContentBeenRevokedSince (identity As String, since As DateTimeOffset) As Boolean

参数

identity

String

Platform::String

winrt::hstring

保护数据的企业标识。 这是托管的电子邮件地址或域。 你的应用应使用 IsIdentityManaged 确认电子邮件地址或域是托管的。

since

DateTime DateTimeOffset

要包含在检查的前进点的日期和时间。

返回

Boolean

bool

如果自指定日期和时间以来吊销了访问权限，则为 true，否则为 false。

Windows 要求

设备系列	Windows Desktop Extension SDK (在 10.0.10586.0 中引入) Windows Mobile Extension SDK (在 10.0.10586.0 中引入)
API contract	Windows.Security.EnterpriseData.EnterpriseDataContract (在 v2.0 中引入)

注解

仅针对设备上具有受保护内容的标识调用此 API (，换而言之，即为由 Windows 信息保护 (WIP) ) 管理的标识调用此 API。 询问是否已撤消标识的内容仅对曾经由 Windows 信息保护 (WIP) 管理的标识有意义。 因此，仅当传递给 API 的标识曾经由 Windows 信息保护 (WIP) 管理的情况下，从 返回的答案才有意义。

我们建议你的应用维护其首次保护数据的时间日志， (与标识关联的文件、缓冲区或流) 。 在此之后，仅当标识在该设备上具有与之关联的受保护内容，并且你的应用希望知道受保护内容自受保护时间以来是否已撤销时，才应调用 。

不打算用作确定 Windows 信息保护 (WIP) 是否曾经启用过然后撤销任意标识（即作为 IsIdentityManaged 的追溯形式）的方法。