ProtectionPolicyManager.HasContentBeenRevokedSince(String, DateTime) Methode

Definition

Namespace:

Windows.Security.EnterpriseData

Hinweis

Ab Juli 2022 stellt Microsoft Windows Information Protection (WIP) und die APIs, die WIP unterstützen, als veraltet fest. Microsoft wird WIP weiterhin auf unterstützten Versionen von Windows unterstützen. Neue Versionen von Windows enthalten keine neuen Funktionen für WIP und werden in zukünftigen Versionen von Windows nicht unterstützt. Weitere Informationen finden Sie unter Ankündigung des Sonnenuntergangs von Windows Information Protection.

Für Ihre Datenschutzanforderungen empfiehlt Microsoft, dass Sie Microsoft Purview Information Protection und Microsoft Purview Data Loss Prevention verwenden. Purview vereinfacht die Konfiguration und bietet einen erweiterten Satz von Funktionen.

Verwenden Sie diese Methode, um zu überprüfen (für eine bekannte Identität, die verwaltet wird oder jemals verwaltet wurde), ob der Zugriff auf geschützte Daten seit einem angegebenen Datum und einer bestimmten Uhrzeit widerrufen wurde oder noch zugänglich ist. Beachten Sie, dass die API true für eine unbekannte Identität zurückgibt (d. a. eine Identität, die noch nie verwaltet wurde und derzeit nicht verwaltet wird). Dadurch kann Ihre App Daten sauber, die einer Identität zugeordnet sind, für die keine Informationen vorhanden sind. Weitere Informationen finden Sie unter Hinweise.

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

Parameter

identity

String

Platform::String

winrt::hstring

Die Unternehmensidentität, die die Daten schützt. Dies ist eine E-Mail-Adresse oder Domäne, die verwaltet wird. Ihre App sollte IsIdentityManaged verwenden, um zu bestätigen, dass eine E-Mail-Adresse oder Domäne verwaltet wird.

since

DateTime DateTimeOffset

Das Datum und die Uhrzeit, ab dem Sie in die Überprüfung einbeziehen möchten.

Gibt zurück

Boolean

bool

true , wenn der Zugriff seit dem angegebenen Datum und der angegebenen Uhrzeit widerrufen wurde, andernfalls false.

Windows-Anforderungen

Gerätefamilie	Windows Desktop Extension SDK (eingeführt in 10.0.10586.0) Windows Mobile Extension SDK (eingeführt in 10.0.10586.0)
API contract	Windows.Security.EnterpriseData.EnterpriseDataContract (eingeführt in v2.0)

Hinweise

Rufen Sie diese API nur für eine Identität auf, die über geschützte Inhalte auf dem Gerät verfügt (d. h. für eine Identität, die von Windows Information Protection (WIP) verwaltet wurde). Die Frage, ob Inhalte für eine Identität widerrufen wurden, ist nur für eine Identität sinnvoll, die jemals von Windows Information Protection (WIP) verwaltet wurde. Daher ist die von zurückgegebene Antwort nur dann sinnvoll, wenn die an die API übergebene Identität jemals von Windows Information Protection (WIP) verwaltet wurde.

Es wird empfohlen, dass Ihre App ein Protokoll darüber führt, zu welchen Zeitpunkten sie zuerst Daten (Dateien, Puffer oder Datenströme) geschützt hat, die einer Identität zugeordnet sind. Danach sollten Sie nur dann aufrufen, wenn die Identität geschützte Inhalte auf diesem Gerät zugeordnet hat und Ihre App wissen möchte, ob der geschützte Inhalt seit dem Zeitpunkt des Schutzes widerrufen wurde.

soll nicht als Möglichkeit verwendet werden, um festzustellen, ob Windows Information Protection (WIP) jemals aktiviert und dann für eine beliebige Identität, also als retrospektive Form von IsIdentityManaged, widerrufen wurde.