FileRevocationManager.ProtectAsync(IStorageItem, String) Método

Definición

Espacio de nombres:

Windows.Security.EnterpriseData

Nota:

A partir de julio de 2022, Microsoft está en desuso en Windows Information Protection (WIP) y las API que admiten WIP. Microsoft seguirá admitiendo WIP en versiones compatibles de Windows. Las nuevas versiones de Windows no incluirán nuevas funcionalidades para WIP y no se admitirán en versiones futuras de Windows. Para obtener más información, vea Anuncio de la puesta de sol de Windows Information Protection.

Para sus necesidades de protección de datos, Microsoft recomienda usar Microsoft Purview Information Protection y Prevención de pérdida de datos de Microsoft Purview. Purview simplifica la configuración y proporciona un conjunto avanzado de funcionalidades.

Nota:

FileRevocationManager puede no estar disponible para versiones posteriores a Windows 10. En su lugar, use FileProtectionManager.

Protege un archivo o carpeta para el borrado selectivo.

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

Archivo o carpeta que se va a proteger para el borrado selectivo.

enterpriseIdentity

String

Platform::String

winrt::hstring

Identificador de empresa para el que está protegido el archivo o la carpeta. El valor enterpriseIdentity debe tener el formato de nombre de dominio internacionalizado (IDN) y no puede contener espacios. Por ejemplo, contoso.com.

Devoluciones

IAsyncOperation<FileProtectionStatus>

Una operación asincrónica que recupera el estado de protección de borrado selectivo del objeto storageItem.

Atributos

DeprecatedAttribute RemoteAsyncAttribute

Comentarios

Puede usar el método ProtectAsync para proteger un archivo o carpeta mediante el borrado selectivo. Esto identifica el archivo como protegido para el identificador de empresa, como "example.com", como se muestra en el ejemplo de código anterior. Si protege una carpeta mediante el método ProtectAsync, todos los archivos de esa carpeta heredan la misma protección.

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

El método ProtectAsync requiere acceso exclusivo al archivo o carpeta que se está cifrando y producirá un error si otro proceso usa tiene un identificador abierto al archivo o carpeta.

Consulte también

• Ejemplo fileRevocationManager
• Protección de archivos con borrado selectivo (C#/VB/C++)