Share via

CfUnregisterSyncRoot 함수(cfapi.h)

  • 아티클

이전에 등록된 동기화 루트의 등록을 취소합니다.

구문

HRESULT CfUnregisterSyncRoot(
  [in] LPCWSTR SyncRootPath
);

매개 변수

[in] SyncRootPath

등록 취소할 동기화 루트의 경로입니다.

반환 값

이 함수가 성공하면 를 반환합니다 S_OK. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

CfRegisterSyncRoot에 등록된 동기화 루트의 등록을 취소합니다. 이는 일반적으로 동기화 공급자 제거 시간, 사용자 계정이 삭제되거나 사용자가 더 이상 디렉터리 트리를 동기화하지 않기로 선택할 때 호출됩니다(동기화 공급자가 지원하는 경우). 등록 취소할 동기화 루트가 이전에 등록되지 않은 경우 API는 STATUS_CLOUD_FILE_NOT_UNDER_SYNC_ROOT 실패합니다.

동기화 공급자는 등록 을 취소할 동기화 루트에 대한 WRITE_DATA 또는 WRITE_DAC 액세스 권한이 있어야 합니다. 그렇지 않으면 HRESULT(ERROR_CLOUD_FILE_ACCESS_DENIED)로 등록 취소가 실패합니다. 동기화 공급자가 동기화 루트에 연결된 경우 HRESULT(ERROR_CLOUD_FILE_INVALID_REQUEST)에서도 등록 취소가 실패합니다.

동기화 루트의 디렉터리 트리를 트래버스하여 동기화 루트의 등록을 취소합니다.

자리 표시자 파일의 경우:

  • 자리 표시자 파일이 완전히 수화되면 "일반" 파일로 되돌립니다.
  • 자리 표시자 파일이 하이드레이션되지 않으면 로컬 컴퓨터에서 영구적으로 삭제됩니다.

자리 표시자 디렉터리:

  • 자리 표시자 디렉터리가 완전히 채워지면 "일반" 디렉터리로 되돌아갑니다.
  • 자리 표시자 디렉터리가 완전히 채워지지 않으면 디렉터리가 로컬 컴퓨터에서 영구적으로 삭제됩니다.

참고

자리 표시자 파일 또는 디렉터리를 되돌리거나 삭제할 수 없는 경우 건너뛰고 전체 동기화 루트 트리가 트래버스될 때까지 등록 취소 프로세스가 계속됩니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 10 버전 1709 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2016 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 cfapi.h
라이브러리 CldApi.lib
DLL CldApi.dll

추가 정보

CfRegisterSyncRoot