CF_SYNC_POLICIES 구조체(cfapi.h)

아티클
03/14/2023

동기화 루트에서 사용하는 동기화 정책을 정의합니다.

구문

typedef struct CF_SYNC_POLICIES {
  ULONG                            StructSize;
  CF_HYDRATION_POLICY              Hydration;
  CF_POPULATION_POLICY             Population;
  CF_INSYNC_POLICY                 InSync;
  CF_HARDLINK_POLICY               HardLink;
  CF_PLACEHOLDER_MANAGEMENT_POLICY PlaceholderManagement;
} CF_SYNC_POLICIES;

멤버

StructSize

구조체의 크기입니다 CF_SYNC_POLICIES .

Hydration

하이드레이션 정책을 사용하면 동기화 공급자가 플랫폼에서 자리 표시자 파일을 하이드레이션하는 방법을 제어할 수 있습니다. 기본 정책 및 정책 한정자 집합으로 구성됩니다.

기본 정책에는 다음과 같은 네 가지 가능한 값이 있습니다.

정책	설명
ALWAYS_FULL	`ALWAYS_FULL` 이 선택되면 플랫폼은 HRESULT, CfCreatePlaceholders, CfDehydratePlaceholder, 탈수 옵션이 있는 CfUpdatePlaceholder 및 탈수 옵션이 있는CfConvertPlaceholder를 포함하는 완전히 하이드레이션되지 않은 자리 표시자를 생성할 수 있는 자리 표시자 작업인 HRESULT`ERROR_CLOUD_FILE_INVALID_REQUEST`와 함께 실패합니다.
FULL	`FULL` 이 선택되면 플랫폼에서 자리 표시자를 탈수할 수 있습니다. 플랫폼이 탈수된 자리 표시자에 대한 액세스를 감지하면 요청이 1 바이트만 요청하는 경우에도 사용자 IO 요청을 완료하기 전에 자리 표시자의 전체 콘텐츠를 로컬로 사용할 수 있는지 확인합니다.
진보적인	`PROGRESSIVE` 이 선택되면 플랫폼에서 자리 표시자를 탈수할 수 있습니다. 플랫폼이 탈수된 자리 표시자에 대한 액세스를 감지하면 동기화 공급자로부터 충분한 데이터가 수신되었다고 판단되는 즉시 사용자 IO 요청을 완료합니다. 그러나 플랫폼은 자리 표시자의 전체 콘텐츠를 로컬로 사용할 수 있거나 자리 표시자의 마지막 사용자 핸들을 닫을 때까지 백그라운드에서 동기화 공급자의 자리 표시자에 있는 나머지 콘텐츠를 계속 요청할 것을 약속합니다. 옵트인 `PROGRESSIVE` 하는 동기화 공급자는 수분 공급 콜백이 오프셋 0에서 순차적으로 도착한다고 가정하지 않을 수 있습니다. 즉, 정책과 동기화 공급자 `PROGRESSIVE` 는 자리 표시자에서 임의 검색을 처리해야 합니다.
PARTIAL	정책은 `PARTIAL` 과 매우 유사합니다 `PROGRESSIVE`. 둘 사이의 유일한 차이점은 정책과 백그라운드에서 연속 수화의 부족이다 `PARTIAL` .

현재 VALIDATION_REQUIRED지원되는 세 가지 정책 한정자는 , STREAMING_ALLOWED및 AUTO_DEHYDRATION_ALLOWED입니다. 일반적으로 한정자는 조합이 자체 충돌하지 않는 한 모든 기본 정책 및 기타 정책 한정자와 혼합 및 일치시킬 수 있습니다.

