FileRevocationManager.CopyProtectionAsync(IStorageItem, IStorageItem) 메서드

정의

네임스페이스:

Windows.Security.EnterpriseData

참고

2022년 7월부터 Microsoft는 WIP(Windows Information Protection) 및 WIP를 지원하는 API를 더 이상 사용하지 않습니다. Microsoft는 지원되는 Windows 버전에서 WIP를 계속 지원합니다. 새 버전의 Windows에는 WIP에 대한 새로운 기능이 포함되지 않으며 이후 버전의 Windows에서는 지원되지 않습니다. 자세한 내용은 Windows Information Protection 일몰 발표를 참조하세요.

데이터 보호 요구 사항에 따라 Microsoft Purview Information Protection 및 Microsoft Purview 데이터 손실 방지 사용하는 것이 좋습니다. Purview는 구성 설정을 간소화하고 고급 기능 집합을 제공합니다.

참고

FileRevocationManager는 Windows 10 후 릴리스에 사용할 수 없습니다. 대신 FileProtectionManager를 사용합니다.

파일 또는 폴더의 선택적 초기화 보호 상태를 새 파일 또는 폴더에 복사합니다.

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)

매개 변수

sourceStorageItem

IStorageItem

선택적 초기화 보호 상태 복사할 원본 항목입니다.

targetStorageItem

IStorageItem

선택적 초기화 보호 상태 복사할 대상 항목입니다.

반환

IAsyncOperation<Boolean>

IAsyncOperation<bool>

복사 작업이 성공하면 true입니다. 그렇지 않으면 false입니다.

특성

DeprecatedAttribute RemoteAsyncAttribute

설명

"다른 이름으로 저장" 작업의 결과로 파일의 새 복사본을 저장하는 경우 선택적 초기화 보호 상태 파일과 함께 복사되지 않습니다. 파일을 보호하려면 CopyProtectionAsync 메서드를 호출하여 기존 보호 상태 새 파일에 복사해야 합니다. CopyAsync 또는 CopyAndReplaceAsync 메서드를 사용하여 보호된 파일을 복사하는 경우 선택적 초기화 보호 상태 파일과 함께 복사되며 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;
}

CopyProtectionAsync 메서드를 사용하려면 암호화되는 파일 또는 폴더에 대한 단독 액세스 권한이 필요하며, 다른 프로세스에서 사용하는 경우 파일 또는 폴더에 대한 핸들이 열려 있으면 실패합니다.

추가 정보

• FileRevocationManager 샘플
• 선택적 초기화를 사용하여 파일을 보호하는 방법(C#/VB/C++)