다음을 통해 공유

CF_HYDRATION_POLICY_MODIFIER 열거형(cfapi.h)

  • 아티클

동기화 공급자가 플랫폼에서 자리 표시자 파일을 하이드레이션하는 방법을 제어할 수 있습니다. 기본 정책인 CF_HYDRATION_POLICY_PRIMARY 사용할 수 있는 한정자입니다.

Syntax

typedef enum CF_HYDRATION_POLICY_MODIFIER {
  CF_HYDRATION_POLICY_MODIFIER_NONE,
  CF_HYDRATION_POLICY_MODIFIER_VALIDATION_REQUIRED,
  CF_HYDRATION_POLICY_MODIFIER_STREAMING_ALLOWED,
  CF_HYDRATION_POLICY_MODIFIER_AUTO_DEHYDRATION_ALLOWED,
  CF_HYDRATION_POLICY_MODIFIER_ALLOW_FULL_RESTART_HYDRATION
} ;

상수

 
CF_HYDRATION_POLICY_MODIFIER_NONE
0x0000

정책 한정자가 없습니다.
CF_HYDRATION_POLICY_MODIFIER_VALIDATION_REQUIRED
0x0001

이 정책 한정자는 동기화 공급자에게 두 가지 보증을 제공합니다. 먼저 동기화 공급자가 반환한 데이터가 사용자 애플리케이션에 반환되기 전에 항상 디스크에 유지되도록 보장합니다. 둘째, 동기화 공급자가 이전에 플랫폼에 반환한 것과 동일한 데이터를 검색하고 무결성의 유효성을 검사할 수 있습니다. 동기화 공급자가 무결성을 성공적으로 확인한 후에만 플랫폼이 사용자 I/O 요청을 완료합니다. 이 한정자는 추가 디스크 I/Os의 비용으로 엔드투엔드 데이터 무결성을 지원하는 데 도움이 됩니다.
CF_HYDRATION_POLICY_MODIFIER_STREAMING_ALLOWED
0x0002

이 정책 한정자는 동기화 공급자가 반환한 데이터를 로컬 디스크에 저장하지 않을 수 있는 권한을 플랫폼에 부여합니다. 이 정책 한정자는 CF_HYDRATION_POLICY_MODIFIER_VALIDATION_REQUIRED 결합할 때 효과가 없습니다.
CF_HYDRATION_POLICY_MODIFIER_AUTO_DEHYDRATION_ALLOWED
0x0004

이 정책 한정자는 동기화 공급자의 도움 없이 동기화 중인 클라우드 파일 자리 표시자를 탈수할 수 있는 권한을 플랫폼에 부여합니다. 이 플래그가 없으면 플랫폼에서 CfDehydratePlaceholder 를 직접 호출할 수 없습니다. 대신 클라우드 파일 자리 표시자를 디하이드레이션하는 유일한 지원 방법은 파일의 고정된 특성을 지우고 파일의 고정되지 않은 특성을 설정하는 것입니다. 이 시점에서 실제 탈수는 두 특성에 대한 디렉터리 변경 알림을 받은 후 동기화 엔진에 의해 비동기적으로 수행됩니다. 이 플래그를 지정하면 플랫폼이 동기화 중인 클라우드 파일 자리 표시자에서 CfDehydratePlaceholder 를 직접 호출할 수 있습니다. 동기화 공급자가 자동 탈수 상태를 지원하는 것이 좋습니다.

참고

이 값은 Windows 10 버전 1803 이상에서 사용할 수 있습니다.
CF_HYDRATION_POLICY_MODIFIER_ALLOW_FULL_RESTART_HYDRATION
0x0008

이 정책 한정자는 AV 필터가 파일을 검사하려는 시도를 가로챌 때 파일을 동기적으로 완전히 수화할 수 있는 플랫폼 권한을 부여합니다. RestartHydration을 사용하여 FetchData 콜백에서 을 변경 fileSize 하려는 동기화 공급자는 파일을 검사하려는 바이러스 백신 및 맬웨어 방지 소프트웨어와 RestartHydration을 사용하여 변경 fileSize 하려는 공급자와의 교착 상태를 방지하기 위해 정책을 옵트 ALLOW_FULL_RESTART_HYDRATION 인해야 합니다.

참고

이 열거형 업데이트는 CfGetPlatformInfo에서 가져온 이 이상인 경우에만 PlatformVersion.IntegrationNumber 지원됩니다0x500.

설명

일반적으로 한정자는 조합이 자체 충돌하지 않는 한 모든 기본 정책(CF_HYDRATION_POLICY_PRIMARY) 및 기타 정책 한정자와 혼합 및 일치시킬 수 있습니다.

CF_HYDRATION_POLICY_MODIFIER_ALLOW_FULL_RESTART_HYDRATION AV(바이러스 백신 및 맬웨어 탐지기)로 인한 교착 상태가 발생하지 않도록 수분 다시 시작 기능을 방지하기 위해 플래그가 추가됩니다. 하이드레이션 요청 과정에서 탈수된 파일의 파일 크기를 업데이트하려는 모든 동기화 공급자는 이 기능을 옵트인해야 합니다. 또는 AV가 파일의 메모리 매핑 섹션을 만들어 열려는 파일을 스캔하려고 하면 수화가 다시 시작되면 교착 상태가 발생할 수 있습니다. 파일이 백 엔드/서버에서 업데이트된 경우에도 파일의 스냅샷 또는 버전을 유지하고 요청된 버전의 파일을 제공하여 사용자의 요청을 충족하는 공급자는 이 정책을 옵트인할 필요가 없습니다. 마찬가지로 백 엔드에서 파일이 변경된 경우 하이드레이션 요청에 실패한 공급자는 이 정책에 대해 옵트인하지 않을 수 있습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 10 버전 1709 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2016 [데스크톱 앱만 해당]
머리글 cfapi.h

추가 정보

CF_HYDRATION_POLICY_PRIMARY

CfDehydratePlaceholder

CfGetPlatformInfo