Share via

CF_CONVERT_FLAGS 열거형(cfapi.h)

  • 아티클

자리 표시자 파일/디렉터리 변환 플래그에 대한 일반 파일/디렉터리입니다.

Syntax

typedef enum CF_CONVERT_FLAGS {
  CF_CONVERT_FLAG_NONE = 0x00000000,
  CF_CONVERT_FLAG_MARK_IN_SYNC = 0x00000001,
  CF_CONVERT_FLAG_DEHYDRATE = 0x00000002,
  CF_CONVERT_FLAG_ENABLE_ON_DEMAND_POPULATION = 0x00000004,
  CF_CONVERT_FLAG_ALWAYS_FULL = 0x00000008,
  CF_CONVERT_FLAG_FORCE_CONVERT_TO_CLOUD_FILE = 0x00000010
} ;

상수

 
CF_CONVERT_FLAG_NONE
값: 0x00000000
변환 플래그가 없습니다.
CF_CONVERT_FLAG_MARK_IN_SYNC
값: 0x00000001
플랫폼은 파일을 성공적으로 변환할 때 변환된 자리 표시자를 클라우드와 동기화된 것으로 표시합니다.
CF_CONVERT_FLAG_DEHYDRATE
값: 0x00000002
파일에만 적용됩니다. 지정된 경우 플랫폼은 파일을 자리 표시자로 변환한 후 파일을 탈수합니다. 호출자는 이 플래그를 지정하거나 데이터 손상이 발생할 수 있는 경우 배타적 핸들을 획득해야 합니다. 플랫폼은 핸들의 배타성의 유효성을 검사하지 않습니다.
CF_CONVERT_FLAG_ENABLE_ON_DEMAND_POPULATION
값: 0x00000004
디렉터리에만 적용됩니다. 지정된 경우 변환된 자리 표시자 디렉터리를 부분적으로 채워진 것으로 표시하므로 나중에 액세스하면 동기화 공급자에게 FETCH_PLACEHOLDERS 콜백이 전송됩니다.
CF_CONVERT_FLAG_ALWAYS_FULL
값: 0x00000008
이 플래그가 있으면 새로 만든 자리 표시자가 항상 가득 찬 것으로 표시됩니다. 수화되면 이러한 (파일) 자리 표시자를 탈수하려는 시도는 오류 코드 ERROR_CLOUD_FILE_DEHYDRATION_DISALLOWED 함께 실패합니다. 이 플래그는 자리 표시자 파일에만 적용됩니다. 자리 표시자 디렉터리에 설정할 수 있지만 아무런 효과가 없습니다.
CF_CONVERT_FLAG_FORCE_CONVERT_TO_CLOUD_FILE
값: 0x00000010
플랫폼을 지정하면 동기화 엔진이 비 클라우드 파일 자리 표시자(다른 재분석 태그/데이터 포함)를 클라우드 파일 자리 표시자로 원자적으로 변환할 수 있습니다. API는 일반적으로 자리 표시자가 아닌 파일을 자리 표시자로 변환하지 못합니다.

**(CF_CONVERT_FLAG_FORCE_CONVERT_TO_CLOUD_FILE 조합		 CF_CONVERT_FLAG_DEHYDRATE)**은 특정 공급자가 다른 플랫폼에서 클라우드 파일 플랫폼으로 마이그레이션하고 이전 플랫폼의 수화된 자리 표시자를 클라우드 파일 플랫폼의 탈수된 자리 표시자로 원자성으로 변환하려는 경우 마이그레이션 시나리오에서 특히 유용합니다. 전체 자리 표시자를 클라우드 파일 자리 표시자로 변환하려면 이 플래그만 전달해야 합니다. 이전 플랫폼에서 전체 파일을 일반 자리 표시자가 아닌 파일로 구현하는 경우 이 플래그는 필요하지 않습니다. 디렉터리에 이 플래그를 전달하면 디렉토리에도 디렉토리가 적용되지 않지만 디렉터 리도 클라우드 파일로 변환됩니다.

정책 CF_PLACEHOLDER_MANAGEMENT_POLICY_CONVERT_TO_UNRESTRICTEDCfRegisterSyncRoot를 사용하여 지정한 경우에도 클라우드 파일 동기화 루트에 등록/연결된 프로세스만 이 플래그를 지정할 수 있습니다.

>[! 참고]
>플래그는 CfGetPlatformInfo에서 가져온 가 이상인 경우에만 PlatformVersion.IntegrationNumber 지원됩니다0x500.

요구 사항

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

추가 정보

CfConvertToPlaceholder

CfRegisterSyncRoot

CfGetPlatformInfo