CfGetSyncRootInfoByHandle 함수(cfapi.h)

파일 핸들로 지정된 지정된 파일을 포함하는 동기화 루트의 다양한 특성을 가져옵니다.

구문

HRESULT CfGetSyncRootInfoByHandle(
  [in]            HANDLE                  FileHandle,
  [in]            CF_SYNC_ROOT_INFO_CLASS InfoClass,
  [out]           PVOID                   InfoBuffer,
  [in]            DWORD                   InfoBufferLength,
  [out, optional] DWORD                   *ReturnedLength
);

매개 변수

[in] FileHandle

정보를 쿼리할 동기화 루트 아래의 파일 핸들입니다.

[in] InfoClass

동기화 루트 정보의 유형입니다.

[out] InfoBuffer

동기화 루트 정보를 받을 버퍼에 대한 포인터입니다.

[in] InfoBufferLength

InfoBuffer의 길이(바이트)입니다.

[out, optional] ReturnedLength

InfoBuffer에 반환된 바이트 수입니다.

반환 값

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

설명

파일 핸들을 사용하는 대부분의 자리 표시자 API와 달리 이 API는 어떤 방식으로도 파일을 수정하지 않으므로 FileHandle 에는 READ_ATTRIBUTES 액세스만 필요합니다.

파일이 클라우드 파일 동기화 루트 아래에 없으면 API가 실패합니다. 성공하면 요청된 특정 InfoClass 에 따라 정보가 반환됩니다.

요구 사항

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

추가 정보

CfGetSyncRootInfoByPath