FileRevocationManager.ProtectAsync(IStorageItem, String) メソッド

定義

名前空間:

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 を使用すると、構成のセットアップが簡略化され、高度な機能セットが提供されます。

注意

fileRevocationManager は、Windows 10後のリリースでは使用できない場合があります。 代わりに、 FileProtectionManager を使用します。

選択的ワイプのためにファイルまたはフォルダーを保護します。

public:
 static IAsyncOperation<FileProtectionStatus> ^ ProtectAsync(IStorageItem ^ storageItem, Platform::String ^ enterpriseIdentity);

/// [Windows.Foundation.Metadata.RemoteAsync]
/// [Windows.Foundation.Metadata.Deprecated("FileRevocationManager might be unavailable after Windows 10. Instead, use FileProtectionManager.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Security.EnterpriseData.EnterpriseDataContract")]
 static IAsyncOperation<FileProtectionStatus> ProtectAsync(IStorageItem const& storageItem, winrt::hstring const& enterpriseIdentity);

[Windows.Foundation.Metadata.RemoteAsync]
[Windows.Foundation.Metadata.Deprecated("FileRevocationManager might be unavailable after Windows 10. Instead, use FileProtectionManager.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Security.EnterpriseData.EnterpriseDataContract")]
public static IAsyncOperation<FileProtectionStatus> ProtectAsync(IStorageItem storageItem, string enterpriseIdentity);

function protectAsync(storageItem, enterpriseIdentity)

Public Shared Function ProtectAsync (storageItem As IStorageItem, enterpriseIdentity As String) As IAsyncOperation(Of FileProtectionStatus)

パラメーター

storageItem

IStorageItem

選択的ワイプ用に保護するファイルまたはフォルダー。

enterpriseIdentity

String

Platform::String

winrt::hstring

ファイルまたはフォルダーが保護されているエンタープライズ ID。 enterpriseIdentity 値は、国際化ドメイン名 (IDN) として書式設定する必要があり、スペースを含めることはできません。 たとえば、「 contoso.com 」のように入力します。

戻り値

IAsyncOperation<FileProtectionStatus>

storageItem の選択的ワイプ保護状態を取得する非同期操作。

属性

DeprecatedAttribute RemoteAsyncAttribute

注釈

ProtectAsync メソッドを使用して、選択的ワイプを使用してファイルまたはフォルダーを保護できます。 これにより、前のコード例に示すように、"example.com" などのエンタープライズ識別子で保護されているファイルが識別されます。 ProtectAsync メソッドを使用してフォルダーを保護する場合、そのフォルダー内のすべてのファイルは同じ保護を継承します。

ApplicationData appRootFolder = ApplicationData.Current;
string enterpriseIdentity = "example.com";
int AccessDeniedHResult = -2147024891;  // Access Denied (0x80070005)

// Add a folder and protect it using Selective Wipe.
private async Task<StorageFolder> AddFolder(string folderName)
{
    StorageFolder newFolder = await appRootFolder.LocalFolder.CreateFolderAsync(folderName);

    var status = await ProtectItem(newFolder, enterpriseIdentity);

    return newFolder;
}

// Add a file and protect it using Selective Wipe.
private async Task<StorageFile> AddFile(string fileName, StorageFolder folder)
{
    StorageFile newFile = await folder.CreateFileAsync(fileName);

    var status = 
        await Windows.Security.EnterpriseData.FileRevocationManager.
            GetStatusAsync(newFile);

    if (status != Windows.Security.EnterpriseData.FileProtectionStatus.Protected)
    {
        status = await ProtectItem(newFile, enterpriseIdentity);
    }

    return newFile;
}

private async Task<Windows.Security.EnterpriseData.FileProtectionStatus> 
    ProtectItem(IStorageItem item, string enterpriseIdentity)
{
    var status = 
        await Windows.Security.EnterpriseData.FileRevocationManager.
            ProtectAsync(item, enterpriseIdentity);

    return status;
}

ProtectAsync メソッドは、暗号化されているファイルまたはフォルダーへの排他的アクセスを必要とし、別のプロセスでを使用している場合、ファイルまたはフォルダーに対してハンドルが開かれている場合は失敗します。

こちらもご覧ください

• FileRevocationManager サンプル
• 選択的ワイプを使用してファイルを保護する方法 (C#/VB/C++)