Share via


CfReportSyncStatus 함수(cfapi.h)

동기화 공급자가 CfConnectSyncRoot 호출에 먼저 연결하지 않고도 지정된 동기화 루트의 상태 플랫폼에 알릴 수 있습니다.

구문

HRESULT CfReportSyncStatus(
  [in, out] LPCWSTR        SyncRootPath,
  [in]      CF_SYNC_STATUS *SyncStatus
);

매개 변수

[in, out] SyncRootPath

동기화 루트의 경로입니다.

[in] SyncStatus

동기화는 보고할 상태 있습니다. 이면 NULL이전에 저장한 동기화 상태 지웁니다. 자세한 내용은 아래의 설명 섹션 참조하세요.

반환 값

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

설명

SyncStatus 매개 변수에 null이 아닌 CF_SYNC_STATUS 제공되면 동기화 공급자가 명시적으로 지워지거나 컴퓨터가 다시 부팅될 때까지 동기화 루트에 정보가 기억됩니다. 플랫폼은 다음 프로세스를 사용하여 클라우드 파일 자리 표시자에서 실패한 작업에 대해 이 정보를 쿼리합니다.

  1. 플랫폼은 먼저 파일 수준에서 동기화 상태 검색합니다.
  2. 동기화 상태 없는 경우 플랫폼은 동기화 루트 수준에서 등록된 동기화 상태 검색합니다. 이 작업은 이 함수를 통해 수행됩니다.
  3. 동기화 상태 있으면 플랫폼은 제공된 정보를 사용하여 사용자에게 더 의미 있고 실행 가능한 메시지를 생성합니다.

CfReportSyncStatus는 동기화 상태 호출 NULL 될 때 이전에 저장한 동기화 상태 지웁니다. 함수 호출이 실패하면 기존 동기화 상태 변경되지 않습니다.

요구 사항

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

추가 정보

CfConnectSyncRoot

CF_SYNC_STATUS