FileRevocationManager.CopyProtectionAsync(IStorageItem, IStorageItem) Método

Definição

Namespace:

Windows.Security.EnterpriseData

Observação

A partir de julho de 2022, a Microsoft está substituindo o Windows Proteção de Informações (WIP) e as APIs que dão suporte à WIP. A Microsoft continuará a dar suporte à WIP em versões com suporte do Windows. As novas versões do Windows não incluirão novos recursos para WIP e não serão compatíveis com versões futuras do Windows. Para obter mais informações, consulte Anunciando o pôr do sol do Windows Proteção de Informações.

Para suas necessidades de proteção de dados, a Microsoft recomenda que você use Proteção de Informações do Microsoft Purview e Prevenção Contra Perda de Dados do Microsoft Purview. O Purview simplifica a configuração configuração e fornece um conjunto avançado de recursos.

Observação

FileRevocationManager pode estar indisponível para versões após o Windows 10. Em vez disso, use FileProtectionManager.

Copie o estado de proteção de apagamento seletivo de um arquivo ou pasta para um novo arquivo ou pasta.

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)

Parâmetros

sourceStorageItem

IStorageItem

O item de origem do qual copiar o status de proteção de apagamento seletivo.

targetStorageItem

IStorageItem

O item de destino para o qual copiar a proteção de apagamento seletivo status.

Retornos

IAsyncOperation<Boolean>

IAsyncOperation<bool>

true se a operação de cópia foi bem-sucedida; caso contrário , false.

Atributos

DeprecatedAttribute RemoteAsyncAttribute

Comentários

Se você salvar uma nova cópia de um arquivo como resultado de uma operação "salvar como", a proteção de apagamento seletivo status não será copiada com o arquivo. Para proteger o arquivo, você deve chamar o método CopyProtectionAsync para copiar a proteção existente status para o novo arquivo. Se você copiar um arquivo protegido usando os métodos CopyAsync ou CopyAndReplaceAsync, a proteção de apagamento seletivo status será copiada com o arquivo e você não precisará chamar o método 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;
}

O método CopyProtectionAsync requer acesso exclusivo ao arquivo ou pasta que está sendo criptografado e falhará se outro processo estiver usando tiver um identificador aberto no arquivo ou pasta.

Confira também

• Exemplo de FileRevocationManager
• Como proteger arquivos com apagamento seletivo (C#/VB/C++)