ProtectionPolicyManager.HasContentBeenRevokedSince(String, DateTime) Metode

Definisi

Ruang nama:

Windows.Security.EnterpriseData

Catatan

Mulai Juli 2022, Microsoft menghentikan Windows Information Protection (WIP) dan API yang mendukung WIP. Microsoft akan terus mendukung WIP pada versi Windows yang didukung. Versi baru Windows tidak akan menyertakan kemampuan baru untuk WIP, dan tidak akan didukung di versi Windows yang akan datang. Untuk informasi selengkapnya, lihat Mengumumkan matahari terbenam Windows Information Protection.

Untuk kebutuhan perlindungan data Anda, Microsoft menyarankan agar Anda menggunakan Perlindungan Informasi Microsoft Purview dan Pencegahan Kehilangan Data Microsoft Purview. Purview menyederhanakan pengaturan konfigurasi dan menyediakan serangkaian kemampuan tingkat lanjut.

Gunakan metode ini untuk memeriksa (untuk identitas yang diketahui yang dikelola atau pernah dikelola) apakah akses ke data yang dilindungi telah dicabut sejak tanggal dan waktu tertentu, atau masih dapat diakses. Perhatikan bahwa API mengembalikan true untuk identitas yang tidak diketahui (yaitu, identitas yang belum pernah dikelola dan saat ini tidak dikelola). Ini agar aplikasi Anda dapat membersihkan data yang terkait dengan identitas yang tidak ada informasinya. Untuk informasi selengkapnya, lihat Komentar.

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

Identitas perusahaan yang melindungi data. Ini adalah alamat email atau domain yang dikelola. Aplikasi Anda harus menggunakan IsIdentityManaged untuk mengonfirmasi bahwa alamat email atau domain dikelola.

since

DateTime DateTimeOffset

Tanggal dan waktu dari titik ke depan yang ingin Anda sertakan dalam pemeriksaan.

Mengembalikan

Boolean

bool

true jika akses telah dicabut sejak tanggal dan waktu yang ditentukan, jika tidak salah.

Persyaratan Windows

Rangkaian perangkat	Windows Desktop Extension SDK (diperkenalkan dalam 10.0.10586.0) Windows Mobile Extension SDK (diperkenalkan dalam 10.0.10586.0)
API contract	Windows.Security.EnterpriseData.EnterpriseDataContract (diperkenalkan dalam v2.0)

Keterangan

Panggil API ini hanya untuk identitas yang memiliki konten yang dilindungi pada perangkat (dengan kata lain, untuk identitas yang telah dikelola oleh Windows Information Protection (WIP)). Menanyakan apakah konten telah dicabut untuk identitas hanya bermakna untuk identitas yang pernah dikelola oleh Windows Information Protection (WIP). Akibatnya, jawaban yang dikembalikan hanya bermakna pada kondisi bahwa identitas yang diteruskan ke API pernah dikelola oleh Windows Information Protection (WIP).

Kami menyarankan agar aplikasi Anda mempertahankan log waktu pertama kali aplikasi tersebut melindungi data (file, buffer, atau aliran) yang terkait dengan identitas. Setelah ini, Anda harus memanggil hanya jika identitas telah melindungi konten yang terkait dengannya di perangkat tersebut dan aplikasi Anda ingin mengetahui apakah konten yang dilindungi dicabut sejak dilindungi.

tidak dimaksudkan untuk digunakan sebagai cara untuk menentukan apakah Windows Information Protection (WIP) pernah diaktifkan dan kemudian dicabut untuk identitas arbitrer, dengan kata lain sebagai bentuk IsIdentityManaged yang tampak retrospektif.