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 |