정책 한정자	Description
VALIDATION_REQUIRED	이 정책 한정자는 동기화 공급자에게 두 가지 보증을 제공합니다. 먼저 동기화 공급자가 반환한 데이터가 사용자 애플리케이션에 반환되기 전에 항상 디스크에 유지되도록 보장합니다. 둘째, 동기화 공급자가 이전에 플랫폼에 반환한 것과 동일한 데이터를 검색하고 무결성의 유효성을 검사할 수 있습니다. 동기화 공급자가 무결성을 성공적으로 확인한 후에만 플랫폼이 사용자 IO 요청을 완료합니다. 이 한정자는 추가 디스크 IO의 비용으로 엔드 투 엔드 데이터 무결성을 지원하는 데 도움이 됩니다.
STREAMING_ALLOWED	이 정책 한정자는 동기화 공급자가 반환한 데이터를 로컬 디스크에 저장하지 않을 수 있는 권한을 플랫폼에 부여합니다. 이 정책 한정자는 와 `VALIDATION_REQUIRED`함께 사용할 수 없습니다. 두 플래그를 모두 지정하면 API가 와 함께 `ERROR_INVALID_PARAMETER` 실패합니다.
AUTO_DEHYDRATION_ALLOWED	이 정책 한정자는 동기화 공급자의 도움 없이 동기화 중인 클라우드 파일 자리 표시자를 탈수할 수 있는 권한을 플랫폼에 부여합니다. 이 플래그가 없으면 플랫폼에서 CfDehydratePlaceholder 를 직접 호출할 수 없습니다. 대신 클라우드 파일 자리 표시자를 디하이드레이션하는 유일한 지원 방법은 파일의 고정된 특성을 지우고 파일의 고정되지 않은 특성을 설정하는 것입니다. 그런 다음 두 특성에 대한 디렉터리 변경 알림을 받은 후 동기화 엔진에서 실제 탈수 작업을 비동기적으로 수행합니다. 이 플래그를 지정하면 플랫폼이 동기화 중인 클라우드 파일 자리 표시자에서 CfDehydratePlaceholder 를 직접 호출할 수 있습니다. 동기화 공급자가 자동 탈수를 지원하는 것이 좋습니다.
ALLOW_FULL_RESTART_HYDRATION	이 정책 한정자는 AV 필터가 파일을 검사하려는 시도를 가로챌 때 파일을 동기적으로 완전히 수화할 수 있는 플랫폼 권한을 부여합니다. RestartHydration을 사용하여 FetchData 콜백에서 을 변경 `fileSize` 하려는 동기화 공급자는 파일을 검사하려는 바이러스 백신 및 맬웨어 방지 소프트웨어와 RestartHydration을 사용하여 변경 `fileSize` 하려는 공급자와의 교착 상태를 방지하기 위해 정책을 옵트 `ALLOW_FULL_RESTART_HYDRATION` 인해야 합니다. 참고: 이 한정자는 CfGetPlatformInfo에서 가져온 이 이상인 경우에만 `PlatformVersion.IntegrationNumber` 지원됩니다`0x500`.

Population

채우기 정책을 사용하면 동기화 공급자가 플랫폼에서 디렉터리와 파일 모두 자리 표시자 네임스페이스를 만드는 방법을 제어할 수 있습니다. 현재 한정자가 정의되지 않은 세 가지 기본 정책이 있습니다.

정책	설명
ALWAYS_FULL	`ALWAYS_FULL` 이 선택되면 플랫폼은 전체 이름 공간을 항상 로컬로 사용할 수 있다고 가정합니다. 동기화 공급자에 디렉터리 열거형 요청을 전달하지 않습니다.
FULL	`FULL` 채우기 정책을 사용하면 플랫폼이 완전히 채워지지 않은 디렉터리에 대한 액세스를 감지하면 동기화 공급자가 사용자 요청을 완료하기 전에 디렉터리 아래의 모든 항목을 반환할 것을 요청합니다.
PARTIAL	`PARTIAL` 채우기 정책을 사용하면 플랫폼이 완전히 채워지지 않은 디렉터리에 대한 액세스를 감지하면 동기화 공급자의 사용자 애플리케이션에 필요한 항목만 요청합니다.

InSync

