CfDisconnectSyncRoot 함수(cfapi.h)

CfConnectSyncRoot에서 만든 통신 채널의 연결을 끊습니다.

구문

HRESULT CfDisconnectSyncRoot(
  [in] CF_CONNECTION_KEY ConnectionKey
);

매개 변수

[in] ConnectionKey

이제 동기화 루트의 연결을 끊는 데 사용되는 CfConnectSyncRoot 에서 반환된 연결 키입니다.

반환 값

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

설명

이렇게 하면 CfConnectSyncRoot를 사용하여 이전에 설정된 플랫폼과의 통신 채널이 제거됩니다.

동기화 공급자는 CfDisconnectSyncRoot 호출 중에 콜백을 계속 받을 수 있으며, 공급자는 호출이 실패할지 아니면 서비스해야 하는지 선택할 수 있습니다. 둘 중 하나를 선택하면 동기화 공급자가 중단되지 않습니다.

CfDisconnectSyncRoot 호출이 반환되면 동기화 공급자는 더 이상 콜백을 받지 않으며 플랫폼은 해당 콜백에 의존하는 모든 작업에 실패합니다.

동기화 공급자는 연결이 끊어질 동기화 루트에 대한 WRITE_DATA 또는 WRITE_DAC 액세스 권한이 있어야 합니다. 그렇지 않으면 HRESULT(ERROR_CLOUD_FILE_ACCESS_DENIED)에서 CfDisconnectSyncRoot에 대한 호출이 실패합니다. 또한 동기화 루트가 이전에 연결되지 않은 경우 잘못된 매개 변수로 인해 호출이 실패합니다. 이 API는 동기화 공급자를 정상적으로 종료하는 과정의 일부로 호출될 수 있습니다. 그러나 동기화 공급자 프로세스가 이 API를 호출하지 않고 종료하도록 선택하거나 예기치 않게 충돌하는 경우 플랫폼은 이를 감지하고 필요한 정리를 수행합니다.

요구 사항

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

추가 정보

CfConnectSyncRoot