FileRevocationManager.ProtectAsync(IStorageItem, String) 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 de 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.

Protege um arquivo ou pasta para apagamento seletivo.

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)

Parâmetros

storageItem

IStorageItem

O arquivo ou pasta a ser protegido para apagamento seletivo.

enterpriseIdentity

String

Platform::String

winrt::hstring

A ID da empresa para a qual o arquivo ou pasta está protegido. O valor enterpriseIdentity deve ser formatado como um IDN (Nome de Domínio Internacionalizado) e não pode conter espaços. Por exemplo, contoso.com.

Retornos

IAsyncOperation<FileProtectionStatus>

Uma operação assíncrona que recupera a proteção de apagamento seletivo status para storageItem.

Atributos

DeprecatedAttribute RemoteAsyncAttribute

Comentários

Você pode usar o método ProtectAsync para proteger um arquivo ou pasta usando o Apagamento Seletivo. Isso identifica o arquivo como protegido para seu identificador corporativo, como "example.com", conforme mostrado no exemplo de código anterior. Se você proteger uma pasta usando o método ProtectAsync, todos os arquivos nessa pasta herdarão a mesma proteção.

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

O método ProtectAsync 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++)