이 InSync 정책을 사용하면 동기화 공급자가 플랫폼이 자리 표시자에서 동기화 중 상태를 지워야 하는 시기를 제어할 수 있습니다. 플랫폼은 데이터 수정 시 항상 동기화 내를 지우는 것 외에도 현재 세 개의 파일 특성(ReadOnly, System 및 Hidden)과 두 개의 파일 시간(CreateTime 및 LastWriteTime)의 조합에 대한 변경 내용에 대해 동기화 중을 지울 수 있습니다. 이러한 정책은 파일 및 디렉터리에 별도로 적용할 수 있습니다.

HardLink

기본적으로 플랫폼은 모든 자리 표시자에 하드 링크를 만들 수 없습니다. 그러나 하드 링크를 처리할 수 있는 동기화 공급자는 정책을 통해 지원을 사용하도록 플랫폼에 ALLOWED 지시할 수 있습니다. 이 정책을 사용하면 링크가 동일한 동기화 루트 아래에 있거나 동기화 루트가 없는 한 애플리케이션에서 파일 시스템에서 지원하는 만큼의 하드 링크를 만들 수 있습니다. 플랫폼은 첫 번째 동기화되지 않은 루트 링크가 도입될 때 자리 표시자를 강제로 하이드레이션하고 마지막 동기화 루트 내 링크가 제거될 때 자리 표시자를 일반 파일에 되돌리기. 정책과 호환되지 않는 하드링크 만들기는 HRESULT ERROR_CLOUD_FILES_INCOMPATIBLE_HARDLINKS로 실패합니다. 정책과 호환되지 않는 자리 표시자 작업도 에서 ERROR_CLOUD_FILES_INCOMPATIBLE_HARDLINKS실패합니다.

PlaceholderManagement

기본적으로 동기화 공급자만 동기화 루트에서 자리 표시자 관리 작업을 수행할 수 있습니다. 동기화 공급자가 아닌 프로세스는 동기화 루트가 비활성 상태인 경우에만 자리 표시자 관리 작업을 수행할 수 있습니다(즉, 동기화 공급자가 동기화 루트에 연결되지 않은 경우). 이러한 정책을 사용하도록 설정하면 동기화되지 않은 공급자 프로세스가 활성 동기화 루트에서 각 자리 표시자 관리 작업을 수행할 수 있습니다. CF_PLACEHOLDER_MANAGEMENT_POLICY_DEFAULT 는 연결된 동기화 공급자만 자리 표시자 관리 작업을 수행할 수 있도록 하는 기본 정책입니다. 아래의 세 가지 정책은 모든 조합으로 지정할 수 있습니다.

정책	설명
CF_PLACEHOLDER_MANAGEMENT_POLICY_CREATE_UNRESTRICTED	등록하는 동안 이 정책을 지정하면 모든 프로세스에서 CfCreatePlaceholders를 호출하여 활성 동기화 루트 내에 자리 표시자를 만들 수 있습니다.
CF_PLACEHOLDER_MANAGEMENT_POLICY_CONVERT_UNRESTRICTED	등록하는 동안 이 정책을 지정하면 모든 프로세스에서 CfConvertToPlaceholder를 호출하여 활성 동기화 루트 내의 파일 또는 디렉터리를 자리 표시자로 변환할 수 있습니다.
CF_PLACEHOLDER_MANAGEMENT_POLICY_UPDATE_UNRESTRICTED	등록하는 동안 이 정책을 지정하면 모든 프로세스에서 API CfUpdatePlaceholder를 통해 활성 동기화 루트 내의 자리 표시자를 업데이트할 수 있습니다.

참고

이러한 플래그는 CfGetPlatformInfo에서 가져온 이 이상인 경우에만 PlatformVersion.IntegrationNumber 지원됩니다0x310.

요구 사항

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

추가 정보

CfCreatePlaceholders

CfConvertToPlaceholder

CfGetPlatformInfo

다음을 통해 공유

CF_SYNC_POLICIES 구조체(cfapi.h)

구문

멤버

요구 사항

추가 정보

피드백

추가 리소스