FileRevocationManager.CopyProtectionAsync(IStorageItem, IStorageItem) Methode

Definition

Namespace:

Windows.Security.EnterpriseData

Hinweis

Ab Juli 2022 stellt Microsoft Windows Information Protection (WIP) und die APIs, die WIP unterstützen, als veraltet fest. Microsoft wird WIP weiterhin auf unterstützten Versionen von Windows unterstützen. 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, dass Sie Microsoft Purview Information Protection und Microsoft Purview Data Loss Prevention verwenden. Purview vereinfacht die Konfiguration und bietet einen erweiterten Satz von Funktionen.

Hinweis

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

Kopieren Sie den Selektiven Zurücksetzungsschutzstatus einer Datei oder eines Ordners in eine neue Datei oder einen neuen Ordner.

public:
 static IAsyncOperation<bool> ^ CopyProtectionAsync(IStorageItem ^ sourceStorageItem, IStorageItem ^ targetStorageItem);

/// [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<bool> CopyProtectionAsync(IStorageItem const& sourceStorageItem, IStorageItem const& targetStorageItem);

[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<bool> CopyProtectionAsync(IStorageItem sourceStorageItem, IStorageItem targetStorageItem);

function copyProtectionAsync(sourceStorageItem, targetStorageItem)

Public Shared Function CopyProtectionAsync (sourceStorageItem As IStorageItem, targetStorageItem As IStorageItem) As IAsyncOperation(Of Boolean)

Parameter

sourceStorageItem

IStorageItem

Das Quellelement, aus dem der selektive Zurücksetzungsschutz status kopiert werden soll.

targetStorageItem

IStorageItem

Das Zielelement, in das der selektive Zurücksetzungsschutz status soll.

Gibt zurück

IAsyncOperation<Boolean>

IAsyncOperation<bool>

TRUE , wenn der Kopiervorgang erfolgreich war; andernfalls false.

Attribute

DeprecatedAttribute RemoteAsyncAttribute

Hinweise

Wenn Sie eine neue Kopie einer Datei als Ergebnis eines "Speichern unter"-Vorgangs speichern, wird der selektive Zurücksetzungsschutz status nicht mit der Datei kopiert. Zum Schutz der Datei müssen Sie die CopyProtectionAsync-Methode aufrufen, um den vorhandenen Schutz status in die neue Datei zu kopieren. Wenn Sie eine geschützte Datei mithilfe der CopyAsync- oder CopyAndReplaceAsync-Methode kopieren, wird der selektive Status mit der Datei kopiert, und Sie müssen die CopyProtectionAsync-Methode nicht aufrufen.

public async Task<bool> CopyFile(StorageFile file, StorageFolder newFolder) 
{
    bool result = false;

    try
    {
        var newFile = await file.CopyAsync(newFolder);
        result = await 
            Windows.Security.EnterpriseData.FileRevocationManager.
            CopyProtectionAsync(file, newFile);
        }
    catch (Exception e) 
    {
        // Handle exception. For example, copy already exists.
    }

    return result;
}

Die CopyProtectionAsync-Methode erfordert exklusiven Zugriff auf die datei oder den Ordner, die verschlüsselt wird, und schlägt fehl, wenn ein anderer Prozess verwendet, der ein Handle für die Datei oder den Ordner geöffnet hat.

Weitere Informationen

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