FileRevocationManager.CopyProtectionAsync(IStorageItem, IStorageItem) Metodo

Definizione

Spazio dei nomi:

Windows.Security.EnterpriseData

Nota

A partire da luglio 2022, Microsoft deprecato Windows Information Protection (WIP) e le API che supportano WIP. Microsoft continuerà a supportare WIP nelle versioni supportate di Windows. Le nuove versioni di Windows non includeranno nuove funzionalità per WIP e non saranno supportate nelle versioni future di Windows. Per altre informazioni, vedere Annuncio del tramonto di Windows Information Protection.

Per le esigenze di protezione dei dati, Microsoft consiglia di usare Microsoft Purview Information Protection e Prevenzione della perdita dei dati Microsoft Purview. Purview semplifica la configurazione e offre un set avanzato di funzionalità.

Nota

FileRevocationManager potrebbe non essere disponibile per le versioni dopo Windows 10. Usare invece FileProtectionManager.

Copiare lo stato di protezione della cancellazione selettiva di un file o di una cartella in un nuovo file o cartella.

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)

Parametri

sourceStorageItem

IStorageItem

Elemento di origine da cui copiare lo stato di protezione della cancellazione selettiva.

targetStorageItem

IStorageItem

Elemento di destinazione in cui copiare lo stato di protezione della cancellazione selettiva.

Restituisce

IAsyncOperation<Boolean>

IAsyncOperation<bool>

true se l'operazione di copia ha avuto esito positivo; in caso contrario false.

Attributi

DeprecatedAttribute RemoteAsyncAttribute

Commenti

Se si salva una nuova copia di un file come risultato di un'operazione "salva con nome", lo stato di protezione della cancellazione selettiva non viene copiato con il file. Per proteggere il file, è necessario chiamare il metodo CopyProtectionAsync per copiare lo stato di protezione esistente nel nuovo file. Se si copia un file protetto usando i metodi CopyAsync o CopyAndReplaceAsync , lo stato di protezione della cancellazione selettiva viene copiato con il file e non è necessario chiamare il metodo CopyProtectionAsync.

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

Il metodo CopyProtectionAsync richiede l'accesso esclusivo al file o alla cartella crittografata e avrà esito negativo se un altro processo usa un handle aperto al file o alla cartella.

Vedi anche

• Esempio di FileRevocationManager
• Come proteggere i file con cancellazione selettiva (C#/VB/C++)