FileRevocationManager.ProtectAsync(IStorageItem, String) Methode

Definition

Namespace:

Windows.Security.EnterpriseData

Hinweis

Ab Juli 2022 veraltet Microsoft Windows Information Protection (WIP) und die APIs, die WIP unterstützen. Microsoft unterstützt WEITERHIN WIP für unterstützte Versionen von Windows. Neue Versionen von Windows enthalten keine neuen Funktionen für WIP und werden in zukünftigen Versionen von Windows nicht unterstützt. Weitere Informationen finden Sie unter Ankündigung des Sonnenuntergangs von Windows Information Protection.

Für Ihre Datenschutzanforderungen empfiehlt Microsoft, Microsoft Purview Information Protection und Microsoft Purview Data Loss Prevention zu verwenden. Purview vereinfacht die Konfiguration und bietet erweiterte Funktionen.

Hinweis

FileRevocationManager ist für Releases nach Windows 10 möglicherweise nicht verfügbar. Verwenden Sie stattdessen FileProtectionManager.

Schützt eine Datei oder einen Ordner beim selektiven Zurücksetzen.

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)

Parameter

storageItem

IStorageItem

Die Datei oder den Ordner, die für die selektive Zurücksetzung geschützt werden sollen.

enterpriseIdentity

String

Platform::String

winrt::hstring

Die Unternehmens-ID, für die die Datei oder der Ordner geschützt ist. Der enterpriseIdentity-Wert muss als internationalisierter Domänenname (IDN) formatiert sein und darf keine Leerzeichen enthalten. Beispiel: contoso.com.

Gibt zurück

IAsyncOperation<FileProtectionStatus>

Ein asynchroner Vorgang, der den selektiven Zurücksetzungsschutz status für storageItem abruft.

Attribute

DeprecatedAttribute RemoteAsyncAttribute

Hinweise

Sie können die ProtectAsync-Methode verwenden, um eine Datei oder einen Ordner mithilfe des selektiven Zurücksetzens zu schützen. Dadurch wird die Datei als für Ihren Unternehmensbezeichner geschützt, z. B. "example.com", wie im vorherigen Codebeispiel gezeigt. Wenn Sie einen Ordner mit der ProtectAsync-Methode schützen, erben alle Dateien in diesem Ordner denselben Schutz.

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;
}

Die ProtectAsync-Methode erfordert exklusiven Zugriff auf die Datei oder den Ordner, die verschlüsselt werden, und schlägt fehl, wenn ein anderer Prozess verwendet, dass ein Handle für die Datei oder den Ordner geöffnet ist.

Weitere Informationen

• FileRevocationManager-Beispiel
• Schützen von Dateien mit selektiver Zurücksetzung (C#/VB/C++)