Share via

CF_UPDATE_FLAGS 열거형(cfapi.h)

  • 아티클

자리 표시자 파일 또는 디렉터리를 업데이트하기 위한 플래그입니다.

Syntax

typedef enum CF_UPDATE_FLAGS {
  CF_UPDATE_FLAG_NONE,
  CF_UPDATE_FLAG_VERIFY_IN_SYNC,
  CF_UPDATE_FLAG_MARK_IN_SYNC,
  CF_UPDATE_FLAG_DEHYDRATE,
  CF_UPDATE_FLAG_ENABLE_ON_DEMAND_POPULATION,
  CF_UPDATE_FLAG_DISABLE_ON_DEMAND_POPULATION,
  CF_UPDATE_FLAG_REMOVE_FILE_IDENTITY,
  CF_UPDATE_FLAG_CLEAR_IN_SYNC,
  CF_UPDATE_FLAG_REMOVE_PROPERTY,
  CF_UPDATE_FLAG_PASSTHROUGH_FS_METADATA,
  CF_UPDATE_FLAG_ALWAYS_FULL,
  CF_UPDATE_FLAG_ALLOW_PARTIAL
} ;

상수

 
CF_UPDATE_FLAG_NONE
0x00000000

업데이트 플래그가 없습니다.
CF_UPDATE_FLAG_VERIFY_IN_SYNC
0x00000001

CF_UPDATE_FLAG_MARK_IN_SYNC 특성이 현재 자리 표시자에 설정되어 있지 않으면 업데이트가 실패합니다. 이는 클라우드에서 로컬 자리 표시자로 변경 내용을 동기화하는 것과 자리 표시자의 데이터 스트림이 로컬로 수정되는 경합을 방지하기 위한 것입니다.
CF_UPDATE_FLAG_MARK_IN_SYNC
0x00000002

플랫폼은 성공적인 업데이트 자리 표시자 작업 시 자리 표시자를 동기화 중으로 표시합니다.
CF_UPDATE_FLAG_DEHYDRATE
0x00000004

파일에만 적용됩니다. 지정된 경우 플랫폼은 자리 표시자를 성공적으로 업데이트한 후 파일을 탈수합니다. 이 플래그를 지정하거나 데이터 손상이 발생할 수 있는 경우 호출자는 배타적 핸들을 획득해야 합니다. 플랫폼은 핸들의 배타성의 유효성을 검사하지 않습니다.
CF_UPDATE_FLAG_ENABLE_ON_DEMAND_POPULATION
0x00000008

디렉터리에만 적용됩니다. 지정된 경우 업데이트된 자리 표시자 디렉터리가 부분적으로 채워져 나중에 액세스하면 동기화 공급자에게 FETCH_PLACEHOLDERS 콜백이 전송됩니다.
CF_UPDATE_FLAG_DISABLE_ON_DEMAND_POPULATION
0x00000010

디렉터리에만 적용됩니다. 지정된 경우 업데이트된 자리 표시자 디렉터리가 완전히 채워져 동기화 공급자에 대한 콜백 없이 플랫폼에서 향후 액세스를 처리하도록 표시합니다.
CF_UPDATE_FLAG_REMOVE_FILE_IDENTITY
0x00000020

지정하면 CfUpdatePlaceholder의 FileIdentity 및 FileIdentityLength가 무시되고 플랫폼은 성공적인 업데이트 호출 시 자리 표시자에서 기존 파일 ID Blob을 제거합니다.
CF_UPDATE_FLAG_CLEAR_IN_SYNC
0x00000040

플랫폼은 성공적인 업데이트 자리 표시자 작업 시 자리 표시자를 동기화되지 않음으로 표시합니다.
CF_UPDATE_FLAG_REMOVE_PROPERTY
0x00000080

플랫폼은 자리 표시자에서 기존의 모든 내재 속성을 제거합니다.

참고

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

플랫폼은 필터링 없이 파일 시스템에 CF_FS_METADATA 전달합니다. 그렇지 않으면 플랫폼은 값이 0인 필드 설정을 건너뜁니다.

참고

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

CF_UPDATE_FLAG_ALWAYS_FULL 는 자리 표시자 파일에만 적용됩니다. 지정하면 업데이트할 자리 표시자가 항상 가득 찼습니다. 수화되면 이러한 자리 표시자 파일을 디하이드레이션하려는 시도가 오류 코드 ERROR_CLOUD_FILE_DEHYDRATION_DISALLOWED로 실패합니다.
CF_UPDATE_FLAG_ALLOW_PARTIAL
0x00000400

CF_UPDATE_FLAG_ALLOW_PARTIAL 는 자리 표시자 파일에만 적용됩니다. 지정하면 자리 표시자 파일의 항상 전체 상태가 지워지므로 다시 탈수될 수 있습니다. 와 함께 CF_UPDATE_FLAG_ALWAYS_FULL 이 플래그를 지정하는 것은 잘못되었으며 오류 코드 ERROR_CLOUD_FILE_INVALID_REQUEST 가 결과로 반환됩니다.

요구 사항

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

추가 정보

CfUpdatePlaceholder