CfSetInSyncState 함수(cfapi.h)

자리 표시자 파일 또는 폴더의 동기화 중 상태를 설정합니다.

구문

HRESULT CfSetInSyncState(
  [in]                HANDLE               FileHandle,
  [in]                CF_IN_SYNC_STATE     InSyncState,
  [in]                CF_SET_IN_SYNC_FLAGS InSyncFlags,
  [in, out, optional] USN                  *InSyncUsn
);

매개 변수

[in] FileHandle

자리 표시자에 대한 핸들입니다. 플랫폼은 작업을 다른 활성 요청과 올바르게 동기화합니다. 특성 또는 액세스 권한 없음 핸들로 충분합니다. 호출자에게 자리 표시자에 대한 WRITE_DATA 또는 WRITE_DAC 액세스 권한이 있어야 합니다.

[in] InSyncState

동기화 중인 상태입니다. InSyncState 는 다음 값 중 하나로 설정할 수 있습니다.

• CF_IN_SYNC_STATE_NOT_IN_SYNC 지정되면 플랫폼은 API 호출에서 성공적으로 반환되면 자리 표시자의 동기화 중 상태를 지웁니다.
• CF_IN_SYNC_STATE_IN_SYNC 지정되면 플랫폼은 API 호출에서 성공적으로 반환될 때 자리 표시자의 동기화 상태를 설정합니다.

[in] InSyncFlags

동기화 중인 상태 플래그입니다. 자세한 내용은 CF_SET_IN_SYNC_FLAGS 참조하세요.

[in, out, optional] InSyncUsn

지정된 경우 입력 시 InSyncUsn 은 파일에 전달된 값과 동일한 USN 값이 있는 경우에만 동기화 내 설정을 수행하도록 플랫폼에 지시합니다. 이는 동기화 공급자가 방금 동기화 자리 표시자가 클라우드로 변경된 경합을 닫기 위한 것이지만 CfSetInSyncState를 호출하기 전에 자리 표시자가 어떤 식으로든 변경되었습니다. 입력에서 의 USN 값 0 에 포인터를 전달하는 것은 포인터를 전달하는 NULL 것과 같습니다. 반환 시 InSYncUsn 은 동기화 중 상태를 설정한 후 최종 USN 값을 받습니다.

반환 값

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

요구 사항

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

추가 정보

CF_IN_SYNC_STATE

CF_SET_IN_SYNC_FLAGS