ProtectionPolicyManager.HasContentBeenRevokedSince(String, DateTime) Método

Definición

Espacio de nombres:

Windows.Security.EnterpriseData

Nota:

A partir de julio de 2022, Microsoft está en desuso en Windows Information Protection (WIP) y las API que admiten WIP. Microsoft seguirá admitiendo WIP en versiones compatibles de Windows. Las nuevas versiones de Windows no incluirán nuevas funcionalidades para WIP y no se admitirán en versiones futuras de Windows. Para obtener más información, vea Anuncio de la puesta de sol de Windows Information Protection.

Para sus necesidades de protección de datos, Microsoft recomienda usar Microsoft Purview Information Protection y Prevención de pérdida de datos de Microsoft Purview. Purview simplifica la configuración y proporciona un conjunto avanzado de funcionalidades.

Use este método para comprobar (en busca de una identidad conocida administrada o alguna vez administrada) si se ha revocado el acceso a los datos protegidos desde una fecha y hora especificadas, o si sigue siendo accesible. Tenga en cuenta que la API devuelve true para una identidad desconocida (es decir, una identidad que nunca se ha administrado y no se administra actualmente). Esto es para que la aplicación pueda limpiar los datos asociados a una identidad para la que no hay información. Para obtener más información, consulta Comentarios.

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

Parámetros

identity

String

Platform::String

winrt::hstring

Identidad empresarial que protege los datos. Se trata de una dirección de correo electrónico o dominio administrado. La aplicación debe usar IsIdentityManaged para confirmar que se administra una dirección de correo electrónico o un dominio.

since

DateTime DateTimeOffset

Fecha y hora a partir de la cual desea incluir en la comprobación.

Devoluciones

Boolean

bool

true si se ha revocado el acceso desde la fecha y hora especificadas; de lo contrario, false.

Requisitos de Windows

Familia de dispositivos	Windows Desktop Extension SDK (se introdujo en la versión 10.0.10586.0) Windows Mobile Extension SDK (se introdujo en la versión 10.0.10586.0)
API contract	Windows.Security.EnterpriseData.EnterpriseDataContract (se introdujo en la versión v2.0)

Comentarios

Llame a esta API solo para una identidad que tenga contenido protegido en el dispositivo (es decir, para una identidad administrada por Windows Information Protection (WIP). Preguntar si el contenido se ha revocado para una identidad solo es significativo para una identidad que windows Information Protection (WIP) ha administrado alguna vez. Por lo tanto, la respuesta devuelta de solo es significativa en la condición de que la identidad pasada a la API haya sido administrada por Windows Information Protection (WIP).

Te recomendamos que tu aplicación mantenga un registro de las veces que primero protege los datos (archivos, búferes o secuencias) asociados a una identidad. Después de esto, debes llamar solo si la identidad tiene contenido protegido asociado a él en ese dispositivo y tu aplicación quiere saber si el contenido protegido se revoca desde el momento en que se protegió.

no está diseñado para usarse como una manera de determinar si Windows Information Protection (WIP) se habilitó y después se revoca para una identidad arbitraria, es decir, como una forma retrospectiva de IsIdentityManaged.