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 引進)

備註

針對 Windows 資訊保護 (WIP) ) 所管理的身分識別，呼叫此 API 僅適用于裝置上具有受保護內容的身分識別 (。 詢問是否已撤銷身分識別的內容，只對 Windows 資訊保護 (WIP) 所管理的身分識別有意義。 因此，從 傳回的答案只有在傳遞至 API 的身分識別已由 Windows 資訊保護 (WIP) 管理的情況下才有意義。

我們建議您的應用程式維護第一次保護資料 (檔案、緩衝區或資料流程) 與身分識別相關聯的記錄。 在此之後，只有在身分識別在該裝置上具有與其相關聯的受保護內容，且您的應用程式想要知道受保護內容在受到保護後是否已撤銷時，才應該呼叫 。

不是用來判斷是否已啟用 Windows 資訊保護 (WIP) ，然後撤銷任意身分識別的方式，換句話說，是IsIdentityManaged的回溯外觀形式。