ProtectionPolicyManager.HasContentBeenRevokedSince(String, DateTime) メソッド

定義

名前空間:

Windows.Security.EnterpriseData

注意

2022 年 7 月以降、Microsoft は Windows Information Protection (WIP) と WIP をサポートする API を非推奨にしています。 Microsoft は、サポートされているバージョンの Windows で WIP を引き続きサポートします。 Windows の新しいバージョンには WIP の新機能は含まれません。また、今後のバージョンの Windows ではサポートされません。 詳細については、「Windows Information Protectionの終了を発表する」を参照してください。

データ保護のニーズに合わせて、Microsoft Purview 情報保護とMicrosoft Purview データ損失防止を使用することをお勧めします。 Purview を使用すると、構成のセットアップが簡略化され、高度な機能セットが提供されます。

このメソッドを使用して、保護されたデータへのアクセスが指定された日時以降に取り消されたか、引き続きアクセス可能であるかをチェックする (マネージドまたは管理された既知の ID の場合)。 API は不明な ID (つまり、管理されておらず、現在管理されていない ID) に対して true を返すことに注意してください。 これは、情報がない ID に関連付けられたデータをアプリでクリーンできるようにするためです。 詳細については、「備考」を参照してください。

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

データを保護するエンタープライズ ID。 これは、管理されているメール アドレスまたはドメインです。 アプリでは 、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 は、デバイス上のコンテンツが保護されている ID (つまり、Windows Information Protection (WIP) によって管理されている ID) に対してのみ呼び出します。 ID に対してコンテンツが取り消されたかどうかを確認することは、Windows Information Protection (WIP) によって管理された ID に対してのみ意味があります。 したがって、 から返される回答は、API に渡された ID が Windows Information Protection (WIP) によって管理されたという条件でのみ意味があります。

アプリでは、ID に関連付けられているデータ (ファイル、バッファー、またはストリーム) を最初に保護した時間のログを保持することをお勧めします。 この後に を呼び出す必要があるのは、ID に関連付けられた保護されたコンテンツがそのデバイス上にあり、保護されたコンテンツが保護された時点以降に取り消されたかどうかをアプリが知りたい場合のみです。

は、Windows Information Protection (WIP) が有効になったかどうかを判断し、任意の ID に対して取り消されたかどうかを判断する方法として使用されるものではありません。つまり、IsIdentityManaged の振り返り形式として使用されます。