ProtectionPolicyManager.HasContentBeenRevokedSince(String, DateTime) Метод

Определение

Пространство имен:

Windows.Security.EnterpriseData

Примечание

Начиная с июля 2022 г. корпорация Майкрософт прекращает использование Windows Information Protection (WIP) и ИНТЕРФЕЙСов API, поддерживающих WIP. Корпорация Майкрософт продолжит поддерживать WIP в поддерживаемых версиях Windows. Новые версии Windows не будут включать новые возможности для WIP и не будут поддерживаться в будущих версиях Windows. Дополнительные сведения см. в статье Объявление о прекращении работы Windows Information Protection.

Для защиты данных корпорация Майкрософт рекомендует использовать Защита информации 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 Information Protection (WIP)). Вопрос о том, было ли отозвано содержимое для удостоверения, имеет смысл только для удостоверения, которое когда-либо находилось под управлением Windows Information Protection (WIP). Следовательно, ответ, возвращаемый из , имеет смысл только при условии, что удостоверение, переданное в API, когда-либо управлялось Windows Information Protection (WIP).

Рекомендуется, чтобы ваше приложение велось в журнале о том, когда оно впервые защищало данные (файлы, буферы или потоки), связанные с удостоверением. После этого следует вызывать только в том случае, если удостоверение защитило содержимое, связанное с ним на этом устройстве, и ваше приложение хочет знать, было ли отозвано защищенное содержимое с момента его защиты.

не предназначено для определения того, была ли когда-либо включена и отозвана ли windows Information Protection (WIP) для произвольного удостоверения, другими словами, в качестве ретроспективной формы IsIdentityManaged.